1394cameracontrol.h

1394 接口视觉工具箱 （英文工具箱

/**\file 1394CameraControl.h
 * \brief Declares C1394CameraControl
 * \ingroup	camfeat
 */

//////////////////////////////////////////////////////////////////////
//
//	Version 6.4
//
//  Copyright 8/2006
//
//  Christopher Baker
//  Robotics Institute
//  Carnegie Mellon University
//  Pittsburgh, PA
//
//	Copyright 5/2000
// 
//	Iwan Ulrich
//	Robotics Institute
//	Carnegie Mellon University
//	Pittsburgh, PA
//
//  This file is part of the CMU 1394 Digital Camera Driver
//
//  The CMU 1394 Digital Camera Driver is free software; you can redistribute 
//  it and/or modify it under the terms of the GNU Lesser General Public License 
//  as published by the Free Software Foundation; either version 2.1 of the License,
//  or (at your option) any later version.
//
//  The CMU 1394 Digital Camera Driver is distributed in the hope that it will 
//  be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU Lesser General Public License for more details.
//
//  You should have received a copy of the GNU Lesser General Public License
//  along with the CMU 1394 Digital Camera Driver; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
//////////////////////////////////////////////////////////////////////

#ifndef __1394CAMERACONTROL_H__
#define __1394CAMERACONTROL_H__

// prototype the Camera class so we can make our parent pointer to it.
class C1394Camera;

/**\brief Encapsulates the operation of exactly one camera feature (control)
 *
 * This class is must be initialized with a parent C1394Camera class and a
 * feature ID of type CAMERA_FEATURE for proper operation.  Thenceforth, this 
 * class can be used to monitor and manipulate the indicated control on the 
 * indicated camera.
 */
class CAMAPI C1394CameraControl  
{
public:
	C1394CameraControl(C1394Camera *pCamera, CAMERA_FEATURE feature);
	~C1394CameraControl();
	
	// Inquiry Stuff
	int Inquire(unsigned long *pRawData = NULL);
	bool HasPresence();         ///< Accessor for m_InquiryReg.present    \see Inquire()
	bool HasAbsControl();       ///< Accessor for m_InquiryReg.absctl     \see Inquire()
	bool HasOnePush();          ///< Accessor for m_InquiryReg.onepush    \see Inquire()
	bool HasReadout();          ///< Accessor for m_InquiryReg.readout    \see Inquire()
	bool HasOnOff();            ///< Accessor for m_InquiryReg.onoff      \see Inquire()
	bool HasAutoMode();         ///< Accessor for m_InquiryReg.automode   \see Inquire()
	bool HasManualMode();       ///< Accessor for m_InquiryReg.manualmode \see Inquire()
	void GetRange(unsigned short *min, unsigned short *max);
	void GetRangeAbsolute(float *fmin, float *fmax);
	
	// Status Stuff
	int Status(unsigned long *pRawData = NULL);
	// Status Accessors
	bool StatusPresence();      ///< Accessor for m_StatusReg.present     \see Status()
	bool StatusAbsControl();    ///< Accessor for m_StatusReg.abscontrol  \see Status()
	bool StatusOnOff();         ///< Accessor for m_StatusReg.onoff       \see Status()
	bool StatusOnePush();      ///< Accessor for m_StatusReg.automode    \see Status()
	bool StatusAutoMode();      ///< Accessor for m_StatusReg.automode    \see Status()
	void GetValue(unsigned short *v_lo, unsigned short *v_hi=NULL);
	void GetValueAbsolute(float *f);
	// Status Mutators
	int SetAbsControl(BOOL on); ///< Mutator for m_StatusReg.AbsControl \return Same as SetStatus()
	int SetOnOff(BOOL on);      ///< Mutator for m_StatusReg.onoff      \return Same as SetStatus()
	int SetOnePush(BOOL on);    ///< Mutator for m_StatusReg.onepush    \return Same as SetStatus()
	int SetAutoMode(BOOL on);   ///< Mutator for m_StatusReg.automode   \return Same as SetStatus()
	int SetValue(unsigned short v_lo, unsigned short v_hi=0);
	int SetValueAbsolute(float f); 
	
	// Identification Stuff
	const char *GetName();
	const char *GetUnits();
	CAMERA_FEATURE GetFeatureID();
protected:
	int SetStatus();
	unsigned long  m_offset;
	unsigned long  m_statusoffset;
	unsigned long  m_inquiryoffset;
	unsigned long  m_absctloffset;
	C1394Camera* m_pCamera;
	CAMERA_FEATURE m_feature;
	FEATURE_INQUIRY_REGISTER m_InquiryReg;
	FEATURE_STATUS_REGISTER  m_StatusReg;
	float m_absmin, m_absmax, m_absval;
};

#endif // __1394CAMERACONTROL_H__