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
,
55 memset(surf
, 0, sizeof(*surf
));
57 surf
->format
= texture
->format
;
58 /* XXX should filter out all non-rt/ds bind flags ? */
63 * Helper to quickly create an RGBA rendering surface of a certain size.
64 * \param textureOut returns the new texture
65 * \param surfaceOut returns the new surface
66 * \return TRUE for success, FALSE if failure
69 util_create_rgba_texture(struct pipe_context
*pipe
,
70 uint width
, uint height
, uint bind
,
71 struct pipe_resource
**textureOut
)
73 static const enum pipe_format rgbaFormats
[] = {
74 PIPE_FORMAT_B8G8R8A8_UNORM
,
75 PIPE_FORMAT_A8R8G8B8_UNORM
,
76 PIPE_FORMAT_A8B8G8R8_UNORM
,
79 const uint target
= PIPE_TEXTURE_2D
;
80 enum pipe_format format
= PIPE_FORMAT_NONE
;
81 struct pipe_resource templ
;
82 struct pipe_surface surf_templ
;
83 struct pipe_screen
*screen
= pipe
->screen
;
86 /* Choose surface format */
87 for (i
= 0; rgbaFormats
[i
]; i
++) {
88 if (screen
->is_format_supported(screen
, rgbaFormats
[i
],
90 format
= rgbaFormats
[i
];
94 if (format
== PIPE_FORMAT_NONE
)
95 return FALSE
; /* unable to get an rgba format!?! */
98 memset(&templ
, 0, sizeof(templ
));
99 templ
.target
= target
;
100 templ
.format
= format
;
101 templ
.last_level
= 0;
102 templ
.width0
= width
;
103 templ
.height0
= height
;
105 templ
.array_size
= 1;
108 *textureOut
= screen
->resource_create(screen
, &templ
);
113 u_surface_default_template(&surf_templ
, *textureOut
, bind
);
119 * Fallback function for pipe->resource_copy_region().
120 * Note: (X,Y)=(0,0) is always the upper-left corner.
123 util_resource_copy_region(struct pipe_context
*pipe
,
124 struct pipe_resource
*dst
,
126 unsigned dst_x
, unsigned dst_y
, unsigned dst_z
,
127 struct pipe_resource
*src
,
129 const struct pipe_box
*src_box
)
131 struct pipe_transfer
*src_trans
, *dst_trans
;
133 const uint8_t *src_map
;
134 enum pipe_format src_format
, dst_format
;
135 struct pipe_box dst_box
;
142 assert((src
->target
== PIPE_BUFFER
&& dst
->target
== PIPE_BUFFER
) ||
143 (src
->target
!= PIPE_BUFFER
&& dst
->target
!= PIPE_BUFFER
));
145 src_format
= src
->format
;
146 dst_format
= dst
->format
;
148 assert(util_format_get_blocksize(dst_format
) == util_format_get_blocksize(src_format
));
149 assert(util_format_get_blockwidth(dst_format
) == util_format_get_blockwidth(src_format
));
150 assert(util_format_get_blockheight(dst_format
) == util_format_get_blockheight(src_format
));
152 src_map
= pipe
->transfer_map(pipe
,
156 src_box
, &src_trans
);
165 dst_box
.width
= src_box
->width
;
166 dst_box
.height
= src_box
->height
;
167 dst_box
.depth
= src_box
->depth
;
169 dst_map
= pipe
->transfer_map(pipe
,
172 PIPE_TRANSFER_WRITE
| PIPE_TRANSFER_DISCARD_RANGE
,
173 &dst_box
, &dst_trans
);
179 if (dst
->target
== PIPE_BUFFER
&& src
->target
== PIPE_BUFFER
) {
180 assert(src_box
->height
== 1);
181 assert(src_box
->depth
== 1);
182 memcpy(dst_map
, src_map
, src_box
->width
);
184 for (z
= 0; z
< src_box
->depth
; ++z
) {
185 util_copy_rect(dst_map
,
189 src_box
->width
, src_box
->height
,
194 dst_map
+= dst_trans
->layer_stride
;
195 src_map
+= src_trans
->layer_stride
;
199 pipe
->transfer_unmap(pipe
, dst_trans
);
201 pipe
->transfer_unmap(pipe
, src_trans
);
208 #define UBYTE_TO_USHORT(B) ((B) | ((B) << 8))
212 * Fallback for pipe->clear_render_target() function.
213 * XXX this looks too hackish to be really useful.
214 * cpp > 4 looks like a gross hack at best...
215 * Plus can't use these transfer fallbacks when clearing
216 * multisampled surfaces for instance.
219 util_clear_render_target(struct pipe_context
*pipe
,
220 struct pipe_surface
*dst
,
221 const union pipe_color_union
*color
,
222 unsigned dstx
, unsigned dsty
,
223 unsigned width
, unsigned height
)
225 struct pipe_transfer
*dst_trans
;
229 assert(dst
->texture
);
232 /* XXX: should handle multiple layers */
233 dst_map
= pipe_transfer_map(pipe
,
236 dst
->u
.tex
.first_layer
,
238 dstx
, dsty
, width
, height
, &dst_trans
);
243 assert(dst_trans
->stride
> 0);
245 util_pack_color(color
->f
, dst
->texture
->format
, &uc
);
246 util_fill_rect(dst_map
, dst
->texture
->format
,
248 0, 0, width
, height
, &uc
);
250 pipe
->transfer_unmap(pipe
, dst_trans
);
255 * Fallback for pipe->clear_stencil() function.
256 * sw fallback doesn't look terribly useful here.
257 * Plus can't use these transfer fallbacks when clearing
258 * multisampled surfaces for instance.
261 util_clear_depth_stencil(struct pipe_context
*pipe
,
262 struct pipe_surface
*dst
,
263 unsigned clear_flags
,
266 unsigned dstx
, unsigned dsty
,
267 unsigned width
, unsigned height
)
269 struct pipe_transfer
*dst_trans
;
271 boolean need_rmw
= FALSE
;
273 if ((clear_flags
& PIPE_CLEAR_DEPTHSTENCIL
) &&
274 ((clear_flags
& PIPE_CLEAR_DEPTHSTENCIL
) != PIPE_CLEAR_DEPTHSTENCIL
) &&
275 util_format_is_depth_and_stencil(dst
->format
))
278 assert(dst
->texture
);
281 dst_map
= pipe_transfer_map(pipe
,
284 dst
->u
.tex
.first_layer
,
285 (need_rmw
? PIPE_TRANSFER_READ_WRITE
:
286 PIPE_TRANSFER_WRITE
),
287 dstx
, dsty
, width
, height
, &dst_trans
);
291 unsigned dst_stride
= dst_trans
->stride
;
292 uint64_t zstencil
= util_pack64_z_stencil(dst
->texture
->format
,
295 assert(dst_trans
->stride
> 0);
297 switch (util_format_get_blocksize(dst
->format
)) {
299 assert(dst
->format
== PIPE_FORMAT_S8_UINT
);
300 if(dst_stride
== width
)
301 memset(dst_map
, (uint8_t) zstencil
, height
* width
);
303 for (i
= 0; i
< height
; i
++) {
304 memset(dst_map
, (uint8_t) zstencil
, width
);
305 dst_map
+= dst_stride
;
310 assert(dst
->format
== PIPE_FORMAT_Z16_UNORM
);
311 for (i
= 0; i
< height
; i
++) {
312 uint16_t *row
= (uint16_t *)dst_map
;
313 for (j
= 0; j
< width
; j
++)
314 *row
++ = (uint16_t) zstencil
;
315 dst_map
+= dst_stride
;
320 for (i
= 0; i
< height
; i
++) {
321 uint32_t *row
= (uint32_t *)dst_map
;
322 for (j
= 0; j
< width
; j
++)
323 *row
++ = (uint32_t) zstencil
;
324 dst_map
+= dst_stride
;
329 if (dst
->format
== PIPE_FORMAT_Z24_UNORM_S8_UINT
)
330 dst_mask
= 0xffffff00;
332 assert(dst
->format
== PIPE_FORMAT_S8_UINT_Z24_UNORM
);
335 if (clear_flags
& PIPE_CLEAR_DEPTH
)
336 dst_mask
= ~dst_mask
;
337 for (i
= 0; i
< height
; i
++) {
338 uint32_t *row
= (uint32_t *)dst_map
;
339 for (j
= 0; j
< width
; j
++) {
340 uint32_t tmp
= *row
& dst_mask
;
341 *row
++ = tmp
| ((uint32_t) zstencil
& ~dst_mask
);
343 dst_map
+= dst_stride
;
349 for (i
= 0; i
< height
; i
++) {
350 uint64_t *row
= (uint64_t *)dst_map
;
351 for (j
= 0; j
< width
; j
++)
353 dst_map
+= dst_stride
;
359 if (clear_flags
& PIPE_CLEAR_DEPTH
)
360 src_mask
= 0x00000000ffffffffull
;
362 src_mask
= 0x000000ff00000000ull
;
364 for (i
= 0; i
< height
; i
++) {
365 uint64_t *row
= (uint64_t *)dst_map
;
366 for (j
= 0; j
< width
; j
++) {
367 uint64_t tmp
= *row
& ~src_mask
;
368 *row
++ = tmp
| (zstencil
& src_mask
);
370 dst_map
+= dst_stride
;
379 pipe
->transfer_unmap(pipe
, dst_trans
);