not create the reduntant directory when done
[platform/core/uifw/libtdm.git] / client / tdm_client.h
index c64391e..e7df780 100644 (file)
@@ -296,7 +296,9 @@ tdm_client_vblank_set_enable_fake(tdm_client_vblank *vblank, unsigned int enable
  * #tdm_client_vblank_wait will return TDM_ERROR_NONE as success if
  * #tdm_client_vblank_set_enable_fake sets true. Once #tdm_client_vblank_wait
  * returns TDM_ERROR_NONE, the user client vblank handler(#tdm_client_vblank_handler)
- * SHOULD be called after the given interval.
+ * SHOULD be called after the given interval. \n
+ * The sequence value of tdm_client_vblank_handler is the relative value of fps.
+ * If fps = 10, this sequence value should be increased by 10 during 1 second.
  * @param[in] vblank The client vblank object
  * @param[in] interval The vblank interval
  * @param[in] func The user client vblank handler
@@ -375,6 +377,22 @@ tdm_client_vblank_set_enable_fake(tdm_client_vblank *vblank, unsigned int enable
 tdm_error
 tdm_client_vblank_wait(tdm_client_vblank *vblank, unsigned int interval, tdm_client_vblank_handler func, void *user_data);
 
+/**
+ * @brief Wait for a vblank with the target sequence number
+ * @details
+ * This function will return TDM_ERROR_DPMS_OFF when DPMS off. However,
+ * #tdm_client_vblank_wait will return TDM_ERROR_NONE as success if
+ * #tdm_client_vblank_set_enable_fake sets true. Once #tdm_client_vblank_wait_seq
+ * returns TDM_ERROR_NONE, the user client vblank handler(#tdm_client_vblank_handler)
+ * SHOULD be called on reaching the target sequence.
+ * @param[in] vblank The client vblank object
+ * @param[in] sequence The target sequence number
+ * @param[in] func The user client vblank handler
+ * @param[in] user_data The user data
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+tdm_error
+tdm_client_vblank_wait_seq(tdm_client_vblank *vblank, unsigned int sequence, tdm_client_vblank_handler func, void *user_data);
 
 #ifdef __cplusplus
 }