OpenNI 1.5.4: xn::MapMetaData Class Reference

OpenNI

#include <XnCppWrapper.h>

Inheritance diagram for xn::MapMetaData:

List of all members.

Public Member Functions

 MapMetaData (XnPixelFormat format, const XnUInt8 **ppData)
XnUInt32 XRes () const
XnUInt32 & XRes ()
XnUInt32 YRes () const
XnUInt32 & YRes ()
XnUInt32 XOffset () const
XnUInt32 & XOffset ()
XnUInt32 YOffset () const
XnUInt32 & YOffset ()
XnUInt32 FullXRes () const
XnUInt32 & FullXRes ()
XnUInt32 FullYRes () const
XnUInt32 & FullYRes ()
XnUInt32 FPS () const
XnUInt32 & FPS ()
XnPixelFormat PixelFormat () const
const XnMapMetaDataGetUnderlying () const
XnMapMetaDataGetUnderlying ()
XnUInt32 BytesPerPixel () const
XnStatus AllocateData (XnUInt32 nXRes, XnUInt32 nYRes)
XnStatus ReAdjust (XnUInt32 nXRes, XnUInt32 nYRes, const XnUInt8 *pExternalBuffer)

Protected Member Functions

XnPixelFormatPixelFormatImpl ()

Detailed Description

The MapMetaData class is a base class for providing the fast data access functionality for the frame object saved in metadata. This functionality is applicable to all generator nodes that have an associated metadata object.

MapMetaData is the next metadata class in the metadata hierarchy after the OutputMetaData class.

The MapMetaData class - like OutputMetaData - is never instantiated; it is a base class of the OpenNI metadata class hierarchy.


Constructor & Destructor Documentation

xn::MapMetaData::MapMetaData ( XnPixelFormat  format,
const XnUInt8 **  ppData 
) [inline]

Ctor. Intended for use by inheriting classes.

Parameters:
[in]formatPixel Format
[in]ppDataA pointer to the data member of the meta data object

Member Function Documentation

XnStatus xn::MapMetaData::AllocateData ( XnUInt32  nXRes,
XnUInt32  nYRes 
) [inline]

Allocates a writable buffer. If a previous buffer was allocated it will be freed (or reused if possible).

Parameters:
[in]nXResThe number of required columns in the map.
[in]nYResThe number of required rows in the map.
XnUInt32 xn::MapMetaData::BytesPerPixel ( ) const [inline]

Gets the number of bytes each pixel occupies.

XnUInt32 xn::MapMetaData::FPS ( ) const [inline]

Gets the FPS in which frame was generated.

XnUInt32& xn::MapMetaData::FPS ( ) [inline]

Gets the FPS in which frame was generated.

XnUInt32 xn::MapMetaData::FullXRes ( ) const [inline]

Gets the number of columns in the full frame (entire field-of-view, ignoring cropping).

XnUInt32& xn::MapMetaData::FullXRes ( ) [inline]

Gets the number of columns in the full frame (entire field-of-view, ignoring cropping).

XnUInt32 xn::MapMetaData::FullYRes ( ) const [inline]

Gets the number of rows in the full frame (entire field-of-view, ignoring cropping).

XnUInt32& xn::MapMetaData::FullYRes ( ) [inline]

Gets the number of rows in the full frame (entire field-of-view, ignoring cropping).

const XnMapMetaData* xn::MapMetaData::GetUnderlying ( ) const [inline]

Gets the C object that is wrapped by this object.

Reimplemented from xn::OutputMetaData.

Reimplemented in xn::SceneMetaData, xn::IRMetaData, xn::ImageMetaData, and xn::DepthMetaData.

XnMapMetaData* xn::MapMetaData::GetUnderlying ( ) [inline]

Gets the C object that is wrapped by this object.

Reimplemented from xn::OutputMetaData.

Reimplemented in xn::SceneMetaData, xn::IRMetaData, xn::ImageMetaData, and xn::DepthMetaData.

XnPixelFormat xn::MapMetaData::PixelFormat ( ) const [inline]

Gets the pixel format of the pixel-map.

Reimplemented in xn::ImageMetaData.

XnPixelFormat& xn::MapMetaData::PixelFormatImpl ( ) [inline, protected]
XnStatus xn::MapMetaData::ReAdjust ( XnUInt32  nXRes,
XnUInt32  nYRes,
const XnUInt8 *  pExternalBuffer 
) [inline]

Changes dimensions of the pixel-map.

Parameters:
[in]nXResNumber of columns in the map
[in]nYResNumber of rows in the map
[in]pExternalBufferOptional. An external buffer to be used. If NULL is passed, a buffer will be allocated.
XnUInt32 xn::MapMetaData::XOffset ( ) const [inline]

Gets the cropping area X offset of the frame object saved in this object. This is the horizontal offset, measured in units of pixel columns, of the buffer within the field of view.

Remarks

The X offset is 0 if cropping is disabled (see XnCropping).

XnUInt32& xn::MapMetaData::XOffset ( ) [inline]

Gets the cropping area X offset of the frame object saved in this object. This is the horizontal offset, measured in units of pixel columns, of the buffer within the field of view.

Remarks

The X offset is 0 if cropping is disabled (see XnCropping).

XnUInt32 xn::MapMetaData::XRes ( ) const [inline]

Gets the frame X resolution of the frame object saved in this object. The X resolution is the actual number of columns in the frame after any required cropping has been applied.

XnUInt32& xn::MapMetaData::XRes ( ) [inline]

Gets the frame X resolution of the frame object saved in this object. The X resolution is the actual number of columns in the frame after any required cropping has been applied.

XnUInt32 xn::MapMetaData::YOffset ( ) const [inline]

Gets the cropping area Y offset of the frame object saved in this object. This is the vertical offset, measured in units of pixel rows, of the buffer within the field of view.

Remarks

The Y offset is 0 if cropping is disabled (see XnCropping).

XnUInt32& xn::MapMetaData::YOffset ( ) [inline]

Gets the cropping area Y offset of the frame object saved in this object. This is the vertical offset, measured in units of pixel rows, of the buffer within the field of view.

Remarks

The Y offset is 0 if cropping is disabled (see XnCropping).

XnUInt32 xn::MapMetaData::YRes ( ) const [inline]

Gets the frame Y resolution of the frame object saved in this object. The Y resolution is the actual number of rows in the frame after any required cropping has been applied.

XnUInt32& xn::MapMetaData::YRes ( ) [inline]

Gets the frame Y resolution of the frame object saved in this object. The Y resolution is the actual number of rows in the frame after any required cropping has been applied.


The documentation for this class was generated from the following file:
Generated on Wed May 16 2012 10:16:06 for OpenNI 1.5.4 by   doxygen 1.7.5.1