1 /* $Id: t_context.h,v 1.29 2001/06/28 17:34:14 keithw Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999-2001 Brian Paul All Rights Reserved.
9 * Permission is hereby granted, free of charge, to any person obtaining a
10 * copy of this software and associated documentation files (the "Software"),
11 * to deal in the Software without restriction, including without limitation
12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13 * and/or sell copies of the Software, and to permit persons to whom the
14 * Software is furnished to do so, subject to the following conditions:
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
23 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 * Keith Whitwell <keithw@valinux.com>
36 #include "math/m_matrix.h"
37 #include "math/m_vector.h"
38 #include "math/m_xform.h"
41 #define MAX_PIPELINE_STAGES 30
44 /* Numbers for sizing immediate structs.
46 #define IMM_MAX_COPIED_VERTS 3
47 #define IMM_MAXDATA (216 + IMM_MAX_COPIED_VERTS)
48 #define IMM_SIZE (IMM_MAXDATA + MAX_CLIPPED_VERTICES)
51 /* Values for IM->BeginState
53 #define VERT_BEGIN_0 0x1 /* glBegin (if initially inside beg/end) */
54 #define VERT_BEGIN_1 0x2 /* glBegin (if initially outside beg/end) */
55 #define VERT_ERROR_0 0x4 /* invalid_operation in initial state 0 */
56 #define VERT_ERROR_1 0x8 /* invalid_operation in initial state 1 */
59 /* Flags to be added to the primitive enum in VB->Primitive.
61 #define PRIM_MODE_MASK 0xff /* Extract the actual primitive */
62 #define PRIM_BEGIN 0x100 /* The prim starts here (not wrapped) */
63 #define PRIM_END 0x200 /* The prim ends in this VB (does not wrap) */
64 #define PRIM_PARITY 0x400 /* The prim wrapped on an odd number of verts */
65 #define PRIM_LAST 0x800 /* No more prims in the VB */
68 /* Flags that describe the inputs and outputs of pipeline stages, and
69 * the contents of a vertex-cassette.
71 * 5 spare flags, rearrangement of eval flags can secure at least 3
74 #define VERT_OBJ _NEW_ARRAY_VERTEX
75 #define VERT_RGBA _NEW_ARRAY_COLOR
76 #define VERT_NORM _NEW_ARRAY_NORMAL
77 #define VERT_INDEX _NEW_ARRAY_INDEX
78 #define VERT_EDGE _NEW_ARRAY_EDGEFLAG
79 #define VERT_SPEC_RGB _NEW_ARRAY_SECONDARYCOLOR
80 #define VERT_FOG_COORD _NEW_ARRAY_FOGCOORD
81 #define VERT_TEX0 _NEW_ARRAY_TEXCOORD_0
82 #define VERT_TEX1 _NEW_ARRAY_TEXCOORD_1
83 #define VERT_TEX2 _NEW_ARRAY_TEXCOORD_2
84 #define VERT_TEX3 _NEW_ARRAY_TEXCOORD_3
85 #define VERT_TEX4 _NEW_ARRAY_TEXCOORD_4
86 #define VERT_TEX5 _NEW_ARRAY_TEXCOORD_5
87 #define VERT_TEX6 _NEW_ARRAY_TEXCOORD_6
88 #define VERT_TEX7 _NEW_ARRAY_TEXCOORD_7
89 #define VERT_EVAL_C1 0x8000 /* imm only */
90 #define VERT_EVAL_C2 0x10000 /* imm only */
91 #define VERT_EVAL_P1 0x20000 /* imm only */
92 #define VERT_EVAL_P2 0x40000 /* imm only */
93 #define VERT_OBJ_3 0x80000 /* imm only */
94 #define VERT_OBJ_4 0x100000 /* imm only */
95 #define VERT_MATERIAL 0x200000 /* imm only, but tested in vb code */
96 #define VERT_ELT 0x400000 /* imm only */
97 #define VERT_BEGIN 0x800000 /* imm only, but tested in vb code */
98 #define VERT_END 0x1000000 /* imm only, but tested in vb code */
99 #define VERT_END_VB 0x2000000 /* imm only, but tested in vb code */
100 #define VERT_POINT_SIZE 0x4000000 /* vb only, could reuse a bit */
101 #define VERT_EYE VERT_BEGIN /* vb only, reuse imm bit */
102 #define VERT_CLIP VERT_END /* vb only, reuse imm bit*/
105 /* Flags for IM->TexCoordSize. Enough flags for 16 units.
107 #define TEX_0_SIZE_3 0x1
108 #define TEX_0_SIZE_4 0x1001
109 #define TEX_SIZE_3(unit) (TEX_0_SIZE_3<<unit)
110 #define TEX_SIZE_4(unit) (TEX_0_SIZE_4<<unit)
115 #define VERT_EVAL_ANY (VERT_EVAL_C1|VERT_EVAL_P1| \
116 VERT_EVAL_C2|VERT_EVAL_P2)
118 #define VERT_OBJ_23 (VERT_OBJ_3|VERT_OBJ)
119 #define VERT_OBJ_234 (VERT_OBJ_4|VERT_OBJ_23)
121 #define VERT_TEX0_SHIFT 11
123 #define VERT_TEX(i) (VERT_TEX0 << i)
125 #define VERT_TEX_ANY (VERT_TEX0 | \
134 #define VERT_FIXUP (VERT_TEX_ANY | \
142 #define VERT_CURRENT_DATA (VERT_FIXUP | \
145 #define VERT_DATA (VERT_TEX_ANY | \
158 /* KW: Represents everything that can take place between a begin and
159 * end, and can represent multiple begin/end pairs. Can be used to
160 * losslessly encode this information in display lists.
164 struct __GLcontextRec
*backref
;
165 GLuint id
, ref_count
;
167 /* This must be saved when immediates are shared in display lists.
169 GLuint CopyStart
, Start
, Count
;
170 GLuint LastData
; /* count or count+1 */
171 GLuint AndFlag
, OrFlag
;
172 GLuint TexSize
; /* keep track of texcoord sizes */
173 GLuint BeginState
, SavedBeginState
;
174 GLuint LastPrimitive
;
176 GLuint ArrayEltFlags
; /* precalc'ed for glArrayElt */
178 GLuint ArrayEltFlush
;
180 #define FLUSH_ELT_EAGER 0x1
181 #define FLUSH_ELT_LAZY 0x2
184 GLuint MaxTextureUnits
; /* precalc'ed for glMultiTexCoordARB */
186 /* Temporary values created when vertices are copied into the
187 * first 3 slots of the struct:
194 /* allocate storage for these on demand:
196 struct gl_material (*Material
)[2];
197 GLuint
*MaterialMask
;
199 GLuint MaterialOrMask
;
200 GLuint MaterialAndMask
;
202 GLfloat (*TexCoord
[MAX_TEXTURE_UNITS
])[4];
204 GLuint Primitive
[IMM_SIZE
]; /* BEGIN/END */
205 GLuint PrimitiveLength
[IMM_SIZE
]; /* BEGIN/END */
206 GLuint Flag
[IMM_SIZE
]; /* VERT_* flags */
207 GLfloat Color
[IMM_SIZE
][4];
208 GLfloat Obj
[IMM_SIZE
][4];
209 GLfloat Normal
[IMM_SIZE
][3];
210 GLfloat
*NormalLengthPtr
;
211 GLfloat TexCoord0
[IMM_SIZE
][4]; /* just VERT_TEX0 */
212 GLuint Elt
[IMM_SIZE
];
213 GLubyte EdgeFlag
[IMM_SIZE
];
214 GLuint Index
[IMM_SIZE
];
215 GLfloat SecondaryColor
[IMM_SIZE
][4];
216 GLfloat FogCoord
[IMM_SIZE
];
224 struct gl_client_array Color
;
225 struct gl_client_array SecondaryColor
;
227 GLvector1ub EdgeFlag
;
228 GLvector4f TexCoord
[MAX_TEXTURE_UNITS
];
234 typedef struct gl_material GLmaterial
;
236 /* Contains the current state of a running pipeline.
238 typedef struct vertex_buffer
240 /* Constant over life of the vertex_buffer.
244 /* Constant over the pipeline.
246 GLuint Count
; /* for everything except Elts */
247 GLuint FirstClipped
; /* temp verts for clipping */
248 GLuint FirstPrimitive
; /* usually zero */
250 /* Pointers to current data.
252 GLuint
*Elts
; /* VERT_ELT */
253 GLvector4f
*ObjPtr
; /* VERT_OBJ */
254 GLvector4f
*EyePtr
; /* VERT_EYE */
255 GLvector4f
*ClipPtr
; /* VERT_CLIP */
256 GLvector4f
*ProjectedClipPtr
; /* VERT_CLIP (2) */
257 GLubyte ClipOrMask
; /* VERT_CLIP (3) */
258 GLubyte
*ClipMask
; /* VERT_CLIP (4) */
259 GLvector3f
*NormalPtr
; /* VERT_NORM */
260 GLfloat
*NormalLengthPtr
; /* VERT_NORM */
261 GLboolean
*EdgeFlag
; /* VERT_EDGE */
262 GLvector4f
*TexCoordPtr
[MAX_TEXTURE_UNITS
]; /* VERT_TEX_0..n */
263 GLvector1ui
*IndexPtr
[2]; /* VERT_INDEX */
264 struct gl_client_array
*ColorPtr
[2]; /* VERT_RGBA */
265 struct gl_client_array
*SecondaryColorPtr
[2]; /* VERT_SPEC_RGB */
266 GLvector1f
*FogCoordPtr
; /* VERT_FOG_COORD */
267 GLvector1f
*PointSizePtr
; /* VERT_POINT_SIZE */
268 GLmaterial (*Material
)[2]; /* VERT_MATERIAL, optional */
269 GLuint
*MaterialMask
; /* VERT_MATERIAL, optional */
270 GLuint
*Flag
; /* VERT_* flags, optional */
271 GLuint
*Primitive
; /* GL_(mode)|PRIM_* flags */
272 GLuint
*PrimitiveLength
; /* integers */
275 GLuint importable_data
;
277 void (*import_data
)( GLcontext
*ctx
, GLuint flags
, GLuint vecflags
);
278 /* Callback to the provider of the untransformed input for the
279 * render stage (or other stages) to call if they need to write into
280 * write-protected arrays, or fixup the stride on input arrays.
282 * This is currently only necessary for client arrays that make it
283 * as far down the pipeline as the render stage.
287 /* Private data from _tnl_render_stage that has no business being
295 /* Describes an individual operation on the pipeline.
297 struct gl_pipeline_stage
{
299 GLuint check_state
; /* All state referenced in check() --
300 * When is the pipeline_stage struct
301 * itself invalidated? Must be
305 /* Usually constant or set by the 'check' callback:
307 GLuint run_state
; /* All state referenced in run() --
308 * When is the cached output of the
312 GLboolean active
; /* True if runnable in current state */
313 GLuint inputs
; /* VERT_* inputs to the stage */
314 GLuint outputs
; /* VERT_* outputs of the stage */
316 /* Set in _tnl_run_pipeline():
318 GLuint changed_inputs
; /* Generated value -- inputs to the
319 * stage that have changed since last
323 /* Private data for the pipeline stage:
327 /* Free private data. May not be null.
329 void (*destroy
)( struct gl_pipeline_stage
* );
331 /* Called from _tnl_validate_pipeline(). Must update all fields in
332 * the pipeline_stage struct for the current state.
334 void (*check
)( GLcontext
*ctx
, struct gl_pipeline_stage
* );
336 /* Called from _tnl_run_pipeline(). The stage.changed_inputs value
337 * encodes all inputs to thee struct which have changed. If
338 * non-zero, recompute all affected outputs of the stage, otherwise
339 * execute any 'sideeffects' of the stage.
341 * Return value: GL_TRUE - keep going
342 * GL_FALSE - finished pipeline
344 GLboolean (*run
)( GLcontext
*ctx
, struct gl_pipeline_stage
* );
349 GLuint build_state_trigger
; /* state changes which require build */
350 GLuint build_state_changes
; /* state changes since last build */
351 GLuint run_state_changes
; /* state changes since last run */
352 GLuint run_input_changes
; /* VERT_* changes since last run */
353 GLuint inputs
; /* VERT_* inputs to pipeline */
354 struct gl_pipeline_stage stages
[MAX_PIPELINE_STAGES
+1];
359 struct tnl_eval_store
{
360 GLuint EvalMap1Flags
;
361 GLuint EvalMap2Flags
;
363 struct immediate
*im
; /* used for temporary data */
367 typedef void (*points_func
)( GLcontext
*ctx
, GLuint first
, GLuint last
);
368 typedef void (*line_func
)( GLcontext
*ctx
, GLuint v1
, GLuint v2
);
369 typedef void (*triangle_func
)( GLcontext
*ctx
,
370 GLuint v1
, GLuint v2
, GLuint v3
);
371 typedef void (*quad_func
)( GLcontext
*ctx
, GLuint v1
, GLuint v2
,
372 GLuint v3
, GLuint v4
);
373 typedef void (*render_func
)( GLcontext
*ctx
, GLuint start
, GLuint count
,
375 typedef void (*interp_func
)( GLcontext
*ctx
,
376 GLfloat t
, GLuint dst
, GLuint out
, GLuint in
,
377 GLboolean force_boundary
);
378 typedef void (*copy_pv_func
)( GLcontext
*ctx
, GLuint dst
, GLuint src
);
381 struct tnl_device_driver
{
386 void (*RunPipeline
)(GLcontext
*ctx
);
387 /* Replaces PipelineStart/PipelineFinish -- intended to allow
388 * drivers to wrap _tnl_run_pipeline() with code to validate state
389 * and grab/release hardware locks.
396 void (*RenderStart
)(GLcontext
*ctx
);
397 void (*RenderFinish
)(GLcontext
*ctx
);
398 /* Called before and after all rendering operations, including DrawPixels,
399 * ReadPixels, Bitmap, span functions, and CopyTexImage, etc commands.
400 * These are a suitable place for grabbing/releasing hardware locks.
403 void (*RenderPrimitive
)(GLcontext
*ctx
, GLenum mode
);
404 /* Called between RednerStart() and RenderFinish() to indicate the
405 * type of primitive we're about to draw. Mode will be one of the
406 * modes accepted by glBegin().
409 interp_func RenderInterp
;
410 /* The interp function is called by the clipping routines when we need
411 * to generate an interpolated vertex. All pertinant vertex ancilliary
412 * data should be computed by interpolating between the 'in' and 'out'
416 copy_pv_func RenderCopyPV
;
417 /* The copy function is used to make a copy of a vertex. All pertinant
418 * vertex attributes should be copied.
421 void (*RenderClippedPolygon
)( GLcontext
*ctx
, const GLuint
*elts
, GLuint n
);
422 /* Render a polygon with <n> vertices whose indexes are in the <elts>
426 void (*RenderClippedLine
)( GLcontext
*ctx
, GLuint v0
, GLuint v1
);
427 /* Render a line between the two vertices given by indexes v0 and v1. */
429 points_func PointsFunc
; /* must now respect vb->elts */
431 triangle_func TriangleFunc
;
433 /* These functions are called in order to render points, lines,
434 * triangles and quads. These are only called via the T&L module.
437 render_func
*RenderTabVerts
;
438 render_func
*RenderTabElts
;
439 /* Render whole unclipped primitives (points, lines, linestrips,
440 * lineloops, etc). The tables are indexed by the GL enum of the
441 * primitive to be rendered. RenderTabVerts is used for non-indexed
442 * arrays of vertices. RenderTabElts is used for indexed arrays of
446 void (*ResetLineStipple
)( GLcontext
*ctx
);
447 /* Reset the hardware's line stipple counter.
450 void (*BuildProjectedVertices
)( GLcontext
*ctx
,
451 GLuint start
, GLuint end
,
453 /* This function is called whenever new vertices are required for
454 * rendering. The vertices in question are those n such that start
455 * <= n < end. The new_inputs parameter indicates those fields of
456 * the vertex which need to be updated, if only a partial repair of
457 * the vertex is required.
459 * This function is called only from _tnl_render_stage in tnl/t_render.c.
463 GLboolean (*MultipassFunc
)( GLcontext
*ctx
, GLuint passno
);
464 /* Driver may request additional render passes by returning GL_TRUE
465 * when this function is called. This function will be called
466 * after the first pass, and passes will be made until the function
467 * returns GL_FALSE. If no function is registered, only one pass
470 * This function will be first invoked with passno == 1.
479 struct tnl_device_driver Driver
;
481 /* Track whether the module is active.
483 GLboolean bound_exec
;
485 /* Display list extensions
487 GLuint opcode_vertex_cassette
;
491 struct gl_pipeline pipeline
;
492 struct vertex_buffer vb
;
494 /* GLvectors for binding to vb:
496 struct vertex_arrays imm_inputs
;
497 struct vertex_arrays array_inputs
;
498 GLuint
*tmp_primitive
;
499 GLuint
*tmp_primitive_length
;
501 /* Set when executing an internally generated begin/end object. If
502 * such an object is encountered in a display list, it will be
503 * replayed only if the list is outside any existing begin/end
506 GLboolean ReplayHardBeginEnd
;
508 /* Note which vertices need copying over succesive immediates.
509 * Will add save versions to precompute vertex copying where
512 struct immediate
*ExecCopySource
;
513 GLuint ExecCopyCount
;
514 GLuint ExecCopyElts
[IMM_MAX_COPIED_VERTS
];
515 GLuint ExecCopyTexSize
;
518 GLuint DlistPrimitive
;
519 GLuint DlistPrimitiveLength
;
520 GLuint DlistLastPrimitive
;
522 /* Cache a single free immediate (refcount == 0)
524 struct immediate
*freed_immediate
;
526 /* Probably need a better configuration mechanism:
528 GLboolean NeedProjCoords
;
529 GLboolean LoopbackDListCassettes
;
530 GLboolean CalcDListNormalLengths
;
532 /* Derived state and storage for _tnl_eval_vb:
534 struct tnl_eval_store eval
;
536 /* Functions to be plugged into dispatch when tnl is active.
538 GLvertexformat vtxfmt
;
544 #define TNL_CONTEXT(ctx) ((TNLcontext *)(ctx->swtnl_context))
545 #define TNL_CURRENT_IM(ctx) ((struct immediate *)(ctx->swtnl_im))
548 #define TYPE_IDX(t) ((t) & 0xf)
549 #define MAX_TYPES TYPE_IDX(GL_DOUBLE)+1 /* 0xa + 1 */
551 extern void _tnl_MakeCurrent( GLcontext
*ctx
,
552 GLframebuffer
*drawBuffer
,
553 GLframebuffer
*readBuffer
);
557 * Macros for fetching current input buffer.
560 #define GET_IMMEDIATE struct immediate *IM = TNL_CURRENT_IM(((GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context())))
561 #define SET_IMMEDIATE(ctx, im) ctx->swtnl_im = (void *)im
563 extern struct immediate
*_tnl_CurrentInput
;
564 #define GET_IMMEDIATE struct immediate *IM = _tnl_CurrentInput
565 #define SET_IMMEDIATE(ctx, im) \
567 ctx->swtnl_im = (void *)im; \
568 _tnl_CurrentInput = im; \