1 /************************************************************************** 2 * 3 * Copyright 2007 VMware, Inc. 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 VMWARE 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 * Authors: 30 * Keith Whitwell <keithw@vmware.com> 31 */ 32 33 #ifndef DRAW_PT_H 34 #define DRAW_PT_H 35 36 #include "pipe/p_compiler.h" 37 38 struct draw_pt_middle_end; 39 struct draw_context; 40 struct draw_prim_info; 41 struct draw_vertex_info; 42 43 44 #define PT_SHADE 0x1 45 #define PT_CLIPTEST 0x2 46 #define PT_PIPELINE 0x4 47 #define PT_MAX_MIDDLE 0x8 48 49 50 /* The "front end" - prepare sets of fetch, draw elements for the 51 * middle end. 52 * 53 * The fetch elements are indices to the vertices. The draw elements are 54 * indices to the fetched vertices. When both arrays of elements are both 55 * linear, middle->run_linear is called; When only the fetch elements are 56 * linear, middle->run_linear_elts is called; Otherwise, middle->run is 57 * called. 58 * 59 * When the number of the draw elements exceeds max_vertex of the middle end, 60 * the draw elements (as well as the fetch elements) are splitted and the 61 * middle end is called multiple times. 62 * 63 * Currenly there is: 64 * - vsplit - catchall implementation, splits big prims 65 */ 66 struct draw_pt_front_end { 67 void (*prepare)( struct draw_pt_front_end *, 68 unsigned prim, 69 struct draw_pt_middle_end *, 70 unsigned opt ); 71 72 void (*run)( struct draw_pt_front_end *, 73 unsigned start, 74 unsigned count ); 75 76 void (*flush)( struct draw_pt_front_end *, unsigned flags ); 77 void (*destroy)( struct draw_pt_front_end * ); 78 }; 79 80 81 /* The "middle end" - prepares actual hardware vertices for the 82 * hardware backend. 83 * 84 * prim_flags is as defined by pipe_draw_info::flags. 85 * 86 * Currently two versions of this: 87 * - fetch, vertex shade, cliptest, prim-pipeline 88 * - fetch, emit (ie passthrough) 89 */ 90 struct draw_pt_middle_end { 91 void (*prepare)( struct draw_pt_middle_end *, 92 unsigned prim, 93 unsigned opt, 94 unsigned *max_vertices ); 95 96 /** 97 * Bind/update parameter state such as constants, viewport dims 98 * and clip planes. Basically, stuff which isn't "baked" into the 99 * shader or pipeline state. 100 */ 101 void (*bind_parameters)(struct draw_pt_middle_end *); 102 103 void (*run)( struct draw_pt_middle_end *, 104 const unsigned *fetch_elts, 105 unsigned fetch_count, 106 const ushort *draw_elts, 107 unsigned draw_count, 108 unsigned prim_flags ); 109 110 void (*run_linear)(struct draw_pt_middle_end *, 111 unsigned start, 112 unsigned count, 113 unsigned prim_flags ); 114 115 /* Transform all vertices in a linear range and then draw them with 116 * the supplied element list. May fail and return FALSE. 117 */ 118 boolean (*run_linear_elts)( struct draw_pt_middle_end *, 119 unsigned fetch_start, 120 unsigned fetch_count, 121 const ushort *draw_elts, 122 unsigned draw_count, 123 unsigned prim_flags ); 124 125 int (*get_max_vertex_count)( struct draw_pt_middle_end * ); 126 127 void (*finish)( struct draw_pt_middle_end * ); 128 void (*destroy)( struct draw_pt_middle_end * ); 129 }; 130 131 132 /* The "back end" - supplied by the driver, defined in draw_vbuf.h. 133 */ 134 struct vbuf_render; 135 struct vertex_header; 136 137 138 /* Frontends: 139 * 140 * Currently only the general-purpose vsplit implementation. 141 */ 142 struct draw_pt_front_end *draw_pt_vsplit(struct draw_context *draw); 143 144 145 /* Middle-ends: 146 * 147 * Currently one general-purpose case which can do all possibilities, 148 * at the slight expense of creating a vertex_header in some cases 149 * unecessarily. 150 * 151 * The special case fetch_emit code avoids pipeline vertices 152 * altogether and builds hardware vertices directly from API 153 * vertex_elements. 154 */ 155 struct draw_pt_middle_end *draw_pt_fetch_emit( struct draw_context *draw ); 156 struct draw_pt_middle_end *draw_pt_middle_fse( struct draw_context *draw ); 157 struct draw_pt_middle_end *draw_pt_fetch_pipeline_or_emit(struct draw_context *draw); 158 struct draw_pt_middle_end *draw_pt_fetch_pipeline_or_emit_llvm(struct draw_context *draw); 159 160 161 162 /******************************************************************************* 163 * HW vertex emit: 164 */ 165 struct pt_emit; 166 167 void draw_pt_emit_prepare( struct pt_emit *emit, 168 unsigned prim, 169 unsigned *max_vertices ); 170 171 void draw_pt_emit( struct pt_emit *emit, 172 const struct draw_vertex_info *vert_info, 173 const struct draw_prim_info *prim_info); 174 175 void draw_pt_emit_linear( struct pt_emit *emit, 176 const struct draw_vertex_info *vert_info, 177 const struct draw_prim_info *prim_info); 178 179 void draw_pt_emit_destroy( struct pt_emit *emit ); 180 181 struct pt_emit *draw_pt_emit_create( struct draw_context *draw ); 182 183 /******************************************************************************* 184 * HW stream output emit: 185 */ 186 struct pt_so_emit; 187 188 void draw_pt_so_emit_prepare(struct pt_so_emit *emit, boolean use_pre_clip_pos); 189 190 void draw_pt_so_emit( struct pt_so_emit *emit, 191 int num_vertex_streams, 192 const struct draw_vertex_info *vert_info, 193 const struct draw_prim_info *prim_info ); 194 195 void draw_pt_so_emit_destroy( struct pt_so_emit *emit ); 196 197 struct pt_so_emit *draw_pt_so_emit_create( struct draw_context *draw ); 198 199 /******************************************************************************* 200 * API vertex fetch: 201 */ 202 203 struct pt_fetch; 204 void draw_pt_fetch_prepare( struct pt_fetch *fetch, 205 unsigned vertex_input_count, 206 unsigned vertex_size, 207 unsigned instance_id_index ); 208 209 void draw_pt_fetch_run( struct pt_fetch *fetch, 210 const unsigned *elts, 211 unsigned count, 212 char *verts ); 213 214 void draw_pt_fetch_run_linear( struct pt_fetch *fetch, 215 unsigned start, 216 unsigned count, 217 char *verts ); 218 219 void draw_pt_fetch_destroy( struct pt_fetch *fetch ); 220 221 struct pt_fetch *draw_pt_fetch_create( struct draw_context *draw ); 222 223 /******************************************************************************* 224 * Post-VS: cliptest, rhw, viewport 225 */ 226 struct pt_post_vs; 227 228 boolean draw_pt_post_vs_run( struct pt_post_vs *pvs, 229 struct draw_vertex_info *info, 230 const struct draw_prim_info *prim_info ); 231 232 void draw_pt_post_vs_prepare( struct pt_post_vs *pvs, 233 boolean clip_xy, 234 boolean clip_z, 235 boolean clip_user, 236 boolean guard_band, 237 boolean bypass_viewport, 238 boolean clip_halfz, 239 boolean need_edgeflags ); 240 241 struct pt_post_vs *draw_pt_post_vs_create( struct draw_context *draw ); 242 243 void draw_pt_post_vs_destroy( struct pt_post_vs *pvs ); 244 245 246 /******************************************************************************* 247 * Utils: 248 */ 249 void draw_pt_split_prim(unsigned prim, unsigned *first, unsigned *incr); 250 unsigned draw_pt_trim_count(unsigned count, unsigned first, unsigned incr); 251 252 253 #endif 254