1 /************************************************************************** 2 * 3 * Copyright 2009 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 * The rast code is concerned with rasterization of command bins. 30 * Each screen tile has a bin associated with it. To render the 31 * scene we iterate over the tile bins and execute the commands 32 * in each bin. 33 * We'll do that with multiple threads... 34 */ 35 36 37 #ifndef LP_RAST_H 38 #define LP_RAST_H 39 40 #include "pipe/p_compiler.h" 41 #include "lp_jit.h" 42 43 44 struct lp_rasterizer; 45 struct lp_scene; 46 struct lp_fence; 47 struct cmd_bin; 48 49 /** For sub-pixel positioning */ 50 #define FIXED_ORDER 4 51 #define FIXED_ONE (1<<FIXED_ORDER) 52 53 54 struct lp_rasterizer_task; 55 56 57 /** 58 * Rasterization state. 59 * Objects of this type are put into the shared data bin and pointed 60 * to by commands in the per-tile bins. 61 */ 62 struct lp_rast_state { 63 /* State for the shader. This also contains state which feeds into 64 * the fragment shader, such as blend color and alpha ref value. 65 */ 66 struct lp_jit_context jit_context; 67 68 /* The shader itself. Probably we also need to pass a pointer to 69 * the tile color/z/stencil data somehow 70 */ 71 struct lp_fragment_shader_variant *variant; 72 }; 73 74 75 /** 76 * Coefficients necessary to run the shader at a given location. 77 * First coefficient is position. 78 * These pointers point into the bin data buffer. 79 */ 80 struct lp_rast_shader_inputs { 81 unsigned frontfacing:1; /** True for front-facing */ 82 unsigned disable:1; /** Partially binned, disable this command */ 83 unsigned opaque:1; /** Is opaque */ 84 unsigned pad0:29; /* wasted space */ 85 unsigned stride; /* how much to advance data between a0, dadx, dady */ 86 unsigned pad2; /* wasted space */ 87 unsigned pad3; /* wasted space */ 88 /* followed by a0, dadx, dady and planes[] */ 89 }; 90 91 /* Note: the order of these values is important as they are loaded by 92 * sse code in rasterization: 93 */ 94 struct lp_rast_plane { 95 /* edge function values at minx,miny ?? */ 96 int c; 97 98 int dcdx; 99 int dcdy; 100 101 /* one-pixel sized trivial reject offsets for each plane */ 102 int eo; 103 }; 104 105 /** 106 * Rasterization information for a triangle known to be in this bin, 107 * plus inputs to run the shader: 108 * These fields are tile- and bin-independent. 109 * Objects of this type are put into the lp_setup_context::data buffer. 110 */ 111 struct lp_rast_triangle { 112 #ifdef DEBUG 113 float v[3][2]; 114 float pad0; 115 float pad1; 116 #endif 117 118 /* inputs for the shader */ 119 struct lp_rast_shader_inputs inputs; 120 /* planes are also allocated here */ 121 }; 122 123 124 #define GET_A0(inputs) ((float (*)[4])((inputs)+1)) 125 #define GET_DADX(inputs) ((float (*)[4])((char *)((inputs) + 1) + (inputs)->stride)) 126 #define GET_DADY(inputs) ((float (*)[4])((char *)((inputs) + 1) + 2 * (inputs)->stride)) 127 #define GET_PLANES(tri) ((struct lp_rast_plane *)((char *)(&(tri)->inputs + 1) + 3 * (tri)->inputs.stride)) 128 129 130 131 struct lp_rasterizer * 132 lp_rast_create( unsigned num_threads ); 133 134 void 135 lp_rast_destroy( struct lp_rasterizer * ); 136 137 unsigned 138 lp_rast_get_num_threads( struct lp_rasterizer * ); 139 140 void 141 lp_rast_queue_scene( struct lp_rasterizer *rast, 142 struct lp_scene *scene ); 143 144 void 145 lp_rast_finish( struct lp_rasterizer *rast ); 146 147 148 union lp_rast_cmd_arg { 149 const struct lp_rast_shader_inputs *shade_tile; 150 struct { 151 const struct lp_rast_triangle *tri; 152 unsigned plane_mask; 153 } triangle; 154 const struct lp_rast_state *set_state; 155 uint8_t clear_color[4]; 156 struct { 157 uint32_t value; 158 uint32_t mask; 159 } clear_zstencil; 160 const struct lp_rast_state *state; 161 struct lp_fence *fence; 162 struct llvmpipe_query *query_obj; 163 }; 164 165 166 /* Cast wrappers. Hopefully these compile to noops! 167 */ 168 static INLINE union lp_rast_cmd_arg 169 lp_rast_arg_inputs( const struct lp_rast_shader_inputs *shade_tile ) 170 { 171 union lp_rast_cmd_arg arg; 172 arg.shade_tile = shade_tile; 173 return arg; 174 } 175 176 static INLINE union lp_rast_cmd_arg 177 lp_rast_arg_triangle( const struct lp_rast_triangle *triangle, 178 unsigned plane_mask) 179 { 180 union lp_rast_cmd_arg arg; 181 arg.triangle.tri = triangle; 182 arg.triangle.plane_mask = plane_mask; 183 return arg; 184 } 185 186 /** 187 * Build argument for a contained triangle. 188 * 189 * All planes are enabled, so instead of the plane mask we pass the upper 190 * left coordinates of the a block that fully encloses the triangle. 191 */ 192 static INLINE union lp_rast_cmd_arg 193 lp_rast_arg_triangle_contained( const struct lp_rast_triangle *triangle, 194 unsigned x, unsigned y) 195 { 196 union lp_rast_cmd_arg arg; 197 arg.triangle.tri = triangle; 198 arg.triangle.plane_mask = x | (y << 8); 199 return arg; 200 } 201 202 static INLINE union lp_rast_cmd_arg 203 lp_rast_arg_state( const struct lp_rast_state *state ) 204 { 205 union lp_rast_cmd_arg arg; 206 arg.set_state = state; 207 return arg; 208 } 209 210 static INLINE union lp_rast_cmd_arg 211 lp_rast_arg_fence( struct lp_fence *fence ) 212 { 213 union lp_rast_cmd_arg arg; 214 arg.fence = fence; 215 return arg; 216 } 217 218 219 static INLINE union lp_rast_cmd_arg 220 lp_rast_arg_clearzs( unsigned value, unsigned mask ) 221 { 222 union lp_rast_cmd_arg arg; 223 arg.clear_zstencil.value = value; 224 arg.clear_zstencil.mask = mask; 225 return arg; 226 } 227 228 229 static INLINE union lp_rast_cmd_arg 230 lp_rast_arg_query( struct llvmpipe_query *pq ) 231 { 232 union lp_rast_cmd_arg arg; 233 arg.query_obj = pq; 234 return arg; 235 } 236 237 static INLINE union lp_rast_cmd_arg 238 lp_rast_arg_null( void ) 239 { 240 union lp_rast_cmd_arg arg; 241 arg.set_state = NULL; 242 return arg; 243 } 244 245 246 /** 247 * Binnable Commands. 248 * These get put into bins by the setup code and are called when 249 * the bins are executed. 250 */ 251 #define LP_RAST_OP_CLEAR_COLOR 0x0 252 #define LP_RAST_OP_CLEAR_ZSTENCIL 0x1 253 #define LP_RAST_OP_TRIANGLE_1 0x2 254 #define LP_RAST_OP_TRIANGLE_2 0x3 255 #define LP_RAST_OP_TRIANGLE_3 0x4 256 #define LP_RAST_OP_TRIANGLE_4 0x5 257 #define LP_RAST_OP_TRIANGLE_5 0x6 258 #define LP_RAST_OP_TRIANGLE_6 0x7 259 #define LP_RAST_OP_TRIANGLE_7 0x8 260 #define LP_RAST_OP_TRIANGLE_8 0x9 261 #define LP_RAST_OP_TRIANGLE_3_4 0xa 262 #define LP_RAST_OP_TRIANGLE_3_16 0xb 263 #define LP_RAST_OP_TRIANGLE_4_16 0xc 264 #define LP_RAST_OP_SHADE_TILE 0xd 265 #define LP_RAST_OP_SHADE_TILE_OPAQUE 0xe 266 #define LP_RAST_OP_BEGIN_QUERY 0xf 267 #define LP_RAST_OP_END_QUERY 0x10 268 #define LP_RAST_OP_SET_STATE 0x11 269 270 #define LP_RAST_OP_MAX 0x12 271 #define LP_RAST_OP_MASK 0xff 272 273 void 274 lp_debug_bins( struct lp_scene *scene ); 275 void 276 lp_debug_draw_bins_by_cmd_length( struct lp_scene *scene ); 277 void 278 lp_debug_draw_bins_by_coverage( struct lp_scene *scene ); 279 280 281 #endif 282