Home | History | Annotate | Download | only in svga
      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