• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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_H
25 #define BLORP_H
26 
27 #include <stdint.h>
28 #include <stdbool.h>
29 
30 #include "isl/isl.h"
31 
32 struct brw_stage_prog_data;
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37 
38 struct blorp_batch;
39 struct blorp_params;
40 
41 struct blorp_context {
42    void *driver_ctx;
43 
44    const struct isl_device *isl_dev;
45 
46    const struct brw_compiler *compiler;
47 
48    bool (*lookup_shader)(struct blorp_batch *batch,
49                          const void *key, uint32_t key_size,
50                          uint32_t *kernel_out, void *prog_data_out);
51    bool (*upload_shader)(struct blorp_batch *batch,
52                          uint32_t stage,
53                          const void *key, uint32_t key_size,
54                          const void *kernel, uint32_t kernel_size,
55                          const struct brw_stage_prog_data *prog_data,
56                          uint32_t prog_data_size,
57                          uint32_t *kernel_out, void *prog_data_out);
58    void (*exec)(struct blorp_batch *batch, const struct blorp_params *params);
59 };
60 
61 void blorp_init(struct blorp_context *blorp, void *driver_ctx,
62                 struct isl_device *isl_dev);
63 void blorp_finish(struct blorp_context *blorp);
64 
65 enum blorp_batch_flags {
66    /**
67     * This flag indicates that blorp should *not* re-emit the depth and
68     * stencil buffer packets.  Instead, the driver guarantees that all depth
69     * and stencil images passed in will match what is currently set in the
70     * hardware.
71     */
72    BLORP_BATCH_NO_EMIT_DEPTH_STENCIL = (1 << 0),
73 
74    /* This flag indicates that the blorp call should be predicated. */
75    BLORP_BATCH_PREDICATE_ENABLE      = (1 << 1),
76 
77    /* This flag indicates that blorp should *not* update the indirect clear
78     * color buffer.
79     */
80    BLORP_BATCH_NO_UPDATE_CLEAR_COLOR = (1 << 2),
81 };
82 
83 struct blorp_batch {
84    struct blorp_context *blorp;
85    void *driver_batch;
86    enum blorp_batch_flags flags;
87 };
88 
89 void blorp_batch_init(struct blorp_context *blorp, struct blorp_batch *batch,
90                       void *driver_batch, enum blorp_batch_flags flags);
91 void blorp_batch_finish(struct blorp_batch *batch);
92 
93 struct blorp_address {
94    void *buffer;
95    uint64_t offset;
96    unsigned reloc_flags;
97    uint32_t mocs;
98 };
99 
100 struct blorp_surf
101 {
102    const struct isl_surf *surf;
103    struct blorp_address addr;
104 
105    const struct isl_surf *aux_surf;
106    struct blorp_address aux_addr;
107    enum isl_aux_usage aux_usage;
108 
109    union isl_color_value clear_color;
110 
111    /**
112     * If set (bo != NULL), clear_color is ignored and the actual clear color
113     * is fetched from this address.  On gen7-8, this is all of dword 7 of
114     * RENDER_SURFACE_STATE and is the responsibility of the caller to ensure
115     * that it contains a swizzle of RGBA and resource min LOD of 0.
116     */
117    struct blorp_address clear_color_addr;
118 
119    /* Only allowed for simple 2D non-MSAA surfaces */
120    uint32_t tile_x_sa, tile_y_sa;
121 };
122 
123 enum blorp_filter {
124    BLORP_FILTER_NONE,
125    BLORP_FILTER_NEAREST,
126    BLORP_FILTER_BILINEAR,
127    BLORP_FILTER_SAMPLE_0,
128    BLORP_FILTER_AVERAGE,
129    BLORP_FILTER_MIN_SAMPLE,
130    BLORP_FILTER_MAX_SAMPLE,
131 };
132 
133 void
134 blorp_blit(struct blorp_batch *batch,
135            const struct blorp_surf *src_surf,
136            unsigned src_level, float src_layer,
137            enum isl_format src_format, struct isl_swizzle src_swizzle,
138            const struct blorp_surf *dst_surf,
139            unsigned dst_level, unsigned dst_layer,
140            enum isl_format dst_format, struct isl_swizzle dst_swizzle,
141            float src_x0, float src_y0,
142            float src_x1, float src_y1,
143            float dst_x0, float dst_y0,
144            float dst_x1, float dst_y1,
145            enum blorp_filter filter,
146            bool mirror_x, bool mirror_y);
147 
148 void
149 blorp_copy(struct blorp_batch *batch,
150            const struct blorp_surf *src_surf,
151            unsigned src_level, unsigned src_layer,
152            const struct blorp_surf *dst_surf,
153            unsigned dst_level, unsigned dst_layer,
154            uint32_t src_x, uint32_t src_y,
155            uint32_t dst_x, uint32_t dst_y,
156            uint32_t src_width, uint32_t src_height);
157 
158 void
159 blorp_buffer_copy(struct blorp_batch *batch,
160                   struct blorp_address src,
161                   struct blorp_address dst,
162                   uint64_t size);
163 
164 void
165 blorp_fast_clear(struct blorp_batch *batch,
166                  const struct blorp_surf *surf,
167                  enum isl_format format, struct isl_swizzle swizzle,
168                  uint32_t level, uint32_t start_layer, uint32_t num_layers,
169                  uint32_t x0, uint32_t y0, uint32_t x1, uint32_t y1);
170 
171 void
172 blorp_clear(struct blorp_batch *batch,
173             const struct blorp_surf *surf,
174             enum isl_format format, struct isl_swizzle swizzle,
175             uint32_t level, uint32_t start_layer, uint32_t num_layers,
176             uint32_t x0, uint32_t y0, uint32_t x1, uint32_t y1,
177             union isl_color_value clear_color,
178             const bool color_write_disable[4]);
179 
180 void
181 blorp_clear_depth_stencil(struct blorp_batch *batch,
182                           const struct blorp_surf *depth,
183                           const struct blorp_surf *stencil,
184                           uint32_t level, uint32_t start_layer,
185                           uint32_t num_layers,
186                           uint32_t x0, uint32_t y0, uint32_t x1, uint32_t y1,
187                           bool clear_depth, float depth_value,
188                           uint8_t stencil_mask, uint8_t stencil_value);
189 bool
190 blorp_can_hiz_clear_depth(const struct gen_device_info *devinfo,
191                           const struct isl_surf *surf,
192                           enum isl_aux_usage aux_usage,
193                           uint32_t level, uint32_t layer,
194                           uint32_t x0, uint32_t y0, uint32_t x1, uint32_t y1);
195 void
196 blorp_hiz_clear_depth_stencil(struct blorp_batch *batch,
197                               const struct blorp_surf *depth,
198                               const struct blorp_surf *stencil,
199                               uint32_t level,
200                               uint32_t start_layer, uint32_t num_layers,
201                               uint32_t x0, uint32_t y0,
202                               uint32_t x1, uint32_t y1,
203                               bool clear_depth, float depth_value,
204                               bool clear_stencil, uint8_t stencil_value);
205 
206 
207 void
208 blorp_gen8_hiz_clear_attachments(struct blorp_batch *batch,
209                                  uint32_t num_samples,
210                                  uint32_t x0, uint32_t y0,
211                                  uint32_t x1, uint32_t y1,
212                                  bool clear_depth, bool clear_stencil,
213                                  uint8_t stencil_value);
214 void
215 blorp_clear_attachments(struct blorp_batch *batch,
216                         uint32_t binding_table_offset,
217                         enum isl_format depth_format,
218                         uint32_t num_samples,
219                         uint32_t start_layer, uint32_t num_layers,
220                         uint32_t x0, uint32_t y0, uint32_t x1, uint32_t y1,
221                         bool clear_color, union isl_color_value color_value,
222                         bool clear_depth, float depth_value,
223                         uint8_t stencil_mask, uint8_t stencil_value);
224 
225 void
226 blorp_ccs_resolve(struct blorp_batch *batch,
227                   struct blorp_surf *surf, uint32_t level,
228                   uint32_t start_layer, uint32_t num_layers,
229                   enum isl_format format,
230                   enum isl_aux_op resolve_op);
231 
232 void
233 blorp_ccs_ambiguate(struct blorp_batch *batch,
234                     struct blorp_surf *surf,
235                     uint32_t level, uint32_t layer);
236 
237 void
238 blorp_mcs_partial_resolve(struct blorp_batch *batch,
239                           struct blorp_surf *surf,
240                           enum isl_format format,
241                           uint32_t start_layer, uint32_t num_layers);
242 
243 void
244 blorp_hiz_op(struct blorp_batch *batch, struct blorp_surf *surf,
245              uint32_t level, uint32_t start_layer, uint32_t num_layers,
246              enum isl_aux_op op);
247 
248 void
249 blorp_hiz_stencil_op(struct blorp_batch *batch, struct blorp_surf *stencil,
250                      uint32_t level, uint32_t start_layer,
251                      uint32_t num_layers, enum isl_aux_op op);
252 #ifdef __cplusplus
253 } /* end extern "C" */
254 #endif /* __cplusplus */
255 
256 #endif /* BLORP_H */
257