OpenNI 1.5.4: User Position Capability

OpenNI

User Position Capability

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

The User Position capability (XN_CAPABILITY_USER_POSITION) allows a Depth Generator to change its output, so that it would be optimized in specific locations in the scene.


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:
hInstance[in] A handle to the instance.
nIndex[in] The user position to get.
pPosition[out] The user position.
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.
Generated on Wed May 16 2012 10:16:06 for OpenNI 1.5.4 by   doxygen 1.7.5.1