/**************************************************************************
-
-libtdm
-
-Copyright 2015 Samsung Electronics co., Ltd. All Rights Reserved.
-
-Contact: Eunchul Kim <chulspro.kim@samsung.com>,
- JinYoung Jeon <jy0.jeon@samsung.com>,
- Taeheon Kim <th908.kim@samsung.com>,
- YoungJun Cho <yj44.cho@samsung.com>,
- SooChan Lim <sc1.lim@samsung.com>,
- Boram Park <sc1.lim@samsung.com>
-
-Permission is hereby granted, free of charge, to any person obtaining a
-copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sub license, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice (including the
-next paragraph) shall be included in all copies or substantial portions
-of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
-IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
-ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
+ *
+ * libtdm
+ *
+ * Copyright 2015 Samsung Electronics co., Ltd. All Rights Reserved.
+ *
+ * Contact: Eunchul Kim <chulspro.kim@samsung.com>,
+ * JinYoung Jeon <jy0.jeon@samsung.com>,
+ * Taeheon Kim <th908.kim@samsung.com>,
+ * YoungJun Cho <yj44.cho@samsung.com>,
+ * SooChan Lim <sc1.lim@samsung.com>,
+ * Boram Park <sc1.lim@samsung.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sub license, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the
+ * next paragraph) shall be included in all copies or substantial portions
+ * of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
+ * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ *
**************************************************************************/
#ifndef _TDM_H_
* @brief The header file for a frontend user.
* @par Example
* @code
- #include <tdm.h> //for a frontend user
+ * #include <tdm.h> //for a frontend user
* @endcode
*/
/**
* @brief The display capability enumeration
*/
-typedef enum
-{
- TDM_DISPLAY_CAPABILITY_PP = (1<<0), /**< if hardware supports pp operation */
- TDM_DISPLAY_CAPABILITY_CAPTURE = (1<<1), /**< if hardware supports capture operation */
+typedef enum {
+ TDM_DISPLAY_CAPABILITY_PP = (1 << 0), /**< if hardware supports pp operation */
+ TDM_DISPLAY_CAPABILITY_CAPTURE = (1 << 1), /**< if hardware supports capture operation */
} tdm_display_capability;
/**
+ * @brief The output change handler
+ * @details This handler will be called when the status of a output object is
+ * changed in runtime.
+ */
+typedef void (*tdm_output_change_handler)(tdm_output *output,
+ tdm_output_change_type type,
+ tdm_value value,
+ void *user_data);
+
+/**
* @brief Initialize a display object
* @param[out] error #TDM_ERROR_NONE if success. Otherwise, error value.
* @return A display object
*/
tdm_error
tdm_display_get_capabilities(tdm_display *dpy,
- tdm_display_capability *capabilities);
+ tdm_display_capability *capabilities);
/**
* @brief Get the pp capabilities of a display object.
*/
tdm_error
tdm_display_get_pp_capabilities(tdm_display *dpy,
- tdm_pp_capability *capabilities);
+ tdm_pp_capability *capabilities);
/**
* @brief Get the pp available format array of a display object.
*/
tdm_error
tdm_display_get_pp_available_formats(tdm_display *dpy,
- const tbm_format **formats, int *count);
+ const tbm_format **formats, int *count);
/**
* @brief Get the pp available size of a display object.
*/
tdm_error
tdm_display_get_pp_available_size(tdm_display *dpy, int *min_w, int *min_h,
- int *max_w, int *max_h, int *preferred_align);
+ int *max_w, int *max_h, int *preferred_align);
/**
* @brief Get the capture capabilities of a display object.
*/
tdm_error
tdm_display_get_capture_capabilities(tdm_display *dpy,
- tdm_capture_capability *capabilities);
+ tdm_capture_capability *capabilities);
/**
* @brief Get the capture available format array of a display object.
*/
tdm_error
tdm_display_get_catpure_available_formats(tdm_display *dpy,
- const tbm_format **formats, int *count);
+ const tbm_format **formats, int *count);
/**
* @brief Get the output counts which a display object has.
*/
tdm_error
tdm_output_get_model_info(tdm_output *output, const char **maker,
- const char **model, const char **name);
+ const char **model, const char **name);
/**
* @brief Get the connection status of a output object.
tdm_output_get_conn_status(tdm_output *output, tdm_output_conn_status *status);
/**
+ * @brief Add a output change handler
+ * @details The handler will be called when the status of a
+ * output object is changed. connection, DPMS, etc.
+ * @param[in] output A output object
+ * @param[in] func A output change handler
+ * @param[in] user_data The user data
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+tdm_error
+tdm_output_add_change_handler(tdm_output *output,
+ tdm_output_change_handler func,
+ void *user_data);
+
+/**
+ * @brief Remove a output change handler
+ * @param[in] output A output object
+ * @param[in] func A output change handler
+ * @param[in] user_data The user data
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+void
+tdm_output_remove_change_handler(tdm_output *output,
+ tdm_output_change_handler func,
+ void *user_data);
+
+/**
* @brief Get the connection type of a output object.
* @param[in] output A output object
* @param[out] type The connection type.
*/
tdm_error
tdm_output_get_available_properties(tdm_output *output, const tdm_prop **props,
- int *count);
+ int *count);
/**
* @brief Get the available mode array of a output object.
*/
tdm_error
tdm_output_get_available_modes(tdm_output *output,
- const tdm_output_mode **modes, int *count);
+ const tdm_output_mode **modes, int *count);
/**
* @brief Get the available size of a output object.
*/
tdm_error
tdm_output_get_available_size(tdm_output *output, int *min_w, int *min_h,
- int *max_w, int *max_h, int *preferred_align);
+ int *max_w, int *max_h, int *preferred_align);
/**
* @brief Get the physical size of a output object.
*/
tdm_error
tdm_output_get_physical_size(tdm_output *output, unsigned int *mmWidth,
- unsigned int *mmHeight);
+ unsigned int *mmHeight);
/**
* @brief Get the subpixel of a output object.
*/
tdm_error
tdm_output_wait_vblank(tdm_output *output, int interval, int sync,
- tdm_output_vblank_handler func, void *user_data);
+ tdm_output_vblank_handler func, void *user_data);
/**
* @brief Commit changes for a output object
*/
tdm_error
tdm_output_commit(tdm_output *output, int sync, tdm_output_commit_handler func,
- void *user_data);
+ void *user_data);
/**
* @brief Set one of available modes of a output object
*/
tdm_error
tdm_layer_get_capabilities(tdm_layer *layer,
- tdm_layer_capability *capabilities);
+ tdm_layer_capability *capabilities);
/**
* @brief Get the available format array of a layer object.
*/
tdm_error
tdm_layer_get_available_formats(tdm_layer *layer, const tbm_format **formats,
- int *count);
+ int *count);
/**
* @brief Get the available property array of a layer object.
*/
tdm_error
tdm_layer_get_available_properties(tdm_layer *layer, const tdm_prop **props,
- int *count);
+ int *count);
/**
* @brief Get the zpos of a layer object.
* - A frontend user only can set the relative zpos to VIDEO layers via #tdm_layer_set_video_pos
* - 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).
+ * -------------------------------- graphic layer 3 <-- top most layer
+ * -------------------------------- graphic layer 2
+ * -------------------------------- graphic layer 1
+ * -------------------------------- graphic layer 0
+ * -------------------------------- video layer -1
+ * -------------------------------- video layer -2 <-- lowest layer
* @param[in] layer A layer object
* @param[out] zpos The zpos
* @return #TDM_ERROR_NONE if success. Otherwise, error value.
* @see tdm_layer_set_video_pos, tdm_layer_capability
*/
tdm_error
-tdm_layer_get_zpos(tdm_layer *layer, unsigned int *zpos);
+tdm_layer_get_zpos(tdm_layer *layer, int *zpos);
/**
* @brief Set the property which has a given id.
/**
* @brief Set the geometry information to a layer object
* @details The geometry information will be applied when the output object
- * of a layer object is committed.
+ * of a layer object is committed. If a layer has TDM_LAYER_CAPABILITY_NO_CROP
+ * capability, a layer will ignore the pos(crop) information of #tdm_info_layer's
+ * src_config.
* @param[in] layer A layer object
* @param[in] info The geometry information
* @return #TDM_ERROR_NONE if success. Otherwise, error value.
tdm_layer_unset_buffer(tdm_layer *layer);
/**
+ * @brief Get a displaying TDM buffer from a layer object
+ * @details A displaying TDM buffer is a current showing buffer on screen
+ * that is set to layer object and applied output object of a layer object.
+ * @param[in] layer A layer object
+ * @return A TDM buffer if success. Otherwise, NULL.
+ */
+tbm_surface_h
+tdm_layer_get_displaying_buffer(tdm_layer *layer, tdm_error *error);
+
+/**
* @brief Set a TBM surface_queue to a layer object
* @details A TBM surface_queue will be applied when the output object
* of a layer object is committed. and TDM layer will be automatically updated
tdm_layer_create_capture(tdm_layer *layer, tdm_error *error);
/**
+ * @brief Get buffer flags from a layer object
+ * @param[in] layer A layer object
+ * @param[out] flags a buffer flags value
+ * @return #TDM_ERROR_NONE if success. Otherwise, error value.
+ */
+tdm_error
+tdm_layer_get_buffer_flags(tdm_layer *layer, unsigned int *flags);
+
+/**
* @brief Destroy a pp object
* @param[in] pp A pp object
* @see tdm_display_create_pp
* @see tdm_buffer_add_release_handler, tdm_buffer_remove_release_handler
*/
typedef void (*tdm_buffer_release_handler)(tbm_surface_h buffer,
- void *user_data);
+ void *user_data);
/**
* @brief Add a release handler to a TDM buffer
*/
tdm_error
tdm_buffer_add_release_handler(tbm_surface_h buffer,
- tdm_buffer_release_handler func, void *user_data);
+ tdm_buffer_release_handler func, void *user_data);
/**
* @brief Remove a release handler from a TDM buffer
*/
void
tdm_buffer_remove_release_handler(tbm_surface_h buffer,
- tdm_buffer_release_handler func, void *user_data);
+ tdm_buffer_release_handler func, void *user_data);
#ifdef __cplusplus
}