OpenNI 1.5.4: Alternative View Point Capability

OpenNI

Alternative View Point Capability

Functions

XN_C_API XnBool XN_C_DECL xnIsViewPointSupported (XnNodeHandle hInstance, XnNodeHandle hOther)
XN_C_API XnStatus XN_C_DECL xnSetViewPoint (XnNodeHandle hInstance, XnNodeHandle hOther)
XN_C_API XnStatus XN_C_DECL xnResetViewPoint (XnNodeHandle hInstance)
XN_C_API XnBool XN_C_DECL xnIsViewPointAs (XnNodeHandle hInstance, XnNodeHandle hOther)
XN_C_API XnStatus XN_C_DECL xnRegisterToViewPointChange (XnNodeHandle hInstance, XnStateChangedHandler handler, void *pCookie, XnCallbackHandle *phCallback)
XN_C_API void XN_C_DECL xnUnregisterFromViewPointChange (XnNodeHandle hInstance, XnCallbackHandle hCallback)

Detailed Description

The Alternative View Point capability (XN_CAPABILITY_ALTERNATIVE_VIEW_POINT) allows a Generator to transform its data to appear as if the sensor is placed in another location. For example, when more than one sensor is active (or one sensor that produces several outputs coming from close locations, yet not the same one), one sensor can change its data to appear as if coming from the location of the other sensor, so that both data buffers represent the same (for example depth and image maps, where the same coordinates in the map represent the same location is the scene).


Function Documentation

XN_C_API XnBool XN_C_DECL xnIsViewPointAs ( XnNodeHandle  hInstance,
XnNodeHandle  hOther 
)

Checks if current view point is as if coming from the other node view point.

Parameters:
hInstance[in] A handle to the instance.
hOther[in] The view point to be checked.
XN_C_API XnBool XN_C_DECL xnIsViewPointSupported ( XnNodeHandle  hInstance,
XnNodeHandle  hOther 
)

Checks if this generator can change its output to look like it was taken from a different location, represented by another generator.

Parameters:
hInstance[in] A handle to the instance.
hOther[in] The view point to be checked.
Returns:
TRUE if view point is supported, FALSE otherwise.
XN_C_API XnStatus XN_C_DECL xnRegisterToViewPointChange ( XnNodeHandle  hInstance,
XnStateChangedHandler  handler,
void *  pCookie,
XnCallbackHandle phCallback 
)

Registers a callback function to view point changes.

Parameters:
hInstance[in] A handle to the instance.
handler[in] A pointer to a function that will be called when view point 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 xnUnregisterFromViewPointChange().
XN_C_API XnStatus XN_C_DECL xnResetViewPoint ( XnNodeHandle  hInstance)

Sets the view point of this generator to its normal one.

Parameters:
hInstance[in] A handle to the instance.
XN_C_API XnStatus XN_C_DECL xnSetViewPoint ( XnNodeHandle  hInstance,
XnNodeHandle  hOther 
)

Sets the view point of this generator to look like as if placed at another generator location.

Parameters:
hInstance[in] A handle to the instance.
hOther[in] The view point to be set.
XN_C_API void XN_C_DECL xnUnregisterFromViewPointChange ( XnNodeHandle  hInstance,
XnCallbackHandle  hCallback 
)

Unregisters a callback function which was registered using xnRegisterToViewPointChange().

Parameters:
hInstance[in] A handle to the instance.
hCallback[in] The handle to the callback returned from xnRegisterToViewPointChange().
Generated on Wed May 16 2012 10:16:06 for OpenNI 1.5.4 by   doxygen 1.7.5.1