1 /**************************************************************************
5 Copyright 2015 Samsung Electronics co., Ltd. All Rights Reserved.
7 Contact: Eunchul Kim <chulspro.kim@samsung.com>,
8 JinYoung Jeon <jy0.jeon@samsung.com>,
9 Taeheon Kim <th908.kim@samsung.com>,
10 YoungJun Cho <yj44.cho@samsung.com>,
11 SooChan Lim <sc1.lim@samsung.com>,
12 Boram Park <sc1.lim@samsung.com>
14 Permission is hereby granted, free of charge, to any person obtaining a
15 copy of this software and associated documentation files (the
16 "Software"), to deal in the Software without restriction, including
17 without limitation the rights to use, copy, modify, merge, publish,
18 distribute, sub license, and/or sell copies of the Software, and to
19 permit persons to whom the Software is furnished to do so, subject to
20 the following conditions:
22 The above copyright notice and this permission notice (including the
23 next paragraph) shall be included in all copies or substantial portions
26 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
27 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
28 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
29 IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
30 ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
31 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
32 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
34 **************************************************************************/
36 #ifndef _TDM_BACKEND_H_
37 #define _TDM_BACKEND_H_
39 #include <tbm_surface.h>
41 #include "tdm_types.h"
47 typedef void tdm_backend_data;
49 typedef struct _tdm_caps_display
55 typedef struct _tdm_caps_output
57 tdm_output_conn_status status;
61 unsigned int mode_count;
62 tdm_output_mode *modes;
64 unsigned int prop_count;
68 unsigned int mmHeight;
69 unsigned int subpixel;
79 typedef struct _tdm_caps_layer
81 tdm_layer_capability capabilities;
82 unsigned int zpos; /* if VIDEO layer, zpos is -1 */
84 unsigned int format_count;
87 unsigned int prop_count;
91 typedef struct _tdm_caps_pp
93 tdm_pp_capability capabilities;
95 unsigned int format_count;
106 typedef struct _tdm_caps_capture
108 tdm_capture_capability capabilities;
110 unsigned int format_count;
113 /* -1: not defined */
121 typedef struct _tdm_func_display
123 tdm_error (*display_get_capabilitiy)(tdm_backend_data *bdata, tdm_caps_display *caps); /* init */
124 tdm_error (*display_get_pp_capability)(tdm_backend_data *bdata, tdm_caps_pp *caps); /* init */
125 tdm_error (*display_get_capture_capability)(tdm_backend_data *bdata, tdm_caps_capture *caps); /* init */
126 tdm_output **(*display_get_outputs)(tdm_backend_data *bdata, int *count, tdm_error *error); /* init */
127 tdm_error (*display_get_fd)(tdm_backend_data *bdata, int *fd);
128 tdm_error (*display_handle_events)(tdm_backend_data *bdata);
129 tdm_pp* (*display_create_pp)(tdm_backend_data *bdata, tdm_error *error);
131 tdm_error (*output_get_capability)(tdm_output *output, tdm_caps_output *caps); /* init */
132 tdm_layer **(*output_get_layers)(tdm_output *output, int *count, tdm_error *error); /* init */
133 tdm_error (*output_set_property)(tdm_output *output, unsigned int id, tdm_value value);
134 tdm_error (*output_get_property)(tdm_output *output, unsigned int id, tdm_value *value);
135 tdm_error (*output_wait_vblank)(tdm_output *output, int interval, int sync, void *user_data);
136 tdm_error (*output_set_vblank_handler)(tdm_output *output, tdm_output_vblank_handler func);
137 tdm_error (*output_commit)(tdm_output *output, int sync, void *user_data);
138 tdm_error (*output_set_commit_handler)(tdm_output *output, tdm_output_commit_handler func);
139 tdm_error (*output_set_dpms)(tdm_output *output, tdm_output_dpms dpms_value);
140 tdm_error (*output_get_dpms)(tdm_output *output, tdm_output_dpms *dpms_value);
141 tdm_error (*output_set_mode)(tdm_output *output, tdm_output_mode *mode);
142 tdm_error (*output_get_mode)(tdm_output *output, const tdm_output_mode **mode);
143 tdm_capture *(*output_create_capture)(tdm_output *output, tdm_error *error);
145 tdm_error (*layer_get_capability)(tdm_layer *layer, tdm_caps_layer *caps); /* init */
146 tdm_error (*layer_set_property)(tdm_layer *layer, unsigned int id, tdm_value value);
147 tdm_error (*layer_get_property)(tdm_layer *layer, unsigned int id, tdm_value *value);
148 tdm_error (*layer_set_info)(tdm_layer *layer, tdm_info_layer *info);
149 tdm_error (*layer_get_info)(tdm_layer *layer, tdm_info_layer *info);
150 tdm_error (*layer_set_buffer)(tdm_layer *layer, tbm_surface_h buffer);
151 tdm_error (*layer_unset_buffer)(tdm_layer *layer);
152 tdm_capture *(*layer_create_capture)(tdm_layer *layer, tdm_error *error);
155 typedef void (*tdm_pp_done_handler)(tdm_pp *pp, tbm_surface_h src, tbm_surface_h dst, void *user_data);
157 typedef struct _tdm_func_pp
159 void (*pp_destroy)(tdm_pp *pp); /* init */
160 tdm_error (*pp_set_info)(tdm_pp *pp, tdm_info_pp *info);
161 tdm_error (*pp_attach)(tdm_pp *pp, tbm_surface_h src, tbm_surface_h dst);
162 tdm_error (*pp_commit)(tdm_pp *pp); /* init */
163 tdm_error (*pp_set_done_handler)(tdm_pp *pp, tdm_pp_done_handler func, void *user_data);
166 typedef void (*tdm_capture_done_handler)(tdm_capture *capture, tbm_surface_h buffer, void *user_data);
168 typedef struct _tdm_func_capture
170 void (*capture_destroy)(tdm_capture *capture); /* init */
171 tdm_error (*capture_set_info)(tdm_capture *capture, tdm_info_capture *info);
172 tdm_error (*capture_attach)(tdm_capture *capture, tbm_surface_h buffer);
173 tdm_error (*capture_commit)(tdm_capture *capture); /* init */
174 tdm_error (*capture_set_done_handler)(tdm_capture *capture, tdm_capture_done_handler func, void *user_data);
177 #define TDM_BACKEND_MINOR_VERSION_MASK 0x0000FFFF
178 #define TDM_BACKEND_MAJOR_VERSION_MASK 0xFFFF0000
179 #define TDM_BACKEND_GET_ABI_MINOR(v) ((v) & TDM_BACKEND_MINOR_VERSION_MASK)
180 #define TDM_BACKEND_GET_ABI_MAJOR(v) (((v) & TDM_BACKEND_MAJOR_VERSION_MASK) >> 16)
182 #define SET_TDM_BACKEND_ABI_VERSION(major, minor) \
183 (((major) << 16) & TDM_BACKEND_MAJOR_VERSION_MASK) | \
184 ((major) & TDM_BACKEND_MINOR_VERSION_MASK)
185 #define TDM_BACKEND_ABI_VERSION SET_TDM_BACKEND_ABI_VERSION(1, 1)
187 typedef struct _tdm_backend_module
191 unsigned long abi_version;
193 tdm_backend_data* (*init)(tdm_display *dpy, tdm_error *error);
194 void (*deinit)(tdm_backend_data *bdata);
195 } tdm_backend_module;
197 tdm_error tdm_backend_register_func_display(tdm_display *dpy, tdm_func_display *func_display);
198 tdm_error tdm_backend_register_func_pp(tdm_display *dpy, tdm_func_pp *func_pp);
199 tdm_error tdm_backend_register_func_capture(tdm_display *dpy, tdm_func_capture *func_capture);
205 #endif /* _TDM_BACKEND_H_ */