1 /**************************************************************************
5 Copyright 2012-2018 Samsung Electronics co., Ltd. All Rights Reserved.
7 Contact: SooChan Lim <sc1.lim@samsung.com>, Sangjin Lee <lsj119@samsung.com>
8 Inpyo Kang <mantiger@samsung.com>, Dongyeon Kim <dy5.kim@samsung.com>
9 Boram Park <boram1288.park@samsung.com>, Changyeon Lee <cyeon.lee@samsung.com>
11 Permission is hereby granted, free of charge, to any person obtaining a
12 copy of this software and associated documentation files (the
13 "Software"), to deal in the Software without restriction, including
14 without limitation the rights to use, copy, modify, merge, publish,
15 distribute, sub license, and/or sell copies of the Software, and to
16 permit persons to whom the Software is furnished to do so, subject to
17 the following conditions:
19 The above copyright notice and this permission notice (including the
20 next paragraph) shall be included in all copies or substantial portions
23 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
25 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
26 IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
27 ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
28 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
29 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
31 **************************************************************************/
33 #ifndef _TBM_TYPE_COMMON_H_
34 #define _TBM_TYPE_COMMON_H_
39 * \file tbm_type_common.h
40 * \brief Type definition used internally
43 /* tbm error base : this error base is same as TIZEN_ERROR_TBM in tizen_error.h */
44 #ifndef TBM_ERROR_BASE
45 #define TBM_ERROR_BASE -0x02830000
49 * @brief Definition for the tizen buffer manager
50 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
52 typedef struct _tbm_bufmgr *tbm_bufmgr;
55 * @brief Definition for the tizen buffer object
56 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
58 typedef struct _tbm_bo *tbm_bo;
61 * @brief Definition for the key associated with the buffer object
62 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
65 typedef uint32_t tbm_key;
67 * @brief Definition for the file descripter of the system buffer manager
68 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
70 typedef int32_t tbm_fd;
73 * @brief Definition for native display (wl_display in tizen)
76 typedef void tbm_native_display;
82 * @brief Enumeration for tbm error type.
86 TBM_ERROR_NONE = 0, /**< Successful */
87 TBM_ERROR_OUT_OF_MEMORY = TBM_ERROR_BASE | 0x0001, /**< failed to allocate the memory */
88 TBM_ERROR_INVALID_PARAMETER = TBM_ERROR_BASE | 0x0002, /**< failed to get the valid parameter */
89 TBM_ERROR_OPERATION_FAILED = TBM_ERROR_BASE | 0x0003, /**< failed to operation */
90 TBM_BO_ERROR_GET_FD_FAILED = TBM_ERROR_BASE | 0x0101, /**< failed to get fd in bo */
91 TBM_BO_ERROR_HEAP_ALLOC_FAILED = TBM_ERROR_BASE | 0x0102, /**< failed to allocate the heap memory in bo */
92 TBM_BO_ERROR_LOAD_MODULE_FAILED = TBM_ERROR_BASE | 0x0103,/**< failed to load module*/
93 TBM_BO_ERROR_THREAD_INIT_FAILED = TBM_ERROR_BASE | 0x0104,/**< failed to initialize the pthread */
94 TBM_BO_ERROR_BO_ALLOC_FAILED = TBM_ERROR_BASE | 0x0105, /**< failed to allocate tbm_bo */
95 TBM_BO_ERROR_INIT_STATE_FAILED = TBM_ERROR_BASE | 0x0106, /**< failed to initialize the state of tbm_bo */
96 TBM_BO_ERROR_IMPORT_FAILED = TBM_ERROR_BASE | 0x0107, /**< failed to import the handle of tbm_bo */
97 TBM_BO_ERROR_IMPORT_FD_FAILED = TBM_ERROR_BASE | 0x0108, /**< failed to import fd of tbm_bo */
98 TBM_BO_ERROR_EXPORT_FAILED = TBM_ERROR_BASE | 0x0109, /**< failed to export the handle of the tbm_bo */
99 TBM_BO_ERROR_EXPORT_FD_FAILED = TBM_ERROR_BASE | 0x01010, /**< failed to export fd of tbm_bo */
100 TBM_BO_ERROR_GET_HANDLE_FAILED = TBM_ERROR_BASE | 0x0111, /**< failed to get the tbm_bo_handle */
101 TBM_BO_ERROR_LOCK_FAILED = TBM_ERROR_BASE | 0x0112, /**< failed to lock the tbm_bo */
102 TBM_BO_ERROR_MAP_FAILED = TBM_ERROR_BASE | 0x0113, /**< failed to map the tbm_bo to get the tbm_bo_handle */
103 TBM_BO_ERROR_UNMAP_FAILED = TBM_ERROR_BASE | 0x0114, /**< failed to unmap the tbm_bo */
104 TBM_BO_ERROR_SWAP_FAILED = TBM_ERROR_BASE | 0x0115, /**< failed to swap the tbm_bos */
105 TBM_BO_ERROR_DUP_FD_FAILED = TBM_ERROR_BASE | 0x0116, /**< failed to duplicate fd */
109 * @brief Enumeration of tbm buffer manager capability.
112 enum TBM_BUFMGR_CAPABILITY {
113 TBM_BUFMGR_CAPABILITY_NONE = 0, /**< Not Support capability*/
114 TBM_BUFMGR_CAPABILITY_SHARE_KEY = (1 << 0), /**< Support sharing buffer by tbm key */
115 TBM_BUFMGR_CAPABILITY_SHARE_FD = (1 << 1), /**< Support sharing buffer by tbm fd */
116 TBM_BUFMGR_CAPABILITY_TBM_SYNC = (1 << 2), /**< Support tbm sync */
120 * @brief Definition for the device type to access tbm_bo
121 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
124 TBM_DEVICE_DEFAULT = 0, /**< the device type to get the default handle */
125 TBM_DEVICE_CPU, /**< the device type to get the virtual memory */
126 TBM_DEVICE_2D, /**< the device type to get the 2D memory handle */
127 TBM_DEVICE_3D, /**< the device type to get the 3D memory handle */
128 TBM_DEVICE_MM, /**< the device type to get the the multimedia handle */
130 } tbm_bo_device_type;
133 * @brief Definition for the optoin to access tbm_bo
134 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
137 TBM_OPTION_NONE = (1 << 0), /**< the option is none */
138 TBM_OPTION_READ = (1 << 0), /**< the option to access to read the bo */
139 TBM_OPTION_WRITE = (1 << 1), /**< the option to access to write the bo */
140 TBM_OPTION_VENDOR = (0xffff0000), /**< the the vendor specific option that depends on the backend */
141 } tbm_bo_access_option;
144 * @brief tbm_bo_handle abstraction of the memory handle by TBM_DEVICE_TYPE
145 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
147 typedef union _tbm_bo_handle {
156 * @brief Enumeration of bo memory type
157 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
160 TBM_BO_DEFAULT = 0, /**< default memory: it depends on the backend */
161 TBM_BO_SCANOUT = (1 << 0), /**< scanout memory */
162 TBM_BO_NONCACHABLE = (1 << 1), /**< non-cachable memory */
163 TBM_BO_WC = (1 << 2), /**< write-combine memory */
164 TBM_BO_VENDOR = (0xffff0000), /**< vendor specific memory: it depends on the backend */
168 * @brief Called when the user data is deleted in buffer object.
169 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
170 * @param[in] user_data User_data to be passed to callback function
171 * @pre The callback must be registered using tbm_bo_add_user_data().\n
172 * tbm_bo_delete_user_data() must be called to invoke this callback.
173 * @see tbm_bo_add_user_data()
174 * @see tbm_bo_delete_user_data()
176 typedef void (*tbm_data_free) (void *user_data);
179 * @brief Enumeration of tbm buffer manager capability.
182 typedef enum TBM_BUFMGR_CAPABILITY tbm_bufmgr_capability;
185 * @brief Enumeration of tbm bo memory type.
188 typedef enum TBM_BO_FLAGS tbm_bo_memory_type;
191 * @brief Enumeration of buffer manager lock try for bo
195 TBM_BUFMGR_BO_LOCK_TYPE_NEVER = 0, /**< the bufmgr do not try to lock the bos when the tbm_bo_map is called. */
196 TBM_BUFMGR_BO_LOCK_TYPE_ONCE, /**< the bufmgr tries to lock the bos only once when the tbm_bo_map is called. */
197 TBM_BUFMGR_BO_LOCK_TYPE_ALWAYS, /**< the bufmgr always tries to lock the bos when the tbm_bo_map is called. */
198 } tbm_bufmgr_bo_lock_type;
201 * @brief Enumeration of the trace log for debug
205 TBM_BUFGMR_DEBUG_TRACE_NONE = 0,
206 TBM_BUFGMR_DEBUG_TRACE_BO = (1 << 0),
207 TBM_BUFGMR_DEBUG_TRACE_SURFACE_INTERNAL = (1 << 1),
208 TBM_BUFGMR_DEBUG_TRACE_SURFACE = (1 << 2),
209 TBM_BUFGMR_DEBUG_TRACE_SURFACE_QUEUE = (1 << 3),
210 } tbm_bufmgr_debug_trace_mask;
212 #endif /* _TBM_TYPE_COMMON_H_ */