1 /**************************************************************************
5 Copyright 2014 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_SURFACE_H_
34 #define _TBM_SURFACE_H_
37 * @addtogroup CAPI_UI_TBM_SURFACE_MODULE
50 * @brief Enumeration of tbm_surface error type
55 TBM_SURFACE_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
56 TBM_SURFACE_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */
57 TBM_SURFACE_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Invalid Operation */
58 } tbm_surface_error_e;
61 * @brief Definition for the max number of tbm surface plane.
64 #define TBM_SURF_PLANE_MAX 4
66 /* option to map the tbm_surface */
68 * @brief Definition for the access option to read.
71 #define TBM_SURF_OPTION_READ (1 << 0)
73 * @brief Definition for the access option to write.
76 #define TBM_SURF_OPTION_WRITE (1 << 1)
79 * @brief Definition for the tbm plane struct.
82 typedef struct _tbm_surface_plane
84 unsigned char *ptr; /**< plane pointer */
85 uint32_t size; /**< plane size */
86 uint32_t offset; /**< plane offset */
87 uint32_t stride; /**< plane stride */
89 void *reserved1; /**< reserved pointer1 */
90 void *reserved2; /**< reserved pointer2 */
91 void *reserved3; /**< reserved pointer3 */
92 } tbm_surface_plane_s;
95 * @brief Definition for the tbm surface infomation struct.
98 typedef struct _tbm_surface_info
100 uint32_t width; /**< tbm surface width */
101 uint32_t height; /**< tbm surface height */
102 tbm_format format; /**< tbm surface foramt*/
103 uint32_t bpp; /**< tbm surface bbp */
104 uint32_t size; /**< tbm surface size */
106 uint32_t num_planes; /**< the number of planes */
107 tbm_surface_plane_s planes[TBM_SURF_PLANE_MAX]; /**< array of planes */
109 void *reserved4; /**< reserved pointer4 */
110 void *reserved5; /**< reserved pointer5 */
111 void *reserved6; /**< reserved pointer6 */
112 } tbm_surface_info_s;
114 #define __tbm_fourcc_code(a,b,c,d) ((uint32_t)(a) | ((uint32_t)(b) << 8) | \
115 ((uint32_t)(c) << 16) | ((uint32_t)(d) << 24))
119 * @brief Definition for the tbm surface foramt C8 ([7:0] C)
122 #define TBM_FORMAT_C8 __tbm_fourcc_code('C', '8', ' ', ' ')
126 * @brief Definition for the tbm surface foramt RGB322 ([7:0] R:G:B 3:3:2)
129 #define TBM_FORMAT_RGB332 __tbm_fourcc_code('R', 'G', 'B', '8')
131 * @brief Definition for the tbm surface foramt RGB233 ([7:0] B:G:R 2:3:3)
134 #define TBM_FORMAT_BGR233 __tbm_fourcc_code('B', 'G', 'R', '8')
138 * @brief Definition for the tbm surface foramt XRGB4444 ([15:0] x:R:G:B 4:4:4:4 little endian)
141 #define TBM_FORMAT_XRGB4444 __tbm_fourcc_code('X', 'R', '1', '2')
143 * @brief Definition for the tbm surface foramt XBRG4444 ([15:0] x:B:G:R 4:4:4:4 little endian)
146 #define TBM_FORMAT_XBGR4444 __tbm_fourcc_code('X', 'B', '1', '2')
148 * @brief Definition for the tbm surface foramt RGBX4444 ([15:0] R:G:B:x 4:4:4:4 little endian)
151 #define TBM_FORMAT_RGBX4444 __tbm_fourcc_code('R', 'X', '1', '2')
153 * @brief Definition for the tbm surface foramt BGRX4444 ([15:0] B:G:R:x 4:4:4:4 little endian)
156 #define TBM_FORMAT_BGRX4444 __tbm_fourcc_code('B', 'X', '1', '2')
159 * @brief Definition for the tbm surface foramt ARGB4444 ([15:0] A:R:G:B 4:4:4:4 little endian)
162 #define TBM_FORMAT_ARGB4444 __tbm_fourcc_code('A', 'R', '1', '2')
164 * @brief Definition for the tbm surface foramt ABGR4444 ([15:0] A:B:G:R 4:4:4:4 little endian)
167 #define TBM_FORMAT_ABGR4444 __tbm_fourcc_code('A', 'B', '1', '2')
169 * @brief Definition for the tbm surface foramt RGBA4444 ([15:0] R:G:B:A 4:4:4:4 little endian)
172 #define TBM_FORMAT_RGBA4444 __tbm_fourcc_code('R', 'A', '1', '2')
174 * @brief Definition for the tbm surface foramt BGRA4444 ([15:0] B:G:R:A 4:4:4:4 little endian)
177 #define TBM_FORMAT_BGRA4444 __tbm_fourcc_code('B', 'A', '1', '2')
180 * @brief Definition for the tbm surface foramt XRGB1555 ([15:0] x:R:G:B 1:5:5:5 little endian)
183 #define TBM_FORMAT_XRGB1555 __tbm_fourcc_code('X', 'R', '1', '5')
185 * @brief Definition for the tbm surface foramt XBGR1555 ([15:0] x:B:G:R 1:5:5:5 little endian)
188 #define TBM_FORMAT_XBGR1555 __tbm_fourcc_code('X', 'B', '1', '5')
190 * @brief Definition for the tbm surface foramt RGBX5551 ([15:0] R:G:B:x 5:5:5:1 little endian)
193 #define TBM_FORMAT_RGBX5551 __tbm_fourcc_code('R', 'X', '1', '5')
195 * @brief Definition for the tbm surface foramt BGRX5551 ([15:0] B:G:R:x 5:5:5:1 little endian)
198 #define TBM_FORMAT_BGRX5551 __tbm_fourcc_code('B', 'X', '1', '5')
201 * @brief Definition for the tbm surface foramt ARGB1555 ([15:0] A:R:G:B 1:5:5:5 little endian)
204 #define TBM_FORMAT_ARGB1555 __tbm_fourcc_code('A', 'R', '1', '5')
206 * @brief Definition for the tbm surface foramt ABGR1555 ([15:0] A:B:G:R 1:5:5:5 little endian)
209 #define TBM_FORMAT_ABGR1555 __tbm_fourcc_code('A', 'B', '1', '5')
211 * @brief Definition for the tbm surface foramt RGBA5551 ([15:0] R:G:B:A 5:5:5:1 little endian)
214 #define TBM_FORMAT_RGBA5551 __tbm_fourcc_code('R', 'A', '1', '5')
216 * @brief Definition for the tbm surface foramt BGRA5551 ([15:0] B:G:R:A 5:5:5:1 little endian)
219 #define TBM_FORMAT_BGRA5551 __tbm_fourcc_code('B', 'A', '1', '5')
222 * @brief Definition for the tbm surface foramt RGB565 ([15:0] R:G:B 5:6:5 little endian)
225 #define TBM_FORMAT_RGB565 __tbm_fourcc_code('R', 'G', '1', '6')
227 * @brief Definition for the tbm surface foramt BGR565 ([15:0] B:G:R 5:6:5 little endian)
230 #define TBM_FORMAT_BGR565 __tbm_fourcc_code('B', 'G', '1', '6')
234 * @brief Definition for the tbm surface foramt RGB888 ([23:0] R:G:B little endian)
237 #define TBM_FORMAT_RGB888 __tbm_fourcc_code('R', 'G', '2', '4')
239 * @brief Definition for the tbm surface foramt BGR888 ([23:0] B:G:R little endian)
242 #define TBM_FORMAT_BGR888 __tbm_fourcc_code('B', 'G', '2', '4')
246 * @brief Definition for the tbm surface foramt XRGB8888 ([31:0] x:R:G:B 8:8:8:8 little endian)
249 #define TBM_FORMAT_XRGB8888 __tbm_fourcc_code('X', 'R', '2', '4')
251 * @brief Definition for the tbm surface foramt XBGR8888 ([31:0] x:B:G:R 8:8:8:8 little endian)
254 #define TBM_FORMAT_XBGR8888 __tbm_fourcc_code('X', 'B', '2', '4')
256 * @brief Definition for the tbm surface foramt RGBX8888 ([31:0] R:G:B:x 8:8:8:8 little endian)
259 #define TBM_FORMAT_RGBX8888 __tbm_fourcc_code('R', 'X', '2', '4')
261 * @brief Definition for the tbm surface foramt BGRX8888 ([31:0] B:G:R:x 8:8:8:8 little endian)
264 #define TBM_FORMAT_BGRX8888 __tbm_fourcc_code('B', 'X', '2', '4')
267 * @brief Definition for the tbm surface foramt ARGB8888 ([31:0] A:R:G:B 8:8:8:8 little endian)
270 #define TBM_FORMAT_ARGB8888 __tbm_fourcc_code('A', 'R', '2', '4')
272 * @brief Definition for the tbm surface foramt ABGR8888 ([31:0] [31:0] A:B:G:R 8:8:8:8 little endian)
275 #define TBM_FORMAT_ABGR8888 __tbm_fourcc_code('A', 'B', '2', '4')
277 * @brief Definition for the tbm surface foramt RGBA8888 ([31:0] R:G:B:A 8:8:8:8 little endian)
280 #define TBM_FORMAT_RGBA8888 __tbm_fourcc_code('R', 'A', '2', '4')
282 * @brief Definition for the tbm surface foramt BGRA8888 ([31:0] B:G:R:A 8:8:8:8 little endian)
285 #define TBM_FORMAT_BGRA8888 __tbm_fourcc_code('B', 'A', '2', '4')
288 * @brief Definition for the tbm surface foramt XRGB2101010 ([31:0] x:R:G:B 2:10:10:10 little endian)
291 #define TBM_FORMAT_XRGB2101010 __tbm_fourcc_code('X', 'R', '3', '0')
293 * @brief Definition for the tbm surface foramt XBGR2101010 ([31:0] x:B:G:R 2:10:10:10 little endian)
296 #define TBM_FORMAT_XBGR2101010 __tbm_fourcc_code('X', 'B', '3', '0')
298 * @brief Definition for the tbm surface foramt RGBX1010102 ([31:0] R:G:B:x 10:10:10:2 little endian)
301 #define TBM_FORMAT_RGBX1010102 __tbm_fourcc_code('R', 'X', '3', '0')
303 * @brief Definition for the tbm surface foramt BGRX1010102 ([31:0] B:G:R:x 10:10:10:2 little endian)
306 #define TBM_FORMAT_BGRX1010102 __tbm_fourcc_code('B', 'X', '3', '0')
309 * @brief Definition for the tbm surface foramt ARGB2101010 ([31:0] A:R:G:B 2:10:10:10 little endian)
312 #define TBM_FORMAT_ARGB2101010 __tbm_fourcc_code('A', 'R', '3', '0')
314 * @brief Definition for the tbm surface foramt ABGR2101010 ([31:0] A:B:G:R 2:10:10:10 little endian)
317 #define TBM_FORMAT_ABGR2101010 __tbm_fourcc_code('A', 'B', '3', '0')
319 * @brief Definition for the tbm surface foramt RGBA1010102 ([31:0] R:G:B:A 10:10:10:2 little endian)
322 #define TBM_FORMAT_RGBA1010102 __tbm_fourcc_code('R', 'A', '3', '0')
324 * @brief Definition for the tbm surface foramt BGRA1010102 ([31:0] B:G:R:A 10:10:10:2 little endian)
327 #define TBM_FORMAT_BGRA1010102 __tbm_fourcc_code('B', 'A', '3', '0') /* */
331 * @brief Definition for the tbm surface foramt YUYV ([31:0] Cr0:Y1:Cb0:Y0 8:8:8:8 little endian)
334 #define TBM_FORMAT_YUYV __tbm_fourcc_code('Y', 'U', 'Y', 'V')
336 * @brief Definition for the tbm surface foramt YVYU ([31:0] Cb0:Y1:Cr0:Y0 8:8:8:8 little endian)
339 #define TBM_FORMAT_YVYU __tbm_fourcc_code('Y', 'V', 'Y', 'U') /* */
341 * @brief Definition for the tbm surface foramt UYVY ([31:0] Y1:Cr0:Y0:Cb0 8:8:8:8 little endian )
344 #define TBM_FORMAT_UYVY __tbm_fourcc_code('U', 'Y', 'V', 'Y')
346 * @brief Definition for the tbm surface foramt VYUY ([31:0] Y1:Cb0:Y0:Cr0 8:8:8:8 little endian)
349 #define TBM_FORMAT_VYUY __tbm_fourcc_code('V', 'Y', 'U', 'Y')
352 * @brief Definition for the tbm surface foramt AYUV ([31:0] A:Y:Cb:Cr 8:8:8:8 little endian)
355 #define TBM_FORMAT_AYUV __tbm_fourcc_code('A', 'Y', 'U', 'V')
359 * index 0 = Y plane, [7:0] Y
360 * index 1 = Cr:Cb plane, [15:0] Cr:Cb little endian
362 * index 1 = Cb:Cr plane, [15:0] Cb:Cr little endian
365 * @brief Definition for the tbm surface foramt NV12 (2x2 subsampled Cr:Cb plane)
368 #define TBM_FORMAT_NV12 __tbm_fourcc_code('N', 'V', '1', '2')
370 * @brief Definition for the tbm surface foramt NV21 (2x2 subsampled Cb:Cr plane)
373 #define TBM_FORMAT_NV21 __tbm_fourcc_code('N', 'V', '2', '1') /* */
375 * @brief Definition for the tbm surface foramt NV16 (2x1 subsampled Cr:Cb plane)
378 #define TBM_FORMAT_NV16 __tbm_fourcc_code('N', 'V', '1', '6')
380 * @brief Definition for the tbm surface foramt NV61 (2x1 subsampled Cb:Cr plane)
383 #define TBM_FORMAT_NV61 __tbm_fourcc_code('N', 'V', '6', '1')
387 * index 0: Y plane, [7:0] Y
388 * index 1: Cb plane, [7:0] Cb
389 * index 2: Cr plane, [7:0] Cr
391 * index 1: Cr plane, [7:0] Cr
392 * index 2: Cb plane, [7:0] Cb
395 * @brief Definition for the tbm surface foramt YUV410 (4x4 subsampled Cb (1) and Cr (2) planes)
397 #define TBM_FORMAT_YUV410 __tbm_fourcc_code('Y', 'U', 'V', '9')
399 * @brief Definition for the tbm surface foramt YVU410 (4x4 subsampled Cr (1) and Cb (2) planes)
402 #define TBM_FORMAT_YVU410 __tbm_fourcc_code('Y', 'V', 'U', '9')
404 * @brief Definition for the tbm surface foramt YUV411 (4x1 subsampled Cb (1) and Cr (2) planes)
407 #define TBM_FORMAT_YUV411 __tbm_fourcc_code('Y', 'U', '1', '1')
409 * @brief Definition for the tbm surface foramt YVU411 (4x1 subsampled Cr (1) and Cb (2) planes)
412 #define TBM_FORMAT_YVU411 __tbm_fourcc_code('Y', 'V', '1', '1')
414 * @brief Definition for the tbm surface foramt YUV420 (2x2 subsampled Cb (1) and Cr (2) planes)
417 #define TBM_FORMAT_YUV420 __tbm_fourcc_code('Y', 'U', '1', '2')
419 * @brief Definition for the tbm surface foramt YVU420 (2x2 subsampled Cr (1) and Cb (2) planes)
422 #define TBM_FORMAT_YVU420 __tbm_fourcc_code('Y', 'V', '1', '2')
424 * @brief Definition for the tbm surface foramt YUV422 (2x1 subsampled Cb (1) and Cr (2) planes)
427 #define TBM_FORMAT_YUV422 __tbm_fourcc_code('Y', 'U', '1', '6')
429 * @brief Definition for the tbm surface foramt YVU422 (2x1 subsampled Cr (1) and Cb (2) planes)
432 #define TBM_FORMAT_YVU422 __tbm_fourcc_code('Y', 'V', '1', '6')
434 * @brief Definition for the tbm surface foramt YUV444 (non-subsampled Cb (1) and Cr (2) planes)
437 #define TBM_FORMAT_YUV444 __tbm_fourcc_code('Y', 'U', '2', '4')
439 * @brief Definition for the tbm surface foramt YVU444 (non-subsampled Cr (1) and Cb (2) planes)
442 #define TBM_FORMAT_YVU444 __tbm_fourcc_code('Y', 'V', '2', '4')
449 * @brief Queries surface format list and number of format supported by the system.
451 * @remarks The formats must be released using free().
452 * @param[out] **formats : format array which the system can support. This pointer has to be freed by user.
453 * @param[out] num : the number of formats.
454 * @return #TBM_SURFACE_ERROR_NONE if this function succeeds, otherwise error status value
455 * @retval #TBM_SURFACE_ERROR_NONE
456 * @retval #TBM_SURFACE_ERROR_INVALID_OPERATION
459 #include <tbm_surface.h>
465 if (tbm_surface_query_formats (&formats, &format_num))
467 for( i = 0 ; i < format_num ; i++)
469 if (formats[i] == TBM_FORMAT_RGB332)
477 int tbm_surface_query_formats (uint32_t **formats, uint32_t *num);
480 * @brief Creates the tbm_surface.
481 * @details This function create the tbm_surface with width, height, format.
483 * @remark The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
484 * @param[in] width : the width of surface
485 * @param[in] height : the height of surface
486 * @param[in] format : the format of surface
487 * @return a tbm_surface_h if this function succeeds, otherwise NULL
488 * @retval #tbm_surface_h
489 * @exception #TBM_SURFACE_ERROR_NONE Success
490 * @exception #TBM_SURFACE_ERROR_INVALID_PARAMETER Invalid parameter
491 * @exception #TBM_SURFACE_ERROR_INVALID_OPERATION Invalid operation
492 * @see tbm_surface_destroy()
495 #include <tbm_surface.h>
497 tbm_surface_h surface;
499 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
503 tbm_surface_destroy (surface);
506 tbm_surface_h tbm_surface_create (int width, int height, tbm_format format);
509 * @brief Destroies the tbm_surface.
511 * @param[in] surface : the tbm_surface_h
512 * @return #TBM_SURFACE_ERROR_NONE if this function succeeds, otherwise error status value
513 * @retval #TBM_SURFACE_ERROR_NONE
514 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
515 * @see tbm_surface_create()
518 #include <tbm_surface.h>
520 tbm_surface_h surface;
522 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
526 tbm_surface_destroy (surface);
529 int tbm_surface_destroy (tbm_surface_h surface);
532 * @brief Maps the tbm_surface according to the access option.
533 * @details After mapping tbm_surface, the information of tbm_surface is assigned in #tbm_surface_info_s struct.\n
534 * The information of tbm_surface has width, height, format, bpp, size, number of planes and information of planes.\n
535 * The information of planes has stride, offset, size and pointer of plane\n
536 * #TBM_SURF_OPTION_READ indecates access option to read.\n
537 * #TBM_SURF_OPTION_WRITE indecates access option to write.
539 * @param[in] surface : the tbm_surface_h
540 * @param[in] opt : the option to access the tbm_surface
541 * @param[out] *info : the infomation of the tbm_surface
542 * @return #TBM_SURFACE_ERROR_NONE if this function succeeds, otherwise error status value
543 * @retval #TBM_SURFACE_ERROR_NONE
544 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
545 * @retval #TBM_SURFACE_ERROR_INVALID_OPERATION
546 * @see tbm_surface_unmap();
549 #include <tbm_surface.h>
551 tbm_surface_h surface;
552 tbm_surface_info_s info;
555 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
556 ret = tbm_surface_map (surface, TBM_SURF_OPTION_WRITE|TBM_SURF_OPTION_READ, &info);
560 tbm_surface_unmap (surface);
561 tbm_surface_destroy (surface);
564 int tbm_surface_map (tbm_surface_h surface, int opt, tbm_surface_info_s *info);
567 * @brief Unmaps the tbm_surface.
569 * @param[in] surface : the tbm_surface_h
570 * @return #TBM_SURFACE_ERROR_NONE if this function succeeds, otherwise error status value
571 * @retval #TBM_SURFACE_ERROR_NONE
572 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
573 * @see tbm_surface_map()
576 #include <tbm_surface.h>
578 tbm_surface_h surface;
579 tbm_surface_info_s info;
582 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
583 ret = tbm_surface_map (surface, TBM_SURF_OPTION_WRITE|TBM_SURF_OPTION_READ, &info);
587 tbm_surface_unmap (surface);
588 tbm_surface_destroy (surface);
591 int tbm_surface_unmap (tbm_surface_h surface);
594 * @brief Gets the information of the tbm_surface.
595 * @details The information of tbm_surface is assigned in #tbm_surface_info_s struct.\n
596 * The information of tbm_surface has width, height, format, bpp, size, number of planes and information of planes.\n
597 * The information of planes has stride, offset, size and pointer of plane.
599 * @param[in] surface : the tbm_surface_h
600 * @param[out] *info : the infomation of the tbm_surface
601 * @return #TBM_SURFACE_ERROR_NONE if this function succeeds, otherwise error status value
602 * @retval #TBM_SURFACE_ERROR_NONE
603 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
604 * @retval #TBM_SURFACE_ERROR_INVALID_OPERATION
605 * @see tbm_surface_map()
608 #include <tbm_surface.h>
610 tbm_surface_h surface;
611 tbm_surface_info_s info;
614 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
615 ret = tbm_surface_get_info (surface, &info);
619 tbm_surface_destroy (surface);
622 int tbm_surface_get_info (tbm_surface_h surface, tbm_surface_info_s *info);
625 * @brief Gets the width of the tbm_surface.
627 * @param[in] surface : the tbm_surface_h
628 * @return the width of the tbm_surface if this function succeeds, otherwise error status value
629 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
632 #include <tbm_surface.h>
634 tbm_surface_h surface;
637 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
641 width = tbm_surface_get_width (surface);
645 tbm_surface_destroy (surface);
648 int tbm_surface_get_width (tbm_surface_h surface);
651 * @brief Gets the height of the tbm_surface.
653 * @param[in] surface : the tbm_surface_h
654 * @return the height of the tbm_surface if this function succeeds, otherwise error status value
655 * @retval #TBM_SURFACE_ERROR_INVALID_PARAMETER
658 #include <tbm_surface.h>
660 tbm_surface_h surface;
663 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
667 height = tbm_surface_get_height (surface);
671 tbm_surface_destroy (surface);
674 int tbm_surface_get_height (tbm_surface_h surface);
677 * @brief Gets the format of the tbm_surface.
679 * @remark The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
680 * @param[in] surface : the tbm_surface_h
681 * @return the format of the tbm_surface if this function succeeds, otherwise 0
682 * @retval #tbm_format
683 * @exception #TBM_SURFACE_ERROR_NONE Success
684 * @exception #TBM_SURFACE_ERROR_INVALID_PARAMETER Invalid parameter
687 #include <tbm_surface.h>
689 tbm_surface_s surface;
692 surface = tbm_surface_create (128, 128, TBM_FORMAT_RGB332);
696 format = tbm_surface_get_format (surface);
700 tbm_surface_destroy (surface);
703 tbm_format tbm_surface_get_format (tbm_surface_h surface);
713 #endif /* _TBM_SURFACE_H_ */