Class CameraSettings

Definition

Namespace:

Tizen.Multimedia

Assembly:

Tizen.Multimedia.Camera.dll

The camera setting class provides methods/properties to get and set basic camera attributes.

public class CameraSettings

Inheritance

object

CameraSettings

Properties

AntiShake

The anti shake feature. If true, the antishake feature is enabled, otherwise false.

Declaration

public bool AntiShake { get; set; }

Property Value

Type	Description
bool

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

AutoContrast

The auto contrast. If true auto contrast is enabled, otherwise false.

Declaration

public bool AutoContrast { get; set; }

Property Value

Type	Description
bool

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

AutoFocusMode

The auto focus mode.

Declaration

public CameraAutoFocusMode AutoFocusMode { get; set; }

Property Value

Type	Description
CameraAutoFocusMode	A CameraAutoFocusMode that specifies the auto focus mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

Brightness

The brightness level of the camera.

Declaration

public int Brightness { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

BrightnessRange

Gets the available brightness level.

Declaration

public Range BrightnessRange { get; }

Property Value

Type	Description
Range

Remarks

If the minimum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

CapturePixelFormat

Format of an image to be captured.

Declaration

public CameraPixelFormat CapturePixelFormat { get; set; }

Property Value

Type	Description
CameraPixelFormat	A CameraPixelFormat that specifies the pixel format of captured image.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.

CaptureResolution

Resolution of the captured image.

Declaration

public Size CaptureResolution { get; set; }

Property Value

Type	Description
Size

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.

Contrast

The contrast level of the camera.

Declaration

public int Contrast { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ContrastRange

Gets the available contrast level.

Declaration

public Range ContrastRange { get; }

Property Value

Type	Description
Range

Remarks

If the mininum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

Effect

The camera effect mode.

Declaration

public CameraEffectMode Effect { get; set; }

Property Value

Type	Description
CameraEffectMode	A CameraEffectMode that specifies the effect mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

EnableTag

The scene mode.

Declaration

public bool EnableTag { get; set; }

Property Value

Type	Description
bool	true if EXIF tags are enabled in the JPEG file, otherwise false.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

EncodedPreviewBitrate

The bit rate of the encoded preview.

Declaration

public int EncodedPreviewBitrate { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

EncodedPreviewGopInterval

The GOP(Group Of Pictures) interval of the encoded preview.

Declaration

public int EncodedPreviewGopInterval { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

Exposure

The exposure value.

Declaration

public int Exposure { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ExposureMode

The exposure mode.

Declaration

public CameraExposureMode ExposureMode { get; set; }

Property Value

Type	Description
CameraExposureMode	A CameraExposureMode that specifies the exposure mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ExposureRange

Gets the available exposure value.

Declaration

public Range ExposureRange { get; }

Property Value

Type	Description
Range

Remarks

If the minimum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

FlashMode

The camera's flash mode.

Declaration

public CameraFlashMode FlashMode { get; set; }

Property Value

Type	Description
CameraFlashMode	A CameraFlashMode that specifies the flash mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

GeoTag

The geo tag(GPS data) in the EXIF tag.

Declaration

public Location GeoTag { get; set; }

Property Value

Type	Description
Location

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

HdrMode

The mode of the HDR(High dynamic range) capture.

Declaration

public CameraHdrMode HdrMode { get; set; }

Property Value

Type	Description
CameraHdrMode	A CameraHdrMode that specifies the HDR mode.

Remarks

Taking multiple pictures at different exposure levels and intelligently stitching them together, so that we eventually arrive at a picture that is representative in both dark and bright areas. If this attribute is set, then event handler set for the HdrCaptureProgress event is invoked.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

Hue

The hue level of the camera.

Declaration

public int Hue { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

HueRange

Gets the available hue level.

Declaration

public Range? HueRange { get; }

Property Value

Type	Description
Range?

Remarks

If HueRange returns null, it means that hue feature is not supported. It can be checked also with IsHueSupported.

See Also

Hue

ImageDescriptionTag

The camera image description in the EXIF tag.

Declaration

public string ImageDescriptionTag { get; set; }

Property Value

Type	Description
string

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ImageQuality

The quality of the image. The range for the image quality is 1 to 100.

Declaration

public int ImageQuality { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

IsoLevel

The ISO level.

Declaration

public CameraIsoLevel IsoLevel { get; set; }

Property Value

Type	Description
CameraIsoLevel	A CameraIsoLevel that specifies the ISO level.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

LensOrientation

Gets the camera lens orientation angle.

Declaration

public int LensOrientation { get; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

OrientationTag

The camera orientation in the tag.

Declaration

public CameraTagOrientation OrientationTag { get; set; }

Property Value

Type	Description
CameraTagOrientation

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

PanRange

Gets the lower limit and the upper limit for the pan position.

Declaration

public Range PanRange { get; }

Property Value

Type	Description
Range

Remarks

If the minimum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

PreviewFps

The preview frame rate.

Declaration

public CameraFps PreviewFps { get; set; }

Property Value

Type	Description
CameraFps	A CameraFps that specifies the preview frame rate.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

PreviewPixelFormat

The preview data format.

Declaration

public CameraPixelFormat PreviewPixelFormat { get; set; }

Property Value

Type	Description
CameraPixelFormat	A CameraPixelFormat that specifies the pixel format of the preview data.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.

PreviewResolution

Gets or sets the resolution of the preview.

Declaration

public Size PreviewResolution { get; set; }

Property Value

Type	Description
Size

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.

PtzType

Sets the type of the PTZ(Pan Tilt Zoom). Mechanical or electronic.

Declaration

public CameraPtzType PtzType { set; }

Property Value

Type	Description
CameraPtzType	A CameraPtzType that specifies the type of the PTZ.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

RecommendedPreviewResolution

Gets the recommended preview resolution.

Declaration

public Size RecommendedPreviewResolution { get; }

Property Value

Type	Description
Size

Remarks

Depending on the capture resolution aspect ratio and the display resolution, the recommended preview resolution is determined.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

SceneMode

The scene mode.

Declaration

public CameraSceneMode SceneMode { get; set; }

Property Value

Type	Description
CameraSceneMode	A CameraSceneMode that specifies the scene mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

SoftwareTag

The software information in the EXIF tag.

Declaration

public string SoftwareTag { get; set; }

Property Value

Type	Description
string

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

StreamFlip

The stream flip.

Declaration

public Flips StreamFlip { get; set; }

Property Value

Type	Description
Flips	A Flips that specifies the camera flip type.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

StreamRotation

The stream rotation.

Declaration

public Rotation StreamRotation { get; set; }

Property Value

Type	Description
Rotation	A Rotation that specifies the rotation of camera device.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

TheaterMode

The theater mode.

Declaration

public CameraTheaterMode TheaterMode { get; set; }

Property Value

Type	Description
CameraTheaterMode	A CameraTheaterMode that specifies the theater mode.

Remarks

If you want to display the preview image on the external display with the full screen mode, use this property.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

TiltRange

Gets the lower limit and the upper limit for the tilt position.

Declaration

public Range TiltRange { get; }

Property Value

Type	Description
Range

Remarks

If the minimum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

VideoStabilization

Enables or disables the video stabilization feature. If true, video stabilization is enabled, otherwise false.

Declaration

public bool VideoStabilization { get; set; }

Property Value

Type	Description
bool

Remarks

If video stabilization is enabled, zero shutter lag is disabled. This feature is used to record a video.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

WhiteBalance

The white balance mode.

Declaration

public CameraWhiteBalance WhiteBalance { get; set; }

Property Value

Type	Description
CameraWhiteBalance	A CameraWhiteBalance that specifies the white balance mode.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ZoomLevel

The zoom level. The range for the zoom level is received from the ZoomRange property.

Declaration

public int ZoomLevel { get; set; }

Property Value

Type	Description
int

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

ZoomRange

Gets the available zoom level.

Declaration

public Range ZoomRange { get; }

Property Value

Type	Description
Range

Remarks

If the minimum value is greater than the maximum value, it means this feature is not supported.

Exceptions

Type	Condition
System.NotSupportedException	In case of this feature is not supported.

Methods

ClearFocusArea()

Clears the auto focus area.

Declaration

public void ClearFocusArea()

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

DisableShutterSound(bool)

Turn the shutter sound on or off, if it is permitted by policy.

Declaration

public void DisableShutterSound(bool shutterSound)

Parameters

Type	Name	Description
bool	shutterSound	Shutter sound On/Off flag

Remarks

If this value is true, shutter sound will be disabled, otherwise enabled. In some countries, this operation is not permitted.

Exceptions

Type	Condition
System.InvalidOperationException	Disabling shutter sound is not permitted.
System.ObjectDisposedException	The camera already has been disposed of.

GetPan()

Gets the current position of the camera.

Declaration

public int GetPan()

Returns

Type	Description
int	Returns the camera's horizontal position.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

GetTilt()

Gets the current position of the camera.

Declaration

public int GetTilt()

Returns

Type	Description
int	Returns the current vertical position.

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

RemoveGeoTag()

Removes the geo tag(GPS data) in the EXIF(EXchangeable Image File format) tag.

Declaration

public void RemoveGeoTag()

Exceptions

Type	Condition
System.ObjectDisposedException	The camera already has been disposed of.

SetAutoFocusArea(int, int)

Sets the auto focus area.

Declaration

public void SetAutoFocusArea(int x, int y)

Parameters

Type	Name	Description
int	x	X position.
int	y	Y position.

Remarks

CameraAutoFocusMode should not be the None.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.InvalidOperationException	In case of any invalid operations.
System.ObjectDisposedException	The camera already has been disposed of.

SetAutoFocusArea(Point)

Sets the auto focus area.

Declaration

public void SetAutoFocusArea(Point pos)

Parameters

Type	Name	Description
Point	pos	Point structure including X, Y position.

Remarks

CameraAutoFocusMode should not be the None.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.InvalidOperationException	In case of any invalid operations.
System.ObjectDisposedException	The camera already has been disposed of.

SetPan(CameraPtzMoveType, int)

Sets the position to move horizontally.

Declaration

public void SetPan(CameraPtzMoveType type, int panStep)

Parameters

Type	Name	Description
CameraPtzMoveType	type	The PTZ move type. CameraPtzMoveType.
int	panStep	The pan step.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.

SetTilt(CameraPtzMoveType, int)

Sets the position to move vertically.

Declaration

public void SetTilt(CameraPtzMoveType type, int tiltStep)

Parameters

Type	Name	Description
CameraPtzMoveType	type	the PTZ move type.
int	tiltStep	The tilt step.

Exceptions

Type	Condition
System.ArgumentException	In case of invalid parameters.
System.ObjectDisposedException	The camera already has been disposed of.