BobDeinterlacer.H

Go to the documentation of this file.
00001 /*!@file Transport/BobDeinterlacer.H Deinterlace frames with the "bob" method */
00002 
00003 // //////////////////////////////////////////////////////////////////// //
00004 // The iLab Neuromorphic Vision C++ Toolkit - Copyright (C) 2000-2005   //
00005 // by the University of Southern California (USC) and the iLab at USC.  //
00006 // See http://iLab.usc.edu for information about this project.          //
00007 // //////////////////////////////////////////////////////////////////// //
00008 // Major portions of the iLab Neuromorphic Vision Toolkit are protected //
00009 // under the U.S. patent ``Computation of Intrinsic Perceptual Saliency //
00010 // in Visual Environments, and Applications'' by Christof Koch and      //
00011 // Laurent Itti, California Institute of Technology, 2001 (patent       //
00012 // pending; application number 09/912,225 filed July 23, 2001; see      //
00013 // http://pair.uspto.gov/cgi-bin/final/home.pl for current status).     //
00014 // //////////////////////////////////////////////////////////////////// //
00015 // This file is part of the iLab Neuromorphic Vision C++ Toolkit.       //
00016 //                                                                      //
00017 // The iLab Neuromorphic Vision C++ Toolkit is free software; you can   //
00018 // redistribute it and/or modify it under the terms of the GNU General  //
00019 // Public License as published by the Free Software Foundation; either  //
00020 // version 2 of the License, or (at your option) any later version.     //
00021 //                                                                      //
00022 // The iLab Neuromorphic Vision C++ Toolkit is distributed in the hope  //
00023 // that it will be useful, but WITHOUT ANY WARRANTY; without even the   //
00024 // implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR      //
00025 // PURPOSE.  See the GNU General Public License for more details.       //
00026 //                                                                      //
00027 // You should have received a copy of the GNU General Public License    //
00028 // along with the iLab Neuromorphic Vision C++ Toolkit; if not, write   //
00029 // to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,   //
00030 // Boston, MA 02111-1307 USA.                                           //
00031 // //////////////////////////////////////////////////////////////////// //
00032 //
00033 // Primary maintainer for this file: Rob Peters <rjpeters at usc dot edu>
00034 // $HeadURL: svn://isvn.usc.edu/software/invt/trunk/saliency/src/Transport/BobDeinterlacer.H $
00035 // $Id: BobDeinterlacer.H 9547 2008-03-28 23:32:43Z rjpeters $
00036 //
00037 
00038 #ifndef TRANSPORT_BOBDEINTERLACER_H_DEFINED
00039 #define TRANSPORT_BOBDEINTERLACER_H_DEFINED
00040 
00041 #include "Transport/Deinterlacer.H"
00042 #include "Util/SimTime.H"
00043 #include "Video/VideoFrame.H"
00044 #include "rutz/time.h"
00045 
00046 /// Deinterlace frames using the "bob" method
00047 /** In short, the "bob" method separates the top and bottom
00048     half-frames, rescales each of them up to full size, and then
00049     displays a video stream at double the normal rate. It is named
00050     "bob" for the slight bobbing up and down that may occur due to the
00051     one-pixel vertical offset between the top and bottom half frames;
00052     however in practice this bobbing usually imperceptible.
00053 
00054     See http://en.wikipedia.org/wiki/Deinterlacing and
00055     http://www.100fps.com/ and for lots of information on various
00056     deinterlacing methods. */
00057 class BobDeinterlacer : public Deinterlacer
00058 {
00059 public:
00060   /// Constructor
00061   BobDeinterlacer(OptionManager& mgr);
00062 
00063   /// Destructor
00064   virtual ~BobDeinterlacer();
00065 
00066   /// Install a FrameListener
00067   /** NOTE! The listener will get the NON-DEINTERLACED frames! */
00068   void setListener(rutz::shared_ptr<FrameListener> listener);
00069 
00070   /// Return the specifications of the next frame
00071   virtual GenericFrameSpec peekFrameSpec();
00072 
00073   /// Get the natural deinterlaced frame (this will be half the frame time of our delegate)
00074   virtual SimTime getNaturalFrameTime() const;
00075 
00076   /// Advise the deinterlacer of the current frame number; pass along to our delegate
00077   virtual bool setFrameNumber(int n);
00078 
00079   /// Get a streaming grab started; reset our timing variables
00080   virtual void startStream();
00081 
00082   /// Get the next bob-deinterlaced frame
00083   virtual GenericFrame readFrame();
00084 
00085 protected:
00086   virtual void start2();
00087   virtual void stop2();
00088 
00089 private:
00090   SimTime itsFieldTime;
00091   int itsFrameNumber;
00092   VideoFrame itsCurFullFrame;
00093   rutz::time itsLastFrameTime;
00094   rutz::time itsLastBottomTime;
00095   double itsUsleepAdjustment;
00096   bool itsDeinterlacing;
00097   bool itsInBottomField;
00098 };
00099 
00100 // ######################################################################
00101 /* So things look consistent in everyone's emacs... */
00102 /* Local Variables: */
00103 /* mode: c++ */
00104 /* indent-tabs-mode: nil */
00105 /* End: */
00106 
00107 #endif // TRANSPORT_BOBDEINTERLACER_H_DEFINED
Generated on Sun May 8 08:06:56 2011 for iLab Neuromorphic Vision Toolkit by  doxygen 1.6.3