/// and functions for picture manipulations like sepia negative and many more.
/// It also notifies you when a significant picture parameter changes e.g. focus.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
public class Camera : IDisposable, IDisplayable<CameraError>
{
private IntPtr _handle = IntPtr.Zero;
/// Initializes a new instance of the <see cref="Camera"/> Class.
/// </summary>
/// <param name="device">The camera device to access</param>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
public Camera(CameraDevice device)
{
CameraErrorFactory.ThrowIfError(Native.Create((int)device, out _handle),
/// Changes the camera device.
/// </summary>
/// <param name="device">The hardware camera to access.</param>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <remarks>
/// If display reuse is set using <see cref="DisplayReuseHint"/>
/// before stopping the preview, the display will be reused and last frame on the display
/// <summary>
/// Gets the device state.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="device">The device to get state.</param>
/// <returns>Returns the state of camera device</returns>
/// <exception cref="ArgumentException">In case of invalid parameters.</exception>
/// <summary>
/// Gets the flash state.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="device">The device to get state.</param>
/// <returns>Returns the flash state of camera device</returns>
/// <exception cref="ArgumentException">In case of invalid parameters.</exception>
/// <remarks>
/// <see cref="CameraAutoFocusMode"/> should not be the <see cref="CameraAutoFocusMode.None"/>.
/// </remarks>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="x">X position</param>
/// <param name="y">Y position</param>
/// <exception cref="ArgumentException">In case of invalid parameters.</exception>
/// <remarks>
/// <see cref="CameraAutoFocusMode"/> should not be the <see cref="CameraAutoFocusMode.None"/>.
/// </remarks>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="pos"><see cref="Point"/> structure including X, Y position</param>
/// <exception cref="ArgumentException">In case of invalid parameters.</exception>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <summary>
/// Clears the auto focus area.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public void ClearFocusArea()
{
/// The auto focus mode.
/// </summary>
/// <value>A <see cref="CameraAutoFocusMode"/> that specifies the auto focus mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraAutoFocusMode AutoFocusMode
{
/// <summary>
/// The contrast level of the camera.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int Contrast
{
/// The auto contrast.
/// If true auto contrast is enabled, otherwise false.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public bool AutoContrast
{
/// <summary>
/// The brightness level of the camera.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int Brightness
{
/// <summary>
/// The exposure value.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int Exposure
{
/// The exposure mode.
/// </summary>
/// <value>A <see cref="CameraExposureMode"/> that specifies the exposure mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraExposureMode ExposureMode
{
/// The zoom level.
/// The range for zoom level is received from ZoomRange property.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera.
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int ZoomLevel
{
/// The whitebalance mode.
/// </summary>
/// <value>A <see cref="CameraWhiteBalance"/> that specifies the white balance mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraWhiteBalance WhiteBalance
{
/// The ISO level.
/// </summary>
/// <value>A <see cref="CameraIsoLevel"/> that specifies ISO level.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraIsoLevel IsoLevel
{
/// The quality of the image.
/// The range for image quality is 1 to 100.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera.
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int ImageQuality
{
/// <summary>
/// Gets or sets the resolution of preview
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ArgumentException">In case of invalid parameters.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public Size PreviewResolution
/// <summary>
/// Resolution of the captured image.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ArgumentException">In case of invalid parameters</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public Size CaptureResolution
/// The theater mode.
/// </summary>
/// <value>A <see cref="CameraTheaterMode"/> that specifies theater mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <remarks>
/// If you want to display the preview image on the external display with the full screen mode,
/// use this property.
/// The camera effect mode.
/// </summary>
/// <value>A <see cref="CameraEffectMode"/> that specifies effect mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraEffectMode Effect
{
/// The scene mode.
/// </summary>
/// <value>A <see cref="CameraSceneMode"/> that specifies scene mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraSceneMode SceneMode
{
/// The camera's flash mode.
/// </summary>
/// <value>A <see cref="CameraFlashMode"/> that specifies flash mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public CameraFlashMode FlashMode
{
/// The mode of HDR(High dynamic range) capture.
/// </summary>
/// <value>A <see cref="CameraHdrMode"/> that specifies the HDR mode.</value>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <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.
/// Enables/Disables the video stabilization feature.
/// If true video stabilization is enabled, otherwise false.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <remarks>
/// If video stabilization is enabled, zero shutter lag is disabled.
/// This feature is used to record a video.
/// <summary>
/// Sets the position to move horizontally.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="type">ptz move type. <seealso cref="CameraPtzMoveType"/></param>
/// <param name="panStep">pan step</param>
/// <exception cref="ArgumentException">In case of invalid parameters</exception>
/// <summary>
/// Gets the current position of the camera.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <returns>Returns the camera's horizontal position</returns>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int GetPan()
/// <summary>
/// Sets the position to move vertically.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <param name="type">ptz move type</param>
/// <param name="tiltStep">tilt step</param>
/// <exception cref="ArgumentException">In case of invalid parameters</exception>
/// <summary>
/// Gets the current position of the camera.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <returns>Returns the current vertical position</returns>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public int GetTilt()
/// <summary>
/// Removes the geotag(GPS data) in the EXIF(Exchangeable image file format) tag.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public void RemoveGeoTag()
{
/// to start, stop and save the recorded content. It also provides methods
/// to get/set various attributes and capabilities of recorder.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/recorder
- /// </privilege>
public class Recorder : IDisposable
{
private IntPtr _handle = IntPtr.Zero;
/// <summary>
/// Audio recorder constructor.
/// </summary>
- /// /// <privilege>
- /// http://tizen.org/privilege/microphone
- /// </privilege>
public Recorder()
{
RecorderErrorFactory.ThrowIfError(Native.Create(out _handle),
/// <param name="camera">
/// The camera object.
/// </param>
- /// <privilege>
- /// http://tizen.org/privilege/camera
- /// </privilege>
public Recorder(Camera camera)
{
RecorderErrorFactory.ThrowIfError(Native.CreateVideo(camera.Handle, out _handle),
/// Before calling the function, it is required to set AudioEncoder,
/// videoencoder and fileformat properties of recorder.
/// </remarks>
- /// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
- /// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public void Prepare()
/// After this method is finished without any exception,
/// The state of recorder will be changed to <see cref="RecorderState.Created"/> state.
/// </summary>
- /// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
- /// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
public void Unprepare()
/// The filename should be set before this function is invoked.
/// </remarks>
/// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
+ /// http://tizen.org/privilege/recorder
/// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
+ /// <exception cref="UnauthorizedAccessException">In case of access to the resources cannot be granted.</exception>
public void Start()
{
ValidateState(RecorderState.Ready, RecorderState.Paused);
/// Recording can be resumed with Start().
/// </remarks>
/// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
+ /// http://tizen.org/privilege/recorder
/// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
+ /// <exception cref="UnauthorizedAccessException">In case of access to the resources cannot be granted.</exception>
public void Pause()
{
ValidateState(RecorderState.Recording);
/// The state of recorder will be changed to <see cref="RecorderState.Ready"/> state.
/// </summary>
/// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
+ /// http://tizen.org/privilege/recorder
/// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
+ /// <exception cref="UnauthorizedAccessException">In case of access to the resources cannot be granted.</exception>
public void Commit()
{
ValidateState(RecorderState.Recording, RecorderState.Paused);
/// The state of recorder will be changed to <see cref="RecorderState.Ready"/> state.
/// </summary>
/// <privilege>
- /// http://tizen.org/privilege/camera or http://tizen.org/privilege/microphone
+ /// http://tizen.org/privilege/recorder
/// </privilege>
/// <exception cref="InvalidOperationException">In case of any invalid operations.</exception>
/// <exception cref="ObjectDisposedException">The camera already has been disposed.</exception>
+ /// <exception cref="UnauthorizedAccessException">In case of access to the resources cannot be granted.</exception>
public void Cancel()
{
ValidateState(RecorderState.Recording, RecorderState.Paused);