Share via

CameraControlProperty (Compact 2013)

  • Article

3/26/2014

This enumeration provides values that identify types of camera settings.

Syntax

typedef enum {
    CameraControl_Pan,
    CameraControl_Tilt,
    CameraControl_Roll,
    CameraControl_Zoom,
    CameraControl_Exposure,
    CameraControl_Iris,
    CameraControl_Focus
    CameraControl_Flash
} CameraControlProperty;

Elements

  • CameraControl_Pan
    Identifies the camera's pan setting, in degrees. Values range from -180 to +180, with the default set to zero. Positive values are clockwise from the origin (the camera rotates clockwise when viewed from above), and negative values are counterclockwise from the origin.
  • CameraControl_Tilt
    Identifies the camera's tilt setting, in degrees. Values range from -180 to +180, with the default set to zero. Positive values point the imaging plane up, and negative values point the imaging plane down.
  • CameraControl_Roll
    Identifies the camera's roll setting, in degrees. Values range from -180 to +180, with the default set to 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.
  • CameraControl_Zoom
    Identifies the camera's zoom setting, in millimeters. Values range from 10 to 600, and the default is specific to the device.

  • CameraControl_Exposure
    Identifies the exposure setting, 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. For example:

    Value

    Seconds

    -3

    1/8

    -2

    1/4

    -1

    1/2

    0

    1

    1

    2

    2

    4
  • CameraControl_Iris
    Specifies the camera's iris setting, in units of fstop * 10.
  • CameraControl_Focus
    Specifies the camera's focus setting, as the distance to the optimally focused target, in millimeters. The range and default value are specific to the device.
  • CameraControl_Flash
    Specifies if the flash is turned on or off.

Remarks

For a given property, a particular device might implement only a subset of the listed range.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

DirectShow Enumerations
IAMCameraControl Interface