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_format.h"
40 #include "util/u_surface.h"
44 * Helper to quickly create an RGBA rendering surface of a certain size.
45 * \param textureOut returns the new texture
46 * \param surfaceOut returns the new surface
47 * \return TRUE for success, FALSE if failure
50 util_create_rgba_surface(struct pipe_screen
*screen
,
51 uint width
, uint height
,
52 struct pipe_texture
**textureOut
,
53 struct pipe_surface
**surfaceOut
)
55 static const enum pipe_format rgbaFormats
[] = {
56 PIPE_FORMAT_A8R8G8B8_UNORM
,
57 PIPE_FORMAT_B8G8R8A8_UNORM
,
58 PIPE_FORMAT_R8G8B8A8_UNORM
,
61 const uint target
= PIPE_TEXTURE_2D
;
62 const uint usage
= PIPE_TEXTURE_USAGE_RENDER_TARGET
;
63 enum pipe_format format
= PIPE_FORMAT_NONE
;
64 struct pipe_texture templ
;
67 /* Choose surface format */
68 for (i
= 0; rgbaFormats
[i
]; i
++) {
69 if (screen
->is_format_supported(screen
, rgbaFormats
[i
],
71 format
= rgbaFormats
[i
];
75 if (format
== PIPE_FORMAT_NONE
)
76 return FALSE
; /* unable to get an rgba format!?! */
79 memset(&templ
, 0, sizeof(templ
));
80 templ
.target
= target
;
81 templ
.format
= format
;
84 templ
.height0
= height
;
86 templ
.tex_usage
= usage
;
88 *textureOut
= screen
->texture_create(screen
, &templ
);
92 /* create surface / view into texture */
93 *surfaceOut
= screen
->get_tex_surface(screen
, *textureOut
, 0, 0, 0, PIPE_BUFFER_USAGE_GPU_WRITE
);
95 pipe_texture_reference(textureOut
, NULL
);
104 * Release the surface and texture from util_create_rgba_surface().
107 util_destroy_rgba_surface(struct pipe_texture
*texture
,
108 struct pipe_surface
*surface
)
110 pipe_surface_reference(&surface
, NULL
);
111 pipe_texture_reference(&texture
, NULL
);