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
35struct pipe_context;
36struct pipe_screen;
37struct svga_context;
38struct svga_texture;
39struct svga_winsys_surface;
40enum SVGA3dSurfaceFormat;
41
42
43struct 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
81void
82svga_mark_surfaces_dirty(struct svga_context *svga);
83
84extern void
85svga_propagate_surface(struct svga_context *svga, struct pipe_surface *surf,
86                       boolean reset);
87
88void
89svga_propagate_rendertargets(struct svga_context *svga);
90
91extern boolean
92svga_surface_needs_propagation(const struct pipe_surface *surf);
93
94struct svga_winsys_surface *
95svga_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
108void
109svga_texture_copy_region(struct svga_context *svga,
110                         struct svga_winsys_surface *src_handle,
111                         unsigned srcSubResource,
112                         unsigned src_x, unsigned src_y, unsigned src_z,
113                         struct svga_winsys_surface *dst_handle,
114                         unsigned dstSubResource,
115                         unsigned dst_x, unsigned dst_y, unsigned dst_z,
116                         unsigned width, unsigned height, unsigned depth);
117
118void
119svga_texture_copy_handle(struct svga_context *svga,
120                         struct svga_winsys_surface *src_handle,
121                         unsigned src_x, unsigned src_y, unsigned src_z,
122                         unsigned src_level, unsigned src_face,
123                         struct svga_winsys_surface *dst_handle,
124                         unsigned dst_x, unsigned dst_y, unsigned dst_z,
125                         unsigned dst_level, unsigned dst_face,
126                         unsigned width, unsigned height, unsigned depth);
127
128
129static inline struct svga_surface *
130svga_surface(struct pipe_surface *surface)
131{
132   return (struct svga_surface *)surface;
133}
134
135
136static inline const struct svga_surface *
137svga_surface_const(const struct pipe_surface *surface)
138{
139   return (const struct svga_surface *)surface;
140}
141
142struct pipe_surface *
143svga_validate_surface_view(struct svga_context *svga, struct svga_surface *s);
144
145static inline SVGA3dResourceType
146svga_resource_type(enum pipe_texture_target target)
147{
148   switch (target) {
149   case PIPE_BUFFER:
150      return SVGA3D_RESOURCE_BUFFER;
151   case PIPE_TEXTURE_1D:
152   case PIPE_TEXTURE_1D_ARRAY:
153      return SVGA3D_RESOURCE_TEXTURE1D;
154   case PIPE_TEXTURE_RECT:
155   case PIPE_TEXTURE_2D:
156   case PIPE_TEXTURE_2D_ARRAY:
157   case PIPE_TEXTURE_CUBE:
158   case PIPE_TEXTURE_CUBE_ARRAY:
159      /* drawing to cube map is treated as drawing to 2D array */
160      return SVGA3D_RESOURCE_TEXTURE2D;
161   case PIPE_TEXTURE_3D:
162      return SVGA3D_RESOURCE_TEXTURE3D;
163   default:
164      assert(!"Unexpected texture target");
165      return SVGA3D_RESOURCE_TEXTURE2D;
166   }
167}
168
169#endif
170