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 void
109 svga_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 
118 void
119 svga_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 
129 static inline struct svga_surface *
svga_surface(struct pipe_surface * surface)130 svga_surface(struct pipe_surface *surface)
131 {
132    return (struct svga_surface *)surface;
133 }
134 
135 
136 static inline const struct svga_surface *
svga_surface_const(const struct pipe_surface * surface)137 svga_surface_const(const struct pipe_surface *surface)
138 {
139    return (const struct svga_surface *)surface;
140 }
141 
142 struct pipe_surface *
143 svga_validate_surface_view(struct svga_context *svga, struct svga_surface *s);
144 
145 static inline SVGA3dResourceType
svga_resource_type(enum pipe_texture_target target)146 svga_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