/********************************************************** * Copyright 2008-2009 VMware, Inc. All rights reserved. * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation * files (the "Software"), to deal in the Software without * restriction, including without limitation the rights to use, copy, * modify, merge, publish, distribute, sublicense, and/or sell copies * of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. * **********************************************************/ #ifndef SVGA_TEXTURE_H #define SVGA_TEXTURE_H #include "pipe/p_compiler.h" #include "pipe/p_state.h" #include "util/u_inlines.h" #include "util/u_memory.h" #include "util/u_transfer.h" #include "svga_screen_cache.h" struct pipe_context; struct pipe_screen; struct svga_context; struct svga_winsys_surface; enum SVGA3dSurfaceFormat; #define SVGA_MAX_TEXTURE_LEVELS 16 extern struct u_resource_vtbl svga_texture_vtbl; struct svga_texture { struct u_resource b; ushort *defined; struct svga_sampler_view *cached_view; unsigned view_age[SVGA_MAX_TEXTURE_LEVELS]; unsigned age; boolean views_modified; /** * Creation key for the host surface handle. * * This structure describes all the host surface characteristics so that it * can be looked up in cache, since creating a host surface is often a slow * operation. */ struct svga_host_surface_cache_key key; /** * Handle for the host side surface. * * This handle is owned by this texture. Views should hold on to a reference * to this texture and never destroy this handle directly. */ struct svga_winsys_surface *handle; /** * Whether the host side surface is validated, either through the * InvalidateGBSurface command or after the surface is updated * or rendered to. */ boolean validated; /** * Whether the host side surface is imported and not created by this * driver. */ boolean imported; /** * Whether texture upload buffer can be used on this texture */ boolean can_use_upload; unsigned size; /**< Approximate size in bytes */ /** array indexed by cube face or 3D/array slice, one bit per mipmap level */ ushort *rendered_to; /** array indexed by cube face or 3D/array slice, one bit per mipmap level. * Set if the level is marked as dirty. */ ushort *dirty; /** * A cached backing host side surface to be used if this texture is being * used for rendering and sampling at the same time. * Currently we only cache one handle. If needed, we can extend this to * support multiple handles. */ struct svga_host_surface_cache_key backed_key; struct svga_winsys_surface *backed_handle; unsigned backed_age; }; /* Note this is only used for texture (not buffer) transfers: */ struct svga_transfer { struct pipe_transfer base; unsigned slice; /**< array slice or cube face */ struct svga_winsys_buffer *hwbuf; /* Height of the hardware buffer in pixel blocks */ unsigned hw_nblocksy; /* Temporary malloc buffer when we can't allocate a hardware buffer * big enough */ void *swbuf; /* True if guest backed surface is supported and we can directly map * to the surface for this transfer. */ boolean use_direct_map; struct { struct pipe_resource *buf; /* points to the upload buffer if this * transfer is done via the upload buffer * instead of directly mapping to the * resource's surface. */ void *map; unsigned offset; SVGA3dBox box; unsigned nlayers; } upload; }; static inline struct svga_texture * svga_texture(struct pipe_resource *resource) { struct svga_texture *tex = (struct svga_texture *)resource; assert(tex == NULL || tex->b.vtbl == &svga_texture_vtbl); return tex; } static inline struct svga_transfer * svga_transfer(struct pipe_transfer *transfer) { assert(transfer); return (struct svga_transfer *)transfer; } /** * Increment the age of a view into a texture * This is used to track updates to textures when we draw into * them via a surface. */ static inline void svga_age_texture_view(struct svga_texture *tex, unsigned level) { assert(level < ARRAY_SIZE(tex->view_age)); tex->view_age[level] = ++(tex->age); } /** For debugging, check that face and level are legal */ static inline void check_face_level(const struct svga_texture *tex, unsigned face, unsigned level) { if (tex->b.b.target == PIPE_TEXTURE_CUBE) { assert(face < 6); } else if (tex->b.b.target == PIPE_TEXTURE_3D) { assert(face < tex->b.b.depth0); } else { assert(face < tex->b.b.array_size); } assert(level < 8 * sizeof(tex->rendered_to[0])); } /** * Mark the given texture face/level as being defined. */ static inline void svga_define_texture_level(struct svga_texture *tex, unsigned face,unsigned level) { check_face_level(tex, face, level); tex->defined[face] |= 1 << level; tex->validated = TRUE; } static inline bool svga_is_texture_level_defined(const struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); return (tex->defined[face] & (1 << level)) != 0; } static inline void svga_set_texture_rendered_to(struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); tex->rendered_to[face] |= 1 << level; tex->validated = TRUE; } static inline void svga_clear_texture_rendered_to(struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); tex->rendered_to[face] &= ~(1 << level); } static inline boolean svga_was_texture_rendered_to(const struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); return !!(tex->rendered_to[face] & (1 << level)); } static inline void svga_set_texture_dirty(struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); tex->dirty[face] |= 1 << level; } static inline void svga_clear_texture_dirty(struct svga_texture *tex) { unsigned i; for (i = 0; i < tex->b.b.depth0 * tex->b.b.array_size; i++) { tex->dirty[i] = 0; } } static inline boolean svga_is_texture_dirty(const struct svga_texture *tex, unsigned face, unsigned level) { check_face_level(tex, face, level); return !!(tex->dirty[face] & (1 << level)); } struct pipe_resource * svga_texture_create(struct pipe_screen *screen, const struct pipe_resource *template); struct pipe_resource * svga_texture_from_handle(struct pipe_screen * screen, const struct pipe_resource *template, struct winsys_handle *whandle); boolean svga_texture_generate_mipmap(struct pipe_context *pipe, struct pipe_resource *pt, enum pipe_format format, unsigned base_level, unsigned last_level, unsigned first_layer, unsigned last_layer); boolean svga_texture_transfer_map_upload_create(struct svga_context *svga); void svga_texture_transfer_map_upload_destroy(struct svga_context *svga); boolean svga_texture_transfer_map_can_upload(const struct svga_screen *svgascreen, const struct pipe_resource *pt); void * svga_texture_transfer_map_upload(struct svga_context *svga, struct svga_transfer *st); void svga_texture_transfer_unmap_upload(struct svga_context *svga, struct svga_transfer *st); boolean svga_texture_device_format_has_alpha(struct pipe_resource *texture); #endif /* SVGA_TEXTURE_H */