Main Page | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages | Examples

ArPTZ Class Reference

#include <ArPTZ.h>

Inheritance diagram for ArPTZ:

ArAMPTU ArDPPTU ArRVisionPTZ ArSonyPTZ ArVCC4 List of all members.

Detailed Description

Base class which handles the PTZ cameras.

This class is mainly concerned with making all the cameras look the same for outgoing data, it is also set up to facilitate the acquisition of incoming data but that is described in the following paragraphs. There are two ways this can be used. The first is the simplest and default behavior and should be used by those whose cameras are attached to their robot's microcontroller, a ArRobot pointer is passed in to the contructor, this is where the commands will be sent to the robot via the robot's connection which will then send it along over the second serial port. The second way is to pass an ArDeviceConnection to setDeviceConnection, if this is done commands will be sent along the given serial port, this should ONLY be done if the camera is attached straight to a serial port on the computer this program is running on.

The next two paragraphs describe how to get data back from the cameras, but this base class is set up so that by default it won't try to get data back and assumes you're not trying to do that. If you are trying to get data back the important functions are packetHandler, robotPacketHandler and readPacket and you should read the docs on those.

If the camera is attached to the robot (and you are thus using the first method described in the first paragraph) then the only way to get data back is to send an ArCommands::GETAUX, then set up a robotPacketHandler for the AUX id and have it call the packetHandler you set up in in the class.

If the camera is attached to the serial port on the computer (and thus the second method described in the first paragraph was used) then its more complicated... the default way is to just pass in an ArDeviceConnection to setDeviceConnection and implement the readPacket method (which MUST not block), and every time through the robot loop readPacket (with the sensorInterpHandler) will be called and any packets will be given to the packetHandler (which you need to implement in your class) to be processed. The other way to do this method is to pass both an ArDefaultConnection and false to setDeviceConnection, this means the camera will not be read at all by default, and you're on your own for reading the data in (ie like your own thread).


Public Member Functions

 ArPTZ (ArRobot *robot)
virtual bool canGetFOV (void)
 Whether we can get the FOV (field of view) or not.
virtual bool canGetRealPanTilt (void) const
 Whether getPan() hand getTilt() return the device's real position, or last commanded position.
virtual bool canGetRealZoom (void) const
 Whether getZoom() returns the device's real zoom amount, or last commanded zoom position.
virtual bool canSetFocus (void) const
 If the driver can set the focus on the camera, or not.
virtual bool canSetGain (void) const
 If the driver can set gain on the camera, or not.
virtual bool canZoom (void) const =0
 Returns true if camera can zoom and this class can control the zoom amount.
virtual void connectHandler (void)
 Internal, attached to robot, inits the camera when robot connects.
virtual int getAuxPort (void)
 Gets the port the device is set to communicate on.
virtual ArDeviceConnectiongetDeviceConnection (void)
 Gets the device connection used by this PTZ camera.
virtual double getFocus (double focus) const
 Get the focus the camera is set to. 0 if not supported.
virtual double getFOVAtMaxZoom (void)
 Gets the field of view at maximum zoom.
virtual double getFOVAtMinZoom (void)
 Gets the field of view at minimum zoom.
virtual double getGain (double gain) const
 Get the gain the camera is set to. 0 if not supported.
virtual double getMaxNegPan (void) const =0
 Gets the lowest negative degree the camera can pan to.
virtual double getMaxNegTilt (void) const =0
 Gets the lowest negative degree the camera can tilt to.
virtual double getMaxPosPan (void) const =0
 Gets the highest positive degree the camera can pan to.
virtual double getMaxPosTilt (void) const =0
 Gets the highest positive degree the camera can tilt to.
virtual int getMaxZoom (void) const
 Gets the maximum value for the zoom on this camera.
virtual int getMinZoom (void) const
 Gets the lowest value for the zoom on this camera.
virtual double getPan (void) const =0
virtual double getTilt (void) const =0
virtual int getZoom (void) const
virtual bool init (void)=0
 Initializes the camera.
virtual bool packetHandler (ArBasePacket *packet)
 Handles a packet that was read from the device.
virtual bool pan (double degrees)=0
 Pans to the given degrees.
virtual bool panRel (double degrees)=0
 Pans relative to current position by given degrees.
virtual bool panTilt (double degreesPan, double degreesTilt)=0
 Pans and tilts to the given degrees.
virtual bool panTiltRel (double degreesPan, double degreesTilt)=0
 Pans and tilts relatives to the current position by the given degrees.
virtual ArBasePacketreadPacket (void)
 Reads a packet from the device connection, MUST NOT BLOCK.
virtual void reset (void)
 Resets the camera.
virtual bool robotPacketHandler (ArRobotPacket *packet)
 Handles a packet that was read by the robot.
virtual bool sendPacket (ArBasePacket *packet)
 Sends a given packet to the camera (via robot or serial port, depending).
virtual void sensorInterpHandler (void)
 Internal, for attaching to the robots sensor interp to read serial port.
virtual bool setAuxPort (int auxPort)
 Sets the aux port on the robot to be used to communicate with this device.
virtual bool setDeviceConnection (ArDeviceConnection *connection, bool driveFromRobotLoop=true)
virtual bool setFocus (double focus) const
virtual bool setGain (double gain) const
virtual bool tilt (double degrees)=0
 Tilts to the given degrees.
virtual bool tiltRel (double degrees)=0
 Tilts relative to the current position by given degrees.
virtual bool zoom (int zoomValue)
 Zooms to the given value.
virtual bool zoomRel (int zoomValue)
 Zooms relative to the current value, by the given value.
virtual ~ArPTZ ()
 Destructor.

Protected Attributes

int myAuxPort
ArCommands::Commands myAuxRxCmd
ArCommands::Commands myAuxTxCmd
ArDeviceConnectionmyConn
ArFunctorC< ArPTZmyConnectCB
ArRobotmyRobot
ArRetFunctor1C< bool, ArPTZ,
ArRobotPacket * > 
myRobotPacketHandlerCB
ArFunctorC< ArPTZmySensorInterpCB


Constructor & Destructor Documentation

ArPTZ::ArPTZ ArRobot robot  ) 
 

Parameters:
robot The robot this camera is attached to, can be NULL


Member Function Documentation

virtual double ArPTZ::getPan void   )  const [pure virtual]
 

The angle the camera is panned to (or last commanded value sent, if unable to obtain real pan position)

See also:
canGetRealPanTilt()

Implemented in ArAMPTU.

virtual double ArPTZ::getTilt void   )  const [pure virtual]
 

The angle the camera is tilted to (or last commanded value sent, if unable to obtain real pan position)

See also:
canGetRealPanTilt()

Implemented in ArAMPTU.

virtual int ArPTZ::getZoom void   )  const [inline, virtual]
 

The amount the camera is zoomed to (or last commanded value sent, if unable to obtain real pan position)

See also:
canZoom();

canGetZoom()

virtual bool ArPTZ::packetHandler ArBasePacket packet  )  [inline, virtual]
 

Handles a packet that was read from the device.

This should work for the robot packet handler or for packets read in from readPacket (the joys of OO), but it can't deal with the need to check the id on robot packets, so you should check the id from robotPacketHandler and then call this one so that your stuff can be used by both robot and serial port connections.

Parameters:
packet the packet to handle
Returns:
true if this packet was handled (ie this knows what it is), false otherwise

virtual ArBasePacket* ArPTZ::readPacket void   )  [inline, virtual]
 

Reads a packet from the device connection, MUST NOT BLOCK.

This should read in a packet from the myConn connection and return a pointer to a packet if there was on to read in, or NULL if there wasn't one... this MUST not block if it is used with the default mode of being driven from the sensorInterpHandler, since that is on the robot loop.

Returns:
packet read in, or NULL if there was no packet read

virtual void ArPTZ::reset void   )  [inline, virtual]
 

Resets the camera.

This function will reset the camera to 0 0 pan tilt, and 0 zoom, on some cameras that can get out of sync it may need to do more, such as call init on it again.

bool ArPTZ::robotPacketHandler ArRobotPacket packet  )  [virtual]
 

Handles a packet that was read by the robot.

This handles packets read in from the robot, this function should just check the ID of the robot packet and then return what packetHandler thinks of the packet.

Parameters:
packet the packet to handle
Returns:
true if the packet was handled (ie this konws what it is), false otherwise

bool ArPTZ::sendPacket ArBasePacket packet  )  [virtual]
 

Sends a given packet to the camera (via robot or serial port, depending).

Parameters:
packet the packet to send
Returns:
true if the packet could be sent, false otherwise

bool ArPTZ::setAuxPort int  auxPort  )  [virtual]
 

Sets the aux port on the robot to be used to communicate with this device.

Parameters:
auxPort The AUX port on the robot's microcontroller that the device is connected to. The C166 controller only has one port. The H8 has two.
Returns:
true if the port was valid (1 or 2). False otherwise.

bool ArPTZ::setDeviceConnection ArDeviceConnection connection,
bool  driveFromRobotLoop = true
[virtual]
 

Sets the device connection to be used by this PTZ camera, if set this camera will send commands via this connection, otherwise its via robot

virtual bool ArPTZ::setFocus double  focus  )  const [inline, virtual]
 

Set focus on camera, range of 1-100. Returns false if out of range or if you can't set the focus on the camera

virtual bool ArPTZ::setGain double  gain  )  const [inline, virtual]
 

Set gain on camera, range of 1-100. Returns false if out of range or if you can't set the gain on the camera


The documentation for this class was generated from the following files:
Generated on Thu Jan 7 10:34:43 2010 for Aria by  doxygen 1.4.2