1 /**********************************************************
2 * Copyright 1998-2017 VMware, Inc. All rights reserved.
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:
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
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
24 **********************************************************/
29 * SVGA 3d hardware cmd definitions
32 #ifndef _SVGA3D_CMD_H_
33 #define _SVGA3D_CMD_H_
35 #define INCLUDE_ALLOW_MODULE
36 #define INCLUDE_ALLOW_USERLEVEL
37 #define INCLUDE_ALLOW_VMCORE
39 #include "includeCheck.h"
40 #include "svga3d_types.h"
41 #include "svga3d_limits.h"
44 * Identifiers for commands in the command FIFO.
46 * IDs between 1000 and 1039 (inclusive) were used by obsolete versions of
47 * the SVGA3D protocol and remain reserved; they should not be used in the
50 * IDs between 1040 and 2999 (inclusive) are available for use by the
51 * current SVGA3D protocol.
53 * FIFO clients other than SVGA3D should stay below 1000, or at 3000
58 SVGA_3D_CMD_LEGACY_BASE
= 1000,
59 SVGA_3D_CMD_BASE
= 1040,
61 SVGA_3D_CMD_SURFACE_DEFINE
= 1040,
62 SVGA_3D_CMD_SURFACE_DESTROY
= 1041,
63 SVGA_3D_CMD_SURFACE_COPY
= 1042,
64 SVGA_3D_CMD_SURFACE_STRETCHBLT
= 1043,
65 SVGA_3D_CMD_SURFACE_DMA
= 1044,
66 SVGA_3D_CMD_CONTEXT_DEFINE
= 1045,
67 SVGA_3D_CMD_CONTEXT_DESTROY
= 1046,
68 SVGA_3D_CMD_SETTRANSFORM
= 1047,
69 SVGA_3D_CMD_SETZRANGE
= 1048,
70 SVGA_3D_CMD_SETRENDERSTATE
= 1049,
71 SVGA_3D_CMD_SETRENDERTARGET
= 1050,
72 SVGA_3D_CMD_SETTEXTURESTATE
= 1051,
73 SVGA_3D_CMD_SETMATERIAL
= 1052,
74 SVGA_3D_CMD_SETLIGHTDATA
= 1053,
75 SVGA_3D_CMD_SETLIGHTENABLED
= 1054,
76 SVGA_3D_CMD_SETVIEWPORT
= 1055,
77 SVGA_3D_CMD_SETCLIPPLANE
= 1056,
78 SVGA_3D_CMD_CLEAR
= 1057,
79 SVGA_3D_CMD_PRESENT
= 1058,
80 SVGA_3D_CMD_SHADER_DEFINE
= 1059,
81 SVGA_3D_CMD_SHADER_DESTROY
= 1060,
82 SVGA_3D_CMD_SET_SHADER
= 1061,
83 SVGA_3D_CMD_SET_SHADER_CONST
= 1062,
84 SVGA_3D_CMD_DRAW_PRIMITIVES
= 1063,
85 SVGA_3D_CMD_SETSCISSORRECT
= 1064,
86 SVGA_3D_CMD_BEGIN_QUERY
= 1065,
87 SVGA_3D_CMD_END_QUERY
= 1066,
88 SVGA_3D_CMD_WAIT_FOR_QUERY
= 1067,
89 SVGA_3D_CMD_PRESENT_READBACK
= 1068,
90 SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN
= 1069,
91 SVGA_3D_CMD_SURFACE_DEFINE_V2
= 1070,
92 SVGA_3D_CMD_GENERATE_MIPMAPS
= 1071,
93 SVGA_3D_CMD_DEAD4
= 1072,
94 SVGA_3D_CMD_DEAD5
= 1073,
95 SVGA_3D_CMD_DEAD6
= 1074,
96 SVGA_3D_CMD_DEAD7
= 1075,
97 SVGA_3D_CMD_DEAD8
= 1076,
98 SVGA_3D_CMD_DEAD9
= 1077,
99 SVGA_3D_CMD_DEAD10
= 1078,
100 SVGA_3D_CMD_DEAD11
= 1079,
101 SVGA_3D_CMD_ACTIVATE_SURFACE
= 1080,
102 SVGA_3D_CMD_DEACTIVATE_SURFACE
= 1081,
103 SVGA_3D_CMD_SCREEN_DMA
= 1082,
104 SVGA_3D_CMD_DEAD1
= 1083,
105 SVGA_3D_CMD_DEAD2
= 1084,
107 SVGA_3D_CMD_DEAD12
= 1085,
108 SVGA_3D_CMD_DEAD13
= 1086,
109 SVGA_3D_CMD_DEAD14
= 1087,
110 SVGA_3D_CMD_DEAD15
= 1088,
111 SVGA_3D_CMD_DEAD16
= 1089,
112 SVGA_3D_CMD_DEAD17
= 1090,
114 SVGA_3D_CMD_SET_OTABLE_BASE
= 1091,
115 SVGA_3D_CMD_READBACK_OTABLE
= 1092,
117 SVGA_3D_CMD_DEFINE_GB_MOB
= 1093,
118 SVGA_3D_CMD_DESTROY_GB_MOB
= 1094,
119 SVGA_3D_CMD_DEAD3
= 1095,
120 SVGA_3D_CMD_UPDATE_GB_MOB_MAPPING
= 1096,
122 SVGA_3D_CMD_DEFINE_GB_SURFACE
= 1097,
123 SVGA_3D_CMD_DESTROY_GB_SURFACE
= 1098,
124 SVGA_3D_CMD_BIND_GB_SURFACE
= 1099,
125 SVGA_3D_CMD_COND_BIND_GB_SURFACE
= 1100,
126 SVGA_3D_CMD_UPDATE_GB_IMAGE
= 1101,
127 SVGA_3D_CMD_UPDATE_GB_SURFACE
= 1102,
128 SVGA_3D_CMD_READBACK_GB_IMAGE
= 1103,
129 SVGA_3D_CMD_READBACK_GB_SURFACE
= 1104,
130 SVGA_3D_CMD_INVALIDATE_GB_IMAGE
= 1105,
131 SVGA_3D_CMD_INVALIDATE_GB_SURFACE
= 1106,
133 SVGA_3D_CMD_DEFINE_GB_CONTEXT
= 1107,
134 SVGA_3D_CMD_DESTROY_GB_CONTEXT
= 1108,
135 SVGA_3D_CMD_BIND_GB_CONTEXT
= 1109,
136 SVGA_3D_CMD_READBACK_GB_CONTEXT
= 1110,
137 SVGA_3D_CMD_INVALIDATE_GB_CONTEXT
= 1111,
139 SVGA_3D_CMD_DEFINE_GB_SHADER
= 1112,
140 SVGA_3D_CMD_DESTROY_GB_SHADER
= 1113,
141 SVGA_3D_CMD_BIND_GB_SHADER
= 1114,
143 SVGA_3D_CMD_SET_OTABLE_BASE64
= 1115,
145 SVGA_3D_CMD_BEGIN_GB_QUERY
= 1116,
146 SVGA_3D_CMD_END_GB_QUERY
= 1117,
147 SVGA_3D_CMD_WAIT_FOR_GB_QUERY
= 1118,
149 SVGA_3D_CMD_NOP
= 1119,
151 SVGA_3D_CMD_ENABLE_GART
= 1120,
152 SVGA_3D_CMD_DISABLE_GART
= 1121,
153 SVGA_3D_CMD_MAP_MOB_INTO_GART
= 1122,
154 SVGA_3D_CMD_UNMAP_GART_RANGE
= 1123,
156 SVGA_3D_CMD_DEFINE_GB_SCREENTARGET
= 1124,
157 SVGA_3D_CMD_DESTROY_GB_SCREENTARGET
= 1125,
158 SVGA_3D_CMD_BIND_GB_SCREENTARGET
= 1126,
159 SVGA_3D_CMD_UPDATE_GB_SCREENTARGET
= 1127,
161 SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL
= 1128,
162 SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL
= 1129,
164 SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE
= 1130,
166 SVGA_3D_CMD_GB_SCREEN_DMA
= 1131,
167 SVGA_3D_CMD_BIND_GB_SURFACE_WITH_PITCH
= 1132,
168 SVGA_3D_CMD_GB_MOB_FENCE
= 1133,
169 SVGA_3D_CMD_DEFINE_GB_SURFACE_V2
= 1134,
170 SVGA_3D_CMD_DEFINE_GB_MOB64
= 1135,
171 SVGA_3D_CMD_REDEFINE_GB_MOB64
= 1136,
172 SVGA_3D_CMD_NOP_ERROR
= 1137,
174 SVGA_3D_CMD_SET_VERTEX_STREAMS
= 1138,
175 SVGA_3D_CMD_SET_VERTEX_DECLS
= 1139,
176 SVGA_3D_CMD_SET_VERTEX_DIVISORS
= 1140,
177 SVGA_3D_CMD_DRAW
= 1141,
178 SVGA_3D_CMD_DRAW_INDEXED
= 1142,
183 SVGA_3D_CMD_DX_MIN
= 1143,
184 SVGA_3D_CMD_DX_DEFINE_CONTEXT
= 1143,
185 SVGA_3D_CMD_DX_DESTROY_CONTEXT
= 1144,
186 SVGA_3D_CMD_DX_BIND_CONTEXT
= 1145,
187 SVGA_3D_CMD_DX_READBACK_CONTEXT
= 1146,
188 SVGA_3D_CMD_DX_INVALIDATE_CONTEXT
= 1147,
189 SVGA_3D_CMD_DX_SET_SINGLE_CONSTANT_BUFFER
= 1148,
190 SVGA_3D_CMD_DX_SET_SHADER_RESOURCES
= 1149,
191 SVGA_3D_CMD_DX_SET_SHADER
= 1150,
192 SVGA_3D_CMD_DX_SET_SAMPLERS
= 1151,
193 SVGA_3D_CMD_DX_DRAW
= 1152,
194 SVGA_3D_CMD_DX_DRAW_INDEXED
= 1153,
195 SVGA_3D_CMD_DX_DRAW_INSTANCED
= 1154,
196 SVGA_3D_CMD_DX_DRAW_INDEXED_INSTANCED
= 1155,
197 SVGA_3D_CMD_DX_DRAW_AUTO
= 1156,
198 SVGA_3D_CMD_DX_SET_INPUT_LAYOUT
= 1157,
199 SVGA_3D_CMD_DX_SET_VERTEX_BUFFERS
= 1158,
200 SVGA_3D_CMD_DX_SET_INDEX_BUFFER
= 1159,
201 SVGA_3D_CMD_DX_SET_TOPOLOGY
= 1160,
202 SVGA_3D_CMD_DX_SET_RENDERTARGETS
= 1161,
203 SVGA_3D_CMD_DX_SET_BLEND_STATE
= 1162,
204 SVGA_3D_CMD_DX_SET_DEPTHSTENCIL_STATE
= 1163,
205 SVGA_3D_CMD_DX_SET_RASTERIZER_STATE
= 1164,
206 SVGA_3D_CMD_DX_DEFINE_QUERY
= 1165,
207 SVGA_3D_CMD_DX_DESTROY_QUERY
= 1166,
208 SVGA_3D_CMD_DX_BIND_QUERY
= 1167,
209 SVGA_3D_CMD_DX_SET_QUERY_OFFSET
= 1168,
210 SVGA_3D_CMD_DX_BEGIN_QUERY
= 1169,
211 SVGA_3D_CMD_DX_END_QUERY
= 1170,
212 SVGA_3D_CMD_DX_READBACK_QUERY
= 1171,
213 SVGA_3D_CMD_DX_SET_PREDICATION
= 1172,
214 SVGA_3D_CMD_DX_SET_SOTARGETS
= 1173,
215 SVGA_3D_CMD_DX_SET_VIEWPORTS
= 1174,
216 SVGA_3D_CMD_DX_SET_SCISSORRECTS
= 1175,
217 SVGA_3D_CMD_DX_CLEAR_RENDERTARGET_VIEW
= 1176,
218 SVGA_3D_CMD_DX_CLEAR_DEPTHSTENCIL_VIEW
= 1177,
219 SVGA_3D_CMD_DX_PRED_COPY_REGION
= 1178,
220 SVGA_3D_CMD_DX_PRED_COPY
= 1179,
221 SVGA_3D_CMD_DX_PRESENTBLT
= 1180,
222 SVGA_3D_CMD_DX_GENMIPS
= 1181,
223 SVGA_3D_CMD_DX_UPDATE_SUBRESOURCE
= 1182,
224 SVGA_3D_CMD_DX_READBACK_SUBRESOURCE
= 1183,
225 SVGA_3D_CMD_DX_INVALIDATE_SUBRESOURCE
= 1184,
226 SVGA_3D_CMD_DX_DEFINE_SHADERRESOURCE_VIEW
= 1185,
227 SVGA_3D_CMD_DX_DESTROY_SHADERRESOURCE_VIEW
= 1186,
228 SVGA_3D_CMD_DX_DEFINE_RENDERTARGET_VIEW
= 1187,
229 SVGA_3D_CMD_DX_DESTROY_RENDERTARGET_VIEW
= 1188,
230 SVGA_3D_CMD_DX_DEFINE_DEPTHSTENCIL_VIEW
= 1189,
231 SVGA_3D_CMD_DX_DESTROY_DEPTHSTENCIL_VIEW
= 1190,
232 SVGA_3D_CMD_DX_DEFINE_ELEMENTLAYOUT
= 1191,
233 SVGA_3D_CMD_DX_DESTROY_ELEMENTLAYOUT
= 1192,
234 SVGA_3D_CMD_DX_DEFINE_BLEND_STATE
= 1193,
235 SVGA_3D_CMD_DX_DESTROY_BLEND_STATE
= 1194,
236 SVGA_3D_CMD_DX_DEFINE_DEPTHSTENCIL_STATE
= 1195,
237 SVGA_3D_CMD_DX_DESTROY_DEPTHSTENCIL_STATE
= 1196,
238 SVGA_3D_CMD_DX_DEFINE_RASTERIZER_STATE
= 1197,
239 SVGA_3D_CMD_DX_DESTROY_RASTERIZER_STATE
= 1198,
240 SVGA_3D_CMD_DX_DEFINE_SAMPLER_STATE
= 1199,
241 SVGA_3D_CMD_DX_DESTROY_SAMPLER_STATE
= 1200,
242 SVGA_3D_CMD_DX_DEFINE_SHADER
= 1201,
243 SVGA_3D_CMD_DX_DESTROY_SHADER
= 1202,
244 SVGA_3D_CMD_DX_BIND_SHADER
= 1203,
245 SVGA_3D_CMD_DX_DEFINE_STREAMOUTPUT
= 1204,
246 SVGA_3D_CMD_DX_DESTROY_STREAMOUTPUT
= 1205,
247 SVGA_3D_CMD_DX_SET_STREAMOUTPUT
= 1206,
248 SVGA_3D_CMD_DX_SET_COTABLE
= 1207,
249 SVGA_3D_CMD_DX_READBACK_COTABLE
= 1208,
250 SVGA_3D_CMD_DX_BUFFER_COPY
= 1209,
251 SVGA_3D_CMD_DX_TRANSFER_FROM_BUFFER
= 1210,
252 SVGA_3D_CMD_DX_SURFACE_COPY_AND_READBACK
= 1211,
253 SVGA_3D_CMD_DX_MOVE_QUERY
= 1212,
254 SVGA_3D_CMD_DX_BIND_ALL_QUERY
= 1213,
255 SVGA_3D_CMD_DX_READBACK_ALL_QUERY
= 1214,
256 SVGA_3D_CMD_DX_PRED_TRANSFER_FROM_BUFFER
= 1215,
257 SVGA_3D_CMD_DX_MOB_FENCE_64
= 1216,
258 SVGA_3D_CMD_DX_BIND_ALL_SHADER
= 1217,
259 SVGA_3D_CMD_DX_HINT
= 1218,
260 SVGA_3D_CMD_DX_BUFFER_UPDATE
= 1219,
261 SVGA_3D_CMD_DX_SET_VS_CONSTANT_BUFFER_OFFSET
= 1220,
262 SVGA_3D_CMD_DX_SET_PS_CONSTANT_BUFFER_OFFSET
= 1221,
263 SVGA_3D_CMD_DX_SET_GS_CONSTANT_BUFFER_OFFSET
= 1222,
264 SVGA_3D_CMD_DX_SET_HS_CONSTANT_BUFFER_OFFSET
= 1223,
265 SVGA_3D_CMD_DX_SET_DS_CONSTANT_BUFFER_OFFSET
= 1224,
266 SVGA_3D_CMD_DX_SET_CS_CONSTANT_BUFFER_OFFSET
= 1225,
268 SVGA_3D_CMD_DX_COND_BIND_ALL_SHADER
= 1226,
269 SVGA_3D_CMD_DX_MAX
= 1227,
271 SVGA_3D_CMD_SCREEN_COPY
= 1227,
273 SVGA_3D_CMD_VIDEO_DEFINE_DECODER
= 1228,
274 SVGA_3D_CMD_VIDEO_DESTROY_DECODER
= 1229,
275 SVGA_3D_CMD_VIDEO_DEFINE_PROCESSOR
= 1230,
276 SVGA_3D_CMD_VIDEO_DESTROY_PROCESSOR
= 1231,
277 SVGA_3D_CMD_VIDEO_DECODE_FRAME
= 1232,
278 SVGA_3D_CMD_VIDEO_PROCESS_FRAME
= 1233,
279 SVGA_3D_CMD_VIDEO_BIND_DECODER_MOB
= 1234,
280 SVGA_3D_CMD_VIDEO_READBACK_DECODER_MOB
= 1235,
282 SVGA_3D_CMD_GROW_OTABLE
= 1236,
283 SVGA_3D_CMD_DX_GROW_COTABLE
= 1237,
284 SVGA_3D_CMD_INTRA_SURFACE_COPY
= 1238,
286 SVGA_3D_CMD_DEFINE_GB_SURFACE_V3
= 1239,
288 SVGA_3D_CMD_DX_RESOLVE_COPY
= 1240,
289 SVGA_3D_CMD_DX_PRED_RESOLVE_COPY
= 1241,
290 SVGA_3D_CMD_DX_PRED_CONVERT_REGION
= 1242,
291 SVGA_3D_CMD_DX_PRED_CONVERT
= 1243,
292 SVGA_3D_CMD_WHOLE_SURFACE_COPY
= 1244,
294 SVGA_3D_CMD_DX_DEFINE_UA_VIEW
= 1245,
295 SVGA_3D_CMD_DX_DESTROY_UA_VIEW
= 1246,
296 SVGA_3D_CMD_DX_CLEAR_UA_VIEW_UINT
= 1247,
297 SVGA_3D_CMD_DX_CLEAR_UA_VIEW_FLOAT
= 1248,
298 SVGA_3D_CMD_DX_COPY_STRUCTURE_COUNT
= 1249,
299 SVGA_3D_CMD_DX_SET_UA_VIEWS
= 1250,
301 SVGA_3D_CMD_DX_DRAW_INDEXED_INSTANCED_INDIRECT
= 1251,
302 SVGA_3D_CMD_DX_DRAW_INSTANCED_INDIRECT
= 1252,
303 SVGA_3D_CMD_DX_DISPATCH
= 1253,
304 SVGA_3D_CMD_DX_DISPATCH_INDIRECT
= 1254,
306 SVGA_3D_CMD_WRITE_ZERO_SURFACE
= 1255,
307 SVGA_3D_CMD_HINT_ZERO_SURFACE
= 1256,
308 SVGA_3D_CMD_DX_TRANSFER_TO_BUFFER
= 1257,
309 SVGA_3D_CMD_DX_SET_STRUCTURE_COUNT
= 1258,
311 SVGA_3D_CMD_LOGICOPS_BITBLT
= 1259,
312 SVGA_3D_CMD_LOGICOPS_TRANSBLT
= 1260,
313 SVGA_3D_CMD_LOGICOPS_STRETCHBLT
= 1261,
314 SVGA_3D_CMD_LOGICOPS_COLORFILL
= 1262,
315 SVGA_3D_CMD_LOGICOPS_ALPHABLEND
= 1263,
316 SVGA_3D_CMD_LOGICOPS_CLEARTYPEBLEND
= 1264,
318 SVGA_3D_CMD_DX_COPY_COTABLE_INTO_MOB
= 1265,
320 SVGA_3D_CMD_UPDATE_GB_SCREENTARGET_V2
= 1266,
321 SVGA_3D_CMD_DEFINE_GB_SURFACE_V4
= 1267,
322 SVGA_3D_CMD_DX_SET_CS_UA_VIEWS
= 1268,
323 SVGA_3D_CMD_DX_SET_MIN_LOD
= 1269,
324 SVGA_3D_CMD_DX_CLEAR_RENDERTARGET_VIEW_BOX
= 1270,
325 SVGA_3D_CMD_DX_CLEAR_UA_VIEW_BOX
= 1271,
326 SVGA_3D_CMD_DX_DEFINE_DEPTHSTENCIL_VIEW_V2
= 1272,
327 SVGA_3D_CMD_DX_DEFINE_STREAMOUTPUT_WITH_MOB
= 1273,
328 SVGA_3D_CMD_DX_SET_SHADER_IFACE
= 1274,
329 SVGA_3D_CMD_DX_BIND_STREAMOUTPUT
= 1275,
331 SVGA_3D_CMD_MAX
= 1276,
332 SVGA_3D_CMD_FUTURE_MAX
= 3000
336 * FIFO command format definitions:
340 * The data size header following cmdNum for every 3d command
343 #include "vmware_pack_begin.h"
348 #include "vmware_pack_end.h"
352 #include "vmware_pack_begin.h"
356 #include "vmware_pack_end.h"
360 #include "vmware_pack_begin.h"
363 SVGA3dSurface1Flags surfaceFlags
;
364 SVGA3dSurfaceFormat format
;
367 * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
368 * structures must have the same value of numMipLevels field.
369 * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
370 * numMipLevels set to 0.
372 SVGA3dSurfaceFace face
[SVGA3D_MAX_SURFACE_FACES
];
375 * Followed by an SVGA3dSize structure for each mip level in each face.
377 * A note on surface sizes: Sizes are always specified in pixels,
378 * even if the true surface size is not a multiple of the minimum
379 * block size of the surface's format. For example, a 3x3x1 DXT1
380 * compressed texture would actually be stored as a 4x4x1 image in
384 #include "vmware_pack_end.h"
385 SVGA3dCmdDefineSurface
; /* SVGA_3D_CMD_SURFACE_DEFINE */
388 #include "vmware_pack_begin.h"
391 SVGA3dSurface1Flags surfaceFlags
;
392 SVGA3dSurfaceFormat format
;
395 * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
396 * structures must have the same value of numMipLevels field.
397 * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
398 * numMipLevels set to 0.
400 SVGA3dSurfaceFace face
[SVGA3D_MAX_SURFACE_FACES
];
401 uint32 multisampleCount
;
402 SVGA3dTextureFilter autogenFilter
;
405 * Followed by an SVGA3dSize structure for each mip level in each face.
407 * A note on surface sizes: Sizes are always specified in pixels,
408 * even if the true surface size is not a multiple of the minimum
409 * block size of the surface's format. For example, a 3x3x1 DXT1
410 * compressed texture would actually be stored as a 4x4x1 image in
414 #include "vmware_pack_end.h"
415 SVGA3dCmdDefineSurface_v2
; /* SVGA_3D_CMD_SURFACE_DEFINE_V2 */
418 #include "vmware_pack_begin.h"
422 #include "vmware_pack_end.h"
423 SVGA3dCmdDestroySurface
; /* SVGA_3D_CMD_SURFACE_DESTROY */
426 #include "vmware_pack_begin.h"
430 #include "vmware_pack_end.h"
431 SVGA3dCmdDefineContext
; /* SVGA_3D_CMD_CONTEXT_DEFINE */
434 #include "vmware_pack_begin.h"
438 #include "vmware_pack_end.h"
439 SVGA3dCmdDestroyContext
; /* SVGA_3D_CMD_CONTEXT_DESTROY */
442 #include "vmware_pack_begin.h"
445 SVGA3dClearFlag clearFlag
;
449 /* Followed by variable number of SVGA3dRect structures */
451 #include "vmware_pack_end.h"
452 SVGA3dCmdClear
; /* SVGA_3D_CMD_CLEAR */
455 #include "vmware_pack_begin.h"
457 SVGA3dLightType type
;
458 SVGA3dBool inWorldSpace
;
472 #include "vmware_pack_end.h"
476 #include "vmware_pack_begin.h"
479 /* Followed by variable number of SVGA3dCopyRect structures */
481 #include "vmware_pack_end.h"
482 SVGA3dCmdPresent
; /* SVGA_3D_CMD_PRESENT */
485 #include "vmware_pack_begin.h"
487 SVGA3dRenderStateName state
;
493 #include "vmware_pack_end.h"
497 #include "vmware_pack_begin.h"
500 /* Followed by variable number of SVGA3dRenderState structures */
502 #include "vmware_pack_end.h"
503 SVGA3dCmdSetRenderState
; /* SVGA_3D_CMD_SETRENDERSTATE */
506 #include "vmware_pack_begin.h"
509 SVGA3dRenderTargetType type
;
510 SVGA3dSurfaceImageId target
;
512 #include "vmware_pack_end.h"
513 SVGA3dCmdSetRenderTarget
; /* SVGA_3D_CMD_SETRENDERTARGET */
516 #include "vmware_pack_begin.h"
518 SVGA3dSurfaceImageId src
;
519 SVGA3dSurfaceImageId dest
;
520 /* Followed by variable number of SVGA3dCopyBox structures */
522 #include "vmware_pack_end.h"
523 SVGA3dCmdSurfaceCopy
; /* SVGA_3D_CMD_SURFACE_COPY */
526 * Perform a surface copy within the same image.
527 * The src/dest boxes are allowed to overlap.
530 #include "vmware_pack_begin.h"
532 SVGA3dSurfaceImageId surface
;
535 #include "vmware_pack_end.h"
536 SVGA3dCmdIntraSurfaceCopy
; /* SVGA_3D_CMD_INTRA_SURFACE_COPY */
539 #include "vmware_pack_begin.h"
541 SVGA3dSurfaceImageId src
;
542 SVGA3dSurfaceImageId dest
;
545 SVGA3dStretchBltMode mode
;
547 #include "vmware_pack_end.h"
548 SVGA3dCmdSurfaceStretchBlt
; /* SVGA_3D_CMD_SURFACE_STRETCHBLT */
551 #include "vmware_pack_begin.h"
554 * If the discard flag is present in a surface DMA operation, the host may
555 * discard the contents of the current mipmap level and face of the target
556 * surface before applying the surface DMA contents.
561 * If the unsynchronized flag is present, the host may perform this upload
562 * without syncing to pending reads on this surface.
564 uint32 unsynchronized
: 1;
567 * Guests *MUST* set the reserved bits to 0 before submitting the command
568 * suffix as future flags may occupy these bits.
570 uint32 reserved
: 30;
572 #include "vmware_pack_end.h"
573 SVGA3dSurfaceDMAFlags
;
576 #include "vmware_pack_begin.h"
578 SVGAGuestImage guest
;
579 SVGA3dSurfaceImageId host
;
580 SVGA3dTransferType transfer
;
583 * Followed by variable number of SVGA3dCopyBox structures. For consistency
584 * in all clipping logic and coordinate translation, we define the
585 * "source" in each copyBox as the guest image and the
586 * "destination" as the host image, regardless of transfer
589 * For efficiency, the SVGA3D device is free to copy more data than
590 * specified. For example, it may round copy boxes outwards such
591 * that they lie on particular alignment boundaries.
594 #include "vmware_pack_end.h"
595 SVGA3dCmdSurfaceDMA
; /* SVGA_3D_CMD_SURFACE_DMA */
598 * SVGA3dCmdSurfaceDMASuffix --
600 * This is a command suffix that will appear after a SurfaceDMA command in
601 * the FIFO. It contains some extra information that hosts may use to
602 * optimize performance or protect the guest. This suffix exists to preserve
603 * backwards compatibility while also allowing for new functionality to be
608 #include "vmware_pack_begin.h"
613 * The maximum offset is used to determine the maximum offset from the
614 * guestPtr base address that will be accessed or written to during this
615 * surfaceDMA. If the suffix is supported, the host will respect this
616 * boundary while performing surface DMAs.
618 * Defaults to MAX_UINT32
620 uint32 maximumOffset
;
623 * A set of flags that describes optimizations that the host may perform
624 * while performing this surface DMA operation. The guest should never rely
625 * on behaviour that is different when these flags are set for correctness.
629 SVGA3dSurfaceDMAFlags flags
;
631 #include "vmware_pack_end.h"
632 SVGA3dCmdSurfaceDMASuffix
;
635 * SVGA_3D_CMD_DRAW_PRIMITIVES --
637 * This command is the SVGA3D device's generic drawing entry point.
638 * It can draw multiple ranges of primitives, optionally using an
639 * index buffer, using an arbitrary collection of vertex buffers.
641 * Each SVGA3dVertexDecl defines a distinct vertex array to bind
642 * during this draw call. The declarations specify which surface
643 * the vertex data lives in, what that vertex data is used for,
644 * and how to interpret it.
646 * Each SVGA3dPrimitiveRange defines a collection of primitives
647 * to render using the same vertex arrays. An index buffer is
652 #include "vmware_pack_begin.h"
655 * A range hint is an optional specification for the range of indices
656 * in an SVGA3dArray that will be used. If 'last' is zero, it is assumed
657 * that the entire array will be used.
659 * These are only hints. The SVGA3D device may use them for
660 * performance optimization if possible, but it's also allowed to
661 * ignore these values.
666 #include "vmware_pack_end.h"
667 SVGA3dArrayRangeHint
;
670 #include "vmware_pack_begin.h"
673 * Define the origin and shape of a vertex or index array. Both
674 * 'offset' and 'stride' are in bytes. The provided surface will be
675 * reinterpreted as a flat array of bytes in the same format used
676 * by surface DMA operations. To avoid unnecessary conversions, the
677 * surface should be created with the SVGA3D_BUFFER format.
679 * Index 0 in the array starts 'offset' bytes into the surface.
680 * Index 1 begins at byte 'offset + stride', etc. Array indices may
687 #include "vmware_pack_end.h"
691 #include "vmware_pack_begin.h"
694 * Describe a vertex array's data type, and define how it is to be
695 * used by the fixed function pipeline or the vertex shader. It
696 * isn't useful to have two VertexDecls with the same
697 * VertexArrayIdentity in one draw call.
700 SVGA3dDeclMethod method
;
701 SVGA3dDeclUsage usage
;
704 #include "vmware_pack_end.h"
705 SVGA3dVertexArrayIdentity
;
708 #include "vmware_pack_begin.h"
709 struct SVGA3dVertexDecl
{
710 SVGA3dVertexArrayIdentity identity
;
712 SVGA3dArrayRangeHint rangeHint
;
714 #include "vmware_pack_end.h"
718 #include "vmware_pack_begin.h"
719 struct SVGA3dPrimitiveRange
{
721 * Define a group of primitives to render, from sequential indices.
723 * The value of 'primitiveType' and 'primitiveCount' imply the
724 * total number of vertices that will be rendered.
726 SVGA3dPrimitiveType primType
;
727 uint32 primitiveCount
;
730 * Optional index buffer. If indexArray.surfaceId is
731 * SVGA3D_INVALID_ID, we render without an index buffer. Rendering
732 * without an index buffer is identical to rendering with an index
733 * buffer containing the sequence [0, 1, 2, 3, ...].
735 * If an index buffer is in use, indexWidth specifies the width in
736 * bytes of each index value. It must be less than or equal to
739 * (Currently, the SVGA3D device requires index buffers to be tightly
740 * packed. In other words, indexWidth == indexArray.stride)
742 SVGA3dArray indexArray
;
746 * Optional index bias. This number is added to all indices from
747 * indexArray before they are used as vertex array indices. This
748 * can be used in multiple ways:
750 * - When not using an indexArray, this bias can be used to
751 * specify where in the vertex arrays to begin rendering.
753 * - A positive number here is equivalent to increasing the
754 * offset in each vertex array.
756 * - A negative number can be used to render using a small
757 * vertex array and an index buffer that contains large
758 * values. This may be used by some applications that
759 * crop a vertex buffer without modifying their index
762 * Note that rendering with a negative bias value may be slower and
763 * use more memory than rendering with a positive or zero bias.
767 #include "vmware_pack_end.h"
768 SVGA3dPrimitiveRange
;
771 #include "vmware_pack_begin.h"
774 uint32 numVertexDecls
;
778 * There are two variable size arrays after the
779 * SVGA3dCmdDrawPrimitives structure. In order,
782 * 1. SVGA3dVertexDecl, quantity 'numVertexDecls', but no more than
783 * SVGA3D_MAX_VERTEX_ARRAYS;
784 * 2. SVGA3dPrimitiveRange, quantity 'numRanges', but no more than
785 * SVGA3D_MAX_DRAW_PRIMITIVE_RANGES;
786 * 3. Optionally, SVGA3dVertexDivisor, quantity 'numVertexDecls' (contains
787 * the frequency divisor for the corresponding vertex decl).
790 #include "vmware_pack_end.h"
791 SVGA3dCmdDrawPrimitives
; /* SVGA_3D_CMD_DRAWPRIMITIVES */
794 #include "vmware_pack_begin.h"
798 uint32 primitiveCount
; // How many primitives to render
799 uint32 startVertexLocation
; // Which vertex do we start rendering at.
801 uint8 primitiveType
; // SVGA3dPrimitiveType
804 #include "vmware_pack_end.h"
808 #include "vmware_pack_begin.h"
812 uint8 primitiveType
; // SVGA3dPrimitiveType
814 uint32 indexBufferSid
; // Valid index buffer sid.
815 uint32 indexBufferOffset
; // Byte offset into the vertex buffer, almost
816 // always 0 for DX9 guests, non-zero for OpenGL
817 // guests. We can't represent non-multiple of
818 // stride offsets in D3D9Renderer...
819 uint8 indexBufferStride
; // Allowable values = 1, 2, or 4
821 int32 baseVertexLocation
; // Bias applied to the index when selecting a
822 // vertex from the streams, may be negative
824 uint32 primitiveCount
; // How many primitives to render
828 #include "vmware_pack_end.h"
829 SVGA3dCmdDrawIndexed
;
832 #include "vmware_pack_begin.h"
835 * Describe a vertex array's data type, and define how it is to be
836 * used by the fixed function pipeline or the vertex shader. It
837 * isn't useful to have two VertexDecls with the same
838 * VertexArrayIdentity in one draw call.
842 uint8 type
; // SVGA3dDeclType
843 uint8 method
; // SVGA3dDeclMethod
844 uint8 usage
; // SVGA3dDeclUsage
849 #include "vmware_pack_end.h"
853 * Should the vertex element respect the stream value? The high bit of the
854 * stream should be set to indicate that the stream should be respected. If
855 * the high bit is not set, the stream will be ignored and replaced by the index
856 * of the position of the currently considered vertex element.
858 * All guests should set this bit and correctly specify the stream going
861 #define SVGA3D_VERTEX_ELEMENT_RESPECT_STREAM (1 << 7)
864 #include "vmware_pack_begin.h"
871 * Followed by numElements SVGA3dVertexElement structures.
873 * If numElements < SVGA3D_MAX_VERTEX_ARRAYS, the remaining elements
874 * are cleared and will not be used by following draws.
877 #include "vmware_pack_end.h"
878 SVGA3dCmdSetVertexDecls
;
881 #include "vmware_pack_begin.h"
887 #include "vmware_pack_end.h"
891 #include "vmware_pack_begin.h"
897 * Followed by numStream SVGA3dVertexStream structures.
899 * If numStreams < SVGA3D_MAX_VERTEX_ARRAYS, the remaining streams
900 * are cleared and will not be used by following draws.
903 #include "vmware_pack_end.h"
904 SVGA3dCmdSetVertexStreams
;
907 #include "vmware_pack_begin.h"
912 #include "vmware_pack_end.h"
913 SVGA3dCmdSetVertexDivisors
;
916 #include "vmware_pack_begin.h"
919 SVGA3dTextureStateName name
;
925 #include "vmware_pack_end.h"
929 #include "vmware_pack_begin.h"
932 /* Followed by variable number of SVGA3dTextureState structures */
934 #include "vmware_pack_end.h"
935 SVGA3dCmdSetTextureState
; /* SVGA_3D_CMD_SETTEXTURESTATE */
938 #include "vmware_pack_begin.h"
941 SVGA3dTransformType type
;
944 #include "vmware_pack_end.h"
945 SVGA3dCmdSetTransform
; /* SVGA_3D_CMD_SETTRANSFORM */
948 #include "vmware_pack_begin.h"
953 #include "vmware_pack_end.h"
957 #include "vmware_pack_begin.h"
962 #include "vmware_pack_end.h"
963 SVGA3dCmdSetZRange
; /* SVGA_3D_CMD_SETZRANGE */
966 #include "vmware_pack_begin.h"
974 #include "vmware_pack_end.h"
978 #include "vmware_pack_begin.h"
982 SVGA3dMaterial material
;
984 #include "vmware_pack_end.h"
985 SVGA3dCmdSetMaterial
; /* SVGA_3D_CMD_SETMATERIAL */
988 #include "vmware_pack_begin.h"
992 SVGA3dLightData data
;
994 #include "vmware_pack_end.h"
995 SVGA3dCmdSetLightData
; /* SVGA_3D_CMD_SETLIGHTDATA */
998 #include "vmware_pack_begin.h"
1004 #include "vmware_pack_end.h"
1005 SVGA3dCmdSetLightEnabled
; /* SVGA_3D_CMD_SETLIGHTENABLED */
1008 #include "vmware_pack_begin.h"
1013 #include "vmware_pack_end.h"
1014 SVGA3dCmdSetViewport
; /* SVGA_3D_CMD_SETVIEWPORT */
1017 #include "vmware_pack_begin.h"
1022 #include "vmware_pack_end.h"
1023 SVGA3dCmdSetScissorRect
; /* SVGA_3D_CMD_SETSCISSORRECT */
1026 #include "vmware_pack_begin.h"
1032 #include "vmware_pack_end.h"
1033 SVGA3dCmdSetClipPlane
; /* SVGA_3D_CMD_SETCLIPPLANE */
1036 #include "vmware_pack_begin.h"
1040 SVGA3dShaderType type
;
1041 /* Followed by variable number of DWORDs for shader bycode */
1043 #include "vmware_pack_end.h"
1044 SVGA3dCmdDefineShader
; /* SVGA_3D_CMD_SHADER_DEFINE */
1047 #include "vmware_pack_begin.h"
1051 SVGA3dShaderType type
;
1053 #include "vmware_pack_end.h"
1054 SVGA3dCmdDestroyShader
; /* SVGA_3D_CMD_SHADER_DESTROY */
1057 #include "vmware_pack_begin.h"
1060 uint32 reg
; /* register number */
1061 SVGA3dShaderType type
;
1062 SVGA3dShaderConstType ctype
;
1066 * Followed by a variable number of additional values.
1069 #include "vmware_pack_end.h"
1070 SVGA3dCmdSetShaderConst
; /* SVGA_3D_CMD_SET_SHADER_CONST */
1073 #include "vmware_pack_begin.h"
1076 SVGA3dShaderType type
;
1079 #include "vmware_pack_end.h"
1080 SVGA3dCmdSetShader
; /* SVGA_3D_CMD_SET_SHADER */
1083 #include "vmware_pack_begin.h"
1086 SVGA3dQueryType type
;
1088 #include "vmware_pack_end.h"
1089 SVGA3dCmdBeginQuery
; /* SVGA_3D_CMD_BEGIN_QUERY */
1092 #include "vmware_pack_begin.h"
1095 SVGA3dQueryType type
;
1096 SVGAGuestPtr guestResult
; /* Points to an SVGA3dQueryResult structure */
1098 #include "vmware_pack_end.h"
1099 SVGA3dCmdEndQuery
; /* SVGA_3D_CMD_END_QUERY */
1103 * SVGA3D_CMD_WAIT_FOR_QUERY --
1105 * Will read the SVGA3dQueryResult structure pointed to by guestResult,
1106 * and if the state member is set to anything else than
1107 * SVGA3D_QUERYSTATE_PENDING, this command will always be a no-op.
1109 * Otherwise, in addition to the query explicitly waited for,
1110 * All queries with the same type and issued with the same cid, for which
1111 * an SVGA_3D_CMD_END_QUERY command has previously been sent, will
1112 * be finished after execution of this command.
1114 * A query will be identified by the gmrId and offset of the guestResult
1115 * member. If the device can't find an SVGA_3D_CMD_END_QUERY that has
1116 * been sent previously with an indentical gmrId and offset, it will
1117 * effectively end all queries with an identical type issued with the
1118 * same cid, and the SVGA3dQueryResult structure pointed to by
1119 * guestResult will not be written to. This property can be used to
1120 * implement a query barrier for a given cid and query type.
1124 #include "vmware_pack_begin.h"
1126 uint32 cid
; /* Same parameters passed to END_QUERY */
1127 SVGA3dQueryType type
;
1128 SVGAGuestPtr guestResult
;
1130 #include "vmware_pack_end.h"
1131 SVGA3dCmdWaitForQuery
; /* SVGA_3D_CMD_WAIT_FOR_QUERY */
1134 #include "vmware_pack_begin.h"
1136 uint32 totalSize
; /* Set by guest before query is ended. */
1137 SVGA3dQueryState state
; /* Set by host or guest. See SVGA3dQueryState. */
1138 union { /* Set by host on exit from PENDING state */
1140 uint32 queryCookie
; /* May be used to identify which QueryGetData this
1141 result corresponds to. */
1144 #include "vmware_pack_end.h"
1149 * SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN --
1151 * This is a blit from an SVGA3D surface to a Screen Object.
1152 * This blit must be directed at a specific screen.
1154 * The blit copies from a rectangular region of an SVGA3D surface
1155 * image to a rectangular region of a screen.
1157 * This command takes an optional variable-length list of clipping
1158 * rectangles after the body of the command. If no rectangles are
1159 * specified, there is no clipping region. The entire destRect is
1160 * drawn to. If one or more rectangles are included, they describe
1161 * a clipping region. The clip rectangle coordinates are measured
1162 * relative to the top-left corner of destRect.
1164 * The srcImage must be from mip=0 face=0.
1166 * This supports scaling if the src and dest are of different sizes.
1169 * SVGA_FIFO_CAP_SCREEN_OBJECT
1173 #include "vmware_pack_begin.h"
1175 SVGA3dSurfaceImageId srcImage
;
1176 SVGASignedRect srcRect
;
1177 uint32 destScreenId
; /* Screen Object ID */
1178 SVGASignedRect destRect
;
1179 /* Clipping: zero or more SVGASignedRects follow */
1181 #include "vmware_pack_end.h"
1182 SVGA3dCmdBlitSurfaceToScreen
; /* SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN */
1185 #include "vmware_pack_begin.h"
1188 SVGA3dTextureFilter filter
;
1190 #include "vmware_pack_end.h"
1191 SVGA3dCmdGenerateMipmaps
; /* SVGA_3D_CMD_GENERATE_MIPMAPS */
1194 #include "vmware_pack_begin.h"
1198 #include "vmware_pack_end.h"
1199 SVGA3dCmdActivateSurface
; /* SVGA_3D_CMD_ACTIVATE_SURFACE */
1202 #include "vmware_pack_begin.h"
1206 #include "vmware_pack_end.h"
1207 SVGA3dCmdDeactivateSurface
; /* SVGA_3D_CMD_DEACTIVATE_SURFACE */
1210 * Screen DMA command
1212 * Available with SVGA_FIFO_CAP_SCREEN_OBJECT_2. The SVGA_CAP_3D device
1213 * cap bit is not required.
1215 * - refBuffer and destBuffer are 32bit BGRX; refBuffer and destBuffer could
1216 * be different, but it is required that guest makes sure refBuffer has
1217 * exactly the same contents that were written to when last time screen DMA
1218 * command is received by host.
1220 * - changemap is generated by lib/blit, and it has the changes from last
1221 * received screen DMA or more.
1225 #include "vmware_pack_begin.h"
1226 struct SVGA3dCmdScreenDMA
{
1228 SVGAGuestImage refBuffer
;
1229 SVGAGuestImage destBuffer
;
1230 SVGAGuestImage changeMap
;
1232 #include "vmware_pack_end.h"
1233 SVGA3dCmdScreenDMA
; /* SVGA_3D_CMD_SCREEN_DMA */
1239 #define SVGA3D_LOTRANSBLT_HONORALPHA (0x01)
1240 #define SVGA3D_LOSTRETCHBLT_MIRRORX (0x01)
1241 #define SVGA3D_LOSTRETCHBLT_MIRRORY (0x02)
1242 #define SVGA3D_LOALPHABLEND_SRCHASALPHA (0x01)
1245 #include "vmware_pack_begin.h"
1246 struct SVGA3dCmdLogicOpsBitBlt
{
1248 * All LogicOps surfaces are one-level
1249 * surfaces so mipmap & face should always
1252 SVGA3dSurfaceImageId src
;
1253 SVGA3dSurfaceImageId dst
;
1254 SVGA3dLogicOp logicOp
;
1255 /* Followed by variable number of SVGA3dCopyBox structures */
1257 #include "vmware_pack_end.h"
1258 SVGA3dCmdLogicOpsBitBlt
; /* SVGA_3D_CMD_LOGICOPS_BITBLT */
1262 #include "vmware_pack_begin.h"
1263 struct SVGA3dCmdLogicOpsTransBlt
{
1265 * All LogicOps surfaces are one-level
1266 * surfaces so mipmap & face should always
1269 SVGA3dSurfaceImageId src
;
1270 SVGA3dSurfaceImageId dst
;
1276 #include "vmware_pack_end.h"
1277 SVGA3dCmdLogicOpsTransBlt
; /* SVGA_3D_CMD_LOGICOPS_TRANSBLT */
1281 #include "vmware_pack_begin.h"
1282 struct SVGA3dCmdLogicOpsStretchBlt
{
1284 * All LogicOps surfaces are one-level
1285 * surfaces so mipmap & face should always
1288 SVGA3dSurfaceImageId src
;
1289 SVGA3dSurfaceImageId dst
;
1295 #include "vmware_pack_end.h"
1296 SVGA3dCmdLogicOpsStretchBlt
; /* SVGA_3D_CMD_LOGICOPS_STRETCHBLT */
1300 #include "vmware_pack_begin.h"
1301 struct SVGA3dCmdLogicOpsColorFill
{
1303 * All LogicOps surfaces are one-level
1304 * surfaces so mipmap & face should always
1307 SVGA3dSurfaceImageId dst
;
1309 SVGA3dLogicOp logicOp
;
1310 /* Followed by variable number of SVGA3dRect structures. */
1312 #include "vmware_pack_end.h"
1313 SVGA3dCmdLogicOpsColorFill
; /* SVGA_3D_CMD_LOGICOPS_COLORFILL */
1317 #include "vmware_pack_begin.h"
1318 struct SVGA3dCmdLogicOpsAlphaBlend
{
1320 * All LogicOps surfaces are one-level
1321 * surfaces so mipmap & face should always
1324 SVGA3dSurfaceImageId src
;
1325 SVGA3dSurfaceImageId dst
;
1331 #include "vmware_pack_end.h"
1332 SVGA3dCmdLogicOpsAlphaBlend
; /* SVGA_3D_CMD_LOGICOPS_ALPHABLEND */
1334 #define SVGA3D_CLEARTYPE_INVALID_GAMMA_INDEX 0xFFFFFFFF
1336 #define SVGA3D_CLEARTYPE_GAMMA_WIDTH 512
1337 #define SVGA3D_CLEARTYPE_GAMMA_HEIGHT 16
1340 #include "vmware_pack_begin.h"
1341 struct SVGA3dCmdLogicOpsClearTypeBlend
{
1343 * All LogicOps surfaces are one-level
1344 * surfaces so mipmap & face should always
1347 SVGA3dSurfaceImageId tmp
;
1348 SVGA3dSurfaceImageId dst
;
1349 SVGA3dSurfaceImageId gammaSurf
;
1350 SVGA3dSurfaceImageId alphaSurf
;
1356 /* Followed by variable number of SVGA3dBox structures */
1358 #include "vmware_pack_end.h"
1359 SVGA3dCmdLogicOpsClearTypeBlend
; /* SVGA_3D_CMD_LOGICOPS_CLEARTYPEBLEND */
1363 * Guest-backed objects definitions.
1367 #include "vmware_pack_begin.h"
1369 SVGAMobFormat ptDepth
;
1373 #include "vmware_pack_end.h"
1377 #include "vmware_pack_begin.h"
1379 SVGA3dSurfaceFormat format
;
1380 SVGA3dSurface1Flags surface1Flags
;
1381 uint32 numMipLevels
;
1382 uint32 multisampleCount
;
1383 SVGA3dTextureFilter autogenFilter
;
1388 SVGA3dSurface2Flags surface2Flags
;
1389 uint8 multisamplePattern
;
1393 #include "vmware_pack_end.h"
1394 SVGAOTableSurfaceEntry
;
1397 #include "vmware_pack_begin.h"
1402 #include "vmware_pack_end.h"
1403 SVGAOTableContextEntry
;
1406 #include "vmware_pack_begin.h"
1408 SVGA3dShaderType type
;
1410 uint32 offsetInBytes
;
1413 #include "vmware_pack_end.h"
1414 SVGAOTableShaderEntry
;
1416 #define SVGA_STFLAG_PRIMARY (1 << 0)
1417 #define SVGA_STFLAG_RESERVED (1 << 1) /* Added with cap SVGA_CAP_HP_CMD_QUEUE */
1418 typedef uint32 SVGAScreenTargetFlags
;
1421 #include "vmware_pack_begin.h"
1423 SVGA3dSurfaceImageId image
;
1428 SVGAScreenTargetFlags flags
;
1432 #include "vmware_pack_end.h"
1433 SVGAOTableScreenTargetEntry
;
1436 #include "vmware_pack_begin.h"
1440 #include "vmware_pack_end.h"
1441 SVGA3dShaderConstFloat
;
1444 #include "vmware_pack_begin.h"
1448 #include "vmware_pack_end.h"
1449 SVGA3dShaderConstInt
;
1452 #include "vmware_pack_begin.h"
1456 #include "vmware_pack_end.h"
1457 SVGA3dShaderConstBool
;
1460 #include "vmware_pack_begin.h"
1462 uint16 streamOffset
;
1468 #include "vmware_pack_end.h"
1469 SVGAGBVertexElement
;
1472 #include "vmware_pack_begin.h"
1478 #include "vmware_pack_end.h"
1481 #include "vmware_pack_begin.h"
1483 SVGA3dRect viewport
;
1484 SVGA3dRect scissorRect
;
1485 SVGA3dZRange zRange
;
1487 SVGA3dSurfaceImageId renderTargets
[SVGA3D_RT_MAX
];
1488 SVGAGBVertexElement decl1
[4];
1490 uint32 renderStates
[SVGA3D_RS_MAX
];
1491 SVGAGBVertexElement decl2
[18];
1496 SVGA3dMaterial material
;
1499 float clipPlanes
[SVGA3D_NUM_CLIPPLANES
][4];
1500 float matrices
[SVGA3D_TRANSFORM_MAX
][16];
1502 SVGA3dBool lightEnabled
[SVGA3D_NUM_LIGHTS
];
1503 SVGA3dLightData lightData
[SVGA3D_NUM_LIGHTS
];
1506 * Shaders currently bound
1508 uint32 shaders
[SVGA3D_NUM_SHADERTYPE_PREDX
];
1509 SVGAGBVertexElement decl3
[10];
1512 uint32 occQueryActive
;
1513 uint32 occQueryValue
;
1516 * Int/Bool Shader constants
1518 SVGA3dShaderConstInt pShaderIValues
[SVGA3D_CONSTINTREG_MAX
];
1519 SVGA3dShaderConstInt vShaderIValues
[SVGA3D_CONSTINTREG_MAX
];
1520 uint16 pShaderBValues
;
1521 uint16 vShaderBValues
;
1524 SVGAGBVertexStream streams
[SVGA3D_MAX_VERTEX_ARRAYS
];
1525 SVGA3dVertexDivisor divisors
[SVGA3D_MAX_VERTEX_ARRAYS
];
1526 uint32 numVertexDecls
;
1527 uint32 numVertexStreams
;
1528 uint32 numVertexDivisors
;
1534 * SVGA3D_TS_INVALID through SVGA3D_TS_CONSTANT are in the
1535 * textureStages array.
1536 * SVGA3D_TS_COLOR_KEY is in tsColorKey.
1538 uint32 tsColorKey
[SVGA3D_NUM_TEXTURE_UNITS
];
1539 uint32 textureStages
[SVGA3D_NUM_TEXTURE_UNITS
][SVGA3D_TS_CONSTANT
+ 1];
1540 uint32 tsColorKeyEnable
[SVGA3D_NUM_TEXTURE_UNITS
];
1543 * Float Shader constants.
1545 SVGA3dShaderConstFloat pShaderFValues
[SVGA3D_CONSTREG_MAX
];
1546 SVGA3dShaderConstFloat vShaderFValues
[SVGA3D_CONSTREG_MAX
];
1548 #include "vmware_pack_end.h"
1550 #define SVGA3D_CONTEXT_DATA_SIZE (sizeof(SVGAGBContextData))
1553 * SVGA3dCmdSetOTableBase --
1555 * This command allows the guest to specify the base PPN of the
1556 * specified object table.
1560 #include "vmware_pack_begin.h"
1562 SVGAOTableType type
;
1565 uint32 validSizeInBytes
;
1566 SVGAMobFormat ptDepth
;
1568 #include "vmware_pack_end.h"
1569 SVGA3dCmdSetOTableBase
; /* SVGA_3D_CMD_SET_OTABLE_BASE */
1572 #include "vmware_pack_begin.h"
1574 SVGAOTableType type
;
1577 uint32 validSizeInBytes
;
1578 SVGAMobFormat ptDepth
;
1580 #include "vmware_pack_end.h"
1581 SVGA3dCmdSetOTableBase64
; /* SVGA_3D_CMD_SET_OTABLE_BASE64 */
1584 * Guests using SVGA_3D_CMD_GROW_OTABLE are promising that
1585 * the new OTable contains the same contents as the old one, except possibly
1586 * for some new invalid entries at the end.
1588 * (Otherwise, guests should use one of the SetOTableBase commands.)
1591 #include "vmware_pack_begin.h"
1593 SVGAOTableType type
;
1596 uint32 validSizeInBytes
;
1597 SVGAMobFormat ptDepth
;
1599 #include "vmware_pack_end.h"
1600 SVGA3dCmdGrowOTable
; /* SVGA_3D_CMD_GROW_OTABLE */
1603 #include "vmware_pack_begin.h"
1605 SVGAOTableType type
;
1607 #include "vmware_pack_end.h"
1608 SVGA3dCmdReadbackOTable
; /* SVGA_3D_CMD_READBACK_OTABLE */
1611 * Define a memory object (Mob) in the OTable.
1615 #include "vmware_pack_begin.h"
1616 struct SVGA3dCmdDefineGBMob
{
1618 SVGAMobFormat ptDepth
;
1622 #include "vmware_pack_end.h"
1623 SVGA3dCmdDefineGBMob
; /* SVGA_3D_CMD_DEFINE_GB_MOB */
1627 * Destroys an object in the OTable.
1631 #include "vmware_pack_begin.h"
1632 struct SVGA3dCmdDestroyGBMob
{
1635 #include "vmware_pack_end.h"
1636 SVGA3dCmdDestroyGBMob
; /* SVGA_3D_CMD_DESTROY_GB_MOB */
1639 * Define a memory object (Mob) in the OTable with a PPN64 base.
1643 #include "vmware_pack_begin.h"
1644 struct SVGA3dCmdDefineGBMob64
{
1646 SVGAMobFormat ptDepth
;
1650 #include "vmware_pack_end.h"
1651 SVGA3dCmdDefineGBMob64
; /* SVGA_3D_CMD_DEFINE_GB_MOB64 */
1654 * Redefine an object in the OTable with PPN64 base.
1658 #include "vmware_pack_begin.h"
1659 struct SVGA3dCmdRedefineGBMob64
{
1661 SVGAMobFormat ptDepth
;
1665 #include "vmware_pack_end.h"
1666 SVGA3dCmdRedefineGBMob64
; /* SVGA_3D_CMD_REDEFINE_GB_MOB64 */
1669 * Notification that the page tables have been modified.
1673 #include "vmware_pack_begin.h"
1674 struct SVGA3dCmdUpdateGBMobMapping
{
1677 #include "vmware_pack_end.h"
1678 SVGA3dCmdUpdateGBMobMapping
; /* SVGA_3D_CMD_UPDATE_GB_MOB_MAPPING */
1681 * Define a guest-backed surface.
1685 #include "vmware_pack_begin.h"
1686 struct SVGA3dCmdDefineGBSurface
{
1688 SVGA3dSurface1Flags surfaceFlags
;
1689 SVGA3dSurfaceFormat format
;
1690 uint32 numMipLevels
;
1691 uint32 multisampleCount
;
1692 SVGA3dTextureFilter autogenFilter
;
1695 #include "vmware_pack_end.h"
1696 SVGA3dCmdDefineGBSurface
; /* SVGA_3D_CMD_DEFINE_GB_SURFACE */
1699 * Defines a guest-backed surface, adding the arraySize field.
1702 * http://msdn.microsoft.com/en-us/library/ff541697%28v=VS.85%29.aspx
1705 #include "vmware_pack_begin.h"
1706 struct SVGA3dCmdDefineGBSurface_v2
{
1708 SVGA3dSurface1Flags surfaceFlags
;
1709 SVGA3dSurfaceFormat format
;
1710 uint32 numMipLevels
;
1711 uint32 multisampleCount
;
1712 SVGA3dTextureFilter autogenFilter
;
1717 #include "vmware_pack_end.h"
1718 SVGA3dCmdDefineGBSurface_v2
; /* SVGA_3D_CMD_DEFINE_GB_SURFACE_V2 */
1721 * Defines a guest-backed surface, adding the larger flags.
1724 #include "vmware_pack_begin.h"
1725 struct SVGA3dCmdDefineGBSurface_v3
{
1727 SVGA3dSurfaceAllFlags surfaceFlags
;
1728 SVGA3dSurfaceFormat format
;
1729 uint32 numMipLevels
;
1730 uint32 multisampleCount
;
1731 SVGA3dMSPattern multisamplePattern
;
1732 SVGA3dTextureFilter autogenFilter
;
1736 #include "vmware_pack_end.h"
1737 SVGA3dCmdDefineGBSurface_v3
; /* SVGA_3D_CMD_DEFINE_GB_SURFACE_V3 */
1740 * Destroy a guest-backed surface.
1744 #include "vmware_pack_begin.h"
1745 struct SVGA3dCmdDestroyGBSurface
{
1748 #include "vmware_pack_end.h"
1749 SVGA3dCmdDestroyGBSurface
; /* SVGA_3D_CMD_DESTROY_GB_SURFACE */
1752 * Bind a guest-backed surface to a mob.
1756 #include "vmware_pack_begin.h"
1757 struct SVGA3dCmdBindGBSurface
{
1761 #include "vmware_pack_end.h"
1762 SVGA3dCmdBindGBSurface
; /* SVGA_3D_CMD_BIND_GB_SURFACE */
1765 #include "vmware_pack_begin.h"
1766 struct SVGA3dCmdBindGBSurfaceWithPitch
{
1769 uint32 baseLevelPitch
;
1771 #include "vmware_pack_end.h"
1772 SVGA3dCmdBindGBSurfaceWithPitch
; /* SVGA_3D_CMD_BIND_GB_SURFACE_WITH_PITCH */
1775 * Conditionally bind a mob to a guest-backed surface if testMobid
1776 * matches the currently bound mob. Optionally issue a
1777 * readback/update on the surface while it is still bound to the old
1778 * mobid if the mobid is changed by this command.
1781 #define SVGA3D_COND_BIND_GB_SURFACE_FLAG_READBACK (1 << 0)
1782 #define SVGA3D_COND_BIND_GB_SURFACE_FLAG_UPDATE (1 << 1)
1785 #include "vmware_pack_begin.h"
1786 struct SVGA3dCmdCondBindGBSurface
{
1788 SVGAMobId testMobid
;
1792 #include "vmware_pack_end.h"
1793 SVGA3dCmdCondBindGBSurface
; /* SVGA_3D_CMD_COND_BIND_GB_SURFACE */
1796 * Update an image in a guest-backed surface.
1797 * (Inform the device that the guest-contents have been updated.)
1801 #include "vmware_pack_begin.h"
1802 struct SVGA3dCmdUpdateGBImage
{
1803 SVGA3dSurfaceImageId image
;
1806 #include "vmware_pack_end.h"
1807 SVGA3dCmdUpdateGBImage
; /* SVGA_3D_CMD_UPDATE_GB_IMAGE */
1810 * Update an entire guest-backed surface.
1811 * (Inform the device that the guest-contents have been updated.)
1815 #include "vmware_pack_begin.h"
1816 struct SVGA3dCmdUpdateGBSurface
{
1819 #include "vmware_pack_end.h"
1820 SVGA3dCmdUpdateGBSurface
; /* SVGA_3D_CMD_UPDATE_GB_SURFACE */
1823 * Readback an image in a guest-backed surface.
1824 * (Request the device to flush the dirty contents into the guest.)
1828 #include "vmware_pack_begin.h"
1829 struct SVGA3dCmdReadbackGBImage
{
1830 SVGA3dSurfaceImageId image
;
1832 #include "vmware_pack_end.h"
1833 SVGA3dCmdReadbackGBImage
; /* SVGA_3D_CMD_READBACK_GB_IMAGE */
1836 * Readback an entire guest-backed surface.
1837 * (Request the device to flush the dirty contents into the guest.)
1841 #include "vmware_pack_begin.h"
1842 struct SVGA3dCmdReadbackGBSurface
{
1845 #include "vmware_pack_end.h"
1846 SVGA3dCmdReadbackGBSurface
; /* SVGA_3D_CMD_READBACK_GB_SURFACE */
1849 * Readback a sub rect of an image in a guest-backed surface. After
1850 * issuing this command the driver is required to issue an update call
1851 * of the same region before issuing any other commands that reference
1852 * this surface or rendering is not guaranteed.
1856 #include "vmware_pack_begin.h"
1857 struct SVGA3dCmdReadbackGBImagePartial
{
1858 SVGA3dSurfaceImageId image
;
1862 #include "vmware_pack_end.h"
1863 SVGA3dCmdReadbackGBImagePartial
; /* SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL */
1867 * Invalidate an image in a guest-backed surface.
1868 * (Notify the device that the contents can be lost.)
1872 #include "vmware_pack_begin.h"
1873 struct SVGA3dCmdInvalidateGBImage
{
1874 SVGA3dSurfaceImageId image
;
1876 #include "vmware_pack_end.h"
1877 SVGA3dCmdInvalidateGBImage
; /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE */
1880 * Invalidate an entire guest-backed surface.
1881 * (Notify the device that the contents if all images can be lost.)
1885 #include "vmware_pack_begin.h"
1886 struct SVGA3dCmdInvalidateGBSurface
{
1889 #include "vmware_pack_end.h"
1890 SVGA3dCmdInvalidateGBSurface
; /* SVGA_3D_CMD_INVALIDATE_GB_SURFACE */
1893 * Invalidate a sub rect of an image in a guest-backed surface. After
1894 * issuing this command the driver is required to issue an update call
1895 * of the same region before issuing any other commands that reference
1896 * this surface or rendering is not guaranteed.
1900 #include "vmware_pack_begin.h"
1901 struct SVGA3dCmdInvalidateGBImagePartial
{
1902 SVGA3dSurfaceImageId image
;
1906 #include "vmware_pack_end.h"
1907 SVGA3dCmdInvalidateGBImagePartial
; /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL */
1911 * Define a guest-backed context.
1915 #include "vmware_pack_begin.h"
1916 struct SVGA3dCmdDefineGBContext
{
1919 #include "vmware_pack_end.h"
1920 SVGA3dCmdDefineGBContext
; /* SVGA_3D_CMD_DEFINE_GB_CONTEXT */
1923 * Destroy a guest-backed context.
1927 #include "vmware_pack_begin.h"
1928 struct SVGA3dCmdDestroyGBContext
{
1931 #include "vmware_pack_end.h"
1932 SVGA3dCmdDestroyGBContext
; /* SVGA_3D_CMD_DESTROY_GB_CONTEXT */
1935 * Bind a guest-backed context.
1937 * validContents should be set to 0 for new contexts,
1938 * and 1 if this is an old context which is getting paged
1939 * back on to the device.
1941 * For new contexts, it is recommended that the driver
1942 * issue commands to initialize all interesting state
1943 * prior to rendering.
1947 #include "vmware_pack_begin.h"
1948 struct SVGA3dCmdBindGBContext
{
1951 uint32 validContents
;
1953 #include "vmware_pack_end.h"
1954 SVGA3dCmdBindGBContext
; /* SVGA_3D_CMD_BIND_GB_CONTEXT */
1957 * Readback a guest-backed context.
1958 * (Request that the device flush the contents back into guest memory.)
1962 #include "vmware_pack_begin.h"
1963 struct SVGA3dCmdReadbackGBContext
{
1966 #include "vmware_pack_end.h"
1967 SVGA3dCmdReadbackGBContext
; /* SVGA_3D_CMD_READBACK_GB_CONTEXT */
1970 * Invalidate a guest-backed context.
1973 #include "vmware_pack_begin.h"
1974 struct SVGA3dCmdInvalidateGBContext
{
1977 #include "vmware_pack_end.h"
1978 SVGA3dCmdInvalidateGBContext
; /* SVGA_3D_CMD_INVALIDATE_GB_CONTEXT */
1981 * Define a guest-backed shader.
1985 #include "vmware_pack_begin.h"
1986 struct SVGA3dCmdDefineGBShader
{
1988 SVGA3dShaderType type
;
1991 #include "vmware_pack_end.h"
1992 SVGA3dCmdDefineGBShader
; /* SVGA_3D_CMD_DEFINE_GB_SHADER */
1995 * Bind a guest-backed shader.
1999 #include "vmware_pack_begin.h"
2000 struct SVGA3dCmdBindGBShader
{
2003 uint32 offsetInBytes
;
2005 #include "vmware_pack_end.h"
2006 SVGA3dCmdBindGBShader
; /* SVGA_3D_CMD_BIND_GB_SHADER */
2009 * Destroy a guest-backed shader.
2013 #include "vmware_pack_begin.h"
2014 struct SVGA3dCmdDestroyGBShader
{
2017 #include "vmware_pack_end.h"
2018 SVGA3dCmdDestroyGBShader
; /* SVGA_3D_CMD_DESTROY_GB_SHADER */
2021 #include "vmware_pack_begin.h"
2025 SVGA3dShaderType shaderType
;
2026 SVGA3dShaderConstType constType
;
2029 * Followed by a variable number of shader constants.
2031 * Note that FLOAT and INT constants are 4-dwords in length, while
2032 * BOOL constants are 1-dword in length.
2035 #include "vmware_pack_end.h"
2036 SVGA3dCmdSetGBShaderConstInline
; /* SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE */
2040 #include "vmware_pack_begin.h"
2043 SVGA3dQueryType type
;
2045 #include "vmware_pack_end.h"
2046 SVGA3dCmdBeginGBQuery
; /* SVGA_3D_CMD_BEGIN_GB_QUERY */
2049 #include "vmware_pack_begin.h"
2052 SVGA3dQueryType type
;
2056 #include "vmware_pack_end.h"
2057 SVGA3dCmdEndGBQuery
; /* SVGA_3D_CMD_END_GB_QUERY */
2061 * SVGA_3D_CMD_WAIT_FOR_GB_QUERY --
2063 * The semantics of this command are identical to the
2064 * SVGA_3D_CMD_WAIT_FOR_QUERY except that the results are written
2065 * to a Mob instead of a GMR.
2069 #include "vmware_pack_begin.h"
2072 SVGA3dQueryType type
;
2076 #include "vmware_pack_end.h"
2077 SVGA3dCmdWaitForGBQuery
; /* SVGA_3D_CMD_WAIT_FOR_GB_QUERY */
2081 #include "vmware_pack_begin.h"
2087 #include "vmware_pack_end.h"
2088 SVGA3dCmdEnableGart
; /* SVGA_3D_CMD_ENABLE_GART */
2091 #include "vmware_pack_begin.h"
2096 #include "vmware_pack_end.h"
2097 SVGA3dCmdMapMobIntoGart
; /* SVGA_3D_CMD_MAP_MOB_INTO_GART */
2101 #include "vmware_pack_begin.h"
2106 #include "vmware_pack_end.h"
2107 SVGA3dCmdUnmapGartRange
; /* SVGA_3D_CMD_UNMAP_GART_RANGE */
2115 #include "vmware_pack_begin.h"
2122 SVGAScreenTargetFlags flags
;
2125 * The physical DPI that the guest expects this screen displayed at.
2127 * Guests which are not DPI-aware should set this to zero.
2131 #include "vmware_pack_end.h"
2132 SVGA3dCmdDefineGBScreenTarget
; /* SVGA_3D_CMD_DEFINE_GB_SCREENTARGET */
2135 #include "vmware_pack_begin.h"
2139 #include "vmware_pack_end.h"
2140 SVGA3dCmdDestroyGBScreenTarget
; /* SVGA_3D_CMD_DESTROY_GB_SCREENTARGET */
2143 #include "vmware_pack_begin.h"
2146 SVGA3dSurfaceImageId image
;
2148 #include "vmware_pack_end.h"
2149 SVGA3dCmdBindGBScreenTarget
; /* SVGA_3D_CMD_BIND_GB_SCREENTARGET */
2152 #include "vmware_pack_begin.h"
2157 #include "vmware_pack_end.h"
2158 SVGA3dCmdUpdateGBScreenTarget
; /* SVGA_3D_CMD_UPDATE_GB_SCREENTARGET */
2161 #include "vmware_pack_begin.h"
2162 struct SVGA3dCmdGBScreenDMA
{
2165 SVGAMobId destMobID
;
2167 SVGAMobId changeMapMobID
;
2169 #include "vmware_pack_end.h"
2170 SVGA3dCmdGBScreenDMA
; /* SVGA_3D_CMD_GB_SCREEN_DMA */
2173 #include "vmware_pack_begin.h"
2179 #include "vmware_pack_end.h"
2180 SVGA3dCmdGBMobFence
; /* SVGA_3D_CMD_GB_MOB_FENCE */
2183 #include "vmware_pack_begin.h"
2186 SVGA3dSurfaceImageId dest
;
2189 uint32 statusMobOffset
;
2191 /* Reserved fields */
2192 uint32 mustBeInvalidId
;
2195 #include "vmware_pack_end.h"
2196 SVGA3dCmdScreenCopy
; /* SVGA_3D_CMD_SCREEN_COPY */
2198 #define SVGA_SCREEN_COPY_STATUS_FAILURE 0x00
2199 #define SVGA_SCREEN_COPY_STATUS_SUCCESS 0x01
2200 #define SVGA_SCREEN_COPY_STATUS_INVALID 0xFFFFFFFF
2202 #endif // _SVGA3D_CMD_H_