diff options
author | Brian Paul <brian.paul@tungstengraphics.com> | 2002-10-21 15:06:26 +0000 |
---|---|---|
committer | Brian Paul <brian.paul@tungstengraphics.com> | 2002-10-21 15:06:26 +0000 |
commit | ac9a65b1dd6694fa9cd3bde640d253bbb996addc (patch) | |
tree | 62e9b11314d696c5d4d77567f3745c479601db40 /src/mesa/swrast/swrast.h | |
parent | ef31f60b12abc2109568fb8d9a2aaa70ec5c71cc (diff) |
doxygen comments (Klaus Niederkrueger)
Diffstat (limited to 'src/mesa/swrast/swrast.h')
-rw-r--r-- | src/mesa/swrast/swrast.h | 39 |
1 files changed, 26 insertions, 13 deletions
diff --git a/src/mesa/swrast/swrast.h b/src/mesa/swrast/swrast.h index 43c9aea8dcd..72bc60f0376 100644 --- a/src/mesa/swrast/swrast.h +++ b/src/mesa/swrast/swrast.h @@ -1,4 +1,4 @@ -/* $Id: swrast.h,v 1.30 2002/10/11 17:41:06 brianp Exp $ */ +/* $Id: swrast.h,v 1.31 2002/10/21 15:06:26 brianp Exp $ */ /* * Mesa 3-D graphics library @@ -63,6 +63,8 @@ * primitives unaccelerated), hook in swrast_setup instead. */ typedef struct { + /** win[0], win[1] are the screen-coords of SWvertex. win[2] is the + * z-coord. what is win[3]? */ GLfloat win[4]; GLfloat texcoord[MAX_TEXTURE_UNITS][4]; GLchan color[4]; @@ -97,7 +99,13 @@ typedef struct { */ -/* Values for interpMask and arrayMask */ +/** + * \defgroup SpanFlags SPAN_XXX-flags + * Bitmasks to indicate which span_arrays need to be computed + * (sw_span::interpMask) or have already been filled + * (sw_span::arrayMask) + */ +/*@{*/ #define SPAN_RGBA 0x001 #define SPAN_SPEC 0x002 #define SPAN_INDEX 0x004 @@ -107,16 +115,21 @@ typedef struct { #define SPAN_INT_TEXTURE 0x040 #define SPAN_LAMBDA 0x080 #define SPAN_COVERAGE 0x100 -#define SPAN_FLAT 0x200 /* flat shading? */ -#define SPAN_XY 0x400 /* arrayMask only - for xArray, yArray */ -#define SPAN_MASK 0x800 /* arrayMask only */ +#define SPAN_FLAT 0x200 /**< flat shading? */ +/** sw_span::arrayMask only - for span_arrays::x, span_arrays::y */ +#define SPAN_XY 0x400 +#define SPAN_MASK 0x800 /**< sw_span::arrayMask only */ +/*@}*/ +/** + * \struct span_arrays + * \brief Arrays of fragment values. + * + * These will either be computed from the x/xStep values above or + * filled in by glDraw/CopyPixels, etc. + */ struct span_arrays { - /** - * Arrays of fragment values. These will either be computed from the - * x/xStep values above or filled in by glDraw/CopyPixels, etc. - */ GLchan rgb[MAX_WIDTH][3]; GLchan rgba[MAX_WIDTH][4]; GLuint index[MAX_WIDTH]; @@ -151,8 +164,8 @@ struct sw_span { GLuint facing; /** - * This bitmask (of SPAN_* flags) indicates which of the x/xStep - * variables are relevant. + * This bitmask (of \link SpanFlags SPAN_* flags\endlink) indicates + * which of the x/xStep variables are relevant. */ GLuint interpMask; @@ -182,8 +195,8 @@ struct sw_span { GLfixed intTex[2], intTexStep[2]; /** - * This bitmask (of SPAN_* flags) indicates which of the fragment arrays - * in the span_arrays struct are relevant. + * This bitmask (of \link SpanFlags SPAN_* flags\endlink) indicates + * which of the fragment arrays in the span_arrays struct are relevant. */ GLuint arrayMask; |