OpenNI 1.5.4
Production Node Info

Functions

XN_C_API XnStatus XN_C_DECL xnNodeInfoAllocate (const XnProductionNodeDescription *pDescription, const XnChar *strCreationInfo, XnNodeInfoList *pNeededNodes, XnNodeInfo **ppNodeInfo)
 
XN_C_API void XN_C_DECL xnNodeInfoFree (XnNodeInfo *pNodeInfo)
 
XN_C_API XnStatus XN_C_DECL xnNodeInfoSetInstanceName (XnNodeInfo *pNodeInfo, const XnChar *strInstanceName)
 
XN_C_API const XnProductionNodeDescription *XN_C_DECL xnNodeInfoGetDescription (XnNodeInfo *pNodeInfo)
 
XN_C_API XnStatus XN_C_DECL xnNodeInfoGetTreeStringRepresentation (XnNodeInfo *pNodeInfo, XnChar *csResult, XnUInt32 nSize)
 
XN_C_API const XnChar *XN_C_DECL xnNodeInfoGetInstanceName (XnNodeInfo *pNodeInfo)
 
XN_C_API const XnChar *XN_C_DECL xnNodeInfoGetCreationInfo (XnNodeInfo *pNodeInfo)
 
XN_C_API XnNodeInfoList *XN_C_DECL xnNodeInfoGetNeededNodes (XnNodeInfo *pNodeInfo)
 
XN_C_API XnNodeHandle XN_C_DECL xnNodeInfoGetRefHandle (XnNodeInfo *pNodeInfo)
 
XN_C_API XnNodeHandle XN_C_DECL xnNodeInfoGetHandle (XnNodeInfo *pNodeInfo)
 
XN_C_API const void *XN_C_DECL xnNodeInfoGetAdditionalData (XnNodeInfo *pNodeInfo)
 

Detailed Description

This page describes the functionality of a production node info object. Each info object can represent a possible production node, or an existing one.

Function Documentation

◆ xnNodeInfoAllocate()

XN_C_API XnStatus XN_C_DECL xnNodeInfoAllocate ( const XnProductionNodeDescription * pDescription,
const XnChar * strCreationInfo,
XnNodeInfoList * pNeededNodes,
XnNodeInfo ** ppNodeInfo )

Allocates a node info object, and sets its details.

Parameters
pDescription[in] The description for the new node info object.
strCreationInfo[in] The creation info for the new node info object.
pNeededNodes[in] A list of node info's that are needed by the new node info.
ppNodeInfo[out] A pointer to pointer to the new node info object.

◆ xnNodeInfoFree()

XN_C_API void XN_C_DECL xnNodeInfoFree ( XnNodeInfo * pNodeInfo)

Frees a node info object

Parameters
pNodeInfo[in] The node info object to free.

◆ xnNodeInfoGetAdditionalData()

XN_C_API const void *XN_C_DECL xnNodeInfoGetAdditionalData ( XnNodeInfo * pNodeInfo)

Gets the additional data object attached to the node info object.

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetCreationInfo()

XN_C_API const XnChar *XN_C_DECL xnNodeInfoGetCreationInfo ( XnNodeInfo * pNodeInfo)

Gets the creation info of the production node.

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetDescription()

XN_C_API const XnProductionNodeDescription *XN_C_DECL xnNodeInfoGetDescription ( XnNodeInfo * pNodeInfo)

Gets the description of the production node.

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetHandle()

XN_C_API XnNodeHandle XN_C_DECL xnNodeInfoGetHandle ( XnNodeInfo * pNodeInfo)

◆ xnNodeInfoGetInstanceName()

XN_C_API const XnChar *XN_C_DECL xnNodeInfoGetInstanceName ( XnNodeInfo * pNodeInfo)

Gets the instance name of the production node.

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetNeededNodes()

XN_C_API XnNodeInfoList *XN_C_DECL xnNodeInfoGetNeededNodes ( XnNodeInfo * pNodeInfo)

Gets the list of needed nodes of the production node.

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetRefHandle()

XN_C_API XnNodeHandle XN_C_DECL xnNodeInfoGetRefHandle ( XnNodeInfo * pNodeInfo)

Gets the handle of the production node. For nodes that weren't created yet, NULL is returned. If a handle is returned, it should be released when no longer used by calling xnProductionNodeRelease().

Parameters
pNodeInfo[in] A production node info object.

◆ xnNodeInfoGetTreeStringRepresentation()

XN_C_API XnStatus XN_C_DECL xnNodeInfoGetTreeStringRepresentation ( XnNodeInfo * pNodeInfo,
XnChar * csResult,
XnUInt32 nSize )

Creates a printable representation of the production tree.

Parameters
pNodeInfo[in] A production node info object.
csResult[in] A buffer to be filled with the printable representation.
nSize[in] Size of the buffer.

◆ xnNodeInfoSetInstanceName()

XN_C_API XnStatus XN_C_DECL xnNodeInfoSetInstanceName ( XnNodeInfo * pNodeInfo,
const XnChar * strInstanceName )

Sets the instance name of the node info object. The name can only be set BEFORE the instance is created.

Parameters
pNodeInfo[in] A production node info object.
strInstanceName[in] The name to give to this instance.