Utilities

General

XN_C_API XnStatus xnGetVersion (XnVersion *pVersion)

ProductionNodeType Utils

XN_C_API const XnChar * xnProductionNodeTypeToString (XnProductionNodeType Type)
XN_C_API XnStatus xnProductionNodeTypeFromString (const XnChar *strType, XnProductionNodeType *pType)
XN_C_API const XnBool xnIsTypeGenerator (XnProductionNodeType type)
 Checks if a certain production node type is a generator or not.

PixelFormat Utils

XN_C_API const XnChar * xnPixelFormatToString (XnPixelFormat format)
XN_C_API XnStatus xnPixelFormatFromString (const XnChar *strName, XnPixelFormat *pFormat)

Resolution Utilities

XN_C_API XnUInt32 xnResolutionGetXRes (XnResolution resolution)
XN_C_API XnUInt32 xnResolutionGetYRes (XnResolution resolution)
XN_C_API XnResolution xnResolutionGetFromXYRes (XnUInt32 xRes, XnUInt32 yRes)
XN_C_API XnResolution xnResolutionGetFromName (const XnChar *strName)
XN_C_API const XnChar * xnResolutionGetName (XnResolution resolution)

XnVersion Utilities

XN_C_API XnInt32 xnVersionCompare (const XnVersion *pVersion1, const XnVersion *pVersion2)
XN_C_API XnStatus xnVersionToString (const XnVersion *pVersion, XnChar *csResult, XnUInt32 nSize)

XnProductionNodeDescription Utilities

XN_C_API XnStatus xnProductionNodeDescriptionToString (const XnProductionNodeDescription *pDescription, XnChar *csResult, XnUInt32 nSize)

C Style Constructors

XN_C_API XnPoint3D xnCreatePoint3D (XnFloat x, XnFloat y, XnFloat z)
XN_C_API XnPlane3D xnCreatePlane3D (XnPoint3D ptPoint, XnVector3D vNormal)

Modules Registry Management

XN_C_API XnStatus xnRegisterModule (const XnChar *strModule, const XnChar *strConfigDir)
XN_C_API XnStatus xnUnregisterModule (const XnChar *strModule)
XN_C_API XnStatus xnPrintRegisteredModules ()

Global Licenses Registry Management

XN_C_API XnStatus xnRegisterGlobalLicense (XnLicense *pLicense)
XN_C_API XnStatus xnUnregisterGlobalLicense (XnLicense *pLicense)
XN_C_API XnStatus xnPrintRegisteredLicenses ()

MetaData Objects Management

XN_C_API XnOutputMetaData * xnAllocateOutputMetaData ()
XN_C_API void xnFreeOutputMetaData (const XnOutputMetaData *pMetaData)
XN_C_API XnStatus xnCopyOutputMetaData (XnOutputMetaData *pDestination, const XnOutputMetaData *pSource)
 Shallow-Copies an Output Meta Data object.
XN_C_API XnMapMetaData * xnAllocateMapMetaData ()
XN_C_API void xnFreeMapMetaData (const XnMapMetaData *pMetaData)
XN_C_API XnStatus xnCopyMapMetaData (XnMapMetaData *pDestination, const XnMapMetaData *pSource)
 Shallow-Copies a Map Meta Data object.
XN_C_API XnDepthMetaData * xnAllocateDepthMetaData ()
XN_C_API void xnFreeDepthMetaData (const XnDepthMetaData *pMetaData)
XN_C_API XnStatus xnCopyDepthMetaData (XnDepthMetaData *pDestination, const XnDepthMetaData *pSource)
 Shallow-Copies a Depth Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.
XN_C_API XnImageMetaData * xnAllocateImageMetaData ()
XN_C_API void xnFreeImageMetaData (const XnImageMetaData *pMetaData)
XN_C_API XnStatus xnCopyImageMetaData (XnImageMetaData *pDestination, const XnImageMetaData *pSource)
 Shallow-Copies an Image Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.
XN_C_API XnIRMetaData * xnAllocateIRMetaData ()
XN_C_API void xnFreeIRMetaData (const XnIRMetaData *pMetaData)
XN_C_API XnStatus xnCopyIRMetaData (XnIRMetaData *pDestination, const XnIRMetaData *pSource)
 Shallow-Copies an IR Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.
XN_C_API XnAudioMetaData * xnAllocateAudioMetaData ()
XN_C_API void xnFreeAudioMetaData (const XnAudioMetaData *pMetaData)
XN_C_API XnStatus xnCopyAudioMetaData (XnAudioMetaData *pDestination, const XnAudioMetaData *pSource)
 Shallow-Copies an Audio Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.
XN_C_API XnSceneMetaData * xnAllocateSceneMetaData ()
XN_C_API void xnFreeSceneMetaData (const XnSceneMetaData *pMetaData)
XN_C_API XnStatus xnCopySceneMetaData (XnSceneMetaData *pDestination, const XnSceneMetaData *pSource)
 Shallow-Copies a Scene Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Functions for Modules Implementors

XN_C_API XnStatus xnAutoEnumerateOverSingleInput (XnContext *pContext, XnNodeInfoList *pList, XnProductionNodeDescription *pDescription, const XnChar *strCreationInfo, XnProductionNodeType InputType, XnEnumerationErrors *pErrors, XnNodeQuery *pQuery)

Detailed Description

This page details some utility functions.

Function Documentation

XN_C_API XnAudioMetaData* xnAllocateAudioMetaData ( )

Allocates and returns an XnAudioMetaData object. When no longer needed, this object should be freed by calling xnFreeAudioMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnDepthMetaData* xnAllocateDepthMetaData ( )

Allocates and returns an XnDepthMetaData object. When no longer needed, this object should be freed by calling xnFreeDepthMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnImageMetaData* xnAllocateImageMetaData ( )

Allocates and returns an XnImageMetaData object. When no longer needed, this object should be freed by calling xnFreeImageMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnIRMetaData* xnAllocateIRMetaData ( )

Allocates and returns an XnIRMetaData object. When no longer needed, this object should be freed by calling xnFreeIRMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnMapMetaData* xnAllocateMapMetaData ( )

Allocates and returns an XnMapMetaData object. When no longer needed, this object should be freed by calling xnFreeMapMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnOutputMetaData* xnAllocateOutputMetaData ( )

Allocates and returns an XnOutputMetaData object. When no longer needed, this object should be freed by calling xnFreeOutputMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnSceneMetaData* xnAllocateSceneMetaData ( )

Allocates and returns an XnSceneMetaData object. When no longer needed, this object should be freed by calling xnFreeSceneMetaData().

Returns:
NULL if allocation failed.
XN_C_API XnStatus xnAutoEnumerateOverSingleInput ( XnContext *  pContext,
XnNodeInfoList *  pList,
XnProductionNodeDescription *  pDescription,
const XnChar *  strCreationInfo,
XnProductionNodeType  InputType,
XnEnumerationErrors *  pErrors,
XnNodeQuery *  pQuery 
)

A helper function for production nodes implementers. Enumerates needed child nodes (assuming there is only one needed input), and populates a list with production trees over that input.

Parameters:
pContext[in] OpenNI Context.
pList[in] The list to be populated.
pDescription[in] The description of the enumerated node.
strCreationInfo[in] [Optional] Additional creation info.
InputType[in] The type of the input required by this production node.
pErrors[in] The errors object passed to Enumerate method.
pQuery[in] [Optional] A filter to be used for finding the appropriate input.
XN_C_API XnStatus xnCopyAudioMetaData ( XnAudioMetaData *  pDestination,
const XnAudioMetaData *  pSource 
)

Shallow-Copies an Audio Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopyDepthMetaData ( XnDepthMetaData *  pDestination,
const XnDepthMetaData *  pSource 
)

Shallow-Copies a Depth Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopyImageMetaData ( XnImageMetaData *  pDestination,
const XnImageMetaData *  pSource 
)

Shallow-Copies an Image Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopyIRMetaData ( XnIRMetaData *  pDestination,
const XnIRMetaData *  pSource 
)

Shallow-Copies an IR Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopyMapMetaData ( XnMapMetaData *  pDestination,
const XnMapMetaData *  pSource 
)

Shallow-Copies a Map Meta Data object.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopyOutputMetaData ( XnOutputMetaData *  pDestination,
const XnOutputMetaData *  pSource 
)

Shallow-Copies an Output Meta Data object.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnStatus xnCopySceneMetaData ( XnSceneMetaData *  pDestination,
const XnSceneMetaData *  pSource 
)

Shallow-Copies a Scene Meta Data object. Note that the data buffer is not copied, and that both object will point to the same buffer.

Parameters:
pDestination[in] Destination object.
pSource[in] Source object.
XN_C_API XnPlane3D xnCreatePlane3D ( XnPoint3D  ptPoint,
XnVector3D  vNormal 
)
XN_C_API XnPoint3D xnCreatePoint3D ( XnFloat  x,
XnFloat  y,
XnFloat  z 
)
XN_C_API void xnFreeAudioMetaData ( const XnAudioMetaData *  pMetaData)

Frees a previously allocated XnAudioMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeDepthMetaData ( const XnDepthMetaData *  pMetaData)

Frees a previously allocated XnDepthMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeImageMetaData ( const XnImageMetaData *  pMetaData)

Frees a previously allocated XnImageMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeIRMetaData ( const XnIRMetaData *  pMetaData)

Frees a previously allocated XnIRMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeMapMetaData ( const XnMapMetaData *  pMetaData)

Frees a previously allocated XnMapMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeOutputMetaData ( const XnOutputMetaData *  pMetaData)

Frees a previously allocated XnOutputMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API void xnFreeSceneMetaData ( const XnSceneMetaData *  pMetaData)

Frees a previously allocated XnSceneMetaData object.

Parameters:
pMetaData[in] object to be freed.
XN_C_API XnStatus xnGetVersion ( XnVersion *  pVersion)

Gets current OpenNI version

Parameters:
pVersion[out] Current DLL version
XN_C_API const XnBool xnIsTypeGenerator ( XnProductionNodeType  type)

Checks if a certain production node type is a generator or not.

Parameters:
type[in] The type to check
XN_C_API XnStatus xnPixelFormatFromString ( const XnChar *  strName,
XnPixelFormat *  pFormat 
)

Gets pixel format by its name.

Parameters:
strName[in] Name of the pixel format.
pFormat[out] Pixel format.
XN_C_API const XnChar* xnPixelFormatToString ( XnPixelFormat  format)

Get the name of the pixel format.

Parameters:
format[in] Pixel Format
XN_C_API XnStatus xnPrintRegisteredLicenses ( )
XN_C_API XnStatus xnPrintRegisteredModules ( )
XN_C_API XnStatus xnProductionNodeDescriptionToString ( const XnProductionNodeDescription *  pDescription,
XnChar *  csResult,
XnUInt32  nSize 
)
XN_C_API XnStatus xnProductionNodeTypeFromString ( const XnChar *  strType,
XnProductionNodeType *  pType 
)

Gets a type from its string representation.

Parameters:
strType[in] The string representation of the type.
pType[out] The type of the production node.
XN_C_API const XnChar* xnProductionNodeTypeToString ( XnProductionNodeType  Type)

Gets a string representation of the production node type.

Parameters:
Type[in] The type of the production node.
XN_C_API XnStatus xnRegisterGlobalLicense ( XnLicense *  pLicense)
XN_C_API XnStatus xnRegisterModule ( const XnChar *  strModule,
const XnChar *  strConfigDir 
)
XN_C_API XnResolution xnResolutionGetFromName ( const XnChar *  strName)

Gets resolution by its name. If resolution is unknown, XN_RESOLUTION_CUSTOM is returned.

Parameters:
strName[in] Name of the resolution.
XN_C_API XnResolution xnResolutionGetFromXYRes ( XnUInt32  xRes,
XnUInt32  yRes 
)

Gets the resolution from the number of pixels in every row and column.

Parameters:
xRes[in] Number of pixels in a row.
yRes[in] Number of pixels in a column.
XN_C_API const XnChar* xnResolutionGetName ( XnResolution  resolution)

Get the name of the resolution.

Parameters:
resolution[in] Resolution.
XN_C_API XnUInt32 xnResolutionGetXRes ( XnResolution  resolution)

Gets the number of pixels in a row for given resolution.

Parameters:
resolution[in] The resolution to translate.
XN_C_API XnUInt32 xnResolutionGetYRes ( XnResolution  resolution)

Gets the number of pixels in a column for given resolution.

Parameters:
resolution[in] The resolution to translate.
XN_C_API XnStatus xnUnregisterGlobalLicense ( XnLicense *  pLicense)
XN_C_API XnStatus xnUnregisterModule ( const XnChar *  strModule)
XN_C_API XnInt32 xnVersionCompare ( const XnVersion *  pVersion1,
const XnVersion *  pVersion2 
)

Compares two versions.

Parameters:
pVersion1[in] First version.
pVersion2[in] Second version.
Returns:
<0 if first is smaller than second, 0 if same, >0 if first is greater than second.
XN_C_API XnStatus xnVersionToString ( const XnVersion *  pVersion,
XnChar *  csResult,
XnUInt32  nSize 
)

nao_openni
Author(s): Bener SUAY
autogenerated on Mon Jan 6 2014 11:27:52