drivers/gpu/drm/vmwgfx/device_include/svga3d

/* [<][>][^][v][top][bottom][index][help] */
   1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */
   2 /**********************************************************
   3  * Copyright 1998-2015 VMware, Inc.
   4  *
   5  * Permission is hereby granted, free of charge, to any person
   6  * obtaining a copy of this software and associated documentation
   7  * files (the "Software"), to deal in the Software without
   8  * restriction, including without limitation the rights to use, copy,
   9  * modify, merge, publish, distribute, sublicense, and/or sell copies
  10  * of the Software, and to permit persons to whom the Software is
  11  * furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be
  14  * included in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  17  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  19  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  20  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  21  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23  * SOFTWARE.
  24  *
  25  **********************************************************/
  26 
  27 /*
  28  * svga3d_cmd.h --
  29  *
  30  *       SVGA 3d hardware cmd definitions
  31  */
  32 
  33 #ifndef _SVGA3D_CMD_H_
  34 #define _SVGA3D_CMD_H_
  35 
  36 #define INCLUDE_ALLOW_MODULE
  37 #define INCLUDE_ALLOW_USERLEVEL
  38 #define INCLUDE_ALLOW_VMCORE
  39 
  40 #include "includeCheck.h"
  41 #include "svga3d_types.h"
  42 
  43 /*
  44  * Identifiers for commands in the command FIFO.
  45  *
  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
  48  * future.
  49  *
  50  * IDs between 1040 and 2999 (inclusive) are available for use by the
  51  * current SVGA3D protocol.
  52  *
  53  * FIFO clients other than SVGA3D should stay below 1000, or at 3000
  54  * and up.
  55  */
  56 
  57 typedef enum {
  58    SVGA_3D_CMD_LEGACY_BASE                                = 1000,
  59    SVGA_3D_CMD_BASE                                       = 1040,
  60 
  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,
 106 
 107    SVGA_3D_CMD_LOGICOPS_BITBLT                            = 1085,
 108    SVGA_3D_CMD_LOGICOPS_TRANSBLT                          = 1086,
 109    SVGA_3D_CMD_LOGICOPS_STRETCHBLT                        = 1087,
 110    SVGA_3D_CMD_LOGICOPS_COLORFILL                         = 1088,
 111    SVGA_3D_CMD_LOGICOPS_ALPHABLEND                        = 1089,
 112    SVGA_3D_CMD_LOGICOPS_CLEARTYPEBLEND                    = 1090,
 113 
 114    SVGA_3D_CMD_SET_OTABLE_BASE                            = 1091,
 115    SVGA_3D_CMD_READBACK_OTABLE                            = 1092,
 116 
 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,
 121 
 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,
 132 
 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,
 138 
 139    SVGA_3D_CMD_DEFINE_GB_SHADER                           = 1112,
 140    SVGA_3D_CMD_DESTROY_GB_SHADER                          = 1113,
 141    SVGA_3D_CMD_BIND_GB_SHADER                             = 1114,
 142 
 143    SVGA_3D_CMD_SET_OTABLE_BASE64                          = 1115,
 144 
 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,
 148 
 149    SVGA_3D_CMD_NOP                                        = 1119,
 150 
 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,
 155 
 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,
 160 
 161    SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL                  = 1128,
 162    SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL                = 1129,
 163 
 164    SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE                 = 1130,
 165 
 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,
 173 
 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,
 179 
 180    /*
 181     * DX10 Commands
 182     */
 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 
 265    /*
 266     * Reserve some IDs to be used for the SM5 shader types.
 267     */
 268    SVGA_3D_CMD_DX_RESERVED1                               = 1223,
 269    SVGA_3D_CMD_DX_RESERVED2                               = 1224,
 270    SVGA_3D_CMD_DX_RESERVED3                               = 1225,
 271 
 272    SVGA_3D_CMD_DX_COND_BIND_ALL_SHADER                    = 1226,
 273    SVGA_3D_CMD_DX_MAX                                     = 1227,
 274 
 275    SVGA_3D_CMD_SCREEN_COPY                                = 1227,
 276 
 277    /*
 278     * Reserve some IDs to be used for video.
 279     */
 280    SVGA_3D_CMD_VIDEO_RESERVED1                            = 1228,
 281    SVGA_3D_CMD_VIDEO_RESERVED2                            = 1229,
 282    SVGA_3D_CMD_VIDEO_RESERVED3                            = 1230,
 283    SVGA_3D_CMD_VIDEO_RESERVED4                            = 1231,
 284    SVGA_3D_CMD_VIDEO_RESERVED5                            = 1232,
 285    SVGA_3D_CMD_VIDEO_RESERVED6                            = 1233,
 286    SVGA_3D_CMD_VIDEO_RESERVED7                            = 1234,
 287    SVGA_3D_CMD_VIDEO_RESERVED8                            = 1235,
 288 
 289    SVGA_3D_CMD_GROW_OTABLE                                = 1236,
 290    SVGA_3D_CMD_DX_GROW_COTABLE                            = 1237,
 291    SVGA_3D_CMD_INTRA_SURFACE_COPY                         = 1238,
 292 
 293    SVGA_3D_CMD_DEFINE_GB_SURFACE_V3                       = 1239,
 294 
 295    SVGA_3D_CMD_DX_RESOLVE_COPY                            = 1240,
 296    SVGA_3D_CMD_DX_PRED_RESOLVE_COPY                       = 1241,
 297    SVGA_3D_CMD_DX_PRED_CONVERT_REGION                     = 1242,
 298    SVGA_3D_CMD_DX_PRED_CONVERT                            = 1243,
 299    SVGA_3D_CMD_WHOLE_SURFACE_COPY                         = 1244,
 300 
 301    SVGA_3D_CMD_MAX                                        = 1245,
 302    SVGA_3D_CMD_FUTURE_MAX                                 = 3000
 303 } SVGAFifo3dCmdId;
 304 
 305 #define SVGA_NUM_3D_CMD (SVGA_3D_CMD_MAX - SVGA_3D_CMD_BASE)
 306 
 307 /*
 308  * FIFO command format definitions:
 309  */
 310 
 311 /*
 312  * The data size header following cmdNum for every 3d command
 313  */
 314 typedef
 315 #include "vmware_pack_begin.h"
 316 struct {
 317    uint32               id;
 318    uint32               size;
 319 }
 320 #include "vmware_pack_end.h"
 321 SVGA3dCmdHeader;
 322 
 323 typedef
 324 #include "vmware_pack_begin.h"
 325 struct {
 326    uint32               numMipLevels;
 327 }
 328 #include "vmware_pack_end.h"
 329 SVGA3dSurfaceFace;
 330 
 331 typedef
 332 #include "vmware_pack_begin.h"
 333 struct {
 334    uint32                      sid;
 335    SVGA3dSurface1Flags         surfaceFlags;
 336    SVGA3dSurfaceFormat         format;
 337    /*
 338     * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
 339     * structures must have the same value of numMipLevels field.
 340     * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
 341     * numMipLevels set to 0.
 342     */
 343    SVGA3dSurfaceFace           face[SVGA3D_MAX_SURFACE_FACES];
 344    /*
 345     * Followed by an SVGA3dSize structure for each mip level in each face.
 346     *
 347     * A note on surface sizes: Sizes are always specified in pixels,
 348     * even if the true surface size is not a multiple of the minimum
 349     * block size of the surface's format. For example, a 3x3x1 DXT1
 350     * compressed texture would actually be stored as a 4x4x1 image in
 351     * memory.
 352     */
 353 }
 354 #include "vmware_pack_end.h"
 355 SVGA3dCmdDefineSurface;       /* SVGA_3D_CMD_SURFACE_DEFINE */
 356 
 357 typedef
 358 #include "vmware_pack_begin.h"
 359 struct {
 360    uint32                      sid;
 361    SVGA3dSurface1Flags         surfaceFlags;
 362    SVGA3dSurfaceFormat         format;
 363    /*
 364     * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
 365     * structures must have the same value of numMipLevels field.
 366     * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
 367     * numMipLevels set to 0.
 368     */
 369    SVGA3dSurfaceFace           face[SVGA3D_MAX_SURFACE_FACES];
 370    uint32                      multisampleCount;
 371    SVGA3dTextureFilter         autogenFilter;
 372    /*
 373     * Followed by an SVGA3dSize structure for each mip level in each face.
 374     *
 375     * A note on surface sizes: Sizes are always specified in pixels,
 376     * even if the true surface size is not a multiple of the minimum
 377     * block size of the surface's format. For example, a 3x3x1 DXT1
 378     * compressed texture would actually be stored as a 4x4x1 image in
 379     * memory.
 380     */
 381 }
 382 #include "vmware_pack_end.h"
 383 SVGA3dCmdDefineSurface_v2;     /* SVGA_3D_CMD_SURFACE_DEFINE_V2 */
 384 
 385 typedef
 386 #include "vmware_pack_begin.h"
 387 struct {
 388    uint32               sid;
 389 }
 390 #include "vmware_pack_end.h"
 391 SVGA3dCmdDestroySurface;      /* SVGA_3D_CMD_SURFACE_DESTROY */
 392 
 393 typedef
 394 #include "vmware_pack_begin.h"
 395 struct {
 396    uint32               cid;
 397 }
 398 #include "vmware_pack_end.h"
 399 SVGA3dCmdDefineContext;       /* SVGA_3D_CMD_CONTEXT_DEFINE */
 400 
 401 typedef
 402 #include "vmware_pack_begin.h"
 403 struct {
 404    uint32               cid;
 405 }
 406 #include "vmware_pack_end.h"
 407 SVGA3dCmdDestroyContext;      /* SVGA_3D_CMD_CONTEXT_DESTROY */
 408 
 409 typedef
 410 #include "vmware_pack_begin.h"
 411 struct {
 412    uint32               cid;
 413    SVGA3dClearFlag      clearFlag;
 414    uint32               color;
 415    float                depth;
 416    uint32               stencil;
 417    /* Followed by variable number of SVGA3dRect structures */
 418 }
 419 #include "vmware_pack_end.h"
 420 SVGA3dCmdClear;               /* SVGA_3D_CMD_CLEAR */
 421 
 422 typedef
 423 #include "vmware_pack_begin.h"
 424 struct {
 425    SVGA3dLightType      type;
 426    SVGA3dBool           inWorldSpace;
 427    float                diffuse[4];
 428    float                specular[4];
 429    float                ambient[4];
 430    float                position[4];
 431    float                direction[4];
 432    float                range;
 433    float                falloff;
 434    float                attenuation0;
 435    float                attenuation1;
 436    float                attenuation2;
 437    float                theta;
 438    float                phi;
 439 }
 440 #include "vmware_pack_end.h"
 441 SVGA3dLightData;
 442 
 443 typedef
 444 #include "vmware_pack_begin.h"
 445 struct {
 446    uint32               sid;
 447    /* Followed by variable number of SVGA3dCopyRect structures */
 448 }
 449 #include "vmware_pack_end.h"
 450 SVGA3dCmdPresent;             /* SVGA_3D_CMD_PRESENT */
 451 
 452 typedef
 453 #include "vmware_pack_begin.h"
 454 struct {
 455    SVGA3dRenderStateName   state;
 456    union {
 457       uint32               uintValue;
 458       float                floatValue;
 459    };
 460 }
 461 #include "vmware_pack_end.h"
 462 SVGA3dRenderState;
 463 
 464 typedef
 465 #include "vmware_pack_begin.h"
 466 struct {
 467    uint32               cid;
 468    /* Followed by variable number of SVGA3dRenderState structures */
 469 }
 470 #include "vmware_pack_end.h"
 471 SVGA3dCmdSetRenderState;      /* SVGA_3D_CMD_SETRENDERSTATE */
 472 
 473 typedef
 474 #include "vmware_pack_begin.h"
 475 struct {
 476    uint32                 cid;
 477    SVGA3dRenderTargetType type;
 478    SVGA3dSurfaceImageId   target;
 479 }
 480 #include "vmware_pack_end.h"
 481 SVGA3dCmdSetRenderTarget;     /* SVGA_3D_CMD_SETRENDERTARGET */
 482 
 483 typedef
 484 #include "vmware_pack_begin.h"
 485 struct {
 486    SVGA3dSurfaceImageId  src;
 487    SVGA3dSurfaceImageId  dest;
 488    /* Followed by variable number of SVGA3dCopyBox structures */
 489 }
 490 #include "vmware_pack_end.h"
 491 SVGA3dCmdSurfaceCopy;               /* SVGA_3D_CMD_SURFACE_COPY */
 492 
 493 /*
 494  * Perform a surface copy within the same image.
 495  * The src/dest boxes are allowed to overlap.
 496  */
 497 typedef
 498 #include "vmware_pack_begin.h"
 499 struct {
 500    SVGA3dSurfaceImageId  surface;
 501    SVGA3dCopyBox box;
 502 }
 503 #include "vmware_pack_end.h"
 504 SVGA3dCmdIntraSurfaceCopy;               /* SVGA_3D_CMD_INTRA_SURFACE_COPY */
 505 
 506 typedef
 507 #include "vmware_pack_begin.h"
 508 struct {
 509    uint32 srcSid;
 510    uint32 destSid;
 511 }
 512 #include "vmware_pack_end.h"
 513 SVGA3dCmdWholeSurfaceCopy;               /* SVGA_3D_CMD_WHOLE_SURFACE_COPY */
 514 
 515 typedef
 516 #include "vmware_pack_begin.h"
 517 struct {
 518    SVGA3dSurfaceImageId  src;
 519    SVGA3dSurfaceImageId  dest;
 520    SVGA3dBox             boxSrc;
 521    SVGA3dBox             boxDest;
 522    SVGA3dStretchBltMode  mode;
 523 }
 524 #include "vmware_pack_end.h"
 525 SVGA3dCmdSurfaceStretchBlt;         /* SVGA_3D_CMD_SURFACE_STRETCHBLT */
 526 
 527 typedef
 528 #include "vmware_pack_begin.h"
 529 struct {
 530    /*
 531     * If the discard flag is present in a surface DMA operation, the host may
 532     * discard the contents of the current mipmap level and face of the target
 533     * surface before applying the surface DMA contents.
 534     */
 535    uint32 discard : 1;
 536 
 537    /*
 538     * If the unsynchronized flag is present, the host may perform this upload
 539     * without syncing to pending reads on this surface.
 540     */
 541    uint32 unsynchronized : 1;
 542 
 543    /*
 544     * Guests *MUST* set the reserved bits to 0 before submitting the command
 545     * suffix as future flags may occupy these bits.
 546     */
 547    uint32 reserved : 30;
 548 }
 549 #include "vmware_pack_end.h"
 550 SVGA3dSurfaceDMAFlags;
 551 
 552 typedef
 553 #include "vmware_pack_begin.h"
 554 struct {
 555    SVGAGuestImage guest;
 556    SVGA3dSurfaceImageId host;
 557    SVGA3dTransferType transfer;
 558    /*
 559     * Followed by variable number of SVGA3dCopyBox structures. For consistency
 560     * in all clipping logic and coordinate translation, we define the
 561     * "source" in each copyBox as the guest image and the
 562     * "destination" as the host image, regardless of transfer
 563     * direction.
 564     *
 565     * For efficiency, the SVGA3D device is free to copy more data than
 566     * specified. For example, it may round copy boxes outwards such
 567     * that they lie on particular alignment boundaries.
 568     */
 569 }
 570 #include "vmware_pack_end.h"
 571 SVGA3dCmdSurfaceDMA;                /* SVGA_3D_CMD_SURFACE_DMA */
 572 
 573 /*
 574  * SVGA3dCmdSurfaceDMASuffix --
 575  *
 576  *    This is a command suffix that will appear after a SurfaceDMA command in
 577  *    the FIFO.  It contains some extra information that hosts may use to
 578  *    optimize performance or protect the guest.  This suffix exists to preserve
 579  *    backwards compatibility while also allowing for new functionality to be
 580  *    implemented.
 581  */
 582 
 583 typedef
 584 #include "vmware_pack_begin.h"
 585 struct {
 586    uint32 suffixSize;
 587 
 588    /*
 589     * The maximum offset is used to determine the maximum offset from the
 590     * guestPtr base address that will be accessed or written to during this
 591     * surfaceDMA.  If the suffix is supported, the host will respect this
 592     * boundary while performing surface DMAs.
 593     *
 594     * Defaults to MAX_UINT32
 595     */
 596    uint32 maximumOffset;
 597 
 598    /*
 599     * A set of flags that describes optimizations that the host may perform
 600     * while performing this surface DMA operation.  The guest should never rely
 601     * on behaviour that is different when these flags are set for correctness.
 602     *
 603     * Defaults to 0
 604     */
 605    SVGA3dSurfaceDMAFlags flags;
 606 }
 607 #include "vmware_pack_end.h"
 608 SVGA3dCmdSurfaceDMASuffix;
 609 
 610 /*
 611  * SVGA_3D_CMD_DRAW_PRIMITIVES --
 612  *
 613  *   This command is the SVGA3D device's generic drawing entry point.
 614  *   It can draw multiple ranges of primitives, optionally using an
 615  *   index buffer, using an arbitrary collection of vertex buffers.
 616  *
 617  *   Each SVGA3dVertexDecl defines a distinct vertex array to bind
 618  *   during this draw call. The declarations specify which surface
 619  *   the vertex data lives in, what that vertex data is used for,
 620  *   and how to interpret it.
 621  *
 622  *   Each SVGA3dPrimitiveRange defines a collection of primitives
 623  *   to render using the same vertex arrays. An index buffer is
 624  *   optional.
 625  */
 626 
 627 typedef
 628 #include "vmware_pack_begin.h"
 629 struct {
 630    /*
 631     * A range hint is an optional specification for the range of indices
 632     * in an SVGA3dArray that will be used. If 'last' is zero, it is assumed
 633     * that the entire array will be used.
 634     *
 635     * These are only hints. The SVGA3D device may use them for
 636     * performance optimization if possible, but it's also allowed to
 637     * ignore these values.
 638     */
 639    uint32               first;
 640    uint32               last;
 641 }
 642 #include "vmware_pack_end.h"
 643 SVGA3dArrayRangeHint;
 644 
 645 typedef
 646 #include "vmware_pack_begin.h"
 647 struct {
 648    /*
 649     * Define the origin and shape of a vertex or index array. Both
 650     * 'offset' and 'stride' are in bytes. The provided surface will be
 651     * reinterpreted as a flat array of bytes in the same format used
 652     * by surface DMA operations. To avoid unnecessary conversions, the
 653     * surface should be created with the SVGA3D_BUFFER format.
 654     *
 655     * Index 0 in the array starts 'offset' bytes into the surface.
 656     * Index 1 begins at byte 'offset + stride', etc. Array indices may
 657     * not be negative.
 658     */
 659    uint32               surfaceId;
 660    uint32               offset;
 661    uint32               stride;
 662 }
 663 #include "vmware_pack_end.h"
 664 SVGA3dArray;
 665 
 666 typedef
 667 #include "vmware_pack_begin.h"
 668 struct {
 669    /*
 670     * Describe a vertex array's data type, and define how it is to be
 671     * used by the fixed function pipeline or the vertex shader. It
 672     * isn't useful to have two VertexDecls with the same
 673     * VertexArrayIdentity in one draw call.
 674     */
 675    SVGA3dDeclType       type;
 676    SVGA3dDeclMethod     method;
 677    SVGA3dDeclUsage      usage;
 678    uint32               usageIndex;
 679 }
 680 #include "vmware_pack_end.h"
 681 SVGA3dVertexArrayIdentity;
 682 
 683 typedef
 684 #include "vmware_pack_begin.h"
 685 struct SVGA3dVertexDecl {
 686    SVGA3dVertexArrayIdentity  identity;
 687    SVGA3dArray                array;
 688    SVGA3dArrayRangeHint       rangeHint;
 689 }
 690 #include "vmware_pack_end.h"
 691 SVGA3dVertexDecl;
 692 
 693 typedef
 694 #include "vmware_pack_begin.h"
 695 struct SVGA3dPrimitiveRange {
 696    /*
 697     * Define a group of primitives to render, from sequential indices.
 698     *
 699     * The value of 'primitiveType' and 'primitiveCount' imply the
 700     * total number of vertices that will be rendered.
 701     */
 702    SVGA3dPrimitiveType  primType;
 703    uint32               primitiveCount;
 704 
 705    /*
 706     * Optional index buffer. If indexArray.surfaceId is
 707     * SVGA3D_INVALID_ID, we render without an index buffer. Rendering
 708     * without an index buffer is identical to rendering with an index
 709     * buffer containing the sequence [0, 1, 2, 3, ...].
 710     *
 711     * If an index buffer is in use, indexWidth specifies the width in
 712     * bytes of each index value. It must be less than or equal to
 713     * indexArray.stride.
 714     *
 715     * (Currently, the SVGA3D device requires index buffers to be tightly
 716     * packed. In other words, indexWidth == indexArray.stride)
 717     */
 718    SVGA3dArray          indexArray;
 719    uint32               indexWidth;
 720 
 721    /*
 722     * Optional index bias. This number is added to all indices from
 723     * indexArray before they are used as vertex array indices. This
 724     * can be used in multiple ways:
 725     *
 726     *  - When not using an indexArray, this bias can be used to
 727     *    specify where in the vertex arrays to begin rendering.
 728     *
 729     *  - A positive number here is equivalent to increasing the
 730     *    offset in each vertex array.
 731     *
 732     *  - A negative number can be used to render using a small
 733     *    vertex array and an index buffer that contains large
 734     *    values. This may be used by some applications that
 735     *    crop a vertex buffer without modifying their index
 736     *    buffer.
 737     *
 738     * Note that rendering with a negative bias value may be slower and
 739     * use more memory than rendering with a positive or zero bias.
 740     */
 741    int32                indexBias;
 742 }
 743 #include "vmware_pack_end.h"
 744 SVGA3dPrimitiveRange;
 745 
 746 typedef
 747 #include "vmware_pack_begin.h"
 748 struct {
 749    uint32               cid;
 750    uint32               numVertexDecls;
 751    uint32               numRanges;
 752 
 753    /*
 754     * There are two variable size arrays after the
 755     * SVGA3dCmdDrawPrimitives structure. In order,
 756     * they are:
 757     *
 758     * 1. SVGA3dVertexDecl, quantity 'numVertexDecls', but no more than
 759     *    SVGA3D_MAX_VERTEX_ARRAYS;
 760     * 2. SVGA3dPrimitiveRange, quantity 'numRanges', but no more than
 761     *    SVGA3D_MAX_DRAW_PRIMITIVE_RANGES;
 762     * 3. Optionally, SVGA3dVertexDivisor, quantity 'numVertexDecls' (contains
 763     *    the frequency divisor for the corresponding vertex decl).
 764     */
 765 }
 766 #include "vmware_pack_end.h"
 767 SVGA3dCmdDrawPrimitives;      /* SVGA_3D_CMD_DRAWPRIMITIVES */
 768 
 769 typedef
 770 #include "vmware_pack_begin.h"
 771 struct {
 772    uint32 cid;
 773 
 774    uint32 primitiveCount;        /* How many primitives to render */
 775    uint32 startVertexLocation;   /* Which vertex do we start rendering at. */
 776 
 777    uint8 primitiveType;          /* SVGA3dPrimitiveType */
 778    uint8 padding[3];
 779 }
 780 #include "vmware_pack_end.h"
 781 SVGA3dCmdDraw;
 782 
 783 typedef
 784 #include "vmware_pack_begin.h"
 785 struct {
 786    uint32 cid;
 787 
 788    uint8 primitiveType;       /* SVGA3dPrimitiveType */
 789 
 790    uint32 indexBufferSid;     /* Valid index buffer sid. */
 791    uint32 indexBufferOffset;  /* Byte offset into the vertex buffer, almost */
 792                               /* always 0 for DX9 guests, non-zero for OpenGL */
 793                               /* guests.  We can't represent non-multiple of */
 794                               /* stride offsets in D3D9Renderer... */
 795    uint8 indexBufferStride;   /* Allowable values = 1, 2, or 4 */
 796 
 797    int32 baseVertexLocation;  /* Bias applied to the index when selecting a */
 798                               /* vertex from the streams, may be negative */
 799 
 800    uint32 primitiveCount;     /* How many primitives to render */
 801    uint32 pad0;
 802    uint16 pad1;
 803 }
 804 #include "vmware_pack_end.h"
 805 SVGA3dCmdDrawIndexed;
 806 
 807 typedef
 808 #include "vmware_pack_begin.h"
 809 struct {
 810    /*
 811     * Describe a vertex array's data type, and define how it is to be
 812     * used by the fixed function pipeline or the vertex shader. It
 813     * isn't useful to have two VertexDecls with the same
 814     * VertexArrayIdentity in one draw call.
 815     */
 816    uint16 streamOffset;
 817    uint8 stream;
 818    uint8 type;          /* SVGA3dDeclType */
 819    uint8 method;        /* SVGA3dDeclMethod */
 820    uint8 usage;         /* SVGA3dDeclUsage */
 821    uint8 usageIndex;
 822    uint8 padding;
 823 
 824 }
 825 #include "vmware_pack_end.h"
 826 SVGA3dVertexElement;
 827 
 828 /*
 829  * Should the vertex element respect the stream value?  The high bit of the
 830  * stream should be set to indicate that the stream should be respected.  If
 831  * the high bit is not set, the stream will be ignored and replaced by the index
 832  * of the position of the currently considered vertex element.
 833  *
 834  * All guests should set this bit and correctly specify the stream going
 835  * forward.
 836  */
 837 #define SVGA3D_VERTEX_ELEMENT_RESPECT_STREAM (1 << 7)
 838 
 839 typedef
 840 #include "vmware_pack_begin.h"
 841 struct {
 842    uint32 cid;
 843 
 844    uint32 numElements;
 845 
 846    /*
 847     * Followed by numElements SVGA3dVertexElement structures.
 848     *
 849     * If numElements < SVGA3D_MAX_VERTEX_ARRAYS, the remaining elements
 850     * are cleared and will not be used by following draws.
 851     */
 852 }
 853 #include "vmware_pack_end.h"
 854 SVGA3dCmdSetVertexDecls;
 855 
 856 typedef
 857 #include "vmware_pack_begin.h"
 858 struct {
 859    uint32 sid;
 860    uint32 stride;
 861    uint32 offset;
 862 }
 863 #include "vmware_pack_end.h"
 864 SVGA3dVertexStream;
 865 
 866 typedef
 867 #include "vmware_pack_begin.h"
 868 struct {
 869    uint32 cid;
 870 
 871    uint32 numStreams;
 872    /*
 873     * Followed by numStream SVGA3dVertexStream structures.
 874     *
 875     * If numStreams < SVGA3D_MAX_VERTEX_ARRAYS, the remaining streams
 876     * are cleared and will not be used by following draws.
 877     */
 878 }
 879 #include "vmware_pack_end.h"
 880 SVGA3dCmdSetVertexStreams;
 881 
 882 typedef
 883 #include "vmware_pack_begin.h"
 884 struct {
 885    uint32 cid;
 886    uint32 numDivisors;
 887 }
 888 #include "vmware_pack_end.h"
 889 SVGA3dCmdSetVertexDivisors;
 890 
 891 typedef
 892 #include "vmware_pack_begin.h"
 893 struct {
 894    uint32                   stage;
 895    SVGA3dTextureStateName   name;
 896    union {
 897       uint32                value;
 898       float                 floatValue;
 899    };
 900 }
 901 #include "vmware_pack_end.h"
 902 SVGA3dTextureState;
 903 
 904 typedef
 905 #include "vmware_pack_begin.h"
 906 struct {
 907    uint32               cid;
 908    /* Followed by variable number of SVGA3dTextureState structures */
 909 }
 910 #include "vmware_pack_end.h"
 911 SVGA3dCmdSetTextureState;      /* SVGA_3D_CMD_SETTEXTURESTATE */
 912 
 913 typedef
 914 #include "vmware_pack_begin.h"
 915 struct {
 916    uint32                   cid;
 917    SVGA3dTransformType      type;
 918    float                    matrix[16];
 919 }
 920 #include "vmware_pack_end.h"
 921 SVGA3dCmdSetTransform;          /* SVGA_3D_CMD_SETTRANSFORM */
 922 
 923 typedef
 924 #include "vmware_pack_begin.h"
 925 struct {
 926    float                min;
 927    float                max;
 928 }
 929 #include "vmware_pack_end.h"
 930 SVGA3dZRange;
 931 
 932 typedef
 933 #include "vmware_pack_begin.h"
 934 struct {
 935    uint32               cid;
 936    SVGA3dZRange         zRange;
 937 }
 938 #include "vmware_pack_end.h"
 939 SVGA3dCmdSetZRange;             /* SVGA_3D_CMD_SETZRANGE */
 940 
 941 typedef
 942 #include "vmware_pack_begin.h"
 943 struct {
 944    float                diffuse[4];
 945    float                ambient[4];
 946    float                specular[4];
 947    float                emissive[4];
 948    float                shininess;
 949 }
 950 #include "vmware_pack_end.h"
 951 SVGA3dMaterial;
 952 
 953 typedef
 954 #include "vmware_pack_begin.h"
 955 struct {
 956    uint32               cid;
 957    SVGA3dFace           face;
 958    SVGA3dMaterial       material;
 959 }
 960 #include "vmware_pack_end.h"
 961 SVGA3dCmdSetMaterial;           /* SVGA_3D_CMD_SETMATERIAL */
 962 
 963 typedef
 964 #include "vmware_pack_begin.h"
 965 struct {
 966    uint32               cid;
 967    uint32               index;
 968    SVGA3dLightData      data;
 969 }
 970 #include "vmware_pack_end.h"
 971 SVGA3dCmdSetLightData;           /* SVGA_3D_CMD_SETLIGHTDATA */
 972 
 973 typedef
 974 #include "vmware_pack_begin.h"
 975 struct {
 976    uint32               cid;
 977    uint32               index;
 978    uint32               enabled;
 979 }
 980 #include "vmware_pack_end.h"
 981 SVGA3dCmdSetLightEnabled;      /* SVGA_3D_CMD_SETLIGHTENABLED */
 982 
 983 typedef
 984 #include "vmware_pack_begin.h"
 985 struct {
 986    uint32               cid;
 987    SVGA3dRect           rect;
 988 }
 989 #include "vmware_pack_end.h"
 990 SVGA3dCmdSetViewport;           /* SVGA_3D_CMD_SETVIEWPORT */
 991 
 992 typedef
 993 #include "vmware_pack_begin.h"
 994 struct {
 995    uint32               cid;
 996    SVGA3dRect           rect;
 997 }
 998 #include "vmware_pack_end.h"
 999 SVGA3dCmdSetScissorRect;         /* SVGA_3D_CMD_SETSCISSORRECT */
1000 
1001 typedef
1002 #include "vmware_pack_begin.h"
1003 struct {
1004    uint32               cid;
1005    uint32               index;
1006    float                plane[4];
1007 }
1008 #include "vmware_pack_end.h"
1009 SVGA3dCmdSetClipPlane;           /* SVGA_3D_CMD_SETCLIPPLANE */
1010 
1011 typedef
1012 #include "vmware_pack_begin.h"
1013 struct {
1014    uint32               cid;
1015    uint32               shid;
1016    SVGA3dShaderType     type;
1017    /* Followed by variable number of DWORDs for shader bycode */
1018 }
1019 #include "vmware_pack_end.h"
1020 SVGA3dCmdDefineShader;           /* SVGA_3D_CMD_SHADER_DEFINE */
1021 
1022 typedef
1023 #include "vmware_pack_begin.h"
1024 struct {
1025    uint32               cid;
1026    uint32               shid;
1027    SVGA3dShaderType     type;
1028 }
1029 #include "vmware_pack_end.h"
1030 SVGA3dCmdDestroyShader;         /* SVGA_3D_CMD_SHADER_DESTROY */
1031 
1032 typedef
1033 #include "vmware_pack_begin.h"
1034 struct {
1035    uint32                  cid;
1036    uint32                  reg;     /* register number */
1037    SVGA3dShaderType        type;
1038    SVGA3dShaderConstType   ctype;
1039    uint32                  values[4];
1040 
1041    /*
1042     * Followed by a variable number of additional values.
1043     */
1044 }
1045 #include "vmware_pack_end.h"
1046 SVGA3dCmdSetShaderConst;        /* SVGA_3D_CMD_SET_SHADER_CONST */
1047 
1048 typedef
1049 #include "vmware_pack_begin.h"
1050 struct {
1051    uint32               cid;
1052    SVGA3dShaderType     type;
1053    uint32               shid;
1054 }
1055 #include "vmware_pack_end.h"
1056 SVGA3dCmdSetShader;       /* SVGA_3D_CMD_SET_SHADER */
1057 
1058 typedef
1059 #include "vmware_pack_begin.h"
1060 struct {
1061    uint32               cid;
1062    SVGA3dQueryType      type;
1063 }
1064 #include "vmware_pack_end.h"
1065 SVGA3dCmdBeginQuery;           /* SVGA_3D_CMD_BEGIN_QUERY */
1066 
1067 typedef
1068 #include "vmware_pack_begin.h"
1069 struct {
1070    uint32               cid;
1071    SVGA3dQueryType      type;
1072    SVGAGuestPtr         guestResult;   /* Points to an SVGA3dQueryResult structure */
1073 }
1074 #include "vmware_pack_end.h"
1075 SVGA3dCmdEndQuery;                  /* SVGA_3D_CMD_END_QUERY */
1076 
1077 
1078 /*
1079  * SVGA3D_CMD_WAIT_FOR_QUERY --
1080  *
1081  *    Will read the SVGA3dQueryResult structure pointed to by guestResult,
1082  *    and if the state member is set to anything else than
1083  *    SVGA3D_QUERYSTATE_PENDING, this command will always be a no-op.
1084  *
1085  *    Otherwise, in addition to the query explicitly waited for,
1086  *    All queries with the same type and issued with the same cid, for which
1087  *    an SVGA_3D_CMD_END_QUERY command has previously been sent, will
1088  *    be finished after execution of this command.
1089  *
1090  *    A query will be identified by the gmrId and offset of the guestResult
1091  *    member. If the device can't find an SVGA_3D_CMD_END_QUERY that has
1092  *    been sent previously with an indentical gmrId and offset, it will
1093  *    effectively end all queries with an identical type issued with the
1094  *    same cid, and the SVGA3dQueryResult structure pointed to by
1095  *    guestResult will not be written to. This property can be used to
1096  *    implement a query barrier for a given cid and query type.
1097  */
1098 
1099 typedef
1100 #include "vmware_pack_begin.h"
1101 struct {
1102    uint32               cid;        /* Same parameters passed to END_QUERY */
1103    SVGA3dQueryType      type;
1104    SVGAGuestPtr         guestResult;
1105 }
1106 #include "vmware_pack_end.h"
1107 SVGA3dCmdWaitForQuery;              /* SVGA_3D_CMD_WAIT_FOR_QUERY */
1108 
1109 typedef
1110 #include "vmware_pack_begin.h"
1111 struct {
1112    uint32               totalSize;    /* Set by guest before query is ended. */
1113    SVGA3dQueryState     state;        /* Set by host or guest. See SVGA3dQueryState. */
1114    union {                            /* Set by host on exit from PENDING state */
1115       uint32            result32;
1116       uint32            queryCookie; /* May be used to identify which QueryGetData this
1117                                         result corresponds to. */
1118    };
1119 }
1120 #include "vmware_pack_end.h"
1121 SVGA3dQueryResult;
1122 
1123 
1124 /*
1125  * SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN --
1126  *
1127  *    This is a blit from an SVGA3D surface to a Screen Object.
1128  *    This blit must be directed at a specific screen.
1129  *
1130  *    The blit copies from a rectangular region of an SVGA3D surface
1131  *    image to a rectangular region of a screen.
1132  *
1133  *    This command takes an optional variable-length list of clipping
1134  *    rectangles after the body of the command. If no rectangles are
1135  *    specified, there is no clipping region. The entire destRect is
1136  *    drawn to. If one or more rectangles are included, they describe
1137  *    a clipping region. The clip rectangle coordinates are measured
1138  *    relative to the top-left corner of destRect.
1139  *
1140  *    The srcImage must be from mip=0 face=0.
1141  *
1142  *    This supports scaling if the src and dest are of different sizes.
1143  *
1144  * Availability:
1145  *    SVGA_FIFO_CAP_SCREEN_OBJECT
1146  */
1147 
1148 typedef
1149 #include "vmware_pack_begin.h"
1150 struct {
1151    SVGA3dSurfaceImageId srcImage;
1152    SVGASignedRect       srcRect;
1153    uint32               destScreenId; /* Screen Object ID */
1154    SVGASignedRect       destRect;
1155    /* Clipping: zero or more SVGASignedRects follow */
1156 }
1157 #include "vmware_pack_end.h"
1158 SVGA3dCmdBlitSurfaceToScreen;         /* SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN */
1159 
1160 typedef
1161 #include "vmware_pack_begin.h"
1162 struct {
1163    uint32               sid;
1164    SVGA3dTextureFilter  filter;
1165 }
1166 #include "vmware_pack_end.h"
1167 SVGA3dCmdGenerateMipmaps;             /* SVGA_3D_CMD_GENERATE_MIPMAPS */
1168 
1169 typedef
1170 #include "vmware_pack_begin.h"
1171 struct {
1172    uint32 sid;
1173 }
1174 #include "vmware_pack_end.h"
1175 SVGA3dCmdActivateSurface;               /* SVGA_3D_CMD_ACTIVATE_SURFACE */
1176 
1177 typedef
1178 #include "vmware_pack_begin.h"
1179 struct {
1180    uint32 sid;
1181 }
1182 #include "vmware_pack_end.h"
1183 SVGA3dCmdDeactivateSurface;             /* SVGA_3D_CMD_DEACTIVATE_SURFACE */
1184 
1185 /*
1186  * Screen DMA command
1187  *
1188  * Available with SVGA_FIFO_CAP_SCREEN_OBJECT_2.  The SVGA_CAP_3D device
1189  * cap bit is not required.
1190  *
1191  * - refBuffer and destBuffer are 32bit BGRX; refBuffer and destBuffer could
1192  *   be different, but it is required that guest makes sure refBuffer has
1193  *   exactly the same contents that were written to when last time screen DMA
1194  *   command is received by host.
1195  *
1196  * - changemap is generated by lib/blit, and it has the changes from last
1197  *   received screen DMA or more.
1198  */
1199 
1200 typedef
1201 #include "vmware_pack_begin.h"
1202 struct SVGA3dCmdScreenDMA {
1203    uint32 screenId;
1204    SVGAGuestImage refBuffer;
1205    SVGAGuestImage destBuffer;
1206    SVGAGuestImage changeMap;
1207 }
1208 #include "vmware_pack_end.h"
1209 SVGA3dCmdScreenDMA;        /* SVGA_3D_CMD_SCREEN_DMA */
1210 
1211 /*
1212  * Logic ops
1213  */
1214 
1215 #define SVGA3D_LOTRANSBLT_HONORALPHA     (0x01)
1216 #define SVGA3D_LOSTRETCHBLT_MIRRORX      (0x01)
1217 #define SVGA3D_LOSTRETCHBLT_MIRRORY      (0x02)
1218 #define SVGA3D_LOALPHABLEND_SRCHASALPHA  (0x01)
1219 
1220 typedef
1221 #include "vmware_pack_begin.h"
1222 struct SVGA3dCmdLogicOpsBitBlt {
1223    /*
1224     * All LogicOps surfaces are one-level
1225     * surfaces so mipmap & face should always
1226     * be zero.
1227     */
1228    SVGA3dSurfaceImageId src;
1229    SVGA3dSurfaceImageId dst;
1230    SVGA3dLogicOp logicOp;
1231    /* Followed by variable number of SVGA3dCopyBox structures */
1232 }
1233 #include "vmware_pack_end.h"
1234 SVGA3dCmdLogicOpsBitBlt;   /* SVGA_3D_CMD_LOGICOPS_BITBLT */
1235 
1236 
1237 typedef
1238 #include "vmware_pack_begin.h"
1239 struct SVGA3dCmdLogicOpsTransBlt {
1240    /*
1241     * All LogicOps surfaces are one-level
1242     * surfaces so mipmap & face should always
1243     * be zero.
1244     */
1245    SVGA3dSurfaceImageId src;
1246    SVGA3dSurfaceImageId dst;
1247    uint32 color;
1248    uint32 flags;
1249    SVGA3dBox srcBox;
1250    SVGA3dBox dstBox;
1251 }
1252 #include "vmware_pack_end.h"
1253 SVGA3dCmdLogicOpsTransBlt;   /* SVGA_3D_CMD_LOGICOPS_TRANSBLT */
1254 
1255 
1256 typedef
1257 #include "vmware_pack_begin.h"
1258 struct SVGA3dCmdLogicOpsStretchBlt {
1259    /*
1260     * All LogicOps surfaces are one-level
1261     * surfaces so mipmap & face should always
1262     * be zero.
1263     */
1264    SVGA3dSurfaceImageId src;
1265    SVGA3dSurfaceImageId dst;
1266    uint16 mode;
1267    uint16 flags;
1268    SVGA3dBox srcBox;
1269    SVGA3dBox dstBox;
1270 }
1271 #include "vmware_pack_end.h"
1272 SVGA3dCmdLogicOpsStretchBlt;   /* SVGA_3D_CMD_LOGICOPS_STRETCHBLT */
1273 
1274 
1275 typedef
1276 #include "vmware_pack_begin.h"
1277 struct SVGA3dCmdLogicOpsColorFill {
1278    /*
1279     * All LogicOps surfaces are one-level
1280     * surfaces so mipmap & face should always
1281     * be zero.
1282     */
1283    SVGA3dSurfaceImageId dst;
1284    uint32 color;
1285    SVGA3dLogicOp logicOp;
1286    /* Followed by variable number of SVGA3dRect structures. */
1287 }
1288 #include "vmware_pack_end.h"
1289 SVGA3dCmdLogicOpsColorFill;   /* SVGA_3D_CMD_LOGICOPS_COLORFILL */
1290 
1291 
1292 typedef
1293 #include "vmware_pack_begin.h"
1294 struct SVGA3dCmdLogicOpsAlphaBlend {
1295    /*
1296     * All LogicOps surfaces are one-level
1297     * surfaces so mipmap & face should always
1298     * be zero.
1299     */
1300    SVGA3dSurfaceImageId src;
1301    SVGA3dSurfaceImageId dst;
1302    uint32 alphaVal;
1303    uint32 flags;
1304    SVGA3dBox srcBox;
1305    SVGA3dBox dstBox;
1306 }
1307 #include "vmware_pack_end.h"
1308 SVGA3dCmdLogicOpsAlphaBlend;   /* SVGA_3D_CMD_LOGICOPS_ALPHABLEND */
1309 
1310 #define SVGA3D_CLEARTYPE_INVALID_GAMMA_INDEX 0xFFFFFFFF
1311 
1312 #define SVGA3D_CLEARTYPE_GAMMA_WIDTH  512
1313 #define SVGA3D_CLEARTYPE_GAMMA_HEIGHT 16
1314 
1315 typedef
1316 #include "vmware_pack_begin.h"
1317 struct SVGA3dCmdLogicOpsClearTypeBlend {
1318    /*
1319     * All LogicOps surfaces are one-level
1320     * surfaces so mipmap & face should always
1321     * be zero.
1322     */
1323    SVGA3dSurfaceImageId tmp;
1324    SVGA3dSurfaceImageId dst;
1325    SVGA3dSurfaceImageId gammaSurf;
1326    SVGA3dSurfaceImageId alphaSurf;
1327    uint32 gamma;
1328    uint32 color;
1329    uint32 color2;
1330    int32 alphaOffsetX;
1331    int32 alphaOffsetY;
1332    /* Followed by variable number of SVGA3dBox structures */
1333 }
1334 #include "vmware_pack_end.h"
1335 SVGA3dCmdLogicOpsClearTypeBlend;   /* SVGA_3D_CMD_LOGICOPS_CLEARTYPEBLEND */
1336 
1337 
1338 /*
1339  * Guest-backed objects definitions.
1340  */
1341 
1342 typedef
1343 #include "vmware_pack_begin.h"
1344 struct {
1345    SVGAMobFormat ptDepth;
1346    uint32 sizeInBytes;
1347    PPN64 base;
1348 }
1349 #include "vmware_pack_end.h"
1350 SVGAOTableMobEntry;
1351 #define SVGA3D_OTABLE_MOB_ENTRY_SIZE (sizeof(SVGAOTableMobEntry))
1352 
1353 typedef
1354 #include "vmware_pack_begin.h"
1355 struct {
1356    SVGA3dSurfaceFormat format;
1357    SVGA3dSurface1Flags surface1Flags;
1358    uint32 numMipLevels;
1359    uint32 multisampleCount;
1360    SVGA3dTextureFilter autogenFilter;
1361    SVGA3dSize size;
1362    SVGAMobId mobid;
1363    uint32 arraySize;
1364    uint32 mobPitch;
1365    SVGA3dSurface2Flags surface2Flags;
1366    uint8 multisamplePattern;
1367    uint8 qualityLevel;
1368    uint8  pad0[2];
1369    uint32 pad1[3];
1370 }
1371 #include "vmware_pack_end.h"
1372 SVGAOTableSurfaceEntry;
1373 #define SVGA3D_OTABLE_SURFACE_ENTRY_SIZE (sizeof(SVGAOTableSurfaceEntry))
1374 
1375 typedef
1376 #include "vmware_pack_begin.h"
1377 struct {
1378    uint32 cid;
1379    SVGAMobId mobid;
1380 }
1381 #include "vmware_pack_end.h"
1382 SVGAOTableContextEntry;
1383 #define SVGA3D_OTABLE_CONTEXT_ENTRY_SIZE (sizeof(SVGAOTableContextEntry))
1384 
1385 typedef
1386 #include "vmware_pack_begin.h"
1387 struct {
1388    SVGA3dShaderType type;
1389    uint32 sizeInBytes;
1390    uint32 offsetInBytes;
1391    SVGAMobId mobid;
1392 }
1393 #include "vmware_pack_end.h"
1394 SVGAOTableShaderEntry;
1395 #define SVGA3D_OTABLE_SHADER_ENTRY_SIZE (sizeof(SVGAOTableShaderEntry))
1396 
1397 #define SVGA_STFLAG_PRIMARY  (1 << 0)
1398 #define SVGA_STFLAG_RESERVED (1 << 1) /* Added with cap SVGA_CAP_HP_CMD_QUEUE */
1399 typedef uint32 SVGAScreenTargetFlags;
1400 
1401 typedef
1402 #include "vmware_pack_begin.h"
1403 struct {
1404    SVGA3dSurfaceImageId image;
1405    uint32 width;
1406    uint32 height;
1407    int32 xRoot;
1408    int32 yRoot;
1409    SVGAScreenTargetFlags flags;
1410    uint32 dpi;
1411    uint32 pad[7];
1412 }
1413 #include "vmware_pack_end.h"
1414 SVGAOTableScreenTargetEntry;
1415 #define SVGA3D_OTABLE_SCREEN_TARGET_ENTRY_SIZE \
1416         (sizeof(SVGAOTableScreenTargetEntry))
1417 
1418 typedef
1419 #include "vmware_pack_begin.h"
1420 struct {
1421    float value[4];
1422 }
1423 #include "vmware_pack_end.h"
1424 SVGA3dShaderConstFloat;
1425 
1426 typedef
1427 #include "vmware_pack_begin.h"
1428 struct {
1429    int32 value[4];
1430 }
1431 #include "vmware_pack_end.h"
1432 SVGA3dShaderConstInt;
1433 
1434 typedef
1435 #include "vmware_pack_begin.h"
1436 struct {
1437    uint32 value;
1438 }
1439 #include "vmware_pack_end.h"
1440 SVGA3dShaderConstBool;
1441 
1442 typedef
1443 #include "vmware_pack_begin.h"
1444 struct {
1445    uint16 streamOffset;
1446    uint8 stream;
1447    uint8 type;
1448    uint8 methodUsage;
1449    uint8 usageIndex;
1450 }
1451 #include "vmware_pack_end.h"
1452 SVGAGBVertexElement;
1453 
1454 typedef
1455 #include "vmware_pack_begin.h"
1456 struct {
1457    uint32 sid;
1458    uint16 stride;
1459    uint32 offset;
1460 }
1461 #include "vmware_pack_end.h"
1462 SVGAGBVertexStream;
1463 typedef
1464 #include "vmware_pack_begin.h"
1465 struct {
1466    SVGA3dRect viewport;
1467    SVGA3dRect scissorRect;
1468    SVGA3dZRange zRange;
1469 
1470    SVGA3dSurfaceImageId renderTargets[SVGA3D_RT_MAX];
1471    SVGAGBVertexElement decl1[4];
1472 
1473    uint32 renderStates[SVGA3D_RS_MAX];
1474    SVGAGBVertexElement decl2[18];
1475    uint32 pad0[2];
1476 
1477    struct {
1478       SVGA3dFace face;
1479       SVGA3dMaterial material;
1480    } material;
1481 
1482    float clipPlanes[SVGA3D_NUM_CLIPPLANES][4];
1483    float matrices[SVGA3D_TRANSFORM_MAX][16];
1484 
1485    SVGA3dBool lightEnabled[SVGA3D_NUM_LIGHTS];
1486    SVGA3dLightData lightData[SVGA3D_NUM_LIGHTS];
1487 
1488    /*
1489     * Shaders currently bound
1490     */
1491    uint32 shaders[SVGA3D_NUM_SHADERTYPE_PREDX];
1492    SVGAGBVertexElement decl3[10];
1493    uint32 pad1[3];
1494 
1495    uint32 occQueryActive;
1496    uint32 occQueryValue;
1497 
1498    /*
1499     * Int/Bool Shader constants
1500     */
1501    SVGA3dShaderConstInt pShaderIValues[SVGA3D_CONSTINTREG_MAX];
1502    SVGA3dShaderConstInt vShaderIValues[SVGA3D_CONSTINTREG_MAX];
1503    uint16 pShaderBValues;
1504    uint16 vShaderBValues;
1505 
1506 
1507    SVGAGBVertexStream streams[SVGA3D_MAX_VERTEX_ARRAYS];
1508    SVGA3dVertexDivisor divisors[SVGA3D_MAX_VERTEX_ARRAYS];
1509    uint32 numVertexDecls;
1510    uint32 numVertexStreams;
1511    uint32 numVertexDivisors;
1512    uint32 pad2[30];
1513 
1514    /*
1515     * Texture Stages
1516     *
1517     * SVGA3D_TS_INVALID through SVGA3D_TS_CONSTANT are in the
1518     * textureStages array.
1519     * SVGA3D_TS_COLOR_KEY is in tsColorKey.
1520     */
1521    uint32 tsColorKey[SVGA3D_NUM_TEXTURE_UNITS];
1522    uint32 textureStages[SVGA3D_NUM_TEXTURE_UNITS][SVGA3D_TS_CONSTANT + 1];
1523    uint32 tsColorKeyEnable[SVGA3D_NUM_TEXTURE_UNITS];
1524 
1525    /*
1526     * Float Shader constants.
1527     */
1528    SVGA3dShaderConstFloat pShaderFValues[SVGA3D_CONSTREG_MAX];
1529    SVGA3dShaderConstFloat vShaderFValues[SVGA3D_CONSTREG_MAX];
1530 }
1531 #include "vmware_pack_end.h"
1532 SVGAGBContextData;
1533 #define SVGA3D_CONTEXT_DATA_SIZE (sizeof(SVGAGBContextData))
1534 
1535 /*
1536  * SVGA3dCmdSetOTableBase --
1537  *
1538  * This command allows the guest to specify the base PPN of the
1539  * specified object table.
1540  */
1541 
1542 typedef
1543 #include "vmware_pack_begin.h"
1544 struct {
1545    SVGAOTableType type;
1546    PPN baseAddress;
1547    uint32 sizeInBytes;
1548    uint32 validSizeInBytes;
1549    SVGAMobFormat ptDepth;
1550 }
1551 #include "vmware_pack_end.h"
1552 SVGA3dCmdSetOTableBase;  /* SVGA_3D_CMD_SET_OTABLE_BASE */
1553 
1554 typedef
1555 #include "vmware_pack_begin.h"
1556 struct {
1557    SVGAOTableType type;
1558    PPN64 baseAddress;
1559    uint32 sizeInBytes;
1560    uint32 validSizeInBytes;
1561    SVGAMobFormat ptDepth;
1562 }
1563 #include "vmware_pack_end.h"
1564 SVGA3dCmdSetOTableBase64;  /* SVGA_3D_CMD_SET_OTABLE_BASE64 */
1565 
1566 /*
1567  * Guests using SVGA_3D_CMD_GROW_OTABLE are promising that
1568  * the new OTable contains the same contents as the old one, except possibly
1569  * for some new invalid entries at the end.
1570  *
1571  * (Otherwise, guests should use one of the SetOTableBase commands.)
1572  */
1573 typedef
1574 #include "vmware_pack_begin.h"
1575 struct {
1576    SVGAOTableType type;
1577    PPN64 baseAddress;
1578    uint32 sizeInBytes;
1579    uint32 validSizeInBytes;
1580    SVGAMobFormat ptDepth;
1581 }
1582 #include "vmware_pack_end.h"
1583 SVGA3dCmdGrowOTable;  /* SVGA_3D_CMD_GROW_OTABLE */
1584 
1585 typedef
1586 #include "vmware_pack_begin.h"
1587 struct {
1588    SVGAOTableType type;
1589 }
1590 #include "vmware_pack_end.h"
1591 SVGA3dCmdReadbackOTable;  /* SVGA_3D_CMD_READBACK_OTABLE */
1592 
1593 /*
1594  * Define a memory object (Mob) in the OTable.
1595  */
1596 
1597 typedef
1598 #include "vmware_pack_begin.h"
1599 struct SVGA3dCmdDefineGBMob {
1600    SVGAMobId mobid;
1601    SVGAMobFormat ptDepth;
1602    PPN base;
1603    uint32 sizeInBytes;
1604 }
1605 #include "vmware_pack_end.h"
1606 SVGA3dCmdDefineGBMob;   /* SVGA_3D_CMD_DEFINE_GB_MOB */
1607 
1608 
1609 /*
1610  * Destroys an object in the OTable.
1611  */
1612 
1613 typedef
1614 #include "vmware_pack_begin.h"
1615 struct SVGA3dCmdDestroyGBMob {
1616    SVGAMobId mobid;
1617 }
1618 #include "vmware_pack_end.h"
1619 SVGA3dCmdDestroyGBMob;   /* SVGA_3D_CMD_DESTROY_GB_MOB */
1620 
1621 
1622 /*
1623  * Define a memory object (Mob) in the OTable with a PPN64 base.
1624  */
1625 
1626 typedef
1627 #include "vmware_pack_begin.h"
1628 struct SVGA3dCmdDefineGBMob64 {
1629    SVGAMobId mobid;
1630    SVGAMobFormat ptDepth;
1631    PPN64 base;
1632    uint32 sizeInBytes;
1633 }
1634 #include "vmware_pack_end.h"
1635 SVGA3dCmdDefineGBMob64;   /* SVGA_3D_CMD_DEFINE_GB_MOB64 */
1636 
1637 /*
1638  * Redefine an object in the OTable with PPN64 base.
1639  */
1640 
1641 typedef
1642 #include "vmware_pack_begin.h"
1643 struct SVGA3dCmdRedefineGBMob64 {
1644    SVGAMobId mobid;
1645    SVGAMobFormat ptDepth;
1646    PPN64 base;
1647    uint32 sizeInBytes;
1648 }
1649 #include "vmware_pack_end.h"
1650 SVGA3dCmdRedefineGBMob64;   /* SVGA_3D_CMD_REDEFINE_GB_MOB64 */
1651 
1652 /*
1653  * Notification that the page tables have been modified.
1654  */
1655 
1656 typedef
1657 #include "vmware_pack_begin.h"
1658 struct SVGA3dCmdUpdateGBMobMapping {
1659    SVGAMobId mobid;
1660 }
1661 #include "vmware_pack_end.h"
1662 SVGA3dCmdUpdateGBMobMapping;   /* SVGA_3D_CMD_UPDATE_GB_MOB_MAPPING */
1663 
1664 /*
1665  * Define a guest-backed surface.
1666  */
1667 
1668 typedef
1669 #include "vmware_pack_begin.h"
1670 struct SVGA3dCmdDefineGBSurface {
1671    uint32 sid;
1672    SVGA3dSurface1Flags surfaceFlags;
1673    SVGA3dSurfaceFormat format;
1674    uint32 numMipLevels;
1675    uint32 multisampleCount;
1676    SVGA3dTextureFilter autogenFilter;
1677    SVGA3dSize size;
1678 }
1679 #include "vmware_pack_end.h"
1680 SVGA3dCmdDefineGBSurface;   /* SVGA_3D_CMD_DEFINE_GB_SURFACE */
1681 
1682 /*
1683  * Defines a guest-backed surface, adding the arraySize field.
1684  */
1685 typedef
1686 #include "vmware_pack_begin.h"
1687 struct SVGA3dCmdDefineGBSurface_v2 {
1688    uint32 sid;
1689    SVGA3dSurface1Flags surfaceFlags;
1690    SVGA3dSurfaceFormat format;
1691    uint32 numMipLevels;
1692    uint32 multisampleCount;
1693    SVGA3dTextureFilter autogenFilter;
1694    SVGA3dSize size;
1695    uint32 arraySize;
1696    uint32 pad;
1697 }
1698 #include "vmware_pack_end.h"
1699 SVGA3dCmdDefineGBSurface_v2;   /* SVGA_3D_CMD_DEFINE_GB_SURFACE_V2 */
1700 
1701 /*
1702  * Defines a guest-backed surface, adding the larger flags.
1703  */
1704 typedef
1705 #include "vmware_pack_begin.h"
1706 struct SVGA3dCmdDefineGBSurface_v3 {
1707    uint32 sid;
1708    SVGA3dSurfaceAllFlags surfaceFlags;
1709    SVGA3dSurfaceFormat format;
1710    uint32 numMipLevels;
1711    uint32 multisampleCount;
1712    SVGA3dMSPattern multisamplePattern;
1713    SVGA3dMSQualityLevel qualityLevel;
1714    SVGA3dTextureFilter autogenFilter;
1715    SVGA3dSize size;
1716    uint32 arraySize;
1717 }
1718 #include "vmware_pack_end.h"
1719 SVGA3dCmdDefineGBSurface_v3;   /* SVGA_3D_CMD_DEFINE_GB_SURFACE_V3 */
1720 
1721 /*
1722  * Destroy a guest-backed surface.
1723  */
1724 
1725 typedef
1726 #include "vmware_pack_begin.h"
1727 struct SVGA3dCmdDestroyGBSurface {
1728    uint32 sid;
1729 }
1730 #include "vmware_pack_end.h"
1731 SVGA3dCmdDestroyGBSurface;   /* SVGA_3D_CMD_DESTROY_GB_SURFACE */
1732 
1733 /*
1734  * Bind a guest-backed surface to a mob.
1735  */
1736 
1737 typedef
1738 #include "vmware_pack_begin.h"
1739 struct SVGA3dCmdBindGBSurface {
1740    uint32 sid;
1741    SVGAMobId mobid;
1742 }
1743 #include "vmware_pack_end.h"
1744 SVGA3dCmdBindGBSurface;   /* SVGA_3D_CMD_BIND_GB_SURFACE */
1745 
1746 typedef
1747 #include "vmware_pack_begin.h"
1748 struct SVGA3dCmdBindGBSurfaceWithPitch {
1749    uint32 sid;
1750    SVGAMobId mobid;
1751    uint32 baseLevelPitch;
1752 }
1753 #include "vmware_pack_end.h"
1754 SVGA3dCmdBindGBSurfaceWithPitch;   /* SVGA_3D_CMD_BIND_GB_SURFACE_WITH_PITCH */
1755 
1756 /*
1757  * Conditionally bind a mob to a guest-backed surface if testMobid
1758  * matches the currently bound mob.  Optionally issue a
1759  * readback/update on the surface while it is still bound to the old
1760  * mobid if the mobid is changed by this command.
1761  */
1762 
1763 #define SVGA3D_COND_BIND_GB_SURFACE_FLAG_READBACK (1 << 0)
1764 #define SVGA3D_COND_BIND_GB_SURFACE_FLAG_UPDATE   (1 << 1)
1765 
1766 typedef
1767 #include "vmware_pack_begin.h"
1768 struct SVGA3dCmdCondBindGBSurface {
1769    uint32 sid;
1770    SVGAMobId testMobid;
1771    SVGAMobId mobid;
1772    uint32 flags;
1773 }
1774 #include "vmware_pack_end.h"
1775 SVGA3dCmdCondBindGBSurface;          /* SVGA_3D_CMD_COND_BIND_GB_SURFACE */
1776 
1777 /*
1778  * Update an image in a guest-backed surface.
1779  * (Inform the device that the guest-contents have been updated.)
1780  */
1781 
1782 typedef
1783 #include "vmware_pack_begin.h"
1784 struct SVGA3dCmdUpdateGBImage {
1785    SVGA3dSurfaceImageId image;
1786    SVGA3dBox box;
1787 }
1788 #include "vmware_pack_end.h"
1789 SVGA3dCmdUpdateGBImage;   /* SVGA_3D_CMD_UPDATE_GB_IMAGE */
1790 
1791 /*
1792  * Update an entire guest-backed surface.
1793  * (Inform the device that the guest-contents have been updated.)
1794  */
1795 
1796 typedef
1797 #include "vmware_pack_begin.h"
1798 struct SVGA3dCmdUpdateGBSurface {
1799    uint32 sid;
1800 }
1801 #include "vmware_pack_end.h"
1802 SVGA3dCmdUpdateGBSurface;   /* SVGA_3D_CMD_UPDATE_GB_SURFACE */
1803 
1804 /*
1805  * Readback an image in a guest-backed surface.
1806  * (Request the device to flush the dirty contents into the guest.)
1807  */
1808 
1809 typedef
1810 #include "vmware_pack_begin.h"
1811 struct SVGA3dCmdReadbackGBImage {
1812    SVGA3dSurfaceImageId image;
1813 }
1814 #include "vmware_pack_end.h"
1815 SVGA3dCmdReadbackGBImage;   /* SVGA_3D_CMD_READBACK_GB_IMAGE */
1816 
1817 /*
1818  * Readback an entire guest-backed surface.
1819  * (Request the device to flush the dirty contents into the guest.)
1820  */
1821 
1822 typedef
1823 #include "vmware_pack_begin.h"
1824 struct SVGA3dCmdReadbackGBSurface {
1825    uint32 sid;
1826 }
1827 #include "vmware_pack_end.h"
1828 SVGA3dCmdReadbackGBSurface;   /* SVGA_3D_CMD_READBACK_GB_SURFACE */
1829 
1830 /*
1831  * Readback a sub rect of an image in a guest-backed surface.  After
1832  * issuing this command the driver is required to issue an update call
1833  * of the same region before issuing any other commands that reference
1834  * this surface or rendering is not guaranteed.
1835  */
1836 
1837 typedef
1838 #include "vmware_pack_begin.h"
1839 struct SVGA3dCmdReadbackGBImagePartial {
1840    SVGA3dSurfaceImageId image;
1841    SVGA3dBox box;
1842    uint32 invertBox;
1843 }
1844 #include "vmware_pack_end.h"
1845 SVGA3dCmdReadbackGBImagePartial; /* SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL */
1846 
1847 
1848 /*
1849  * Invalidate an image in a guest-backed surface.
1850  * (Notify the device that the contents can be lost.)
1851  */
1852 
1853 typedef
1854 #include "vmware_pack_begin.h"
1855 struct SVGA3dCmdInvalidateGBImage {
1856    SVGA3dSurfaceImageId image;
1857 }
1858 #include "vmware_pack_end.h"
1859 SVGA3dCmdInvalidateGBImage;   /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE */
1860 
1861 /*
1862  * Invalidate an entire guest-backed surface.
1863  * (Notify the device that the contents if all images can be lost.)
1864  */
1865 
1866 typedef
1867 #include "vmware_pack_begin.h"
1868 struct SVGA3dCmdInvalidateGBSurface {
1869    uint32 sid;
1870 }
1871 #include "vmware_pack_end.h"
1872 SVGA3dCmdInvalidateGBSurface; /* SVGA_3D_CMD_INVALIDATE_GB_SURFACE */
1873 
1874 /*
1875  * Invalidate a sub rect of an image in a guest-backed surface.  After
1876  * issuing this command the driver is required to issue an update call
1877  * of the same region before issuing any other commands that reference
1878  * this surface or rendering is not guaranteed.
1879  */
1880 
1881 typedef
1882 #include "vmware_pack_begin.h"
1883 struct SVGA3dCmdInvalidateGBImagePartial {
1884    SVGA3dSurfaceImageId image;
1885    SVGA3dBox box;
1886    uint32 invertBox;
1887 }
1888 #include "vmware_pack_end.h"
1889 SVGA3dCmdInvalidateGBImagePartial; /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL */
1890 
1891 
1892 /*
1893  * Define a guest-backed context.
1894  */
1895 
1896 typedef
1897 #include "vmware_pack_begin.h"
1898 struct SVGA3dCmdDefineGBContext {
1899    uint32 cid;
1900 }
1901 #include "vmware_pack_end.h"
1902 SVGA3dCmdDefineGBContext;   /* SVGA_3D_CMD_DEFINE_GB_CONTEXT */
1903 
1904 /*
1905  * Destroy a guest-backed context.
1906  */
1907 
1908 typedef
1909 #include "vmware_pack_begin.h"
1910 struct SVGA3dCmdDestroyGBContext {
1911    uint32 cid;
1912 }
1913 #include "vmware_pack_end.h"
1914 SVGA3dCmdDestroyGBContext;   /* SVGA_3D_CMD_DESTROY_GB_CONTEXT */
1915 
1916 /*
1917  * Bind a guest-backed context.
1918  *
1919  * validContents should be set to 0 for new contexts,
1920  * and 1 if this is an old context which is getting paged
1921  * back on to the device.
1922  *
1923  * For new contexts, it is recommended that the driver
1924  * issue commands to initialize all interesting state
1925  * prior to rendering.
1926  */
1927 
1928 typedef
1929 #include "vmware_pack_begin.h"
1930 struct SVGA3dCmdBindGBContext {
1931    uint32 cid;
1932    SVGAMobId mobid;
1933    uint32 validContents;
1934 }
1935 #include "vmware_pack_end.h"
1936 SVGA3dCmdBindGBContext;   /* SVGA_3D_CMD_BIND_GB_CONTEXT */
1937 
1938 /*
1939  * Readback a guest-backed context.
1940  * (Request that the device flush the contents back into guest memory.)
1941  */
1942 
1943 typedef
1944 #include "vmware_pack_begin.h"
1945 struct SVGA3dCmdReadbackGBContext {
1946    uint32 cid;
1947 }
1948 #include "vmware_pack_end.h"
1949 SVGA3dCmdReadbackGBContext;   /* SVGA_3D_CMD_READBACK_GB_CONTEXT */
1950 
1951 /*
1952  * Invalidate a guest-backed context.
1953  */
1954 typedef
1955 #include "vmware_pack_begin.h"
1956 struct SVGA3dCmdInvalidateGBContext {
1957    uint32 cid;
1958 }
1959 #include "vmware_pack_end.h"
1960 SVGA3dCmdInvalidateGBContext;   /* SVGA_3D_CMD_INVALIDATE_GB_CONTEXT */
1961 
1962 /*
1963  * Define a guest-backed shader.
1964  */
1965 
1966 typedef
1967 #include "vmware_pack_begin.h"
1968 struct SVGA3dCmdDefineGBShader {
1969    uint32 shid;
1970    SVGA3dShaderType type;
1971    uint32 sizeInBytes;
1972 }
1973 #include "vmware_pack_end.h"
1974 SVGA3dCmdDefineGBShader;   /* SVGA_3D_CMD_DEFINE_GB_SHADER */
1975 
1976 /*
1977  * Bind a guest-backed shader.
1978  */
1979 
1980 typedef
1981 #include "vmware_pack_begin.h"
1982 struct SVGA3dCmdBindGBShader {
1983    uint32 shid;
1984    SVGAMobId mobid;
1985    uint32 offsetInBytes;
1986 }
1987 #include "vmware_pack_end.h"
1988 SVGA3dCmdBindGBShader;   /* SVGA_3D_CMD_BIND_GB_SHADER */
1989 
1990 /*
1991  * Destroy a guest-backed shader.
1992  */
1993 
1994 typedef
1995 #include "vmware_pack_begin.h"
1996 struct SVGA3dCmdDestroyGBShader {
1997    uint32 shid;
1998 }
1999 #include "vmware_pack_end.h"
2000 SVGA3dCmdDestroyGBShader;   /* SVGA_3D_CMD_DESTROY_GB_SHADER */
2001 
2002 typedef
2003 #include "vmware_pack_begin.h"
2004 struct {
2005    uint32                  cid;
2006    uint32                  regStart;
2007    SVGA3dShaderType        shaderType;
2008    SVGA3dShaderConstType   constType;
2009 
2010    /*
2011     * Followed by a variable number of shader constants.
2012     *
2013     * Note that FLOAT and INT constants are 4-dwords in length, while
2014     * BOOL constants are 1-dword in length.
2015     */
2016 }
2017 #include "vmware_pack_end.h"
2018 SVGA3dCmdSetGBShaderConstInline;   /* SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE */
2019 
2020 
2021 typedef
2022 #include "vmware_pack_begin.h"
2023 struct {
2024    uint32               cid;
2025    SVGA3dQueryType      type;
2026 }
2027 #include "vmware_pack_end.h"
2028 SVGA3dCmdBeginGBQuery;           /* SVGA_3D_CMD_BEGIN_GB_QUERY */
2029 
2030 typedef
2031 #include "vmware_pack_begin.h"
2032 struct {
2033    uint32               cid;
2034    SVGA3dQueryType      type;
2035    SVGAMobId mobid;
2036    uint32 offset;
2037 }
2038 #include "vmware_pack_end.h"
2039 SVGA3dCmdEndGBQuery;                  /* SVGA_3D_CMD_END_GB_QUERY */
2040 
2041 
2042 /*
2043  * SVGA_3D_CMD_WAIT_FOR_GB_QUERY --
2044  *
2045  *    The semantics of this command are identical to the
2046  *    SVGA_3D_CMD_WAIT_FOR_QUERY except that the results are written
2047  *    to a Mob instead of a GMR.
2048  */
2049 
2050 typedef
2051 #include "vmware_pack_begin.h"
2052 struct {
2053    uint32               cid;
2054    SVGA3dQueryType      type;
2055    SVGAMobId mobid;
2056    uint32 offset;
2057 }
2058 #include "vmware_pack_end.h"
2059 SVGA3dCmdWaitForGBQuery;          /* SVGA_3D_CMD_WAIT_FOR_GB_QUERY */
2060 
2061 
2062 typedef
2063 #include "vmware_pack_begin.h"
2064 struct {
2065    SVGAMobId mobid;
2066    uint32 mustBeZero;
2067    uint32 initialized;
2068 }
2069 #include "vmware_pack_end.h"
2070 SVGA3dCmdEnableGart;              /* SVGA_3D_CMD_ENABLE_GART */
2071 
2072 typedef
2073 #include "vmware_pack_begin.h"
2074 struct {
2075    SVGAMobId mobid;
2076    uint32 gartOffset;
2077 }
2078 #include "vmware_pack_end.h"
2079 SVGA3dCmdMapMobIntoGart;          /* SVGA_3D_CMD_MAP_MOB_INTO_GART */
2080 
2081 
2082 typedef
2083 #include "vmware_pack_begin.h"
2084 struct {
2085    uint32 gartOffset;
2086    uint32 numPages;
2087 }
2088 #include "vmware_pack_end.h"
2089 SVGA3dCmdUnmapGartRange;          /* SVGA_3D_CMD_UNMAP_GART_RANGE */
2090 
2091 
2092 /*
2093  * Screen Targets
2094  */
2095 
2096 typedef
2097 #include "vmware_pack_begin.h"
2098 struct {
2099    uint32 stid;
2100    uint32 width;
2101    uint32 height;
2102    int32 xRoot;
2103    int32 yRoot;
2104    SVGAScreenTargetFlags flags;
2105 
2106    /*
2107     * The physical DPI that the guest expects this screen displayed at.
2108     *
2109     * Guests which are not DPI-aware should set this to zero.
2110     */
2111    uint32 dpi;
2112 }
2113 #include "vmware_pack_end.h"
2114 SVGA3dCmdDefineGBScreenTarget;    /* SVGA_3D_CMD_DEFINE_GB_SCREENTARGET */
2115 
2116 typedef
2117 #include "vmware_pack_begin.h"
2118 struct {
2119    uint32 stid;
2120 }
2121 #include "vmware_pack_end.h"
2122 SVGA3dCmdDestroyGBScreenTarget;  /* SVGA_3D_CMD_DESTROY_GB_SCREENTARGET */
2123 
2124 typedef
2125 #include "vmware_pack_begin.h"
2126 struct {
2127    uint32 stid;
2128    SVGA3dSurfaceImageId image;
2129 }
2130 #include "vmware_pack_end.h"
2131 SVGA3dCmdBindGBScreenTarget;  /* SVGA_3D_CMD_BIND_GB_SCREENTARGET */
2132 
2133 typedef
2134 #include "vmware_pack_begin.h"
2135 struct {
2136    uint32 stid;
2137    SVGA3dRect rect;
2138 }
2139 #include "vmware_pack_end.h"
2140 SVGA3dCmdUpdateGBScreenTarget;  /* SVGA_3D_CMD_UPDATE_GB_SCREENTARGET */
2141 
2142 typedef
2143 #include "vmware_pack_begin.h"
2144 struct SVGA3dCmdGBScreenDMA {
2145    uint32 screenId;
2146    uint32 dead;
2147    SVGAMobId destMobID;
2148    uint32 destPitch;
2149    SVGAMobId changeMapMobID;
2150 }
2151 #include "vmware_pack_end.h"
2152 SVGA3dCmdGBScreenDMA;        /* SVGA_3D_CMD_GB_SCREEN_DMA */
2153 
2154 typedef
2155 #include "vmware_pack_begin.h"
2156 struct {
2157    uint32 value;
2158    uint32 mobId;
2159    uint32 mobOffset;
2160 }
2161 #include "vmware_pack_end.h"
2162 SVGA3dCmdGBMobFence;  /* SVGA_3D_CMD_GB_MOB_FENCE */
2163 
2164 typedef
2165 #include "vmware_pack_begin.h"
2166 struct {
2167    uint32 stid;
2168    SVGA3dSurfaceImageId dest;
2169 
2170    uint32 statusMobId;
2171    uint32 statusMobOffset;
2172 
2173    /* Reserved fields */
2174    uint32 mustBeInvalidId;
2175    uint32 mustBeZero;
2176 }
2177 #include "vmware_pack_end.h"
2178 SVGA3dCmdScreenCopy;  /* SVGA_3D_CMD_SCREEN_COPY */
2179 
2180 #define SVGA_SCREEN_COPY_STATUS_FAILURE 0x00
2181 #define SVGA_SCREEN_COPY_STATUS_SUCCESS 0x01
2182 #define SVGA_SCREEN_COPY_STATUS_INVALID 0xFFFFFFFF
2183 
2184 #endif /* _SVGA3D_CMD_H_ */
/* [<][>][^][v][top][bottom][index][help] */
root/drivers/gpu/drm/vmwgfx/device_include/svga3d_cmd.h

INCLUDED FROM
