pvfiledev.h

Go to the documentation of this file.

/*
 * pvfiledev.cxx
 *
 * Video file declaration
 *
 * Portable Windows Library
 *
 * Copyright (C) 2004 Post Increment
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Portable Windows Library.
 *
 * The Initial Developer of the Original Code is
 * Craig Southeren <craigs@postincrement.com>
 *
 * All Rights Reserved.
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: pvfiledev.h,v $
 * Revision 1.10  2007/04/20 06:47:02  csoutheren
 * Really disable video code when video is turned off
 *
 * Revision 1.9  2007/04/13 07:13:13  rjongbloed
 * Major update of video subsystem:
 *   Abstracted video frame info (width, height etc) into separate class.
 *   Changed devices, converter and video file to use above.
 *   Enhanced video file hint detection for frame rate and more
 *     flexible formats.
 *   Fixed issue if need to convert both colour format and size, had to do
 *     colour format first or it didn't convert size.
 *   Win32 video output device can be selected by "MSWIN" alone.
 *
 * Revision 1.8  2007/04/03 12:09:37  rjongbloed
 * Fixed various "file video device" issues:
 *   Remove filename from PVideoDevice::OpenArgs (use deviceName)
 *   Added driverName to PVideoDevice::OpenArgs (so can select YUVFile)
 *   Added new statics to create correct video input/output device object
 *     given a PVideoDevice::OpenArgs structure.
 *   Fixed begin able to write to YUVFile when YUV420P colour format
 *     is not actually selected.
 *   Fixed truncating output video file if overwriting.
 *
 * Revision 1.7  2006/06/21 03:28:41  csoutheren
 * Various cleanups thanks for Frederic Heem
 *
 * Revision 1.6  2006/04/19 04:09:04  csoutheren
 * Allow frame size conversions
 *
 * Revision 1.5  2006/03/17 06:54:49  csoutheren
 * Removed unused member variable
 *
 * Revision 1.4  2006/03/13 07:49:09  csoutheren
 * Added newline at end of file
 *
 * Revision 1.3  2006/03/06 06:04:13  csoutheren
 * Added YUVFile video output device
 *
 * Revision 1.2  2006/02/20 06:49:45  csoutheren
 * Added video file and video file input device code
 *
 * Revision 1.1  2006/02/20 06:17:28  csoutheren
 * Added ability to read video from a file
 *
 */

#ifndef _PVFILEDEV
#define _PVFILEDEV

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <ptlib.h>

#if P_VIDEO
#if P_VIDFILE

#include <ptlib.h>
#include <ptlib/video.h>
#include <ptlib/vconvert.h>
#include <ptclib/pvidfile.h>
#include <ptclib/delaychan.h>


//
// This class defines a video capture (input) device that reads video from a raw YUV file
//

class PVideoInputDevice_YUVFile : public PVideoInputDevice
{
 PCLASSINFO(PVideoInputDevice_YUVFile, PVideoInputDevice);
 public:
   enum {
     Channel_PlayAndClose     = 0,
     Channel_PlayAndRepeat    = 1,
     Channel_PlayAndKeepLast  = 2,
     Channel_PlayAndShowBlack = 3,
     ChannelCount             = 4
   };

    PVideoInputDevice_YUVFile();

    ~PVideoInputDevice_YUVFile();


    BOOL Open(
      const PString & deviceName,   
      BOOL startImmediate = TRUE    
    );

    BOOL IsOpen() ;

    BOOL Close();

    BOOL Start();

    BOOL Stop();

    BOOL IsCapturing();

    static PStringList GetInputDeviceNames();

    virtual PStringList GetDeviceNames() const
      { return GetInputDeviceNames(); }

    virtual PINDEX GetMaxFrameBytes();

    virtual BOOL GetFrameData(
      BYTE * buffer,                 
      PINDEX * bytesReturned = NULL  
    );

    virtual BOOL GetFrameDataNoDelay(
      BYTE * buffer,                 
      PINDEX * bytesReturned = NULL  
    );


    void GrabBlankImage(BYTE *resFrame);

    virtual BOOL SetVideoFormat(
      VideoFormat videoFormat   
    );

    virtual int GetNumChannels() ;

    virtual BOOL SetChannel(
         int channelNumber  
    );
    
    virtual BOOL SetColourFormat(
      const PString & colourFormat   // New colour format for device.
    );
    
    virtual BOOL SetFrameRate(
      unsigned rate  
    );
         
    virtual BOOL GetFrameSizeLimits(
      unsigned & minWidth,   
      unsigned & minHeight,  
      unsigned & maxWidth,   
      unsigned & maxHeight   
    ) ;

    virtual BOOL SetFrameSize(
      unsigned width,   
      unsigned height   
    );

    void ClearMapping() { return ; }

    virtual BOOL TestAllFormats()
      { return TRUE; }

    void FillRect(BYTE * frame,int xPos, int initialYPos,int rectWidth, int rectHeight,int r, int g,  int b);
   
 protected:
   unsigned       grabCount;
   PINDEX         videoFrameSize;
   PVideoFile   * file;
   PAdaptiveDelay pacing;
};


//
// This class defines a video display (output) device that writes video to a raw YUV file
//

class PVideoOutputDevice_YUVFile : public PVideoOutputDevice
{
  PCLASSINFO(PVideoOutputDevice_YUVFile, PVideoOutputDevice);

  public:
    PVideoOutputDevice_YUVFile();

    ~PVideoOutputDevice_YUVFile();

    static PStringList GetOutputDeviceNames();

    virtual PStringList GetDeviceNames() const
      { return GetOutputDeviceNames(); }

    virtual BOOL Open(
      const PString & deviceName,   
      BOOL startImmediate = TRUE    
    );

    BOOL Start();

    BOOL Stop();

    virtual BOOL Close();

    virtual BOOL IsOpen();

    virtual BOOL SetColourFormat(
      const PString & colourFormat   // New colour format for device.
    );
    
    virtual PINDEX GetMaxFrameBytes();

    virtual BOOL SetFrameData(
      unsigned x,
      unsigned y,
      unsigned width,
      unsigned height,
      const BYTE * data,
      BOOL endFrame = TRUE
    );

  protected:  
   PVideoFile * file;
};


#endif // P_VIDFILE
#endif

#endif // _PVFILEDEV

---