cedric pushed a commit to branch master. http://git.enlightenment.org/core/efl.git/commit/?id=acfd5a82567c39baf1ad5afb4add97653c05cb0c
commit acfd5a82567c39baf1ad5afb4add97653c05cb0c Author: Philippe Caseiro <pcase...@cadoles.com> Date: Mon Oct 20 15:27:06 2014 +0200 emotion: updating API documentation. --- src/lib/emotion/Emotion.h | 51 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/src/lib/emotion/Emotion.h b/src/lib/emotion/Emotion.h index bb41cbe..a776084 100644 --- a/src/lib/emotion/Emotion.h +++ b/src/lib/emotion/Emotion.h @@ -367,7 +367,19 @@ extern "C" { * @defgroup Emotion_Ressource Video ressource management */ +/** + * @brief Initialise Emotion library + * + * Initialise needed libraries like eina ecore eet + * Initialise needed modules like webcam + */ EAPI Eina_Bool emotion_init(void); + +/** + * @brief Shutdown Emotion library + * + * Proper shutdown of all loaded modules and initialised libraries. + */ EAPI Eina_Bool emotion_shutdown(void); /** @@ -854,6 +866,15 @@ EAPI void emotion_object_smooth_scale_set (Evas_Object *obj, Eina_B * @ingroup Emotion_Video */ EAPI Eina_Bool emotion_object_smooth_scale_get (const Evas_Object *obj); + +/** + * @brief Send an Emotion Event to an Evas object + * + * @param obj The object target of the event. + * @param ev The emotion event. + * + * @see Emotion_Event + */ EAPI void emotion_object_event_simple_send (Evas_Object *obj, Emotion_Event ev); /** @@ -1004,8 +1025,38 @@ EAPI const char *emotion_object_video_subtitle_file_get (const Evas_Object *ob * @ingroup Emotion_Video */ EAPI int emotion_object_video_channel_count (const Evas_Object *obj); + +/** + * @brief Get the name of a given video channel + * + * @param obj The object which we are retrieving the channel name from + * @param channel the channel number + * @return the channel name. + * + * @see emotion_object_video_channel_count() + * + * @ingroup Emotion_Video + */ EAPI const char *emotion_object_video_channel_name_get(const Evas_Object *obj, int channel); + +/** + * @brief Set the channel for a given video object + * + * @param obj The target object which we are setting the channel + * @param channel the channel number to be setted. + * + * @ingroup Emotion_Video + */ EAPI void emotion_object_video_channel_set (Evas_Object *obj, int channel); + +/** + * @brief Get the channel for a given video object + * + * @param obj The target object which we are getting the channel + * @return The current channel number. + * + * @ingroup Emotion_Video + */ EAPI int emotion_object_video_channel_get (const Evas_Object *obj); EAPI void emotion_object_spu_mute_set (Evas_Object *obj, Eina_Bool mute); EAPI Eina_Bool emotion_object_spu_mute_get (const Evas_Object *obj); --