DeviceVideoSettings Class
Provides access to the video properties on a video capture device.
Namespace: DevExpress.Data.Camera
Assembly: DevExpress.Data.Desktop.v24.1.dll
NuGet Packages: DevExpress.Data.Desktop, DevExpress.ExpressApp.Win.Design
Declaration
[TypeConverter(typeof(ExpandableObjectConverter))]
public class DeviceVideoSettings :
INotifyPropertyChangedRelated API Members
The following members return DeviceVideoSettings objects:
| Library | Related API Members |
|---|---|
| WinForms Controls | CameraControl.VideoSettings |
| WPF Controls | CameraControl.DeviceSettings |
Remarks
The DeviceVideoSettings object provides access to the video properties on a video capture device, such as a webcam. Typically, video capture devices support the brightness, contrast, hue, saturation, gamma, and sharpness video properties. For instance, the DeviceVideoSettings.Brightness property provides access to the video property that specifies the brightness, also called the black level. The availability of each video property, as well as the range, default value, and step size, depends on the particular video capture device.
Video properties are represented by the DeviceVideoProperty objects. This class exposes the DeviceVideoProperty.Min, DeviceVideoProperty.Max, DeviceVideoProperty.Default and DeviceVideoProperty.SteppingDelta properties that return the extreme and default values, and the step size by which the video property can be changed. The current value of a video property can be get or set using the DeviceVideoProperty.Value property. The DeviceVideoSettings object does not hold the video property values (these are stored by the device itself), rather, it provides the capability to get and set a video property value on a particular device. Thus, changing video property values may affect the quality of videos captured by the device in other applications. If a device does not support a particular video property, changing the value has no effect.
The DeviceVideoSettings object is designed to be associated with an object that implements the ICameraDeviceClient interface. This object controls a video capture device, processes the video stream received from this device, and provides end-users with the capability to adjust the video properties. An example of an object that implements the ICameraDeviceClient interface is the CameraControl. An instance of the DeviceVideoSettings object can be accessed through the CameraControl.VideoSettings property.