{
public:
/**
- * This is the default constructor for this class.
- *
- * @since 2.0
- *
- * @remarks The object is not fully constructed after this constructor is called. For full construction,
- * the Construct() method must be called right after calling this constructor.
- */
+ * This is the default constructor for this class.
+ *
+ * @since 2.0
+ *
+ * @remarks
+ * -The object is not fully constructed after this constructor is called. For full construction,
+ * the Construct() method must be called right after calling this constructor.
+ */
Camera(void);
/**
- * This is the destructor for this class. @n
- * All allocated resources are deallocated by this method. This method must be called in the same thread
- * where the Construct() method is called.This polymorphic destructor should be overridden if required.
- * This way, the destructors of the derived classes are called when the destructor of this interface is called.
- *
- * @since 2.0
- *
- */
+ * This is the destructor for this class. @n
+ * All allocated resources are deallocated by this method. This method must be called in the same thread
+ * where the Construct() method is called.This polymorphic destructor should be overridden if required.
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ *
+ * @since 2.0
+ *
+ */
virtual ~Camera(void);
/**
*
* @since 2.0
*
+ * @feature %http://tizen.org/feature/camera.back or %http://tizen.org/feature/camera.front
* @return An error code
* @param[in] listener An instance of ICameraEventListener
* @param[in] camSel The %Camera to power on
* @exception E_SYSTEM A system error has occurred.
* @exception E_DEVICE_BUSY The camera is under use by other application or already used in this application.
* @exception E_DEVICE_UNAVAILABLE The camera is unavailable.
- * @exception E_UNSUPPORTED_OPERATION The camera usage is not supported.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(ICameraEventListener& listener, CameraSelection camSel = CAMERA_PRIMARY);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The reserved configurations are set in this method.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
+ * @remarks
+ * -reserved configurations are set in this method.
* @see PowerOff()
*/
result PowerOn(void);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @see PowerOn()
*/
result PowerOff(void);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] pBufferInfo The buffer information for the camera preview display
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The overlay region retrieved by the buffer information must be the topmost window when this method is
- * called.
- * @remarks The ICameraEventListener::OnCameraPreviewed() method can be delayed or dropped depending on
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
+ * @remarks
+ * -The overlay region retrieved by the buffer information must be the topmost window when this method is called. @n
+ * -The ICameraEventListener::OnCameraPreviewed() method can be delayed or dropped depending on
* the system's performance. @n
- * For more information on the relationship between this method and the PowerOn() method, and the
+ * -For more information on the relationship between this method and the PowerOn() method, and the
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see StopPreview()
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
+ * @remarks
+ * - For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see StartPreview()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support capture feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
- * @remarks In a zero-shutter-lag camera, the state changes to ::CAMERA_STATE_PREVIEW after capturing.
- * @remarks The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
+ * -In a zero-shutter-lag camera, the state changes to ::CAMERA_STATE_PREVIEW after capturing.
+ * -The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
* ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see ICameraEventListener::OnCameraCaptured()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] brightness The brightness level to set @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support brightness configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default brightness level is @c 5. @n
- * The device's supported range for the brightness level is from @c 0 to @c 9. @n
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -The default brightness level is @c 5. @n
+ * -The device's supported range for the brightness level is from @c 0 to @c 9. @n
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetBrightness()
*/
*
* @return The current brightness level @n
* The returned value ranges from @c 0 to @c 9.
- * @remarks The device's supported range for the brightness level is from @c 0 to @c 9.
+ * @remarks
+ * -The device's supported range for the brightness level is from @c 0 to @c 9.
* @see SetBrightness()
*/
int GetBrightness(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] contrast The contrast level to set @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support contrast configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default contrast level is @c 5. @n
- * The device's supported range for the contrast level is from @c 0 to @c 9. @n
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
+ * @remarks
+ * -The default contrast level is @c 5. @n
+ * -The device's supported range for the contrast level is from @c 0 to @c 9. @n
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetContrast()
*
* @return The current contrast level @n
* The returned value ranges from @c 0 to @c 9.
- * @remarks The device's supported range for the contrast level is from @c 0 to @c 9.
+ * @remarks
+ * -The device's supported range for the contrast level is from @c 0 to @c 9.
* @see SetContrast()
*/
int GetContrast(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support zooming feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * If Camera supports only ::CAMERA_ZOOM_TYPE_SMART, the zoom ratio can differ according
+ * @remarks
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -If Camera supports only ::CAMERA_ZOOM_TYPE_SMART, the zoom ratio can differ according
* to the preview, capture, and recording resolutions.
- * The supported zoom types can be obtained by using the
+ * -The supported zoom types can be obtained by using the
* MediaCapability::GetValueN(CAMERA_PRIMARY_ZOOM_TYPE) method. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see ZoomOut()
* @see GetZoomLevel()
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support zooming feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * If CameraZoomType supports only ::CAMERA_ZOOM_TYPE_SMART, zoom ratio can differ according to
+ * @remarks
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -If CameraZoomType supports only ::CAMERA_ZOOM_TYPE_SMART, zoom ratio can differ according to
* the preview, capture, and recording resolutions.
- * The supported zoom types can be obtained by using the
+ * -The supported zoom types can be obtained by using the
* MediaCapability::GetValueN(CAMERA_PRIMARY_ZOOM_TYPE) method. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see ZoomIn()
* @see GetZoomLevel()
* @since 2.0
*
* @return The current zoom level
- * @remarks The zoom level is different for each camera device.
+ * @remarks
+ * -The zoom level is different for each camera device.
* @see ZoomIn()
* @see ZoomOut()
* @see GetMaxZoomLevel()
* @since 2.0
*
* @return The maximum zoom level
- * @remarks The zoom level is different for each camera device.
+ * @remarks
+ * -The zoom level is different for each camera device.
* @see ZoomIn()
* @see ZoomOut()
* @see GetZoomLevel()
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] resolution The preview resolution @n
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support preview resolution configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method works in the ::CAMERA_STATE_INITIALIZED state. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -This method works in the ::CAMERA_STATE_INITIALIZED state. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetPreviewResolution()
*/
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value and each item in the list must be deleted by the caller.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value and each item in the list must be deleted by the caller.
* @see SetPreviewResolution()
* @see GetPreviewResolution()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] resolution The display resolution @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support capture resolution configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks For more information on the relationship between this method and the PowerOn() method, and the
+ * @remarks
+ * -For more information on the relationship between this method and the PowerOn() method, and the
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
- * @remarks In a zero-shutter-lag camera, the default preview format applies this feature correctly. The other preview formats are not guaranteed.
- * @remarks The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
+ * -In a zero-shutter-lag camera, the default preview format applies this feature correctly. The other preview formats are not guaranteed.
+ * -The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
* ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see GetCaptureResolution()
*/
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value and each item in the list must be deleted by the caller.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value and each item in the list must be deleted by the caller.
* @see SetCaptureResolution()
* @see GetCaptureResolution()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] effect The effect for the input data of the camera
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support effect configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c effect is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default effect is ::CAMERA_EFFECT_NONE.
- * This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -The default effect is ::CAMERA_EFFECT_NONE.
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetEffect()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera.back.flash or %http://tizen.org/feature/camera.front.flash
*
* @return An error code
* @param[in] flashOn Set to @c true to switch on the flash light, @n
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support flash configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The flash is switched on when the camera captures a picture. If the value of @c flashOn is
+ * @remarks
+ * -The flash is switched on when the camera captures a picture. If the value of @c flashOn is
* set to @c true, this method returns E_UNSUPPORTED_OPERATION in the Emulator. @n
- * SetFlash(true) works same as SetFlashMode(CAMERA_FLASH_MODE_ON) and SetFlash(false) works same as SetFlashMode(CAMERA_FLASH_MODE_OFF). @n
- * For more information on the relationship between this method and the PowerOn() method, and the
+ * -SetFlash(true) works same as SetFlashMode(CAMERA_FLASH_MODE_ON) and SetFlash(false) works same as SetFlashMode(CAMERA_FLASH_MODE_OFF). @n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
- * @remarks In a zero-shutter-lag camera, only the default preview format applies this feature.
+ * @remarks
+ * -In a zero-shutter-lag camera, only the default preview format applies this feature.
* @see IsFlashOn()
* @see SetFlashMode()
* @see CameraFlashMode
*
* @return @c true if the flash light is on, @n
* else @c false
- * @remarks This method works same as return (GetFlashMode()!=CAMERA_FLASH_MODE_OFF).
+ * @remarks
+ * -This method works same as return (GetFlashMode()!=CAMERA_FLASH_MODE_OFF).
* @see SetFlash()
* @see GetFlashMode()
* @see CameraFlashMode
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera.back.flash or %http://tizen.org/feature/camera.front.flash
*
* @return An error code
* @param[in] flashMode flash mode to switch on the flash light.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support flash configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c flashMode is not supported.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks Normally the flash splashes before the camera captures a picture. @n
+ * @remarks
+ * -Normally the flash splashes before the camera captures a picture. @n
* ::CAMERA_FLASH_MODE_CONTINUOUS keeps the flash turned on after the method is called until ::CAMERA_FLASH_MODE_OFF is set. @n
- * This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * @remarks In a zero-shutter-lag camera, the default preview format applies this feature correctly. The other preview formats are not guaranteed.
- * @remarks The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -In a zero-shutter-lag camera, the default preview format applies this feature correctly. The other preview formats are not guaranteed.
+ * -The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
* ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see GetFlashMode()
*/
* @since 2.0
*
* @return The flash mode of the camera
- * @remarks If the %Camera doesn't support the flash mode, this method always returns ::CAMERA_FLASH_MODE_OFF.
+ * @remarks
+ * -If the %Camera doesn't support the flash mode, this method always returns ::CAMERA_FLASH_MODE_OFF.
* @see SetFlashMode()
*/
CameraFlashMode GetFlashMode(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] exposure The camera exposure level @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support exposure configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default exposure level is @c 5.
- * The supported range for exposure level is from @c 0 to @c 9.
- * This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -The default exposure level is @c 5.
+ * -The supported range for exposure level is from @c 0 to @c 9.
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetExposure()
*/
*
* @return An integer value representing the exposure level of the camera @n
* The returned value ranges from @c 0 to @c 9.
- * @remarks The supported range for exposure level is from @c 0 to @c 9.
+ * @remarks
+ * -The supported range for exposure level is from @c 0 to @c 9.
* @see SetExposure()
*/
int GetExposure(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] whiteBalance The camera white balance level
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support white balance configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c whiteBalance is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default white balance is ::CAMERA_WHITE_BALANCE_AUTO.
- * This method returns E_UNSUPPORTED_OPERATION in the Emulator.
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -The default white balance is ::CAMERA_WHITE_BALANCE_AUTO.
+ * -This method returns E_UNSUPPORTED_OPERATION in the Emulator.
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetWhiteBalance()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] quality The camera's quality level
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support capturing quality configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks The default quality is ::CAMERA_QUALITY_NORMAL.
- * This method works correctly when PowerOn() is executed. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -The default quality is ::CAMERA_QUALITY_NORMAL.
+ * -This method works correctly when PowerOn() is executed. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetQuality()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] focusMode focus mode
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_INVALID_ARG The specified focus mode is invalid.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support focus mode configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c focusMode is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks ::CAMERA_FOCUS_MODE_NONE always throws E_INVALID_ARG.
+ * @remarks
+ * -::CAMERA_FOCUS_MODE_NONE always throws E_INVALID_ARG.
* @see GetFocusMode()
*/
result SetFocusMode(CameraFocusMode focusMode);
* @since 2.0
*
* @return The %Camera focus mode
- * @remarks If the %Camera does not support the focus mode, this method always returns ::CAMERA_FOCUS_MODE_NONE.
+ * @remarks
+ * -If the %Camera does not support the focus mode, this method always returns ::CAMERA_FOCUS_MODE_NONE.
* @see SetFocusMode()
*/
CameraFocusMode GetFocusMode(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] pointList The auto focus point list which consists of Tizen::Graphics::Point pointers
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support focus pointing feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE This method is not supported for the current focus mode.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method works fine when the current focus mode is @c CAMERA_FOCUS_MODE_NORMAL or @c CAMERA_FOCUS_MODE_MACRO.@n
- * If the input parameter has a empty list, the focus area is changed to the center.
+ * @remarks
+ * -This method works fine when the current focus mode is @c CAMERA_FOCUS_MODE_NORMAL or @c CAMERA_FOCUS_MODE_MACRO.@n
+ * -If the input parameter has a empty list, the focus area is changed to the center.
* @see GetAutoFocusPointN()
*/
result SetAutoFocusPoint(const Tizen::Base::Collection::IList& pointList);
* else @c null if no auto focus point is set or if an exception occurs.
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value and each item in the list must be deleted by the caller.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value and each item in the list must be deleted by the caller.
* @see SetAutoFocusPoint()
*/
Tizen::Base::Collection::IList* GetAutoFocusPointN(void) const;
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] callback Set to @c true to enable auto focus callback, @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support auto focus feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks If @c callback is set to @c false, the ICameraEventListener::OnCameraAutoFocused() method is not called.
- * This method throws @c E_UNSUPPORTED_OPERATION in the emulator. @n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -If @c callback is set to @c false, the ICameraEventListener::OnCameraAutoFocused() method is not called.
+ * -This method throws @c E_UNSUPPORTED_OPERATION in the emulator. @n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
*/
result SetAutoFocus(bool callback);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] format The camera's capture format @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support capture format configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method works correctly when PowerOn() is executed.
+ * @remarks
+ * -This method works correctly when PowerOn() is executed.
* @see GetCaptureFormat()
*/
result SetCaptureFormat(const Tizen::Graphics::PixelFormat format);
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value must be deleted.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value must be deleted.
* @see SetCaptureFormat()
* @see GetCaptureFormat()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] format The camera's preview format @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support preview format configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method works in ::CAMERA_STATE_INITIALIZED state. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -This method works in ::CAMERA_STATE_INITIALIZED state. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetPreviewFormat()
* @see GetSupportedPreviewFormatListN()
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value must be deleted.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value must be deleted.
* @see SetPreviewFormat()
* @see GetPreviewFormat()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] isoLevel The camera's ISO level @n
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support iso level configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c isoLevel is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks In some devices this method works in the ::CAMERA_STATE_PREVIEW state.
- * This method throws E_UNSUPPORTED_OPERATION in the Emulator. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -In some devices this method works in the ::CAMERA_STATE_PREVIEW state.
+ * -This method throws E_UNSUPPORTED_OPERATION in the Emulator. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetIsoLevel()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] fps The frame rate per second
* @exception E_DEVICE_BUSY The camera is under use by other application.
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support preview frame rate configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks This method works in ::CAMERA_STATE_INITIALIZED state. @n@n
- * For more information on the relationship between this method and the PowerOn() method, and the
- * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
+ * @remarks
+ * -This method works in ::CAMERA_STATE_INITIALIZED state. @n@n
+ * -For more information on the relationship between this method and the PowerOn() method, and the
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* @see GetPreviewFrameRate()
* @see GetSupportedPreviewFrameRateListN()
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value must be deleted by the caller. @n
- * This method returns fps list that can be supported by all resolutions.
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value must be deleted by the caller. @n
+ * -This method returns fps list that can be supported by all resolutions.
* @see SetPreviewFrameRate()
* @see GetPreviewFrameRate()
* @see FRAME_RATE_AUTO
* @exception E_INVALID_ARG The specified input resolution is invalid.
* @exception E_SYSTEM A system error has occurred.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks The specific error code can be accessed using the GetLastResult() method. @n
- * The return value must be deleted by the caller. @n
+ * @remarks
+ * -The specific error code can be accessed using the GetLastResult() method. @n
+ * -The return value must be deleted by the caller. @n
* @see SetPreviewFrameRate()
* @see GetPreviewFrameRate()
* @see GetSupportedPreviewFrameRateListN(void) const
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] orientation The orientation value to set in EXIF
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_STATE This instance is in an invalid state for this method.
* @exception E_OUT_OF_RANGE The input value is out of range.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support exif orientation configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The default value of orientation is @c CAMERA_EXIF_ORIENTATION_TOP_LEFT. @n
- * This method works correctly when PowerOn() is executed. The orientation value set by this method can be obtained using the
+ * @remarks
+ * -The default value of orientation is @c CAMERA_EXIF_ORIENTATION_TOP_LEFT. @n
+ * -This method works correctly when PowerOn() is executed. The orientation value set by this method can be obtained using the
* Tizen::Content::ImageData::GetOrientation() method after writing the captured data to a file.
*/
result SetExifOrientation(CameraExifOrientation orientation);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] latitude The latitude value to set in EXIF @n
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_STATE This instance is in an invalid state for this method.
* @exception E_OUT_OF_RANGE The input value is out of range.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support exif gps coordinates configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method sets the GPS coordinates and enables entering the coordinates into the Exchangeable Image File Format (EXIF).
- * @remarks By default, the GPS coordinates are not entered in JPEG's EXIF.
- * @remarks The GPS coordinates that are set using this method are entered in every call to the
+ * @remarks
+ * -This method sets the GPS coordinates and enables entering the coordinates into the Exchangeable Image File Format (EXIF).
+ * -By default, the GPS coordinates are not entered in JPEG's EXIF.
+ * -The GPS coordinates that are set using this method are entered in every call to the
* Capture() method, until DisableExifGpsCoordinates() is called or this instance is destroyed. @n
- * This method works correctly when PowerOn() is executed. @n
- * The values set by this method can result in an error as compared to the values stored in the Exchangeable Image File Format (EXIF) field.
+ * -This method works correctly when PowerOn() is executed. @n
+ * -The values set by this method can result in an error as compared to the values stored in the Exchangeable Image File Format (EXIF) field.
*/
result SetExifGpsCoordinates(double latitude, double longitude, float altitude);
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_STATE This instance is in an invalid state for this method.
* @exception E_OUT_OF_RANGE The input value is out of range.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support exif gps coordinates configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_SYSTEM A system error has occurred.
* @see SetExifGpsCoordinates()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] flip The camera flip type
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_STATE This instance is in an invalid state for this method.
* @exception E_INVALID_ARG The input value is out of range.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support flip configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c flip is not supported.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method works in the ::CAMERA_STATE_INITIALIZED state.
- * @remarks Finally the last specified type is applied even with the several types applicable.
- * @remarks In a zero-shutter-lag camera, the default preview format is not guaranteed to apply this feature correctly.
- * @remarks The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
+ * @remarks
+ * -This method works in the ::CAMERA_STATE_INITIALIZED state.
+ * -Finally the last specified type is applied even with the several types applicable.
+ * -In a zero-shutter-lag camera, the default preview format is not guaranteed to apply this feature correctly.
+ * -The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
* ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see GetFlip()
*/
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] rotation The camera rotation
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_INVALID_STATE This instance is in an invalid state for this method.
* @exception E_INVALID_ARG The input value is out of range.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support preview rotation configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c rotation is not supported.
* @exception E_SYSTEM A system error has occurred.
- * @remarks This method works in the ::CAMERA_STATE_INITIALIZED state.
- * @remarks The last specified type is applied even with the several types applicable.
- * @remarks This method rotates the preview and recording data but not the captured image. @n
- * The captured image's orientation is always following the physical rotation.
- * @remarks When the preview is rotated, the preview callback data's width and height can be changed. @n
- * Thus the application must recognize these changes when it uses the preview data in ICameraEventListener::OnCameraPreviewed() callback.
- * @remarks For the intended view of preview, Tizen::Ui::Controls::OverlayRegion::OVERLAY_REGION_TYPE_NORMAL must be selected when Tizen::Ui::Controls::OverlayRegion is created.
- * @remarks In a zero-shutter-lag camera, the default preview format is not guaranteed to apply this feature correctly.
- * @remarks The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
+ * @remarks
+ * -This method works in the ::CAMERA_STATE_INITIALIZED state.
+ * -The last specified type is applied even with the several types applicable.
+ * -This method rotates the preview and recording data but not the captured image. @n
+ * The captured image's orientation is always following the physical rotation.
+ * -When the preview is rotated, the preview callback data's width and height can be changed. @n
+ * Thus the application must recognize these changes when it uses the preview data in ICameraEventListener::OnCameraPreviewed() callback.
+ * - For the intended view of preview, Tizen::Ui::Controls::OverlayRegion::OVERLAY_REGION_TYPE_NORMAL must be selected when Tizen::Ui::Controls::OverlayRegion is created.
+ * -In a zero-shutter-lag camera, the default preview format is not guaranteed to apply this feature correctly.
+ * -The zero-shutter-lag capability can be checked using MediaCapability::GetValue(const Tizen::Base::String& key, bool& value) with
* ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see GetPreviewRotation()
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] meteringMode The metering mode
* @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
* @exception E_DEVICE_FAILED The device operation has failed.
* @exception E_INVALID_ARG The specified metering mode is invalid.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support metering mode configuration feature.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
* @exception E_UNSUPPORTED_TYPE The specified @c meteringMode is not supported.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks ::CAMERA_METERING_MODE_NONE always throws E_INVALID_ARG.
+ * @remarks
+ * -::CAMERA_METERING_MODE_NONE always throws E_INVALID_ARG.
* @see GetMeteringMode()
*/
result SetMeteringMode(CameraMeteringMode meteringMode);
* @since 2.0
*
* @return The %Camera metering mode
- * @remarks If the %Camera does not support the metering mode, this method always returns ::CAMERA_METERING_MODE_NONE.
+ * @remarks
+ * -If the %Camera does not support the metering mode, this method always returns ::CAMERA_METERING_MODE_NONE.
* @see SetMeteringMode()
*/
CameraMeteringMode GetMeteringMode(void) const;
/**
- * Sets the scene mode of the camera.
- *
- * @since 2.1
- * @privlevel public
- * @privilege %http://tizen.org/privilege/camera
- *
- * @return An error code
- * @param[in] sceneMode The scene mode
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_STATE This instance is in an invalid state for this method.
- * @exception E_DEVICE_BUSY The camera is under use by another application.
- * @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
- * @exception E_DEVICE_FAILED The device operation has failed.
- * @exception E_INVALID_ARG The specified @c sceneMode is invalid.
- * @exception E_UNSUPPORTED_OPERATION The target device does not support scene mode configuration feature.
- * @exception E_UNSUPPORTED_TYPE The specified @c sceneMode is not supported.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks In a specific scene mode, camera's attributes such as brightness, metering mode, iso level, white balance, flash, and focus are changed to the ones that are pre-defined by each scene mode. @n
- * In a specific scene mode, if an application sets any attribute that is related to the scene, the mode can be changed to ::CAMERA_SCENE_OFF. @n
- * Thus, it is recommended that the application check the current scene mode after setting the attributes. @n
- * In case that the scene mode is changed to ::CAMERA_SCENE_OFF, all the attributes set by the application are reloaded.
- */
+ * Sets the scene mode of the camera.
+ *
+ * @since 2.1
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
+ *
+ * @return An error code
+ * @param[in] sceneMode The scene mode
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_STATE This instance is in an invalid state for this method.
+ * @exception E_DEVICE_BUSY The camera is under use by another application.
+ * @exception E_DEVICE_UNAVAILABLE The camera becomes unavailable.
+ * @exception E_DEVICE_FAILED The device operation has failed.
+ * @exception E_INVALID_ARG The specified @c sceneMode is invalid.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
+ * @exception E_UNSUPPORTED_TYPE The specified @c sceneMode is not supported.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @remarks
+ * -In a specific scene mode, camera's attributes such as brightness, metering mode, iso level, white balance, flash, and focus are changed to the ones that are pre-defined by each scene mode. @n
+ * -In a specific scene mode, if an application sets any attribute that is related to the scene, the mode can be changed to ::CAMERA_SCENE_OFF. @n
+ * Thus, it is recommended that the application check the current scene mode after setting the attributes. @n
+ * -In case that the scene mode is changed to ::CAMERA_SCENE_OFF, all the attributes set by the application are reloaded.
+ */
result SetSceneMode(CameraSceneMode sceneMode);
* @since 2.1
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] filter An instance of IVideoStreamFilter
* @exception E_OBJ_ALREADY_EXIST The filter already exists.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @remarks IVideoStreamFilter::ProcessVideoStream() will be called when the video frame is ready.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
+ * @remarks
+ * -IVideoStreamFilter::ProcessVideoStream() will be called when the video frame is ready.
*/
result AddVideoStreamFilter(Tizen::Media::IVideoStreamFilter& filter);
* @since 2.1
* @privlevel public
* @privilege %http://tizen.org/privilege/camera
+ * @feature %http://tizen.org/feature/camera
*
* @return An error code
* @param[in] filter An instance of IVideoStreamFilter
* @exception E_SUCCESS The method is successful.
* @exception E_OBJ_NOT_FOUND The filter is not found.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature.
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/manifest_features.htm">Application Filtering</a>.
*/
result RemoveVideoStreamFilter(Tizen::Media::IVideoStreamFilter& filter);
private:
/**
- * This is the copy constructor for this class.
- *
- * @since 2.0
- *
- * @remarks The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
- * @see Construct()
- */
+ * This is the copy constructor for this class.
+ *
+ * @since 2.0
+ *
+ * @remarks
+ * -The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
+ * @see Construct()
+ */
Camera(const Camera& rhs);
/**
- * This is the copy assignment operator for this class.
- *
- * @since 2.0
- *
- * @remarks The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
- *
- */
+ * This is the copy assignment operator for this class.
+ *
+ * @since 2.0
+ *
+ * @remarks
+ * -The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
+ *
+ */
Camera& operator =(const Camera& rhs);
friend class _CameraImpl;