CameraControl.SaveSettingsToRegistry(String) Method

SECURITY-RELATED CONSIDERATIONS

Using file paths sourced from untrusted input may expose unauthorized files or allow unintended file access. Always validate and normalize all external paths to prevent path manipulation.

Saves video settings of the currently used capture device to the system registry.

Namespace : DevExpress.XtraEditors.Camera

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

• C#
• VB.NET

public virtual bool SaveSettingsToRegistry(
    string path
)

Public Overridable Function SaveSettingsToRegistry(
    path As String
) As Boolean

Parameters

A String value specifying the system registry path to which video settings are saved.

|

Returns

true if the operation is successfully completed; otherwise, false.

|

Remarks

Use the SaveSettingsToRegistry method to save the video settings (see CameraControl.VideoSettings) of the currently used device (see CameraControl.Device) to the system registry. The settings can then be restored via the CameraControl.RestoreSettingsFromRegistry method.

For the path parameter you can define whole and partial registry keys. For example, if you define “Software\Company", the full path will be as follows: “HKEY_CURRENT_USER\Software\Company". To store the settings in a different root key, define the entire path in the following form “HKEY_LOCAL_MACHINE\Software\Company".

The values of the following video properties are preserved:

• CameraDeviceBase.Name—Gets the UI display name of the video capture device.
• CameraDeviceBase.Resolution—Gets or sets the resolution of a video stream captured by the current device.
• DeviceVideoSettings.BacklightCompensation—Provides access to the video property that specifies the backlight compensation setting.
• DeviceVideoSettings.Brightness—Provides access to the video property that specifies the brightness, also called the black level.
• DeviceVideoSettings.ColorEnable—Provides access to the video property that specifies the color enable setting.
• DeviceVideoSettings.Contrast—Provides access to the video property that specifies the contrast.
• DeviceVideoSettings.Gain—Provides access to the video property that specifies the gain adjustment.
• DeviceVideoSettings.Gamma—Provides access to the video property that specifies the gamma.
• DeviceVideoSettings.Hue—Provides access to the video property that specifies the hue.
• DeviceVideoSettings.Saturation—Provides access to the video property that specifies the saturation.
• DeviceVideoSettings.Sharpness—Provides access to the video property that specifies the sharpness.
• DeviceVideoSettings.WhiteBalance—Provides access to the video property that specifies the white balance, as a color temperature in degrees Kelvin.

You can also save settings to a file in XML format using the CameraControl.SaveSettingsToXml method.

See Also

RestoreSettingsFromRegistry(String)

SaveSettingsToXml(String)

CameraControl Class

CameraControl Members

DevExpress.XtraEditors.Camera Namespace