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_surface.h"
43 * Helper to quickly create an RGBA rendering surface of a certain size.
44 * \param textureOut returns the new texture
45 * \param surfaceOut returns the new surface
46 * \return TRUE for success, FALSE if failure
49 util_create_rgba_surface(struct pipe_screen
*screen
,
50 uint width
, uint height
,
51 struct pipe_texture
**textureOut
,
52 struct pipe_surface
**surfaceOut
)
54 static const enum pipe_format rgbaFormats
[] = {
55 PIPE_FORMAT_A8R8G8B8_UNORM
,
56 PIPE_FORMAT_B8G8R8A8_UNORM
,
57 PIPE_FORMAT_R8G8B8A8_UNORM
,
60 const uint target
= PIPE_TEXTURE_2D
;
61 const uint usage
= PIPE_TEXTURE_USAGE_RENDER_TARGET
;
62 enum pipe_format format
= PIPE_FORMAT_NONE
;
63 struct pipe_texture templ
;
66 /* Choose surface format */
67 for (i
= 0; rgbaFormats
[i
]; i
++) {
68 if (screen
->is_format_supported(screen
, rgbaFormats
[i
],
70 format
= rgbaFormats
[i
];
74 if (format
== PIPE_FORMAT_NONE
)
75 return FALSE
; /* unable to get an rgba format!?! */
78 memset(&templ
, 0, sizeof(templ
));
79 templ
.target
= target
;
80 templ
.format
= format
;
83 templ
.height0
= height
;
85 templ
.tex_usage
= usage
;
87 *textureOut
= screen
->texture_create(screen
, &templ
);
91 /* create surface / view into texture */
92 *surfaceOut
= screen
->get_tex_surface(screen
, *textureOut
, 0, 0, 0, PIPE_BUFFER_USAGE_GPU_WRITE
);
94 pipe_texture_reference(textureOut
, NULL
);
103 * Release the surface and texture from util_create_rgba_surface().
106 util_destroy_rgba_surface(struct pipe_texture
*texture
,
107 struct pipe_surface
*surface
)
109 pipe_surface_reference(&surface
, NULL
);
110 pipe_texture_reference(&texture
, NULL
);