1 /**********************************************************
2 * Copyright 2008-2009 VMware, Inc. All rights reserved.
4 * Permission is hereby granted, free of charge, to any person
5 * obtaining a copy of this software and associated documentation
6 * files (the "Software"), to deal in the Software without
7 * restriction, including without limitation the rights to use, copy,
8 * modify, merge, publish, distribute, sublicense, and/or sell copies
9 * of the Software, and to permit persons to whom the Software is
10 * furnished to do so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 **********************************************************/
26 #ifndef SVGA_TEXTURE_H
27 #define SVGA_TEXTURE_H
30 #include "pipe/p_compiler.h"
31 #include "pipe/p_state.h"
32 #include "util/u_inlines.h"
33 #include "util/u_memory.h"
34 #include "util/u_transfer.h"
35 #include "svga_screen_cache.h"
40 struct svga_winsys_surface
;
41 enum SVGA3dSurfaceFormat
;
44 #define SVGA_MAX_TEXTURE_LEVELS 16
47 extern struct u_resource_vtbl svga_texture_vtbl
;
56 struct svga_sampler_view
*cached_view
;
58 unsigned view_age
[SVGA_MAX_TEXTURE_LEVELS
];
61 boolean views_modified
;
64 * Creation key for the host surface handle.
66 * This structure describes all the host surface characteristics so that it
67 * can be looked up in cache, since creating a host surface is often a slow
70 struct svga_host_surface_cache_key key
;
73 * Handle for the host side surface.
75 * This handle is owned by this texture. Views should hold on to a reference
76 * to this texture and never destroy this handle directly.
78 struct svga_winsys_surface
*handle
;
81 * Whether the host side surface is validated, either through the
82 * InvalidateGBSurface command or after the surface is updated
88 * Whether the host side surface is imported and not created by this
94 * Whether texture upload buffer can be used on this texture
96 boolean can_use_upload
;
98 unsigned size
; /**< Approximate size in bytes */
100 /** array indexed by cube face or 3D/array slice, one bit per mipmap level */
103 /** array indexed by cube face or 3D/array slice, one bit per mipmap level.
104 * Set if the level is marked as dirty.
109 * A cached backing host side surface to be used if this texture is being
110 * used for rendering and sampling at the same time.
111 * Currently we only cache one handle. If needed, we can extend this to
112 * support multiple handles.
114 struct svga_host_surface_cache_key backed_key
;
115 struct svga_winsys_surface
*backed_handle
;
121 /* Note this is only used for texture (not buffer) transfers:
125 struct pipe_transfer base
;
127 unsigned slice
; /**< array slice or cube face */
128 SVGA3dBox box
; /* The adjusted box with slice index removed from z */
130 struct svga_winsys_buffer
*hwbuf
;
132 /* Height of the hardware buffer in pixel blocks */
133 unsigned hw_nblocksy
;
135 /* Temporary malloc buffer when we can't allocate a hardware buffer
139 /* True if guest backed surface is supported and we can directly map
140 * to the surface for this transfer.
142 boolean use_direct_map
;
145 struct pipe_resource
*buf
; /* points to the upload buffer if this
146 * transfer is done via the upload buffer
147 * instead of directly mapping to the
148 * resource's surface.
158 static inline struct svga_texture
*
159 svga_texture(struct pipe_resource
*resource
)
161 struct svga_texture
*tex
= (struct svga_texture
*)resource
;
162 assert(tex
== NULL
|| tex
->b
.vtbl
== &svga_texture_vtbl
);
167 static inline struct svga_transfer
*
168 svga_transfer(struct pipe_transfer
*transfer
)
171 return (struct svga_transfer
*)transfer
;
176 * Increment the age of a view into a texture
177 * This is used to track updates to textures when we draw into
178 * them via a surface.
181 svga_age_texture_view(struct svga_texture
*tex
, unsigned level
)
183 assert(level
< ARRAY_SIZE(tex
->view_age
));
184 tex
->view_age
[level
] = ++(tex
->age
);
188 /** For debugging, check that face and level are legal */
190 check_face_level(const struct svga_texture
*tex
,
191 unsigned face
, unsigned level
)
193 if (tex
->b
.b
.target
== PIPE_TEXTURE_CUBE
) {
196 else if (tex
->b
.b
.target
== PIPE_TEXTURE_3D
) {
197 assert(face
< tex
->b
.b
.depth0
);
200 assert(face
< tex
->b
.b
.array_size
);
203 assert(level
< 8 * sizeof(tex
->rendered_to
[0]));
208 * Mark the given texture face/level as being defined.
211 svga_define_texture_level(struct svga_texture
*tex
,
212 unsigned face
,unsigned level
)
214 check_face_level(tex
, face
, level
);
215 tex
->defined
[face
] |= 1 << level
;
216 tex
->validated
= TRUE
;
221 svga_is_texture_level_defined(const struct svga_texture
*tex
,
222 unsigned face
, unsigned level
)
224 check_face_level(tex
, face
, level
);
225 return (tex
->defined
[face
] & (1 << level
)) != 0;
230 svga_set_texture_rendered_to(struct svga_texture
*tex
,
231 unsigned face
, unsigned level
)
233 check_face_level(tex
, face
, level
);
234 tex
->rendered_to
[face
] |= 1 << level
;
235 tex
->validated
= TRUE
;
240 svga_clear_texture_rendered_to(struct svga_texture
*tex
,
241 unsigned face
, unsigned level
)
243 check_face_level(tex
, face
, level
);
244 tex
->rendered_to
[face
] &= ~(1 << level
);
248 static inline boolean
249 svga_was_texture_rendered_to(const struct svga_texture
*tex
,
250 unsigned face
, unsigned level
)
252 check_face_level(tex
, face
, level
);
253 return !!(tex
->rendered_to
[face
] & (1 << level
));
257 svga_set_texture_dirty(struct svga_texture
*tex
,
258 unsigned face
, unsigned level
)
260 check_face_level(tex
, face
, level
);
261 tex
->dirty
[face
] |= 1 << level
;
265 svga_clear_texture_dirty(struct svga_texture
*tex
)
268 for (i
= 0; i
< tex
->b
.b
.depth0
* tex
->b
.b
.array_size
; i
++) {
273 static inline boolean
274 svga_is_texture_dirty(const struct svga_texture
*tex
,
275 unsigned face
, unsigned level
)
277 check_face_level(tex
, face
, level
);
278 return !!(tex
->dirty
[face
] & (1 << level
));
281 struct pipe_resource
*
282 svga_texture_create(struct pipe_screen
*screen
,
283 const struct pipe_resource
*template);
285 struct pipe_resource
*
286 svga_texture_from_handle(struct pipe_screen
* screen
,
287 const struct pipe_resource
*template,
288 struct winsys_handle
*whandle
);
291 svga_texture_generate_mipmap(struct pipe_context
*pipe
,
292 struct pipe_resource
*pt
,
293 enum pipe_format format
,
296 unsigned first_layer
,
297 unsigned last_layer
);
300 svga_texture_transfer_map_upload_create(struct svga_context
*svga
);
303 svga_texture_transfer_map_upload_destroy(struct svga_context
*svga
);
306 svga_texture_transfer_map_can_upload(const struct svga_screen
*svgascreen
,
307 const struct pipe_resource
*pt
);
310 svga_texture_transfer_map_upload(struct svga_context
*svga
,
311 struct svga_transfer
*st
);
314 svga_texture_transfer_unmap_upload(struct svga_context
*svga
,
315 struct svga_transfer
*st
);
318 svga_texture_device_format_has_alpha(struct pipe_resource
*texture
);
320 #endif /* SVGA_TEXTURE_H */