1 /* $Id: t_context.h,v 1.8 2000/12/27 22:30:29 keithw Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999 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 0x1000
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
;
181 GLuint MaxTextureUnits
; /* precalc'ed for glMultiTexCoordARB */
183 /* Temporary values created when vertices are copied into the
184 * first 3 slots of the struct:
191 /* allocate storage for these on demand:
193 struct gl_material (*Material
)[2];
194 GLuint
*MaterialMask
;
195 GLfloat
*NormalLengths
;
196 GLfloat (*TexCoord
[MAX_TEXTURE_UNITS
])[4];
198 GLuint Primitive
[IMM_SIZE
]; /* BEGIN/END */
199 GLuint PrimitiveLength
[IMM_SIZE
]; /* BEGIN/END */
200 GLuint Flag
[IMM_SIZE
]; /* VERT_* flags */
201 GLchan Color
[IMM_SIZE
][4];
202 GLfloat Obj
[IMM_SIZE
][4];
203 GLfloat Normal
[IMM_SIZE
][3];
204 GLfloat TexCoord0
[IMM_SIZE
][4]; /* just VERT_TEX0 */
205 GLuint Elt
[IMM_SIZE
];
206 GLubyte EdgeFlag
[IMM_SIZE
];
207 GLuint Index
[IMM_SIZE
];
208 GLubyte SecondaryColor
[IMM_SIZE
][4];
209 GLfloat FogCoord
[IMM_SIZE
];
219 GLvector1ub EdgeFlag
;
220 GLvector4f TexCoord
[MAX_TEXTURE_UNITS
];
222 GLvector4ub SecondaryColor
;
227 typedef struct gl_material GLmaterial
;
229 /* Contains the current state of a running pipeline.
231 typedef struct vertex_buffer
233 /* Constant over life of the vertex_buffer.
237 /* Constant over the pipeline.
239 GLuint Count
; /* for everything except Elts */
240 GLuint FirstClipped
; /* temp verts for clipping */
241 GLuint FirstPrimitive
; /* usually zero */
243 /* Pointers to current data.
245 GLuint
*Elts
; /* VERT_ELT */
246 GLvector4f
*ObjPtr
; /* VERT_OBJ */
247 GLvector4f
*EyePtr
; /* VERT_EYE */
248 GLvector4f
*ClipPtr
; /* VERT_CLIP */
249 GLvector4f
*ProjectedClipPtr
; /* VERT_CLIP (2) */
250 GLubyte ClipOrMask
; /* VERT_CLIP (3) */
251 GLubyte
*ClipMask
; /* VERT_CLIP (4) */
252 GLvector3f
*NormalPtr
; /* VERT_NORM */
253 GLfloat
*NormalLengthPtr
; /* VERT_NORM (optional) */
254 GLvector1ub
*EdgeFlagPtr
; /* VERT_EDGE */
255 GLvector4f
*TexCoordPtr
[MAX_TEXTURE_UNITS
]; /* VERT_TEX_0..n */
256 GLvector1ui
*IndexPtr
[2]; /* VERT_INDEX */
257 GLvector4ub
*ColorPtr
[2]; /* VERT_RGBA */
258 GLvector4ub
*SecondaryColorPtr
[2]; /* VERT_SPEC_RGB */
259 GLvector1f
*FogCoordPtr
; /* VERT_FOG_COORD */
260 GLvector1f
*PointSizePtr
; /* VERT_POINT_SIZE */
261 GLmaterial (*Material
)[2]; /* VERT_MATERIAL, optional */
262 GLuint
*MaterialMask
; /* VERT_MATERIAL, optional */
263 GLuint
*Flag
; /* VERT_* flags, optional */
264 GLuint
*Primitive
; /* GL_(mode)|PRIM_* flags */
265 GLuint
*PrimitiveLength
; /* integers */
268 GLuint importable_data
;
269 void (*import_data
)( GLcontext
*ctx
, GLuint flags
, GLuint vecflags
);
270 /* Callback to the provider of the untransformed input for the
271 * render stage (or other stages) to call if they need to write into
272 * write-protected arrays, or fixup the stride on input arrays.
274 * This is currently only necessary for client arrays that make it
275 * as far down the pipeline as the render stage.
280 /* Two pieces of private data from _tnl_render_stage that have no
281 * business being in this struct.
288 /* Describes an individual operation on the pipeline.
290 struct gl_pipeline_stage
{
292 GLuint check_state
; /* All state referenced in check() --
293 * When is the pipeline_stage struct
294 * itself invalidated? Must be
298 /* Usually constant or set by the 'check' callback:
300 GLuint run_state
; /* All state referenced in run() --
301 * When is the cached output of the
305 GLboolean active
; /* True if runnable in current state */
306 GLuint inputs
; /* VERT_* inputs to the stage */
307 GLuint outputs
; /* VERT_* outputs of the stage */
309 /* Set in _tnl_run_pipeline():
311 GLuint changed_inputs
; /* Generated value -- inputs to the
312 * stage that have changed since last
316 /* Private data for the pipeline stage:
320 /* Free private data. May not be null.
322 void (*destroy
)( struct gl_pipeline_stage
* );
324 /* Called from _tnl_validate_pipeline(). Must update all fields in
325 * the pipeline_stage struct for the current state.
327 void (*check
)( GLcontext
*ctx
, struct gl_pipeline_stage
* );
329 /* Called from _tnl_run_pipeline(). The stage.changed_inputs value
330 * encodes all inputs to thee struct which have changed. If
331 * non-zero, recompute all affected outputs of the stage, otherwise
332 * execute any 'sideeffects' of the stage.
334 * Return value: GL_TRUE - keep going
335 * GL_FALSE - finished pipeline
337 GLboolean (*run
)( GLcontext
*ctx
, struct gl_pipeline_stage
* );
342 GLuint build_state_trigger
; /* state changes which require build */
343 GLuint build_state_changes
; /* state changes since last build */
344 GLuint run_state_changes
; /* state changes since last run */
345 GLuint run_input_changes
; /* VERT_* changes since last run */
346 GLuint inputs
; /* VERT_* inputs to pipeline */
347 struct gl_pipeline_stage stages
[MAX_PIPELINE_STAGES
];
352 struct tnl_eval_store
{
353 GLuint EvalMap1Flags
;
354 GLuint EvalMap2Flags
;
357 GLfloat Coord
[IMM_SIZE
][4];
358 GLfloat Obj
[IMM_SIZE
][4];
359 GLfloat TexCoord
[IMM_SIZE
][4];
360 GLfloat Normal
[IMM_SIZE
][3];
361 GLchan Color
[IMM_SIZE
][4];
362 GLuint Index
[IMM_SIZE
];
363 GLuint Flag
[IMM_SIZE
];
364 GLuint Elts
[IMM_SIZE
];
369 /* Track whether the module is active.
371 GLboolean bound_exec
;
373 /* Display list extensions
375 GLuint opcode_vertex_cassette
;
379 struct gl_pipeline pipeline
;
380 struct vertex_buffer vb
;
382 /* GLvectors for binding to vb:
384 struct vertex_arrays imm_inputs
;
385 struct vertex_arrays array_inputs
;
386 GLuint
*tmp_primitive
;
387 GLuint
*tmp_primitive_length
;
389 /* Set when executing an internally generated immediate.
391 GLboolean ReplayHardBeginEnd
;
392 GLenum CurrentPrimitive
;
394 /* Note which vertices need copying over succesive immediates.
395 * Will add save versions to precompute vertex copying where
398 struct immediate
*ExecCopySource
;
399 GLuint ExecCopyCount
;
400 GLuint ExecCopyElts
[IMM_MAX_COPIED_VERTS
];
401 GLuint ExecCopyTexSize
;
404 GLuint DlistPrimitive
;
405 GLuint DlistPrimitiveLength
;
406 GLuint DlistLastPrimitive
;
408 /* Derived state and storage for _tnl_eval_vb:
410 struct tnl_eval_store eval
;
412 /* Functions to be plugged into dispatch when tnl is active.
414 GLvertexformat vtxfmt
;
420 #define TNL_CONTEXT(ctx) ((TNLcontext *)(ctx->swtnl_context))
421 #define TNL_CURRENT_IM(ctx) ((struct immediate *)(ctx->swtnl_im))
424 #define TYPE_IDX(t) ((t) & 0xf)
425 #define MAX_TYPES TYPE_IDX(GL_DOUBLE)+1 /* 0xa + 1 */
427 extern void _tnl_MakeCurrent( GLcontext
*ctx
,
428 GLframebuffer
*drawBuffer
,
429 GLframebuffer
*readBuffer
);
433 * Macros for fetching current input buffer.
436 #define GET_IMMEDIATE struct immediate *IM = TNL_CURRENT_IM(((GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context())))
437 #define SET_IMMEDIATE(ctx, im) ctx->swtnl_im = (void *)im
439 extern struct immediate
*_tnl_CurrentInput
;
440 #define GET_IMMEDIATE struct immediate *IM = _tnl_CurrentInput
441 #define SET_IMMEDIATE(ctx, im) \
443 ctx->swtnl_im = (void *)im; \
444 _tnl_CurrentInput = im; \