1 /* $Id: s_context.h,v 1.19 2002/08/07 00:45:07 brianp Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999-2002 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>
31 * \file swrast/s_context.h
32 * \brief fill in description
33 * \author Keith Whitwell <keithw@valinux.com>
43 * For texture sampling:
45 typedef void (*TextureSampleFunc
)( GLcontext
*ctx
, GLuint texUnit
,
46 const struct gl_texture_object
*tObj
,
47 GLuint n
, GLfloat texcoords
[][4],
48 const GLfloat lambda
[], GLchan rgba
[][4] );
56 typedef void (_ASMAPIP blend_func
)( GLcontext
*ctx
, GLuint n
,
58 GLchan src
[][4], CONST GLchan dst
[][4] );
60 typedef void (*blend_func
)( GLcontext
*ctx
, GLuint n
, const GLubyte mask
[],
61 GLchan src
[][4], CONST GLchan dst
[][4] );
64 typedef void (*swrast_point_func
)( GLcontext
*ctx
, const SWvertex
*);
66 typedef void (*swrast_line_func
)( GLcontext
*ctx
,
67 const SWvertex
*, const SWvertex
*);
69 typedef void (*swrast_tri_func
)( GLcontext
*ctx
, const SWvertex
*,
70 const SWvertex
*, const SWvertex
*);
73 /** \defgroup Bitmasks
74 * Bitmasks to indicate which rasterization options are enabled
78 #define ALPHATEST_BIT 0x001 /**< Alpha-test pixels */
79 #define BLEND_BIT 0x002 /**< Blend pixels */
80 #define DEPTH_BIT 0x004 /**< Depth-test pixels */
81 #define FOG_BIT 0x008 /**< Fog pixels */
82 #define LOGIC_OP_BIT 0x010 /**< Apply logic op in software */
83 #define CLIP_BIT 0x020 /**< Scissor or window clip pixels */
84 #define STENCIL_BIT 0x040 /**< Stencil pixels */
85 #define MASKING_BIT 0x080 /**< Do glColorMask or glIndexMask */
86 #define ALPHABUF_BIT 0x100 /**< Using software alpha buffer */
87 #define MULTI_DRAW_BIT 0x400 /**< Write to more than one color- */
88 /**< buffer or no buffers. */
89 #define OCCLUSION_BIT 0x800 /**< GL_HP_occlusion_test enabled */
90 #define TEXTURE_BIT 0x1000 /**< Texturing really enabled */
93 #define _SWRAST_NEW_RASTERMASK (_NEW_BUFFERS| \
110 /** Driver interface:
112 struct swrast_device_driver Driver
;
114 /** Configuration mechanisms to make software rasterizer match
115 * characteristics of the hardware rasterizer (if present):
117 GLboolean AllowVertexFog
;
118 GLboolean AllowPixelFog
;
120 /** Derived values, invalidated on statechanges, updated from
121 * _swrast_validate_derived():
124 GLfloat _MinMagThresh
[MAX_TEXTURE_UNITS
];
125 GLfloat _backface_sign
;
126 GLboolean _PreferPixelFog
;
127 GLboolean _AnyTextureCombine
;
129 /* Accum buffer temporaries.
131 GLboolean _IntegerAccumMode
; /**< Storing unscaled integers? */
132 GLfloat _IntegerAccumScaler
; /**< Implicit scale factor */
137 GLuint StippleCounter
; /**< Line stipple counter */
141 /** Mechanism to allow driver (like X11) to register further
142 * software rasterization routines.
145 void (*choose_point
)( GLcontext
* );
146 void (*choose_line
)( GLcontext
* );
147 void (*choose_triangle
)( GLcontext
* );
149 GLuint invalidate_point
;
150 GLuint invalidate_line
;
151 GLuint invalidate_triangle
;
154 /** Function pointers for dispatch behind public entrypoints. */
156 void (*InvalidateState
)( GLcontext
*ctx
, GLuint new_state
);
158 swrast_point_func Point
;
159 swrast_line_func Line
;
160 swrast_tri_func Triangle
;
164 * Placeholders for when separate specular (or secondary color) is
165 * enabled but texturing is not.
168 swrast_point_func SpecPoint
;
169 swrast_line_func SpecLine
;
170 swrast_tri_func SpecTriangle
;
174 * Typically, we'll allocate a sw_span structure as a local variable
175 * and set its 'array' pointer to point to this object. The reason is
176 * this object is big and causes problems when allocated on the stack
179 struct span_arrays
*span_data
;
181 /** Internal hooks, kept uptodate by the same mechanism as above.
183 blend_func BlendFunc
;
184 TextureSampleFunc TextureSample
[MAX_TEXTURE_UNITS
];
186 /** Buffer for saving the sampled texture colors.
187 * Needed for GL_ARB_texture_env_crossbar implementation.
195 _swrast_validate_derived( GLcontext
*ctx
);
198 #define SWRAST_CONTEXT(ctx) ((SWcontext *)ctx->swrast_context)
200 #define RENDER_START(SWctx, GLctx) \
202 if ((SWctx)->Driver.SpanRenderStart) { \
203 (*(SWctx)->Driver.SpanRenderStart)(GLctx); \
207 #define RENDER_FINISH(SWctx, GLctx) \
209 if ((SWctx)->Driver.SpanRenderFinish) { \
210 (*(SWctx)->Driver.SpanRenderFinish)(GLctx); \
217 * XXX these macros are just bandages for now in order to make
218 * CHAN_BITS==32 compile cleanly.
219 * These should probably go elsewhere at some point.
221 #if CHAN_TYPE == GL_FLOAT
222 #define ChanToFixed(X) (X)
223 #define FixedToChan(X) (X)
225 #define ChanToFixed(X) IntToFixed(X)
226 #define FixedToChan(X) FixedToInt(X)