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_screen.h"
36 #include "pipe/p_state.h"
37 #include "pipe/p_defines.h"
38 #include "util/u_inlines.h"
40 #include "util/u_memory.h"
41 #include "util/u_surface.h"
45 * Helper to quickly create an RGBA rendering surface of a certain size.
46 * \param textureOut returns the new texture
47 * \param surfaceOut returns the new surface
48 * \return TRUE for success, FALSE if failure
51 util_create_rgba_surface(struct pipe_screen
*screen
,
52 uint width
, uint height
,
53 struct pipe_texture
**textureOut
,
54 struct pipe_surface
**surfaceOut
)
56 static const enum pipe_format rgbaFormats
[] = {
57 PIPE_FORMAT_B8G8R8A8_UNORM
,
58 PIPE_FORMAT_A8R8G8B8_UNORM
,
59 PIPE_FORMAT_A8B8G8R8_UNORM
,
62 const uint target
= PIPE_TEXTURE_2D
;
63 const uint usage
= PIPE_TEXTURE_USAGE_RENDER_TARGET
;
64 enum pipe_format format
= PIPE_FORMAT_NONE
;
65 struct pipe_texture templ
;
68 /* Choose surface format */
69 for (i
= 0; rgbaFormats
[i
]; i
++) {
70 if (screen
->is_format_supported(screen
, rgbaFormats
[i
],
72 format
= rgbaFormats
[i
];
76 if (format
== PIPE_FORMAT_NONE
)
77 return FALSE
; /* unable to get an rgba format!?! */
80 memset(&templ
, 0, sizeof(templ
));
81 templ
.target
= target
;
82 templ
.format
= format
;
85 templ
.height0
= height
;
87 templ
.tex_usage
= usage
;
89 *textureOut
= screen
->texture_create(screen
, &templ
);
93 /* create surface / view into texture */
94 *surfaceOut
= screen
->get_tex_surface(screen
, *textureOut
, 0, 0, 0, PIPE_BUFFER_USAGE_GPU_WRITE
);
96 pipe_texture_reference(textureOut
, NULL
);
105 * Release the surface and texture from util_create_rgba_surface().
108 util_destroy_rgba_surface(struct pipe_texture
*texture
,
109 struct pipe_surface
*surface
)
111 pipe_surface_reference(&surface
, NULL
);
112 pipe_texture_reference(&texture
, NULL
);
118 * Compare pipe_framebuffer_state objects.
119 * \return TRUE if same, FALSE if different
122 util_framebuffer_state_equal(const struct pipe_framebuffer_state
*dst
,
123 const struct pipe_framebuffer_state
*src
)
127 if (dst
->width
!= src
->width
||
128 dst
->height
!= src
->height
)
131 for (i
= 0; i
< Elements(src
->cbufs
); i
++) {
132 if (dst
->cbufs
[i
] != src
->cbufs
[i
]) {
137 if (dst
->nr_cbufs
!= src
->nr_cbufs
) {
141 if (dst
->zsbuf
!= src
->zsbuf
) {
150 * Copy framebuffer state from src to dst, updating refcounts.
153 util_copy_framebuffer_state(struct pipe_framebuffer_state
*dst
,
154 const struct pipe_framebuffer_state
*src
)
158 dst
->width
= src
->width
;
159 dst
->height
= src
->height
;
161 for (i
= 0; i
< Elements(src
->cbufs
); i
++) {
162 pipe_surface_reference(&dst
->cbufs
[i
], src
->cbufs
[i
]);
165 dst
->nr_cbufs
= src
->nr_cbufs
;
167 pipe_surface_reference(&dst
->zsbuf
, src
->zsbuf
);
172 util_unreference_framebuffer_state(struct pipe_framebuffer_state
*fb
)
176 for (i
= 0; i
< fb
->nr_cbufs
; i
++) {
177 pipe_surface_reference(&fb
->cbufs
[i
], NULL
);
180 pipe_surface_reference(&fb
->zsbuf
, NULL
);
182 fb
->width
= fb
->height
= 0;