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