Skip to main content

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 :
    INotifyPropertyChanged

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.

Inheritance

Object
DeviceVideoSettings
See Also