Subversion Repositories shark

Rev

Rev 56 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
56 pj 1 
/* $Id: m_vector.h,v 1.1 2003-02-28 11:48:05 pj Exp $ */
2 
 
3 
/*
4 
 * Mesa 3-D graphics library
5 
 * Version:  3.5
6 
 *
7 
 * Copyright (C) 1999-2001  Brian Paul   All Rights Reserved.
8 
 *
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:
15 
 *
16 
 * The above copyright notice and this permission notice shall be included
17 
 * in all copies or substantial portions of the Software.
18 
 *
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.
25 
 */
26 
 
27 
/*
28 
 * New (3.1) transformation code written by Keith Whitwell.
29 
 */
30 
 
31 
 
32 
#ifndef _M_VECTOR_H_
33 
#define _M_VECTOR_H_
34 
 
35 
#include "glheader.h"
36 
#include "mtypes.h"             /* hack for GLchan */
37 
 
38 
 
39 
#define VEC_DIRTY_0        0x1
40 
#define VEC_DIRTY_1        0x2
41 
#define VEC_DIRTY_2        0x4
42 
#define VEC_DIRTY_3        0x8
43 
#define VEC_MALLOC         0x10 /* storage field points to self-allocated mem*/
44 
#define VEC_NOT_WRITEABLE  0x40 /* writable elements to hold clipped data */
45 
#define VEC_BAD_STRIDE     0x100 /* matches tnl's prefered stride */
46 
 
47 
 
48 
#define VEC_SIZE_1   VEC_DIRTY_0
49 
#define VEC_SIZE_2   (VEC_DIRTY_0|VEC_DIRTY_1)
50 
#define VEC_SIZE_3   (VEC_DIRTY_0|VEC_DIRTY_1|VEC_DIRTY_2)
51 
#define VEC_SIZE_4   (VEC_DIRTY_0|VEC_DIRTY_1|VEC_DIRTY_2|VEC_DIRTY_3)
52 
 
53 
 
54 
 
55 
/* Wrap all the information about vectors up in a struct.  Has
56 
 * additional fields compared to the other vectors to help us track of
57 
 * different vertex sizes, and whether we need to clean columns out
58 
 * because they contain non-(0,0,0,1) values.
59 
 *
60 
 * The start field is used to reserve data for copied vertices at the
61 
 * end of _mesa_transform_vb, and avoids the need for a multiplication in
62 
 * the transformation routines.
63 
 */
64 
typedef struct {
65 
   GLfloat (*data)[4];  /* may be malloc'd or point to client data */
66 
   GLfloat *start;      /* points somewhere inside of <data> */
67 
   GLuint count;        /* size of the vector (in elements) */
68 
   GLuint stride;       /* stride from one element to the next (in bytes) */
69 
   GLuint size;         /* 2-4 for vertices and 1-4 for texcoords */
70 
   GLuint flags;        /* which columns are dirty */
71 
   void *storage;       /* self-allocated storage */
72 
} GLvector4f;
73 
 
74 
 
75 
extern void _mesa_vector4f_init( GLvector4f *v, GLuint flags,
76 
                              GLfloat (*storage)[4] );
77 
extern void _mesa_vector4f_alloc( GLvector4f *v, GLuint flags,
78 
                               GLuint count, GLuint alignment );
79 
extern void _mesa_vector4f_free( GLvector4f *v );
80 
extern void _mesa_vector4f_print( GLvector4f *v, GLubyte *, GLboolean );
81 
extern void _mesa_vector4f_clean_elem( GLvector4f *vec, GLuint nr, GLuint elt );
82 
 
83 
 
84 
/* Could use a single vector type for normals and vertices, but
85 
 * this way avoids some casts.
86 
 */
87 
typedef struct {
88 
   GLfloat (*data)[3];
89 
   GLfloat *start;
90 
   GLuint count;
91 
   GLuint stride;
92 
   GLuint flags;
93 
   void *storage;
94 
} GLvector3f;
95 
 
96 
extern void _mesa_vector3f_init( GLvector3f *v, GLuint flags, GLfloat (*)[3] );
97 
extern void _mesa_vector3f_alloc( GLvector3f *v, GLuint flags, GLuint count,
98 
                               GLuint alignment );
99 
extern void _mesa_vector3f_free( GLvector3f *v );
100 
extern void _mesa_vector3f_print( GLvector3f *v, GLubyte *, GLboolean );
101 
 
102 
 
103 
typedef struct {
104 
   GLfloat *data;
105 
   GLfloat *start;
106 
   GLuint count;
107 
   GLuint stride;
108 
   GLuint flags;
109 
   void *storage;
110 
} GLvector1f;
111 
 
112 
extern void _mesa_vector1f_free( GLvector1f *v );
113 
extern void _mesa_vector1f_init( GLvector1f *v, GLuint flags, GLfloat * );
114 
extern void _mesa_vector1f_alloc( GLvector1f *v, GLuint flags, GLuint count,
115 
                               GLuint alignment );
116 
 
117 
 
118 
/* For 4ub rgba values.
119 
 */
120 
typedef struct {
121 
   GLubyte (*data)[4];
122 
   GLubyte *start;
123 
   GLuint count;
124 
   GLuint stride;
125 
   GLuint flags;
126 
   void *storage;
127 
} GLvector4ub;
128 
 
129 
extern void _mesa_vector4ub_init( GLvector4ub *v, GLuint flags,
130 
                               GLubyte (*storage)[4] );
131 
extern void _mesa_vector4ub_alloc( GLvector4ub *v, GLuint flags, GLuint count,
132 
                                GLuint alignment );
133 
extern void _mesa_vector4ub_free( GLvector4ub * );
134 
 
135 
 
136 
/* For 4 * GLchan values.
137 
 */
138 
typedef struct {
139 
   GLchan (*data)[4];
140 
   GLchan *start;
141 
   GLuint count;
142 
   GLuint stride;
143 
   GLuint flags;
144 
   void *storage;
145 
} GLvector4chan;
146 
 
147 
extern void _mesa_vector4chan_init( GLvector4chan *v, GLuint flags,
148 
                                 GLchan (*storage)[4] );
149 
extern void _mesa_vector4chan_alloc( GLvector4chan *v, GLuint flags, GLuint count,
150 
                                  GLuint alignment );
151 
extern void _mesa_vector4chan_free( GLvector4chan * );
152 
 
153 
 
154 
 
155 
 
156 
/* For 4 * GLushort rgba values.
157 
 */
158 
typedef struct {
159 
   GLushort (*data)[4];
160 
   GLushort *start;
161 
   GLuint count;
162 
   GLuint stride;
163 
   GLuint flags;
164 
   void *storage;
165 
} GLvector4us;
166 
 
167 
extern void _mesa_vector4us_init( GLvector4us *v, GLuint flags,
168 
                               GLushort (*storage)[4] );
169 
extern void _mesa_vector4us_alloc( GLvector4us *v, GLuint flags, GLuint count,
170 
                                GLuint alignment );
171 
extern void _mesa_vector4us_free( GLvector4us * );
172 
 
173 
 
174 
 
175 
 
176 
/* For 1ub values, eg edgeflag.
177 
 */
178 
typedef struct {
179 
   GLubyte *data;
180 
   GLubyte *start;
181 
   GLuint count;
182 
   GLuint stride;
183 
   GLuint flags;
184 
   void *storage;
185 
} GLvector1ub;
186 
 
187 
extern void _mesa_vector1ub_init( GLvector1ub *v, GLuint flags, GLubyte *storage);
188 
extern void _mesa_vector1ub_alloc( GLvector1ub *v, GLuint flags, GLuint count,
189 
                                GLuint alignment );
190 
extern void _mesa_vector1ub_free( GLvector1ub * );
191 
 
192 
 
193 
 
194 
 
195 
/* For, eg Index, Array element.
196 
 */
197 
typedef struct {
198 
   GLuint *data;
199 
   GLuint *start;
200 
   GLuint count;
201 
   GLuint stride;
202 
   GLuint flags;
203 
   void *storage;
204 
} GLvector1ui;
205 
 
206 
extern void _mesa_vector1ui_init( GLvector1ui *v, GLuint flags, GLuint *storage );
207 
extern void _mesa_vector1ui_alloc( GLvector1ui *v, GLuint flags, GLuint count,
208 
                                GLuint alignment );
209 
extern void _mesa_vector1ui_free( GLvector1ui * );
210 
 
211 
 
212 
 
213 
/*
214 
 * Given vector <v>, return a pointer (cast to <type *> to the <i>-th element.
215 
 *
216 
 * End up doing a lot of slow imuls if not careful.
217 
 */
218 
#define VEC_ELT( v, type, i ) \
219 
       ( (type *)  ( ((GLbyte *) ((v)->data)) + (i) * (v)->stride) )
220 
 
221 
 
222 
#endif