diff options
| author | Doyoun Kang <doyoun.kang@samsung.com> | 2016-04-08 11:08:32 +0900 |
|---|---|---|
| committer | Doyoun Kang <doyoun.kang@samsung.com> | 2016-04-12 16:26:10 +0900 |
| commit | 141da17ec9ba983f7cb8da108651ffa621091dc9 (patch) | |
| tree | 9c95efeaa8ca7e8b267d55abbbef382de33e36d0 /include | |
| parent | ffec519b6c0f2adfebcee017d4777af9ec61e719 (diff) | |
| download | efl-util-141da17ec9ba983f7cb8da108651ffa621091dc9.tar.gz efl-util-141da17ec9ba983f7cb8da108651ffa621091dc9.tar.bz2 efl-util-141da17ec9ba983f7cb8da108651ffa621091dc9.zip | |
Added new APIs for setting/getting brightness of screen
Change-Id: I65a97922484db61058822c4a688b2e2c79d115f4
Diffstat (limited to 'include')
| -rw-r--r-- | include/efl_util.h | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/include/efl_util.h b/include/efl_util.h index 7ee6fca..4fb2363 100644 --- a/include/efl_util.h +++ b/include/efl_util.h @@ -257,6 +257,42 @@ API int efl_util_set_window_screen_mode_error_cb(Evas_Object *window, efl_util_w API int efl_util_unset_window_screen_mode_error_cb(Evas_Object *window); /** + * @brief Sets the user's preferred brightness of the specified window. + * @details This API is useful when the application need to change the brightness of the screen when it is appeared on the screen. + * If the application sets the brightness 0 to 100 to its window and the application window is shown wholly or partially, + * the window manager requests the display system to change the brightness of the screen using user's preferred brightness. + * If the window is no longer shown, then the window manger request the display system to go back to default brightness. + * If the brightness is less than 0, this means to use the default screen brightness. + * @since_tizen 3.0 + * @privlevel public + * @privilege %http://tizen.org/privilege/display + * @remarks This API needs the privilege. + * If the application which is not get the privilege use this API, the window manager generates the permission deny error. + * @param[in] window The EFL window + * @param[in] brightness The preferred brightness + * @return @c 0 on success, otherwise a negative error value + * @retval #EFL_UTIL_ERROR_NONE Successful + * @retval #EFL_UTIL_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #EFL_UTIL_ERROR_PERMISSION_DENIED Permission denied + * @retval #EFL_UTIL_ERROR_OUT_OF_MEMORY Out of memory + * @see efl_util_get_window_brightness() + */ +API int efl_util_set_window_brightness(Evas_Object *window, int brightness); + +/** + * @brief Gets the user's preferred brightness of the specified window. + * @since_tizen 3.0 + * @param[in] window The EFL window + * @param[out] brightness The preferred brightness + * @return @c 0 on success, otherwise a negative error value + * @retval #EFL_UTIL_ERROR_NONE Successful + * @retval #EFL_UTIL_ERROR_INVALID_PARAMETER Invalid parameter + * @see efl_util_set_window_brightness() + */ +API int efl_util_get_window_brightness(Evas_Object *window, int *brightness); + + +/** * @} */ |