ofDirectShowGrabberfile

ofDirectShowGrabberclass

Functions

ofDirectShowGrabber ()

ofDirectShowGrabber()

~ofDirectShowGrabber ()

~ofDirectShowGrabber()

listDevices ()

ofVideoDevice listDevices() const

Get a list of available video grabber devices.

Returns: a std::vector of ofVideoDevice objects.

Implements ofBaseVideoGrabber.

setup ()

bool setup(int w, int h)

Set up the grabber with the requested width and height.

Some video grabbers may take the requested width and height as a hint and choose the closest dimensions to those requested. Users can check the actual width and height by calling getWidth() and getHeight() respectively after a successful setup.

Parameters

w	the requested width.
h	the requested height.

Returns: true if the video grabber was set up successfully.

Implements ofBaseVideoGrabber.

update ()

void update()

Update the object's state.

Implements ofBaseUpdates.

isFrameNew ()

bool isFrameNew() const

Returns: true if the pixel data was updated since the last call to update().

Implements ofBaseVideo.

isInitialized ()

bool isInitialized() const

Determine if the video source is initialized.

Video sources such as cameras are often initialized with a setup() method. Video sources such as movie players are often initialized with a load() method.

Returns: true if the video source is initialized.

Implements ofBaseVideo.

setPixelFormat ()

bool setPixelFormat(ofPixelFormat pixelFormat)

Set the requested ofPixelFormat.

Parameters

pixelFormat the requested ofPixelFormat.

Returns: true if the format was successfully changed.

Implements ofBaseVideo.

getPixelFormat ()

ofPixelFormat getPixelFormat() const

Returns: the current ofPixelFormat.

Implements ofBaseVideo.

getPixels ()

ofPixels getPixels()

Get a reference to the underlying ofPixels.

Returns: a reference the underlying ofPixels.

Implements ofBaseHasPixels_< T >.

ofPixels getPixels() const

Get a const reference to the underlying ofPixels.

Returns: a const reference the underlying ofPixels.

Implements ofBaseHasPixels_< T >.

close ()

void close()

Close the video source.

Implements ofBaseVideo.

clearMemory ()

void clearMemory()

videoSettings ()

void videoSettings()

Request a native GUI for video grabber settings.

Note: This feature may not be implemented by all video grabbers.

Reimplemented from ofBaseVideoGrabber.

getWidth ()

float getWidth() const

Get the video grabber's width.

Returns: the video grabber's width.

Implements ofBaseVideoGrabber.

getHeight ()

float getHeight() const

Get the video grabber's height.

Returns: the video grabber's height.

Implements ofBaseVideoGrabber.

setVerbose ()

void setVerbose(bool bTalkToMe)

Set the video grabber's hardware verbosity level.

Parameters

bTalkToMe true if verbose grabber logging feedback is required.

Reimplemented from ofBaseVideoGrabber.

setDeviceID ()

void setDeviceID(int _deviceID)

Set the video grabber's device ID.

In most cases, a user can choose a specific grabber source by ID. This device ID information should be available to the user via the listDevices() method.

Parameters

deviceID The device ID provided by listDevices().

Reimplemented from ofBaseVideoGrabber.

setDesiredFrameRate ()

void setDesiredFrameRate(int framerate)

Set the video grabber's desired frame rate.

Many video grabbers support user-specified frame rates. This frame rate should be considered a hint for the video grabber and is not guaranteed.

Parameters

framerate the desired frame rate.

Reimplemented from ofBaseVideoGrabber.

getTexturePtr ()

ofTexture getTexturePtr()

Get the video grabber's internal ofTexture pointer if available.

Note: Subclasses should implement this method only if internal API can upload video grabber pixels directly to an ofTexture.

Returns: the internal ofTexture pointer or NULL if not available.