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
  83    float (*a0)[4];
  84    float (*dadx)[4];
  85    float (*dady)[4];
  86
  87    const struct lp_rast_state *state;
  88 };
  89
  90 struct lp_rast_clearzs {
  91    unsigned clearzs_value;
  92    unsigned clearzs_mask;
  93 };
  94
  95 struct lp_rast_plane {
  96    /* one-pixel sized trivial accept offsets for each plane */
  97    int ei;
  98
  99    /* one-pixel sized trivial reject offsets for each plane */
 100    int eo;
 101
 102    /* edge function values at minx,miny ?? */
 103    int c;
 104
 105    int dcdx;
 106    int dcdy;
 107
 108    /* edge/step info for 3 edges and 4x4 block of pixels */
 109    const int *step;
 110 };
 111
 112 /**
 113  * Rasterization information for a triangle known to be in this bin,
 114  * plus inputs to run the shader:
 115  * These fields are tile- and bin-independent.
 116  * Objects of this type are put into the lp_setup_context::data buffer.
 117  */
 118 struct lp_rast_triangle {
 119    /* inputs for the shader */
 120    struct lp_rast_shader_inputs inputs;
 121
 122    int step[3][16];
 123
 124 #ifdef DEBUG
 125    float v[3][2];
 126 #endif
 127
 128    struct lp_rast_plane plane[7]; /* NOTE: may allocate fewer planes */
 129 };
 130
 131
 132
 133 struct lp_rasterizer *
 134 lp_rast_create( unsigned num_threads );
 135
 136 void
 137 lp_rast_destroy( struct lp_rasterizer * );
 138
 139 unsigned
 140 lp_rast_get_num_threads( struct lp_rasterizer * );
 141
 142 void
 143 lp_rast_queue_scene( struct lp_rasterizer *rast,
 144                      struct lp_scene *scene );
 145
 146 void
 147 lp_rast_finish( struct lp_rasterizer *rast );
 148
 149
 150 union lp_rast_cmd_arg {
 151    const struct lp_rast_shader_inputs *shade_tile;
 152    struct {
 153       const struct lp_rast_triangle *tri;
 154       unsigned plane_mask;
 155    } triangle;
 156    const struct lp_rast_state *set_state;
 157    uint8_t clear_color[4];
 158    const struct lp_rast_clearzs *clear_zstencil;
 159    struct lp_fence *fence;
 160    struct llvmpipe_query *query_obj;
 161 };
 162
 163
 164 /* Cast wrappers.  Hopefully these compile to noops!
 165  */
 166 static INLINE union lp_rast_cmd_arg
 167 lp_rast_arg_inputs( const struct lp_rast_shader_inputs *shade_tile )
 168 {
 169    union lp_rast_cmd_arg arg;
 170    arg.shade_tile = shade_tile;
 171    return arg;
 172 }
 173
 174 static INLINE union lp_rast_cmd_arg
 175 lp_rast_arg_triangle( const struct lp_rast_triangle *triangle,
 176                       unsigned plane_mask)
 177 {
 178    union lp_rast_cmd_arg arg;
 179    arg.triangle.tri = triangle;
 180    arg.triangle.plane_mask = plane_mask;
 181    return arg;
 182 }
 183
 184 static INLINE union lp_rast_cmd_arg
 185 lp_rast_arg_state( const struct lp_rast_state *state )
 186 {
 187    union lp_rast_cmd_arg arg;
 188    arg.set_state = state;
 189    return arg;
 190 }
 191
 192 static INLINE union lp_rast_cmd_arg
 193 lp_rast_arg_fence( struct lp_fence *fence )
 194 {
 195    union lp_rast_cmd_arg arg;
 196    arg.fence = fence;
 197    return arg;
 198 }
 199
 200
 201 static INLINE union lp_rast_cmd_arg
 202 lp_rast_arg_clearzs( const struct lp_rast_clearzs *clearzs )
 203 {
 204    union lp_rast_cmd_arg arg;
 205    arg.clear_zstencil = clearzs;
 206    return arg;
 207 }
 208
 209 static INLINE union lp_rast_cmd_arg
 210 lp_rast_arg_null( void )
 211 {
 212    union lp_rast_cmd_arg arg;
 213    arg.set_state = NULL;
 214    return arg;
 215 }
 216
 217
 218 /**
 219  * Binnable Commands.
 220  * These get put into bins by the setup code and are called when
 221  * the bins are executed.
 222  */
 223
 224 void lp_rast_clear_color( struct lp_rasterizer_task *,
 225                           const union lp_rast_cmd_arg );
 226
 227 void lp_rast_clear_zstencil( struct lp_rasterizer_task *,
 228                              const union lp_rast_cmd_arg );
 229
 230 void lp_rast_triangle_1( struct lp_rasterizer_task *,
 231                          const union lp_rast_cmd_arg );
 232 void lp_rast_triangle_2( struct lp_rasterizer_task *,
 233                          const union lp_rast_cmd_arg );
 234 void lp_rast_triangle_3( struct lp_rasterizer_task *,
 235                          const union lp_rast_cmd_arg );
 236 void lp_rast_triangle_4( struct lp_rasterizer_task *,
 237                          const union lp_rast_cmd_arg );
 238 void lp_rast_triangle_5( struct lp_rasterizer_task *,
 239                          const union lp_rast_cmd_arg );
 240 void lp_rast_triangle_6( struct lp_rasterizer_task *,
 241                          const union lp_rast_cmd_arg );
 242 void lp_rast_triangle_7( struct lp_rasterizer_task *,
 243                          const union lp_rast_cmd_arg );
 244
 245 void lp_rast_shade_tile( struct lp_rasterizer_task *,
 246                          const union lp_rast_cmd_arg );
 247
 248 void lp_rast_shade_tile_opaque( struct lp_rasterizer_task *,
 249                                 const union lp_rast_cmd_arg );
 250
 251 void lp_rast_fence( struct lp_rasterizer_task *,
 252                     const union lp_rast_cmd_arg );
 253
 254 void lp_rast_store_linear_color( struct lp_rasterizer_task *,
 255                           const union lp_rast_cmd_arg );
 256
 257
 258 void lp_rast_begin_query(struct lp_rasterizer_task *,
 259                          const union lp_rast_cmd_arg );
 260
 261 void lp_rast_end_query(struct lp_rasterizer_task *,
 262                        const union lp_rast_cmd_arg );
 263
 264
 265 #endif