i965: Use ISL for emitting buffer surface states
[mesa.git] / src / mesa / drivers / dri / i965 / brw_context.h
1 /*
2 Copyright (C) Intel Corp. 2006. All Rights Reserved.
3 Intel funded Tungsten Graphics to
4 develop this 3D driver.
5
6 Permission is hereby granted, free of charge, to any person obtaining
7 a copy of this software and associated documentation files (the
8 "Software"), to deal in the Software without restriction, including
9 without limitation the rights to use, copy, modify, merge, publish,
10 distribute, sublicense, and/or sell copies of the Software, and to
11 permit persons to whom the Software is furnished to do so, subject to
12 the following conditions:
13
14 The above copyright notice and this permission notice (including the
15 next paragraph) shall be included in all copies or substantial
16 portions of the Software.
17
18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21 IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
22 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
23 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
24 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25
26 **********************************************************************/
27 /*
28 * Authors:
29 * Keith Whitwell <keithw@vmware.com>
30 */
31
32
33 #ifndef BRWCONTEXT_INC
34 #define BRWCONTEXT_INC
35
36 #include <stdbool.h>
37 #include "main/macros.h"
38 #include "main/mtypes.h"
39 #include "brw_structs.h"
40 #include "brw_compiler.h"
41 #include "intel_aub.h"
42
43 #include "isl/isl.h"
44
45 #ifdef __cplusplus
46 extern "C" {
47 /* Evil hack for using libdrm in a c++ compiler. */
48 #define virtual virt
49 #endif
50
51 #include <intel_bufmgr.h>
52 #ifdef __cplusplus
53 #undef virtual
54 }
55 #endif
56
57 #ifdef __cplusplus
58 extern "C" {
59 #endif
60 #include "intel_debug.h"
61 #include "intel_screen.h"
62 #include "intel_tex_obj.h"
63 #include "intel_resolve_map.h"
64
65 /* Glossary:
66 *
67 * URB - uniform resource buffer. A mid-sized buffer which is
68 * partitioned between the fixed function units and used for passing
69 * values (vertices, primitives, constants) between them.
70 *
71 * CURBE - constant URB entry. An urb region (entry) used to hold
72 * constant values which the fixed function units can be instructed to
73 * preload into the GRF when spawning a thread.
74 *
75 * VUE - vertex URB entry. An urb entry holding a vertex and usually
76 * a vertex header. The header contains control information and
77 * things like primitive type, Begin/end flags and clip codes.
78 *
79 * PUE - primitive URB entry. An urb entry produced by the setup (SF)
80 * unit holding rasterization and interpolation parameters.
81 *
82 * GRF - general register file. One of several register files
83 * addressable by programmed threads. The inputs (r0, payload, curbe,
84 * urb) of the thread are preloaded to this area before the thread is
85 * spawned. The registers are individually 8 dwords wide and suitable
86 * for general usage. Registers holding thread input values are not
87 * special and may be overwritten.
88 *
89 * MRF - message register file. Threads communicate (and terminate)
90 * by sending messages. Message parameters are placed in contiguous
91 * MRF registers. All program output is via these messages. URB
92 * entries are populated by sending a message to the shared URB
93 * function containing the new data, together with a control word,
94 * often an unmodified copy of R0.
95 *
96 * R0 - GRF register 0. Typically holds control information used when
97 * sending messages to other threads.
98 *
99 * EU or GEN4 EU: The name of the programmable subsystem of the
100 * i965 hardware. Threads are executed by the EU, the registers
101 * described above are part of the EU architecture.
102 *
103 * Fixed function units:
104 *
105 * CS - Command streamer. Notional first unit, little software
106 * interaction. Holds the URB entries used for constant data, ie the
107 * CURBEs.
108 *
109 * VF/VS - Vertex Fetch / Vertex Shader. The fixed function part of
110 * this unit is responsible for pulling vertices out of vertex buffers
111 * in vram and injecting them into the processing pipe as VUEs. If
112 * enabled, it first passes them to a VS thread which is a good place
113 * for the driver to implement any active vertex shader.
114 *
115 * HS - Hull Shader (Tessellation Control Shader)
116 *
117 * TE - Tessellation Engine (Tessellation Primitive Generation)
118 *
119 * DS - Domain Shader (Tessellation Evaluation Shader)
120 *
121 * GS - Geometry Shader. This corresponds to a new DX10 concept. If
122 * enabled, incoming strips etc are passed to GS threads in individual
123 * line/triangle/point units. The GS thread may perform arbitary
124 * computation and emit whatever primtives with whatever vertices it
125 * chooses. This makes GS an excellent place to implement GL's
126 * unfilled polygon modes, though of course it is capable of much
127 * more. Additionally, GS is used to translate away primitives not
128 * handled by latter units, including Quads and Lineloops.
129 *
130 * CS - Clipper. Mesa's clipping algorithms are imported to run on
131 * this unit. The fixed function part performs cliptesting against
132 * the 6 fixed clipplanes and makes descisions on whether or not the
133 * incoming primitive needs to be passed to a thread for clipping.
134 * User clip planes are handled via cooperation with the VS thread.
135 *
136 * SF - Strips Fans or Setup: Triangles are prepared for
137 * rasterization. Interpolation coefficients are calculated.
138 * Flatshading and two-side lighting usually performed here.
139 *
140 * WM - Windower. Interpolation of vertex attributes performed here.
141 * Fragment shader implemented here. SIMD aspects of EU taken full
142 * advantage of, as pixels are processed in blocks of 16.
143 *
144 * CC - Color Calculator. No EU threads associated with this unit.
145 * Handles blending and (presumably) depth and stencil testing.
146 */
147
148 struct brw_context;
149 struct brw_inst;
150 struct brw_vs_prog_key;
151 struct brw_vue_prog_key;
152 struct brw_wm_prog_key;
153 struct brw_wm_prog_data;
154 struct brw_cs_prog_key;
155 struct brw_cs_prog_data;
156
157 enum brw_pipeline {
158 BRW_RENDER_PIPELINE,
159 BRW_COMPUTE_PIPELINE,
160
161 BRW_NUM_PIPELINES
162 };
163
164 enum brw_cache_id {
165 BRW_CACHE_FS_PROG,
166 BRW_CACHE_BLORP_PROG,
167 BRW_CACHE_SF_PROG,
168 BRW_CACHE_VS_PROG,
169 BRW_CACHE_FF_GS_PROG,
170 BRW_CACHE_GS_PROG,
171 BRW_CACHE_TCS_PROG,
172 BRW_CACHE_TES_PROG,
173 BRW_CACHE_CLIP_PROG,
174 BRW_CACHE_CS_PROG,
175
176 BRW_MAX_CACHE
177 };
178
179 enum brw_state_id {
180 /* brw_cache_ids must come first - see brw_state_cache.c */
181 BRW_STATE_URB_FENCE = BRW_MAX_CACHE,
182 BRW_STATE_FRAGMENT_PROGRAM,
183 BRW_STATE_GEOMETRY_PROGRAM,
184 BRW_STATE_TESS_PROGRAMS,
185 BRW_STATE_VERTEX_PROGRAM,
186 BRW_STATE_CURBE_OFFSETS,
187 BRW_STATE_REDUCED_PRIMITIVE,
188 BRW_STATE_PATCH_PRIMITIVE,
189 BRW_STATE_PRIMITIVE,
190 BRW_STATE_CONTEXT,
191 BRW_STATE_PSP,
192 BRW_STATE_SURFACES,
193 BRW_STATE_BINDING_TABLE_POINTERS,
194 BRW_STATE_INDICES,
195 BRW_STATE_VERTICES,
196 BRW_STATE_DEFAULT_TESS_LEVELS,
197 BRW_STATE_BATCH,
198 BRW_STATE_INDEX_BUFFER,
199 BRW_STATE_VS_CONSTBUF,
200 BRW_STATE_TCS_CONSTBUF,
201 BRW_STATE_TES_CONSTBUF,
202 BRW_STATE_GS_CONSTBUF,
203 BRW_STATE_PROGRAM_CACHE,
204 BRW_STATE_STATE_BASE_ADDRESS,
205 BRW_STATE_VUE_MAP_GEOM_OUT,
206 BRW_STATE_TRANSFORM_FEEDBACK,
207 BRW_STATE_RASTERIZER_DISCARD,
208 BRW_STATE_STATS_WM,
209 BRW_STATE_UNIFORM_BUFFER,
210 BRW_STATE_ATOMIC_BUFFER,
211 BRW_STATE_IMAGE_UNITS,
212 BRW_STATE_META_IN_PROGRESS,
213 BRW_STATE_INTERPOLATION_MAP,
214 BRW_STATE_PUSH_CONSTANT_ALLOCATION,
215 BRW_STATE_NUM_SAMPLES,
216 BRW_STATE_TEXTURE_BUFFER,
217 BRW_STATE_GEN4_UNIT_STATE,
218 BRW_STATE_CC_VP,
219 BRW_STATE_SF_VP,
220 BRW_STATE_CLIP_VP,
221 BRW_STATE_SAMPLER_STATE_TABLE,
222 BRW_STATE_VS_ATTRIB_WORKAROUNDS,
223 BRW_STATE_COMPUTE_PROGRAM,
224 BRW_STATE_CS_WORK_GROUPS,
225 BRW_STATE_URB_SIZE,
226 BRW_STATE_CC_STATE,
227 BRW_STATE_BLORP,
228 BRW_NUM_STATE_BITS
229 };
230
231 /**
232 * BRW_NEW_*_PROG_DATA and BRW_NEW_*_PROGRAM are similar, but distinct.
233 *
234 * BRW_NEW_*_PROGRAM relates to the gl_shader_program/gl_program structures.
235 * When the currently bound shader program differs from the previous draw
236 * call, these will be flagged. They cover brw->{stage}_program and
237 * ctx->{Stage}Program->_Current.
238 *
239 * BRW_NEW_*_PROG_DATA is flagged when the effective shaders change, from a
240 * driver perspective. Even if the same shader is bound at the API level,
241 * we may need to switch between multiple versions of that shader to handle
242 * changes in non-orthagonal state.
243 *
244 * Additionally, multiple shader programs may have identical vertex shaders
245 * (for example), or compile down to the same code in the backend. We combine
246 * those into a single program cache entry.
247 *
248 * BRW_NEW_*_PROG_DATA occurs when switching program cache entries, which
249 * covers the brw_*_prog_data structures, and brw->*.prog_offset.
250 */
251 #define BRW_NEW_FS_PROG_DATA (1ull << BRW_CACHE_FS_PROG)
252 /* XXX: The BRW_NEW_BLORP_BLIT_PROG_DATA dirty bit is unused (as BLORP doesn't
253 * use the normal state upload paths), but the cache is still used. To avoid
254 * polluting the brw_state_cache code with special cases, we retain the dirty
255 * bit for now. It should eventually be removed.
256 */
257 #define BRW_NEW_BLORP_BLIT_PROG_DATA (1ull << BRW_CACHE_BLORP_PROG)
258 #define BRW_NEW_SF_PROG_DATA (1ull << BRW_CACHE_SF_PROG)
259 #define BRW_NEW_VS_PROG_DATA (1ull << BRW_CACHE_VS_PROG)
260 #define BRW_NEW_FF_GS_PROG_DATA (1ull << BRW_CACHE_FF_GS_PROG)
261 #define BRW_NEW_GS_PROG_DATA (1ull << BRW_CACHE_GS_PROG)
262 #define BRW_NEW_TCS_PROG_DATA (1ull << BRW_CACHE_TCS_PROG)
263 #define BRW_NEW_TES_PROG_DATA (1ull << BRW_CACHE_TES_PROG)
264 #define BRW_NEW_CLIP_PROG_DATA (1ull << BRW_CACHE_CLIP_PROG)
265 #define BRW_NEW_CS_PROG_DATA (1ull << BRW_CACHE_CS_PROG)
266 #define BRW_NEW_URB_FENCE (1ull << BRW_STATE_URB_FENCE)
267 #define BRW_NEW_FRAGMENT_PROGRAM (1ull << BRW_STATE_FRAGMENT_PROGRAM)
268 #define BRW_NEW_GEOMETRY_PROGRAM (1ull << BRW_STATE_GEOMETRY_PROGRAM)
269 #define BRW_NEW_TESS_PROGRAMS (1ull << BRW_STATE_TESS_PROGRAMS)
270 #define BRW_NEW_VERTEX_PROGRAM (1ull << BRW_STATE_VERTEX_PROGRAM)
271 #define BRW_NEW_CURBE_OFFSETS (1ull << BRW_STATE_CURBE_OFFSETS)
272 #define BRW_NEW_REDUCED_PRIMITIVE (1ull << BRW_STATE_REDUCED_PRIMITIVE)
273 #define BRW_NEW_PATCH_PRIMITIVE (1ull << BRW_STATE_PATCH_PRIMITIVE)
274 #define BRW_NEW_PRIMITIVE (1ull << BRW_STATE_PRIMITIVE)
275 #define BRW_NEW_CONTEXT (1ull << BRW_STATE_CONTEXT)
276 #define BRW_NEW_PSP (1ull << BRW_STATE_PSP)
277 #define BRW_NEW_SURFACES (1ull << BRW_STATE_SURFACES)
278 #define BRW_NEW_BINDING_TABLE_POINTERS (1ull << BRW_STATE_BINDING_TABLE_POINTERS)
279 #define BRW_NEW_INDICES (1ull << BRW_STATE_INDICES)
280 #define BRW_NEW_VERTICES (1ull << BRW_STATE_VERTICES)
281 #define BRW_NEW_DEFAULT_TESS_LEVELS (1ull << BRW_STATE_DEFAULT_TESS_LEVELS)
282 /**
283 * Used for any batch entry with a relocated pointer that will be used
284 * by any 3D rendering.
285 */
286 #define BRW_NEW_BATCH (1ull << BRW_STATE_BATCH)
287 /** \see brw.state.depth_region */
288 #define BRW_NEW_INDEX_BUFFER (1ull << BRW_STATE_INDEX_BUFFER)
289 #define BRW_NEW_VS_CONSTBUF (1ull << BRW_STATE_VS_CONSTBUF)
290 #define BRW_NEW_TCS_CONSTBUF (1ull << BRW_STATE_TCS_CONSTBUF)
291 #define BRW_NEW_TES_CONSTBUF (1ull << BRW_STATE_TES_CONSTBUF)
292 #define BRW_NEW_GS_CONSTBUF (1ull << BRW_STATE_GS_CONSTBUF)
293 #define BRW_NEW_PROGRAM_CACHE (1ull << BRW_STATE_PROGRAM_CACHE)
294 #define BRW_NEW_STATE_BASE_ADDRESS (1ull << BRW_STATE_STATE_BASE_ADDRESS)
295 #define BRW_NEW_VUE_MAP_GEOM_OUT (1ull << BRW_STATE_VUE_MAP_GEOM_OUT)
296 #define BRW_NEW_TRANSFORM_FEEDBACK (1ull << BRW_STATE_TRANSFORM_FEEDBACK)
297 #define BRW_NEW_RASTERIZER_DISCARD (1ull << BRW_STATE_RASTERIZER_DISCARD)
298 #define BRW_NEW_STATS_WM (1ull << BRW_STATE_STATS_WM)
299 #define BRW_NEW_UNIFORM_BUFFER (1ull << BRW_STATE_UNIFORM_BUFFER)
300 #define BRW_NEW_ATOMIC_BUFFER (1ull << BRW_STATE_ATOMIC_BUFFER)
301 #define BRW_NEW_IMAGE_UNITS (1ull << BRW_STATE_IMAGE_UNITS)
302 #define BRW_NEW_META_IN_PROGRESS (1ull << BRW_STATE_META_IN_PROGRESS)
303 #define BRW_NEW_INTERPOLATION_MAP (1ull << BRW_STATE_INTERPOLATION_MAP)
304 #define BRW_NEW_PUSH_CONSTANT_ALLOCATION (1ull << BRW_STATE_PUSH_CONSTANT_ALLOCATION)
305 #define BRW_NEW_NUM_SAMPLES (1ull << BRW_STATE_NUM_SAMPLES)
306 #define BRW_NEW_TEXTURE_BUFFER (1ull << BRW_STATE_TEXTURE_BUFFER)
307 #define BRW_NEW_GEN4_UNIT_STATE (1ull << BRW_STATE_GEN4_UNIT_STATE)
308 #define BRW_NEW_CC_VP (1ull << BRW_STATE_CC_VP)
309 #define BRW_NEW_SF_VP (1ull << BRW_STATE_SF_VP)
310 #define BRW_NEW_CLIP_VP (1ull << BRW_STATE_CLIP_VP)
311 #define BRW_NEW_SAMPLER_STATE_TABLE (1ull << BRW_STATE_SAMPLER_STATE_TABLE)
312 #define BRW_NEW_VS_ATTRIB_WORKAROUNDS (1ull << BRW_STATE_VS_ATTRIB_WORKAROUNDS)
313 #define BRW_NEW_COMPUTE_PROGRAM (1ull << BRW_STATE_COMPUTE_PROGRAM)
314 #define BRW_NEW_CS_WORK_GROUPS (1ull << BRW_STATE_CS_WORK_GROUPS)
315 #define BRW_NEW_URB_SIZE (1ull << BRW_STATE_URB_SIZE)
316 #define BRW_NEW_CC_STATE (1ull << BRW_STATE_CC_STATE)
317 #define BRW_NEW_BLORP (1ull << BRW_STATE_BLORP)
318
319 struct brw_state_flags {
320 /** State update flags signalled by mesa internals */
321 GLuint mesa;
322 /**
323 * State update flags signalled as the result of brw_tracked_state updates
324 */
325 uint64_t brw;
326 };
327
328 /** Subclass of Mesa vertex program */
329 struct brw_vertex_program {
330 struct gl_vertex_program program;
331 GLuint id;
332 };
333
334
335 /** Subclass of Mesa tessellation control program */
336 struct brw_tess_ctrl_program {
337 struct gl_tess_ctrl_program program;
338 unsigned id; /**< serial no. to identify tess ctrl progs, never re-used */
339 };
340
341
342 /** Subclass of Mesa tessellation evaluation program */
343 struct brw_tess_eval_program {
344 struct gl_tess_eval_program program;
345 unsigned id; /**< serial no. to identify tess eval progs, never re-used */
346 };
347
348
349 /** Subclass of Mesa geometry program */
350 struct brw_geometry_program {
351 struct gl_geometry_program program;
352 unsigned id; /**< serial no. to identify geom progs, never re-used */
353 };
354
355
356 /** Subclass of Mesa fragment program */
357 struct brw_fragment_program {
358 struct gl_fragment_program program;
359 GLuint id; /**< serial no. to identify frag progs, never re-used */
360 };
361
362
363 /** Subclass of Mesa compute program */
364 struct brw_compute_program {
365 struct gl_compute_program program;
366 unsigned id; /**< serial no. to identify compute progs, never re-used */
367 };
368
369
370 struct brw_shader {
371 struct gl_linked_shader base;
372
373 bool compiled_once;
374 };
375
376 /**
377 * Bitmask indicating which fragment shader inputs represent varyings (and
378 * hence have to be delivered to the fragment shader by the SF/SBE stage).
379 */
380 #define BRW_FS_VARYING_INPUT_MASK \
381 (BITFIELD64_RANGE(0, VARYING_SLOT_MAX) & \
382 ~VARYING_BIT_POS & ~VARYING_BIT_FACE)
383
384
385 /*
386 * Mapping of VUE map slots to interpolation modes.
387 */
388 struct interpolation_mode_map {
389 unsigned char mode[BRW_VARYING_SLOT_COUNT];
390 };
391
392 static inline bool brw_any_flat_varyings(struct interpolation_mode_map *map)
393 {
394 for (int i = 0; i < BRW_VARYING_SLOT_COUNT; i++)
395 if (map->mode[i] == INTERP_QUALIFIER_FLAT)
396 return true;
397
398 return false;
399 }
400
401 static inline bool brw_any_noperspective_varyings(struct interpolation_mode_map *map)
402 {
403 for (int i = 0; i < BRW_VARYING_SLOT_COUNT; i++)
404 if (map->mode[i] == INTERP_QUALIFIER_NOPERSPECTIVE)
405 return true;
406
407 return false;
408 }
409
410
411 struct brw_sf_prog_data {
412 GLuint urb_read_length;
413 GLuint total_grf;
414
415 /* Each vertex may have upto 12 attributes, 4 components each,
416 * except WPOS which requires only 2. (11*4 + 2) == 44 ==> 11
417 * rows.
418 *
419 * Actually we use 4 for each, so call it 12 rows.
420 */
421 GLuint urb_entry_size;
422 };
423
424
425 /**
426 * We always program SF to start reading at an offset of 1 (2 varying slots)
427 * from the start of the vertex URB entry. This causes it to skip:
428 * - VARYING_SLOT_PSIZ and BRW_VARYING_SLOT_NDC on gen4-5
429 * - VARYING_SLOT_PSIZ and VARYING_SLOT_POS on gen6+
430 */
431 #define BRW_SF_URB_ENTRY_READ_OFFSET 1
432
433
434 struct brw_clip_prog_data {
435 GLuint curb_read_length; /* user planes? */
436 GLuint clip_mode;
437 GLuint urb_read_length;
438 GLuint total_grf;
439 };
440
441 struct brw_ff_gs_prog_data {
442 GLuint urb_read_length;
443 GLuint total_grf;
444
445 /**
446 * Gen6 transform feedback: Amount by which the streaming vertex buffer
447 * indices should be incremented each time the GS is invoked.
448 */
449 unsigned svbi_postincrement_value;
450 };
451
452 /** Number of texture sampler units */
453 #define BRW_MAX_TEX_UNIT 32
454
455 /** Max number of render targets in a shader */
456 #define BRW_MAX_DRAW_BUFFERS 8
457
458 /** Max number of UBOs in a shader */
459 #define BRW_MAX_UBO 14
460
461 /** Max number of SSBOs in a shader */
462 #define BRW_MAX_SSBO 12
463
464 /** Max number of atomic counter buffer objects in a shader */
465 #define BRW_MAX_ABO 16
466
467 /** Max number of image uniforms in a shader */
468 #define BRW_MAX_IMAGES 32
469
470 /**
471 * Max number of binding table entries used for stream output.
472 *
473 * From the OpenGL 3.0 spec, table 6.44 (Transform Feedback State), the
474 * minimum value of MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS is 64.
475 *
476 * On Gen6, the size of transform feedback data is limited not by the number
477 * of components but by the number of binding table entries we set aside. We
478 * use one binding table entry for a float, one entry for a vector, and one
479 * entry per matrix column. Since the only way we can communicate our
480 * transform feedback capabilities to the client is via
481 * MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS, we need to plan for the
482 * worst case, in which all the varyings are floats, so we use up one binding
483 * table entry per component. Therefore we need to set aside at least 64
484 * binding table entries for use by transform feedback.
485 *
486 * Note: since we don't currently pack varyings, it is currently impossible
487 * for the client to actually use up all of these binding table entries--if
488 * all of their varyings were floats, they would run out of varying slots and
489 * fail to link. But that's a bug, so it seems prudent to go ahead and
490 * allocate the number of binding table entries we will need once the bug is
491 * fixed.
492 */
493 #define BRW_MAX_SOL_BINDINGS 64
494
495 /** Maximum number of actual buffers used for stream output */
496 #define BRW_MAX_SOL_BUFFERS 4
497
498 #define BRW_MAX_SURFACES (BRW_MAX_DRAW_BUFFERS + \
499 BRW_MAX_TEX_UNIT * 2 + /* normal, gather */ \
500 BRW_MAX_UBO + \
501 BRW_MAX_SSBO + \
502 BRW_MAX_ABO + \
503 BRW_MAX_IMAGES + \
504 2 + /* shader time, pull constants */ \
505 1 /* cs num work groups */)
506
507 #define SURF_INDEX_GEN6_SOL_BINDING(t) (t)
508
509 /**
510 * Stride in bytes between shader_time entries.
511 *
512 * We separate entries by a cacheline to reduce traffic between EUs writing to
513 * different entries.
514 */
515 #define SHADER_TIME_STRIDE 64
516
517 struct brw_cache_item {
518 /**
519 * Effectively part of the key, cache_id identifies what kind of state
520 * buffer is involved, and also which dirty flag should set.
521 */
522 enum brw_cache_id cache_id;
523 /** 32-bit hash of the key data */
524 GLuint hash;
525 GLuint key_size; /* for variable-sized keys */
526 GLuint aux_size;
527 const void *key;
528
529 uint32_t offset;
530 uint32_t size;
531
532 struct brw_cache_item *next;
533 };
534
535
536 struct brw_cache {
537 struct brw_context *brw;
538
539 struct brw_cache_item **items;
540 drm_intel_bo *bo;
541 GLuint size, n_items;
542
543 uint32_t next_offset;
544 bool bo_used_by_gpu;
545 };
546
547
548 /* Considered adding a member to this struct to document which flags
549 * an update might raise so that ordering of the state atoms can be
550 * checked or derived at runtime. Dropped the idea in favor of having
551 * a debug mode where the state is monitored for flags which are
552 * raised that have already been tested against.
553 */
554 struct brw_tracked_state {
555 struct brw_state_flags dirty;
556 void (*emit)( struct brw_context *brw );
557 };
558
559 enum shader_time_shader_type {
560 ST_NONE,
561 ST_VS,
562 ST_TCS,
563 ST_TES,
564 ST_GS,
565 ST_FS8,
566 ST_FS16,
567 ST_CS,
568 };
569
570 struct brw_vertex_buffer {
571 /** Buffer object containing the uploaded vertex data */
572 drm_intel_bo *bo;
573 uint32_t offset;
574 uint32_t size;
575 /** Byte stride between elements in the uploaded array */
576 GLuint stride;
577 GLuint step_rate;
578 };
579 struct brw_vertex_element {
580 const struct gl_client_array *glarray;
581
582 int buffer;
583
584 /** Offset of the first element within the buffer object */
585 unsigned int offset;
586 };
587
588 struct brw_query_object {
589 struct gl_query_object Base;
590
591 /** Last query BO associated with this query. */
592 drm_intel_bo *bo;
593
594 /** Last index in bo with query data for this object. */
595 int last_index;
596
597 /** True if we know the batch has been flushed since we ended the query. */
598 bool flushed;
599 };
600
601 enum brw_gpu_ring {
602 UNKNOWN_RING,
603 RENDER_RING,
604 BLT_RING,
605 };
606
607 struct intel_batchbuffer {
608 /** Current batchbuffer being queued up. */
609 drm_intel_bo *bo;
610 /** Last BO submitted to the hardware. Used for glFinish(). */
611 drm_intel_bo *last_bo;
612
613 #ifdef DEBUG
614 uint16_t emit, total;
615 #endif
616 uint16_t reserved_space;
617 uint32_t *map_next;
618 uint32_t *map;
619 uint32_t *cpu_map;
620 #define BATCH_SZ (8192*sizeof(uint32_t))
621
622 uint32_t state_batch_offset;
623 enum brw_gpu_ring ring;
624 bool needs_sol_reset;
625 bool state_base_address_emitted;
626
627 struct {
628 uint32_t *map_next;
629 int reloc_count;
630 } saved;
631 };
632
633 #define MAX_GS_INPUT_VERTICES 6
634
635 #define BRW_MAX_XFB_STREAMS 4
636
637 struct brw_transform_feedback_object {
638 struct gl_transform_feedback_object base;
639
640 /** A buffer to hold SO_WRITE_OFFSET(n) values while paused. */
641 drm_intel_bo *offset_bo;
642
643 /** If true, SO_WRITE_OFFSET(n) should be reset to zero at next use. */
644 bool zero_offsets;
645
646 /** The most recent primitive mode (GL_TRIANGLES/GL_POINTS/GL_LINES). */
647 GLenum primitive_mode;
648
649 /**
650 * Count of primitives generated during this transform feedback operation.
651 * @{
652 */
653 uint64_t prims_generated[BRW_MAX_XFB_STREAMS];
654 drm_intel_bo *prim_count_bo;
655 unsigned prim_count_buffer_index; /**< in number of uint64_t units */
656 /** @} */
657
658 /**
659 * Number of vertices written between last Begin/EndTransformFeedback().
660 *
661 * Used to implement DrawTransformFeedback().
662 */
663 uint64_t vertices_written[BRW_MAX_XFB_STREAMS];
664 bool vertices_written_valid;
665 };
666
667 /**
668 * Data shared between each programmable stage in the pipeline (vs, gs, and
669 * wm).
670 */
671 struct brw_stage_state
672 {
673 gl_shader_stage stage;
674 struct brw_stage_prog_data *prog_data;
675
676 /**
677 * Optional scratch buffer used to store spilled register values and
678 * variably-indexed GRF arrays.
679 *
680 * The contents of this buffer are short-lived so the same memory can be
681 * re-used at will for multiple shader programs (executed by the same fixed
682 * function). However reusing a scratch BO for which shader invocations
683 * are still in flight with a per-thread scratch slot size other than the
684 * original can cause threads with different scratch slot size and FFTID
685 * (which may be executed in parallel depending on the shader stage and
686 * hardware generation) to map to an overlapping region of the scratch
687 * space, which can potentially lead to mutual scratch space corruption.
688 * For that reason if you borrow this scratch buffer you should only be
689 * using the slot size given by the \c per_thread_scratch member below,
690 * unless you're taking additional measures to synchronize thread execution
691 * across slot size changes.
692 */
693 drm_intel_bo *scratch_bo;
694
695 /**
696 * Scratch slot size allocated for each thread in the buffer object given
697 * by \c scratch_bo.
698 */
699 uint32_t per_thread_scratch;
700
701 /** Offset in the program cache to the program */
702 uint32_t prog_offset;
703
704 /** Offset in the batchbuffer to Gen4-5 pipelined state (VS/WM/GS_STATE). */
705 uint32_t state_offset;
706
707 uint32_t push_const_offset; /* Offset in the batchbuffer */
708 int push_const_size; /* in 256-bit register increments */
709
710 /* Binding table: pointers to SURFACE_STATE entries. */
711 uint32_t bind_bo_offset;
712 uint32_t surf_offset[BRW_MAX_SURFACES];
713
714 /** SAMPLER_STATE count and table offset */
715 uint32_t sampler_count;
716 uint32_t sampler_offset;
717 };
718
719 enum brw_predicate_state {
720 /* The first two states are used if we can determine whether to draw
721 * without having to look at the values in the query object buffer. This
722 * will happen if there is no conditional render in progress, if the query
723 * object is already completed or if something else has already added
724 * samples to the preliminary result such as via a BLT command.
725 */
726 BRW_PREDICATE_STATE_RENDER,
727 BRW_PREDICATE_STATE_DONT_RENDER,
728 /* In this case whether to draw or not depends on the result of an
729 * MI_PREDICATE command so the predicate enable bit needs to be checked.
730 */
731 BRW_PREDICATE_STATE_USE_BIT
732 };
733
734 struct shader_times;
735
736 struct brw_l3_config;
737
738 /**
739 * brw_context is derived from gl_context.
740 */
741 struct brw_context
742 {
743 struct gl_context ctx; /**< base class, must be first field */
744
745 struct
746 {
747 void (*update_texture_surface)(struct gl_context *ctx,
748 unsigned unit,
749 uint32_t *surf_offset,
750 bool for_gather, uint32_t plane);
751 uint32_t (*update_renderbuffer_surface)(struct brw_context *brw,
752 struct gl_renderbuffer *rb,
753 bool layered, unsigned unit,
754 uint32_t surf_index);
755
756 void (*emit_texture_surface_state)(struct brw_context *brw,
757 struct intel_mipmap_tree *mt,
758 GLenum target,
759 unsigned min_layer,
760 unsigned max_layer,
761 unsigned min_level,
762 unsigned max_level,
763 unsigned format,
764 unsigned swizzle,
765 uint32_t *surf_offset,
766 int surf_index,
767 bool rw, bool for_gather);
768 void (*emit_null_surface_state)(struct brw_context *brw,
769 unsigned width,
770 unsigned height,
771 unsigned samples,
772 uint32_t *out_offset);
773
774 /**
775 * Send the appropriate state packets to configure depth, stencil, and
776 * HiZ buffers (i965+ only)
777 */
778 void (*emit_depth_stencil_hiz)(struct brw_context *brw,
779 struct intel_mipmap_tree *depth_mt,
780 uint32_t depth_offset,
781 uint32_t depthbuffer_format,
782 uint32_t depth_surface_type,
783 struct intel_mipmap_tree *stencil_mt,
784 bool hiz, bool separate_stencil,
785 uint32_t width, uint32_t height,
786 uint32_t tile_x, uint32_t tile_y);
787
788 } vtbl;
789
790 dri_bufmgr *bufmgr;
791
792 drm_intel_context *hw_ctx;
793
794 /** BO for post-sync nonzero writes for gen6 workaround. */
795 drm_intel_bo *workaround_bo;
796 uint8_t pipe_controls_since_last_cs_stall;
797
798 /**
799 * Set of drm_intel_bo * that have been rendered to within this batchbuffer
800 * and would need flushing before being used from another cache domain that
801 * isn't coherent with it (i.e. the sampler).
802 */
803 struct set *render_cache;
804
805 /**
806 * Number of resets observed in the system at context creation.
807 *
808 * This is tracked in the context so that we can determine that another
809 * reset has occurred.
810 */
811 uint32_t reset_count;
812
813 struct intel_batchbuffer batch;
814 bool no_batch_wrap;
815
816 struct {
817 drm_intel_bo *bo;
818 uint32_t next_offset;
819 } upload;
820
821 /**
822 * Set if rendering has occurred to the drawable's front buffer.
823 *
824 * This is used in the DRI2 case to detect that glFlush should also copy
825 * the contents of the fake front buffer to the real front buffer.
826 */
827 bool front_buffer_dirty;
828
829 /** Framerate throttling: @{ */
830 drm_intel_bo *throttle_batch[2];
831
832 /* Limit the number of outstanding SwapBuffers by waiting for an earlier
833 * frame of rendering to complete. This gives a very precise cap to the
834 * latency between input and output such that rendering never gets more
835 * than a frame behind the user. (With the caveat that we technically are
836 * not using the SwapBuffers itself as a barrier but the first batch
837 * submitted afterwards, which may be immediately prior to the next
838 * SwapBuffers.)
839 */
840 bool need_swap_throttle;
841
842 /** General throttling, not caught by throttling between SwapBuffers */
843 bool need_flush_throttle;
844 /** @} */
845
846 GLuint stats_wm;
847
848 /**
849 * drirc options:
850 * @{
851 */
852 bool no_rast;
853 bool always_flush_batch;
854 bool always_flush_cache;
855 bool disable_throttling;
856 bool precompile;
857 bool dual_color_blend_by_location;
858
859 driOptionCache optionCache;
860 /** @} */
861
862 GLuint primitive; /**< Hardware primitive, such as _3DPRIM_TRILIST. */
863
864 GLenum reduced_primitive;
865
866 /**
867 * Set if we're either a debug context or the INTEL_DEBUG=perf environment
868 * variable is set, this is the flag indicating to do expensive work that
869 * might lead to a perf_debug() call.
870 */
871 bool perf_debug;
872
873 uint32_t max_gtt_map_object_size;
874
875 int gen;
876 int gt;
877
878 bool is_g4x;
879 bool is_baytrail;
880 bool is_haswell;
881 bool is_cherryview;
882 bool is_broxton;
883
884 bool has_hiz;
885 bool has_separate_stencil;
886 bool must_use_separate_stencil;
887 bool has_llc;
888 bool has_swizzling;
889 bool has_surface_tile_offset;
890 bool has_compr4;
891 bool has_negative_rhw_bug;
892 bool has_pln;
893 bool no_simd8;
894 bool use_rep_send;
895 bool use_resource_streamer;
896
897 /**
898 * Whether LRI can be used to write register values from the batch buffer.
899 */
900 bool can_do_pipelined_register_writes;
901
902 /**
903 * Some versions of Gen hardware don't do centroid interpolation correctly
904 * on unlit pixels, causing incorrect values for derivatives near triangle
905 * edges. Enabling this flag causes the fragment shader to use
906 * non-centroid interpolation for unlit pixels, at the expense of two extra
907 * fragment shader instructions.
908 */
909 bool needs_unlit_centroid_workaround;
910
911 struct isl_device isl_dev;
912
913 GLuint NewGLState;
914 struct {
915 struct brw_state_flags pipelines[BRW_NUM_PIPELINES];
916 } state;
917
918 enum brw_pipeline last_pipeline;
919
920 struct brw_cache cache;
921
922 /** IDs for meta stencil blit shader programs. */
923 struct gl_shader_program *meta_stencil_blit_programs[2];
924
925 /* Whether a meta-operation is in progress. */
926 bool meta_in_progress;
927
928 /* Whether the last depth/stencil packets were both NULL. */
929 bool no_depth_or_stencil;
930
931 /* The last PMA stall bits programmed. */
932 uint32_t pma_stall_bits;
933
934 struct {
935 struct {
936 /** The value of gl_BaseVertex for the current _mesa_prim. */
937 int gl_basevertex;
938
939 /** The value of gl_BaseInstance for the current _mesa_prim. */
940 int gl_baseinstance;
941 } params;
942
943 /**
944 * Buffer and offset used for GL_ARB_shader_draw_parameters
945 * (for now, only gl_BaseVertex).
946 */
947 drm_intel_bo *draw_params_bo;
948 uint32_t draw_params_offset;
949
950 /**
951 * The value of gl_DrawID for the current _mesa_prim. This always comes
952 * in from it's own vertex buffer since it's not part of the indirect
953 * draw parameters.
954 */
955 int gl_drawid;
956 drm_intel_bo *draw_id_bo;
957 uint32_t draw_id_offset;
958 } draw;
959
960 struct {
961 /**
962 * For gl_NumWorkGroups: If num_work_groups_bo is non NULL, then it is
963 * an indirect call, and num_work_groups_offset is valid. Otherwise,
964 * num_work_groups is set based on glDispatchCompute.
965 */
966 drm_intel_bo *num_work_groups_bo;
967 GLintptr num_work_groups_offset;
968 const GLuint *num_work_groups;
969 } compute;
970
971 struct {
972 struct brw_vertex_element inputs[VERT_ATTRIB_MAX];
973 struct brw_vertex_buffer buffers[VERT_ATTRIB_MAX];
974
975 struct brw_vertex_element *enabled[VERT_ATTRIB_MAX];
976 GLuint nr_enabled;
977 GLuint nr_buffers;
978
979 /* Summary of size and varying of active arrays, so we can check
980 * for changes to this state:
981 */
982 bool index_bounds_valid;
983 unsigned int min_index, max_index;
984
985 /* Offset from start of vertex buffer so we can avoid redefining
986 * the same VB packed over and over again.
987 */
988 unsigned int start_vertex_bias;
989
990 /**
991 * Certain vertex attribute formats aren't natively handled by the
992 * hardware and require special VS code to fix up their values.
993 *
994 * These bitfields indicate which workarounds are needed.
995 */
996 uint8_t attrib_wa_flags[VERT_ATTRIB_MAX];
997 } vb;
998
999 struct {
1000 /**
1001 * Index buffer for this draw_prims call.
1002 *
1003 * Updates are signaled by BRW_NEW_INDICES.
1004 */
1005 const struct _mesa_index_buffer *ib;
1006
1007 /* Updates are signaled by BRW_NEW_INDEX_BUFFER. */
1008 drm_intel_bo *bo;
1009 uint32_t size;
1010 GLuint type;
1011
1012 /* Offset to index buffer index to use in CMD_3D_PRIM so that we can
1013 * avoid re-uploading the IB packet over and over if we're actually
1014 * referencing the same index buffer.
1015 */
1016 unsigned int start_vertex_offset;
1017 } ib;
1018
1019 /* Active vertex program:
1020 */
1021 const struct gl_vertex_program *vertex_program;
1022 const struct gl_geometry_program *geometry_program;
1023 const struct gl_tess_ctrl_program *tess_ctrl_program;
1024 const struct gl_tess_eval_program *tess_eval_program;
1025 const struct gl_fragment_program *fragment_program;
1026 const struct gl_compute_program *compute_program;
1027
1028 /**
1029 * Number of samples in ctx->DrawBuffer, updated by BRW_NEW_NUM_SAMPLES so
1030 * that we don't have to reemit that state every time we change FBOs.
1031 */
1032 int num_samples;
1033
1034 /**
1035 * Platform specific constants containing the maximum number of threads
1036 * for each pipeline stage.
1037 */
1038 unsigned max_vs_threads;
1039 unsigned max_hs_threads;
1040 unsigned max_ds_threads;
1041 unsigned max_gs_threads;
1042 unsigned max_wm_threads;
1043 unsigned max_cs_threads;
1044
1045 /* BRW_NEW_URB_ALLOCATIONS:
1046 */
1047 struct {
1048 GLuint vsize; /* vertex size plus header in urb registers */
1049 GLuint gsize; /* GS output size in urb registers */
1050 GLuint hsize; /* Tessellation control output size in urb registers */
1051 GLuint dsize; /* Tessellation evaluation output size in urb registers */
1052 GLuint csize; /* constant buffer size in urb registers */
1053 GLuint sfsize; /* setup data size in urb registers */
1054
1055 bool constrained;
1056
1057 GLuint min_vs_entries; /* Minimum number of VS entries */
1058 GLuint max_vs_entries; /* Maximum number of VS entries */
1059 GLuint max_hs_entries; /* Maximum number of HS entries */
1060 GLuint max_ds_entries; /* Maximum number of DS entries */
1061 GLuint max_gs_entries; /* Maximum number of GS entries */
1062
1063 GLuint nr_vs_entries;
1064 GLuint nr_hs_entries;
1065 GLuint nr_ds_entries;
1066 GLuint nr_gs_entries;
1067 GLuint nr_clip_entries;
1068 GLuint nr_sf_entries;
1069 GLuint nr_cs_entries;
1070
1071 GLuint vs_start;
1072 GLuint hs_start;
1073 GLuint ds_start;
1074 GLuint gs_start;
1075 GLuint clip_start;
1076 GLuint sf_start;
1077 GLuint cs_start;
1078 /**
1079 * URB size in the current configuration. The units this is expressed
1080 * in are somewhat inconsistent, see brw_device_info::urb::size.
1081 *
1082 * FINISHME: Represent the URB size consistently in KB on all platforms.
1083 */
1084 GLuint size;
1085
1086 /* True if the most recently sent _3DSTATE_URB message allocated
1087 * URB space for the GS.
1088 */
1089 bool gs_present;
1090
1091 /* True if the most recently sent _3DSTATE_URB message allocated
1092 * URB space for the HS and DS.
1093 */
1094 bool tess_present;
1095 } urb;
1096
1097
1098 /* BRW_NEW_CURBE_OFFSETS:
1099 */
1100 struct {
1101 GLuint wm_start; /**< pos of first wm const in CURBE buffer */
1102 GLuint wm_size; /**< number of float[4] consts, multiple of 16 */
1103 GLuint clip_start;
1104 GLuint clip_size;
1105 GLuint vs_start;
1106 GLuint vs_size;
1107 GLuint total_size;
1108
1109 /**
1110 * Pointer to the (intel_upload.c-generated) BO containing the uniforms
1111 * for upload to the CURBE.
1112 */
1113 drm_intel_bo *curbe_bo;
1114 /** Offset within curbe_bo of space for current curbe entry */
1115 GLuint curbe_offset;
1116 } curbe;
1117
1118 /**
1119 * Layout of vertex data exiting the geometry portion of the pipleine.
1120 * This comes from the last enabled shader stage (GS, DS, or VS).
1121 *
1122 * BRW_NEW_VUE_MAP_GEOM_OUT is flagged when the VUE map changes.
1123 */
1124 struct brw_vue_map vue_map_geom_out;
1125
1126 struct {
1127 struct brw_stage_state base;
1128 struct brw_vs_prog_data *prog_data;
1129 } vs;
1130
1131 struct {
1132 struct brw_stage_state base;
1133 struct brw_tcs_prog_data *prog_data;
1134
1135 /**
1136 * True if the 3DSTATE_HS command most recently emitted to the 3D
1137 * pipeline enabled the HS; false otherwise.
1138 */
1139 bool enabled;
1140 } tcs;
1141
1142 struct {
1143 struct brw_stage_state base;
1144 struct brw_tes_prog_data *prog_data;
1145
1146 /**
1147 * True if the 3DSTATE_DS command most recently emitted to the 3D
1148 * pipeline enabled the DS; false otherwise.
1149 */
1150 bool enabled;
1151 } tes;
1152
1153 struct {
1154 struct brw_stage_state base;
1155 struct brw_gs_prog_data *prog_data;
1156
1157 /**
1158 * True if the 3DSTATE_GS command most recently emitted to the 3D
1159 * pipeline enabled the GS; false otherwise.
1160 */
1161 bool enabled;
1162 } gs;
1163
1164 struct {
1165 struct brw_ff_gs_prog_data *prog_data;
1166
1167 bool prog_active;
1168 /** Offset in the program cache to the CLIP program pre-gen6 */
1169 uint32_t prog_offset;
1170 uint32_t state_offset;
1171
1172 uint32_t bind_bo_offset;
1173 /**
1174 * Surface offsets for the binding table. We only need surfaces to
1175 * implement transform feedback so BRW_MAX_SOL_BINDINGS is all that we
1176 * need in this case.
1177 */
1178 uint32_t surf_offset[BRW_MAX_SOL_BINDINGS];
1179 } ff_gs;
1180
1181 struct {
1182 struct brw_clip_prog_data *prog_data;
1183
1184 /** Offset in the program cache to the CLIP program pre-gen6 */
1185 uint32_t prog_offset;
1186
1187 /* Offset in the batch to the CLIP state on pre-gen6. */
1188 uint32_t state_offset;
1189
1190 /* As of gen6, this is the offset in the batch to the CLIP VP,
1191 * instead of vp_bo.
1192 */
1193 uint32_t vp_offset;
1194 } clip;
1195
1196
1197 struct {
1198 struct brw_sf_prog_data *prog_data;
1199
1200 /** Offset in the program cache to the CLIP program pre-gen6 */
1201 uint32_t prog_offset;
1202 uint32_t state_offset;
1203 uint32_t vp_offset;
1204 bool viewport_transform_enable;
1205 } sf;
1206
1207 struct {
1208 struct brw_stage_state base;
1209 struct brw_wm_prog_data *prog_data;
1210
1211 GLuint render_surf;
1212
1213 /**
1214 * Buffer object used in place of multisampled null render targets on
1215 * Gen6. See brw_emit_null_surface_state().
1216 */
1217 drm_intel_bo *multisampled_null_render_target_bo;
1218 uint32_t fast_clear_op;
1219
1220 float offset_clamp;
1221 } wm;
1222
1223 struct {
1224 struct brw_stage_state base;
1225 struct brw_cs_prog_data *prog_data;
1226 } cs;
1227
1228 /* RS hardware binding table */
1229 struct {
1230 drm_intel_bo *bo;
1231 uint32_t next_offset;
1232 } hw_bt_pool;
1233
1234 struct {
1235 uint32_t state_offset;
1236 uint32_t blend_state_offset;
1237 uint32_t depth_stencil_state_offset;
1238 uint32_t vp_offset;
1239 } cc;
1240
1241 struct {
1242 struct brw_query_object *obj;
1243 bool begin_emitted;
1244 } query;
1245
1246 struct {
1247 enum brw_predicate_state state;
1248 bool supported;
1249 } predicate;
1250
1251 struct {
1252 /** A map from pipeline statistics counter IDs to MMIO addresses. */
1253 const int *statistics_registers;
1254
1255 /** The number of active monitors using OA counters. */
1256 unsigned oa_users;
1257
1258 /**
1259 * A buffer object storing OA counter snapshots taken at the start and
1260 * end of each batch (creating "bookends" around the batch).
1261 */
1262 drm_intel_bo *bookend_bo;
1263
1264 /** The number of snapshots written to bookend_bo. */
1265 int bookend_snapshots;
1266
1267 /**
1268 * An array of monitors whose results haven't yet been assembled based on
1269 * the data in buffer objects.
1270 *
1271 * These may be active, or have already ended. However, the results
1272 * have not been requested.
1273 */
1274 struct brw_perf_monitor_object **unresolved;
1275 int unresolved_elements;
1276 int unresolved_array_size;
1277
1278 /**
1279 * Mapping from a uint32_t offset within an OA snapshot to the ID of
1280 * the counter which MI_REPORT_PERF_COUNT stores there.
1281 */
1282 const int *oa_snapshot_layout;
1283
1284 /** Number of 32-bit entries in a hardware counter snapshot. */
1285 int entries_per_oa_snapshot;
1286 } perfmon;
1287
1288 int num_atoms[BRW_NUM_PIPELINES];
1289 const struct brw_tracked_state render_atoms[76];
1290 const struct brw_tracked_state compute_atoms[11];
1291
1292 /* If (INTEL_DEBUG & DEBUG_BATCH) */
1293 struct {
1294 uint32_t offset;
1295 uint32_t size;
1296 enum aub_state_struct_type type;
1297 int index;
1298 } *state_batch_list;
1299 int state_batch_count;
1300
1301 uint32_t render_target_format[MESA_FORMAT_COUNT];
1302 bool format_supported_as_render_target[MESA_FORMAT_COUNT];
1303
1304 /* Interpolation modes, one byte per vue slot.
1305 * Used Gen4/5 by the clip|sf|wm stages. Ignored on Gen6+.
1306 */
1307 struct interpolation_mode_map interpolation_mode;
1308
1309 /* PrimitiveRestart */
1310 struct {
1311 bool in_progress;
1312 bool enable_cut_index;
1313 } prim_restart;
1314
1315 /** Computed depth/stencil/hiz state from the current attached
1316 * renderbuffers, valid only during the drawing state upload loop after
1317 * brw_workaround_depthstencil_alignment().
1318 */
1319 struct {
1320 struct intel_mipmap_tree *depth_mt;
1321 struct intel_mipmap_tree *stencil_mt;
1322
1323 /* Inter-tile (page-aligned) byte offsets. */
1324 uint32_t depth_offset, hiz_offset, stencil_offset;
1325 /* Intra-tile x,y offsets for drawing to depth/stencil/hiz */
1326 uint32_t tile_x, tile_y;
1327 } depthstencil;
1328
1329 uint32_t num_instances;
1330 int basevertex;
1331 int baseinstance;
1332
1333 struct {
1334 const struct brw_l3_config *config;
1335 } l3;
1336
1337 struct {
1338 drm_intel_bo *bo;
1339 const char **names;
1340 int *ids;
1341 enum shader_time_shader_type *types;
1342 struct shader_times *cumulative;
1343 int num_entries;
1344 int max_entries;
1345 double report_time;
1346 } shader_time;
1347
1348 struct brw_fast_clear_state *fast_clear_state;
1349
1350 __DRIcontext *driContext;
1351 struct intel_screen *intelScreen;
1352 };
1353
1354 /*======================================================================
1355 * brw_vtbl.c
1356 */
1357 void brwInitVtbl( struct brw_context *brw );
1358
1359 /* brw_clear.c */
1360 extern void intelInitClearFuncs(struct dd_function_table *functions);
1361
1362 /*======================================================================
1363 * brw_context.c
1364 */
1365 extern const char *const brw_vendor_string;
1366
1367 extern const char *
1368 brw_get_renderer_string(const struct intel_screen *intelScreen);
1369
1370 enum {
1371 DRI_CONF_BO_REUSE_DISABLED,
1372 DRI_CONF_BO_REUSE_ALL
1373 };
1374
1375 void intel_update_renderbuffers(__DRIcontext *context,
1376 __DRIdrawable *drawable);
1377 void intel_prepare_render(struct brw_context *brw);
1378
1379 void intel_resolve_for_dri2_flush(struct brw_context *brw,
1380 __DRIdrawable *drawable);
1381
1382 GLboolean brwCreateContext(gl_api api,
1383 const struct gl_config *mesaVis,
1384 __DRIcontext *driContextPriv,
1385 unsigned major_version,
1386 unsigned minor_version,
1387 uint32_t flags,
1388 bool notify_reset,
1389 unsigned *error,
1390 void *sharedContextPrivate);
1391
1392 /*======================================================================
1393 * brw_misc_state.c
1394 */
1395 void
1396 brw_meta_resolve_color(struct brw_context *brw,
1397 struct intel_mipmap_tree *mt);
1398
1399 /*======================================================================
1400 * brw_misc_state.c
1401 */
1402 void brw_get_depthstencil_tile_masks(struct intel_mipmap_tree *depth_mt,
1403 uint32_t depth_level,
1404 uint32_t depth_layer,
1405 struct intel_mipmap_tree *stencil_mt,
1406 uint32_t *out_tile_mask_x,
1407 uint32_t *out_tile_mask_y);
1408 void brw_workaround_depthstencil_alignment(struct brw_context *brw,
1409 GLbitfield clear_mask);
1410
1411 /* brw_object_purgeable.c */
1412 void brw_init_object_purgeable_functions(struct dd_function_table *functions);
1413
1414 /*======================================================================
1415 * brw_queryobj.c
1416 */
1417 void brw_init_common_queryobj_functions(struct dd_function_table *functions);
1418 void gen4_init_queryobj_functions(struct dd_function_table *functions);
1419 void brw_emit_query_begin(struct brw_context *brw);
1420 void brw_emit_query_end(struct brw_context *brw);
1421 void brw_query_counter(struct gl_context *ctx, struct gl_query_object *q);
1422 bool brw_is_query_pipelined(struct brw_query_object *query);
1423
1424 /** gen6_queryobj.c */
1425 void gen6_init_queryobj_functions(struct dd_function_table *functions);
1426 void brw_write_timestamp(struct brw_context *brw, drm_intel_bo *bo, int idx);
1427 void brw_write_depth_count(struct brw_context *brw, drm_intel_bo *bo, int idx);
1428
1429 /** hsw_queryobj.c */
1430 void hsw_init_queryobj_functions(struct dd_function_table *functions);
1431
1432 /** brw_conditional_render.c */
1433 void brw_init_conditional_render_functions(struct dd_function_table *functions);
1434 bool brw_check_conditional_render(struct brw_context *brw);
1435
1436 /** intel_batchbuffer.c */
1437 void brw_load_register_mem(struct brw_context *brw,
1438 uint32_t reg,
1439 drm_intel_bo *bo,
1440 uint32_t read_domains, uint32_t write_domain,
1441 uint32_t offset);
1442 void brw_load_register_mem64(struct brw_context *brw,
1443 uint32_t reg,
1444 drm_intel_bo *bo,
1445 uint32_t read_domains, uint32_t write_domain,
1446 uint32_t offset);
1447 void brw_store_register_mem32(struct brw_context *brw,
1448 drm_intel_bo *bo, uint32_t reg, uint32_t offset);
1449 void brw_store_register_mem64(struct brw_context *brw,
1450 drm_intel_bo *bo, uint32_t reg, uint32_t offset);
1451 void brw_load_register_imm32(struct brw_context *brw,
1452 uint32_t reg, uint32_t imm);
1453 void brw_load_register_imm64(struct brw_context *brw,
1454 uint32_t reg, uint64_t imm);
1455 void brw_load_register_reg(struct brw_context *brw, uint32_t src,
1456 uint32_t dest);
1457 void brw_load_register_reg64(struct brw_context *brw, uint32_t src,
1458 uint32_t dest);
1459 void brw_store_data_imm32(struct brw_context *brw, drm_intel_bo *bo,
1460 uint32_t offset, uint32_t imm);
1461 void brw_store_data_imm64(struct brw_context *brw, drm_intel_bo *bo,
1462 uint32_t offset, uint64_t imm);
1463
1464 /*======================================================================
1465 * brw_state_dump.c
1466 */
1467 void brw_debug_batch(struct brw_context *brw);
1468 void brw_annotate_aub(struct brw_context *brw);
1469
1470 /*======================================================================
1471 * intel_tex_validate.c
1472 */
1473 void brw_validate_textures( struct brw_context *brw );
1474
1475
1476 /*======================================================================
1477 * brw_program.c
1478 */
1479 static inline bool
1480 key_debug(struct brw_context *brw, const char *name, int a, int b)
1481 {
1482 if (a != b) {
1483 perf_debug(" %s %d->%d\n", name, a, b);
1484 return true;
1485 }
1486 return false;
1487 }
1488
1489 void brwInitFragProgFuncs( struct dd_function_table *functions );
1490
1491 /* Per-thread scratch space is a power-of-two multiple of 1KB. */
1492 static inline int
1493 brw_get_scratch_size(int size)
1494 {
1495 return MAX2(1024, util_next_power_of_two(size));
1496 }
1497 void brw_get_scratch_bo(struct brw_context *brw,
1498 drm_intel_bo **scratch_bo, int size);
1499 void brw_alloc_stage_scratch(struct brw_context *brw,
1500 struct brw_stage_state *stage_state,
1501 unsigned per_thread_size,
1502 unsigned thread_count);
1503 void brw_init_shader_time(struct brw_context *brw);
1504 int brw_get_shader_time_index(struct brw_context *brw,
1505 struct gl_shader_program *shader_prog,
1506 struct gl_program *prog,
1507 enum shader_time_shader_type type);
1508 void brw_collect_and_report_shader_time(struct brw_context *brw);
1509 void brw_destroy_shader_time(struct brw_context *brw);
1510
1511 /* brw_urb.c
1512 */
1513 void brw_upload_urb_fence(struct brw_context *brw);
1514
1515 /* brw_curbe.c
1516 */
1517 void brw_upload_cs_urb_state(struct brw_context *brw);
1518
1519 /* brw_fs_reg_allocate.cpp
1520 */
1521 void brw_fs_alloc_reg_sets(struct brw_compiler *compiler);
1522
1523 /* brw_vec4_reg_allocate.cpp */
1524 void brw_vec4_alloc_reg_set(struct brw_compiler *compiler);
1525
1526 /* brw_disasm.c */
1527 int brw_disassemble_inst(FILE *file, const struct brw_device_info *devinfo,
1528 struct brw_inst *inst, bool is_compacted);
1529
1530 /* brw_vs.c */
1531 gl_clip_plane *brw_select_clip_planes(struct gl_context *ctx);
1532
1533 /* brw_draw_upload.c */
1534 unsigned brw_get_vertex_surface_type(struct brw_context *brw,
1535 const struct gl_client_array *glarray);
1536
1537 static inline unsigned
1538 brw_get_index_type(GLenum type)
1539 {
1540 assert((type == GL_UNSIGNED_BYTE)
1541 || (type == GL_UNSIGNED_SHORT)
1542 || (type == GL_UNSIGNED_INT));
1543
1544 /* The possible values for type are GL_UNSIGNED_BYTE (0x1401),
1545 * GL_UNSIGNED_SHORT (0x1403), and GL_UNSIGNED_INT (0x1405) which we want
1546 * to map to scale factors of 0, 1, and 2, respectively. These scale
1547 * factors are then left-shfited by 8 to be in the correct position in the
1548 * CMD_INDEX_BUFFER packet.
1549 *
1550 * Subtracting 0x1401 gives 0, 2, and 4. Shifting left by 7 afterwards
1551 * gives 0x00000000, 0x00000100, and 0x00000200. These just happen to be
1552 * the values the need to be written in the CMD_INDEX_BUFFER packet.
1553 */
1554 return (type - 0x1401) << 7;
1555 }
1556
1557 void brw_prepare_vertices(struct brw_context *brw);
1558
1559 /* brw_wm_surface_state.c */
1560 void brw_init_surface_formats(struct brw_context *brw);
1561 void brw_create_constant_surface(struct brw_context *brw,
1562 drm_intel_bo *bo,
1563 uint32_t offset,
1564 uint32_t size,
1565 uint32_t *out_offset);
1566 void brw_create_buffer_surface(struct brw_context *brw,
1567 drm_intel_bo *bo,
1568 uint32_t offset,
1569 uint32_t size,
1570 uint32_t *out_offset);
1571 void brw_update_buffer_texture_surface(struct gl_context *ctx,
1572 unsigned unit,
1573 uint32_t *surf_offset);
1574 void
1575 brw_update_sol_surface(struct brw_context *brw,
1576 struct gl_buffer_object *buffer_obj,
1577 uint32_t *out_offset, unsigned num_vector_components,
1578 unsigned stride_dwords, unsigned offset_dwords);
1579 void brw_upload_ubo_surfaces(struct brw_context *brw,
1580 struct gl_linked_shader *shader,
1581 struct brw_stage_state *stage_state,
1582 struct brw_stage_prog_data *prog_data);
1583 void brw_upload_abo_surfaces(struct brw_context *brw,
1584 struct gl_linked_shader *shader,
1585 struct brw_stage_state *stage_state,
1586 struct brw_stage_prog_data *prog_data);
1587 void brw_upload_image_surfaces(struct brw_context *brw,
1588 struct gl_linked_shader *shader,
1589 struct brw_stage_state *stage_state,
1590 struct brw_stage_prog_data *prog_data);
1591
1592 /* brw_surface_formats.c */
1593 bool brw_render_target_supported(struct brw_context *brw,
1594 struct gl_renderbuffer *rb);
1595 uint32_t brw_depth_format(struct brw_context *brw, mesa_format format);
1596
1597 /* brw_performance_monitor.c */
1598 void brw_init_performance_monitors(struct brw_context *brw);
1599 void brw_dump_perf_monitors(struct brw_context *brw);
1600 void brw_perf_monitor_new_batch(struct brw_context *brw);
1601 void brw_perf_monitor_finish_batch(struct brw_context *brw);
1602
1603 /* intel_buffer_objects.c */
1604 int brw_bo_map(struct brw_context *brw, drm_intel_bo *bo, int write_enable,
1605 const char *bo_name);
1606 int brw_bo_map_gtt(struct brw_context *brw, drm_intel_bo *bo,
1607 const char *bo_name);
1608
1609 /* intel_extensions.c */
1610 extern void intelInitExtensions(struct gl_context *ctx);
1611
1612 /* intel_state.c */
1613 extern int intel_translate_shadow_compare_func(GLenum func);
1614 extern int intel_translate_compare_func(GLenum func);
1615 extern int intel_translate_stencil_op(GLenum op);
1616 extern int intel_translate_logic_op(GLenum opcode);
1617
1618 /* intel_syncobj.c */
1619 void intel_init_syncobj_functions(struct dd_function_table *functions);
1620
1621 /* gen6_sol.c */
1622 struct gl_transform_feedback_object *
1623 brw_new_transform_feedback(struct gl_context *ctx, GLuint name);
1624 void
1625 brw_delete_transform_feedback(struct gl_context *ctx,
1626 struct gl_transform_feedback_object *obj);
1627 void
1628 brw_begin_transform_feedback(struct gl_context *ctx, GLenum mode,
1629 struct gl_transform_feedback_object *obj);
1630 void
1631 brw_end_transform_feedback(struct gl_context *ctx,
1632 struct gl_transform_feedback_object *obj);
1633 GLsizei
1634 brw_get_transform_feedback_vertex_count(struct gl_context *ctx,
1635 struct gl_transform_feedback_object *obj,
1636 GLuint stream);
1637
1638 /* gen7_sol_state.c */
1639 void
1640 gen7_begin_transform_feedback(struct gl_context *ctx, GLenum mode,
1641 struct gl_transform_feedback_object *obj);
1642 void
1643 gen7_end_transform_feedback(struct gl_context *ctx,
1644 struct gl_transform_feedback_object *obj);
1645 void
1646 gen7_pause_transform_feedback(struct gl_context *ctx,
1647 struct gl_transform_feedback_object *obj);
1648 void
1649 gen7_resume_transform_feedback(struct gl_context *ctx,
1650 struct gl_transform_feedback_object *obj);
1651
1652 /* hsw_sol.c */
1653 void
1654 hsw_begin_transform_feedback(struct gl_context *ctx, GLenum mode,
1655 struct gl_transform_feedback_object *obj);
1656 void
1657 hsw_end_transform_feedback(struct gl_context *ctx,
1658 struct gl_transform_feedback_object *obj);
1659 void
1660 hsw_pause_transform_feedback(struct gl_context *ctx,
1661 struct gl_transform_feedback_object *obj);
1662 void
1663 hsw_resume_transform_feedback(struct gl_context *ctx,
1664 struct gl_transform_feedback_object *obj);
1665
1666 /* brw_blorp_blit.cpp */
1667 GLbitfield
1668 brw_blorp_framebuffer(struct brw_context *brw,
1669 struct gl_framebuffer *readFb,
1670 struct gl_framebuffer *drawFb,
1671 GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
1672 GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
1673 GLbitfield mask, GLenum filter);
1674
1675 bool
1676 brw_blorp_copytexsubimage(struct brw_context *brw,
1677 struct gl_renderbuffer *src_rb,
1678 struct gl_texture_image *dst_image,
1679 int slice,
1680 int srcX0, int srcY0,
1681 int dstX0, int dstY0,
1682 int width, int height);
1683
1684 /* gen6_multisample_state.c */
1685 unsigned
1686 gen6_determine_sample_mask(struct brw_context *brw);
1687
1688 void
1689 gen6_emit_3dstate_multisample(struct brw_context *brw,
1690 unsigned num_samples);
1691 void
1692 gen6_emit_3dstate_sample_mask(struct brw_context *brw, unsigned mask);
1693 void
1694 gen6_get_sample_position(struct gl_context *ctx,
1695 struct gl_framebuffer *fb,
1696 GLuint index,
1697 GLfloat *result);
1698 void
1699 gen6_set_sample_maps(struct gl_context *ctx);
1700
1701 /* gen8_multisample_state.c */
1702 void gen8_emit_3dstate_multisample(struct brw_context *brw, unsigned num_samp);
1703 void gen8_emit_3dstate_sample_pattern(struct brw_context *brw);
1704
1705 /* gen7_urb.c */
1706 void
1707 gen7_emit_push_constant_state(struct brw_context *brw, unsigned vs_size,
1708 unsigned hs_size, unsigned ds_size,
1709 unsigned gs_size, unsigned fs_size);
1710
1711 void
1712 gen7_upload_urb(struct brw_context *brw, unsigned vs_size,
1713 bool gs_present, bool tess_present);
1714
1715 /* brw_reset.c */
1716 extern GLenum
1717 brw_get_graphics_reset_status(struct gl_context *ctx);
1718 void
1719 brw_check_for_reset(struct brw_context *brw);
1720
1721 /* brw_compute.c */
1722 extern void
1723 brw_init_compute_functions(struct dd_function_table *functions);
1724
1725 /*======================================================================
1726 * Inline conversion functions. These are better-typed than the
1727 * macros used previously:
1728 */
1729 static inline struct brw_context *
1730 brw_context( struct gl_context *ctx )
1731 {
1732 return (struct brw_context *)ctx;
1733 }
1734
1735 static inline struct brw_vertex_program *
1736 brw_vertex_program(struct gl_vertex_program *p)
1737 {
1738 return (struct brw_vertex_program *) p;
1739 }
1740
1741 static inline const struct brw_vertex_program *
1742 brw_vertex_program_const(const struct gl_vertex_program *p)
1743 {
1744 return (const struct brw_vertex_program *) p;
1745 }
1746
1747 static inline struct brw_tess_ctrl_program *
1748 brw_tess_ctrl_program(struct gl_tess_ctrl_program *p)
1749 {
1750 return (struct brw_tess_ctrl_program *) p;
1751 }
1752
1753 static inline struct brw_tess_eval_program *
1754 brw_tess_eval_program(struct gl_tess_eval_program *p)
1755 {
1756 return (struct brw_tess_eval_program *) p;
1757 }
1758
1759 static inline struct brw_geometry_program *
1760 brw_geometry_program(struct gl_geometry_program *p)
1761 {
1762 return (struct brw_geometry_program *) p;
1763 }
1764
1765 static inline struct brw_fragment_program *
1766 brw_fragment_program(struct gl_fragment_program *p)
1767 {
1768 return (struct brw_fragment_program *) p;
1769 }
1770
1771 static inline const struct brw_fragment_program *
1772 brw_fragment_program_const(const struct gl_fragment_program *p)
1773 {
1774 return (const struct brw_fragment_program *) p;
1775 }
1776
1777 static inline struct brw_compute_program *
1778 brw_compute_program(struct gl_compute_program *p)
1779 {
1780 return (struct brw_compute_program *) p;
1781 }
1782
1783 /**
1784 * Pre-gen6, the register file of the EUs was shared between threads,
1785 * and each thread used some subset allocated on a 16-register block
1786 * granularity. The unit states wanted these block counts.
1787 */
1788 static inline int
1789 brw_register_blocks(int reg_count)
1790 {
1791 return ALIGN(reg_count, 16) / 16 - 1;
1792 }
1793
1794 static inline uint32_t
1795 brw_program_reloc(struct brw_context *brw, uint32_t state_offset,
1796 uint32_t prog_offset)
1797 {
1798 if (brw->gen >= 5) {
1799 /* Using state base address. */
1800 return prog_offset;
1801 }
1802
1803 drm_intel_bo_emit_reloc(brw->batch.bo,
1804 state_offset,
1805 brw->cache.bo,
1806 prog_offset,
1807 I915_GEM_DOMAIN_INSTRUCTION, 0);
1808
1809 return brw->cache.bo->offset64 + prog_offset;
1810 }
1811
1812 bool brw_do_cubemap_normalize(struct exec_list *instructions);
1813 bool brw_lower_texture_gradients(struct brw_context *brw,
1814 struct exec_list *instructions);
1815 bool brw_do_lower_unnormalized_offset(struct exec_list *instructions);
1816
1817 extern const char * const conditional_modifier[16];
1818 extern const char *const pred_ctrl_align16[16];
1819
1820 void
1821 brw_emit_depthbuffer(struct brw_context *brw);
1822
1823 void
1824 brw_emit_depth_stencil_hiz(struct brw_context *brw,
1825 struct intel_mipmap_tree *depth_mt,
1826 uint32_t depth_offset, uint32_t depthbuffer_format,
1827 uint32_t depth_surface_type,
1828 struct intel_mipmap_tree *stencil_mt,
1829 bool hiz, bool separate_stencil,
1830 uint32_t width, uint32_t height,
1831 uint32_t tile_x, uint32_t tile_y);
1832
1833 void
1834 gen6_emit_depth_stencil_hiz(struct brw_context *brw,
1835 struct intel_mipmap_tree *depth_mt,
1836 uint32_t depth_offset, uint32_t depthbuffer_format,
1837 uint32_t depth_surface_type,
1838 struct intel_mipmap_tree *stencil_mt,
1839 bool hiz, bool separate_stencil,
1840 uint32_t width, uint32_t height,
1841 uint32_t tile_x, uint32_t tile_y);
1842
1843 void
1844 gen7_emit_depth_stencil_hiz(struct brw_context *brw,
1845 struct intel_mipmap_tree *depth_mt,
1846 uint32_t depth_offset, uint32_t depthbuffer_format,
1847 uint32_t depth_surface_type,
1848 struct intel_mipmap_tree *stencil_mt,
1849 bool hiz, bool separate_stencil,
1850 uint32_t width, uint32_t height,
1851 uint32_t tile_x, uint32_t tile_y);
1852 void
1853 gen8_emit_depth_stencil_hiz(struct brw_context *brw,
1854 struct intel_mipmap_tree *depth_mt,
1855 uint32_t depth_offset, uint32_t depthbuffer_format,
1856 uint32_t depth_surface_type,
1857 struct intel_mipmap_tree *stencil_mt,
1858 bool hiz, bool separate_stencil,
1859 uint32_t width, uint32_t height,
1860 uint32_t tile_x, uint32_t tile_y);
1861
1862 void gen8_hiz_exec(struct brw_context *brw, struct intel_mipmap_tree *mt,
1863 unsigned int level, unsigned int layer, enum gen6_hiz_op op);
1864
1865 uint32_t get_hw_prim_for_gl_prim(int mode);
1866
1867 void
1868 gen6_upload_push_constants(struct brw_context *brw,
1869 const struct gl_program *prog,
1870 const struct brw_stage_prog_data *prog_data,
1871 struct brw_stage_state *stage_state,
1872 enum aub_state_struct_type type);
1873
1874 bool
1875 gen9_use_linear_1d_layout(const struct brw_context *brw,
1876 const struct intel_mipmap_tree *mt);
1877
1878 /* brw_pipe_control.c */
1879 int brw_init_pipe_control(struct brw_context *brw,
1880 const struct brw_device_info *info);
1881 void brw_fini_pipe_control(struct brw_context *brw);
1882
1883 void brw_emit_pipe_control_flush(struct brw_context *brw, uint32_t flags);
1884 void brw_emit_pipe_control_write(struct brw_context *brw, uint32_t flags,
1885 drm_intel_bo *bo, uint32_t offset,
1886 uint32_t imm_lower, uint32_t imm_upper);
1887 void brw_emit_mi_flush(struct brw_context *brw);
1888 void brw_emit_post_sync_nonzero_flush(struct brw_context *brw);
1889 void brw_emit_depth_stall_flushes(struct brw_context *brw);
1890 void gen7_emit_vs_workaround_flush(struct brw_context *brw);
1891 void gen7_emit_cs_stall_flush(struct brw_context *brw);
1892
1893 /* brw_queryformat.c */
1894 void brw_query_internal_format(struct gl_context *ctx, GLenum target,
1895 GLenum internalFormat, GLenum pname,
1896 GLint *params);
1897
1898 #ifdef __cplusplus
1899 }
1900 #endif
1901
1902 #endif