Go to most recent revision | Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
1901 | serge | 1 | /* |
2 | * Mesa 3-D graphics library |
||
3 | * Version: 7.3 |
||
4 | * |
||
5 | * Copyright (C) 1999-2008 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 | |||
25 | |||
26 | #ifndef _M_XFORM_H |
||
27 | #define _M_XFORM_H |
||
28 | |||
29 | |||
30 | #include "main/compiler.h" |
||
31 | #include "main/glheader.h" |
||
32 | #include "math/m_matrix.h" |
||
33 | #include "math/m_vector.h" |
||
34 | |||
35 | #ifdef USE_X86_ASM |
||
36 | #define _XFORMAPI _ASMAPI |
||
37 | #define _XFORMAPIP _ASMAPIP |
||
38 | #else |
||
39 | #define _XFORMAPI |
||
40 | #define _XFORMAPIP * |
||
41 | #endif |
||
42 | |||
43 | |||
44 | extern void |
||
45 | _math_init_transformation(void); |
||
46 | extern void |
||
47 | init_c_cliptest(void); |
||
48 | |||
49 | /* KW: Clip functions now do projective divide as well. The projected |
||
50 | * coordinates are very useful to us because they let us cull |
||
51 | * backfaces and eliminate vertices from lighting, fogging, etc |
||
52 | * calculations. Despite the fact that this divide could be done one |
||
53 | * day in hardware, we would still have a reason to want to do it here |
||
54 | * as long as those other calculations remain in software. |
||
55 | * |
||
56 | * Clipping is a convenient place to do the divide on x86 as it should be |
||
57 | * possible to overlap with integer outcode calculations. |
||
58 | * |
||
59 | * There are two cases where we wouldn't want to do the divide in cliptest: |
||
60 | * - When we aren't clipping. We still might want to cull backfaces |
||
61 | * so the divide should be done elsewhere. This currently never |
||
62 | * happens. |
||
63 | * |
||
64 | * - When culling isn't likely to help us, such as when the GL culling |
||
65 | * is disabled and we not lighting or are only lighting |
||
66 | * one-sided. In this situation, backface determination provides |
||
67 | * us with no useful information. A tricky case to detect is when |
||
68 | * all input data is already culled, although hopefully the |
||
69 | * application wouldn't turn on culling in such cases. |
||
70 | * |
||
71 | * We supply a buffer to hold the [x/w,y/w,z/w,1/w] values which |
||
72 | * are the result of the projection. This is only used in the |
||
73 | * 4-vector case - in other cases, we just use the clip coordinates |
||
74 | * as the projected coordinates - they are identical. |
||
75 | * |
||
76 | * This is doubly convenient because it means the Win[] array is now |
||
77 | * of the same stride as all the others, so I can now turn map_vertices |
||
78 | * into a straight-forward matrix transformation, with asm acceleration |
||
79 | * automatically available. |
||
80 | */ |
||
81 | |||
82 | /* Vertex buffer clipping flags |
||
83 | */ |
||
84 | #define CLIP_RIGHT_SHIFT 0 |
||
85 | #define CLIP_LEFT_SHIFT 1 |
||
86 | #define CLIP_TOP_SHIFT 2 |
||
87 | #define CLIP_BOTTOM_SHIFT 3 |
||
88 | #define CLIP_NEAR_SHIFT 4 |
||
89 | #define CLIP_FAR_SHIFT 5 |
||
90 | |||
91 | #define CLIP_RIGHT_BIT 0x01 |
||
92 | #define CLIP_LEFT_BIT 0x02 |
||
93 | #define CLIP_TOP_BIT 0x04 |
||
94 | #define CLIP_BOTTOM_BIT 0x08 |
||
95 | #define CLIP_NEAR_BIT 0x10 |
||
96 | #define CLIP_FAR_BIT 0x20 |
||
97 | #define CLIP_USER_BIT 0x40 |
||
98 | #define CLIP_CULL_BIT 0x80 |
||
99 | #define CLIP_FRUSTUM_BITS 0x3f |
||
100 | |||
101 | |||
102 | typedef GLvector4f * (_XFORMAPIP clip_func)( GLvector4f *vClip, |
||
103 | GLvector4f *vProj, |
||
104 | GLubyte clipMask[], |
||
105 | GLubyte *orMask, |
||
106 | GLubyte *andMask, |
||
107 | GLboolean viewport_z_clip ); |
||
108 | |||
109 | typedef void (*dotprod_func)( GLfloat *out, |
||
110 | GLuint out_stride, |
||
111 | CONST GLvector4f *coord_vec, |
||
112 | CONST GLfloat plane[4] ); |
||
113 | |||
114 | typedef void (*vec_copy_func)( GLvector4f *to, |
||
115 | CONST GLvector4f *from ); |
||
116 | |||
117 | |||
118 | |||
119 | /* |
||
120 | * Functions for transformation of normals in the VB. |
||
121 | */ |
||
122 | typedef void (_NORMAPIP normal_func)( CONST GLmatrix *mat, |
||
123 | GLfloat scale, |
||
124 | CONST GLvector4f *in, |
||
125 | CONST GLfloat lengths[], |
||
126 | GLvector4f *dest ); |
||
127 | |||
128 | |||
129 | /* Flags for selecting a normal transformation function. |
||
130 | */ |
||
131 | #define NORM_RESCALE 0x1 /* apply the scale factor */ |
||
132 | #define NORM_NORMALIZE 0x2 /* normalize */ |
||
133 | #define NORM_TRANSFORM 0x4 /* apply the transformation matrix */ |
||
134 | #define NORM_TRANSFORM_NO_ROT 0x8 /* apply the transformation matrix */ |
||
135 | |||
136 | |||
137 | |||
138 | |||
139 | /* KW: New versions of the transform function allow a mask array |
||
140 | * specifying that individual vector transform should be skipped |
||
141 | * when the mask byte is zero. This is always present as a |
||
142 | * parameter, to allow a unified interface. |
||
143 | */ |
||
144 | typedef void (_XFORMAPIP transform_func)( GLvector4f *to_vec, |
||
145 | CONST GLfloat m[16], |
||
146 | CONST GLvector4f *from_vec ); |
||
147 | |||
148 | |||
149 | extern dotprod_func _mesa_dotprod_tab[5]; |
||
150 | extern vec_copy_func _mesa_copy_tab[0x10]; |
||
151 | extern vec_copy_func _mesa_copy_clean_tab[5]; |
||
152 | extern clip_func _mesa_clip_tab[5]; |
||
153 | extern clip_func _mesa_clip_np_tab[5]; |
||
154 | extern normal_func _mesa_normal_tab[0xf]; |
||
155 | |||
156 | /* Use of 2 layers of linked 1-dimensional arrays to reduce |
||
157 | * cost of lookup. |
||
158 | */ |
||
159 | extern transform_func *_mesa_transform_tab[5]; |
||
160 | |||
161 | |||
162 | |||
163 | #define TransformRaw( to, mat, from ) \ |
||
164 | ( _mesa_transform_tab[(from)->size][(mat)->type]( to, (mat)->m, from ), \ |
||
165 | (to) ) |
||
166 | |||
167 | |||
168 | #endif |