src/gallium/drivers/svga/svga_surface.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_SURFACE_H
  27 #define SVGA_SURFACE_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_texture;
  39 struct svga_winsys_surface;
  40 enum SVGA3dSurfaceFormat;
  41
  42
  43 struct svga_surface
  44 {
  45    struct pipe_surface base;
  46
  47    struct svga_host_surface_cache_key key;
  48
  49    /*
  50     * Note that the handle may point at a secondary / backing resource
  51     * created by svga_texture_view_surface() which is something other
  52     * than svga_texture(base->texture)->handle.
  53     */
  54    struct svga_winsys_surface *handle;
  55
  56    unsigned real_layer;
  57    unsigned real_level;
  58    unsigned real_zslice;
  59
  60    boolean dirty;
  61
  62    /* VGPU10 */
  63    SVGA3dRenderTargetViewId view_id;
  64
  65    /*
  66     * As with 'handle' above, this may point to a secondary / backing resource.
  67     * We can't have one resource bound as both a render target and a shader
  68     * resource at the same time.  But we sometimes want to do that, such as
  69     * for mipmap generation where we sample from one level and render into
  70     * another.
  71     * In this situation, the backed surface is the render target while the
  72     * original surface is the shader resource.
  73     */
  74    struct svga_surface *backed;
  75    unsigned age;                   /* timestamp when the backed resource is
  76                                     * synced with the original resource.
  77                                     */
  78 };
  79
  80
  81 void
  82 svga_mark_surfaces_dirty(struct svga_context *svga);
  83
  84 extern void
  85 svga_propagate_surface(struct svga_context *svga, struct pipe_surface *surf,
  86                        boolean reset);
  87
  88 void
  89 svga_propagate_rendertargets(struct svga_context *svga);
  90
  91 extern boolean
  92 svga_surface_needs_propagation(const struct pipe_surface *surf);
  93
  94 struct svga_winsys_surface *
  95 svga_texture_view_surface(struct svga_context *svga,
  96                           struct svga_texture *tex,
  97                           unsigned bind_flags,
  98                           SVGA3dSurfaceAllFlags flags,
  99                           SVGA3dSurfaceFormat format,
 100                           unsigned start_mip,
 101                           unsigned num_mip,
 102                           int layer_pick,
 103                           unsigned num_layers,
 104                           int zslice_pick,
 105                           boolean cacheable,
 106                           struct svga_host_surface_cache_key *key); /* OUT */
 107
 108
 109 void
 110 svga_texture_copy_handle(struct svga_context *svga,
 111                          struct svga_winsys_surface *src_handle,
 112                          unsigned src_x, unsigned src_y, unsigned src_z,
 113                          unsigned src_level, unsigned src_face,
 114                          struct svga_winsys_surface *dst_handle,
 115                          unsigned dst_x, unsigned dst_y, unsigned dst_z,
 116                          unsigned dst_level, unsigned dst_face,
 117                          unsigned width, unsigned height, unsigned depth);
 118
 119
 120 static inline struct svga_surface *
 121 svga_surface(struct pipe_surface *surface)
 122 {
 123    return (struct svga_surface *)surface;
 124 }
 125
 126
 127 static inline const struct svga_surface *
 128 svga_surface_const(const struct pipe_surface *surface)
 129 {
 130    return (const struct svga_surface *)surface;
 131 }
 132
 133 struct pipe_surface *
 134 svga_validate_surface_view(struct svga_context *svga, struct svga_surface *s);
 135
 136 static inline SVGA3dResourceType
 137 svga_resource_type(enum pipe_texture_target target)
 138 {
 139    switch (target) {
 140    case PIPE_TEXTURE_1D:
 141    case PIPE_TEXTURE_1D_ARRAY:
 142       return SVGA3D_RESOURCE_TEXTURE1D;
 143    case PIPE_TEXTURE_RECT:
 144    case PIPE_TEXTURE_2D:
 145    case PIPE_TEXTURE_2D_ARRAY:
 146    case PIPE_TEXTURE_CUBE:
 147    case PIPE_TEXTURE_CUBE_ARRAY:
 148       /* drawing to cube map is treated as drawing to 2D array */
 149       return SVGA3D_RESOURCE_TEXTURE2D;
 150    case PIPE_TEXTURE_3D:
 151       return SVGA3D_RESOURCE_TEXTURE3D;
 152    default:
 153       assert(!"Unexpected texture target");
 154       return SVGA3D_RESOURCE_TEXTURE2D;
 155    }
 156 }
 157
 158 #endif