Addon.Webcam.GetCameraControlPropertyMoreSetting()

Description

Returns the range and default values of a specified webcam property.

Syntax

.Addon.Webcam.GetCameraControlPropertyMoreSetting(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 <CameraControlMoreSetting> is returned. Methods available in the object are

Data Type Method Name Description
<long> GetMinValue() Returns the minimum value of the property.
<long> GetMaxValue() Returns the maximum value of the property.
<long> GetSteppingDelta() Returns the step size for the property. The step size is the smallest increment by which the property can change.
<long> GetDefaultValue() Returns the default 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 _CameraControlMoreSetting = DWObject.Addon.Webcam.GetCameraControlPropertyMoreSetting(EnumDWT_CameraControlProperty.
CCP_PAN); 
var _GetMinValue = _CameraControlMoreSetting.GetMinValue();
var _GetMaxValue = _CameraControlMoreSetting.GetMaxValue();
var _GetSteppingDelta = _CameraControlMoreSetting.GetSteppingDelta();
var _GetDefaultValue = _CameraControlMoreSetting.GetDefaultValue();
var _GetIfAuto = _CameraControlMoreSetting.GetIfAuto();
alert("MinValue: " + _GetMinValue + "; MaxValue: " + _GetMaxValue + "; SteppingDelta: " + _GetSteppingDelta + 
"; DefaultValue: " + _GetDefaultValue + "; IfAuto: " + _GetIfAuto);

See also

Addon.Webcam.GetCameraControlPropertySetting

Addon.Webcam.GetVideoPropertySetting

Addon.Webcam.GetVideoPropertyMoreSetting

Addon.Webcam.SetVideoPropertySetting