tbm_bufmgr_debug: change signature of tbm_bufmgr_debug_tbm_info_get

[platform/core/uifw/libtbm.git] / src / tbm_bufmgr.h

diff --git a/src/tbm_bufmgr.h b/src/tbm_bufmgr.h
index 6ba3edb..e386bea 100644 (file)
--- a/src/tbm_bufmgr.h
+++ b/src/tbm_bufmgr.h
@@ -1029,13 +1029,12 @@ int tbm_bo_get_flags(tbm_bo bo);
 void tbm_bufmgr_debug_show(tbm_bufmgr bufmgr);
 
 /**
- * @brief Print out to str the information of tbm_bos.
+ * @brief Get string with the information of tbm_bos.
  * @since_tizen 3.0
  * @param[in] bufmgr : the buffer manager
- * @param[out] str :
- * @param[out] len :
+ * @return sting with info if this function succeeds, otherwise NULL. It has to be free by user.
  */
-void tbm_bufmgr_debug_tbm_info_get(tbm_bufmgr bufmgr, char * str, int * len);
+char * tbm_bufmgr_debug_tbm_info_get(tbm_bufmgr bufmgr);
 
 /**
  * @brief Print out the trace of tbm_bos.
@@ -1062,6 +1061,26 @@ int tbm_bufmgr_debug_dump_all(char *path);
  */
 int tbm_bufmgr_debug_queue_dump(char *path, int count, int onoff);
 
+/**
+ * @brief Set scale factor for the nearest calling tbm_bufmgr_debug_dump_all() or tbm_bufmgr_debug_queue_dump()
+ * @since_tizen 3.0
+ * @param[in] scale : the scale factor, 0 - disable scaling
+ * @par Example
+   @code
+   #include <tbm_bufmgr.h>
+
+   // Dump all surface with scale factor 0.5
+   tbm_bufmgr_debug_dump_set_scale(0.5);
+   tbm_bufmgr_debug_dump_all("/tmp/");
+
+   // Start the dump debugging for queue with scale factor 0.5
+   tbm_bufmgr_debug_dump_set_scale(0.2);
+   tbm_bufmgr_debug_queue_dump("/tmp/", 10, 1);
+
+   @endcode
+ */
+void tbm_bufmgr_debug_dump_set_scale(double scale);
+
 int tbm_bufmgr_bind_native_display(tbm_bufmgr bufmgr, void *NativeDisplay);
 
 #ifdef __cplusplus