src/gallium/drivers/llvmpipe/lp_rast.h

   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 "util/u_pack_color.h"
  42 #include "lp_jit.h"
  43
  44
  45 struct lp_rasterizer;
  46 struct lp_scene;
  47 struct lp_fence;
  48 struct cmd_bin;
  49
  50 #define FIXED_TYPE_WIDTH 64
  51 /** For sub-pixel positioning */
  52 #define FIXED_ORDER 8
  53 #define FIXED_ONE (1<<FIXED_ORDER)
  54 #define FIXED_SHIFT (FIXED_TYPE_WIDTH - 1)
  55 /** Maximum length of an edge in a primitive in pixels.
  56  *  If the framebuffer is large we have to think about fixed-point
  57  *  integer overflow. Coordinates need ((FIXED_TYPE_WIDTH/2) - 1) bits
  58  *  to be able to fit product of two such coordinates inside
  59  *  FIXED_TYPE_WIDTH, any larger and we could overflow a
  60  *  FIXED_TYPE_WIDTH_-bit int.
  61  */
  62 #define MAX_FIXED_LENGTH (1 << (((FIXED_TYPE_WIDTH/2) - 1) - FIXED_ORDER))
  63
  64 #define MAX_FIXED_LENGTH32 (1 << (((32/2) - 1) - FIXED_ORDER))
  65
  66 /* Rasterizer output size going to jit fs, width/height */
  67 #define LP_RASTER_BLOCK_SIZE 4
  68
  69 #define LP_MAX_ACTIVE_BINNED_QUERIES 64
  70
  71 #define IMUL64(a, b) (((int64_t)(a)) * ((int64_t)(b)))
  72
  73 struct lp_rasterizer_task;
  74
  75
  76 /**
  77  * Rasterization state.
  78  * Objects of this type are put into the shared data bin and pointed
  79  * to by commands in the per-tile bins.
  80  */
  81 struct lp_rast_state {
  82    /* State for the shader.  This also contains state which feeds into
  83     * the fragment shader, such as blend color and alpha ref value.
  84     */
  85    struct lp_jit_context jit_context;
  86
  87    /* The shader itself.  Probably we also need to pass a pointer to
  88     * the tile color/z/stencil data somehow
  89      */
  90    struct lp_fragment_shader_variant *variant;
  91 };
  92
  93
  94 /**
  95  * Coefficients necessary to run the shader at a given location.
  96  * First coefficient is position.
  97  * These pointers point into the bin data buffer.
  98  */
  99 struct lp_rast_shader_inputs {
 100    unsigned frontfacing:1;      /** True for front-facing */
 101    unsigned disable:1;          /** Partially binned, disable this command */
 102    unsigned opaque:1;           /** Is opaque */
 103    unsigned pad0:29;            /* wasted space */
 104    unsigned stride;             /* how much to advance data between a0, dadx, dady */
 105    unsigned layer;              /* the layer to render to (from gs, already clamped) */
 106    unsigned viewport_index;     /* the active viewport index (from gs, already clamped) */
 107    /* followed by a0, dadx, dady and planes[] */
 108 };
 109
 110 struct lp_rast_plane {
 111    /* edge function values at minx,miny ?? */
 112    int64_t c;
 113
 114    int32_t dcdx;
 115    int32_t dcdy;
 116
 117    /* one-pixel sized trivial reject offsets for each plane */
 118    uint32_t eo;
 119    /*
 120     * We rely on this struct being 64bit aligned (ideally it would be 128bit
 121     * but that's quite the waste) and therefore on 32bit we need padding
 122     * since otherwise (even with the 64bit number in there) it wouldn't be.
 123     */
 124    uint32_t pad;
 125 };
 126
 127 /**
 128  * Rasterization information for a triangle known to be in this bin,
 129  * plus inputs to run the shader:
 130  * These fields are tile- and bin-independent.
 131  * Objects of this type are put into the lp_setup_context::data buffer.
 132  */
 133 struct lp_rast_triangle {
 134 #ifdef DEBUG
 135    float v[3][2];
 136    float pad0;
 137    float pad1;
 138 #endif
 139
 140    /* inputs for the shader */
 141    struct lp_rast_shader_inputs inputs;
 142    /* planes are also allocated here */
 143 };
 144
 145
 146 struct lp_rast_clear_rb {
 147    union util_color color_val;
 148    unsigned cbuf;
 149 };
 150
 151
 152 #define GET_A0(inputs) ((float (*)[4])((inputs)+1))
 153 #define GET_DADX(inputs) ((float (*)[4])((char *)((inputs) + 1) + (inputs)->stride))
 154 #define GET_DADY(inputs) ((float (*)[4])((char *)((inputs) + 1) + 2 * (inputs)->stride))
 155 #define GET_PLANES(tri) ((struct lp_rast_plane *)((char *)(&(tri)->inputs + 1) + 3 * (tri)->inputs.stride))
 156
 157
 158
 159 struct lp_rasterizer *
 160 lp_rast_create( unsigned num_threads );
 161
 162 void
 163 lp_rast_destroy( struct lp_rasterizer * );
 164
 165 void
 166 lp_rast_queue_scene( struct lp_rasterizer *rast,
 167                      struct lp_scene *scene );
 168
 169 void
 170 lp_rast_finish( struct lp_rasterizer *rast );
 171
 172
 173 union lp_rast_cmd_arg {
 174    const struct lp_rast_shader_inputs *shade_tile;
 175    struct {
 176       const struct lp_rast_triangle *tri;
 177       unsigned plane_mask;
 178    } triangle;
 179    const struct lp_rast_state *set_state;
 180    const struct lp_rast_clear_rb *clear_rb;
 181    struct {
 182       uint64_t value;
 183       uint64_t mask;
 184    } clear_zstencil;
 185    const struct lp_rast_state *state;
 186    struct lp_fence *fence;
 187    struct llvmpipe_query *query_obj;
 188 };
 189
 190
 191 /* Cast wrappers.  Hopefully these compile to noops!
 192  */
 193 static inline union lp_rast_cmd_arg
 194 lp_rast_arg_inputs( const struct lp_rast_shader_inputs *shade_tile )
 195 {
 196    union lp_rast_cmd_arg arg;
 197    arg.shade_tile = shade_tile;
 198    return arg;
 199 }
 200
 201 static inline union lp_rast_cmd_arg
 202 lp_rast_arg_triangle( const struct lp_rast_triangle *triangle,
 203                       unsigned plane_mask)
 204 {
 205    union lp_rast_cmd_arg arg;
 206    arg.triangle.tri = triangle;
 207    arg.triangle.plane_mask = plane_mask;
 208    return arg;
 209 }
 210
 211 /**
 212  * Build argument for a contained triangle.
 213  *
 214  * All planes are enabled, so instead of the plane mask we pass the upper
 215  * left coordinates of the a block that fully encloses the triangle.
 216  */
 217 static inline union lp_rast_cmd_arg
 218 lp_rast_arg_triangle_contained( const struct lp_rast_triangle *triangle,
 219                                 unsigned x, unsigned y)
 220 {
 221    union lp_rast_cmd_arg arg;
 222    arg.triangle.tri = triangle;
 223    arg.triangle.plane_mask = x | (y << 8);
 224    return arg;
 225 }
 226
 227 static inline union lp_rast_cmd_arg
 228 lp_rast_arg_state( const struct lp_rast_state *state )
 229 {
 230    union lp_rast_cmd_arg arg;
 231    arg.set_state = state;
 232    return arg;
 233 }
 234
 235 static inline union lp_rast_cmd_arg
 236 lp_rast_arg_fence( struct lp_fence *fence )
 237 {
 238    union lp_rast_cmd_arg arg;
 239    arg.fence = fence;
 240    return arg;
 241 }
 242
 243
 244 static inline union lp_rast_cmd_arg
 245 lp_rast_arg_clearzs( uint64_t value, uint64_t mask )
 246 {
 247    union lp_rast_cmd_arg arg;
 248    arg.clear_zstencil.value = value;
 249    arg.clear_zstencil.mask = mask;
 250    return arg;
 251 }
 252
 253
 254 static inline union lp_rast_cmd_arg
 255 lp_rast_arg_query( struct llvmpipe_query *pq )
 256 {
 257    union lp_rast_cmd_arg arg;
 258    arg.query_obj = pq;
 259    return arg;
 260 }
 261
 262 static inline union lp_rast_cmd_arg
 263 lp_rast_arg_null( void )
 264 {
 265    union lp_rast_cmd_arg arg;
 266    arg.set_state = NULL;
 267    return arg;
 268 }
 269
 270
 271 /**
 272  * Binnable Commands.
 273  * These get put into bins by the setup code and are called when
 274  * the bins are executed.
 275  */
 276 #define LP_RAST_OP_CLEAR_COLOR       0x0
 277 #define LP_RAST_OP_CLEAR_ZSTENCIL    0x1
 278 #define LP_RAST_OP_TRIANGLE_1        0x2
 279 #define LP_RAST_OP_TRIANGLE_2        0x3
 280 #define LP_RAST_OP_TRIANGLE_3        0x4
 281 #define LP_RAST_OP_TRIANGLE_4        0x5
 282 #define LP_RAST_OP_TRIANGLE_5        0x6
 283 #define LP_RAST_OP_TRIANGLE_6        0x7
 284 #define LP_RAST_OP_TRIANGLE_7        0x8
 285 #define LP_RAST_OP_TRIANGLE_8        0x9
 286 #define LP_RAST_OP_TRIANGLE_3_4      0xa
 287 #define LP_RAST_OP_TRIANGLE_3_16     0xb
 288 #define LP_RAST_OP_TRIANGLE_4_16     0xc
 289 #define LP_RAST_OP_SHADE_TILE        0xd
 290 #define LP_RAST_OP_SHADE_TILE_OPAQUE 0xe
 291 #define LP_RAST_OP_BEGIN_QUERY       0xf
 292 #define LP_RAST_OP_END_QUERY         0x10
 293 #define LP_RAST_OP_SET_STATE         0x11
 294 #define LP_RAST_OP_TRIANGLE_32_1     0x12
 295 #define LP_RAST_OP_TRIANGLE_32_2     0x13
 296 #define LP_RAST_OP_TRIANGLE_32_3     0x14
 297 #define LP_RAST_OP_TRIANGLE_32_4     0x15
 298 #define LP_RAST_OP_TRIANGLE_32_5     0x16
 299 #define LP_RAST_OP_TRIANGLE_32_6     0x17
 300 #define LP_RAST_OP_TRIANGLE_32_7     0x18
 301 #define LP_RAST_OP_TRIANGLE_32_8     0x19
 302 #define LP_RAST_OP_TRIANGLE_32_3_4   0x1a
 303 #define LP_RAST_OP_TRIANGLE_32_3_16  0x1b
 304 #define LP_RAST_OP_TRIANGLE_32_4_16  0x1c
 305
 306 #define LP_RAST_OP_MAX               0x1d
 307 #define LP_RAST_OP_MASK              0xff
 308
 309 void
 310 lp_debug_bins( struct lp_scene *scene );
 311 void
 312 lp_debug_draw_bins_by_cmd_length( struct lp_scene *scene );
 313 void
 314 lp_debug_draw_bins_by_coverage( struct lp_scene *scene );
 315
 316
 317 #endif