1 /************************************************************************** 2 * 3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4 * All Rights Reserved. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a 7 * copy of this software and associated documentation files (the 8 * "Software"), to deal in the Software without restriction, including 9 * without limitation the rights to use, copy, modify, merge, publish, 10 * distribute, sub license, and/or sell copies of the Software, and to 11 * permit persons to whom the Software is furnished to do so, subject to 12 * the following conditions: 13 * 14 * The above copyright notice and this permission notice (including the 15 * next paragraph) shall be included in all copies or substantial portions 16 * of the Software. 17 * 18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25 * 26 **************************************************************************/ 27 28 /** 29 * Post-transform vertex format info. The vertex_info struct is used by 30 * the draw_vbuf code to emit hardware-specific vertex layouts into hw 31 * vertex buffers. 32 * 33 * Author: 34 * Brian Paul 35 */ 36 37 38 #ifndef DRAW_VERTEX_H 39 #define DRAW_VERTEX_H 40 41 42 #include "pipe/p_compiler.h" 43 #include "pipe/p_state.h" 44 #include "util/u_debug.h" 45 #include "util/u_memory.h" 46 47 48 /** 49 * Vertex attribute emit modes 50 */ 51 enum attrib_emit { 52 EMIT_OMIT, /**< don't emit the attribute */ 53 EMIT_1F, 54 EMIT_1F_PSIZE, /**< insert constant point size */ 55 EMIT_2F, 56 EMIT_3F, 57 EMIT_4F, 58 EMIT_4UB, /**< is RGBA like the rest */ 59 EMIT_4UB_BGRA 60 }; 61 62 63 /** 64 * Attribute interpolation mode 65 */ 66 enum interp_mode { 67 INTERP_NONE, /**< never interpolate vertex header info */ 68 INTERP_POS, /**< special case for frag position */ 69 INTERP_CONSTANT, 70 INTERP_LINEAR, 71 INTERP_PERSPECTIVE 72 }; 73 74 75 /** 76 * Information about hardware/rasterization vertex layout. 77 */ 78 struct vertex_info 79 { 80 uint num_attribs; 81 uint hwfmt[4]; /**< hardware format info for this format */ 82 uint size; /**< total vertex size in dwords */ 83 84 /* Keep this small and at the end of the struct to allow quick 85 * memcmp() comparisons. 86 */ 87 struct { 88 unsigned interp_mode:4; /**< INTERP_x */ 89 unsigned emit:4; /**< EMIT_x */ 90 unsigned src_index:8; /**< map to post-xform attribs */ 91 } attrib[PIPE_MAX_SHADER_OUTPUTS]; 92 }; 93 94 static INLINE size_t 95 draw_vinfo_size( const struct vertex_info *a ) 96 { 97 return offsetof(const struct vertex_info, attrib[a->num_attribs]); 98 } 99 100 static INLINE int 101 draw_vinfo_compare( const struct vertex_info *a, 102 const struct vertex_info *b ) 103 { 104 size_t sizea = draw_vinfo_size( a ); 105 return memcmp( a, b, sizea ); 106 } 107 108 static INLINE void 109 draw_vinfo_copy( struct vertex_info *dst, 110 const struct vertex_info *src ) 111 { 112 size_t size = draw_vinfo_size( src ); 113 memcpy( dst, src, size ); 114 } 115 116 117 118 /** 119 * Add another attribute to the given vertex_info object. 120 * \param src_index indicates which post-transformed vertex attrib slot 121 * corresponds to this attribute. 122 * \return slot in which the attribute was added 123 */ 124 static INLINE uint 125 draw_emit_vertex_attr(struct vertex_info *vinfo, 126 enum attrib_emit emit, 127 enum interp_mode interp, /* only used by softpipe??? */ 128 uint src_index) 129 { 130 const uint n = vinfo->num_attribs; 131 assert(n < Elements(vinfo->attrib)); 132 vinfo->attrib[n].emit = emit; 133 vinfo->attrib[n].interp_mode = interp; 134 vinfo->attrib[n].src_index = src_index; 135 vinfo->num_attribs++; 136 return n; 137 } 138 139 140 extern void draw_compute_vertex_size(struct vertex_info *vinfo); 141 142 void draw_dump_emitted_vertex(const struct vertex_info *vinfo, 143 const uint8_t *data); 144 145 146 static INLINE enum pipe_format draw_translate_vinfo_format(enum attrib_emit emit) 147 { 148 switch (emit) { 149 case EMIT_OMIT: 150 return PIPE_FORMAT_NONE; 151 case EMIT_1F: 152 case EMIT_1F_PSIZE: 153 return PIPE_FORMAT_R32_FLOAT; 154 case EMIT_2F: 155 return PIPE_FORMAT_R32G32_FLOAT; 156 case EMIT_3F: 157 return PIPE_FORMAT_R32G32B32_FLOAT; 158 case EMIT_4F: 159 return PIPE_FORMAT_R32G32B32A32_FLOAT; 160 case EMIT_4UB: 161 return PIPE_FORMAT_R8G8B8A8_UNORM; 162 case EMIT_4UB_BGRA: 163 return PIPE_FORMAT_B8G8R8A8_UNORM; 164 default: 165 assert(!"unexpected format"); 166 return PIPE_FORMAT_NONE; 167 } 168 } 169 170 static INLINE unsigned draw_translate_vinfo_size(enum attrib_emit emit) 171 { 172 switch (emit) { 173 case EMIT_OMIT: 174 return 0; 175 case EMIT_1F: 176 case EMIT_1F_PSIZE: 177 return 1 * sizeof(float); 178 case EMIT_2F: 179 return 2 * sizeof(float); 180 case EMIT_3F: 181 return 3 * sizeof(float); 182 case EMIT_4F: 183 return 4 * sizeof(float); 184 case EMIT_4UB: 185 return 4 * sizeof(unsigned char); 186 case EMIT_4UB_BGRA: 187 return 4 * sizeof(unsigned char); 188 default: 189 assert(!"unexpected format"); 190 return 0; 191 } 192 } 193 194 #endif /* DRAW_VERTEX_H */ 195