DirectShow file input stream object. More...

#include <vidl_dshow_file_istream.h>

Inheritance diagram for vidl_dshow_file_istream:

Public Member Functions
	vidl_dshow_file_istream (const vcl_string &name)
	Constructor - from a string containing the file name.
virtual	~vidl_dshow_file_istream ()
	Destructor.
virtual bool	is_open () const
	Return true if the stream is open for reading.
virtual bool	is_valid () const
	Return true if the stream is in a valid state.
virtual bool	is_seekable () const
	Return true if the stream supports seeking.
virtual int	num_frames () const
	Return the number of frames if known.
virtual unsigned int	frame_number () const
	Return the current frame number.
virtual unsigned int	width () const
	Return the width of each frame.
virtual unsigned int	height () const
	Return the height of each frame.
virtual vidl_pixel_format	format () const
	Return the pixel format.
virtual double	frame_rate () const
	Return the frame rate (FPS, 0.0 if unspecified).
virtual double	duration () const
	Return the duration in seconds (0.0 if unknown).
virtual void	close ()
	Close the stream.
virtual bool	advance ()
	Advance to the next frame (but don't acquire an image).
virtual bool	advance_wait ()
	Initiate advance and wait for completion; synchronous advance.
virtual bool	advance_start ()
	Initiate advance and return immediately; asynchronous advance.
virtual bool	is_frame_available () const
	Returns true if the advance has finished and a frame is available.
virtual vidl_frame_sptr	read_frame ()
	Read the next frame from the stream (advance and acquire).
virtual vidl_frame_sptr	current_frame ()
	Return the current frame in the stream.
virtual bool	seek_frame (unsigned int frame_number)
	Seek to the given frame number.
void	ref ()
	Increment reference count.
void	unref ()
	Decrement reference count.
int	ref_count () const
	Number of objects referring to this data.
Private Member Functions
	vidl_dshow_file_istream (const vidl_dshow_file_istream &)
vidl_dshow_file_istream &	operator= (const vidl_dshow_file_istream &)
void	open (const vcl_string &filename)
	Open a video file.
Private Attributes
CComPtr< IFilterGraph2 >	filter_graph_
CComPtr< IMediaControl >	media_control_
CComPtr< IMediaSeeking >	media_seeking_
CComPtr< IMediaEventEx >	media_event_
CComPtr< ISampleGrabber >	sample_grabber_
vcl_vector< unsigned char >	buffer_ [2]
double	buffer_time_ [2]
unsigned char	buffer_index_
unsigned int	buffer_width_
unsigned int	buffer_height_
vidl_pixel_format	buffer_pixel_format_
unsigned int	frame_index_
REFERENCE_TIME	end_position_
bool	is_time_format_frame_
bool	is_valid_
DWORD	register_
	ID in Running Object Table (ROT), for debugging with GraphEdit.

Detailed Description

DirectShow file input stream object.

This is still in an experimental stage, but should be usable. It should be able to open avi and wmv files as long as the system has the available decoder, in the case of compressed video.

DirectShow is very flexible and complex. Therefore we have taken the approach to throw an exception or abort in the case where something that is not supported fails, rather than try to parse through every error and provide an alternative. However, we welcome any feedback on desired features to make vidl_dshow_file_istream more usable in the VXL context.

Definition at line 50 of file vidl_dshow_file_istream.h.

Constructor & Destructor Documentation

vidl_dshow_file_istream::vidl_dshow_file_istream ( const vcl_string & name )

Constructor - from a string containing the file name.

Constructor - from a string containing a device name.

Definition at line 19 of file vidl_dshow_file_istream.cxx.

vidl_dshow_file_istream::~vidl_dshow_file_istream ( void ) [virtual]

Destructor.

Definition at line 34 of file vidl_dshow_file_istream.cxx.

vidl_dshow_file_istream::vidl_dshow_file_istream ( const vidl_dshow_file_istream & ) [private]

Member Function Documentation

virtual bool vidl_dshow_file_istream::advance ( ) [inline, virtual]

Advance to the next frame (but don't acquire an image).

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation