src/intel/blorp/blorp_priv.h

   1 /*
   2  * Copyright © 2012 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21  * IN THE SOFTWARE.
  22  */
  23
  24 #ifndef BLORP_PRIV_H
  25 #define BLORP_PRIV_H
  26
  27 #include <stdint.h>
  28
  29 #include "compiler/nir/nir.h"
  30 #include "brw_compiler.h"
  31
  32 #include "blorp.h"
  33
  34 #ifdef __cplusplus
  35 extern "C" {
  36 #endif
  37
  38 /**
  39  * Binding table indices used by BLORP.
  40  */
  41 enum {
  42    BLORP_RENDERBUFFER_BT_INDEX,
  43    BLORP_TEXTURE_BT_INDEX,
  44    BLORP_NUM_BT_ENTRIES
  45 };
  46
  47 enum blorp_fast_clear_op {
  48    BLORP_FAST_CLEAR_OP_NONE = 0,
  49    BLORP_FAST_CLEAR_OP_CLEAR,
  50    BLORP_FAST_CLEAR_OP_RESOLVE_PARTIAL,
  51    BLORP_FAST_CLEAR_OP_RESOLVE_FULL,
  52 };
  53
  54 struct brw_blorp_surface_info
  55 {
  56    bool enabled;
  57
  58    struct isl_surf surf;
  59    struct blorp_address addr;
  60
  61    struct isl_surf aux_surf;
  62    struct blorp_address aux_addr;
  63    enum isl_aux_usage aux_usage;
  64
  65    union isl_color_value clear_color;
  66
  67    struct isl_view view;
  68
  69    /* Z offset into a 3-D texture or slice of a 2-D array texture. */
  70    uint32_t z_offset;
  71
  72    uint32_t tile_x_sa, tile_y_sa;
  73 };
  74
  75 void
  76 brw_blorp_surface_info_init(struct blorp_context *blorp,
  77                             struct brw_blorp_surface_info *info,
  78                             const struct blorp_surf *surf,
  79                             unsigned int level, unsigned int layer,
  80                             enum isl_format format, bool is_render_target);
  81
  82
  83 struct brw_blorp_coord_transform
  84 {
  85    float multiplier;
  86    float offset;
  87 };
  88
  89 /**
  90  * Bounding rectangle telling pixel discard which pixels are not to be
  91  * touched. This is needed in when surfaces are configured as something else
  92  * what they really are:
  93  *
  94  *    - writing W-tiled stencil as Y-tiled
  95  *    - writing interleaved multisampled as single sampled.
  96  *
  97  * See blorp_nir_discard_if_outside_rect().
  98  */
  99 struct brw_blorp_discard_rect
 100 {
 101    uint32_t x0;
 102    uint32_t x1;
 103    uint32_t y0;
 104    uint32_t y1;
 105 };
 106
 107 /**
 108  * Grid needed for blended and scaled blits of integer formats, see
 109  * blorp_nir_manual_blend_bilinear().
 110  */
 111 struct brw_blorp_rect_grid
 112 {
 113    float x1;
 114    float y1;
 115    float pad[2];
 116 };
 117
 118 struct blorp_surf_offset {
 119    uint32_t x;
 120    uint32_t y;
 121 };
 122
 123 struct brw_blorp_wm_inputs
 124 {
 125    struct brw_blorp_discard_rect discard_rect;
 126    struct brw_blorp_rect_grid rect_grid;
 127    struct brw_blorp_coord_transform coord_transform[2];
 128
 129    struct blorp_surf_offset src_offset;
 130    struct blorp_surf_offset dst_offset;
 131
 132    /* Minimum layer setting works for all the textures types but texture_3d
 133     * for which the setting has no effect. Use the z-coordinate instead.
 134     */
 135    uint32_t src_z;
 136
 137    /* Pad out to an integral number of registers */
 138    uint32_t pad[1];
 139 };
 140
 141 static inline unsigned
 142 brw_blorp_get_urb_length(const struct brw_wm_prog_data *prog_data)
 143 {
 144    if (prog_data == NULL)
 145       return 1;
 146
 147    /* From the BSpec: 3D Pipeline - Strips and Fans - 3DSTATE_SBE
 148     *
 149     * read_length = ceiling((max_source_attr+1)/2)
 150     */
 151    return MAX2((prog_data->num_varying_inputs + 1) / 2, 1);
 152 }
 153
 154 struct blorp_params
 155 {
 156    uint32_t x0;
 157    uint32_t y0;
 158    uint32_t x1;
 159    uint32_t y1;
 160    float z;
 161    uint8_t stencil_mask;
 162    uint8_t stencil_ref;
 163    struct brw_blorp_surface_info depth;
 164    struct brw_blorp_surface_info stencil;
 165    uint32_t depth_format;
 166    struct brw_blorp_surface_info src;
 167    struct brw_blorp_surface_info dst;
 168    enum blorp_hiz_op hiz_op;
 169    enum blorp_fast_clear_op fast_clear_op;
 170    bool color_write_disable[4];
 171    struct brw_blorp_wm_inputs wm_inputs;
 172    unsigned num_draw_buffers;
 173    unsigned num_layers;
 174    uint32_t wm_prog_kernel;
 175    struct brw_wm_prog_data *wm_prog_data;
 176 };
 177
 178 void blorp_params_init(struct blorp_params *params);
 179
 180 struct brw_blorp_blit_prog_key
 181 {
 182    /* Number of samples per pixel that have been configured in the surface
 183     * state for texturing from.
 184     */
 185    unsigned tex_samples;
 186
 187    /* MSAA layout that has been configured in the surface state for texturing
 188     * from.
 189     */
 190    enum isl_msaa_layout tex_layout;
 191
 192    enum isl_aux_usage tex_aux_usage;
 193
 194    /* Actual number of samples per pixel in the source image. */
 195    unsigned src_samples;
 196
 197    /* Actual MSAA layout used by the source image. */
 198    enum isl_msaa_layout src_layout;
 199
 200    /* Number of samples per pixel that have been configured in the render
 201     * target.
 202     */
 203    unsigned rt_samples;
 204
 205    /* MSAA layout that has been configured in the render target. */
 206    enum isl_msaa_layout rt_layout;
 207
 208    /* Actual number of samples per pixel in the destination image. */
 209    unsigned dst_samples;
 210
 211    /* Actual MSAA layout used by the destination image. */
 212    enum isl_msaa_layout dst_layout;
 213
 214    /* Type of the data to be read from the texture (one of
 215     * nir_type_(int|uint|float)).
 216     */
 217    nir_alu_type texture_data_type;
 218
 219    /* True if the source image is W tiled.  If true, the surface state for the
 220     * source image must be configured as Y tiled, and tex_samples must be 0.
 221     */
 222    bool src_tiled_w;
 223
 224    /* True if the destination image is W tiled.  If true, the surface state
 225     * for the render target must be configured as Y tiled, and rt_samples must
 226     * be 0.
 227     */
 228    bool dst_tiled_w;
 229
 230    /* True if the destination is an RGB format.  If true, the surface state
 231     * for the render target must be configured as red with three times the
 232     * normal width.  We need to do this because you cannot render to
 233     * non-power-of-two formats.
 234     */
 235    bool dst_rgb;
 236
 237    /* True if all source samples should be blended together to produce each
 238     * destination pixel.  If true, src_tiled_w must be false, tex_samples must
 239     * equal src_samples, and tex_samples must be nonzero.
 240     */
 241    bool blend;
 242
 243    /* True if the rectangle being sent through the rendering pipeline might be
 244     * larger than the destination rectangle, so the WM program should kill any
 245     * pixels that are outside the destination rectangle.
 246     */
 247    bool use_kill;
 248
 249    /**
 250     * True if the WM program should be run in MSDISPMODE_PERSAMPLE with more
 251     * than one sample per pixel.
 252     */
 253    bool persample_msaa_dispatch;
 254
 255    /* True for scaled blitting. */
 256    bool blit_scaled;
 257
 258    /* True if this blit operation may involve intratile offsets on the source.
 259     * In this case, we need to add the offset before texturing.
 260     */
 261    bool need_src_offset;
 262
 263    /* True if this blit operation may involve intratile offsets on the
 264     * destination.  In this case, we need to add the offset to gl_FragCoord.
 265     */
 266    bool need_dst_offset;
 267
 268    /* Scale factors between the pixel grid and the grid of samples. We're
 269     * using grid of samples for bilinear filetring in multisample scaled blits.
 270     */
 271    float x_scale;
 272    float y_scale;
 273
 274    /* True for blits with filter = GL_LINEAR. */
 275    bool bilinear_filter;
 276 };
 277
 278 /**
 279  * \name BLORP internals
 280  * \{
 281  *
 282  * Used internally by gen6_blorp_exec() and gen7_blorp_exec().
 283  */
 284
 285 void brw_blorp_init_wm_prog_key(struct brw_wm_prog_key *wm_key);
 286
 287 const unsigned *
 288 blorp_compile_fs(struct blorp_context *blorp, void *mem_ctx,
 289                  struct nir_shader *nir,
 290                  const struct brw_wm_prog_key *wm_key,
 291                  bool use_repclear,
 292                  struct brw_wm_prog_data *wm_prog_data,
 293                  unsigned *program_size);
 294
 295 /** \} */
 296
 297 #ifdef __cplusplus
 298 } /* end extern "C" */
 299 #endif /* __cplusplus */
 300
 301 #endif /* BLORP_PRIV_H */