1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
Name
NV_native_query
Name Strings
EGL_NV_native_query
Contributors
Mathias Heyer, NVIDIA
Daniel Kartch, NVIDIA
Peter Pipkorn, NVIDIA
Acorn Pooley, NVIDIA
Greg Roth, NVIDIA
Contacts
Peter Pipkorn, NVIDIA Corporation (ppipkorn 'at' nvidia.com)
Status
Complete
Version
Version 0.4, 25 Sept, 2012
Number
EGL Extension #45
Dependencies
Requires EGL 1.0
This extension is written against the wording of the EGL 1.4
Specification.
Overview
This extension allows an application to query which native display,
pixmap and surface corresponds to a EGL object.
New Procedures and Functions
EGLBoolean eglQueryNativeDisplayNV(
EGLDisplay dpy,
EGLNativeDisplayType* display_id);
EGLBoolean eglQueryNativeWindowNV(
EGLDisplay dpy,
EGLSurface surf,
EGLNativeWindowType* window);
EGLBoolean eglQueryNativePixmapNV(
EGLDisplay dpy,
EGLSurface surf,
EGLNativePixmapType* pixmap);
Changes to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors)
In Chapter 3.2, after the description of eglInitialize and before the
description of eglTerminate insert
"While initialized, the native display that corresponds to an
EGLDisplay can retrieved by
EGLBoolean eglQueryNativeDisplayNV(
EGLDisplay dpy,
EGLNativeDisplayType* display_id);
If the <dpy> is a valid and initialized EGLDisplay, EGL_TRUE
will be returned and the native display handle will be written
to <display_id>. Otherwise EGL_FALSE will be returned and the
contents of <display_id> are left untouched. If the <dpy> is
not valid, an EGL_BAD_DISPLAY error will be generated. If <dpy>
is not initialized, an EGL_NOT_INITIALIZED error will be
generated. If <display_id> is NULL, an EGL_BAD_PARAMETER error
will be generated.
In Chapter 3.5 Rendering Surfaces, after section 3.5.1 insert
"The native window that corresponds to an EGLSurface can be
retrieved by
EGLBoolean eglQueryNativeWindowNV(
EGLDisplay dpy,
EGLSurface surf,
EGLNativeWindowType* win);
The corresponding native window will be written to <win>,
and EGL_TRUE will be returned. If the call fails, EGL_FALSE
will be returned, and content of <win> will not be modified.
If <dpy> is not a valid EGLDisplay, an EGL_BAD_DISPLAY error
will be generated. If <dpy> is not initialized, an EGL_NOT_-
INITIALIZED error will be generated. If <surf> is not a valid
EGLSurface, or <surf> does not have a corresponding native
window, an EGL_BAD_SURFACE error will be generated." If <win>
is NULL, an EGL_BAD_PARAMETER error will be generated.
After section 3.5.4 Creating Native Pixmap Rendering Surfaces insert
"The native pixmap that corresponds to an EGLSurface can be
retrieved by
EGLBoolean eglQueryNativePixmapNV(
EGLDisplay dpy,
EGLSurface surf,
EGLNativePixmapType* pixmap);
The corresponding native pixmap will be written to <pixmap>,
and EGL_TRUE will be returned. If the call fails, EGL_FALSE
will be returned, and the content of <pixmap> will not be
modified. If <dpy> is not a valid EGLDisplay, an EGL_BAD_-
DISPLAY error will be generated. If <dpy> is not initialized,
an EGL_NOT_INITIALIZED error will be generated. If <surf> is
not a valid EGLSurface, or <surf> does not have a corresponding
native pixmap, an EGL_BAD_SURFACE error will be generated." If
<pixmap> is NULL, an EGL_BAD_PARAMETER error will be
generated.
Issues
Revision History
#4 (Greg Roth, Sept 25, 2012)
- Further document all potential errors for all functions
#3 (Daniel Kartch, August 30, 2011)
- Add restriction that EGLDisplay be initialized
#2 (Peter Pipkorn, December 16, 2009)
- Minor cleanup
#1 (Peter Pipkorn, December 15, 2009)
- First Draft
|
