xref: /aosp_15_r20/external/mesa3d/src/gallium/auxiliary/util/u_blitter.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /**************************************************************************
2  *
3  * Copyright 2009 Marek Olšák <[email protected]>
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the
7  * "Software"), to deal in the Software without restriction, including
8  * without limitation the rights to use, copy, modify, merge, publish,
9  * distribute, sub license, and/or sell copies of the Software, and to
10  * permit persons to whom the Software is furnished to do so, subject to
11  * the following conditions:
12  *
13  * The above copyright notice and this permission notice (including the
14  * next paragraph) shall be included in all copies or substantial portions
15  * of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
20  * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
21  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  *
25  **************************************************************************/
26 
27 #ifndef U_BLITTER_H
28 #define U_BLITTER_H
29 
30 #include "util/u_framebuffer.h"
31 #include "util/u_inlines.h"
32 
33 #include "pipe/p_state.h"
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 struct pipe_context;
40 
41 enum blitter_attrib_type {
42    UTIL_BLITTER_ATTRIB_NONE,
43    UTIL_BLITTER_ATTRIB_COLOR,
44    UTIL_BLITTER_ATTRIB_TEXCOORD_XY,
45    UTIL_BLITTER_ATTRIB_TEXCOORD_XYZW,
46 };
47 
48 union blitter_attrib {
49    float color[4];
50 
51    struct {
52       float x1, y1, x2, y2, z, w;
53    } texcoord;
54 };
55 
56 struct blitter_context;
57 
58 typedef void *(*blitter_get_vs_func)(struct blitter_context *blitter);
59 
60 struct blitter_context
61 {
62    /**
63     * Draw a rectangle.
64     *
65     * \param get_vs  Callback for obtaining the vertex shader for the draw call.
66     *                It might invoke the shader compiler. The driver is
67     *                responsible for setting the vertex shader, and the callback
68     *                allows the driver to query the vertex shader CSO if it
69     *                wants to use the default one.
70     * \param x1      An X coordinate of the top-left corner.
71     * \param y1      A Y coordinate of the top-left corner.
72     * \param x2      An X coordinate of the bottom-right corner.
73     * \param y2      A Y coordinate of the bottom-right corner.
74     * \param depth   A depth which the rectangle is rendered at.
75     *
76     * \param type   Semantics of the attributes "attrib".
77     *               If type is UTIL_BLITTER_ATTRIB_NONE, ignore them.
78     *               If type is UTIL_BLITTER_ATTRIB_COLOR, the attributes
79     *               make up a constant RGBA color, and should go
80     *               to the GENERIC0 varying slot of a fragment shader.
81     *               If type is UTIL_BLITTER_ATTRIB_TEXCOORD, {a1, a2} and
82     *               {a3, a4} specify top-left and bottom-right texture
83     *               coordinates of the rectangle, respectively, and should go
84     *               to the GENERIC0 varying slot of a fragment shader.
85     *
86     * \param attrib See type.
87     *
88     * \note A driver may optionally override this callback to implement
89     *       a specialized hardware path for drawing a rectangle, e.g. using
90     *       a rectangular point sprite.
91     */
92    void (*draw_rectangle)(struct blitter_context *blitter,
93                           void *vertex_elements_cso,
94                           blitter_get_vs_func get_vs,
95                           int x1, int y1, int x2, int y2,
96                           float depth, unsigned num_instances,
97                           enum blitter_attrib_type type,
98                           const union blitter_attrib *attrib);
99 
100    /* Whether the blitter is running. */
101    bool running;
102 
103    bool use_index_buffer;
104 
105    /* Private members, really. */
106    struct pipe_context *pipe; /**< pipe context */
107 
108    void *saved_blend_state;   /**< blend state */
109    void *saved_dsa_state;     /**< depth stencil alpha state */
110    void *saved_velem_state;   /**< vertex elements state */
111    void *saved_rs_state;      /**< rasterizer state */
112    void *saved_fs, *saved_vs, *saved_gs, *saved_tcs, *saved_tes; /**< shaders */
113 
114    struct pipe_framebuffer_state saved_fb_state;  /**< framebuffer state */
115    struct pipe_stencil_ref saved_stencil_ref;     /**< stencil ref */
116    struct pipe_viewport_state saved_viewport;
117    struct pipe_scissor_state saved_scissor;
118    bool skip_viewport_restore;
119    bool is_sample_mask_saved;
120    unsigned saved_sample_mask;
121    unsigned saved_min_samples;
122 
123    unsigned saved_num_sampler_states;
124    void *saved_sampler_states[PIPE_MAX_SAMPLERS];
125 
126    unsigned saved_num_sampler_views;
127    struct pipe_sampler_view *saved_sampler_views[PIPE_MAX_SAMPLERS];
128 
129    unsigned cb_slot;
130    struct pipe_constant_buffer saved_fs_constant_buffer;
131 
132    unsigned saved_num_vb;
133    struct pipe_vertex_buffer saved_vertex_buffers[PIPE_MAX_ATTRIBS];
134 
135    unsigned saved_num_so_targets;
136    struct pipe_stream_output_target *saved_so_targets[PIPE_MAX_SO_BUFFERS];
137 
138    struct pipe_query *saved_render_cond_query;
139    enum pipe_render_cond_flag saved_render_cond_mode;
140    bool saved_render_cond_cond;
141 
142    bool saved_window_rectangles_include;
143    unsigned saved_num_window_rectangles;
144    struct pipe_scissor_state saved_window_rectangles[PIPE_MAX_WINDOW_RECTANGLES];
145 };
146 
147 /**
148  * Create a blitter context.
149  */
150 struct blitter_context *util_blitter_create(struct pipe_context *pipe);
151 
152 /**
153  * Destroy a blitter context.
154  */
155 void util_blitter_destroy(struct blitter_context *blitter);
156 
157 void util_blitter_cache_all_shaders(struct blitter_context *blitter);
158 void *util_blitter_get_noop_blend_state(struct blitter_context *blitter);
159 void *util_blitter_get_noop_dsa_state(struct blitter_context *blitter);
160 void *util_blitter_get_discard_rasterizer_state(struct blitter_context *blitter);
161 
162 
163 /**
164  * Return the pipe context associated with a blitter context.
165  */
166 static inline
util_blitter_get_pipe(struct blitter_context * blitter)167 struct pipe_context *util_blitter_get_pipe(struct blitter_context *blitter)
168 {
169    return blitter->pipe;
170 }
171 
172 /**
173  * Override PIPE_CAP_TEXTURE_MULTISAMPLE as reported by the driver.
174  */
175 void util_blitter_set_texture_multisample(struct blitter_context *blitter,
176                                           bool supported);
177 
178 /* The default function to draw a rectangle. This can only be used
179  * inside of the draw_rectangle callback if the driver overrides it. */
180 void util_blitter_draw_rectangle(struct blitter_context *blitter,
181                                  void *vertex_elements_cso,
182                                  blitter_get_vs_func get_vs,
183                                  int x1, int y1, int x2, int y2,
184                                  float depth, unsigned num_instances,
185                                  enum blitter_attrib_type type,
186                                  const union blitter_attrib *attrib);
187 
188 
189 /*
190  * These states must be saved before any of the following functions are called:
191  * - vertex buffers
192  * - vertex elements
193  * - vertex shader
194  * - geometry shader (if supported)
195  * - stream output targets (if supported)
196  * - rasterizer state
197  */
198 
199 /**
200  * Clear a specified set of currently bound buffers to specified values.
201  *
202  * These states must be saved in the blitter in addition to the state objects
203  * already required to be saved:
204  * - fragment shader
205  * - depth stencil alpha state
206  * - blend state
207  */
208 void util_blitter_clear(struct blitter_context *blitter,
209                         unsigned width, unsigned height, unsigned num_layers,
210                         unsigned clear_buffers,
211                         const union pipe_color_union *color,
212                         double depth, unsigned stencil,
213                         bool msaa);
214 
215 /**
216  * Check if the blitter (with the help of the driver) can blit between
217  * the two resources.
218  */
219 bool util_blitter_is_copy_supported(struct blitter_context *blitter,
220                                     const struct pipe_resource *dst,
221                                     const struct pipe_resource *src);
222 
223 bool util_blitter_is_blit_supported(struct blitter_context *blitter,
224 				    const struct pipe_blit_info *info);
225 
226 /**
227  * Copy a block of pixels from one surface to another.
228  *
229  * These states must be saved in the blitter in addition to the state objects
230  * already required to be saved:
231  * - fragment shader
232  * - depth stencil alpha state
233  * - blend state
234  * - fragment sampler states
235  * - fragment sampler textures
236  * - framebuffer state
237  * - sample mask
238  */
239 void util_blitter_copy_texture(struct blitter_context *blitter,
240                                struct pipe_resource *dst,
241                                unsigned dst_level,
242                                unsigned dstx, unsigned dsty, unsigned dstz,
243                                struct pipe_resource *src,
244                                unsigned src_level,
245                                const struct pipe_box *srcbox);
246 
247 /**
248  * This is a generic implementation of pipe->blit, which accepts
249  * sampler/surface views instead of resources.
250  *
251  * The layer and mipmap level are specified by the views.
252  *
253  * Drivers can use this to change resource properties (like format, width,
254  * height) by changing how the views interpret them, instead of changing
255  * pipe_resource directly. This is used to blit resources of formats which
256  * are not renderable.
257  *
258  * src_width0 and src_height0 are sampler_view-private properties that
259  * override pipe_resource. The blitter uses them for computation of texture
260  * coordinates. The dst dimensions are supplied through pipe_surface::width
261  * and height.
262  *
263  * The mask is a combination of the PIPE_MASK_* flags.
264  * Set to PIPE_MASK_RGBAZS if unsure.
265  */
266 void util_blitter_blit_generic(struct blitter_context *blitter,
267                                struct pipe_surface *dst,
268                                const struct pipe_box *dstbox,
269                                struct pipe_sampler_view *src,
270                                const struct pipe_box *srcbox,
271                                unsigned src_width0, unsigned src_height0,
272                                unsigned mask, unsigned filter,
273                                const struct pipe_scissor_state *scissor,
274                                bool alpha_blend, bool sample0_only,
275                                unsigned dst_sample,
276                                void *fs_override);
277 
278 void util_blitter_blit(struct blitter_context *blitter,
279 		       const struct pipe_blit_info *info,
280                        void *fs_override);
281 
282 void util_blitter_generate_mipmap(struct blitter_context *blitter,
283                                   struct pipe_resource *tex,
284                                   enum pipe_format format,
285                                   unsigned base_level, unsigned last_level,
286                                   unsigned first_layer, unsigned last_layer);
287 
288 /**
289  * Helper function to initialize a view for copy_texture_view.
290  * The parameters must match copy_texture_view.
291  */
292 void util_blitter_default_dst_texture(struct pipe_surface *dst_templ,
293                                       struct pipe_resource *dst,
294                                       unsigned dstlevel,
295                                       unsigned dstz);
296 
297 /**
298  * Helper function to initialize a view for copy_texture_view.
299  * The parameters must match copy_texture_view.
300  */
301 void util_blitter_default_src_texture(struct blitter_context *blitter,
302                                       struct pipe_sampler_view *src_templ,
303                                       struct pipe_resource *src,
304                                       unsigned srclevel);
305 
306 /**
307  * Clear the contents of a buffer using the Stream Output functionality.
308  * 4-byte alignment is required.
309  *
310  * "num_channels" can be 1, 2, 3, or 4, and specifies if the clear value is
311  * R, RG, RGB, or RGBA.
312  *
313  * For each element, only "num_channels" components of "clear_value" are
314  * copied to the buffer, then the offset is incremented by num_channels*4.
315  */
316 void util_blitter_clear_buffer(struct blitter_context *blitter,
317                                struct pipe_resource *dst,
318                                unsigned offset, unsigned size,
319                                unsigned num_channels,
320                                const union pipe_color_union *clear_value);
321 
322 /**
323  * Clear a region of a (color) surface to a constant value.
324  *
325  * These states must be saved in the blitter in addition to the state objects
326  * already required to be saved:
327  * - fragment shader
328  * - depth stencil alpha state
329  * - blend state
330  * - framebuffer state
331  */
332 void util_blitter_clear_render_target(struct blitter_context *blitter,
333                                       struct pipe_surface *dst,
334                                       const union pipe_color_union *color,
335                                       unsigned dstx, unsigned dsty,
336                                       unsigned width, unsigned height);
337 
338 /**
339  * Clear a region of a depth-stencil surface, both stencil and depth
340  * or only one of them if this is a combined depth-stencil surface.
341  *
342  * These states must be saved in the blitter in addition to the state objects
343  * already required to be saved:
344  * - fragment shader
345  * - depth stencil alpha state
346  * - blend state
347  * - framebuffer state
348  */
349 void util_blitter_clear_depth_stencil(struct blitter_context *blitter,
350                                       struct pipe_surface *dst,
351                                       unsigned clear_flags,
352                                       double depth,
353                                       unsigned stencil,
354                                       unsigned dstx, unsigned dsty,
355                                       unsigned width, unsigned height);
356 
357 /* The following functions are customized variants of the clear functions.
358  * Some drivers use them internally to do things like MSAA resolve
359  * and resource decompression. It usually consists of rendering a full-screen
360  * quad with a special blend or DSA state.
361  */
362 
363 /* Used by r300g for depth decompression. */
364 void util_blitter_custom_clear_depth(struct blitter_context *blitter,
365                                      unsigned width, unsigned height,
366                                      double depth, void *custom_dsa);
367 
368 /* Used by r600g for depth decompression. */
369 void util_blitter_custom_depth_stencil(struct blitter_context *blitter,
370 				       struct pipe_surface *zsurf,
371 				       struct pipe_surface *cbsurf,
372 				       unsigned sample_mask,
373 				       void *dsa_stage, float depth);
374 
375 /* Used by r600g for color decompression. */
376 void util_blitter_custom_color(struct blitter_context *blitter,
377                                struct pipe_surface *dstsurf,
378                                void *custom_blend);
379 
380 /* Used by r600g for MSAA color resolve. */
381 void util_blitter_custom_resolve_color(struct blitter_context *blitter,
382                                        struct pipe_resource *dst,
383                                        unsigned dst_level,
384                                        unsigned dst_layer,
385                                        struct pipe_resource *src,
386                                        unsigned src_layer,
387 				       unsigned sampled_mask,
388                                        void *custom_blend,
389                                        enum pipe_format format);
390 
391 /* Used by vc4 for 8/16-bit linear-to-tiled blits */
392 void util_blitter_custom_shader(struct blitter_context *blitter,
393                                 struct pipe_surface *dstsurf,
394                                 void *custom_vs, void *custom_fs);
395 
396 /* Used by D3D12 for non-MSAA -> MSAA stencil blits */
397 void util_blitter_stencil_fallback(struct blitter_context *blitter,
398                                    struct pipe_resource *dst,
399                                    unsigned dst_level,
400                                    const struct pipe_box *dstbox,
401                                    struct pipe_resource *src,
402                                    unsigned src_level,
403                                    const struct pipe_box *srcbox,
404                                    const struct pipe_scissor_state *scissor);
405 
406 /* The functions below should be used to save currently bound constant state
407  * objects inside a driver. The objects are automatically restored at the end
408  * of the util_blitter_{clear, copy_region, fill_region} functions and then
409  * forgotten.
410  *
411  * States not listed here are not affected by util_blitter. */
412 
413 static inline void
util_blitter_save_blend(struct blitter_context * blitter,void * state)414 util_blitter_save_blend(struct blitter_context *blitter, void *state)
415 {
416    blitter->saved_blend_state = state;
417 }
418 
419 static inline void
util_blitter_save_depth_stencil_alpha(struct blitter_context * blitter,void * state)420 util_blitter_save_depth_stencil_alpha(struct blitter_context *blitter,
421                                       void *state)
422 {
423    blitter->saved_dsa_state = state;
424 }
425 
426 static inline void
util_blitter_save_vertex_elements(struct blitter_context * blitter,void * state)427 util_blitter_save_vertex_elements(struct blitter_context *blitter, void *state)
428 {
429    blitter->saved_velem_state = state;
430 }
431 
432 static inline void
util_blitter_save_stencil_ref(struct blitter_context * blitter,const struct pipe_stencil_ref * state)433 util_blitter_save_stencil_ref(struct blitter_context *blitter,
434                               const struct pipe_stencil_ref *state)
435 {
436    blitter->saved_stencil_ref = *state;
437 }
438 
439 static inline void
util_blitter_save_rasterizer(struct blitter_context * blitter,void * state)440 util_blitter_save_rasterizer(struct blitter_context *blitter, void *state)
441 {
442    blitter->saved_rs_state = state;
443 }
444 
445 static inline void
util_blitter_save_fragment_shader(struct blitter_context * blitter,void * fs)446 util_blitter_save_fragment_shader(struct blitter_context *blitter, void *fs)
447 {
448    blitter->saved_fs = fs;
449 }
450 
451 static inline void
util_blitter_save_vertex_shader(struct blitter_context * blitter,void * vs)452 util_blitter_save_vertex_shader(struct blitter_context *blitter, void *vs)
453 {
454    blitter->saved_vs = vs;
455 }
456 
457 static inline void
util_blitter_save_geometry_shader(struct blitter_context * blitter,void * gs)458 util_blitter_save_geometry_shader(struct blitter_context *blitter, void *gs)
459 {
460    blitter->saved_gs = gs;
461 }
462 
463 static inline void
util_blitter_save_tessctrl_shader(struct blitter_context * blitter,void * sh)464 util_blitter_save_tessctrl_shader(struct blitter_context *blitter,
465                                   void *sh)
466 {
467    blitter->saved_tcs = sh;
468 }
469 
470 static inline void
util_blitter_save_tesseval_shader(struct blitter_context * blitter,void * sh)471 util_blitter_save_tesseval_shader(struct blitter_context *blitter,
472                                   void *sh)
473 {
474    blitter->saved_tes = sh;
475 }
476 
477 static inline void
util_blitter_save_framebuffer(struct blitter_context * blitter,const struct pipe_framebuffer_state * state)478 util_blitter_save_framebuffer(struct blitter_context *blitter,
479                               const struct pipe_framebuffer_state *state)
480 {
481    blitter->saved_fb_state.nr_cbufs = 0; /* It's ~0 now, meaning it's unsaved. */
482    util_copy_framebuffer_state(&blitter->saved_fb_state, state);
483 }
484 
485 static inline void
util_blitter_save_viewport(struct blitter_context * blitter,struct pipe_viewport_state * state)486 util_blitter_save_viewport(struct blitter_context *blitter,
487                            struct pipe_viewport_state *state)
488 {
489    blitter->saved_viewport = *state;
490 }
491 
492 static inline void
util_blitter_save_scissor(struct blitter_context * blitter,struct pipe_scissor_state * state)493 util_blitter_save_scissor(struct blitter_context *blitter,
494                           struct pipe_scissor_state *state)
495 {
496    blitter->saved_scissor = *state;
497 }
498 
499 static inline void
util_blitter_save_fragment_sampler_states(struct blitter_context * blitter,unsigned num_sampler_states,void ** sampler_states)500 util_blitter_save_fragment_sampler_states(
501                   struct blitter_context *blitter,
502                   unsigned num_sampler_states,
503                   void **sampler_states)
504 {
505    assert(num_sampler_states <= ARRAY_SIZE(blitter->saved_sampler_states));
506 
507    blitter->saved_num_sampler_states = num_sampler_states;
508    memcpy(blitter->saved_sampler_states, sampler_states,
509           num_sampler_states * sizeof(void *));
510 }
511 
512 static inline void
util_blitter_save_fragment_sampler_views(struct blitter_context * blitter,unsigned num_views,struct pipe_sampler_view ** views)513 util_blitter_save_fragment_sampler_views(struct blitter_context *blitter,
514                                          unsigned num_views,
515                                          struct pipe_sampler_view **views)
516 {
517    unsigned i;
518    assert(num_views <= ARRAY_SIZE(blitter->saved_sampler_views));
519 
520    blitter->saved_num_sampler_views = num_views;
521    for (i = 0; i < num_views; i++)
522       pipe_sampler_view_reference(&blitter->saved_sampler_views[i],
523                                   views[i]);
524 }
525 
526 static inline void
util_blitter_save_fragment_constant_buffer_slot(struct blitter_context * blitter,struct pipe_constant_buffer * constant_buffers)527 util_blitter_save_fragment_constant_buffer_slot(
528                   struct blitter_context *blitter,
529                   struct pipe_constant_buffer *constant_buffers)
530 {
531    pipe_resource_reference(&blitter->saved_fs_constant_buffer.buffer,
532                            constant_buffers[blitter->cb_slot].buffer);
533    memcpy(&blitter->saved_fs_constant_buffer, &constant_buffers[blitter->cb_slot],
534           sizeof(struct pipe_constant_buffer));
535 }
536 
537 static inline void
util_blitter_save_vertex_buffers(struct blitter_context * blitter,struct pipe_vertex_buffer * vertex_buffers,unsigned count)538 util_blitter_save_vertex_buffers(struct blitter_context *blitter,
539                                  struct pipe_vertex_buffer *vertex_buffers,
540                                  unsigned count)
541 {
542    for (unsigned i = 0; i < count; i++) {
543       pipe_vertex_buffer_reference(&blitter->saved_vertex_buffers[i],
544                                    &vertex_buffers[i]);
545    }
546    blitter->saved_num_vb = count;
547 }
548 
549 static inline void
util_blitter_save_so_targets(struct blitter_context * blitter,unsigned num_targets,struct pipe_stream_output_target ** targets)550 util_blitter_save_so_targets(struct blitter_context *blitter,
551                              unsigned num_targets,
552                              struct pipe_stream_output_target **targets)
553 {
554    unsigned i;
555    assert(num_targets <= ARRAY_SIZE(blitter->saved_so_targets));
556 
557    blitter->saved_num_so_targets = num_targets;
558    for (i = 0; i < num_targets; i++)
559       pipe_so_target_reference(&blitter->saved_so_targets[i],
560                                targets[i]);
561 }
562 
563 static inline void
util_blitter_save_sample_mask(struct blitter_context * blitter,unsigned sample_mask,unsigned min_samples)564 util_blitter_save_sample_mask(struct blitter_context *blitter,
565                               unsigned sample_mask, unsigned min_samples)
566 {
567    blitter->is_sample_mask_saved = true;
568    blitter->saved_sample_mask = sample_mask;
569    blitter->saved_min_samples = min_samples;
570 }
571 
572 static inline void
util_blitter_save_render_condition(struct blitter_context * blitter,struct pipe_query * query,bool condition,enum pipe_render_cond_flag mode)573 util_blitter_save_render_condition(struct blitter_context *blitter,
574                                    struct pipe_query *query,
575                                    bool condition,
576                                    enum pipe_render_cond_flag mode)
577 {
578    blitter->saved_render_cond_query = query;
579    blitter->saved_render_cond_mode = mode;
580    blitter->saved_render_cond_cond = condition;
581 }
582 
583 static inline void
util_blitter_save_window_rectangles(struct blitter_context * blitter,bool include,unsigned num_rectangles,const struct pipe_scissor_state * rects)584 util_blitter_save_window_rectangles(struct blitter_context *blitter,
585                                     bool include,
586                                     unsigned num_rectangles,
587                                     const struct pipe_scissor_state *rects)
588 {
589    blitter->saved_window_rectangles_include = include;
590    blitter->saved_num_window_rectangles = num_rectangles;
591    if (num_rectangles > 0) {
592       assert(num_rectangles < ARRAY_SIZE(blitter->saved_window_rectangles));
593       memcpy(blitter->saved_window_rectangles, rects,
594              sizeof(*rects) * num_rectangles);
595    }
596 }
597 
598 void util_blitter_common_clear_setup(struct blitter_context *blitter,
599                                      unsigned width, unsigned height,
600                                      unsigned clear_buffers,
601                                      void *custom_blend, void *custom_dsa);
602 
603 void util_blitter_set_running_flag(struct blitter_context *blitter);
604 void util_blitter_unset_running_flag(struct blitter_context *blitter);
605 
606 void util_blitter_restore_vertex_states(struct blitter_context *blitter);
607 void util_blitter_restore_fragment_states(struct blitter_context *blitter);
608 void util_blitter_restore_render_cond(struct blitter_context *blitter);
609 void util_blitter_restore_fb_state(struct blitter_context *blitter);
610 void util_blitter_restore_textures(struct blitter_context *blitter);
611 void util_blitter_restore_constant_buffer_state(struct blitter_context *blitter);
612 
613 /* These are supported combinations of blits from ZS to color and vice versa.
614  * The blitter will do the packing/unpacking of depth and stencil
615  * in the fragment shader.
616  */
617 static inline enum pipe_format
util_blitter_get_color_format_for_zs(enum pipe_format format)618 util_blitter_get_color_format_for_zs(enum pipe_format format)
619 {
620    switch (format) {
621    case PIPE_FORMAT_Z16_UNORM:
622       return PIPE_FORMAT_R16_UNORM;
623 
624    case PIPE_FORMAT_Z32_FLOAT:
625       return PIPE_FORMAT_R32_FLOAT;
626 
627    case PIPE_FORMAT_Z24_UNORM_S8_UINT:
628    case PIPE_FORMAT_Z24X8_UNORM:
629    case PIPE_FORMAT_S8_UINT_Z24_UNORM:
630    case PIPE_FORMAT_X8Z24_UNORM:
631       return PIPE_FORMAT_R32_UINT;
632 
633    case PIPE_FORMAT_Z32_FLOAT_S8X24_UINT:
634       return PIPE_FORMAT_R32G32_UINT;
635 
636    case PIPE_FORMAT_Z32_UNORM:
637    default:
638       assert(0);
639    }
640    return PIPE_FORMAT_NONE;
641 }
642 
643 #ifdef __cplusplus
644 }
645 #endif
646 
647 #endif
648