Addon.Webcam.GetCameraControlPropertySetting()

Description

Returns the basic settings of a camera property.

Syntax

.Addon.Webcam.GetCameraControlPropertySetting(iProperty);

Parameters

<int> iProperty: Specifies the property to query, allowed values are:

Allowed Values EnumDWT_CameraControlProperty enumeration Description
0 EnumDWT_CameraControlProperty.CCP_PAN 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.
1 EnumDWT_CameraControlProperty.CCP_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.
2 EnumDWT_CameraControlProperty.CCP_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.
3 EnumDWT_CameraControlProperty.CCP_ZOOM Specifies the camera's zoom setting, in millimeters. Values range from 10 to 600, and the default is specific to the device.
4 EnumDWT_CameraControlProperty.CCP_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:
Value Seconds
  -3     1/8
  -2     1/4
  -1     1/2
  0        1
  1        2
  2        4
5 EnumDWT_CameraControlProperty.CCP_IRIS Specifies the camera's iris setting, in units of fstop* 10.
6 EnumDWT_CameraControlProperty.CCP_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.

Return value

An object of the type <CameraControlSetting> is returned. Methods available in the object are

Data Type Method Name Description
<int> GetValue() Returns the value of the property.
<bool> GetIfAuto() Returns a value that indicates whether the setting is controlled manually or automatically.

Example

DWObject.Addon.Webcam.SelectSource(document.getElementById("source").options[document.getElementById("source").selectedIndex].text);
var _CameraControlSetting = DWObject.Addon.Webcam.GetCameraControlPropertySetting(EnumDWT_CameraControlProperty.CCP_PAN); 
var _GetValue = _CameraControlSetting.GetValue();
var _GetIfAuto = _CameraControlSetting.GetIfAuto();
alert("GetValue: " + _GetValue + "; IfAuto: " + _GetIfAuto);

See also

Addon.Webcam.SetCameraControlPropertySetting

Addon.Webcam.GetVideoPropertySetting

Addon.Webcam.GetVideoPropertyMoreSetting

Addon.Webcam.SetVideoPropertySetting