CameraControlProperty enumeration (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The CameraControlProperty
enumeration specifies a setting on a camera.
Syntax
typedef enum tagCameraControlProperty {
CameraControl_Pan = 0,
CameraControl_Tilt,
CameraControl_Roll,
CameraControl_Zoom,
CameraControl_Exposure,
CameraControl_Iris,
CameraControl_Focus
} CameraControlProperty;
Constants
CameraControl_Pan Value: 0 Specifies 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 Specifies 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 Specifies 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 Specifies the camera's zoom setting, in millimeters. Values range from 10 to 600, and the default is specific to the device. |
||||||||||||||
CameraControl_Exposure Specifies the exposure setting, in log base 2 seconds. In other words, for values less than zero, the exposure time is 1/2^n seconds, and for values zero or above, the exposure time is 2^n seconds. For example:
|
||||||||||||||
CameraControl_Iris Specifies the camera's iris setting, in units of fₛₜₒₚ* 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. |
Remarks
For a given property, a particular device might implement only a subset of the listed range.
Requirements
Requirement | Value |
---|---|
Header | strmif.h (include Dshow.h) |