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     * jit_function[0] skips the triangle in/out test code
  71     * jit_function[1] does triangle in/out testing
  72      */
  73    lp_jit_frag_func jit_function[2];
  74
  75    boolean opaque;
  76 };
  77
  78
  79 /**
  80  * Coefficients necessary to run the shader at a given location.
  81  * First coefficient is position.
  82  * These pointers point into the bin data buffer.
  83  */
  84 struct lp_rast_shader_inputs {
  85    float (*a0)[4];
  86    float (*dadx)[4];
  87    float (*dady)[4];
  88
  89    /* edge/step info for 3 edges and 4x4 block of pixels */
  90    PIPE_ALIGN_VAR(16) int step[3][16];
  91 };
  92
  93
  94 /**
  95  * Rasterization information for a triangle known to be in this bin,
  96  * plus inputs to run the shader:
  97  * These fields are tile- and bin-independent.
  98  * Objects of this type are put into the lp_setup_context::data buffer.
  99  */
 100 struct lp_rast_triangle {
 101 #ifdef DEBUG
 102    float v[3][2];
 103 #endif
 104
 105    /* one-pixel sized trivial accept offsets for each plane */
 106    int ei1;
 107    int ei2;
 108    int ei3;
 109
 110    /* one-pixel sized trivial reject offsets for each plane */
 111    int eo1;
 112    int eo2;
 113    int eo3;
 114
 115    /* y deltas for vertex pairs (in fixed pt) */
 116    int dy12;
 117    int dy23;
 118    int dy31;
 119
 120    /* x deltas for vertex pairs (in fixed pt) */
 121    int dx12;
 122    int dx23;
 123    int dx31;
 124
 125    /* edge function values at minx,miny ?? */
 126    int c1, c2, c3;
 127
 128    /* inputs for the shader */
 129    PIPE_ALIGN_VAR(16) struct lp_rast_shader_inputs inputs;
 130 };
 131
 132
 133
 134 struct lp_rasterizer *
 135 lp_rast_create( void );
 136
 137 void
 138 lp_rast_destroy( struct lp_rasterizer * );
 139
 140 unsigned
 141 lp_rast_get_num_threads( struct lp_rasterizer * );
 142
 143 void
 144 lp_rast_queue_scene( struct lp_rasterizer *rast,
 145                      struct lp_scene *scene );
 146
 147 void
 148 lp_rast_finish( struct lp_rasterizer *rast );
 149
 150
 151 union lp_rast_cmd_arg {
 152    const struct lp_rast_shader_inputs *shade_tile;
 153    const struct lp_rast_triangle *triangle;
 154    const struct lp_rast_state *set_state;
 155    uint8_t clear_color[4];
 156    unsigned clear_zstencil;
 157    struct lp_fence *fence;
 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 {
 174    union lp_rast_cmd_arg arg;
 175    arg.triangle = triangle;
 176    return arg;
 177 }
 178
 179 static INLINE union lp_rast_cmd_arg
 180 lp_rast_arg_state( const struct lp_rast_state *state )
 181 {
 182    union lp_rast_cmd_arg arg;
 183    arg.set_state = state;
 184    return arg;
 185 }
 186
 187 static INLINE union lp_rast_cmd_arg
 188 lp_rast_arg_fence( struct lp_fence *fence )
 189 {
 190    union lp_rast_cmd_arg arg;
 191    arg.fence = fence;
 192    return arg;
 193 }
 194
 195
 196 static INLINE union lp_rast_cmd_arg
 197 lp_rast_arg_null( void )
 198 {
 199    union lp_rast_cmd_arg arg;
 200    arg.set_state = NULL;
 201    return arg;
 202 }
 203
 204
 205
 206 /**
 207  * Binnable Commands.
 208  * These get put into bins by the setup code and are called when
 209  * the bins are executed.
 210  */
 211
 212 void lp_rast_clear_color( struct lp_rasterizer_task *,
 213                           const union lp_rast_cmd_arg );
 214
 215 void lp_rast_clear_zstencil( struct lp_rasterizer_task *,
 216                              const union lp_rast_cmd_arg );
 217
 218 void lp_rast_load_color( struct lp_rasterizer_task *,
 219                          const union lp_rast_cmd_arg );
 220
 221 void lp_rast_set_state( struct lp_rasterizer_task *,
 222                         const union lp_rast_cmd_arg );
 223
 224 void lp_rast_triangle( struct lp_rasterizer_task *,
 225                        const union lp_rast_cmd_arg );
 226
 227 void lp_rast_shade_tile( struct lp_rasterizer_task *,
 228                          const union lp_rast_cmd_arg );
 229
 230 void lp_rast_fence( struct lp_rasterizer_task *,
 231                     const union lp_rast_cmd_arg );
 232
 233 #endif