Utilities
[C Reference]

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)

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 XnOutputMetaDataxnAllocateOutputMetaData ()
XN_C_API void xnFreeOutputMetaData (const XnOutputMetaData *pMetaData)
XN_C_API XnStatus xnCopyOutputMetaData (XnOutputMetaData *pDestination, const XnOutputMetaData *pSource)
XN_C_API XnMapMetaDataxnAllocateMapMetaData ()
XN_C_API void xnFreeMapMetaData (const XnMapMetaData *pMetaData)
XN_C_API XnStatus xnCopyMapMetaData (XnMapMetaData *pDestination, const XnMapMetaData *pSource)
XN_C_API XnDepthMetaDataxnAllocateDepthMetaData ()
XN_C_API void xnFreeDepthMetaData (const XnDepthMetaData *pMetaData)
XN_C_API XnStatus xnCopyDepthMetaData (XnDepthMetaData *pDestination, const XnDepthMetaData *pSource)
XN_C_API XnImageMetaDataxnAllocateImageMetaData ()
XN_C_API void xnFreeImageMetaData (const XnImageMetaData *pMetaData)
XN_C_API XnStatus xnCopyImageMetaData (XnImageMetaData *pDestination, const XnImageMetaData *pSource)
XN_C_API XnIRMetaDataxnAllocateIRMetaData ()
XN_C_API void xnFreeIRMetaData (const XnIRMetaData *pMetaData)
XN_C_API XnStatus xnCopyIRMetaData (XnIRMetaData *pDestination, const XnIRMetaData *pSource)
XN_C_API XnAudioMetaDataxnAllocateAudioMetaData ()
XN_C_API void xnFreeAudioMetaData (const XnAudioMetaData *pMetaData)
XN_C_API XnStatus xnCopyAudioMetaData (XnAudioMetaData *pDestination, const XnAudioMetaData *pSource)
XN_C_API XnSceneMetaDataxnAllocateSceneMetaData ()
XN_C_API void xnFreeSceneMetaData (const XnSceneMetaData *pMetaData)
XN_C_API XnStatus xnCopySceneMetaData (XnSceneMetaData *pDestination, const XnSceneMetaData *pSource)

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 
)