forked from google/angle
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ANGLE_multi_draw.txt
235 lines (166 loc) · 7.23 KB
/
ANGLE_multi_draw.txt
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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
Name
ANGLE_multi_draw
Name Strings
GL_ANGLE_multi_draw
Contributors
Austin Eng, Google Inc.
Kai Ninomiya, Google Inc.
Kenneth Russell, Google Inc.
Contributors to the EXT_multi_draw_arrays specification
Contributors to the ARB_shader_draw_parameters specification
Contact
Austin Eng (enga 'at' google.com)
Status
Incomplete
Version
Last Modified Date: October 24, 2018
Author Revision: 1
Number
OpenGL ES Extension XX
Dependencies
OpenGL ES 2.0 is required.
This extension is written against the OpenGL ES 2.0 specification,
the OpenGL ES 3.0 specification, and the OpenGL ES Shading Language 3.0
specification.
The presence of the GL_ANGLE_instanced_arrays or GL_EXT_instanced_arrays
extensions affects the definition of this extension.
Overview
This extension exposes the Multi* draw call variants in
EXT_multi_draw_arrays functionality in addition to the vertex shader builtin
gl_DrawID exposed by ARB_shader_draw_parameters for OpenGL.
These functions behave identically to the standard functions
DrawArrays() and DrawElements() except they handle multiple lists of
vertices in one call. Their main purpose is to allow one function call
to render more than one primitive such as triangle strip, triangle fan,
etc.
Additionally, this extension adds a further built-in variable, gl_DrawID
to the shading language. This variable contains the index of the draw
currently being processed by a Multi* variant of a drawing command.
IP Status
No known IP claims.
New Procedures and Functions
void MultiDrawArraysANGLE(enum mode,
const int *firsts,
const sizei *counts,
sizei drawcount);
void MultiDrawElementsANGLE(enum mode,
const sizei *counts,
enum type,
const void *const *indices,
sizei drawcount);
void MultiDrawArraysInstancedANGLE(enum mode,
const int *firsts,
const sizei *counts,
const sizei *instanceCounts,
sizei drawcount);
void MultiDrawElementsInstancedANGLE(enum mode,
const sizei *counts,
enum type,
const void *const *indices,
const sizei *instanceCounts,
sizei drawcount);
New Tokens
None.
Additions to Chapter 2 of the OpenGL ES 2.0 Specification
Section 2.8 Vertex Arrays:
The command
void MultiDrawArraysANGLE(
enum mode,
const int *firsts,
const sizei *counts,
sizei drawcount)
Behaves identically to DrawArrays except that a list of arrays is
specified instead. The number of lists is specified in the drawcount
parameter. It has the same effect as:
for(i=0; i<drawcount; i++) {
if (*(counts+i)>0) DrawArrays(mode, *(firsts+i), *(counts+i));
}
The index of the draw (<i> in the above pseudo-code) may be read by
a vertex shader as <gl_DrawID>.
The command
void MultiDrawElementsANGLE(
enum mode,
const sizei *counts,
enum type,
const void *const *indices,
sizei drawcount)
Behaves identically to DrawElements except that a list of arrays is
specified instead. The number of lists is specified in the drawcount
parameter. It has the same effect as:
for(i=0; i<drawcount; i++) {
if (*(counts+i)>0) {
DrawElements(mode, *(counts+i), type, *(indices+i));
}
}
The index of the draw (<i> in the above pseudo-code) may be read by
a vertex shader as <gl_DrawID>.
Additions to Chapter 2 of the OpenGL ES 3.0 Specification
Section 2.9.3 Drawing Commands:
The command
void MultiDrawArraysInstancedANGLE(
enum mode,
const int *firsts,
const sizei *counts,
const sizei *instanceCounts,
sizei drawcount)
Behaves identically to DrawArraysInstanced except that a list of arrays is
specified instead. The number of lists is specified in the drawcount
parameter. It has the same effect as:
for(i=0; i<drawcount; i++) {
if (*(counts+i)>0) DrawArraysInstanced(mode, *(firsts+i), *(counts+i),
*(instanceCounts+1));
}
The index of the draw (<i> in the above pseudo-code) may be read by
a vertex shader as <gl_DrawID>.
The command
void MultiDrawElementsInstancedANGLE(
enum mode,
sizei *counts,
enum type,
const void *const *indices,
const sizei *instanceCounts,
sizei drawcount)
Behaves identically to DrawElementsInstanced except that a list of arrays is
specified instead. The number of lists is specified in the drawcount
parameter. It has the same effect as:
for(i=0; i<drawcount; i++) {
if (*(counts+i)>0) {
DrawElementsInstanced(mode, *(counts+i), type,
*(indices+i), *(instanceCounts+1));
}
}
The index of the draw (<i> in the above pseudo-code) may be read by
a vertex shader as <gl_DrawID>.
Errors
The error INVALID_VALUE is generated by the new functions if <drawcount>
is less than 0.
MultiDrawArraysANGLE, MultiDrawElementsANGLE,
MultiDrawArraysInstancedANGLE, and MultiDrawElementsInstancedANGLE generate
the same errors as DrawArrays, DrawElements, DrawArraysInstanced,
and DrawElementsInstanced, respectively, for any draw <i> where an error
is generated. If any call would produce an error, no drawing is performed.
Modifications to the OpenGL ES Shading Language Specification, Version 3.00
Including the following line in a shader can be used to control the
language featured described in this extension:
#extension GL_ANGLE_multi_draw : <behavior>
where <behavior> is as specified in section 3.5.
A new preprocessor #define is added to the OpenGL ES Shading Language:
#define GL_ANGLE_multi_draw 1
Dependencies on GL_ANGLE_instanced_arrays
If GL_ANGLE_instanced_arrays or GL_EXT_instanced_arrays is enabled,
append the lanuage in "Additions to Chapter 2 of the OpenGL ES 3.0
Specification, Section 2.9.3 Drawing Commands" to the language in
"Additions to Chapter 2 of the OpenGL ES 2.0 Specification, Section
2.8 Vertex Arrays".
If GL_ANGLE_instanced_arrays or GL_EXT_instanced_arrays is not enabled
and the context is less than a OpenGL ES 3.0 context, the error
INVALID_OPERATION is generated by any call to the functions
MultiDrawArraysInstancedANGLE and MultiDrawElementsInstancedANGLE.
Issues
None
Revision History
Rev. Date Author Changes
---- -------- ---------------- --------------------------------------------
1 10/24/18 Austin Eng First revision.
2 10/25/18 Austin Eng Add instanced variants.
3 06/21/22 Alexey Knyazev Fixed typos and type usage.