video.h

Go to the documentation of this file.

/*
 * video.h
 *
 * Video interface class.
 *
 * Portable Windows Library
 *
 * Copyright (c) 1993-1998 Equivalence Pty. Ltd.
 *
 * 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 Equivalence Pty. Ltd.
 *
 * Portions are Copyright (C) 1993 Free Software Foundation, Inc.
 * All Rights Reserved.
 *
 * Contributor(s): Derek Smithies (derek@indranet.co.nz)
 *
 * $Log: video.h,v $
 * Revision 1.19  2007/04/20 06:47:02  csoutheren
 * Really disable video code when video is turned off
 *
 * Revision 1.18  2005/11/30 12:47:38  csoutheren
 * Removed tabs, reformatted some code, and changed tags for Doxygen
 *
 * Revision 1.17  2003/11/19 04:28:21  csoutheren
 * Changed to support video output plugins
 *
 * Revision 1.16  2003/09/17 05:41:59  csoutheren
 * Removed recursive includes
 *
 * Revision 1.15  2003/09/17 01:18:02  csoutheren
 * Removed recursive include file system and removed all references
 * to deprecated coooperative threading support
 *
 * Revision 1.14  2003/04/15 21:10:29  dereks
 * Patches for Firewire video. Thanks Georgi Georgiev.
 *
 * Revision 1.13  2003/03/17 07:45:14  robertj
 * Removed redundant "render now" function.
 *
 * Revision 1.12  2003/02/18 03:55:59  dereks
 * Add 1394AVC pathces from  Georgi Georgiev. Thanks!
 *
 * Revision 1.11  2003/01/11 05:30:13  robertj
 * Added support for IEEE 1394 AV/C cameras, thanks Georgi Georgiev
 *
 * Revision 1.10  2002/09/16 01:08:59  robertj
 * Added #define so can select if #pragma interface/implementation is used on
 *   platform basis (eg MacOS) rather than compiler, thanks Robert Monaghan.
 *
 * Revision 1.9  2002/02/20 02:37:26  dereks
 * Initial release of Firewire camera support for linux.
 * Many thanks to Ryutaroh Matsumoto <ryutaroh@rmatsumoto.org>.
 *
 * Revision 1.8  2002/01/04 04:11:45  dereks
 * Add video flip code from Walter Whitlock, which flips code at the grabber.
 *
 * Revision 1.7  2001/12/03 03:44:52  dereks
 * Add method to retrive pointer to the attached video display class.
 *
 * Revision 1.6  2001/11/28 00:07:32  dereks
 * Locking added to PVideoChannel, allowing reader/writer to be changed mid call
 * Enabled adjustment of the video frame rate
 * New fictitous image, a blank grey area
 *
 * Revision 1.5  2001/10/23 02:11:00  dereks
 * Extend video channel so it can display raw data, using attached video devices.
 *
 * Revision 1.4  2001/05/22 12:49:32  robertj
 * Did some seriously wierd rewrite of platform headers to eliminate the
 *   stupid GNU compiler warning about braces not matching.
 *
 * Revision 1.3  2001/03/07 01:42:59  dereks
 * miscellaneous video fixes. Works on linux now. Add debug statements
 * (at PTRACE level of 1)
 *
 * Revision 1.2  2000/12/19 22:20:26  dereks
 * Add video channel classes to connect to the PwLib PVideoInputDevice class.
 * Add PFakeVideoInput class to generate test images for video.
 *
 * Revision 1.1  2000/11/09 00:43:04  dereks
 * Initial release.
 *
 * 
 *
 */

#ifndef _PVIDEO
#define _PVIDEO

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <ptbuildopts.h>

#if P_VIDEO

#include <ptlib/videoio.h>

class PVideoChannel : public PChannel
{
  PCLASSINFO(PVideoChannel, PChannel);

  public:
    enum Directions {
      Recorder,
      Player
    };

    PVideoChannel();

    PVideoChannel(
      const PString & device,       
      Directions dir               
    );
    // 

    ~PVideoChannel();
    // Destroy and close the video driver

    BOOL Open(
      const PString & device,       
      Directions dir               
    );

     BOOL IsOpen() const;
    
    static PStringList GetDeviceNames(
      Directions dir    // Video I/O direction
    )  ;

    static PString GetDefaultDevice(
      Directions dir    // Video I/O direction
    );

    
    virtual PINDEX  GetGrabWidth(); 

    virtual PINDEX  GetGrabHeight();

    virtual BOOL Read(void * buf, PINDEX  len);
      // Low level read from the video channel. This function will block until the
      // requested number of characters were read.
  
  
    BOOL Write(const void * buf,  //Pointer to the image data to be rendered
               PINDEX      len);
    
    virtual BOOL Redraw(const void * frame); 

    PINDEX  GetRenderWidth();

    PINDEX  GetRenderHeight();

    virtual void SetRenderFrameSize(int _width, int _height); 

    virtual void SetGrabberFrameSize(int _width, int _height); 

    virtual void AttachVideoPlayer(PVideoOutputDevice * device, BOOL keepCurrent = TRUE);

    virtual void AttachVideoReader(PVideoInputDevice * device, BOOL keepCurrent = TRUE);

    virtual PVideoInputDevice *GetVideoReader();

    virtual PVideoOutputDevice *GetVideoPlayer();

    virtual BOOL IsGrabberOpen();
    
    virtual BOOL IsRenderOpen();

    BOOL DisplayRawData(void *videoBuffer);

    virtual void CloseVideoReader();

    virtual void CloseVideoPlayer();

    void RestrictAccess();
    
    void EnableAccess();

    BOOL ToggleVFlipInput();

 protected:

    Directions       direction;

    PString          deviceName;     
    PVideoInputDevice  *mpInput;    
    PVideoOutputDevice *mpOutput;   

    PMutex           accessMutex;   // Ensure that only task is accesing 
                                    // members in this video channel.
  private:
    void Construct();


// Include platform dependent part of class
#ifdef _WIN32
#include "msos/ptlib/video.h"
#else
#include "unix/ptlib/video.h"
#endif
};

#endif // P_VIDEO

#endif // _PVIDEO


// End Of File ///////////////////////////////////////////////////////////////

---