src/gallium/drivers/svga/svga_sampler_view.h

   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