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 "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    float facing;     /** Positive for front-facing, negative for back-facing */
  82    unsigned disable:1;  /** Partially binned, disable this command */
  83    unsigned opaque:1;   /** Is opaque */
  84
  85    float (*a0)[4];
  86    float (*dadx)[4];
  87    float (*dady)[4];
  88 };
  89
  90 /* Note: the order of these values is important as they are loaded by
  91  * sse code in rasterization:
  92  */
  93 struct lp_rast_plane {
  94    /* edge function values at minx,miny ?? */
  95    int c;
  96
  97    int dcdx;
  98    int dcdy;
  99
 100    /* one-pixel sized trivial reject offsets for each plane */
 101    int eo;
 102
 103    /* one-pixel sized trivial accept offsets for each plane */
 104    int ei;
 105 };
 106
 107 /**
 108  * Rasterization information for a triangle known to be in this bin,
 109  * plus inputs to run the shader:
 110  * These fields are tile- and bin-independent.
 111  * Objects of this type are put into the lp_setup_context::data buffer.
 112  */
 113 struct lp_rast_triangle {
 114    /* inputs for the shader */
 115    struct lp_rast_shader_inputs inputs;
 116
 117 #ifdef DEBUG
 118    float v[3][2];
 119 #endif
 120
 121    struct lp_rast_plane plane[8]; /* NOTE: may allocate fewer planes */
 122 };
 123
 124
 125
 126 struct lp_rasterizer *
 127 lp_rast_create( unsigned num_threads );
 128
 129 void
 130 lp_rast_destroy( struct lp_rasterizer * );
 131
 132 unsigned
 133 lp_rast_get_num_threads( struct lp_rasterizer * );
 134
 135 void
 136 lp_rast_queue_scene( struct lp_rasterizer *rast,
 137                      struct lp_scene *scene );
 138
 139 void
 140 lp_rast_finish( struct lp_rasterizer *rast );
 141
 142
 143 union lp_rast_cmd_arg {
 144    const struct lp_rast_shader_inputs *shade_tile;
 145    struct {
 146       const struct lp_rast_triangle *tri;
 147       unsigned plane_mask;
 148    } triangle;
 149    const struct lp_rast_state *set_state;
 150    uint8_t clear_color[4];
 151    struct {
 152       uint32_t value;
 153       uint32_t mask;
 154    } clear_zstencil;
 155    const struct lp_rast_state *state;
 156    struct lp_fence *fence;
 157    struct llvmpipe_query *query_obj;
 158 };
 159
 160
 161 /* Cast wrappers.  Hopefully these compile to noops!
 162  */
 163 static INLINE union lp_rast_cmd_arg
 164 lp_rast_arg_inputs( const struct lp_rast_shader_inputs *shade_tile )
 165 {
 166    union lp_rast_cmd_arg arg;
 167    arg.shade_tile = shade_tile;
 168    return arg;
 169 }
 170
 171 static INLINE union lp_rast_cmd_arg
 172 lp_rast_arg_triangle( const struct lp_rast_triangle *triangle,
 173                       unsigned plane_mask)
 174 {
 175    union lp_rast_cmd_arg arg;
 176    arg.triangle.tri = triangle;
 177    arg.triangle.plane_mask = plane_mask;
 178    return arg;
 179 }
 180
 181 static INLINE union lp_rast_cmd_arg
 182 lp_rast_arg_state( const struct lp_rast_state *state )
 183 {
 184    union lp_rast_cmd_arg arg;
 185    arg.set_state = state;
 186    return arg;
 187 }
 188
 189 static INLINE union lp_rast_cmd_arg
 190 lp_rast_arg_fence( struct lp_fence *fence )
 191 {
 192    union lp_rast_cmd_arg arg;
 193    arg.fence = fence;
 194    return arg;
 195 }
 196
 197
 198 static INLINE union lp_rast_cmd_arg
 199 lp_rast_arg_clearzs( unsigned value, unsigned mask )
 200 {
 201    union lp_rast_cmd_arg arg;
 202    arg.clear_zstencil.value = value;
 203    arg.clear_zstencil.mask = mask;
 204    return arg;
 205 }
 206
 207
 208 static INLINE union lp_rast_cmd_arg
 209 lp_rast_arg_query( struct llvmpipe_query *pq )
 210 {
 211    union lp_rast_cmd_arg arg;
 212    arg.query_obj = pq;
 213    return arg;
 214 }
 215
 216 static INLINE union lp_rast_cmd_arg
 217 lp_rast_arg_null( void )
 218 {
 219    union lp_rast_cmd_arg arg;
 220    arg.set_state = NULL;
 221    return arg;
 222 }
 223
 224
 225 /**
 226  * Binnable Commands.
 227  * These get put into bins by the setup code and are called when
 228  * the bins are executed.
 229  */
 230 #define LP_RAST_OP_CLEAR_COLOR       0x0
 231 #define LP_RAST_OP_CLEAR_ZSTENCIL    0x1
 232 #define LP_RAST_OP_TRIANGLE_1        0x2
 233 #define LP_RAST_OP_TRIANGLE_2        0x3
 234 #define LP_RAST_OP_TRIANGLE_3        0x4
 235 #define LP_RAST_OP_TRIANGLE_4        0x5
 236 #define LP_RAST_OP_TRIANGLE_5        0x6
 237 #define LP_RAST_OP_TRIANGLE_6        0x7
 238 #define LP_RAST_OP_TRIANGLE_7        0x8
 239 #define LP_RAST_OP_TRIANGLE_8        0x9
 240 #define LP_RAST_OP_TRIANGLE_3_4      0xa
 241 #define LP_RAST_OP_TRIANGLE_3_16     0xb
 242 #define LP_RAST_OP_TRIANGLE_4_16     0xc
 243 #define LP_RAST_OP_SHADE_TILE        0xd
 244 #define LP_RAST_OP_SHADE_TILE_OPAQUE 0xe
 245 #define LP_RAST_OP_BEGIN_QUERY       0xf
 246 #define LP_RAST_OP_END_QUERY         0x10
 247 #define LP_RAST_OP_SET_STATE         0x11
 248
 249 #define LP_RAST_OP_MAX               0x12
 250 #define LP_RAST_OP_MASK              0xff
 251
 252 void
 253 lp_debug_bins( struct lp_scene *scene );
 254 void
 255 lp_debug_draw_bins_by_cmd_length( struct lp_scene *scene );
 256 void
 257 lp_debug_draw_bins_by_coverage( struct lp_scene *scene );
 258
 259
 260 #endif