1 /**************************************************************************
3 * Copyright 2009 VMware, Inc. All Rights Reserved.
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:
13 * The above copyright notice and this permission notice (including the
14 * next paragraph) shall be included in all copies or substantial portions
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.
25 **************************************************************************/
29 * Surface utility functions.
35 #include "pipe/p_defines.h"
36 #include "pipe/p_screen.h"
37 #include "pipe/p_state.h"
39 #include "util/u_format.h"
40 #include "util/u_inlines.h"
41 #include "util/u_rect.h"
42 #include "util/u_surface.h"
43 #include "util/u_pack_color.h"
47 * Initialize a pipe_surface object. 'view' is considered to have
48 * uninitialized contents.
51 u_surface_default_template(struct pipe_surface
*surf
,
52 const struct pipe_resource
*texture
)
54 memset(surf
, 0, sizeof(*surf
));
56 surf
->format
= texture
->format
;
61 * Copy 2D rect from one place to another.
62 * Position and sizes are in pixels.
63 * src_stride may be negative to do vertical flip of pixels from source.
66 util_copy_rect(ubyte
* dst
,
67 enum pipe_format format
,
79 int src_stride_pos
= src_stride
< 0 ? -src_stride
: src_stride
;
80 int blocksize
= util_format_get_blocksize(format
);
81 int blockwidth
= util_format_get_blockwidth(format
);
82 int blockheight
= util_format_get_blockheight(format
);
84 assert(blocksize
> 0);
85 assert(blockwidth
> 0);
86 assert(blockheight
> 0);
90 width
= (width
+ blockwidth
- 1)/blockwidth
;
91 height
= (height
+ blockheight
- 1)/blockheight
;
95 dst
+= dst_x
* blocksize
;
96 src
+= src_x
* blocksize
;
97 dst
+= dst_y
* dst_stride
;
98 src
+= src_y
* src_stride_pos
;
101 if (width
== dst_stride
&& width
== src_stride
)
102 memcpy(dst
, src
, height
* width
);
104 for (i
= 0; i
< height
; i
++) {
105 memcpy(dst
, src
, width
);
114 * Copy 3D box from one place to another.
115 * Position and sizes are in pixels.
118 util_copy_box(ubyte
* dst
,
119 enum pipe_format format
,
120 unsigned dst_stride
, unsigned dst_slice_stride
,
121 unsigned dst_x
, unsigned dst_y
, unsigned dst_z
,
122 unsigned width
, unsigned height
, unsigned depth
,
124 int src_stride
, unsigned src_slice_stride
,
125 unsigned src_x
, unsigned src_y
, unsigned src_z
)
128 dst
+= dst_z
* dst_slice_stride
;
129 src
+= src_z
* src_slice_stride
;
130 for (z
= 0; z
< depth
; ++z
) {
140 dst
+= dst_slice_stride
;
141 src
+= src_slice_stride
;
147 util_fill_rect(ubyte
* dst
,
148 enum pipe_format format
,
154 union util_color
*uc
)
156 const struct util_format_description
*desc
= util_format_description(format
);
159 int blocksize
= desc
->block
.bits
/ 8;
160 int blockwidth
= desc
->block
.width
;
161 int blockheight
= desc
->block
.height
;
163 assert(blocksize
> 0);
164 assert(blockwidth
> 0);
165 assert(blockheight
> 0);
168 dst_y
/= blockheight
;
169 width
= (width
+ blockwidth
- 1)/blockwidth
;
170 height
= (height
+ blockheight
- 1)/blockheight
;
172 dst
+= dst_x
* blocksize
;
173 dst
+= dst_y
* dst_stride
;
174 width_size
= width
* blocksize
;
178 if(dst_stride
== width_size
)
179 memset(dst
, uc
->ub
, height
* width_size
);
181 for (i
= 0; i
< height
; i
++) {
182 memset(dst
, uc
->ub
, width_size
);
188 for (i
= 0; i
< height
; i
++) {
189 uint16_t *row
= (uint16_t *)dst
;
190 for (j
= 0; j
< width
; j
++)
196 for (i
= 0; i
< height
; i
++) {
197 uint32_t *row
= (uint32_t *)dst
;
198 for (j
= 0; j
< width
; j
++)
204 for (i
= 0; i
< height
; i
++) {
206 for (j
= 0; j
< width
; j
++) {
207 memcpy(row
, uc
, blocksize
);
218 util_fill_box(ubyte
* dst
,
219 enum pipe_format format
,
221 unsigned layer_stride
,
228 union util_color
*uc
)
231 dst
+= z
* layer_stride
;
232 for (layer
= z
; layer
< depth
; layer
++) {
233 util_fill_rect(dst
, format
,
235 x
, y
, width
, height
, uc
);
241 /** Mipmap level size computation, with minimum block size */
242 static inline unsigned
243 minify(unsigned value
, unsigned levels
, unsigned blocksize
)
245 return MAX2(blocksize
, value
>> levels
);
250 * Fallback function for pipe->resource_copy_region().
251 * We support copying between different formats (including compressed/
252 * uncompressed) if the bytes per block or pixel matches. If copying
253 * compressed -> uncompressed, the dst region is reduced by the block
254 * width, height. If copying uncompressed -> compressed, the dest region
255 * is expanded by the block width, height. See GL_ARB_copy_image.
256 * Note: (X,Y)=(0,0) is always the upper-left corner.
259 util_resource_copy_region(struct pipe_context
*pipe
,
260 struct pipe_resource
*dst
,
262 unsigned dst_x
, unsigned dst_y
, unsigned dst_z
,
263 struct pipe_resource
*src
,
265 const struct pipe_box
*src_box_in
)
267 struct pipe_transfer
*src_trans
, *dst_trans
;
269 const uint8_t *src_map
;
270 MAYBE_UNUSED
enum pipe_format src_format
;
271 enum pipe_format dst_format
;
272 struct pipe_box src_box
, dst_box
;
273 unsigned src_bs
, dst_bs
, src_bw
, dst_bw
, src_bh
, dst_bh
;
279 assert((src
->target
== PIPE_BUFFER
&& dst
->target
== PIPE_BUFFER
) ||
280 (src
->target
!= PIPE_BUFFER
&& dst
->target
!= PIPE_BUFFER
));
282 src_format
= src
->format
;
283 dst_format
= dst
->format
;
286 src_box
= *src_box_in
;
292 dst_box
.width
= src_box
.width
;
293 dst_box
.height
= src_box
.height
;
294 dst_box
.depth
= src_box
.depth
;
296 src_bs
= util_format_get_blocksize(src_format
);
297 src_bw
= util_format_get_blockwidth(src_format
);
298 src_bh
= util_format_get_blockheight(src_format
);
299 dst_bs
= util_format_get_blocksize(dst_format
);
300 dst_bw
= util_format_get_blockwidth(dst_format
);
301 dst_bh
= util_format_get_blockheight(dst_format
);
303 /* Note: all box positions and sizes are in pixels */
304 if (src_bw
> 1 && dst_bw
== 1) {
305 /* Copy from compressed to uncompressed.
306 * Shrink dest box by the src block size.
308 dst_box
.width
/= src_bw
;
309 dst_box
.height
/= src_bh
;
311 else if (src_bw
== 1 && dst_bw
> 1) {
312 /* Copy from uncompressed to compressed.
313 * Expand dest box by the dest block size.
315 dst_box
.width
*= dst_bw
;
316 dst_box
.height
*= dst_bh
;
319 /* compressed -> compressed or uncompressed -> uncompressed copy */
320 assert(src_bw
== dst_bw
);
321 assert(src_bh
== dst_bh
);
324 assert(src_bs
== dst_bs
);
325 if (src_bs
!= dst_bs
) {
326 /* This can happen if we fail to do format checking before hand.
332 /* check that region boxes are block aligned */
333 assert(src_box
.x
% src_bw
== 0);
334 assert(src_box
.y
% src_bh
== 0);
335 assert(src_box
.width
% src_bw
== 0 ||
336 src_box
.x
+ src_box
.width
== minify(src
->width0
, src_level
, src_bw
));
337 assert(src_box
.height
% src_bh
== 0 ||
338 src_box
.y
+ src_box
.height
== minify(src
->height0
, src_level
, src_bh
));
339 assert(dst_box
.x
% dst_bw
== 0);
340 assert(dst_box
.y
% dst_bh
== 0);
341 assert(dst_box
.width
% dst_bw
== 0 ||
342 dst_box
.x
+ dst_box
.width
== minify(dst
->width0
, dst_level
, dst_bw
));
343 assert(dst_box
.height
% dst_bh
== 0 ||
344 dst_box
.y
+ dst_box
.height
== minify(dst
->height0
, dst_level
, dst_bh
));
346 /* check that region boxes are not out of bounds */
347 assert(src_box
.x
+ src_box
.width
<=
348 minify(src
->width0
, src_level
, src_bw
));
349 assert(src_box
.y
+ src_box
.height
<=
350 minify(src
->height0
, src_level
, src_bh
));
351 assert(dst_box
.x
+ dst_box
.width
<=
352 minify(dst
->width0
, dst_level
, dst_bw
));
353 assert(dst_box
.y
+ dst_box
.height
<=
354 minify(dst
->height0
, dst_level
, dst_bh
));
356 /* check that total number of src, dest bytes match */
357 assert((src_box
.width
/ src_bw
) * (src_box
.height
/ src_bh
) * src_bs
==
358 (dst_box
.width
/ dst_bw
) * (dst_box
.height
/ dst_bh
) * dst_bs
);
360 src_map
= pipe
->transfer_map(pipe
,
364 &src_box
, &src_trans
);
370 dst_map
= pipe
->transfer_map(pipe
,
373 PIPE_TRANSFER_WRITE
|
374 PIPE_TRANSFER_DISCARD_RANGE
, &dst_box
,
381 if (dst
->target
== PIPE_BUFFER
&& src
->target
== PIPE_BUFFER
) {
382 assert(src_box
.height
== 1);
383 assert(src_box
.depth
== 1);
384 memcpy(dst_map
, src_map
, src_box
.width
);
386 util_copy_box(dst_map
,
388 dst_trans
->stride
, dst_trans
->layer_stride
,
390 src_box
.width
, src_box
.height
, src_box
.depth
,
392 src_trans
->stride
, src_trans
->layer_stride
,
396 pipe
->transfer_unmap(pipe
, dst_trans
);
398 pipe
->transfer_unmap(pipe
, src_trans
);
405 #define UBYTE_TO_USHORT(B) ((B) | ((B) << 8))
409 * Fallback for pipe->clear_render_target() function.
410 * XXX this looks too hackish to be really useful.
411 * cpp > 4 looks like a gross hack at best...
412 * Plus can't use these transfer fallbacks when clearing
413 * multisampled surfaces for instance.
414 * Clears all bound layers.
417 util_clear_render_target(struct pipe_context
*pipe
,
418 struct pipe_surface
*dst
,
419 const union pipe_color_union
*color
,
420 unsigned dstx
, unsigned dsty
,
421 unsigned width
, unsigned height
)
423 struct pipe_transfer
*dst_trans
;
428 assert(dst
->texture
);
432 if (dst
->texture
->target
== PIPE_BUFFER
) {
434 * The fill naturally works on the surface format, however
435 * the transfer uses resource format which is just bytes for buffers.
438 unsigned pixstride
= util_format_get_blocksize(dst
->format
);
439 dx
= (dst
->u
.buf
.first_element
+ dstx
) * pixstride
;
440 w
= width
* pixstride
;
442 dst_map
= pipe_transfer_map(pipe
,
450 max_layer
= dst
->u
.tex
.last_layer
- dst
->u
.tex
.first_layer
;
451 dst_map
= pipe_transfer_map_3d(pipe
,
455 dstx
, dsty
, dst
->u
.tex
.first_layer
,
456 width
, height
, max_layer
+ 1, &dst_trans
);
462 enum pipe_format format
= dst
->format
;
463 assert(dst_trans
->stride
> 0);
465 if (util_format_is_pure_integer(format
)) {
467 * We expect int/uint clear values here, though some APIs
468 * might disagree (but in any case util_pack_color()
469 * couldn't handle it)...
471 if (util_format_is_pure_sint(format
)) {
472 util_format_write_4i(format
, color
->i
, 0, &uc
, 0, 0, 0, 1, 1);
475 assert(util_format_is_pure_uint(format
));
476 util_format_write_4ui(format
, color
->ui
, 0, &uc
, 0, 0, 0, 1, 1);
480 util_pack_color(color
->f
, format
, &uc
);
483 util_fill_box(dst_map
, dst
->format
,
484 dst_trans
->stride
, dst_trans
->layer_stride
,
485 0, 0, 0, width
, height
, max_layer
+ 1, &uc
);
487 pipe
->transfer_unmap(pipe
, dst_trans
);
492 * Fallback for pipe->clear_stencil() function.
493 * sw fallback doesn't look terribly useful here.
494 * Plus can't use these transfer fallbacks when clearing
495 * multisampled surfaces for instance.
496 * Clears all bound layers.
499 util_clear_depth_stencil(struct pipe_context
*pipe
,
500 struct pipe_surface
*dst
,
501 unsigned clear_flags
,
504 unsigned dstx
, unsigned dsty
,
505 unsigned width
, unsigned height
)
507 enum pipe_format format
= dst
->format
;
508 struct pipe_transfer
*dst_trans
;
510 boolean need_rmw
= FALSE
;
511 unsigned max_layer
, layer
;
513 if ((clear_flags
& PIPE_CLEAR_DEPTHSTENCIL
) &&
514 ((clear_flags
& PIPE_CLEAR_DEPTHSTENCIL
) != PIPE_CLEAR_DEPTHSTENCIL
) &&
515 util_format_is_depth_and_stencil(format
))
518 assert(dst
->texture
);
522 max_layer
= dst
->u
.tex
.last_layer
- dst
->u
.tex
.first_layer
;
523 dst_map
= pipe_transfer_map_3d(pipe
,
526 (need_rmw
? PIPE_TRANSFER_READ_WRITE
:
527 PIPE_TRANSFER_WRITE
),
528 dstx
, dsty
, dst
->u
.tex
.first_layer
,
529 width
, height
, max_layer
+ 1, &dst_trans
);
533 unsigned dst_stride
= dst_trans
->stride
;
534 uint64_t zstencil
= util_pack64_z_stencil(format
, depth
, stencil
);
535 ubyte
*dst_layer
= dst_map
;
537 assert(dst_trans
->stride
> 0);
539 for (layer
= 0; layer
<= max_layer
; layer
++) {
542 switch (util_format_get_blocksize(format
)) {
544 assert(format
== PIPE_FORMAT_S8_UINT
);
545 if(dst_stride
== width
)
546 memset(dst_map
, (uint8_t) zstencil
, height
* width
);
548 for (i
= 0; i
< height
; i
++) {
549 memset(dst_map
, (uint8_t) zstencil
, width
);
550 dst_map
+= dst_stride
;
555 assert(format
== PIPE_FORMAT_Z16_UNORM
);
556 for (i
= 0; i
< height
; i
++) {
557 uint16_t *row
= (uint16_t *)dst_map
;
558 for (j
= 0; j
< width
; j
++)
559 *row
++ = (uint16_t) zstencil
;
560 dst_map
+= dst_stride
;
565 for (i
= 0; i
< height
; i
++) {
566 uint32_t *row
= (uint32_t *)dst_map
;
567 for (j
= 0; j
< width
; j
++)
568 *row
++ = (uint32_t) zstencil
;
569 dst_map
+= dst_stride
;
574 if (format
== PIPE_FORMAT_Z24_UNORM_S8_UINT
)
575 dst_mask
= 0x00ffffff;
577 assert(format
== PIPE_FORMAT_S8_UINT_Z24_UNORM
);
578 dst_mask
= 0xffffff00;
580 if (clear_flags
& PIPE_CLEAR_DEPTH
)
581 dst_mask
= ~dst_mask
;
582 for (i
= 0; i
< height
; i
++) {
583 uint32_t *row
= (uint32_t *)dst_map
;
584 for (j
= 0; j
< width
; j
++) {
585 uint32_t tmp
= *row
& dst_mask
;
586 *row
++ = tmp
| ((uint32_t) zstencil
& ~dst_mask
);
588 dst_map
+= dst_stride
;
594 for (i
= 0; i
< height
; i
++) {
595 uint64_t *row
= (uint64_t *)dst_map
;
596 for (j
= 0; j
< width
; j
++)
598 dst_map
+= dst_stride
;
604 if (clear_flags
& PIPE_CLEAR_DEPTH
)
605 src_mask
= 0x00000000ffffffffull
;
607 src_mask
= 0x000000ff00000000ull
;
609 for (i
= 0; i
< height
; i
++) {
610 uint64_t *row
= (uint64_t *)dst_map
;
611 for (j
= 0; j
< width
; j
++) {
612 uint64_t tmp
= *row
& ~src_mask
;
613 *row
++ = tmp
| (zstencil
& src_mask
);
615 dst_map
+= dst_stride
;
623 dst_layer
+= dst_trans
->layer_stride
;
626 pipe
->transfer_unmap(pipe
, dst_trans
);
631 /* Return if the box is totally inside the resource.
634 is_box_inside_resource(const struct pipe_resource
*res
,
635 const struct pipe_box
*box
,
638 unsigned width
= 1, height
= 1, depth
= 1;
640 switch (res
->target
) {
646 case PIPE_TEXTURE_1D
:
647 width
= u_minify(res
->width0
, level
);
651 case PIPE_TEXTURE_2D
:
652 case PIPE_TEXTURE_RECT
:
653 width
= u_minify(res
->width0
, level
);
654 height
= u_minify(res
->height0
, level
);
657 case PIPE_TEXTURE_3D
:
658 width
= u_minify(res
->width0
, level
);
659 height
= u_minify(res
->height0
, level
);
660 depth
= u_minify(res
->depth0
, level
);
662 case PIPE_TEXTURE_CUBE
:
663 width
= u_minify(res
->width0
, level
);
664 height
= u_minify(res
->height0
, level
);
667 case PIPE_TEXTURE_1D_ARRAY
:
668 width
= u_minify(res
->width0
, level
);
670 depth
= res
->array_size
;
672 case PIPE_TEXTURE_2D_ARRAY
:
673 width
= u_minify(res
->width0
, level
);
674 height
= u_minify(res
->height0
, level
);
675 depth
= res
->array_size
;
677 case PIPE_TEXTURE_CUBE_ARRAY
:
678 width
= u_minify(res
->width0
, level
);
679 height
= u_minify(res
->height0
, level
);
680 depth
= res
->array_size
;
681 assert(res
->array_size
% 6 == 0);
683 case PIPE_MAX_TEXTURE_TYPES
:
687 return box
->x
>= 0 &&
688 box
->x
+ box
->width
<= (int) width
&&
690 box
->y
+ box
->height
<= (int) height
&&
692 box
->z
+ box
->depth
<= (int) depth
;
696 get_sample_count(const struct pipe_resource
*res
)
698 return res
->nr_samples
? res
->nr_samples
: 1;
702 * Try to do a blit using resource_copy_region. The function calls
703 * resource_copy_region if the blit description is compatible with it.
705 * It returns TRUE if the blit was done using resource_copy_region.
707 * It returns FALSE otherwise and the caller must fall back to a more generic
708 * codepath for the blit operation. (e.g. by using u_blitter)
711 util_try_blit_via_copy_region(struct pipe_context
*ctx
,
712 const struct pipe_blit_info
*blit
)
714 unsigned mask
= util_format_get_mask(blit
->dst
.format
);
716 /* No format conversions. */
717 if (blit
->src
.resource
->format
!= blit
->src
.format
||
718 blit
->dst
.resource
->format
!= blit
->dst
.format
||
719 !util_is_format_compatible(
720 util_format_description(blit
->src
.resource
->format
),
721 util_format_description(blit
->dst
.resource
->format
))) {
725 /* No masks, no filtering, no scissor. */
726 if ((blit
->mask
& mask
) != mask
||
727 blit
->filter
!= PIPE_TEX_FILTER_NEAREST
||
728 blit
->scissor_enable
) {
733 if (blit
->src
.box
.width
< 0 ||
734 blit
->src
.box
.height
< 0 ||
735 blit
->src
.box
.depth
< 0) {
740 if (blit
->src
.box
.width
!= blit
->dst
.box
.width
||
741 blit
->src
.box
.height
!= blit
->dst
.box
.height
||
742 blit
->src
.box
.depth
!= blit
->dst
.box
.depth
) {
746 /* No out-of-bounds access. */
747 if (!is_box_inside_resource(blit
->src
.resource
, &blit
->src
.box
,
749 !is_box_inside_resource(blit
->dst
.resource
, &blit
->dst
.box
,
754 /* Sample counts must match. */
755 if (get_sample_count(blit
->src
.resource
) !=
756 get_sample_count(blit
->dst
.resource
)) {
760 if (blit
->alpha_blend
)
763 ctx
->resource_copy_region(ctx
, blit
->dst
.resource
, blit
->dst
.level
,
764 blit
->dst
.box
.x
, blit
->dst
.box
.y
, blit
->dst
.box
.z
,
765 blit
->src
.resource
, blit
->src
.level
,