Functions
XN_C_API XnUInt32 XN_C_DECL	xnGetSupportedUserPositionsCount (XnNodeHandle hInstance)

XN_C_API XnStatus XN_C_DECL	xnSetUserPosition (XnNodeHandle hInstance, XnUInt32 nIndex, const XnBoundingBox3D *pPosition)

XN_C_API XnStatus XN_C_DECL	xnGetUserPosition (XnNodeHandle hInstance, XnUInt32 nIndex, XnBoundingBox3D *pPosition)

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

XN_C_API void XN_C_DECL	xnUnregisterFromUserPositionChange (XnNodeHandle hInstance, XnCallbackHandle hCallback)

Detailed Description

Function Documentation

XN_C_API XnUInt32 XN_C_DECL xnGetSupportedUserPositionsCount ( XnNodeHandle hInstance )

Gets the number of user positions supported by this generator.

Parameters

hInstance [in] A handle to the instance.

Returns: 0 if this production node does not support the User Position capability.

XN_C_API XnStatus XN_C_DECL xnGetUserPosition	(	XnNodeHandle	hInstance,
		XnUInt32	nIndex,
		XnBoundingBox3D *	pPosition
	)

Gets the current user position.

Parameters

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

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

Registers a callback function to user position changes.

Parameters

hInstance	[in] A handle to the instance.
handler	[in] A pointer to a function that will be called when user position 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 xnUnregisterFromUserPositionChange.

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

XN_C_API XnStatus XN_C_DECL xnSetUserPosition	(	XnNodeHandle	hInstance,
		XnUInt32	nIndex,
		const XnBoundingBox3D *	pPosition
	)

Sets the current user position.

Parameters

hInstance	[in] A handle to the instance.
nIndex	[in] The user position to set.
pPosition	[in] The user position in the frame.

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

XN_C_API void XN_C_DECL xnUnregisterFromUserPositionChange	(	XnNodeHandle	hInstance,
		XnCallbackHandle	hCallback
	)

Unregisters a callback function which was registered using xnRegisterToUserPositionChange.

Parameters

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