• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    TIZEN_image_native_buffer
4
5Name Strings
6
7    EGL_TIZEN_image_native_buffer
8
9Contributors
10
11    Dongyeon Kim
12    Minsu Han
13    Inpyo Kang
14    Zeeshan Anwar
15
16Contact
17
18    Dongyeon Kim, Samsung Electronics (dy5.kim 'at' samsung.com)
19    Zeeshan Anwar, Samsung Electronics (z.anwar 'at' samsung.com)
20
21Status
22
23    This extension is obsolete and has been replaced by
24	EGL_TIZEN_image_native_buffer
25
26Version
27
28    Version 2, July 23, 2014
29
30Number
31
32    EGL Extension #76
33
34Dependencies
35
36    EGL 1.2 is required.
37
38    EGL_KHR_image_base is required.
39
40    This extension is written against the wording of the EGL 1.2
41    Specification.
42
43Overview
44
45    This extension enables using a Tizen native buffer (struct
46    native_buffer) as an EGLImage source.
47
48New Types
49
50    None.
51
52New Procedures and Functions
53
54    None.
55
56New Tokens
57
58    Accepted by the <target> parameter of eglCreateImageKHR:
59
60    EGL_NATIVE_BUFFER_TIZEN             0x32A0
61
62Changes to Chapter 3 of the EGL 1.2 Specification (EGL Functions and Errors)
63
64    Add to section 2.5.1 "EGLImage Specification" (as defined by the
65    EGL_KHR_image_base specification), in the description of
66    eglCreateImageKHR:
67
68   "Values accepted for <target> are listed in Table aaa, below.
69
70      +-------------------------+--------------------------------------+
71      | <target>                | Notes                                |
72      +-------------------------+--------------------------------------+
73      | EGL_NATIVE_BUFFER_TIZEN | Used for Tizen native_buffer objects |
74      +-------------------------+--------------------------------------+
75       Table aaa.  Legal values for eglCreateImageKHR <target> parameter
76
77    ...
78
79    If <target> is EGL_NATIVE_BUFFER_TIZEN, <dpy> must be a valid display,
80    <ctx> must be EGL_NO_CONTEXT, <buffer> must be a pointer to a valid
81    native_buffer object (cast into the type EGLClientBuffer), and
82    attributes other than EGL_IMAGE_PRESERVED_KHR are ignored."
83
84    Add to the list of error conditions for eglCreateImageKHR:
85
86      "* If <target> is EGL_NATIVE_BUFFER_TIZEN and <buffer> is not a
87         pointer to a valid native_buffer, the error EGL_BAD_PARAMETER
88         is generated.
89
90       * If <target> is EGL_NATIVE_BUFFER_TIZEN and <ctx> is not
91         EGL_NO_CONTEXT, the error EGL_BAD_CONTEXT is generated.
92
93       * If <target> is EGL_NATIVE_BUFFER_TIZEN and <buffer> was created
94         with properties (format, usage, dimensions, etc.) not supported by
95         the EGL implementation, the error EGL_BAD_PARAMETER is generated."
96
97Issues
98
99    1. Should this extension define what combinations of native_buffer
100    properties implementations are required to support?
101
102    RESOLVED: No.
103
104    The requirements have evolved over time and will continue to change with
105    future Tizen releases. The minimum requirements for a given Tizen
106    version should be documented by that version.
107
108
109Revision History
110
111#2 (Zeeshan Anwar, July 01, 2014)
112    - Assigned the value to EGL_NATIVE_BUFFER_TIZEN
113#1 (Dongyeon Kim, June 05, 2013)
114    - Initial draft.
115