fix doxygen document 14/62614/1 accepted/tizen/common/20160321.150033 accepted/tizen/ivi/20160321.005555 accepted/tizen/mobile/20160321.005509 accepted/tizen/tv/20160321.005523 accepted/tizen/wearable/20160321.005543 submit/tizen/20160320.224501
authorBoram Park <boram1288.park@samsung.com>
Thu, 17 Mar 2016 04:58:22 +0000 (13:58 +0900)
committerBoram Park <boram1288.park@samsung.com>
Thu, 17 Mar 2016 05:11:37 +0000 (14:11 +0900)
Change-Id: I588b867d55069ed8199bd24894d85fd51e850e7c

doc/tdm_doc.h
include/tdm_backend.h

index 9652b58..7d4c856 100644 (file)
@@ -39,8 +39,8 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 /**
  * @mainpage TDM
  * @author     Boram Park, boram1288.park@samsung.com
- * @date       Dec 30, 2015
- * @version    1.0.0
+ * @date       Mar 17, 2016
+ * @version    1.1.0
  * @par Introduction
  * TDM stands for Tizen Display Manager. It's the display HAL layer for tizen
  * display server. It offers the frontend APIs(@ref tdm.h) for a frontend user
@@ -69,20 +69,24 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  * A backend module @b SHOULD define the global data symbol of which name is
  * @b "tdm_backend_module_data". TDM will read this symbol, @b "tdm_backend_module_data",
  * at the initial time and call init() function of #tdm_backend_module.
- * A backend module at least @b SHOULD register the #tdm_func_display functions
- * to a display object with #tdm_backend_register_func_display() function in initial time.\n
+ * A backend module at least @b SHOULD register the #tdm_func_display,
+ * #tdm_func_output, #tdm_func_layer functions to a display object via
+ * #tdm_backend_register_func_display(), #tdm_backend_register_func_output(),
+ * #tdm_backend_register_func_layer() functions in initial time.\n
  * @code
     #include <tdm_backend.h>
 
-    static tdm_func_display drm_func_display =
-    {
+    static tdm_func_display drm_func_display = {
         drm_display_get_capabilitiy,
         ...
-        drm_display_get_outputs,
-        ...
+    };
+
+    static tdm_func_output drm_func_output = {
         drm_output_get_capability,
-        drm_output_get_layers,
         ...
+    };
+
+    static tdm_func_layer drm_func_layer = {
         drm_layer_get_capability,
         ...
     };
@@ -98,6 +102,12 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
         ret = tdm_backend_register_func_display(dpy, &drm_func_display);
         if (ret != TDM_ERROR_NONE)
             goto failed;
+        ret = tdm_backend_register_func_output(dpy, &drm_func_output);
+        if (ret != TDM_ERROR_NONE)
+            goto failed;
+        ret = tdm_backend_register_func_layer(dpy, &drm_func_layer);
+        if (ret != TDM_ERROR_NONE)
+            goto failed;
         ...
         return (tdm_backend_data*)drm_data;
     }
index 775efcc..bc9d195 100644 (file)
@@ -72,7 +72,7 @@ typedef struct _tdm_caps_display {
 
 /**
  * @brief The capabilities structure of a output object
- * @see The output_get_capability() function of #tdm_func_display
+ * @see The output_get_capability() function of #tdm_func_output
  */
 typedef struct _tdm_caps_output {
        char maker[TDM_NAME_LEN];       /**< The output maker */
@@ -103,7 +103,7 @@ typedef struct _tdm_caps_output {
 
 /**
  * @brief The capabilities structure of a layer object
- * @see The layer_get_capability() function of #tdm_func_display
+ * @see The layer_get_capability() function of #tdm_func_layer
  */
 typedef struct _tdm_caps_layer {
        tdm_layer_capability capabilities;  /**< The capabilities of layer */
@@ -113,7 +113,7 @@ typedef struct _tdm_caps_layer {
         * GRAPHIC layers are non-changeable. The zpos of GRAPHIC layers starts
         * from 0. If there are 4 GRAPHIC layers, The zpos SHOULD be 0, 1, 2, 3.\n
         * But the zpos of VIDEO layer is changeable by layer_set_video_pos() function
-        * of #tdm_func_display. And The zpos of VIDEO layers is less than GRAPHIC
+        * of #tdm_func_layer. And The zpos of VIDEO layers is less than GRAPHIC
         * layers or more than GRAPHIC layers.
         * ie, ..., -2, -1, 4, 5, ... (if 0 <= GRAPHIC layer's zpos < 4).
         * The zpos of VIDEO layers is @b relative. It doesn't need to start
@@ -521,7 +521,7 @@ typedef struct _tdm_func_layer {
         * @param[in] layer A layer object
         * @param[in] info The geometry information
         * @return #TDM_ERROR_NONE if success. Otherwise, error value.
-        * @see output_commit() function of #tdm_func_display
+        * @see output_commit() function of #tdm_func_output
         * @remark
         * A backend module would apply the geometry information when the output object
         * of a layer object is committed.
@@ -541,7 +541,7 @@ typedef struct _tdm_func_layer {
         * @param[in] layer A layer object
         * @param[in] buffer A TDM buffer
         * @return #TDM_ERROR_NONE if success. Otherwise, error value.
-        * @see output_commit() function of #tdm_func_display
+        * @see output_commit() function of #tdm_func_output
         * @remark
         * A backend module would apply a TDM buffer when the output object
         * of a layer object is committed.
@@ -689,8 +689,8 @@ typedef struct _tdm_func_capture {
        /**
         * @brief Destroy a capture object
         * @param[in] capture A capture object
-        * @see output_create_capture() function of #tdm_func_display
-        * @see layer_create_capture() function of #tdm_func_display
+        * @see output_create_capture() function of #tdm_func_output
+        * @see layer_create_capture() function of #tdm_func_layer
         */
        void         (*capture_destroy)(tdm_capture *capture);