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);

-- 


Reply via email to