ltmmCameraControlProperty Constants

typedef enum ltmmCameraControlProperty
{
    ltmmCameraControl_Pan = 1,
    ltmmCameraControl_Tilt,
    ltmmCameraControl_Roll,
    ltmmCameraControl_Zoom,
    ltmmCameraControl_Exposure,
    ltmmCameraControl_Iris,
    ltmmCameraControl_Focus
} ltmmCameraControlProperty;
 

The ltmmCameraControlProperty constants define individual settings in a camera.

Constant

Description

ltmmCameraControl_Pan

[1] Specifies the pan property. The pan property is measured in degrees. Possible values range from –180 to +180. The default value is zero. Positive values are clockwise from the origin (the camera rotates clockwise when viewed from above), and negative values are counterclockwise from the origin. 

ltmmCameraControl_Tilt

[2] Specifies the tilt property. The tilt property is measured in degrees. Possible values range from –180 to +180. The default value is zero. Positive values point the imaging plane up, and negative values point the imaging plane down.

ltmmCameraControl_Roll

[3] Specifies the roll property. The roll property is measured in degrees. Possible values range from –180 to +180. The default value is zero. Positive values cause a clockwise rotation of the camera along the image-viewing axis, and negative values cause a counterclockwise rotation of the camera.

ltmmCameraControl_Zoom

[4] Specifies the zoom property. The zoom property is measured in millimeters. Values range from 10 to 600 or as stated by the device documentation.

ltmmCameraControl_Exposure

[5] Specifies the exposure (shutter speed) property. The exposure property is measured in “log base 2” seconds. In other words, for values less than zero, the exposure time is 1/2n seconds, and for values zero or above, the exposure time is 2n seconds.

ltmmCameraControl_Iris

[6] Specifies the iris property. The iris property is measured in units of (f-stop * 10). F-stop is aterm used to indicate the amount of light passing through the lens. The smaller the f-number, the greater the amount of light passing through the lens.

Typical F-stops included on manual-iris lenses are 1.4, 2.0, 2.8, 4.0, 5.6, 8.0, 11, 16, and 22 (these are actual values, not multiplied by 10).

ltmmCameraControl_Focus

[7] Specifies the focus property, as the distance to the optimally focused target. The focus property is measured in millimeters. The range and default value are specific to the device.

Comments

The range and default values of the camera control properties might be specific to the camera (consult the device documentation).

To get the range of values for a certain property, call IltmmCameraControl::GetRange.

To get the current value for a specific property, call IltmmCameraControl::Get.

To set a specific property to a new value, call IltmmCameraControl::Set.