* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @n
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, int& value) with CAMERA_COUNT key.
+ * @remarks Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, int& value)
+ * with ::CAMERA_COUNT key.
*/
result Construct(ICameraEventListener& listener, CameraSelection camSel = CAMERA_PRIMARY);
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_PREVIEW or CAMERA_SECONDARY_SUPPORT_PREVIEW keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_PREVIEW or ::CAMERA_SECONDARY_SUPPORT_PREVIEW keys.
* @see StopPreview()
* @see ICameraEventListener::OnCameraPreviewed()
*/
* state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_CAPTURE or CAMERA_SECONDARY_SUPPORT_CAPTURE keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_CAPTURE or ::CAMERA_SECONDARY_SUPPORT_CAPTURE keys.
* -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.
* 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>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_BRIGHTNESS or CAMERA_SECONDARY_SUPPORT_BRIGHTNESS keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_BRIGHTNESS or ::CAMERA_SECONDARY_SUPPORT_BRIGHTNESS keys.
* @see GetBrightness()
*/
result SetBrightness(int brightness);
* @since 2.0
*
* @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.
- * @see SetBrightness()
+ * 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.
+ * @see SetBrightness()
*/
int GetBrightness(void) const;
* 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>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_CONTRAST or CAMERA_SECONDARY_SUPPORT_CONTRAST keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_CONTRAST or ::CAMERA_SECONDARY_SUPPORT_CONTRAST keys.
* @see GetContrast()
*/
result SetContrast(int contrast);
* @remarks
* - This method returns @c E_UNSUPPORTED_OPERATION in the Emulator.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_ZOOM or CAMERA_SECONDARY_SUPPORT_ZOOM keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_ZOOM or ::CAMERA_SECONDARY_SUPPORT_ZOOM keys.
* - 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
* @remarks
* - This method returns @c E_UNSUPPORTED_OPERATION in the Emulator.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_ZOOM or CAMERA_SECONDARY_SUPPORT_ZOOM keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_ZOOM or ::CAMERA_SECONDARY_SUPPORT_ZOOM keys.
* - 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
* MediaCapability::GetValueN(CAMERA_PRIMARY_ZOOM_TYPE) method.
- * - 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>.
+ * - 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()
* @see GetMaxZoomLevel()
* @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
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* -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.
+ * ::CAMERA_PRIMARY_SUPPORT_ZERO_SHUTTER_LAG, ::CAMERA_SECONDARY_SUPPORT_ZERO_SHUTTER_LAG keys.
* @see GetCaptureResolution()
*/
result SetCaptureResolution(const Tizen::Graphics::Dimension& resolution);
* -This method returns @c 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
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm
">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_EFFECT or CAMERA_SECONDARY_EFFECT keys.
+ * with @c CAMERA_PRIMARY_EFFECT or @c CAMERA_SECONDARY_EFFECT keys.
* @see GetEffect()
*/
result SetEffect(CameraEffect effect);
* set to @c true, this method returns @c 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).
* - 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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_FLASH or CAMERA_SECONDARY_SUPPORT_FLASH keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_FLASH or ::CAMERA_SECONDARY_SUPPORT_FLASH keys.
* -In a zero-shutter-lag camera, only the default preview format applies this feature.
* @see IsFlashOn()
* @see SetFlashMode()
* @c CAMERA_FLASH_MODE_CONTINUOUS keeps the flash turned on after the method is called until @c CAMERA_FLASH_MODE_OFF is set.
* - This method returns @c E_UNSUPPORTED_OPERATION in the Emulator.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_FLASH_MODE or CAMERA_SECONDARY_FLASH_MODE keys.
+ * with @c CAMERA_PRIMARY_FLASH_MODE or @c CAMERA_SECONDARY_FLASH_MODE keys.
* - 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.
* - This method returns @c E_UNSUPPORTED_OPERATION in the Emulator.
* - This method works correctly when PowerOn() is executed. @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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_EXPOSURE or CAMERA_SECONDARY_SUPPORT_EXPOSURE keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_EXPOSURE or ::CAMERA_SECONDARY_SUPPORT_EXPOSURE keys.
* @see GetExposure()
*/
result SetExposure(int exposure);
* - This method returns @c E_UNSUPPORTED_OPERATION in the Emulator.
* - This method works correctly when PowerOn() is executed. @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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_WHITE_BALANCE or CAMERA_SECONDARY_WHITE_BALANCE keys.
+ * with @c CAMERA_PRIMARY_WHITE_BALANCE or @c CAMERA_SECONDARY_WHITE_BALANCE keys.
* @see GetWhiteBalance()
*/
result SetWhiteBalance(CameraWhiteBalance whiteBalance);
* - The default quality is @c CAMERA_QUALITY_NORMAL.
* - This method works correctly when PowerOn() is executed. @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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* @see GetQuality()
*/
result SetQuality(CameraQuality quality);
* @remarks
* - @c CAMERA_FOCUS_MODE_NONE always throws @c E_INVALID_ARG.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_FOCUS_MODE or CAMERA_SECONDARY_FOCUS_MODE keys.
-
+ * with @c CAMERA_PRIMARY_FOCUS_MODE or @c CAMERA_SECONDARY_FOCUS_MODE keys.
+ *
* @see GetFocusMode()
*/
result SetFocusMode(CameraFocusMode focusMode);
* @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.
- * - 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>.
+ * - 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>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValue(const Tizen::Base::String& key, bool& value)
- * with CAMERA_PRIMARY_SUPPORT_FOCUS or CAMERA_SECONDARY_SUPPORT_FOCUS keys.
+ * with ::CAMERA_PRIMARY_SUPPORT_FOCUS or ::CAMERA_SECONDARY_SUPPORT_FOCUS keys.
*/
result SetAutoFocus(bool callback);
* @remarks
* - This method works in ::CAMERA_STATE_INITIALIZED state.
* - 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>.
+ * 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()
*/
* - In some devices this method works in the ::CAMERA_STATE_PREVIEW state.
* - This method throws @c E_UNSUPPORTED_OPERATION in the Emulator.
* - 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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_ISO_LEVEL or CAMERA_SECONDARY_ISO_LEVEL keys.
+ * with @c CAMERA_PRIMARY_ISO_LEVEL or @c CAMERA_SECONDARY_ISO_LEVEL keys.
* @see GetIsoLevel()
*/
result SetIsoLevel(CameraIsoLevel isoLevel);
* @remarks
* - This method works in ::CAMERA_STATE_INITIALIZED state.
* - 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>.
+ * state transition caused by this method, see <a href="../org.tizen.native.appprogramming/html/guide/media/launching_camera.htm">here</a>.
* @see GetPreviewFrameRate()
*/
result SetPreviewFrameRate(int fps);
* -This method works in the ::CAMERA_STATE_INITIALIZED state.
* -Finally the last specified type is applied even with the several types applicable.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_FLIP or CAMERA_SECONDARY_FLIP keys.
+ * with @c CAMERA_PRIMARY_FLIP or @c CAMERA_SECONDARY_FLIP keys.
* -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.
* - 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.
+ * 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.
+ * 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.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_PREVIEW_ROTATION or CAMERA_SECONDARY_PREVIEW_ROTATION keys.
+ * with @c CAMERA_PRIMARY_PREVIEW_ROTATION or @c CAMERA_SECONDARY_PREVIEW_ROTATION keys.
* - 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.
* @remarks
* - @c CAMERA_METERING_MODE_NONE always throws @c E_INVALID_ARG.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_METERING_MODE or CAMERA_SECONDARY_METERING_MODE keys.
+ * with @c CAMERA_PRIMARY_METERING_MODE or @c CAMERA_SECONDARY_METERING_MODE keys.
* @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 @c CAMERA_METERING_MODE_NONE.
+ * @remarks If the %Camera does not support the metering mode, this method always returns @c CAMERA_METERING_MODE_NONE.
* @see SetMeteringMode()
*/
CameraMeteringMode GetMeteringMode(void) const;
* @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.
- * - In a specific scene mode, if an application sets any attribute that is related to the scene, the mode can be changed to @c 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 @c CAMERA_SCENE_OFF, all the attributes set by the application are reloaded.
+ * - 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.
+ * - In a specific scene mode, if an application sets any attribute that is related to the scene, the mode can be changed to @c 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 @c CAMERA_SCENE_OFF, all the attributes set by the application are reloaded.
* - Before calling this method, check whether the feature is supported by MediaCapability::GetValueN(const Tizen::Base::String& key)
- * with CAMERA_PRIMARY_SCENE_MODE or CAMERA_SECONDARY_SCENE_MODE keys.
+ * with @c CAMERA_PRIMARY_SCENE_MODE or @c CAMERA_SECONDARY_SCENE_MODE keys.
*/
result SetSceneMode(CameraSceneMode sceneMode);