1 /*
2 * Mesa 3-D graphics library
3 * Version: 6.5
4 *
5 * Copyright (C) 1999-2005 Brian Paul All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 *
24 * Authors:
25 * Keith Whitwell <keith@tungstengraphics.com>
26 */
27
28
29 /*
30 * Render whole vertex buffers, including projection of vertices from
31 * clip space and clipping of primitives.
32 *
33 * This file makes calls to project vertices and to the point, line
34 * and triangle rasterizers via the function pointers:
35 *
36 * context->Driver.Render.*
37 *
38 */
39
40
41 #include "main/glheader.h"
42 #include "main/context.h"
43 #include "main/enums.h"
44 #include "main/macros.h"
45 #include "main/imports.h"
46 #include "main/mtypes.h"
47 #include "math/m_xform.h"
48
49 #include "t_pipeline.h"
50
51
52
53 /**********************************************************************/
54 /* Clip single primitives */
55 /**********************************************************************/
56
57
58 #define W(i) coord[i][3]
59 #define Z(i) coord[i][2]
60 #define Y(i) coord[i][1]
61 #define X(i) coord[i][0]
62 #define SIZE 4
63 #define TAG(x) x##_4
64 #include "t_vb_cliptmp.h"
65
66
67
68 /**********************************************************************/
69 /* Clip and render whole begin/end objects */
70 /**********************************************************************/
71
72 #define NEED_EDGEFLAG_SETUP (ctx->Polygon.FrontMode != GL_FILL || ctx->Polygon.BackMode != GL_FILL)
73 #define EDGEFLAG_GET(idx) VB->EdgeFlag[idx]
74 #define EDGEFLAG_SET(idx, val) VB->EdgeFlag[idx] = val
75
76
77 /* This does NOT include the CLIP_USER_BIT! */
78 #define CLIPMASK (CLIP_FRUSTUM_BITS | CLIP_CULL_BIT)
79
80
81 /* Vertices, with the possibility of clipping.
82 */
83 #define RENDER_POINTS( start, count ) \
84 tnl->Driver.Render.Points( ctx, start, count )
85
86 #define RENDER_LINE( v1, v2 ) \
87 do { \
88 GLubyte c1 = mask[v1], c2 = mask[v2]; \
89 GLubyte ormask = c1|c2; \
90 if (!ormask) \
91 LineFunc( ctx, v1, v2 ); \
92 else if (!(c1 & c2 & CLIPMASK)) \
93 clip_line_4( ctx, v1, v2, ormask ); \
94 } while (0)
95
96 #define RENDER_TRI( v1, v2, v3 ) \
97 do { \
98 GLubyte c1 = mask[v1], c2 = mask[v2], c3 = mask[v3]; \
99 GLubyte ormask = c1|c2|c3; \
100 if (!ormask) \
101 TriangleFunc( ctx, v1, v2, v3 ); \
102 else if (!(c1 & c2 & c3 & CLIPMASK)) \
103 clip_tri_4( ctx, v1, v2, v3, ormask ); \
104 } while (0)
105
106 #define RENDER_QUAD( v1, v2, v3, v4 ) \
107 do { \
108 GLubyte c1 = mask[v1], c2 = mask[v2]; \
109 GLubyte c3 = mask[v3], c4 = mask[v4]; \
110 GLubyte ormask = c1|c2|c3|c4; \
111 if (!ormask) \
112 QuadFunc( ctx, v1, v2, v3, v4 ); \
113 else if (!(c1 & c2 & c3 & c4 & CLIPMASK)) \
114 clip_quad_4( ctx, v1, v2, v3, v4, ormask ); \
115 } while (0)
116
117
118 #define LOCAL_VARS \
119 TNLcontext *tnl = TNL_CONTEXT(ctx); \
120 struct vertex_buffer *VB = &tnl->vb; \
121 const GLuint * const elt = VB->Elts; \
122 const GLubyte *mask = VB->ClipMask; \
123 const GLuint sz = VB->ClipPtr->size; \
124 const tnl_line_func LineFunc = tnl->Driver.Render.Line; \
125 const tnl_triangle_func TriangleFunc = tnl->Driver.Render.Triangle; \
126 const tnl_quad_func QuadFunc = tnl->Driver.Render.Quad; \
127 const GLboolean stipple = ctx->Line.StippleFlag; \
128 (void) (LineFunc && TriangleFunc && QuadFunc); \
129 (void) elt; (void) mask; (void) sz; (void) stipple;
130
131 #define TAG(x) clip_##x##_verts
132 #define INIT(x) tnl->Driver.Render.PrimitiveNotify( ctx, x )
133 #define RESET_STIPPLE if (stipple) tnl->Driver.Render.ResetLineStipple( ctx )
134 #define PRESERVE_VB_DEFS
135 #include "t_vb_rendertmp.h"
136
137
138
139 /* Elts, with the possibility of clipping.
140 */
141 #undef ELT
142 #undef TAG
143 #define ELT(x) elt[x]
144 #define TAG(x) clip_##x##_elts
145 #include "t_vb_rendertmp.h"
146
147 /* TODO: do this for all primitives, verts and elts:
148 */
clip_elt_triangles(struct gl_context * ctx,GLuint start,GLuint count,GLuint flags)149 static void clip_elt_triangles( struct gl_context *ctx,
150 GLuint start,
151 GLuint count,
152 GLuint flags )
153 {
154 TNLcontext *tnl = TNL_CONTEXT(ctx);
155 tnl_render_func render_tris = tnl->Driver.Render.PrimTabElts[GL_TRIANGLES];
156 struct vertex_buffer *VB = &tnl->vb;
157 const GLuint * const elt = VB->Elts;
158 GLubyte *mask = VB->ClipMask;
159 GLuint last = count-2;
160 GLuint j;
161 (void) flags;
162
163 tnl->Driver.Render.PrimitiveNotify( ctx, GL_TRIANGLES );
164
165 for (j=start; j < last; j+=3 ) {
166 GLubyte c1 = mask[elt[j]];
167 GLubyte c2 = mask[elt[j+1]];
168 GLubyte c3 = mask[elt[j+2]];
169 GLubyte ormask = c1|c2|c3;
170 if (ormask) {
171 if (start < j)
172 render_tris( ctx, start, j, 0 );
173 if (!(c1&c2&c3&CLIPMASK))
174 clip_tri_4( ctx, elt[j], elt[j+1], elt[j+2], ormask );
175 start = j+3;
176 }
177 }
178
179 if (start < j)
180 render_tris( ctx, start, j, 0 );
181 }
182
183 /**********************************************************************/
184 /* Render whole begin/end objects */
185 /**********************************************************************/
186
187 #define NEED_EDGEFLAG_SETUP (ctx->Polygon.FrontMode != GL_FILL || ctx->Polygon.BackMode != GL_FILL)
188 #define EDGEFLAG_GET(idx) VB->EdgeFlag[idx]
189 #define EDGEFLAG_SET(idx, val) VB->EdgeFlag[idx] = val
190
191
192 /* Vertices, no clipping.
193 */
194 #define RENDER_POINTS( start, count ) \
195 tnl->Driver.Render.Points( ctx, start, count )
196
197 #define RENDER_LINE( v1, v2 ) \
198 LineFunc( ctx, v1, v2 )
199
200 #define RENDER_TRI( v1, v2, v3 ) \
201 TriangleFunc( ctx, v1, v2, v3 )
202
203 #define RENDER_QUAD( v1, v2, v3, v4 ) \
204 QuadFunc( ctx, v1, v2, v3, v4 )
205
206 #define TAG(x) _tnl_##x##_verts
207
208 #define LOCAL_VARS \
209 TNLcontext *tnl = TNL_CONTEXT(ctx); \
210 struct vertex_buffer *VB = &tnl->vb; \
211 const GLuint * const elt = VB->Elts; \
212 const tnl_line_func LineFunc = tnl->Driver.Render.Line; \
213 const tnl_triangle_func TriangleFunc = tnl->Driver.Render.Triangle; \
214 const tnl_quad_func QuadFunc = tnl->Driver.Render.Quad; \
215 const GLboolean stipple = ctx->Line.StippleFlag; \
216 (void) (LineFunc && TriangleFunc && QuadFunc); \
217 (void) elt; (void) stipple
218
219 #define RESET_STIPPLE if (stipple) tnl->Driver.Render.ResetLineStipple( ctx )
220 #define INIT(x) tnl->Driver.Render.PrimitiveNotify( ctx, x )
221 #define RENDER_TAB_QUALIFIER
222 #define PRESERVE_VB_DEFS
223 #include "t_vb_rendertmp.h"
224
225
226 /* Elts, no clipping.
227 */
228 #undef ELT
229 #define TAG(x) _tnl_##x##_elts
230 #define ELT(x) elt[x]
231 #include "t_vb_rendertmp.h"
232
233
234 /**********************************************************************/
235 /* Helper functions for drivers */
236 /**********************************************************************/
237
_tnl_RenderClippedPolygon(struct gl_context * ctx,const GLuint * elts,GLuint n)238 void _tnl_RenderClippedPolygon( struct gl_context *ctx, const GLuint *elts, GLuint n )
239 {
240 TNLcontext *tnl = TNL_CONTEXT(ctx);
241 struct vertex_buffer *VB = &tnl->vb;
242 GLuint *tmp = VB->Elts;
243
244 VB->Elts = (GLuint *)elts;
245 tnl->Driver.Render.PrimTabElts[GL_POLYGON]( ctx, 0, n, PRIM_BEGIN|PRIM_END );
246 VB->Elts = tmp;
247 }
248
_tnl_RenderClippedLine(struct gl_context * ctx,GLuint ii,GLuint jj)249 void _tnl_RenderClippedLine( struct gl_context *ctx, GLuint ii, GLuint jj )
250 {
251 TNLcontext *tnl = TNL_CONTEXT(ctx);
252 tnl->Driver.Render.Line( ctx, ii, jj );
253 }
254
255
256
257 /**********************************************************************/
258 /* Clip and render whole vertex buffers */
259 /**********************************************************************/
260
261
run_render(struct gl_context * ctx,struct tnl_pipeline_stage * stage)262 static GLboolean run_render( struct gl_context *ctx,
263 struct tnl_pipeline_stage *stage )
264 {
265 TNLcontext *tnl = TNL_CONTEXT(ctx);
266 struct vertex_buffer *VB = &tnl->vb;
267 tnl_render_func *tab;
268 GLint pass = 0;
269
270 /* Allow the drivers to lock before projected verts are built so
271 * that window coordinates are guarenteed not to change before
272 * rendering.
273 */
274 ASSERT(tnl->Driver.Render.Start);
275
276 tnl->Driver.Render.Start( ctx );
277
278 ASSERT(tnl->Driver.Render.BuildVertices);
279 ASSERT(tnl->Driver.Render.PrimitiveNotify);
280 ASSERT(tnl->Driver.Render.Points);
281 ASSERT(tnl->Driver.Render.Line);
282 ASSERT(tnl->Driver.Render.Triangle);
283 ASSERT(tnl->Driver.Render.Quad);
284 ASSERT(tnl->Driver.Render.ResetLineStipple);
285 ASSERT(tnl->Driver.Render.Interp);
286 ASSERT(tnl->Driver.Render.CopyPV);
287 ASSERT(tnl->Driver.Render.ClippedLine);
288 ASSERT(tnl->Driver.Render.ClippedPolygon);
289 ASSERT(tnl->Driver.Render.Finish);
290
291 tnl->Driver.Render.BuildVertices( ctx, 0, VB->Count, ~0 );
292
293 if (VB->ClipOrMask) {
294 tab = VB->Elts ? clip_render_tab_elts : clip_render_tab_verts;
295 clip_render_tab_elts[GL_TRIANGLES] = clip_elt_triangles;
296 }
297 else {
298 tab = (VB->Elts ?
299 tnl->Driver.Render.PrimTabElts :
300 tnl->Driver.Render.PrimTabVerts);
301 }
302
303 do
304 {
305 GLuint i;
306
307 for (i = 0 ; i < VB->PrimitiveCount ; i++)
308 {
309 GLuint prim = _tnl_translate_prim(&VB->Primitive[i]);
310 GLuint start = VB->Primitive[i].start;
311 GLuint length = VB->Primitive[i].count;
312
313 assert((prim & PRIM_MODE_MASK) <= GL_POLYGON);
314
315 if (MESA_VERBOSE & VERBOSE_PRIMS)
316 _mesa_debug(NULL, "MESA prim %s %d..%d\n",
317 _mesa_lookup_enum_by_nr(prim & PRIM_MODE_MASK),
318 start, start+length);
319
320 if (length)
321 tab[prim & PRIM_MODE_MASK]( ctx, start, start + length, prim );
322 }
323 } while (tnl->Driver.Render.Multipass &&
324 tnl->Driver.Render.Multipass( ctx, ++pass ));
325
326 tnl->Driver.Render.Finish( ctx );
327
328 return GL_FALSE; /* finished the pipe */
329 }
330
331
332 /**********************************************************************/
333 /* Render pipeline stage */
334 /**********************************************************************/
335
336
337
338
339
340 const struct tnl_pipeline_stage _tnl_render_stage =
341 {
342 "render", /* name */
343 NULL, /* private data */
344 NULL, /* creator */
345 NULL, /* destructor */
346 NULL, /* validate */
347 run_render /* run */
348 };
349