[965] Convert brw_draw_upload to managing dri_bos, not gl_buffer_objects.
[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 (http://www.tungstengraphics.com) 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 <keith@tungstengraphics.com>
30 */
31
32
33 #ifndef BRWCONTEXT_INC
34 #define BRWCONTEXT_INC
35
36 #include "intel_context.h"
37 #include "brw_structs.h"
38 #include "imports.h"
39
40
41 /* Glossary:
42 *
43 * URB - uniform resource buffer. A mid-sized buffer which is
44 * partitioned between the fixed function units and used for passing
45 * values (vertices, primitives, constants) between them.
46 *
47 * CURBE - constant URB entry. An urb region (entry) used to hold
48 * constant values which the fixed function units can be instructed to
49 * preload into the GRF when spawining a thread.
50 *
51 * VUE - vertex URB entry. An urb entry holding a vertex and usually
52 * a vertex header. The header contains control information and
53 * things like primitive type, Begin/end flags and clip codes.
54 *
55 * PUE - primitive URB entry. An urb entry produced by the setup (SF)
56 * unit holding rasterization and interpolation parameters.
57 *
58 * GRF - general register file. One of several register files
59 * addressable by programmed threads. The inputs (r0, payload, curbe,
60 * urb) of the thread are preloaded to this area before the thread is
61 * spawned. The registers are individually 8 dwords wide and suitable
62 * for general usage. Registers holding thread input values are not
63 * special and may be overwritten.
64 *
65 * MRF - message register file. Threads communicate (and terminate)
66 * by sending messages. Message parameters are placed in contigous
67 * MRF registers. All program output is via these messages. URB
68 * entries are populated by sending a message to the shared URB
69 * function containing the new data, together with a control word,
70 * often an unmodified copy of R0.
71 *
72 * R0 - GRF register 0. Typically holds control information used when
73 * sending messages to other threads.
74 *
75 * EU or GEN4 EU: The name of the programmable subsystem of the
76 * i965 hardware. Threads are executed by the EU, the registers
77 * described above are part of the EU architecture.
78 *
79 * Fixed function units:
80 *
81 * CS - Command streamer. Notional first unit, little software
82 * interaction. Holds the URB entries used for constant data, ie the
83 * CURBEs.
84 *
85 * VF/VS - Vertex Fetch / Vertex Shader. The fixed function part of
86 * this unit is responsible for pulling vertices out of vertex buffers
87 * in vram and injecting them into the processing pipe as VUEs. If
88 * enabled, it first passes them to a VS thread which is a good place
89 * for the driver to implement any active vertex shader.
90 *
91 * GS - Geometry Shader. This corresponds to a new DX10 concept. If
92 * enabled, incoming strips etc are passed to GS threads in individual
93 * line/triangle/point units. The GS thread may perform arbitary
94 * computation and emit whatever primtives with whatever vertices it
95 * chooses. This makes GS an excellent place to implement GL's
96 * unfilled polygon modes, though of course it is capable of much
97 * more. Additionally, GS is used to translate away primitives not
98 * handled by latter units, including Quads and Lineloops.
99 *
100 * CS - Clipper. Mesa's clipping algorithms are imported to run on
101 * this unit. The fixed function part performs cliptesting against
102 * the 6 fixed clipplanes and makes descisions on whether or not the
103 * incoming primitive needs to be passed to a thread for clipping.
104 * User clip planes are handled via cooperation with the VS thread.
105 *
106 * SF - Strips Fans or Setup: Triangles are prepared for
107 * rasterization. Interpolation coefficients are calculated.
108 * Flatshading and two-side lighting usually performed here.
109 *
110 * WM - Windower. Interpolation of vertex attributes performed here.
111 * Fragment shader implemented here. SIMD aspects of EU taken full
112 * advantage of, as pixels are processed in blocks of 16.
113 *
114 * CC - Color Calculator. No EU threads associated with this unit.
115 * Handles blending and (presumably) depth and stencil testing.
116 */
117
118 #define BRW_FALLBACK_TEXTURE 0x1
119 #define BRW_MAX_CURBE (32*16)
120
121 struct brw_context;
122
123 #define BRW_NEW_URB_FENCE 0x1
124 #define BRW_NEW_FRAGMENT_PROGRAM 0x2
125 #define BRW_NEW_VERTEX_PROGRAM 0x4
126 #define BRW_NEW_INPUT_DIMENSIONS 0x8
127 #define BRW_NEW_CURBE_OFFSETS 0x10
128 #define BRW_NEW_REDUCED_PRIMITIVE 0x20
129 #define BRW_NEW_PRIMITIVE 0x40
130 #define BRW_NEW_CONTEXT 0x80
131 #define BRW_NEW_WM_INPUT_DIMENSIONS 0x100
132 #define BRW_NEW_INPUT_VARYING 0x200
133 #define BRW_NEW_TNL_PROGRAM 0x400
134 #define BRW_NEW_PSP 0x800
135 #define BRW_NEW_METAOPS 0x1000
136 #define BRW_NEW_FENCE 0x2000
137 #define BRW_NEW_LOCK 0x4000
138 /**
139 * Used for any batch entry with a relocated pointer that will be used
140 * by any 3D rendering.
141 */
142 #define BRW_NEW_BATCH 0x8000
143 /** brw->depth_region updated */
144 #define BRW_NEW_DEPTH_BUFFER 0x10000
145
146 struct brw_state_flags {
147 /** State update flags signalled by mesa internals */
148 GLuint mesa;
149 /** State update flags signalled by brw_state_cache.c searches */
150 GLuint cache;
151 /**
152 * State update flags signalled as the result of brw_tracked_state updates
153 */
154 GLuint brw;
155 };
156
157 struct brw_vertex_program {
158 struct gl_vertex_program program;
159 GLuint id;
160 GLuint param_state; /* flags indicating state tracked by params */
161 };
162
163
164
165 struct brw_fragment_program {
166 struct gl_fragment_program program;
167 GLuint id;
168 GLuint param_state; /* flags indicating state tracked by params */
169 };
170
171
172
173
174 /* Data about a particular attempt to compile a program. Note that
175 * there can be many of these, each in a different GL state
176 * corresponding to a different brw_wm_prog_key struct, with different
177 * compiled programs:
178 */
179 struct brw_wm_prog_data {
180 GLuint curb_read_length;
181 GLuint urb_read_length;
182
183 GLuint first_curbe_grf;
184 GLuint total_grf;
185 GLuint total_scratch;
186
187 GLuint nr_params;
188 GLboolean error;
189
190 /* Pointer to tracked values (only valid once
191 * _mesa_load_state_parameters has been called at runtime).
192 */
193 const GLfloat *param[BRW_MAX_CURBE];
194 };
195
196 struct brw_sf_prog_data {
197 GLuint urb_read_length;
198 GLuint total_grf;
199
200 /* Each vertex may have upto 12 attributes, 4 components each,
201 * except WPOS which requires only 2. (11*4 + 2) == 44 ==> 11
202 * rows.
203 *
204 * Actually we use 4 for each, so call it 12 rows.
205 */
206 GLuint urb_entry_size;
207 };
208
209 struct brw_clip_prog_data {
210 GLuint curb_read_length; /* user planes? */
211 GLuint clip_mode;
212 GLuint urb_read_length;
213 GLuint total_grf;
214 };
215
216 struct brw_gs_prog_data {
217 GLuint urb_read_length;
218 GLuint total_grf;
219 };
220
221 struct brw_vs_prog_data {
222 GLuint curb_read_length;
223 GLuint urb_read_length;
224 GLuint total_grf;
225 GLuint outputs_written;
226
227 GLuint inputs_read;
228
229 /* Used for calculating urb partitions:
230 */
231 GLuint urb_entry_size;
232 };
233
234
235 /* Size == 0 if output either not written, or always [0,0,0,1]
236 */
237 struct brw_vs_ouput_sizes {
238 GLubyte output_size[VERT_RESULT_MAX];
239 };
240
241
242 #define BRW_MAX_TEX_UNIT 8
243 #define BRW_WM_MAX_SURF BRW_MAX_TEX_UNIT + 1
244
245 enum brw_cache_id {
246 BRW_CC_VP,
247 BRW_CC_UNIT,
248 BRW_WM_PROG,
249 BRW_SAMPLER_DEFAULT_COLOR,
250 BRW_SAMPLER,
251 BRW_WM_UNIT,
252 BRW_SF_PROG,
253 BRW_SF_VP,
254 BRW_SF_UNIT,
255 BRW_VS_UNIT,
256 BRW_VS_PROG,
257 BRW_GS_UNIT,
258 BRW_GS_PROG,
259 BRW_CLIP_VP,
260 BRW_CLIP_UNIT,
261 BRW_CLIP_PROG,
262 BRW_SS_SURFACE,
263 BRW_SS_SURF_BIND,
264
265 BRW_MAX_CACHE
266 };
267
268 struct brw_cache_item {
269 /**
270 * Effectively part of the key, cache_id identifies what kind of state
271 * buffer is involved, and also which brw->state.dirty.cache flag should
272 * be set when this cache item is chosen.
273 */
274 enum brw_cache_id cache_id;
275 /** 32-bit hash of the key data */
276 GLuint hash;
277 GLuint key_size; /* for variable-sized keys */
278 const void *key;
279 dri_bo **reloc_bufs;
280 GLuint nr_reloc_bufs;
281
282 dri_bo *bo;
283 GLuint data_size;
284
285 struct brw_cache_item *next;
286 };
287
288
289
290 struct brw_cache {
291 struct brw_context *brw;
292
293 struct brw_cache_item **items;
294 GLuint size, n_items;
295
296 GLuint key_size[BRW_MAX_CACHE]; /* for fixed-size keys */
297 GLuint aux_size[BRW_MAX_CACHE];
298 char *name[BRW_MAX_CACHE];
299
300 /* Record of the last BOs chosen for each cache_id. Used to set
301 * brw->state.dirty.cache when a new cache item is chosen.
302 */
303 dri_bo *last_bo[BRW_MAX_CACHE];
304 };
305
306
307
308 struct brw_state_pointers {
309 struct gl_colorbuffer_attrib *Color;
310 struct gl_depthbuffer_attrib *Depth;
311 struct gl_fog_attrib *Fog;
312 struct gl_hint_attrib *Hint;
313 struct gl_light_attrib *Light;
314 struct gl_line_attrib *Line;
315 struct gl_point_attrib *Point;
316 struct gl_polygon_attrib *Polygon;
317 GLuint *PolygonStipple;
318 struct gl_scissor_attrib *Scissor;
319 struct gl_stencil_attrib *Stencil;
320 struct gl_texture_attrib *Texture;
321 struct gl_transform_attrib *Transform;
322 struct gl_viewport_attrib *Viewport;
323 struct gl_vertex_program_state *VertexProgram;
324 struct gl_fragment_program_state *FragmentProgram;
325 };
326
327 /* Considered adding a member to this struct to document which flags
328 * an update might raise so that ordering of the state atoms can be
329 * checked or derived at runtime. Dropped the idea in favor of having
330 * a debug mode where the state is monitored for flags which are
331 * raised that have already been tested against.
332 */
333 struct brw_tracked_state {
334 struct brw_state_flags dirty;
335 void (*update)( struct brw_context *brw );
336 };
337
338 /* Flags for brw->state.cache.
339 */
340 #define CACHE_NEW_CC_VP (1<<BRW_CC_VP)
341 #define CACHE_NEW_CC_UNIT (1<<BRW_CC_UNIT)
342 #define CACHE_NEW_WM_PROG (1<<BRW_WM_PROG)
343 #define CACHE_NEW_SAMPLER_DEFAULT_COLOR (1<<BRW_SAMPLER_DEFAULT_COLOR)
344 #define CACHE_NEW_SAMPLER (1<<BRW_SAMPLER)
345 #define CACHE_NEW_WM_UNIT (1<<BRW_WM_UNIT)
346 #define CACHE_NEW_SF_PROG (1<<BRW_SF_PROG)
347 #define CACHE_NEW_SF_VP (1<<BRW_SF_VP)
348 #define CACHE_NEW_SF_UNIT (1<<BRW_SF_UNIT)
349 #define CACHE_NEW_VS_UNIT (1<<BRW_VS_UNIT)
350 #define CACHE_NEW_VS_PROG (1<<BRW_VS_PROG)
351 #define CACHE_NEW_GS_UNIT (1<<BRW_GS_UNIT)
352 #define CACHE_NEW_GS_PROG (1<<BRW_GS_PROG)
353 #define CACHE_NEW_CLIP_VP (1<<BRW_CLIP_VP)
354 #define CACHE_NEW_CLIP_UNIT (1<<BRW_CLIP_UNIT)
355 #define CACHE_NEW_CLIP_PROG (1<<BRW_CLIP_PROG)
356 #define CACHE_NEW_SURFACE (1<<BRW_SS_SURFACE)
357 #define CACHE_NEW_SURF_BIND (1<<BRW_SS_SURF_BIND)
358
359 struct brw_cached_batch_item {
360 struct header *header;
361 GLuint sz;
362 struct brw_cached_batch_item *next;
363 };
364
365
366
367 /* Protect against a future where VERT_ATTRIB_MAX > 32. Wouldn't life
368 * be easier if C allowed arrays of packed elements?
369 */
370 #define ATTRIB_BIT_DWORDS ((VERT_ATTRIB_MAX+31)/32)
371
372 struct brw_vertex_element {
373 const struct gl_client_array *glarray;
374
375 /** Size of a complete element */
376 GLuint element_size;
377 /** Number of uploaded elements for this input. */
378 GLuint count;
379 /** Byte stride between elements in the uploaded array */
380 GLuint stride;
381 /** Offset of the first element within the buffer object */
382 unsigned int offset;
383 /** Buffer object containing the uploaded vertex data */
384 dri_bo *bo;
385 };
386
387
388
389 struct brw_vertex_info {
390 GLuint varying; /* varying:1[VERT_ATTRIB_MAX] */
391 GLuint sizes[ATTRIB_BIT_DWORDS * 2]; /* sizes:2[VERT_ATTRIB_MAX] */
392 };
393
394
395
396
397 /* Cache for TNL programs.
398 */
399 struct brw_tnl_cache_item {
400 GLuint hash;
401 void *key;
402 void *data;
403 struct brw_tnl_cache_item *next;
404 };
405
406 struct brw_tnl_cache {
407 struct brw_tnl_cache_item **items;
408 GLuint size, n_items;
409 };
410
411
412
413 struct brw_context
414 {
415 struct intel_context intel;
416 GLuint primitive;
417
418 GLboolean emit_state_always;
419 GLboolean wrap;
420 GLboolean tmp_fallback;
421 GLboolean no_batch_wrap;
422
423 struct {
424 struct brw_state_flags dirty;
425 struct brw_tracked_state **atoms;
426 GLuint nr_atoms;
427
428
429 struct intel_region *draw_region;
430 struct intel_region *depth_region;
431 } state;
432
433 struct brw_state_pointers attribs;
434 struct brw_cache cache;
435 struct brw_cached_batch_item *cached_batch_items;
436
437 struct {
438 struct brw_vertex_element inputs[VERT_ATTRIB_MAX];
439
440 #define BRW_NR_UPLOAD_BUFS 17
441 #define BRW_UPLOAD_INIT_SIZE (128*1024)
442
443 struct {
444 dri_bo *bo;
445 GLuint offset;
446 } upload;
447
448 /* Summary of size and varying of active arrays, so we can check
449 * for changes to this state:
450 */
451 struct brw_vertex_info info;
452 } vb;
453
454 struct {
455 /* Will be allocated on demand if needed.
456 */
457 struct brw_state_pointers attribs;
458 struct gl_vertex_program *vp;
459 struct gl_fragment_program *fp, *fp_tex;
460
461 struct gl_buffer_object *vbo;
462
463 struct intel_region *saved_draw_region;
464 struct intel_region *saved_depth_region;
465
466 GLuint restore_draw_buffers[MAX_DRAW_BUFFERS];
467 GLuint restore_num_draw_buffers;
468
469 struct gl_fragment_program *restore_fp;
470
471 GLboolean active;
472 } metaops;
473
474 /* Track fixed function t&l in a vertex program:
475 */
476 struct gl_vertex_program *tnl_program;
477 struct brw_tnl_cache tnl_program_cache;
478
479 /* Active vertex program:
480 */
481 const struct gl_vertex_program *vertex_program;
482 const struct gl_fragment_program *fragment_program;
483
484
485 /* For populating the gtt:
486 */
487 GLuint next_free_page;
488
489
490 /* BRW_NEW_URB_ALLOCATIONS:
491 */
492 struct {
493 GLuint vsize; /* vertex size plus header in urb registers */
494 GLuint csize; /* constant buffer size in urb registers */
495 GLuint sfsize; /* setup data size in urb registers */
496
497 GLboolean constrained;
498
499 GLuint nr_vs_entries;
500 GLuint nr_gs_entries;
501 GLuint nr_clip_entries;
502 GLuint nr_sf_entries;
503 GLuint nr_cs_entries;
504
505 /* GLuint vs_size; */
506 /* GLuint gs_size; */
507 /* GLuint clip_size; */
508 /* GLuint sf_size; */
509 /* GLuint cs_size; */
510
511 GLuint vs_start;
512 GLuint gs_start;
513 GLuint clip_start;
514 GLuint sf_start;
515 GLuint cs_start;
516 } urb;
517
518
519 /* BRW_NEW_CURBE_OFFSETS:
520 */
521 struct {
522 GLuint wm_start;
523 GLuint wm_size;
524 GLuint clip_start;
525 GLuint clip_size;
526 GLuint vs_start;
527 GLuint vs_size;
528 GLuint total_size;
529
530 /* Dynamic tracker which changes to reflect the state referenced
531 * by active fp and vp program parameters:
532 */
533 struct brw_tracked_state tracked_state;
534
535 dri_bo *curbe_bo;
536 /** Offset within curbe_bo of space for current curbe entry */
537 GLuint curbe_offset;
538 /** Offset within curbe_bo of space for next curbe entry */
539 GLuint curbe_next_offset;
540
541 GLfloat *last_buf;
542 GLuint last_bufsz;
543 } curbe;
544
545 struct {
546 struct brw_vs_prog_data *prog_data;
547
548 dri_bo *prog_bo;
549 dri_bo *state_bo;
550 } vs;
551
552 struct {
553 struct brw_gs_prog_data *prog_data;
554
555 GLboolean prog_active;
556 dri_bo *prog_bo;
557 dri_bo *state_bo;
558 } gs;
559
560 struct {
561 struct brw_clip_prog_data *prog_data;
562
563 dri_bo *prog_bo;
564 dri_bo *state_bo;
565 dri_bo *vp_bo;
566 } clip;
567
568
569 struct {
570 struct brw_sf_prog_data *prog_data;
571
572 dri_bo *prog_bo;
573 dri_bo *state_bo;
574 dri_bo *vp_bo;
575 } sf;
576
577 struct {
578 struct brw_wm_prog_data *prog_data;
579 struct brw_wm_compile *compile_data;
580
581 /* Input sizes, calculated from active vertex program:
582 */
583 GLuint input_size_masks[4];
584
585 /** Array of surface default colors (texture border color) */
586 dri_bo *sdc_bo[BRW_MAX_TEX_UNIT];
587
588 GLuint render_surf;
589 GLuint nr_surfaces;
590
591 GLuint max_threads;
592 dri_bo *scratch_buffer;
593
594 GLuint sampler_count;
595 dri_bo *sampler_bo;
596
597 /** Binding table of pointers to surf_bo entries */
598 dri_bo *bind_bo;
599 dri_bo *surf_bo[BRW_WM_MAX_SURF];
600
601 dri_bo *prog_bo;
602 dri_bo *state_bo;
603 } wm;
604
605
606 struct {
607 dri_bo *prog_bo;
608 dri_bo *state_bo;
609 dri_bo *vp_bo;
610 } cc;
611
612
613 /* Used to give every program string a unique id
614 */
615 GLuint program_id;
616 };
617
618
619 #define BRW_PACKCOLOR8888(r,g,b,a) ((r<<24) | (g<<16) | (b<<8) | a)
620
621
622
623 /*======================================================================
624 * brw_vtbl.c
625 */
626 void brwInitVtbl( struct brw_context *brw );
627 void brw_do_flush( struct brw_context *brw,
628 GLuint flags );
629
630 /*======================================================================
631 * brw_context.c
632 */
633 GLboolean brwCreateContext( const __GLcontextModes *mesaVis,
634 __DRIcontextPrivate *driContextPriv,
635 void *sharedContextPrivate);
636
637
638
639 /*======================================================================
640 * brw_state.c
641 */
642 void brw_validate_state( struct brw_context *brw );
643 void brw_init_state( struct brw_context *brw );
644 void brw_destroy_state( struct brw_context *brw );
645
646
647 /*======================================================================
648 * brw_state_dump.c
649 */
650 void brw_debug_batch(struct intel_context *intel);
651
652 /*======================================================================
653 * brw_tex.c
654 */
655 void brwUpdateTextureState( struct intel_context *intel );
656 void brw_FrameBufferTexInit( struct brw_context *brw );
657 void brw_FrameBufferTexDestroy( struct brw_context *brw );
658 void brw_validate_textures( struct brw_context *brw );
659
660 /*======================================================================
661 * brw_metaops.c
662 */
663
664 void brw_init_metaops( struct brw_context *brw );
665 void brw_destroy_metaops( struct brw_context *brw );
666
667
668 /*======================================================================
669 * brw_program.c
670 */
671 void brwInitFragProgFuncs( struct dd_function_table *functions );
672
673
674 /* brw_urb.c
675 */
676 void brw_upload_urb_fence(struct brw_context *brw);
677
678 void brw_upload_constant_buffer_state(struct brw_context *brw);
679
680
681 /*======================================================================
682 * Inline conversion functions. These are better-typed than the
683 * macros used previously:
684 */
685 static inline struct brw_context *
686 brw_context( GLcontext *ctx )
687 {
688 return (struct brw_context *)ctx;
689 }
690
691 #endif
692