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
,
54 struct pipe_resource
**textureOut
,
55 struct pipe_surface
**surfaceOut
)
57 static const enum pipe_format rgbaFormats
[] = {
58 PIPE_FORMAT_B8G8R8A8_UNORM
,
59 PIPE_FORMAT_A8R8G8B8_UNORM
,
60 PIPE_FORMAT_A8B8G8R8_UNORM
,
63 const uint target
= PIPE_TEXTURE_2D
;
64 enum pipe_format format
= PIPE_FORMAT_NONE
;
65 struct pipe_resource 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
;
89 *textureOut
= screen
->resource_create(screen
, &templ
);
93 /* create surface / view into texture */
94 *surfaceOut
= screen
->get_tex_surface(screen
,
99 pipe_resource_reference(textureOut
, NULL
);
108 * Release the surface and texture from util_create_rgba_surface().
111 util_destroy_rgba_surface(struct pipe_resource
*texture
,
112 struct pipe_surface
*surface
)
114 pipe_surface_reference(&surface
, NULL
);
115 pipe_resource_reference(&texture
, NULL
);