contrib/brl/bbas/vidl2/vidl2_istream.h

Go to the documentation of this file.

// This is brl/bbas/vidl2/vidl2_istream.h
#ifndef vidl2_istream_h_
#define vidl2_istream_h_
#ifdef VCL_NEEDS_PRAGMA_INTERFACE
#pragma interface
#endif
//:
// \file
// \brief A base class for input video streams
//
// \author Matt Leotta
// \date 19 Dec 2005

#include "vidl2_frame_sptr.h"
#include "vidl2_pixel_format.h"

//: A base class for input video streams
class vidl2_istream
{
 public:
  //: Constructor
  vidl2_istream() : ref_count_(0) {}
  //: Destructor
  virtual ~vidl2_istream() {}

  //: Return true if the stream is open for reading
  virtual bool is_open() const = 0;

  //: Return true if the stream is in a valid state
  virtual bool is_valid() const = 0;

  //: Return true if the stream support seeking
  virtual bool is_seekable() const = 0;

  //: Return the number of frames if known
  //  returns -1 for non-seekable streams
  virtual int num_frames() const = 0;

  //: Return the current frame number
  virtual unsigned int frame_number() const = 0;

  //: Return the width of each frame
  virtual unsigned int width() const = 0;

  //: Return the height of each frame
  virtual unsigned int height() const = 0;

  //: Return the pixel format
  virtual vidl2_pixel_format format() const = 0;

  //: Return the frame rate (FPS, 0.0 if unspecified)
  virtual double frame_rate() const = 0;

  //: Close the stream
  virtual void close() = 0;

  //: Advance to the next frame (but don't acquire an image)
  virtual bool advance() = 0 ;

  //: Read the next frame from the stream (advance and acquire)
  virtual vidl2_frame_sptr read_frame() = 0;

  //: Return the current frame in the stream
  virtual vidl2_frame_sptr current_frame() = 0;

  //: Seek to the given frame number
  // \returns true if successful
  virtual bool seek_frame(unsigned int frame_number) = 0;

 private:
  //: prevent deep copying a stream
  vidl2_istream(const vidl2_istream& other):ref_count_(0){}

 //-------------------------------------------------------
 // reference counting
 public:

  //: Increment reference count
  void ref() { ref_count_++; }

  //: Decrement reference count
  void unref() { if (--ref_count_ <= 0) delete this; }

  //: Number of objects referring to this data
  int ref_count() const { return ref_count_; }

 private:
  int ref_count_;
};

#endif // vidl2_istream_h_

---