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"
39 #include "util/u_memory.h"
40 #include "util/u_format.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_A8R8G8B8_UNORM,
58 PIPE_FORMAT_B8G8R8A8_UNORM,
59 PIPE_FORMAT_R8G8B8A8_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;