videoio1394dc.h

Go to the documentation of this file.

/*
 * videoio1394dc.h
 *
 * Copyright:
 * Copyright (c) 2002 Ryutaroh Matsumoto <ryutaroh@rmatsumoto.org>
 *
 * 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.
 *
 *
 * Classes to support streaming video input from IEEE 1394 cameras.
 * Detailed explanation can be found at src/ptlib/unix/video4dc1394.cxx
 *
 * $Revision: 24177 $
 * $Author: rjongbloed $
 * $Date: 2010-04-05 21:52:04 +1000 (Mon, 05 Apr 2010) $
 */


#ifndef PTLIB_VIDEOIO1394DC_H
#define PTLIB_VIDEOIO1394DC_H

#ifdef __GNUC__
#pragma interface
#endif

#include <libraw1394/raw1394.h>
#include <libdc1394/dc1394_control.h>

class PVideoInput1394DcDevice : public PVideoInputDevice
{
    PCLASSINFO(PVideoInput1394DcDevice, PVideoInputDevice);
 public:
    PVideoInput1394DcDevice();

    ~PVideoInput1394DcDevice();

    PBoolean Open(
      const PString & deviceName,   
      PBoolean startImmediate = true    
    );

    PBoolean IsOpen();

    PBoolean Close();

    PBoolean Start();

    PBoolean Stop();

    PBoolean IsCapturing();

    static PStringList GetInputDeviceNames();

    PINDEX GetMaxFrameBytes();

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

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


    int GetBrightness();

    PBoolean SetBrightness(unsigned newBrightness);


    int GetWhiteness();

    PBoolean SetWhiteness(unsigned newWhiteness);


    int GetColour();

    PBoolean SetColour(unsigned newColour);


    int GetContrast();

    PBoolean SetContrast(unsigned newContrast);


    int GetHue();

    PBoolean SetHue(unsigned newHue);
    
    
    PBoolean GetParameters (int *whiteness, int *brightness, 
                        int *colour, int *contrast, int *hue);

    PBoolean GetFrameSizeLimits(
      unsigned & minWidth,   
      unsigned & minHeight,  
      unsigned & maxWidth,   
      unsigned & maxHeight   
    ) ;

    void ClearMapping();

    int GetNumChannels();
    PBoolean SetChannel(
         int channelNumber  
    );
    PBoolean SetFrameRate(
      unsigned rate  
    );
    PBoolean SetVideoFormat(
      VideoFormat videoFormat   
    );
    PBoolean SetFrameSize(
      unsigned width,   
      unsigned height   
    );
    PBoolean SetColourFormat(
      const PString & colourFormat   // New colour format for device.
    );


    PBoolean TestAllFormats();

    PBoolean SetFrameSizeConverter(
      unsigned width,        
      unsigned height,       
      PBoolean     bScaleNotCrop 
    );

    PBoolean SetColourFormatConverter(
      const PString & colourFormat // New colour format for device.
    );


 protected:
    raw1394handle_t handle;
    PBoolean is_capturing;
    PBoolean UseDMA;
    nodeid_t * camera_nodes;
    int numCameras;
    dc1394_cameracapture camera;
    int capturing_duration;
    PString      desiredColourFormat;
    unsigned     desiredFrameWidth;
    unsigned     desiredFrameHeight;
};


#endif // PTLIB_VIDEOIO1394DC_H


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