#include <OpenNI.h>

类
class	FrameAllocator

class	NewFrameListener

Public 成员函数
	VideoStream ()

	VideoStream (OniStreamHandle handle)

	~VideoStream ()

Status	addNewFrameListener (NewFrameListener *pListener)

Status	create (const Device &device, SensorType sensorType)

void	destroy ()

void	filterSpeckles (void *buf, int newVal, int maxSpeckleSize, int maxDiff)

CameraSettings *	getCameraSettings ()

bool	getCropping (int pOriginX, int pOriginY, int pWidth, int pHeight) const

float	getHorizontalFieldOfView () const

int	getMaxPixelValue () const

int	getMinPixelValue () const

bool	getMirroringEnabled () const

Status	getProperty (int propertyId, void data, int dataSize) const

template<class T >
Status	getProperty (int propertyId, T *value) const

const SensorInfo &	getSensorInfo () const

ParamsRegistrationMode	getSoftwareRegistratorMode ()

float	getVerticalFieldOfView () const

VideoMode	getVideoMode () const

Status	invoke (int commandId, void *data, int dataSize)

template<class T >
Status	invoke (int commandId, T &value)

bool	isCommandSupported (int commandId) const

bool	isCroppingSupported () const

bool	isPropertySupported (int propertyId) const

bool	isValid () const

Status	readFrame (VideoFrameRef *pFrame)

void	removeNewFrameListener (NewFrameListener *pListener)

Status	resetCropping ()

Status	setCropping (int originX, int originY, int width, int height)

Status	setFrameBuffersAllocator (FrameAllocator *pAllocator)

Status	setMirroringEnabled (bool isEnabled)

Status	setProperty (int propertyId, const void *data, int dataSize)

template<class T >
Status	setProperty (int propertyId, const T &value)

void	setSoftwareRegistrator (ParamsRegistrationMode mode)

Status	setVideoMode (const VideoMode &videoMode)

Status	start ()

void	stop ()

友元
class	Device

详细描述

The VideoStream object encapsulates a single video stream from a device. Once created, it is used to start data flow from the device, and to read individual frames of data. This is the central class used to obtain data in OpenNI. It provides the ability to manually read data in a polling loop, as well as providing events and a Listener class that can be used to implement event-driven data acquisition.

Aside from the video data frames themselves, the class offers a number of functions used for obtaining information about a VideoStream. Field of view, available video modes, and minimum and maximum valid pixel values can all be obtained.

In addition to obtaining data, the VideoStream object is used to set all configuration properties that apply to a specific stream (rather than to an entire device). In particular, it is used to control cropping, mirroring, and video modes.

A pointer to a valid, initialized device that provides the desired stream type is required to create a stream.

Several video streams can be created to stream data from the same sensor. This is useful if several components of an application need to read frames separately.

While some device might allow different streams from the same sensor to have different configurations, most devices will have a single configuration for the sensor, shared by all streams.

构造及析构函数说明

◆ VideoStream() [1/2]

openni::VideoStream::VideoStream ( )

inline

Default constructor. Creates a new, non-valid VideoStream object. The object created will be invalid until its create() function is called with a valid Device.

◆ VideoStream() [2/2]

openni::VideoStream::VideoStream ( OniStreamHandle handle )

inlineexplicit

Handle constructor. Creates a VideoStream object based on the given initialized handle. This object will not destroy the underlying handle when destroy() or destructor is called

◆ ~VideoStream()

openni::VideoStream::~VideoStream ( )

inline

Destructor. The destructor calls the destroy() function, but it is considered a best practice for applications to call destroy() manually on any VideoStream that they run create() on.

成员函数说明

◆ addNewFrameListener()

Status openni::VideoStream::addNewFrameListener ( NewFrameListener * pListener )

inline

Adds a new Listener to receive this VideoStream onNewFrame event. See VideoStream::NewFrameListener for more information on implementing an event driven frame reading architecture. An instance of a listener can be added to only one source.

参数

[in] pListener Pointer to a VideoStream::NewFrameListener object (or a derivative) that will respond to this event.

返回: Status code indicating success or failure of the operation.

◆ create()

Status openni::VideoStream::create	(	const Device &	device,
		SensorType	sensorType
	)

inline

Creates a stream of frames from a specific sensor type of a specific device. You must supply a reference to a Device that supplies the sensor type requested. You can use Device::hasSensor() to check whether a given sensor is available on your target device before calling create().

参数

[in]	device	A reference to the Device you want to create the stream on.
[in]	sensorType	The type of sensor the stream should produce data from.

返回: Status code indicating success or failure for this operation.

◆ destroy()

void openni::VideoStream::destroy ( )

inline

Destroy this stream. This function is currently called automatically by the destructor, but it is considered a best practice for applications to manually call this function on any VideoStream that they call create() for.

◆ filterSpeckles()

void openni::VideoStream::filterSpeckles	(	void *	buf,
		int	newVal,
		int	maxSpeckleSize,
		int	maxDiff
	)

inline

◆ getCameraSettings()

CameraSettings* openni::VideoStream::getCameraSettings ( )

inline

Gets an object through which several camera settings can be configured.

返回: NULL if the stream doesn't support camera settings.

◆ getCropping()

bool openni::VideoStream::getCropping	(	int *	pOriginX,
		int *	pOriginY,
		int *	pWidth,
		int *	pHeight
	)		const

inline

Obtains the current cropping settings for this stream.

参数

[out]	pOriginX	X coordinate of the upper left corner of the cropping window
[out]	pOriginY	Y coordinate of the upper left corner of the cropping window
[out]	pWidth	Horizontal width of the cropping window, in pixels
[out]	pHeight	Vertical width of the cropping window, in pixels returns true if cropping is currently enabled, false if it is not.

◆ getHorizontalFieldOfView()

float openni::VideoStream::getHorizontalFieldOfView ( ) const

inline

Gets the horizontal field of view of frames received from this stream.

返回: Horizontal field of view, in radians.

◆ getMaxPixelValue()

int openni::VideoStream::getMaxPixelValue ( ) const

inline

Provides the maximum possible value for pixels obtained by this stream. This is most useful for getting the maximum possible value of depth streams.

返回: Maximum possible pixel value.

◆ getMinPixelValue()

int openni::VideoStream::getMinPixelValue ( ) const

inline

Provides the smallest possible value for pixels obtains by this VideoStream. This is most useful for getting the minimum possible value that will be reported by a depth stream.

返回: Minimum possible pixel value that can come from this stream.

◆ getMirroringEnabled()

bool openni::VideoStream::getMirroringEnabled ( ) const

inline

Check whether mirroring is currently turned on for this stream.

返回: true if mirroring is currently enabled, false otherwise.

◆ getProperty() [1/2]

Status openni::VideoStream::getProperty	(	int	propertyId,
		void *	data,
		int *	dataSize
	)		const

inline

General function for obtaining the value of stream specific properties. There are convenience functions available for all commonly used properties, so it is not expected that applications will make direct use of the getProperty function very often.

参数

[in]	propertyId	The numerical ID of the property to be queried.
[out]	data	Place to store the value of the property.
[in,out]	dataSize	IN: Size of the buffer passed in the `data` argument. OUT: the actual written size.

返回: Status code indicating success or failure of this operation.

◆ getProperty() [2/2]

template<class T >

Status openni::VideoStream::getProperty	(	int	propertyId,
		T *	value
	)		const

inline

Function for getting the value from a property using an arbitrary output type. There are convenience functions available for all commonly used properties, so it is not expected that applications will make direct use of this function very often.

模板参数

[in]	T Data type of the value to be read.

参数

[in]	propertyId	The numerical ID of the property to be read.
[in,out]	value	Pointer to a place to store the value read from the property.

返回: Status code indicating success or failure of this operation.

◆ getSensorInfo()

const SensorInfo& openni::VideoStream::getSensorInfo ( ) const

inline

Provides the SensorInfo object associated with the sensor that is producing this VideoStream. Note that this function will return NULL if the stream has not yet been initialized with the create() function.

SensorInfo is useful primarily as a means of learning which video modes are valid for this VideoStream.

返回: Reference to the SensorInfo object associated with the sensor providing this stream.

◆ getSoftwareRegistratorMode()

ParamsRegistrationMode openni::VideoStream::getSoftwareRegistratorMode ( )

inline

◆ getVerticalFieldOfView()

float openni::VideoStream::getVerticalFieldOfView ( ) const

inline

Gets the vertical field of view of frames received from this stream.

返回: Vertical field of view, in radians.

◆ getVideoMode()

VideoMode openni::VideoStream::getVideoMode ( ) const

inline

Get the current video mode information for this video stream. This includes its resolution, fps and stream format.

返回: Current video mode information for this video stream.

◆ invoke() [1/2]

Status openni::VideoStream::invoke	(	int	commandId,
		void *	data,
		int	dataSize
	)

inline

Invokes a command that takes an arbitrary data type as its input. It is not expected that application code will need this function frequently, as all commonly used properties have higher level functions provided.

参数

[in]	commandId	Numerical code of the property to be invoked.
[in]	data	Data to be passed to the property.
[in]	dataSize	size of the buffer passed in `data`.

返回: Status code indicating success or failure of this operation.

◆ invoke() [2/2]

template<class T >

Status openni::VideoStream::invoke	(	int	commandId,
		T &	value
	)

inline

Invokes a command that takes an arbitrary data type as its input. It is not expected that application code will need this function frequently, as all commonly used properties have higher level functions provided.

模板参数

[in]	T Type of data to be passed to the property.

参数

[in]	commandId	Numerical code of the property to be invoked.
[in]	value	Data to be passed to the property.

返回: Status code indicating success or failure of this operation.

◆ isCommandSupported()

bool openni::VideoStream::isCommandSupported ( int commandId ) const

inline

Checks if a specific command is supported by the video stream.

参数

[in] commandId Command to be checked.

返回: true if the command is supported, false otherwise.

◆ isCroppingSupported()

bool openni::VideoStream::isCroppingSupported ( ) const

inline

Checks whether this stream supports cropping.

返回: true if the stream supports cropping, false if it does not.

◆ isPropertySupported()

bool openni::VideoStream::isPropertySupported ( int propertyId ) const

inline

Checks if a specific property is supported by the video stream.

参数

[in] propertyId Property to be checked.

返回: true if the property is supported, false otherwise.

◆ isValid()

bool openni::VideoStream::isValid ( ) const

inline

Checks to see if this object has been properly initialized and currently points to a valid stream.

返回: true if this object has been previously initialized, false otherwise.

◆ readFrame()

Status openni::VideoStream::readFrame ( VideoFrameRef * pFrame )

inline

Read the next frame from this video stream, delivered as a VideoFrameRef. This is the primary method for manually obtaining frames of video data.
If no new frame is available, the call will block until one is available. To avoid blocking, use VideoStream::Listener to implement an event driven architecture. Another alternative is to use OpenNI::waitForAnyStream() to wait for new frames from several streams.

参数

[out] pFrame Pointer to a VideoFrameRef object to hold the reference to the new frame.

返回: Status code to indicated success or failure of this function.

◆ removeNewFrameListener()

void openni::VideoStream::removeNewFrameListener ( NewFrameListener * pListener )

inline

Removes a Listener from this video stream list. The listener removed will no longer receive new frame events from this stream.

参数

[in] pListener Pointer to the listener object to be removed.

◆ resetCropping()

Status openni::VideoStream::resetCropping ( )

inline

Disables cropping.

返回: Status code indicating success or failure of this operation.

◆ setCropping()

Status openni::VideoStream::setCropping	(	int	originX,
		int	originY,
		int	width,
		int	height
	)

inline

Changes the cropping settings for this stream. You can use the isCroppingSupported() function to make sure cropping is supported before calling this function.

参数

[in]	originX	New X coordinate of the upper left corner of the cropping window.
[in]	originY	New Y coordinate of the upper left corner of the cropping window.
[in]	width	New horizontal width for the cropping window, in pixels.
[in]	height	New vertical height for the cropping window, in pixels.

返回: Status code indicating success or failure of this operation.

◆ setFrameBuffersAllocator()

Status openni::VideoStream::setFrameBuffersAllocator ( FrameAllocator * pAllocator )

inline

Sets the frame buffers allocator for this video stream.

参数

[in] pAllocator Pointer to the frame buffers allocator object. Pass NULL to return to default frame allocator.

返回: ONI_STATUS_OUT_OF_FLOW The frame buffers allocator cannot be set while stream is streaming.

◆ setMirroringEnabled()

Status openni::VideoStream::setMirroringEnabled ( bool isEnabled )

inline

Enable or disable mirroring for this stream.

参数

[in] isEnabled true to enable mirroring, false to disable it.

返回: Status code indicating the success or failure of this operation.

◆ setProperty() [1/2]

Status openni::VideoStream::setProperty	(	int	propertyId,
		const void *	data,
		int	dataSize
	)

inline

General function for setting the value of stream specific properties. There are convenience functions available for all commonly used properties, so it is not expected that applications will make direct use of the setProperty function very often.

参数

[in]	propertyId	The numerical ID of the property to be set.
[in]	data	Place to store the data to be written to the property.
[in]	dataSize	Size of the data to be written to the property.

返回: Status code indicating success or failure of this operation.

◆ setProperty() [2/2]

template<class T >

Status openni::VideoStream::setProperty	(	int	propertyId,
		const T &	value
	)

inline

Function for setting a value of a stream property using an arbitrary input type. There are convenience functions available for all commonly used properties, so it is not expected that applications will make direct use of this function very often.

模板参数

[in]	T Data type of the value to be passed to the property.

参数

[in]	propertyId	The numerical ID of the property to be set.
[in]	value	Data to be sent to the property.

返回: Status code indicating success or failure of this operation.

◆ setSoftwareRegistrator()

void openni::VideoStream::setSoftwareRegistrator ( ParamsRegistrationMode mode )

inline

◆ setVideoMode()

Status openni::VideoStream::setVideoMode ( const VideoMode & videoMode )

inline

Changes the current video mode of this stream. Recommended practice is to use Device::getSensorInfo(), and then SensorInfo::getSupportedVideoModes() to obtain a list of valid video mode settings for this stream. Then, pass a valid VideoMode to setVideoMode to ensure correct operation.

参数

[in] videoMode Desired new video mode for this stream. returns Status code indicating success or failure of this operation.

◆ start()

Status openni::VideoStream::start ( )

inline

Starts data generation from this video stream.

◆ stop()

void openni::VideoStream::stop ( )

inline

Stops data generation from this video stream.

友元及相关函数文档

◆ Device

friend class Device

friend

该类的文档由以下文件生成:

OpenNI.h

类

Public 成员函数

友元

详细描述

构造及析构函数说明

◆ VideoStream() [1/2]

◆ VideoStream() [2/2]

◆ ~VideoStream()

成员函数说明

◆ addNewFrameListener()

◆ create()

◆ destroy()

◆ filterSpeckles()

◆ getCameraSettings()

◆ getCropping()

◆ getHorizontalFieldOfView()

◆ getMaxPixelValue()

◆ getMinPixelValue()

◆ getMirroringEnabled()

◆ getProperty() [1/2]

◆ getProperty() [2/2]

◆ getSensorInfo()

◆ getSoftwareRegistratorMode()

◆ getVerticalFieldOfView()

◆ getVideoMode()

◆ invoke() [1/2]

◆ invoke() [2/2]

◆ isCommandSupported()

◆ isCroppingSupported()

◆ isPropertySupported()

◆ isValid()

◆ readFrame()

◆ removeNewFrameListener()

◆ resetCropping()

◆ setCropping()

◆ setFrameBuffersAllocator()

◆ setMirroringEnabled()

◆ setProperty() [1/2]

◆ setProperty() [2/2]

◆ setSoftwareRegistrator()

◆ setVideoMode()

◆ start()

◆ stop()

友元及相关函数文档

◆ Device