CameraControl.SaveSettingsToXml(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 specified file in XML format.

Namespace : DevExpress.XtraEditors.Camera

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

• C#
• VB.NET

public virtual void SaveSettingsToXml(
    string xmlFile
)

Public Overridable Sub SaveSettingsToXml(
    xmlFile As String
)

Parameters

A String value that specifies the name of file to save video settings.

|

Remarks

Use the SaveSettingsToXml method to save the video settings (see CameraControl.VideoSettings) of the currently used device (see CameraControl.Device) to the specified file in XML format. The settings can then be restored via the CameraControl.RestoreSettingsFromXml method.

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 the system registry using the CameraControl.SaveSettingsToRegistry method.

See Also

RestoreSettingsFromXml(String)

SaveSettingsToRegistry(String)

CameraControl Class

CameraControl Members

DevExpress.XtraEditors.Camera Namespace