Depth Generator

Modules
	User Position Capability
Functions
XN_C_API XnStatus XN_C_DECL	xnCreateDepthGenerator (XnContext *pContext, XnNodeHandle *phDepthGenerator, XnNodeQuery *pQuery, XnEnumerationErrors *pErrors)
XN_C_API XnDepthPixel XN_C_DECL	xnGetDeviceMaxDepth (XnNodeHandle hInstance)
XN_C_API XnStatus XN_C_DECL	xnGetDepthFieldOfView (XnNodeHandle hInstance, XnFieldOfView *pFOV)
XN_C_API XnStatus XN_C_DECL	xnRegisterToDepthFieldOfViewChange (XnNodeHandle hInstance, XnStateChangedHandler handler, void *pCookie, XnCallbackHandle *phCallback)
XN_C_API void XN_C_DECL	xnUnregisterFromDepthFieldOfViewChange (XnNodeHandle hInstance, XnCallbackHandle hCallback)
XN_C_API XnStatus XN_C_DECL	xnConvertProjectiveToRealWorld (XnNodeHandle hInstance, XnUInt32 nCount, const XnPoint3D *aProjective, XnPoint3D *aRealWorld)
XN_C_API XnStatus XN_C_DECL	xnConvertRealWorldToProjective (XnNodeHandle hInstance, XnUInt32 nCount, const XnPoint3D *aRealWorld, XnPoint3D *aProjective)
XN_C_API XnDepthPixel *XN_C_DECL	xnGetDepthMap (XnNodeHandle hInstance)
XN_C_API void XN_C_DECL	xnGetDepthMetaData (XnNodeHandle hInstance, XnDepthMetaData *pMetaData)

---

Detailed Description

A Depth Generator node is a Map Generator that outputs depth maps. It supports all Map Generator functions, and adds additional functions.

---

Function Documentation

XN_C_API XnStatus XN_C_DECL xnConvertProjectiveToRealWorld	(	XnNodeHandle	hInstance,
		XnUInt32	nCount,
		const XnPoint3D *	aProjective,
		XnPoint3D *	aRealWorld
	)

Converts a list of points from projective coordinates to real world coordinates.

Parameters:

hInstance	[in] A handle to the instance.
nCount	[in] The number of points to translate.
aProjective	[in] An array of projective coordinates points.
aRealWorld	[in/out] An array to be filled with real world coordinates points.

Returns:

XN_STATUS_INVALID_OPERATION if this production node is not a depth generator.

XN_C_API XnStatus XN_C_DECL xnConvertRealWorldToProjective	(	XnNodeHandle	hInstance,
		XnUInt32	nCount,
		const XnPoint3D *	aRealWorld,
		XnPoint3D *	aProjective
	)

Converts a list of points from projective coordinates to real world coordinates.

Parameters:

hInstance	[in] A handle to the instance.
nCount	[in] The number of points to translate.
aRealWorld	[in] An array of real world coordinates points.
aProjective	[in/out] An array to be filled with projective coordinates points.

Returns:

XN_STATUS_INVALID_OPERATION if this production node is not a depth generator.

XN_C_API XnStatus XN_C_DECL xnCreateDepthGenerator	(	XnContext *	pContext,
		XnNodeHandle *	phDepthGenerator,
		XnNodeQuery *	pQuery,
		XnEnumerationErrors *	pErrors
	)

Creates a depth generator.

Parameters:

pContext	[in] The context in which to create the depth generator
phDepthGenerator	[out] A handle to the created depth generator
pQuery	[in] Optional. Can be used to select which depth generator to create. If not specified, this function may create any depth generator that is available.
pErrors	[in] Optional. If provided, will be filled with information about depth generators that could not be created.

XN_C_API XnStatus XN_C_DECL xnGetDepthFieldOfView	(	XnNodeHandle	hInstance,
		XnFieldOfView *	pFOV
	)

Gets the Field-Of-View of the depth generator, in radians.

Parameters:

hInstance	[in] A handle to the instance.
pFOV	[in] A struct to be filled with field of view.

Returns:

XN_STATUS_INVALID_OPERATION if this production node is not a depth generator.

XN_C_API XnDepthPixel* XN_C_DECL xnGetDepthMap

(

XnNodeHandle

hInstance

)

Gets the current depth-map. This map is updated after a call to xnWaitAndUpdateData().

Parameters:

hInstance

[in] A handle to the instance.

Returns:

NULL if this production node is not a depth generator.

XN_C_API void XN_C_DECL xnGetDepthMetaData	(	XnNodeHandle	hInstance,
		XnDepthMetaData *	pMetaData
	)

Gets the current depth-map meta data.

Parameters:

hInstance	[in] A handle to the instance.
pMetaData	[in] The struct to be filled.

XN_C_API XnDepthPixel XN_C_DECL xnGetDeviceMaxDepth

(

XnNodeHandle

hInstance

)

Gets the maximum depth the device can produce.

Parameters:

hInstance

[in] A handle to the instance.

Returns:

-1 if this production node is not a depth generator.

XN_C_API XnStatus XN_C_DECL xnRegisterToDepthFieldOfViewChange	(	XnNodeHandle	hInstance,
		XnStateChangedHandler	handler,
		void *	pCookie,
		XnCallbackHandle *	phCallback
	)

Registers a callback function to field of view changes.

Parameters:

hInstance	[in] A handle to the instance.
handler	[in] A pointer to a function that will be called when field of view changes.
pCookie	[in] A user cookie that will be passed to the callback function.
phCallback	[out] Optional. Will be filled with a handle to be passed to xnUnregisterFromDepthFieldOfViewChange.

Returns:

XN_STATUS_INVALID_OPERATION if this production node does not support the User Position capability.

XN_C_API void XN_C_DECL xnUnregisterFromDepthFieldOfViewChange	(	XnNodeHandle	hInstance,
		XnCallbackHandle	hCallback
	)

Unregisters a callback function which was registered using xnRegisterToDepthFieldOfViewChange.

Parameters:

hInstance	[in] A handle to the instance.
hCallback	[in] The handle to the callback returned from xnRegisterToDepthFieldOfViewChange.