Compartilhar via

CSPROPERTY_VIDCAP_CAMERACONTROL (Compact 2013)

  • Artigo

3/26/2014

This enumeration defines values that represent the properties in the PROPSETID_VIDCAP_CAMERACONTROL property set.

Syntax

typedef enum {
  CSPROPERTY_CAMERACONTROL_PAN,
  CSPROPERTY_CAMERACONTROL_TILT,
  CSPROPERTY_CAMERACONTROL_ROLL,
  CSPROPERTY_CAMERACONTROL_ZOOM,
  CSPROPERTY_CAMERACONTROL_EXPOSURE,
  CSPROPERTY_CAMERACONTROL_IRIS,
  CSPROPERTY_CAMERACONTROL_FOCUS,
  CSPROPERTY_CAMERACONTROL_FLASH
} CSPROPERTY_VIDCAP_CAMERACONTROL;

Elements

  • CSPROPERTY_CAMERACONTROL_PAN
    Used to get or set the camera's pan setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the pan setting. This value is expressed in degrees. Positive values indicate that the camera is rotated clockwise. Negative values indicate that the camera is rotated counterclockwise.

    Every video capture minidriver that supports this property must define a range and default value for this property. The range for the device must be -180 through +180. The default value must be 0.

  • CSPROPERTY_CAMERACONTROL_TILT
    Used to get or set the camera's tilt setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the tilt setting. This value is expressed in degrees. Positive values point the imaging plane up. Negative values point the imaging plane down.

    Every video capture minidriver that supports this property must define a range and default value for this property. The range for the device must -180 through +180. The default value must be 0.

  • CSPROPERTY_CAMERACONTROL_ROLL
    Used to get or set the camera's roll setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the roll setting. This value is expressed in degrees. Positive values cause a clockwise rotation of the camera along the image-viewing axis. Negative values cause a counterclockwise rotation of the camera.

    Every video capture minidriver that supports this property must define a range and default value for this property. The range for the device must be -180 through +180 and the default value must be 0.

  • CSPROPERTY_CAMERACONTROL_ZOOM
    Used to get or set the camera's zoom setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the zoom. This value is expressed in millimeters.

    Every video capture minidriver that supports this property must define a range and default value for this property. The range for the device must be 10 through 600. The default value must be 10.

  • CSPROPERTY_CAMERACONTROL_EXPOSURE
    Used to get or set a digital camera's exposure time. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the length of exposure. This value is expressed in log base 2 seconds, thus, for values less than zero, the exposure time is 1/2n seconds. For positive values and zero, the exposure time is 2n seconds. For example:

    Value

    -7

    -6

    -5

    -4

    -3

    -2

    -1

    0

    1

    Seconds

    1/128

    1/64

    1/32

    1/16

    1/8

    1/4

    1/2

    1

    2

    Every video capture minidriver that supports this property must define its own range and default value for this property.

  • CSPROPERTY_CAMERACONTROL_IRIS
    Used to get or set a camera's aperture setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the camera's aperture setting. This value is expressed in units of fstop * 10.

    Every video capture minidriver that supports this property must define its own range and default value for this property.

  • CSPROPERTY_CAMERACONTROL_FOCUS
    Used to get or set the camera's focus setting. This property is optional.

    The property value (operation data) is a LONG.

    The Value member of the CSPROPERTY_CAMERACONTROL_S structure is used to specify the focus setting. This value is expressed in millimeters.

    Every video capture minidriver that supports this property must define its own range and default value for this property.

  • CSPROPERTY_CAMERACONTROL_FLASH
    Used to get or set the camera's flash setting. It can be used to turn the flash on or off and it can be used to provide the distance of the subject in millimeters. This property is optional.

    For applications that only support two-status-flash (on and off), set this value to the maximum available to indicate Flash On, and minimum available to indicate Flash Off. You can use IAMCameraControl::GetRange to get the flash range.

Remarks

The following table summarizes the usages for the CSPROPERTY_VIDCAP_CAMERACONTROL property types.

Property

Get

Set

Target

Property Descriptor Type

Property Value Type

CSPROPERTY_CAMERACONTROL_PAN

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_TILT

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_ROLL

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_ZOOM

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_EXPOSURE

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_IRIS

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_FOCUS

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

CSPROPERTY_CAMERACONTROL_FLASH

Yes

Yes

Filter

CSPROPERTY_CAMERACONTROL_S

LONG

Requirements

Header

csmedia.h

See Also

Reference

Camera Driver Enumerations
CSPROPERTY_CAMERACONTROL_S