1 /********************************************************** 2 * Copyright 2008-2009 VMware, Inc. All rights reserved. 3 * 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: 11 * 12 * The above copyright notice and this permission notice shall be 13 * included in all copies or substantial portions of the Software. 14 * 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 22 * SOFTWARE. 23 * 24 **********************************************************/ 25 26 #ifndef SVGA_SAMPLER_VIEW_H 27 #define SVGA_SAMPLER_VIEW_H 28 29 30 #include "pipe/p_compiler.h" 31 #include "pipe/p_state.h" 32 #include "util/u_inlines.h" 33 #include "svga_screen_cache.h" 34 35 struct pipe_context; 36 struct pipe_screen; 37 struct svga_context; 38 struct svga_winsys_surface; 39 enum SVGA3dSurfaceFormat; 40 41 42 /** 43 * A sampler's view into a texture 44 * 45 * We currently cache one sampler view on 46 * the texture and in there by holding a reference 47 * from the texture to the sampler view. 48 * 49 * Because of this we can not hold a refernce to the 50 * texture from the sampler view. So the user 51 * of the sampler views must make sure that the 52 * texture has a reference take for as long as 53 * the sampler view is refrenced. 54 * 55 * Just unreferencing the sampler_view before the 56 * texture is enough. 57 */ 58 struct svga_sampler_view 59 { 60 struct pipe_reference reference; 61 62 struct pipe_resource *texture; 63 64 int min_lod; 65 int max_lod; 66 67 unsigned age; 68 69 struct svga_host_surface_cache_key key; 70 struct svga_winsys_surface *handle; 71 }; 72 73 74 75 extern struct svga_sampler_view * 76 svga_get_tex_sampler_view(struct pipe_context *pipe, 77 struct pipe_resource *pt, 78 unsigned min_lod, unsigned max_lod); 79 80 void 81 svga_validate_sampler_view(struct svga_context *svga, struct svga_sampler_view *v); 82 83 void 84 svga_destroy_sampler_view_priv(struct svga_sampler_view *v); 85 86 void 87 svga_debug_describe_sampler_view(char *buf, const struct svga_sampler_view *sv); 88 89 static INLINE void 90 svga_sampler_view_reference(struct svga_sampler_view **ptr, struct svga_sampler_view *v) 91 { 92 struct svga_sampler_view *old = *ptr; 93 94 if (pipe_reference_described(&(*ptr)->reference, &v->reference, 95 (debug_reference_descriptor)svga_debug_describe_sampler_view)) 96 svga_destroy_sampler_view_priv(old); 97 *ptr = v; 98 } 99 100 101 #endif 102