protect against broken apps
[mesa.git] / src / mesa / tnl / t_vertex.h
1 /*
2 * Copyright 2003 Tungsten Graphics, inc.
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * on the rights to use, copy, modify, merge, publish, distribute, sub
9 * license, and/or sell copies of the Software, and to permit persons to whom
10 * the Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
19 * TUNGSTEN GRAPHICS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
22 * USE OR OTHER DEALINGS IN THE SOFTWARE.
23 *
24 * Authors:
25 * Keith Whitwell <keithw@tungstengraphics.com>
26 */
27
28 #ifndef _TNL_VERTEX_H
29 #define _TNL_VERTEX_H
30
31 /* New mechanism to specify hardware vertices so that tnl can build
32 * and manipulate them directly.
33 */
34
35
36 /* It will probably be necessary to allow drivers to specify new
37 * emit-styles to cover all the wierd and wacky things out there.
38 */
39 enum tnl_attr_format {
40 EMIT_1F,
41 EMIT_2F,
42 EMIT_3F,
43 EMIT_4F,
44 EMIT_2F_VIEWPORT, /* do viewport transform and emit */
45 EMIT_3F_VIEWPORT, /* do viewport transform and emit */
46 EMIT_4F_VIEWPORT, /* do viewport transform and emit */
47 EMIT_3F_XYW, /* for projective texture */
48 EMIT_1UB_1F, /* for fog coordinate */
49 EMIT_3UB_3F_BGR, /* for specular color */
50 EMIT_3UB_3F_RGB, /* for specular color */
51 EMIT_4UB_4F_BGRA, /* for color */
52 EMIT_4UB_4F_RGBA, /* for color */
53 EMIT_4CHAN_4F_RGBA, /* for swrast color */
54 EMIT_MAX
55 };
56
57 struct tnl_attr_map {
58 GLuint attrib; /* _TNL_ATTRIB_ enum */
59 enum tnl_attr_format format;
60 GLuint offset;
61 };
62
63
64
65 /* Interpolate between two vertices to produce a third:
66 */
67 extern void _tnl_interp( GLcontext *ctx,
68 GLfloat t,
69 GLuint edst, GLuint eout, GLuint ein,
70 GLboolean force_boundary );
71
72 /* Copy colors from one vertex to another:
73 */
74 extern void _tnl_copy_pv( GLcontext *ctx, GLuint edst, GLuint esrc );
75
76
77 /* Extract a named attribute from a hardware vertex. Will have to
78 * reverse any viewport transformation, swizzling or other conversions
79 * which may have been applied:
80 */
81 extern void _tnl_get_attr( GLcontext *ctx, const void *vertex, GLenum attrib,
82 GLfloat *dest );
83
84 extern void *_tnl_get_vertex( GLcontext *ctx, GLuint nr );
85
86
87 /*
88 */
89 extern GLuint _tnl_install_attrs( GLcontext *ctx,
90 const struct tnl_attr_map *map,
91 GLuint nr, const GLfloat *vp,
92 GLuint unpacked_size );
93
94
95
96
97
98 extern void _tnl_free_vertices( GLcontext *ctx );
99
100 extern void _tnl_init_vertices( GLcontext *ctx,
101 GLuint vb_size,
102 GLuint max_vertex_size );
103
104 extern void *_tnl_emit_vertices_to_buffer( GLcontext *ctx,
105 GLuint start,
106 GLuint count,
107 void *dest );
108
109 extern void _tnl_build_vertices( GLcontext *ctx,
110 GLuint start,
111 GLuint count,
112 GLuint newinputs );
113
114 extern void _tnl_invalidate_vertices( GLcontext *ctx, GLuint newinputs );
115
116 extern void _tnl_invalidate_vertex_state( GLcontext *ctx, GLuint new_state );
117
118
119 #endif