drivers/gpu/drm/vmwgfx/svga3d_reg.h

   1 /**********************************************************
   2  * Copyright 1998-2014 VMware, Inc.  All rights reserved.
   3  *
   4  * Permission is hereby granted, free of charge, to any person
   5  * obtaining a copy of this software and associated documentation
   6  * files (the "Software"), to deal in the Software without
   7  * restriction, including without limitation the rights to use, copy,
   8  * modify, merge, publish, distribute, sublicense, and/or sell copies
   9  * of the Software, and to permit persons to whom the Software is
  10  * furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be
  13  * included in all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  16  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  17  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  18  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  19  * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  20  * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  21  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  22  * SOFTWARE.
  23  *
  24  **********************************************************/
  25
  26 /*
  27  * svga3d_reg.h --
  28  *
  29  *       SVGA 3D hardware definitions
  30  */
  31
  32 #ifndef _SVGA3D_REG_H_
  33 #define _SVGA3D_REG_H_
  34
  35 #include "svga_reg.h"
  36
  37 typedef uint32 PPN;
  38 typedef __le64 PPN64;
  39
  40 /*
  41  * 3D Hardware Version
  42  *
  43  *   The hardware version is stored in the SVGA_FIFO_3D_HWVERSION fifo
  44  *   register.   Is set by the host and read by the guest.  This lets
  45  *   us make new guest drivers which are backwards-compatible with old
  46  *   SVGA hardware revisions.  It does not let us support old guest
  47  *   drivers.  Good enough for now.
  48  *
  49  */
  50
  51 #define SVGA3D_MAKE_HWVERSION(major, minor)      (((major) << 16) | ((minor) & 0xFF))
  52 #define SVGA3D_MAJOR_HWVERSION(version)          ((version) >> 16)
  53 #define SVGA3D_MINOR_HWVERSION(version)          ((version) & 0xFF)
  54
  55 typedef enum {
  56    SVGA3D_HWVERSION_WS5_RC1   = SVGA3D_MAKE_HWVERSION(0, 1),
  57    SVGA3D_HWVERSION_WS5_RC2   = SVGA3D_MAKE_HWVERSION(0, 2),
  58    SVGA3D_HWVERSION_WS51_RC1  = SVGA3D_MAKE_HWVERSION(0, 3),
  59    SVGA3D_HWVERSION_WS6_B1    = SVGA3D_MAKE_HWVERSION(1, 1),
  60    SVGA3D_HWVERSION_FUSION_11 = SVGA3D_MAKE_HWVERSION(1, 4),
  61    SVGA3D_HWVERSION_WS65_B1   = SVGA3D_MAKE_HWVERSION(2, 0),
  62    SVGA3D_HWVERSION_WS8_B1    = SVGA3D_MAKE_HWVERSION(2, 1),
  63    SVGA3D_HWVERSION_CURRENT   = SVGA3D_HWVERSION_WS8_B1,
  64 } SVGA3dHardwareVersion;
  65
  66 /*
  67  * Generic Types
  68  */
  69
  70 typedef uint32 SVGA3dBool; /* 32-bit Bool definition */
  71 #define SVGA3D_NUM_CLIPPLANES                   6
  72 #define SVGA3D_MAX_SIMULTANEOUS_RENDER_TARGETS  8
  73 #define SVGA3D_MAX_CONTEXT_IDS                  256
  74 #define SVGA3D_MAX_SURFACE_IDS                  (32 * 1024)
  75
  76 #define SVGA3D_NUM_TEXTURE_UNITS                32
  77 #define SVGA3D_NUM_LIGHTS                       8
  78
  79 /*
  80  * Surface formats.
  81  *
  82  * If you modify this list, be sure to keep GLUtil.c in sync. It
  83  * includes the internal format definition of each surface in
  84  * GLUtil_ConvertSurfaceFormat, and it contains a table of
  85  * human-readable names in GLUtil_GetFormatName.
  86  */
  87
  88 typedef enum SVGA3dSurfaceFormat {
  89    SVGA3D_FORMAT_MIN                   = 0,
  90    SVGA3D_FORMAT_INVALID               = 0,
  91
  92    SVGA3D_X8R8G8B8                     = 1,
  93    SVGA3D_A8R8G8B8                     = 2,
  94
  95    SVGA3D_R5G6B5                       = 3,
  96    SVGA3D_X1R5G5B5                     = 4,
  97    SVGA3D_A1R5G5B5                     = 5,
  98    SVGA3D_A4R4G4B4                     = 6,
  99
 100    SVGA3D_Z_D32                        = 7,
 101    SVGA3D_Z_D16                        = 8,
 102    SVGA3D_Z_D24S8                      = 9,
 103    SVGA3D_Z_D15S1                      = 10,
 104
 105    SVGA3D_LUMINANCE8                   = 11,
 106    SVGA3D_LUMINANCE4_ALPHA4            = 12,
 107    SVGA3D_LUMINANCE16                  = 13,
 108    SVGA3D_LUMINANCE8_ALPHA8            = 14,
 109
 110    SVGA3D_DXT1                         = 15,
 111    SVGA3D_DXT2                         = 16,
 112    SVGA3D_DXT3                         = 17,
 113    SVGA3D_DXT4                         = 18,
 114    SVGA3D_DXT5                         = 19,
 115
 116    SVGA3D_BUMPU8V8                     = 20,
 117    SVGA3D_BUMPL6V5U5                   = 21,
 118    SVGA3D_BUMPX8L8V8U8                 = 22,
 119    SVGA3D_BUMPL8V8U8                   = 23,
 120
 121    SVGA3D_ARGB_S10E5                   = 24,   /* 16-bit floating-point ARGB */
 122    SVGA3D_ARGB_S23E8                   = 25,   /* 32-bit floating-point ARGB */
 123
 124    SVGA3D_A2R10G10B10                  = 26,
 125
 126    /* signed formats */
 127    SVGA3D_V8U8                         = 27,
 128    SVGA3D_Q8W8V8U8                     = 28,
 129    SVGA3D_CxV8U8                       = 29,
 130
 131    /* mixed formats */
 132    SVGA3D_X8L8V8U8                     = 30,
 133    SVGA3D_A2W10V10U10                  = 31,
 134
 135    SVGA3D_ALPHA8                       = 32,
 136
 137    /* Single- and dual-component floating point formats */
 138    SVGA3D_R_S10E5                      = 33,
 139    SVGA3D_R_S23E8                      = 34,
 140    SVGA3D_RG_S10E5                     = 35,
 141    SVGA3D_RG_S23E8                     = 36,
 142
 143    SVGA3D_BUFFER                       = 37,
 144
 145    SVGA3D_Z_D24X8                      = 38,
 146
 147    SVGA3D_V16U16                       = 39,
 148
 149    SVGA3D_G16R16                       = 40,
 150    SVGA3D_A16B16G16R16                 = 41,
 151
 152    /* Packed Video formats */
 153    SVGA3D_UYVY                         = 42,
 154    SVGA3D_YUY2                         = 43,
 155
 156    /* Planar video formats */
 157    SVGA3D_NV12                         = 44,
 158
 159    /* Video format with alpha */
 160    SVGA3D_AYUV                         = 45,
 161
 162    SVGA3D_R32G32B32A32_TYPELESS        = 46,
 163    SVGA3D_R32G32B32A32_FLOAT           = 25,
 164    SVGA3D_R32G32B32A32_UINT            = 47,
 165    SVGA3D_R32G32B32A32_SINT            = 48,
 166    SVGA3D_R32G32B32_TYPELESS           = 49,
 167    SVGA3D_R32G32B32_FLOAT              = 50,
 168    SVGA3D_R32G32B32_UINT               = 51,
 169    SVGA3D_R32G32B32_SINT               = 52,
 170    SVGA3D_R16G16B16A16_TYPELESS        = 53,
 171    SVGA3D_R16G16B16A16_FLOAT           = 24,
 172    SVGA3D_R16G16B16A16_UNORM           = 41,
 173    SVGA3D_R16G16B16A16_UINT            = 54,
 174    SVGA3D_R16G16B16A16_SNORM           = 55,
 175    SVGA3D_R16G16B16A16_SINT            = 56,
 176    SVGA3D_R32G32_TYPELESS              = 57,
 177    SVGA3D_R32G32_FLOAT                 = 36,
 178    SVGA3D_R32G32_UINT                  = 58,
 179    SVGA3D_R32G32_SINT                  = 59,
 180    SVGA3D_R32G8X24_TYPELESS            = 60,
 181    SVGA3D_D32_FLOAT_S8X24_UINT         = 61,
 182    SVGA3D_R32_FLOAT_X8X24_TYPELESS     = 62,
 183    SVGA3D_X32_TYPELESS_G8X24_UINT      = 63,
 184    SVGA3D_R10G10B10A2_TYPELESS         = 64,
 185    SVGA3D_R10G10B10A2_UNORM            = 26,
 186    SVGA3D_R10G10B10A2_UINT             = 65,
 187    SVGA3D_R11G11B10_FLOAT              = 66,
 188    SVGA3D_R8G8B8A8_TYPELESS            = 67,
 189    SVGA3D_R8G8B8A8_UNORM               = 68,
 190    SVGA3D_R8G8B8A8_UNORM_SRGB          = 69,
 191    SVGA3D_R8G8B8A8_UINT                = 70,
 192    SVGA3D_R8G8B8A8_SNORM               = 28,
 193    SVGA3D_R8G8B8A8_SINT                = 71,
 194    SVGA3D_R16G16_TYPELESS              = 72,
 195    SVGA3D_R16G16_FLOAT                 = 35,
 196    SVGA3D_R16G16_UNORM                 = 40,
 197    SVGA3D_R16G16_UINT                  = 73,
 198    SVGA3D_R16G16_SNORM                 = 39,
 199    SVGA3D_R16G16_SINT                  = 74,
 200    SVGA3D_R32_TYPELESS                 = 75,
 201    SVGA3D_D32_FLOAT                    = 76,
 202    SVGA3D_R32_FLOAT                    = 34,
 203    SVGA3D_R32_UINT                     = 77,
 204    SVGA3D_R32_SINT                     = 78,
 205    SVGA3D_R24G8_TYPELESS               = 79,
 206    SVGA3D_D24_UNORM_S8_UINT            = 80,
 207    SVGA3D_R24_UNORM_X8_TYPELESS        = 81,
 208    SVGA3D_X24_TYPELESS_G8_UINT         = 82,
 209    SVGA3D_R8G8_TYPELESS                = 83,
 210    SVGA3D_R8G8_UNORM                   = 84,
 211    SVGA3D_R8G8_UINT                    = 85,
 212    SVGA3D_R8G8_SNORM                   = 27,
 213    SVGA3D_R8G8_SINT                    = 86,
 214    SVGA3D_R16_TYPELESS                 = 87,
 215    SVGA3D_R16_FLOAT                    = 33,
 216    SVGA3D_D16_UNORM                    = 8,
 217    SVGA3D_R16_UNORM                    = 88,
 218    SVGA3D_R16_UINT                     = 89,
 219    SVGA3D_R16_SNORM                    = 90,
 220    SVGA3D_R16_SINT                     = 91,
 221    SVGA3D_R8_TYPELESS                  = 92,
 222    SVGA3D_R8_UNORM                     = 93,
 223    SVGA3D_R8_UINT                      = 94,
 224    SVGA3D_R8_SNORM                     = 95,
 225    SVGA3D_R8_SINT                      = 96,
 226    SVGA3D_A8_UNORM                     = 32,
 227    SVGA3D_P8                           = 97,
 228    SVGA3D_R9G9B9E5_SHAREDEXP           = 98,
 229    SVGA3D_R8G8_B8G8_UNORM              = 99,
 230    SVGA3D_G8R8_G8B8_UNORM              = 100,
 231    SVGA3D_BC1_TYPELESS                 = 101,
 232    SVGA3D_BC1_UNORM                    = 15,
 233    SVGA3D_BC1_UNORM_SRGB               = 102,
 234    SVGA3D_BC2_TYPELESS                 = 103,
 235    SVGA3D_BC2_UNORM                    = 17,
 236    SVGA3D_BC2_UNORM_SRGB               = 104,
 237    SVGA3D_BC3_TYPELESS                 = 105,
 238    SVGA3D_BC3_UNORM                    = 19,
 239    SVGA3D_BC3_UNORM_SRGB               = 106,
 240    SVGA3D_BC4_TYPELESS                 = 107,
 241    SVGA3D_BC4_UNORM                    = 108,
 242    SVGA3D_BC4_SNORM                    = 109,
 243    SVGA3D_BC5_TYPELESS                 = 110,
 244    SVGA3D_BC5_UNORM                    = 111,
 245    SVGA3D_BC5_SNORM                    = 112,
 246    SVGA3D_B5G6R5_UNORM                 = 3,
 247    SVGA3D_B5G5R5A1_UNORM               = 5,
 248    SVGA3D_B8G8R8A8_UNORM               = 2,
 249    SVGA3D_B8G8R8X8_UNORM               = 1,
 250    SVGA3D_R10G10B10_XR_BIAS_A2_UNORM   = 113,
 251    SVGA3D_B8G8R8A8_TYPELESS            = 114,
 252    SVGA3D_B8G8R8A8_UNORM_SRGB          = 115,
 253    SVGA3D_B8G8R8X8_TYPELESS            = 116,
 254    SVGA3D_B8G8R8X8_UNORM_SRGB          = 117,
 255
 256    /* Advanced D3D9 depth formats. */
 257    SVGA3D_Z_DF16                       = 118,
 258    SVGA3D_Z_DF24                       = 119,
 259    SVGA3D_Z_D24S8_INT                  = 120,
 260
 261    /* Planar video formats. */
 262    SVGA3D_YV12                         = 121,
 263
 264    SVGA3D_FORMAT_MAX                   = 122,
 265 } SVGA3dSurfaceFormat;
 266
 267 typedef uint32 SVGA3dColor; /* a, r, g, b */
 268
 269 /*
 270  * These match the D3DFORMAT_OP definitions used by Direct3D. We need
 271  * them so that we can query the host for what the supported surface
 272  * operations are (when we're using the D3D backend, in particular),
 273  * and so we can send those operations to the guest.
 274  */
 275 typedef enum {
 276    SVGA3DFORMAT_OP_TEXTURE                               = 0x00000001,
 277    SVGA3DFORMAT_OP_VOLUMETEXTURE                         = 0x00000002,
 278    SVGA3DFORMAT_OP_CUBETEXTURE                           = 0x00000004,
 279    SVGA3DFORMAT_OP_OFFSCREEN_RENDERTARGET                = 0x00000008,
 280    SVGA3DFORMAT_OP_SAME_FORMAT_RENDERTARGET              = 0x00000010,
 281    SVGA3DFORMAT_OP_ZSTENCIL                              = 0x00000040,
 282    SVGA3DFORMAT_OP_ZSTENCIL_WITH_ARBITRARY_COLOR_DEPTH   = 0x00000080,
 283
 284 /*
 285  * This format can be used as a render target if the current display mode
 286  * is the same depth if the alpha channel is ignored. e.g. if the device
 287  * can render to A8R8G8B8 when the display mode is X8R8G8B8, then the
 288  * format op list entry for A8R8G8B8 should have this cap.
 289  */
 290    SVGA3DFORMAT_OP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET  = 0x00000100,
 291
 292 /*
 293  * This format contains DirectDraw support (including Flip).  This flag
 294  * should not to be set on alpha formats.
 295  */
 296    SVGA3DFORMAT_OP_DISPLAYMODE                           = 0x00000400,
 297
 298 /*
 299  * The rasterizer can support some level of Direct3D support in this format
 300  * and implies that the driver can create a Context in this mode (for some
 301  * render target format).  When this flag is set, the SVGA3DFORMAT_OP_DISPLAYMODE
 302  * flag must also be set.
 303  */
 304    SVGA3DFORMAT_OP_3DACCELERATION                        = 0x00000800,
 305
 306 /*
 307  * This is set for a private format when the driver has put the bpp in
 308  * the structure.
 309  */
 310    SVGA3DFORMAT_OP_PIXELSIZE                             = 0x00001000,
 311
 312 /*
 313  * Indicates that this format can be converted to any RGB format for which
 314  * SVGA3DFORMAT_OP_MEMBEROFGROUP_ARGB is specified
 315  */
 316    SVGA3DFORMAT_OP_CONVERT_TO_ARGB                       = 0x00002000,
 317
 318 /*
 319  * Indicates that this format can be used to create offscreen plain surfaces.
 320  */
 321    SVGA3DFORMAT_OP_OFFSCREENPLAIN                        = 0x00004000,
 322
 323 /*
 324  * Indicated that this format can be read as an SRGB texture (meaning that the
 325  * sampler will linearize the looked up data)
 326  */
 327    SVGA3DFORMAT_OP_SRGBREAD                              = 0x00008000,
 328
 329 /*
 330  * Indicates that this format can be used in the bumpmap instructions
 331  */
 332    SVGA3DFORMAT_OP_BUMPMAP                               = 0x00010000,
 333
 334 /*
 335  * Indicates that this format can be sampled by the displacement map sampler
 336  */
 337    SVGA3DFORMAT_OP_DMAP                                  = 0x00020000,
 338
 339 /*
 340  * Indicates that this format cannot be used with texture filtering
 341  */
 342    SVGA3DFORMAT_OP_NOFILTER                              = 0x00040000,
 343
 344 /*
 345  * Indicates that format conversions are supported to this RGB format if
 346  * SVGA3DFORMAT_OP_CONVERT_TO_ARGB is specified in the source format.
 347  */
 348    SVGA3DFORMAT_OP_MEMBEROFGROUP_ARGB                    = 0x00080000,
 349
 350 /*
 351  * Indicated that this format can be written as an SRGB target (meaning that the
 352  * pixel pipe will DE-linearize data on output to format)
 353  */
 354    SVGA3DFORMAT_OP_SRGBWRITE                             = 0x00100000,
 355
 356 /*
 357  * Indicates that this format cannot be used with alpha blending
 358  */
 359    SVGA3DFORMAT_OP_NOALPHABLEND                          = 0x00200000,
 360
 361 /*
 362  * Indicates that the device can auto-generated sublevels for resources
 363  * of this format
 364  */
 365    SVGA3DFORMAT_OP_AUTOGENMIPMAP                         = 0x00400000,
 366
 367 /*
 368  * Indicates that this format can be used by vertex texture sampler
 369  */
 370    SVGA3DFORMAT_OP_VERTEXTEXTURE                         = 0x00800000,
 371
 372 /*
 373  * Indicates that this format supports neither texture coordinate wrap
 374  * modes, nor mipmapping
 375  */
 376    SVGA3DFORMAT_OP_NOTEXCOORDWRAPNORMIP                  = 0x01000000
 377 } SVGA3dFormatOp;
 378
 379 /*
 380  * This structure is a conversion of SVGA3DFORMAT_OP_*.
 381  * Entries must be located at the same position.
 382  */
 383 typedef union {
 384    uint32 value;
 385    struct {
 386       uint32 texture : 1;
 387       uint32 volumeTexture : 1;
 388       uint32 cubeTexture : 1;
 389       uint32 offscreenRenderTarget : 1;
 390       uint32 sameFormatRenderTarget : 1;
 391       uint32 unknown1 : 1;
 392       uint32 zStencil : 1;
 393       uint32 zStencilArbitraryDepth : 1;
 394       uint32 sameFormatUpToAlpha : 1;
 395       uint32 unknown2 : 1;
 396       uint32 displayMode : 1;
 397       uint32 acceleration3d : 1;
 398       uint32 pixelSize : 1;
 399       uint32 convertToARGB : 1;
 400       uint32 offscreenPlain : 1;
 401       uint32 sRGBRead : 1;
 402       uint32 bumpMap : 1;
 403       uint32 dmap : 1;
 404       uint32 noFilter : 1;
 405       uint32 memberOfGroupARGB : 1;
 406       uint32 sRGBWrite : 1;
 407       uint32 noAlphaBlend : 1;
 408       uint32 autoGenMipMap : 1;
 409       uint32 vertexTexture : 1;
 410       uint32 noTexCoordWrapNorMip : 1;
 411    };
 412 } SVGA3dSurfaceFormatCaps;
 413
 414 /*
 415  * SVGA_3D_CMD_SETRENDERSTATE Types.  All value types
 416  * must fit in a uint32.
 417  */
 418
 419 typedef enum {
 420    SVGA3D_RS_INVALID                   = 0,
 421    SVGA3D_RS_ZENABLE                   = 1,     /* SVGA3dBool */
 422    SVGA3D_RS_ZWRITEENABLE              = 2,     /* SVGA3dBool */
 423    SVGA3D_RS_ALPHATESTENABLE           = 3,     /* SVGA3dBool */
 424    SVGA3D_RS_DITHERENABLE              = 4,     /* SVGA3dBool */
 425    SVGA3D_RS_BLENDENABLE               = 5,     /* SVGA3dBool */
 426    SVGA3D_RS_FOGENABLE                 = 6,     /* SVGA3dBool */
 427    SVGA3D_RS_SPECULARENABLE            = 7,     /* SVGA3dBool */
 428    SVGA3D_RS_STENCILENABLE             = 8,     /* SVGA3dBool */
 429    SVGA3D_RS_LIGHTINGENABLE            = 9,     /* SVGA3dBool */
 430    SVGA3D_RS_NORMALIZENORMALS          = 10,    /* SVGA3dBool */
 431    SVGA3D_RS_POINTSPRITEENABLE         = 11,    /* SVGA3dBool */
 432    SVGA3D_RS_POINTSCALEENABLE          = 12,    /* SVGA3dBool */
 433    SVGA3D_RS_STENCILREF                = 13,    /* uint32 */
 434    SVGA3D_RS_STENCILMASK               = 14,    /* uint32 */
 435    SVGA3D_RS_STENCILWRITEMASK          = 15,    /* uint32 */
 436    SVGA3D_RS_FOGSTART                  = 16,    /* float */
 437    SVGA3D_RS_FOGEND                    = 17,    /* float */
 438    SVGA3D_RS_FOGDENSITY                = 18,    /* float */
 439    SVGA3D_RS_POINTSIZE                 = 19,    /* float */
 440    SVGA3D_RS_POINTSIZEMIN              = 20,    /* float */
 441    SVGA3D_RS_POINTSIZEMAX              = 21,    /* float */
 442    SVGA3D_RS_POINTSCALE_A              = 22,    /* float */
 443    SVGA3D_RS_POINTSCALE_B              = 23,    /* float */
 444    SVGA3D_RS_POINTSCALE_C              = 24,    /* float */
 445    SVGA3D_RS_FOGCOLOR                  = 25,    /* SVGA3dColor */
 446    SVGA3D_RS_AMBIENT                   = 26,    /* SVGA3dColor */
 447    SVGA3D_RS_CLIPPLANEENABLE           = 27,    /* SVGA3dClipPlanes */
 448    SVGA3D_RS_FOGMODE                   = 28,    /* SVGA3dFogMode */
 449    SVGA3D_RS_FILLMODE                  = 29,    /* SVGA3dFillMode */
 450    SVGA3D_RS_SHADEMODE                 = 30,    /* SVGA3dShadeMode */
 451    SVGA3D_RS_LINEPATTERN               = 31,    /* SVGA3dLinePattern */
 452    SVGA3D_RS_SRCBLEND                  = 32,    /* SVGA3dBlendOp */
 453    SVGA3D_RS_DSTBLEND                  = 33,    /* SVGA3dBlendOp */
 454    SVGA3D_RS_BLENDEQUATION             = 34,    /* SVGA3dBlendEquation */
 455    SVGA3D_RS_CULLMODE                  = 35,    /* SVGA3dFace */
 456    SVGA3D_RS_ZFUNC                     = 36,    /* SVGA3dCmpFunc */
 457    SVGA3D_RS_ALPHAFUNC                 = 37,    /* SVGA3dCmpFunc */
 458    SVGA3D_RS_STENCILFUNC               = 38,    /* SVGA3dCmpFunc */
 459    SVGA3D_RS_STENCILFAIL               = 39,    /* SVGA3dStencilOp */
 460    SVGA3D_RS_STENCILZFAIL              = 40,    /* SVGA3dStencilOp */
 461    SVGA3D_RS_STENCILPASS               = 41,    /* SVGA3dStencilOp */
 462    SVGA3D_RS_ALPHAREF                  = 42,    /* float (0.0 .. 1.0) */
 463    SVGA3D_RS_FRONTWINDING              = 43,    /* SVGA3dFrontWinding */
 464    SVGA3D_RS_COORDINATETYPE            = 44,    /* SVGA3dCoordinateType */
 465    SVGA3D_RS_ZBIAS                     = 45,    /* float */
 466    SVGA3D_RS_RANGEFOGENABLE            = 46,    /* SVGA3dBool */
 467    SVGA3D_RS_COLORWRITEENABLE          = 47,    /* SVGA3dColorMask */
 468    SVGA3D_RS_VERTEXMATERIALENABLE      = 48,    /* SVGA3dBool */
 469    SVGA3D_RS_DIFFUSEMATERIALSOURCE     = 49,    /* SVGA3dVertexMaterial */
 470    SVGA3D_RS_SPECULARMATERIALSOURCE    = 50,    /* SVGA3dVertexMaterial */
 471    SVGA3D_RS_AMBIENTMATERIALSOURCE     = 51,    /* SVGA3dVertexMaterial */
 472    SVGA3D_RS_EMISSIVEMATERIALSOURCE    = 52,    /* SVGA3dVertexMaterial */
 473    SVGA3D_RS_TEXTUREFACTOR             = 53,    /* SVGA3dColor */
 474    SVGA3D_RS_LOCALVIEWER               = 54,    /* SVGA3dBool */
 475    SVGA3D_RS_SCISSORTESTENABLE         = 55,    /* SVGA3dBool */
 476    SVGA3D_RS_BLENDCOLOR                = 56,    /* SVGA3dColor */
 477    SVGA3D_RS_STENCILENABLE2SIDED       = 57,    /* SVGA3dBool */
 478    SVGA3D_RS_CCWSTENCILFUNC            = 58,    /* SVGA3dCmpFunc */
 479    SVGA3D_RS_CCWSTENCILFAIL            = 59,    /* SVGA3dStencilOp */
 480    SVGA3D_RS_CCWSTENCILZFAIL           = 60,    /* SVGA3dStencilOp */
 481    SVGA3D_RS_CCWSTENCILPASS            = 61,    /* SVGA3dStencilOp */
 482    SVGA3D_RS_VERTEXBLEND               = 62,    /* SVGA3dVertexBlendFlags */
 483    SVGA3D_RS_SLOPESCALEDEPTHBIAS       = 63,    /* float */
 484    SVGA3D_RS_DEPTHBIAS                 = 64,    /* float */
 485
 486
 487    /*
 488     * Output Gamma Level
 489     *
 490     * Output gamma effects the gamma curve of colors that are output from the
 491     * rendering pipeline.  A value of 1.0 specifies a linear color space. If the
 492     * value is <= 0.0, gamma correction is ignored and linear color space is
 493     * used.
 494     */
 495
 496    SVGA3D_RS_OUTPUTGAMMA               = 65,    /* float */
 497    SVGA3D_RS_ZVISIBLE                  = 66,    /* SVGA3dBool */
 498    SVGA3D_RS_LASTPIXEL                 = 67,    /* SVGA3dBool */
 499    SVGA3D_RS_CLIPPING                  = 68,    /* SVGA3dBool */
 500    SVGA3D_RS_WRAP0                     = 69,    /* SVGA3dWrapFlags */
 501    SVGA3D_RS_WRAP1                     = 70,    /* SVGA3dWrapFlags */
 502    SVGA3D_RS_WRAP2                     = 71,    /* SVGA3dWrapFlags */
 503    SVGA3D_RS_WRAP3                     = 72,    /* SVGA3dWrapFlags */
 504    SVGA3D_RS_WRAP4                     = 73,    /* SVGA3dWrapFlags */
 505    SVGA3D_RS_WRAP5                     = 74,    /* SVGA3dWrapFlags */
 506    SVGA3D_RS_WRAP6                     = 75,    /* SVGA3dWrapFlags */
 507    SVGA3D_RS_WRAP7                     = 76,    /* SVGA3dWrapFlags */
 508    SVGA3D_RS_WRAP8                     = 77,    /* SVGA3dWrapFlags */
 509    SVGA3D_RS_WRAP9                     = 78,    /* SVGA3dWrapFlags */
 510    SVGA3D_RS_WRAP10                    = 79,    /* SVGA3dWrapFlags */
 511    SVGA3D_RS_WRAP11                    = 80,    /* SVGA3dWrapFlags */
 512    SVGA3D_RS_WRAP12                    = 81,    /* SVGA3dWrapFlags */
 513    SVGA3D_RS_WRAP13                    = 82,    /* SVGA3dWrapFlags */
 514    SVGA3D_RS_WRAP14                    = 83,    /* SVGA3dWrapFlags */
 515    SVGA3D_RS_WRAP15                    = 84,    /* SVGA3dWrapFlags */
 516    SVGA3D_RS_MULTISAMPLEANTIALIAS      = 85,    /* SVGA3dBool */
 517    SVGA3D_RS_MULTISAMPLEMASK           = 86,    /* uint32 */
 518    SVGA3D_RS_INDEXEDVERTEXBLENDENABLE  = 87,    /* SVGA3dBool */
 519    SVGA3D_RS_TWEENFACTOR               = 88,    /* float */
 520    SVGA3D_RS_ANTIALIASEDLINEENABLE     = 89,    /* SVGA3dBool */
 521    SVGA3D_RS_COLORWRITEENABLE1         = 90,    /* SVGA3dColorMask */
 522    SVGA3D_RS_COLORWRITEENABLE2         = 91,    /* SVGA3dColorMask */
 523    SVGA3D_RS_COLORWRITEENABLE3         = 92,    /* SVGA3dColorMask */
 524    SVGA3D_RS_SEPARATEALPHABLENDENABLE  = 93,    /* SVGA3dBool */
 525    SVGA3D_RS_SRCBLENDALPHA             = 94,    /* SVGA3dBlendOp */
 526    SVGA3D_RS_DSTBLENDALPHA             = 95,    /* SVGA3dBlendOp */
 527    SVGA3D_RS_BLENDEQUATIONALPHA        = 96,    /* SVGA3dBlendEquation */
 528    SVGA3D_RS_TRANSPARENCYANTIALIAS     = 97,    /* SVGA3dTransparencyAntialiasType */
 529    SVGA3D_RS_LINEAA                    = 98,    /* SVGA3dBool */
 530    SVGA3D_RS_LINEWIDTH                 = 99,    /* float */
 531    SVGA3D_RS_MAX
 532 } SVGA3dRenderStateName;
 533
 534 typedef enum {
 535    SVGA3D_TRANSPARENCYANTIALIAS_NORMAL            = 0,
 536    SVGA3D_TRANSPARENCYANTIALIAS_ALPHATOCOVERAGE   = 1,
 537    SVGA3D_TRANSPARENCYANTIALIAS_SUPERSAMPLE       = 2,
 538    SVGA3D_TRANSPARENCYANTIALIAS_MAX
 539 } SVGA3dTransparencyAntialiasType;
 540
 541 typedef enum {
 542    SVGA3D_VERTEXMATERIAL_NONE     = 0,    /* Use the value in the current material */
 543    SVGA3D_VERTEXMATERIAL_DIFFUSE  = 1,    /* Use the value in the diffuse component */
 544    SVGA3D_VERTEXMATERIAL_SPECULAR = 2,    /* Use the value in the specular component */
 545 } SVGA3dVertexMaterial;
 546
 547 typedef enum {
 548    SVGA3D_FILLMODE_INVALID = 0,
 549    SVGA3D_FILLMODE_POINT   = 1,
 550    SVGA3D_FILLMODE_LINE    = 2,
 551    SVGA3D_FILLMODE_FILL    = 3,
 552    SVGA3D_FILLMODE_MAX
 553 } SVGA3dFillModeType;
 554
 555
 556 typedef
 557 union {
 558    struct {
 559       uint16   mode;       /* SVGA3dFillModeType */
 560       uint16   face;       /* SVGA3dFace */
 561    };
 562    uint32 uintValue;
 563 } SVGA3dFillMode;
 564
 565 typedef enum {
 566    SVGA3D_SHADEMODE_INVALID = 0,
 567    SVGA3D_SHADEMODE_FLAT    = 1,
 568    SVGA3D_SHADEMODE_SMOOTH  = 2,
 569    SVGA3D_SHADEMODE_PHONG   = 3,     /* Not supported */
 570    SVGA3D_SHADEMODE_MAX
 571 } SVGA3dShadeMode;
 572
 573 typedef
 574 union {
 575    struct {
 576       uint16 repeat;
 577       uint16 pattern;
 578    };
 579    uint32 uintValue;
 580 } SVGA3dLinePattern;
 581
 582 typedef enum {
 583    SVGA3D_BLENDOP_INVALID            = 0,
 584    SVGA3D_BLENDOP_ZERO               = 1,
 585    SVGA3D_BLENDOP_ONE                = 2,
 586    SVGA3D_BLENDOP_SRCCOLOR           = 3,
 587    SVGA3D_BLENDOP_INVSRCCOLOR        = 4,
 588    SVGA3D_BLENDOP_SRCALPHA           = 5,
 589    SVGA3D_BLENDOP_INVSRCALPHA        = 6,
 590    SVGA3D_BLENDOP_DESTALPHA          = 7,
 591    SVGA3D_BLENDOP_INVDESTALPHA       = 8,
 592    SVGA3D_BLENDOP_DESTCOLOR          = 9,
 593    SVGA3D_BLENDOP_INVDESTCOLOR       = 10,
 594    SVGA3D_BLENDOP_SRCALPHASAT        = 11,
 595    SVGA3D_BLENDOP_BLENDFACTOR        = 12,
 596    SVGA3D_BLENDOP_INVBLENDFACTOR     = 13,
 597    SVGA3D_BLENDOP_MAX
 598 } SVGA3dBlendOp;
 599
 600 typedef enum {
 601    SVGA3D_BLENDEQ_INVALID            = 0,
 602    SVGA3D_BLENDEQ_ADD                = 1,
 603    SVGA3D_BLENDEQ_SUBTRACT           = 2,
 604    SVGA3D_BLENDEQ_REVSUBTRACT        = 3,
 605    SVGA3D_BLENDEQ_MINIMUM            = 4,
 606    SVGA3D_BLENDEQ_MAXIMUM            = 5,
 607    SVGA3D_BLENDEQ_MAX
 608 } SVGA3dBlendEquation;
 609
 610 typedef enum {
 611    SVGA3D_FRONTWINDING_INVALID = 0,
 612    SVGA3D_FRONTWINDING_CW      = 1,
 613    SVGA3D_FRONTWINDING_CCW     = 2,
 614    SVGA3D_FRONTWINDING_MAX
 615 } SVGA3dFrontWinding;
 616
 617 typedef enum {
 618    SVGA3D_FACE_INVALID  = 0,
 619    SVGA3D_FACE_NONE     = 1,
 620    SVGA3D_FACE_FRONT    = 2,
 621    SVGA3D_FACE_BACK     = 3,
 622    SVGA3D_FACE_FRONT_BACK = 4,
 623    SVGA3D_FACE_MAX
 624 } SVGA3dFace;
 625
 626 /*
 627  * The order and the values should not be changed
 628  */
 629
 630 typedef enum {
 631    SVGA3D_CMP_INVALID              = 0,
 632    SVGA3D_CMP_NEVER                = 1,
 633    SVGA3D_CMP_LESS                 = 2,
 634    SVGA3D_CMP_EQUAL                = 3,
 635    SVGA3D_CMP_LESSEQUAL            = 4,
 636    SVGA3D_CMP_GREATER              = 5,
 637    SVGA3D_CMP_NOTEQUAL             = 6,
 638    SVGA3D_CMP_GREATEREQUAL         = 7,
 639    SVGA3D_CMP_ALWAYS               = 8,
 640    SVGA3D_CMP_MAX
 641 } SVGA3dCmpFunc;
 642
 643 /*
 644  * SVGA3D_FOGFUNC_* specifies the fog equation, or PER_VERTEX which allows
 645  * the fog factor to be specified in the alpha component of the specular
 646  * (a.k.a. secondary) vertex color.
 647  */
 648 typedef enum {
 649    SVGA3D_FOGFUNC_INVALID          = 0,
 650    SVGA3D_FOGFUNC_EXP              = 1,
 651    SVGA3D_FOGFUNC_EXP2             = 2,
 652    SVGA3D_FOGFUNC_LINEAR           = 3,
 653    SVGA3D_FOGFUNC_PER_VERTEX       = 4
 654 } SVGA3dFogFunction;
 655
 656 /*
 657  * SVGA3D_FOGTYPE_* specifies if fog factors are computed on a per-vertex
 658  * or per-pixel basis.
 659  */
 660 typedef enum {
 661    SVGA3D_FOGTYPE_INVALID          = 0,
 662    SVGA3D_FOGTYPE_VERTEX           = 1,
 663    SVGA3D_FOGTYPE_PIXEL            = 2,
 664    SVGA3D_FOGTYPE_MAX              = 3
 665 } SVGA3dFogType;
 666
 667 /*
 668  * SVGA3D_FOGBASE_* selects depth or range-based fog. Depth-based fog is
 669  * computed using the eye Z value of each pixel (or vertex), whereas range-
 670  * based fog is computed using the actual distance (range) to the eye.
 671  */
 672 typedef enum {
 673    SVGA3D_FOGBASE_INVALID          = 0,
 674    SVGA3D_FOGBASE_DEPTHBASED       = 1,
 675    SVGA3D_FOGBASE_RANGEBASED       = 2,
 676    SVGA3D_FOGBASE_MAX              = 3
 677 } SVGA3dFogBase;
 678
 679 typedef enum {
 680    SVGA3D_STENCILOP_INVALID        = 0,
 681    SVGA3D_STENCILOP_KEEP           = 1,
 682    SVGA3D_STENCILOP_ZERO           = 2,
 683    SVGA3D_STENCILOP_REPLACE        = 3,
 684    SVGA3D_STENCILOP_INCRSAT        = 4,
 685    SVGA3D_STENCILOP_DECRSAT        = 5,
 686    SVGA3D_STENCILOP_INVERT         = 6,
 687    SVGA3D_STENCILOP_INCR           = 7,
 688    SVGA3D_STENCILOP_DECR           = 8,
 689    SVGA3D_STENCILOP_MAX
 690 } SVGA3dStencilOp;
 691
 692 typedef enum {
 693    SVGA3D_CLIPPLANE_0              = (1 << 0),
 694    SVGA3D_CLIPPLANE_1              = (1 << 1),
 695    SVGA3D_CLIPPLANE_2              = (1 << 2),
 696    SVGA3D_CLIPPLANE_3              = (1 << 3),
 697    SVGA3D_CLIPPLANE_4              = (1 << 4),
 698    SVGA3D_CLIPPLANE_5              = (1 << 5),
 699 } SVGA3dClipPlanes;
 700
 701 typedef enum {
 702    SVGA3D_CLEAR_COLOR              = 0x1,
 703    SVGA3D_CLEAR_DEPTH              = 0x2,
 704    SVGA3D_CLEAR_STENCIL            = 0x4
 705 } SVGA3dClearFlag;
 706
 707 typedef enum {
 708    SVGA3D_RT_DEPTH                 = 0,
 709    SVGA3D_RT_STENCIL               = 1,
 710    SVGA3D_RT_COLOR0                = 2,
 711    SVGA3D_RT_COLOR1                = 3,
 712    SVGA3D_RT_COLOR2                = 4,
 713    SVGA3D_RT_COLOR3                = 5,
 714    SVGA3D_RT_COLOR4                = 6,
 715    SVGA3D_RT_COLOR5                = 7,
 716    SVGA3D_RT_COLOR6                = 8,
 717    SVGA3D_RT_COLOR7                = 9,
 718    SVGA3D_RT_MAX,
 719    SVGA3D_RT_INVALID               = ((uint32)-1),
 720 } SVGA3dRenderTargetType;
 721
 722 #define SVGA3D_MAX_RT_COLOR (SVGA3D_RT_COLOR7 - SVGA3D_RT_COLOR0 + 1)
 723
 724 typedef
 725 union {
 726    struct {
 727       uint32  red   : 1;
 728       uint32  green : 1;
 729       uint32  blue  : 1;
 730       uint32  alpha : 1;
 731    };
 732    uint32 uintValue;
 733 } SVGA3dColorMask;
 734
 735 typedef enum {
 736    SVGA3D_VBLEND_DISABLE            = 0,
 737    SVGA3D_VBLEND_1WEIGHT            = 1,
 738    SVGA3D_VBLEND_2WEIGHT            = 2,
 739    SVGA3D_VBLEND_3WEIGHT            = 3,
 740 } SVGA3dVertexBlendFlags;
 741
 742 typedef enum {
 743    SVGA3D_WRAPCOORD_0   = 1 << 0,
 744    SVGA3D_WRAPCOORD_1   = 1 << 1,
 745    SVGA3D_WRAPCOORD_2   = 1 << 2,
 746    SVGA3D_WRAPCOORD_3   = 1 << 3,
 747    SVGA3D_WRAPCOORD_ALL = 0xF,
 748 } SVGA3dWrapFlags;
 749
 750 /*
 751  * SVGA_3D_CMD_TEXTURESTATE Types.  All value types
 752  * must fit in a uint32.
 753  */
 754
 755 typedef enum {
 756    SVGA3D_TS_INVALID                    = 0,
 757    SVGA3D_TS_BIND_TEXTURE               = 1,    /* SVGA3dSurfaceId */
 758    SVGA3D_TS_COLOROP                    = 2,    /* SVGA3dTextureCombiner */
 759    SVGA3D_TS_COLORARG1                  = 3,    /* SVGA3dTextureArgData */
 760    SVGA3D_TS_COLORARG2                  = 4,    /* SVGA3dTextureArgData */
 761    SVGA3D_TS_ALPHAOP                    = 5,    /* SVGA3dTextureCombiner */
 762    SVGA3D_TS_ALPHAARG1                  = 6,    /* SVGA3dTextureArgData */
 763    SVGA3D_TS_ALPHAARG2                  = 7,    /* SVGA3dTextureArgData */
 764    SVGA3D_TS_ADDRESSU                   = 8,    /* SVGA3dTextureAddress */
 765    SVGA3D_TS_ADDRESSV                   = 9,    /* SVGA3dTextureAddress */
 766    SVGA3D_TS_MIPFILTER                  = 10,   /* SVGA3dTextureFilter */
 767    SVGA3D_TS_MAGFILTER                  = 11,   /* SVGA3dTextureFilter */
 768    SVGA3D_TS_MINFILTER                  = 12,   /* SVGA3dTextureFilter */
 769    SVGA3D_TS_BORDERCOLOR                = 13,   /* SVGA3dColor */
 770    SVGA3D_TS_TEXCOORDINDEX              = 14,   /* uint32 */
 771    SVGA3D_TS_TEXTURETRANSFORMFLAGS      = 15,   /* SVGA3dTexTransformFlags */
 772    SVGA3D_TS_TEXCOORDGEN                = 16,   /* SVGA3dTextureCoordGen */
 773    SVGA3D_TS_BUMPENVMAT00               = 17,   /* float */
 774    SVGA3D_TS_BUMPENVMAT01               = 18,   /* float */
 775    SVGA3D_TS_BUMPENVMAT10               = 19,   /* float */
 776    SVGA3D_TS_BUMPENVMAT11               = 20,   /* float */
 777    SVGA3D_TS_TEXTURE_MIPMAP_LEVEL       = 21,   /* uint32 */
 778    SVGA3D_TS_TEXTURE_LOD_BIAS           = 22,   /* float */
 779    SVGA3D_TS_TEXTURE_ANISOTROPIC_LEVEL  = 23,   /* uint32 */
 780    SVGA3D_TS_ADDRESSW                   = 24,   /* SVGA3dTextureAddress */
 781
 782
 783    /*
 784     * Sampler Gamma Level
 785     *
 786     * Sampler gamma effects the color of samples taken from the sampler.  A
 787     * value of 1.0 will produce linear samples.  If the value is <= 0.0 the
 788     * gamma value is ignored and a linear space is used.
 789     */
 790
 791    SVGA3D_TS_GAMMA                      = 25,   /* float */
 792    SVGA3D_TS_BUMPENVLSCALE              = 26,   /* float */
 793    SVGA3D_TS_BUMPENVLOFFSET             = 27,   /* float */
 794    SVGA3D_TS_COLORARG0                  = 28,   /* SVGA3dTextureArgData */
 795    SVGA3D_TS_ALPHAARG0                  = 29,   /* SVGA3dTextureArgData */
 796    SVGA3D_TS_MAX
 797 } SVGA3dTextureStateName;
 798
 799 typedef enum {
 800    SVGA3D_TC_INVALID                   = 0,
 801    SVGA3D_TC_DISABLE                   = 1,
 802    SVGA3D_TC_SELECTARG1                = 2,
 803    SVGA3D_TC_SELECTARG2                = 3,
 804    SVGA3D_TC_MODULATE                  = 4,
 805    SVGA3D_TC_ADD                       = 5,
 806    SVGA3D_TC_ADDSIGNED                 = 6,
 807    SVGA3D_TC_SUBTRACT                  = 7,
 808    SVGA3D_TC_BLENDTEXTUREALPHA         = 8,
 809    SVGA3D_TC_BLENDDIFFUSEALPHA         = 9,
 810    SVGA3D_TC_BLENDCURRENTALPHA         = 10,
 811    SVGA3D_TC_BLENDFACTORALPHA          = 11,
 812    SVGA3D_TC_MODULATE2X                = 12,
 813    SVGA3D_TC_MODULATE4X                = 13,
 814    SVGA3D_TC_DSDT                      = 14,
 815    SVGA3D_TC_DOTPRODUCT3               = 15,
 816    SVGA3D_TC_BLENDTEXTUREALPHAPM       = 16,
 817    SVGA3D_TC_ADDSIGNED2X               = 17,
 818    SVGA3D_TC_ADDSMOOTH                 = 18,
 819    SVGA3D_TC_PREMODULATE               = 19,
 820    SVGA3D_TC_MODULATEALPHA_ADDCOLOR    = 20,
 821    SVGA3D_TC_MODULATECOLOR_ADDALPHA    = 21,
 822    SVGA3D_TC_MODULATEINVALPHA_ADDCOLOR = 22,
 823    SVGA3D_TC_MODULATEINVCOLOR_ADDALPHA = 23,
 824    SVGA3D_TC_BUMPENVMAPLUMINANCE       = 24,
 825    SVGA3D_TC_MULTIPLYADD               = 25,
 826    SVGA3D_TC_LERP                      = 26,
 827    SVGA3D_TC_MAX
 828 } SVGA3dTextureCombiner;
 829
 830 #define SVGA3D_TC_CAP_BIT(svga3d_tc_op) (svga3d_tc_op ? (1 << (svga3d_tc_op - 1)) : 0)
 831
 832 typedef enum {
 833    SVGA3D_TEX_ADDRESS_INVALID    = 0,
 834    SVGA3D_TEX_ADDRESS_WRAP       = 1,
 835    SVGA3D_TEX_ADDRESS_MIRROR     = 2,
 836    SVGA3D_TEX_ADDRESS_CLAMP      = 3,
 837    SVGA3D_TEX_ADDRESS_BORDER     = 4,
 838    SVGA3D_TEX_ADDRESS_MIRRORONCE = 5,
 839    SVGA3D_TEX_ADDRESS_EDGE       = 6,
 840    SVGA3D_TEX_ADDRESS_MAX
 841 } SVGA3dTextureAddress;
 842
 843 /*
 844  * SVGA3D_TEX_FILTER_NONE as the minification filter means mipmapping is
 845  * disabled, and the rasterizer should use the magnification filter instead.
 846  */
 847 typedef enum {
 848    SVGA3D_TEX_FILTER_NONE           = 0,
 849    SVGA3D_TEX_FILTER_NEAREST        = 1,
 850    SVGA3D_TEX_FILTER_LINEAR         = 2,
 851    SVGA3D_TEX_FILTER_ANISOTROPIC    = 3,
 852    SVGA3D_TEX_FILTER_FLATCUBIC      = 4, /* Deprecated, not implemented */
 853    SVGA3D_TEX_FILTER_GAUSSIANCUBIC  = 5, /* Deprecated, not implemented */
 854    SVGA3D_TEX_FILTER_PYRAMIDALQUAD  = 6, /* Not currently implemented */
 855    SVGA3D_TEX_FILTER_GAUSSIANQUAD   = 7, /* Not currently implemented */
 856    SVGA3D_TEX_FILTER_MAX
 857 } SVGA3dTextureFilter;
 858
 859 typedef enum {
 860    SVGA3D_TEX_TRANSFORM_OFF    = 0,
 861    SVGA3D_TEX_TRANSFORM_S      = (1 << 0),
 862    SVGA3D_TEX_TRANSFORM_T      = (1 << 1),
 863    SVGA3D_TEX_TRANSFORM_R      = (1 << 2),
 864    SVGA3D_TEX_TRANSFORM_Q      = (1 << 3),
 865    SVGA3D_TEX_PROJECTED        = (1 << 15),
 866 } SVGA3dTexTransformFlags;
 867
 868 typedef enum {
 869    SVGA3D_TEXCOORD_GEN_OFF              = 0,
 870    SVGA3D_TEXCOORD_GEN_EYE_POSITION     = 1,
 871    SVGA3D_TEXCOORD_GEN_EYE_NORMAL       = 2,
 872    SVGA3D_TEXCOORD_GEN_REFLECTIONVECTOR = 3,
 873    SVGA3D_TEXCOORD_GEN_SPHERE           = 4,
 874    SVGA3D_TEXCOORD_GEN_MAX
 875 } SVGA3dTextureCoordGen;
 876
 877 /*
 878  * Texture argument constants for texture combiner
 879  */
 880 typedef enum {
 881    SVGA3D_TA_INVALID    = 0,
 882    SVGA3D_TA_CONSTANT   = 1,
 883    SVGA3D_TA_PREVIOUS   = 2,
 884    SVGA3D_TA_DIFFUSE    = 3,
 885    SVGA3D_TA_TEXTURE    = 4,
 886    SVGA3D_TA_SPECULAR   = 5,
 887    SVGA3D_TA_MAX
 888 } SVGA3dTextureArgData;
 889
 890 #define SVGA3D_TM_MASK_LEN 4
 891
 892 /* Modifiers for texture argument constants defined above. */
 893 typedef enum {
 894    SVGA3D_TM_NONE       = 0,
 895    SVGA3D_TM_ALPHA      = (1 << SVGA3D_TM_MASK_LEN),
 896    SVGA3D_TM_ONE_MINUS  = (2 << SVGA3D_TM_MASK_LEN),
 897 } SVGA3dTextureArgModifier;
 898
 899 #define SVGA3D_INVALID_ID         ((uint32)-1)
 900 #define SVGA3D_MAX_CLIP_PLANES    6
 901
 902 /*
 903  * This is the limit to the number of fixed-function texture
 904  * transforms and texture coordinates we can support. It does *not*
 905  * correspond to the number of texture image units (samplers) we
 906  * support!
 907  */
 908 #define SVGA3D_MAX_TEXTURE_COORDS 8
 909
 910 /*
 911  * Vertex declarations
 912  *
 913  * Notes:
 914  *
 915  * SVGA3D_DECLUSAGE_POSITIONT is for pre-transformed vertices. If you
 916  * draw with any POSITIONT vertex arrays, the programmable vertex
 917  * pipeline will be implicitly disabled. Drawing will take place as if
 918  * no vertex shader was bound.
 919  */
 920
 921 typedef enum {
 922    SVGA3D_DECLUSAGE_POSITION     = 0,
 923    SVGA3D_DECLUSAGE_BLENDWEIGHT,       /*  1 */
 924    SVGA3D_DECLUSAGE_BLENDINDICES,      /*  2 */
 925    SVGA3D_DECLUSAGE_NORMAL,            /*  3 */
 926    SVGA3D_DECLUSAGE_PSIZE,             /*  4 */
 927    SVGA3D_DECLUSAGE_TEXCOORD,          /*  5 */
 928    SVGA3D_DECLUSAGE_TANGENT,           /*  6 */
 929    SVGA3D_DECLUSAGE_BINORMAL,          /*  7 */
 930    SVGA3D_DECLUSAGE_TESSFACTOR,        /*  8 */
 931    SVGA3D_DECLUSAGE_POSITIONT,         /*  9 */
 932    SVGA3D_DECLUSAGE_COLOR,             /* 10 */
 933    SVGA3D_DECLUSAGE_FOG,               /* 11 */
 934    SVGA3D_DECLUSAGE_DEPTH,             /* 12 */
 935    SVGA3D_DECLUSAGE_SAMPLE,            /* 13 */
 936    SVGA3D_DECLUSAGE_MAX
 937 } SVGA3dDeclUsage;
 938
 939 typedef enum {
 940    SVGA3D_DECLMETHOD_DEFAULT     = 0,
 941    SVGA3D_DECLMETHOD_PARTIALU,
 942    SVGA3D_DECLMETHOD_PARTIALV,
 943    SVGA3D_DECLMETHOD_CROSSUV,          /* Normal */
 944    SVGA3D_DECLMETHOD_UV,
 945    SVGA3D_DECLMETHOD_LOOKUP,           /* Lookup a displacement map */
 946    SVGA3D_DECLMETHOD_LOOKUPPRESAMPLED, /* Lookup a pre-sampled displacement map */
 947 } SVGA3dDeclMethod;
 948
 949 typedef enum {
 950    SVGA3D_DECLTYPE_FLOAT1        =  0,
 951    SVGA3D_DECLTYPE_FLOAT2        =  1,
 952    SVGA3D_DECLTYPE_FLOAT3        =  2,
 953    SVGA3D_DECLTYPE_FLOAT4        =  3,
 954    SVGA3D_DECLTYPE_D3DCOLOR      =  4,
 955    SVGA3D_DECLTYPE_UBYTE4        =  5,
 956    SVGA3D_DECLTYPE_SHORT2        =  6,
 957    SVGA3D_DECLTYPE_SHORT4        =  7,
 958    SVGA3D_DECLTYPE_UBYTE4N       =  8,
 959    SVGA3D_DECLTYPE_SHORT2N       =  9,
 960    SVGA3D_DECLTYPE_SHORT4N       = 10,
 961    SVGA3D_DECLTYPE_USHORT2N      = 11,
 962    SVGA3D_DECLTYPE_USHORT4N      = 12,
 963    SVGA3D_DECLTYPE_UDEC3         = 13,
 964    SVGA3D_DECLTYPE_DEC3N         = 14,
 965    SVGA3D_DECLTYPE_FLOAT16_2     = 15,
 966    SVGA3D_DECLTYPE_FLOAT16_4     = 16,
 967    SVGA3D_DECLTYPE_MAX,
 968 } SVGA3dDeclType;
 969
 970 /*
 971  * This structure is used for the divisor for geometry instancing;
 972  * it's a direct translation of the Direct3D equivalent.
 973  */
 974 typedef union {
 975    struct {
 976       /*
 977        * For index data, this number represents the number of instances to draw.
 978        * For instance data, this number represents the number of
 979        * instances/vertex in this stream
 980        */
 981       uint32 count : 30;
 982
 983       /*
 984        * This is 1 if this is supposed to be the data that is repeated for
 985        * every instance.
 986        */
 987       uint32 indexedData : 1;
 988
 989       /*
 990        * This is 1 if this is supposed to be the per-instance data.
 991        */
 992       uint32 instanceData : 1;
 993    };
 994
 995    uint32 value;
 996 } SVGA3dVertexDivisor;
 997
 998 typedef enum {
 999    SVGA3D_PRIMITIVE_INVALID                     = 0,
1000    SVGA3D_PRIMITIVE_TRIANGLELIST                = 1,
1001    SVGA3D_PRIMITIVE_POINTLIST                   = 2,
1002    SVGA3D_PRIMITIVE_LINELIST                    = 3,
1003    SVGA3D_PRIMITIVE_LINESTRIP                   = 4,
1004    SVGA3D_PRIMITIVE_TRIANGLESTRIP               = 5,
1005    SVGA3D_PRIMITIVE_TRIANGLEFAN                 = 6,
1006    SVGA3D_PRIMITIVE_MAX
1007 } SVGA3dPrimitiveType;
1008
1009 typedef enum {
1010    SVGA3D_COORDINATE_INVALID                   = 0,
1011    SVGA3D_COORDINATE_LEFTHANDED                = 1,
1012    SVGA3D_COORDINATE_RIGHTHANDED               = 2,
1013    SVGA3D_COORDINATE_MAX
1014 } SVGA3dCoordinateType;
1015
1016 typedef enum {
1017    SVGA3D_TRANSFORM_INVALID                     = 0,
1018    SVGA3D_TRANSFORM_WORLD                       = 1,
1019    SVGA3D_TRANSFORM_VIEW                        = 2,
1020    SVGA3D_TRANSFORM_PROJECTION                  = 3,
1021    SVGA3D_TRANSFORM_TEXTURE0                    = 4,
1022    SVGA3D_TRANSFORM_TEXTURE1                    = 5,
1023    SVGA3D_TRANSFORM_TEXTURE2                    = 6,
1024    SVGA3D_TRANSFORM_TEXTURE3                    = 7,
1025    SVGA3D_TRANSFORM_TEXTURE4                    = 8,
1026    SVGA3D_TRANSFORM_TEXTURE5                    = 9,
1027    SVGA3D_TRANSFORM_TEXTURE6                    = 10,
1028    SVGA3D_TRANSFORM_TEXTURE7                    = 11,
1029    SVGA3D_TRANSFORM_WORLD1                      = 12,
1030    SVGA3D_TRANSFORM_WORLD2                      = 13,
1031    SVGA3D_TRANSFORM_WORLD3                      = 14,
1032    SVGA3D_TRANSFORM_MAX
1033 } SVGA3dTransformType;
1034
1035 typedef enum {
1036    SVGA3D_LIGHTTYPE_INVALID                     = 0,
1037    SVGA3D_LIGHTTYPE_POINT                       = 1,
1038    SVGA3D_LIGHTTYPE_SPOT1                       = 2, /* 1-cone, in degrees */
1039    SVGA3D_LIGHTTYPE_SPOT2                       = 3, /* 2-cone, in radians */
1040    SVGA3D_LIGHTTYPE_DIRECTIONAL                 = 4,
1041    SVGA3D_LIGHTTYPE_MAX
1042 } SVGA3dLightType;
1043
1044 typedef enum {
1045    SVGA3D_CUBEFACE_POSX                         = 0,
1046    SVGA3D_CUBEFACE_NEGX                         = 1,
1047    SVGA3D_CUBEFACE_POSY                         = 2,
1048    SVGA3D_CUBEFACE_NEGY                         = 3,
1049    SVGA3D_CUBEFACE_POSZ                         = 4,
1050    SVGA3D_CUBEFACE_NEGZ                         = 5,
1051 } SVGA3dCubeFace;
1052
1053 typedef enum {
1054    SVGA3D_SHADERTYPE_INVALID                    = 0,
1055    SVGA3D_SHADERTYPE_MIN                        = 1,
1056    SVGA3D_SHADERTYPE_VS                         = 1,
1057    SVGA3D_SHADERTYPE_PS                         = 2,
1058    SVGA3D_SHADERTYPE_MAX                        = 3,
1059    SVGA3D_SHADERTYPE_GS                         = 3,
1060 } SVGA3dShaderType;
1061
1062 #define SVGA3D_NUM_SHADERTYPE (SVGA3D_SHADERTYPE_MAX - SVGA3D_SHADERTYPE_MIN)
1063
1064 typedef enum {
1065    SVGA3D_CONST_TYPE_FLOAT                      = 0,
1066    SVGA3D_CONST_TYPE_INT                        = 1,
1067    SVGA3D_CONST_TYPE_BOOL                       = 2,
1068    SVGA3D_CONST_TYPE_MAX
1069 } SVGA3dShaderConstType;
1070
1071 #define SVGA3D_MAX_SURFACE_FACES                6
1072
1073 typedef enum {
1074    SVGA3D_STRETCH_BLT_POINT                     = 0,
1075    SVGA3D_STRETCH_BLT_LINEAR                    = 1,
1076    SVGA3D_STRETCH_BLT_MAX
1077 } SVGA3dStretchBltMode;
1078
1079 typedef enum {
1080    SVGA3D_QUERYTYPE_OCCLUSION                   = 0,
1081    SVGA3D_QUERYTYPE_MAX
1082 } SVGA3dQueryType;
1083
1084 typedef enum {
1085    SVGA3D_QUERYSTATE_PENDING     = 0,      /* Waiting on the host (set by guest) */
1086    SVGA3D_QUERYSTATE_SUCCEEDED   = 1,      /* Completed successfully (set by host) */
1087    SVGA3D_QUERYSTATE_FAILED      = 2,      /* Completed unsuccessfully (set by host) */
1088    SVGA3D_QUERYSTATE_NEW         = 3,      /* Never submitted (For guest use only) */
1089 } SVGA3dQueryState;
1090
1091 typedef enum {
1092    SVGA3D_WRITE_HOST_VRAM        = 1,
1093    SVGA3D_READ_HOST_VRAM         = 2,
1094 } SVGA3dTransferType;
1095
1096 /*
1097  * The maximum number of vertex arrays we're guaranteed to support in
1098  * SVGA_3D_CMD_DRAWPRIMITIVES.
1099  */
1100 #define SVGA3D_MAX_VERTEX_ARRAYS   32
1101
1102 /*
1103  * The maximum number of primitive ranges we're guaranteed to support
1104  * in SVGA_3D_CMD_DRAWPRIMITIVES.
1105  */
1106 #define SVGA3D_MAX_DRAW_PRIMITIVE_RANGES 32
1107
1108 /*
1109  * Identifiers for commands in the command FIFO.
1110  *
1111  * IDs between 1000 and 1039 (inclusive) were used by obsolete versions of
1112  * the SVGA3D protocol and remain reserved; they should not be used in the
1113  * future.
1114  *
1115  * IDs between 1040 and 1999 (inclusive) are available for use by the
1116  * current SVGA3D protocol.
1117  *
1118  * FIFO clients other than SVGA3D should stay below 1000, or at 2000
1119  * and up.
1120  */
1121
1122 #define SVGA_3D_CMD_LEGACY_BASE            1000
1123 #define SVGA_3D_CMD_BASE                   1040
1124
1125 #define SVGA_3D_CMD_SURFACE_DEFINE         SVGA_3D_CMD_BASE + 0     /* Deprecated */
1126 #define SVGA_3D_CMD_SURFACE_DESTROY        SVGA_3D_CMD_BASE + 1
1127 #define SVGA_3D_CMD_SURFACE_COPY           SVGA_3D_CMD_BASE + 2
1128 #define SVGA_3D_CMD_SURFACE_STRETCHBLT     SVGA_3D_CMD_BASE + 3
1129 #define SVGA_3D_CMD_SURFACE_DMA            SVGA_3D_CMD_BASE + 4
1130 #define SVGA_3D_CMD_CONTEXT_DEFINE         SVGA_3D_CMD_BASE + 5
1131 #define SVGA_3D_CMD_CONTEXT_DESTROY        SVGA_3D_CMD_BASE + 6
1132 #define SVGA_3D_CMD_SETTRANSFORM           SVGA_3D_CMD_BASE + 7
1133 #define SVGA_3D_CMD_SETZRANGE              SVGA_3D_CMD_BASE + 8
1134 #define SVGA_3D_CMD_SETRENDERSTATE         SVGA_3D_CMD_BASE + 9
1135 #define SVGA_3D_CMD_SETRENDERTARGET        SVGA_3D_CMD_BASE + 10
1136 #define SVGA_3D_CMD_SETTEXTURESTATE        SVGA_3D_CMD_BASE + 11
1137 #define SVGA_3D_CMD_SETMATERIAL            SVGA_3D_CMD_BASE + 12
1138 #define SVGA_3D_CMD_SETLIGHTDATA           SVGA_3D_CMD_BASE + 13
1139 #define SVGA_3D_CMD_SETLIGHTENABLED        SVGA_3D_CMD_BASE + 14
1140 #define SVGA_3D_CMD_SETVIEWPORT            SVGA_3D_CMD_BASE + 15
1141 #define SVGA_3D_CMD_SETCLIPPLANE           SVGA_3D_CMD_BASE + 16
1142 #define SVGA_3D_CMD_CLEAR                  SVGA_3D_CMD_BASE + 17
1143 #define SVGA_3D_CMD_PRESENT                SVGA_3D_CMD_BASE + 18    /* Deprecated */
1144 #define SVGA_3D_CMD_SHADER_DEFINE          SVGA_3D_CMD_BASE + 19
1145 #define SVGA_3D_CMD_SHADER_DESTROY         SVGA_3D_CMD_BASE + 20
1146 #define SVGA_3D_CMD_SET_SHADER             SVGA_3D_CMD_BASE + 21
1147 #define SVGA_3D_CMD_SET_SHADER_CONST       SVGA_3D_CMD_BASE + 22
1148 #define SVGA_3D_CMD_DRAW_PRIMITIVES        SVGA_3D_CMD_BASE + 23
1149 #define SVGA_3D_CMD_SETSCISSORRECT         SVGA_3D_CMD_BASE + 24
1150 #define SVGA_3D_CMD_BEGIN_QUERY            SVGA_3D_CMD_BASE + 25
1151 #define SVGA_3D_CMD_END_QUERY              SVGA_3D_CMD_BASE + 26
1152 #define SVGA_3D_CMD_WAIT_FOR_QUERY         SVGA_3D_CMD_BASE + 27
1153 #define SVGA_3D_CMD_PRESENT_READBACK       SVGA_3D_CMD_BASE + 28    /* Deprecated */
1154 #define SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN SVGA_3D_CMD_BASE + 29
1155 #define SVGA_3D_CMD_SURFACE_DEFINE_V2      SVGA_3D_CMD_BASE + 30
1156 #define SVGA_3D_CMD_GENERATE_MIPMAPS       SVGA_3D_CMD_BASE + 31
1157 #define SVGA_3D_CMD_ACTIVATE_SURFACE       SVGA_3D_CMD_BASE + 40
1158 #define SVGA_3D_CMD_DEACTIVATE_SURFACE     SVGA_3D_CMD_BASE + 41
1159 #define SVGA_3D_CMD_SCREEN_DMA               1082
1160 #define SVGA_3D_CMD_SET_UNITY_SURFACE_COOKIE 1083
1161 #define SVGA_3D_CMD_OPEN_CONTEXT_SURFACE     1084
1162
1163 #define SVGA_3D_CMD_LOGICOPS_BITBLT          1085
1164 #define SVGA_3D_CMD_LOGICOPS_TRANSBLT        1086
1165 #define SVGA_3D_CMD_LOGICOPS_STRETCHBLT      1087
1166 #define SVGA_3D_CMD_LOGICOPS_COLORFILL       1088
1167 #define SVGA_3D_CMD_LOGICOPS_ALPHABLEND      1089
1168 #define SVGA_3D_CMD_LOGICOPS_CLEARTYPEBLEND  1090
1169
1170 #define SVGA_3D_CMD_SET_OTABLE_BASE          1091
1171 #define SVGA_3D_CMD_READBACK_OTABLE          1092
1172
1173 #define SVGA_3D_CMD_DEFINE_GB_MOB            1093
1174 #define SVGA_3D_CMD_DESTROY_GB_MOB           1094
1175 #define SVGA_3D_CMD_REDEFINE_GB_MOB          1095
1176 #define SVGA_3D_CMD_UPDATE_GB_MOB_MAPPING    1096
1177
1178 #define SVGA_3D_CMD_DEFINE_GB_SURFACE        1097
1179 #define SVGA_3D_CMD_DESTROY_GB_SURFACE       1098
1180 #define SVGA_3D_CMD_BIND_GB_SURFACE          1099
1181 #define SVGA_3D_CMD_COND_BIND_GB_SURFACE     1100
1182 #define SVGA_3D_CMD_UPDATE_GB_IMAGE          1101
1183 #define SVGA_3D_CMD_UPDATE_GB_SURFACE        1102
1184 #define SVGA_3D_CMD_READBACK_GB_IMAGE        1103
1185 #define SVGA_3D_CMD_READBACK_GB_SURFACE      1104
1186 #define SVGA_3D_CMD_INVALIDATE_GB_IMAGE      1105
1187 #define SVGA_3D_CMD_INVALIDATE_GB_SURFACE    1106
1188
1189 #define SVGA_3D_CMD_DEFINE_GB_CONTEXT        1107
1190 #define SVGA_3D_CMD_DESTROY_GB_CONTEXT       1108
1191 #define SVGA_3D_CMD_BIND_GB_CONTEXT          1109
1192 #define SVGA_3D_CMD_READBACK_GB_CONTEXT      1110
1193 #define SVGA_3D_CMD_INVALIDATE_GB_CONTEXT    1111
1194
1195 #define SVGA_3D_CMD_DEFINE_GB_SHADER         1112
1196 #define SVGA_3D_CMD_DESTROY_GB_SHADER        1113
1197 #define SVGA_3D_CMD_BIND_GB_SHADER           1114
1198
1199 #define SVGA_3D_CMD_SET_OTABLE_BASE64        1115
1200
1201 #define SVGA_3D_CMD_BEGIN_GB_QUERY           1116
1202 #define SVGA_3D_CMD_END_GB_QUERY             1117
1203 #define SVGA_3D_CMD_WAIT_FOR_GB_QUERY        1118
1204
1205 #define SVGA_3D_CMD_NOP                      1119
1206
1207 #define SVGA_3D_CMD_ENABLE_GART              1120
1208 #define SVGA_3D_CMD_DISABLE_GART             1121
1209 #define SVGA_3D_CMD_MAP_MOB_INTO_GART        1122
1210 #define SVGA_3D_CMD_UNMAP_GART_RANGE         1123
1211
1212 #define SVGA_3D_CMD_DEFINE_GB_SCREENTARGET   1124
1213 #define SVGA_3D_CMD_DESTROY_GB_SCREENTARGET  1125
1214 #define SVGA_3D_CMD_BIND_GB_SCREENTARGET     1126
1215 #define SVGA_3D_CMD_UPDATE_GB_SCREENTARGET   1127
1216
1217 #define SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL   1128
1218 #define SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL 1129
1219
1220 #define SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE  1130
1221 #define SVGA_3D_CMD_GB_SCREEN_DMA               1131
1222 #define SVGA_3D_CMD_BIND_GB_SURFACE_WITH_PITCH  1132
1223 #define SVGA_3D_CMD_GB_MOB_FENCE                1133
1224 #define SVGA_3D_CMD_DEFINE_GB_SURFACE_V2        1134
1225 #define SVGA_3D_CMD_DEFINE_GB_MOB64          1135
1226 #define SVGA_3D_CMD_REDEFINE_GB_MOB64        1136
1227 #define SVGA_3D_CMD_NOP_ERROR                1137
1228
1229 #define SVGA_3D_CMD_RESERVED1                1138
1230 #define SVGA_3D_CMD_RESERVED2                1139
1231 #define SVGA_3D_CMD_RESERVED3                1140
1232 #define SVGA_3D_CMD_RESERVED4                1141
1233 #define SVGA_3D_CMD_RESERVED5                1142
1234
1235 #define SVGA_3D_CMD_MAX                      1142
1236 #define SVGA_3D_CMD_FUTURE_MAX               3000
1237
1238 /*
1239  * Common substructures used in multiple FIFO commands:
1240  */
1241
1242 typedef struct {
1243    union {
1244       struct {
1245          uint16  function;       /* SVGA3dFogFunction */
1246          uint8   type;           /* SVGA3dFogType */
1247          uint8   base;           /* SVGA3dFogBase */
1248       };
1249       uint32     uintValue;
1250    };
1251 } SVGA3dFogMode;
1252
1253 /*
1254  * Uniquely identify one image (a 1D/2D/3D array) from a surface. This
1255  * is a surface ID as well as face/mipmap indices.
1256  */
1257
1258 typedef
1259 struct SVGA3dSurfaceImageId {
1260    uint32               sid;
1261    uint32               face;
1262    uint32               mipmap;
1263 } SVGA3dSurfaceImageId;
1264
1265 typedef
1266 struct SVGA3dGuestImage {
1267    SVGAGuestPtr         ptr;
1268
1269    /*
1270     * A note on interpretation of pitch: This value of pitch is the
1271     * number of bytes between vertically adjacent image
1272     * blocks. Normally this is the number of bytes between the first
1273     * pixel of two adjacent scanlines. With compressed textures,
1274     * however, this may represent the number of bytes between
1275     * compression blocks rather than between rows of pixels.
1276     *
1277     * XXX: Compressed textures currently must be tightly packed in guest memory.
1278     *
1279     * If the image is 1-dimensional, pitch is ignored.
1280     *
1281     * If 'pitch' is zero, the SVGA3D device calculates a pitch value
1282     * assuming each row of blocks is tightly packed.
1283     */
1284    uint32 pitch;
1285 } SVGA3dGuestImage;
1286
1287
1288 /*
1289  * FIFO command format definitions:
1290  */
1291
1292 /*
1293  * The data size header following cmdNum for every 3d command
1294  */
1295 typedef
1296 struct {
1297    uint32               id;
1298    uint32               size;
1299 } SVGA3dCmdHeader;
1300
1301 /*
1302  * A surface is a hierarchy of host VRAM surfaces: 1D, 2D, or 3D, with
1303  * optional mipmaps and cube faces.
1304  */
1305
1306 typedef
1307 struct {
1308    uint32               width;
1309    uint32               height;
1310    uint32               depth;
1311 } SVGA3dSize;
1312
1313 typedef enum {
1314    SVGA3D_SURFACE_CUBEMAP              = (1 << 0),
1315
1316    /*
1317     * HINT flags are not enforced by the device but are useful for
1318     * performance.
1319     */
1320    SVGA3D_SURFACE_HINT_STATIC          = (1 << 1),
1321    SVGA3D_SURFACE_HINT_DYNAMIC         = (1 << 2),
1322    SVGA3D_SURFACE_HINT_INDEXBUFFER     = (1 << 3),
1323    SVGA3D_SURFACE_HINT_VERTEXBUFFER    = (1 << 4),
1324    SVGA3D_SURFACE_HINT_TEXTURE         = (1 << 5),
1325    SVGA3D_SURFACE_HINT_RENDERTARGET    = (1 << 6),
1326    SVGA3D_SURFACE_HINT_DEPTHSTENCIL    = (1 << 7),
1327    SVGA3D_SURFACE_HINT_WRITEONLY       = (1 << 8),
1328    SVGA3D_SURFACE_MASKABLE_ANTIALIAS   = (1 << 9),
1329    SVGA3D_SURFACE_AUTOGENMIPMAPS       = (1 << 10),
1330    SVGA3D_SURFACE_DECODE_RENDERTARGET   = (1 << 11),
1331
1332    /*
1333     * Is this surface using a base-level pitch for it's mob backing?
1334     *
1335     * This flag is not intended to be set by guest-drivers, but is instead
1336     * set by the device when the surface is bound to a mob with a specified
1337     * pitch.
1338     */
1339    SVGA3D_SURFACE_MOB_PITCH             = (1 << 12),
1340
1341    SVGA3D_SURFACE_INACTIVE              = (1 << 13),
1342    SVGA3D_SURFACE_HINT_RT_LOCKABLE      = (1 << 14),
1343    SVGA3D_SURFACE_VOLUME                = (1 << 15),
1344
1345    /*
1346     * Required to be set on a surface to bind it to a screen target.
1347     */
1348    SVGA3D_SURFACE_SCREENTARGET          = (1 << 16),
1349
1350    /*
1351     * Align images in the guest-backing mob to 16-bytes.
1352     */
1353    SVGA3D_SURFACE_ALIGN16               = (1 << 17),
1354
1355    SVGA3D_SURFACE_1D                    = (1 << 18),
1356    SVGA3D_SURFACE_ARRAY                 = (1 << 19),
1357
1358    /*
1359     * Bind flags.
1360     * These are enforced for any surface defined with DefineGBSurface_v2.
1361     */
1362    SVGA3D_SURFACE_BIND_VERTEX_BUFFER    = (1 << 20),
1363    SVGA3D_SURFACE_BIND_INDEX_BUFFER     = (1 << 21),
1364    SVGA3D_SURFACE_BIND_CONSTANT_BUFFER  = (1 << 22),
1365    SVGA3D_SURFACE_BIND_SHADER_RESOURCE  = (1 << 23),
1366    SVGA3D_SURFACE_BIND_RENDER_TARGET    = (1 << 24),
1367    SVGA3D_SURFACE_BIND_DEPTH_STENCIL    = (1 << 25),
1368    SVGA3D_SURFACE_BIND_STREAM_OUTPUT    = (1 << 26),
1369
1370    /*
1371     * Marker for the last defined bit.
1372     */
1373    SVGA3D_SURFACE_FLAG_MAX              = (1 << 27),
1374 } SVGA3dSurfaceFlags;
1375
1376 typedef
1377 struct {
1378    uint32               numMipLevels;
1379 } SVGA3dSurfaceFace;
1380
1381 typedef
1382 struct {
1383    uint32                      sid;
1384    SVGA3dSurfaceFlags          surfaceFlags;
1385    SVGA3dSurfaceFormat         format;
1386    /*
1387     * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
1388     * structures must have the same value of numMipLevels field.
1389     * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
1390     * numMipLevels set to 0.
1391     */
1392    SVGA3dSurfaceFace           face[SVGA3D_MAX_SURFACE_FACES];
1393    /*
1394     * Followed by an SVGA3dSize structure for each mip level in each face.
1395     *
1396     * A note on surface sizes: Sizes are always specified in pixels,
1397     * even if the true surface size is not a multiple of the minimum
1398     * block size of the surface's format. For example, a 3x3x1 DXT1
1399     * compressed texture would actually be stored as a 4x4x1 image in
1400     * memory.
1401     */
1402 } SVGA3dCmdDefineSurface;       /* SVGA_3D_CMD_SURFACE_DEFINE */
1403
1404 typedef
1405 struct {
1406    uint32                      sid;
1407    SVGA3dSurfaceFlags          surfaceFlags;
1408    SVGA3dSurfaceFormat         format;
1409    /*
1410     * If surfaceFlags has SVGA3D_SURFACE_CUBEMAP bit set, all SVGA3dSurfaceFace
1411     * structures must have the same value of numMipLevels field.
1412     * Otherwise, all but the first SVGA3dSurfaceFace structures must have the
1413     * numMipLevels set to 0.
1414     */
1415    SVGA3dSurfaceFace           face[SVGA3D_MAX_SURFACE_FACES];
1416    uint32                      multisampleCount;
1417    SVGA3dTextureFilter         autogenFilter;
1418    /*
1419     * Followed by an SVGA3dSize structure for each mip level in each face.
1420     *
1421     * A note on surface sizes: Sizes are always specified in pixels,
1422     * even if the true surface size is not a multiple of the minimum
1423     * block size of the surface's format. For example, a 3x3x1 DXT1
1424     * compressed texture would actually be stored as a 4x4x1 image in
1425     * memory.
1426     */
1427 } SVGA3dCmdDefineSurface_v2;     /* SVGA_3D_CMD_SURFACE_DEFINE_V2 */
1428
1429 typedef
1430 struct {
1431    uint32               sid;
1432 } SVGA3dCmdDestroySurface;      /* SVGA_3D_CMD_SURFACE_DESTROY */
1433
1434 typedef
1435 struct {
1436    uint32               cid;
1437 } SVGA3dCmdDefineContext;       /* SVGA_3D_CMD_CONTEXT_DEFINE */
1438
1439 typedef
1440 struct {
1441    uint32               cid;
1442 } SVGA3dCmdDestroyContext;      /* SVGA_3D_CMD_CONTEXT_DESTROY */
1443
1444 typedef
1445 struct {
1446    uint32               cid;
1447    SVGA3dClearFlag      clearFlag;
1448    uint32               color;
1449    float                depth;
1450    uint32               stencil;
1451    /* Followed by variable number of SVGA3dRect structures */
1452 } SVGA3dCmdClear;               /* SVGA_3D_CMD_CLEAR */
1453
1454 typedef
1455 struct SVGA3dCopyRect {
1456    uint32               x;
1457    uint32               y;
1458    uint32               w;
1459    uint32               h;
1460    uint32               srcx;
1461    uint32               srcy;
1462 } SVGA3dCopyRect;
1463
1464 typedef
1465 struct SVGA3dCopyBox {
1466    uint32               x;
1467    uint32               y;
1468    uint32               z;
1469    uint32               w;
1470    uint32               h;
1471    uint32               d;
1472    uint32               srcx;
1473    uint32               srcy;
1474    uint32               srcz;
1475 } SVGA3dCopyBox;
1476
1477 typedef
1478 struct {
1479    uint32               x;
1480    uint32               y;
1481    uint32               w;
1482    uint32               h;
1483 } SVGA3dRect;
1484
1485 typedef
1486 struct {
1487    uint32               x;
1488    uint32               y;
1489    uint32               z;
1490    uint32               w;
1491    uint32               h;
1492    uint32               d;
1493 } SVGA3dBox;
1494
1495 typedef
1496 struct {
1497    uint32               x;
1498    uint32               y;
1499    uint32               z;
1500 } SVGA3dPoint;
1501
1502 typedef
1503 struct {
1504    SVGA3dLightType      type;
1505    SVGA3dBool           inWorldSpace;
1506    float                diffuse[4];
1507    float                specular[4];
1508    float                ambient[4];
1509    float                position[4];
1510    float                direction[4];
1511    float                range;
1512    float                falloff;
1513    float                attenuation0;
1514    float                attenuation1;
1515    float                attenuation2;
1516    float                theta;
1517    float                phi;
1518 } SVGA3dLightData;
1519
1520 typedef
1521 struct {
1522    uint32               sid;
1523    /* Followed by variable number of SVGA3dCopyRect structures */
1524 } SVGA3dCmdPresent;             /* SVGA_3D_CMD_PRESENT */
1525
1526 typedef
1527 struct {
1528    SVGA3dRenderStateName   state;
1529    union {
1530       uint32               uintValue;
1531       float                floatValue;
1532    };
1533 } SVGA3dRenderState;
1534
1535 typedef
1536 struct {
1537    uint32               cid;
1538    /* Followed by variable number of SVGA3dRenderState structures */
1539 } SVGA3dCmdSetRenderState;      /* SVGA_3D_CMD_SETRENDERSTATE */
1540
1541 typedef
1542 struct {
1543    uint32                 cid;
1544    SVGA3dRenderTargetType type;
1545    SVGA3dSurfaceImageId   target;
1546 } SVGA3dCmdSetRenderTarget;     /* SVGA_3D_CMD_SETRENDERTARGET */
1547
1548 typedef
1549 struct {
1550    SVGA3dSurfaceImageId  src;
1551    SVGA3dSurfaceImageId  dest;
1552    /* Followed by variable number of SVGA3dCopyBox structures */
1553 } SVGA3dCmdSurfaceCopy;               /* SVGA_3D_CMD_SURFACE_COPY */
1554
1555 typedef
1556 struct {
1557    SVGA3dSurfaceImageId  src;
1558    SVGA3dSurfaceImageId  dest;
1559    SVGA3dBox             boxSrc;
1560    SVGA3dBox             boxDest;
1561    SVGA3dStretchBltMode  mode;
1562 } SVGA3dCmdSurfaceStretchBlt;         /* SVGA_3D_CMD_SURFACE_STRETCHBLT */
1563
1564 typedef
1565 struct {
1566    /*
1567     * If the discard flag is present in a surface DMA operation, the host may
1568     * discard the contents of the current mipmap level and face of the target
1569     * surface before applying the surface DMA contents.
1570     */
1571    uint32 discard : 1;
1572
1573    /*
1574     * If the unsynchronized flag is present, the host may perform this upload
1575     * without syncing to pending reads on this surface.
1576     */
1577    uint32 unsynchronized : 1;
1578
1579    /*
1580     * Guests *MUST* set the reserved bits to 0 before submitting the command
1581     * suffix as future flags may occupy these bits.
1582     */
1583    uint32 reserved : 30;
1584 } SVGA3dSurfaceDMAFlags;
1585
1586 typedef
1587 struct {
1588    SVGA3dGuestImage      guest;
1589    SVGA3dSurfaceImageId  host;
1590    SVGA3dTransferType    transfer;
1591    /*
1592     * Followed by variable number of SVGA3dCopyBox structures. For consistency
1593     * in all clipping logic and coordinate translation, we define the
1594     * "source" in each copyBox as the guest image and the
1595     * "destination" as the host image, regardless of transfer
1596     * direction.
1597     *
1598     * For efficiency, the SVGA3D device is free to copy more data than
1599     * specified. For example, it may round copy boxes outwards such
1600     * that they lie on particular alignment boundaries.
1601     */
1602 } SVGA3dCmdSurfaceDMA;                /* SVGA_3D_CMD_SURFACE_DMA */
1603
1604 /*
1605  * SVGA3dCmdSurfaceDMASuffix --
1606  *
1607  *    This is a command suffix that will appear after a SurfaceDMA command in
1608  *    the FIFO.  It contains some extra information that hosts may use to
1609  *    optimize performance or protect the guest.  This suffix exists to preserve
1610  *    backwards compatibility while also allowing for new functionality to be
1611  *    implemented.
1612  */
1613
1614 typedef
1615 struct {
1616    uint32 suffixSize;
1617
1618    /*
1619     * The maximum offset is used to determine the maximum offset from the
1620     * guestPtr base address that will be accessed or written to during this
1621     * surfaceDMA.  If the suffix is supported, the host will respect this
1622     * boundary while performing surface DMAs.
1623     *
1624     * Defaults to MAX_UINT32
1625     */
1626    uint32 maximumOffset;
1627
1628    /*
1629     * A set of flags that describes optimizations that the host may perform
1630     * while performing this surface DMA operation.  The guest should never rely
1631     * on behaviour that is different when these flags are set for correctness.
1632     *
1633     * Defaults to 0
1634     */
1635    SVGA3dSurfaceDMAFlags flags;
1636 } SVGA3dCmdSurfaceDMASuffix;
1637
1638 /*
1639  * SVGA_3D_CMD_DRAW_PRIMITIVES --
1640  *
1641  *   This command is the SVGA3D device's generic drawing entry point.
1642  *   It can draw multiple ranges of primitives, optionally using an
1643  *   index buffer, using an arbitrary collection of vertex buffers.
1644  *
1645  *   Each SVGA3dVertexDecl defines a distinct vertex array to bind
1646  *   during this draw call. The declarations specify which surface
1647  *   the vertex data lives in, what that vertex data is used for,
1648  *   and how to interpret it.
1649  *
1650  *   Each SVGA3dPrimitiveRange defines a collection of primitives
1651  *   to render using the same vertex arrays. An index buffer is
1652  *   optional.
1653  */
1654
1655 typedef
1656 struct {
1657    /*
1658     * A range hint is an optional specification for the range of indices
1659     * in an SVGA3dArray that will be used. If 'last' is zero, it is assumed
1660     * that the entire array will be used.
1661     *
1662     * These are only hints. The SVGA3D device may use them for
1663     * performance optimization if possible, but it's also allowed to
1664     * ignore these values.
1665     */
1666    uint32               first;
1667    uint32               last;
1668 } SVGA3dArrayRangeHint;
1669
1670 typedef
1671 struct {
1672    /*
1673     * Define the origin and shape of a vertex or index array. Both
1674     * 'offset' and 'stride' are in bytes. The provided surface will be
1675     * reinterpreted as a flat array of bytes in the same format used
1676     * by surface DMA operations. To avoid unnecessary conversions, the
1677     * surface should be created with the SVGA3D_BUFFER format.
1678     *
1679     * Index 0 in the array starts 'offset' bytes into the surface.
1680     * Index 1 begins at byte 'offset + stride', etc. Array indices may
1681     * not be negative.
1682     */
1683    uint32               surfaceId;
1684    uint32               offset;
1685    uint32               stride;
1686 } SVGA3dArray;
1687
1688 typedef
1689 struct {
1690    /*
1691     * Describe a vertex array's data type, and define how it is to be
1692     * used by the fixed function pipeline or the vertex shader. It
1693     * isn't useful to have two VertexDecls with the same
1694     * VertexArrayIdentity in one draw call.
1695     */
1696    SVGA3dDeclType       type;
1697    SVGA3dDeclMethod     method;
1698    SVGA3dDeclUsage      usage;
1699    uint32               usageIndex;
1700 } SVGA3dVertexArrayIdentity;
1701
1702 typedef
1703 struct {
1704    SVGA3dVertexArrayIdentity  identity;
1705    SVGA3dArray                array;
1706    SVGA3dArrayRangeHint       rangeHint;
1707 } SVGA3dVertexDecl;
1708
1709 typedef
1710 struct {
1711    /*
1712     * Define a group of primitives to render, from sequential indices.
1713     *
1714     * The value of 'primitiveType' and 'primitiveCount' imply the
1715     * total number of vertices that will be rendered.
1716     */
1717    SVGA3dPrimitiveType  primType;
1718    uint32               primitiveCount;
1719
1720    /*
1721     * Optional index buffer. If indexArray.surfaceId is
1722     * SVGA3D_INVALID_ID, we render without an index buffer. Rendering
1723     * without an index buffer is identical to rendering with an index
1724     * buffer containing the sequence [0, 1, 2, 3, ...].
1725     *
1726     * If an index buffer is in use, indexWidth specifies the width in
1727     * bytes of each index value. It must be less than or equal to
1728     * indexArray.stride.
1729     *
1730     * (Currently, the SVGA3D device requires index buffers to be tightly
1731     * packed. In other words, indexWidth == indexArray.stride)
1732     */
1733    SVGA3dArray          indexArray;
1734    uint32               indexWidth;
1735
1736    /*
1737     * Optional index bias. This number is added to all indices from
1738     * indexArray before they are used as vertex array indices. This
1739     * can be used in multiple ways:
1740     *
1741     *  - When not using an indexArray, this bias can be used to
1742     *    specify where in the vertex arrays to begin rendering.
1743     *
1744     *  - A positive number here is equivalent to increasing the
1745     *    offset in each vertex array.
1746     *
1747     *  - A negative number can be used to render using a small
1748     *    vertex array and an index buffer that contains large
1749     *    values. This may be used by some applications that
1750     *    crop a vertex buffer without modifying their index
1751     *    buffer.
1752     *
1753     * Note that rendering with a negative bias value may be slower and
1754     * use more memory than rendering with a positive or zero bias.
1755     */
1756    int32                indexBias;
1757 } SVGA3dPrimitiveRange;
1758
1759 typedef
1760 struct {
1761    uint32               cid;
1762    uint32               numVertexDecls;
1763    uint32               numRanges;
1764
1765    /*
1766     * There are two variable size arrays after the
1767     * SVGA3dCmdDrawPrimitives structure. In order,
1768     * they are:
1769     *
1770     * 1. SVGA3dVertexDecl, quantity 'numVertexDecls', but no more than
1771     *    SVGA3D_MAX_VERTEX_ARRAYS;
1772     * 2. SVGA3dPrimitiveRange, quantity 'numRanges', but no more than
1773     *    SVGA3D_MAX_DRAW_PRIMITIVE_RANGES;
1774     * 3. Optionally, SVGA3dVertexDivisor, quantity 'numVertexDecls' (contains
1775     *    the frequency divisor for the corresponding vertex decl).
1776     */
1777 } SVGA3dCmdDrawPrimitives;      /* SVGA_3D_CMD_DRAWPRIMITIVES */
1778
1779 typedef
1780 struct {
1781    uint32                   stage;
1782    SVGA3dTextureStateName   name;
1783    union {
1784       uint32                value;
1785       float                 floatValue;
1786    };
1787 } SVGA3dTextureState;
1788
1789 typedef
1790 struct {
1791    uint32               cid;
1792    /* Followed by variable number of SVGA3dTextureState structures */
1793 } SVGA3dCmdSetTextureState;      /* SVGA_3D_CMD_SETTEXTURESTATE */
1794
1795 typedef
1796 struct {
1797    uint32                   cid;
1798    SVGA3dTransformType      type;
1799    float                    matrix[16];
1800 } SVGA3dCmdSetTransform;          /* SVGA_3D_CMD_SETTRANSFORM */
1801
1802 typedef
1803 struct {
1804    float                min;
1805    float                max;
1806 } SVGA3dZRange;
1807
1808 typedef
1809 struct {
1810    uint32               cid;
1811    SVGA3dZRange         zRange;
1812 } SVGA3dCmdSetZRange;             /* SVGA_3D_CMD_SETZRANGE */
1813
1814 typedef
1815 struct {
1816    float                diffuse[4];
1817    float                ambient[4];
1818    float                specular[4];
1819    float                emissive[4];
1820    float                shininess;
1821 } SVGA3dMaterial;
1822
1823 typedef
1824 struct {
1825    uint32               cid;
1826    SVGA3dFace           face;
1827    SVGA3dMaterial       material;
1828 } SVGA3dCmdSetMaterial;           /* SVGA_3D_CMD_SETMATERIAL */
1829
1830 typedef
1831 struct {
1832    uint32               cid;
1833    uint32               index;
1834    SVGA3dLightData      data;
1835 } SVGA3dCmdSetLightData;           /* SVGA_3D_CMD_SETLIGHTDATA */
1836
1837 typedef
1838 struct {
1839    uint32               cid;
1840    uint32               index;
1841    uint32               enabled;
1842 } SVGA3dCmdSetLightEnabled;      /* SVGA_3D_CMD_SETLIGHTENABLED */
1843
1844 typedef
1845 struct {
1846    uint32               cid;
1847    SVGA3dRect           rect;
1848 } SVGA3dCmdSetViewport;           /* SVGA_3D_CMD_SETVIEWPORT */
1849
1850 typedef
1851 struct {
1852    uint32               cid;
1853    SVGA3dRect           rect;
1854 } SVGA3dCmdSetScissorRect;         /* SVGA_3D_CMD_SETSCISSORRECT */
1855
1856 typedef
1857 struct {
1858    uint32               cid;
1859    uint32               index;
1860    float                plane[4];
1861 } SVGA3dCmdSetClipPlane;           /* SVGA_3D_CMD_SETCLIPPLANE */
1862
1863 typedef
1864 struct {
1865    uint32               cid;
1866    uint32               shid;
1867    SVGA3dShaderType     type;
1868    /* Followed by variable number of DWORDs for shader bycode */
1869 } SVGA3dCmdDefineShader;           /* SVGA_3D_CMD_SHADER_DEFINE */
1870
1871 typedef
1872 struct {
1873    uint32               cid;
1874    uint32               shid;
1875    SVGA3dShaderType     type;
1876 } SVGA3dCmdDestroyShader;         /* SVGA_3D_CMD_SHADER_DESTROY */
1877
1878 typedef
1879 struct {
1880    uint32                  cid;
1881    uint32                  reg;     /* register number */
1882    SVGA3dShaderType        type;
1883    SVGA3dShaderConstType   ctype;
1884    uint32                  values[4];
1885 } SVGA3dCmdSetShaderConst;        /* SVGA_3D_CMD_SET_SHADER_CONST */
1886
1887 typedef
1888 struct {
1889    uint32               cid;
1890    SVGA3dShaderType     type;
1891    uint32               shid;
1892 } SVGA3dCmdSetShader;             /* SVGA_3D_CMD_SET_SHADER */
1893
1894 typedef
1895 struct {
1896    uint32               cid;
1897    SVGA3dQueryType      type;
1898 } SVGA3dCmdBeginQuery;           /* SVGA_3D_CMD_BEGIN_QUERY */
1899
1900 typedef
1901 struct {
1902    uint32               cid;
1903    SVGA3dQueryType      type;
1904    SVGAGuestPtr         guestResult;  /* Points to an SVGA3dQueryResult structure */
1905 } SVGA3dCmdEndQuery;                  /* SVGA_3D_CMD_END_QUERY */
1906
1907 typedef
1908 struct {
1909    uint32               cid;          /* Same parameters passed to END_QUERY */
1910    SVGA3dQueryType      type;
1911    SVGAGuestPtr         guestResult;
1912 } SVGA3dCmdWaitForQuery;              /* SVGA_3D_CMD_WAIT_FOR_QUERY */
1913
1914 typedef
1915 struct {
1916    uint32               totalSize;    /* Set by guest before query is ended. */
1917    SVGA3dQueryState     state;        /* Set by host or guest. See SVGA3dQueryState. */
1918    union {                            /* Set by host on exit from PENDING state */
1919       uint32            result32;
1920    };
1921 } SVGA3dQueryResult;
1922
1923 /*
1924  * SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN --
1925  *
1926  *    This is a blit from an SVGA3D surface to a Screen Object. Just
1927  *    like GMR-to-screen blits, this blit may be directed at a
1928  *    specific screen or to the virtual coordinate space.
1929  *
1930  *    The blit copies from a rectangular region of an SVGA3D surface
1931  *    image to a rectangular region of a screen or screens.
1932  *
1933  *    This command takes an optional variable-length list of clipping
1934  *    rectangles after the body of the command. If no rectangles are
1935  *    specified, there is no clipping region. The entire destRect is
1936  *    drawn to. If one or more rectangles are included, they describe
1937  *    a clipping region. The clip rectangle coordinates are measured
1938  *    relative to the top-left corner of destRect.
1939  *
1940  *    This clipping region serves multiple purposes:
1941  *
1942  *      - It can be used to perform an irregularly shaped blit more
1943  *        efficiently than by issuing many separate blit commands.
1944  *
1945  *      - It is equivalent to allowing blits with non-integer
1946  *        source coordinates. You could blit just one half-pixel
1947  *        of a source, for example, by specifying a larger
1948  *        destination rectangle than you need, then removing
1949  *        part of it using a clip rectangle.
1950  *
1951  * Availability:
1952  *    SVGA_FIFO_CAP_SCREEN_OBJECT
1953  *
1954  * Limitations:
1955  *
1956  *    - Currently, no backend supports blits from a mipmap or face
1957  *      other than the first one.
1958  */
1959
1960 typedef
1961 struct {
1962    SVGA3dSurfaceImageId srcImage;
1963    SVGASignedRect       srcRect;
1964    uint32               destScreenId; /* Screen ID or SVGA_ID_INVALID for virt. coords */
1965    SVGASignedRect       destRect;     /* Supports scaling if src/rest different size */
1966    /* Clipping: zero or more SVGASignedRects follow */
1967 } SVGA3dCmdBlitSurfaceToScreen;         /* SVGA_3D_CMD_BLIT_SURFACE_TO_SCREEN */
1968
1969 typedef
1970 struct {
1971    uint32               sid;
1972    SVGA3dTextureFilter  filter;
1973 } SVGA3dCmdGenerateMipmaps;             /* SVGA_3D_CMD_GENERATE_MIPMAPS */
1974
1975
1976 /*
1977  * Guest-backed surface definitions.
1978  */
1979
1980 typedef enum SVGAMobFormat {
1981    SVGA3D_MOBFMT_INVALID = SVGA3D_INVALID_ID,
1982    SVGA3D_MOBFMT_PTDEPTH_0 = 0,
1983    SVGA3D_MOBFMT_PTDEPTH_1 = 1,
1984    SVGA3D_MOBFMT_PTDEPTH_2 = 2,
1985    SVGA3D_MOBFMT_RANGE     = 3,
1986    SVGA3D_MOBFMT_PTDEPTH64_0 = 4,
1987    SVGA3D_MOBFMT_PTDEPTH64_1 = 5,
1988    SVGA3D_MOBFMT_PTDEPTH64_2 = 6,
1989    SVGA3D_MOBFMT_MAX,
1990 } SVGAMobFormat;
1991
1992 /*
1993  * Sizes of opaque types.
1994  */
1995
1996 #define SVGA3D_OTABLE_MOB_ENTRY_SIZE 16
1997 #define SVGA3D_OTABLE_CONTEXT_ENTRY_SIZE 8
1998 #define SVGA3D_OTABLE_SURFACE_ENTRY_SIZE 64
1999 #define SVGA3D_OTABLE_SHADER_ENTRY_SIZE 16
2000 #define SVGA3D_OTABLE_SCREEN_TARGET_ENTRY_SIZE 64
2001 #define SVGA3D_CONTEXT_DATA_SIZE 16384
2002
2003 /*
2004  * SVGA3dCmdSetOTableBase --
2005  *
2006  * This command allows the guest to specify the base PPN of the
2007  * specified object table.
2008  */
2009
2010 typedef enum {
2011    SVGA_OTABLE_MOB           = 0,
2012    SVGA_OTABLE_MIN           = 0,
2013    SVGA_OTABLE_SURFACE       = 1,
2014    SVGA_OTABLE_CONTEXT       = 2,
2015    SVGA_OTABLE_SHADER        = 3,
2016    SVGA_OTABLE_SCREEN_TARGET = 4,
2017    SVGA_OTABLE_DX9_MAX       = 5,
2018    SVGA_OTABLE_MAX           = 8
2019 } SVGAOTableType;
2020
2021 typedef
2022 struct {
2023    SVGAOTableType type;
2024    PPN baseAddress;
2025    uint32 sizeInBytes;
2026    uint32 validSizeInBytes;
2027    SVGAMobFormat ptDepth;
2028 } __packed
2029 SVGA3dCmdSetOTableBase;  /* SVGA_3D_CMD_SET_OTABLE_BASE */
2030
2031 typedef
2032 struct {
2033    SVGAOTableType type;
2034    PPN64 baseAddress;
2035    uint32 sizeInBytes;
2036    uint32 validSizeInBytes;
2037    SVGAMobFormat ptDepth;
2038 } __packed
2039 SVGA3dCmdSetOTableBase64;  /* SVGA_3D_CMD_SET_OTABLE_BASE64 */
2040
2041 typedef
2042 struct {
2043    SVGAOTableType type;
2044 } __packed
2045 SVGA3dCmdReadbackOTable;  /* SVGA_3D_CMD_READBACK_OTABLE */
2046
2047 /*
2048  * Define a memory object (Mob) in the OTable.
2049  */
2050
2051 typedef
2052 struct SVGA3dCmdDefineGBMob {
2053    SVGAMobId mobid;
2054    SVGAMobFormat ptDepth;
2055    PPN base;
2056    uint32 sizeInBytes;
2057 } __packed
2058 SVGA3dCmdDefineGBMob;   /* SVGA_3D_CMD_DEFINE_GB_MOB */
2059
2060
2061 /*
2062  * Destroys an object in the OTable.
2063  */
2064
2065 typedef
2066 struct SVGA3dCmdDestroyGBMob {
2067    SVGAMobId mobid;
2068 } __packed
2069 SVGA3dCmdDestroyGBMob;   /* SVGA_3D_CMD_DESTROY_GB_MOB */
2070
2071 /*
2072  * Redefine an object in the OTable.
2073  */
2074
2075 typedef
2076 struct SVGA3dCmdRedefineGBMob {
2077    SVGAMobId mobid;
2078    SVGAMobFormat ptDepth;
2079    PPN base;
2080    uint32 sizeInBytes;
2081 } __packed
2082 SVGA3dCmdRedefineGBMob;   /* SVGA_3D_CMD_REDEFINE_GB_MOB */
2083
2084 /*
2085  * Define a memory object (Mob) in the OTable with a PPN64 base.
2086  */
2087
2088 typedef
2089 struct SVGA3dCmdDefineGBMob64 {
2090    SVGAMobId mobid;
2091    SVGAMobFormat ptDepth;
2092    PPN64 base;
2093    uint32 sizeInBytes;
2094 } __packed
2095 SVGA3dCmdDefineGBMob64;   /* SVGA_3D_CMD_DEFINE_GB_MOB64 */
2096
2097 /*
2098  * Redefine an object in the OTable with PPN64 base.
2099  */
2100
2101 typedef
2102 struct SVGA3dCmdRedefineGBMob64 {
2103    SVGAMobId mobid;
2104    SVGAMobFormat ptDepth;
2105    PPN64 base;
2106    uint32 sizeInBytes;
2107 } __packed
2108 SVGA3dCmdRedefineGBMob64;   /* SVGA_3D_CMD_REDEFINE_GB_MOB64 */
2109
2110 /*
2111  * Notification that the page tables have been modified.
2112  */
2113
2114 typedef
2115 struct SVGA3dCmdUpdateGBMobMapping {
2116    SVGAMobId mobid;
2117 } __packed
2118 SVGA3dCmdUpdateGBMobMapping;   /* SVGA_3D_CMD_UPDATE_GB_MOB_MAPPING */
2119
2120 /*
2121  * Define a guest-backed surface.
2122  */
2123
2124 typedef
2125 struct SVGA3dCmdDefineGBSurface {
2126    uint32 sid;
2127    SVGA3dSurfaceFlags surfaceFlags;
2128    SVGA3dSurfaceFormat format;
2129    uint32 numMipLevels;
2130    uint32 multisampleCount;
2131    SVGA3dTextureFilter autogenFilter;
2132    SVGA3dSize size;
2133 } __packed
2134 SVGA3dCmdDefineGBSurface;   /* SVGA_3D_CMD_DEFINE_GB_SURFACE */
2135
2136 /*
2137  * Destroy a guest-backed surface.
2138  */
2139
2140 typedef
2141 struct SVGA3dCmdDestroyGBSurface {
2142    uint32 sid;
2143 } __packed
2144 SVGA3dCmdDestroyGBSurface;   /* SVGA_3D_CMD_DESTROY_GB_SURFACE */
2145
2146 /*
2147  * Bind a guest-backed surface to an object.
2148  */
2149
2150 typedef
2151 struct SVGA3dCmdBindGBSurface {
2152    uint32 sid;
2153    SVGAMobId mobid;
2154 } __packed
2155 SVGA3dCmdBindGBSurface;   /* SVGA_3D_CMD_BIND_GB_SURFACE */
2156
2157 /*
2158  * Conditionally bind a mob to a guest backed surface if testMobid
2159  * matches the currently bound mob.  Optionally issue a readback on
2160  * the surface while it is still bound to the old mobid if the mobid
2161  * is changed by this command.
2162  */
2163
2164 #define SVGA3D_COND_BIND_GB_SURFACE_FLAG_READBACK (1 << 0)
2165
2166 typedef
2167 struct{
2168    uint32 sid;
2169    SVGAMobId testMobid;
2170    SVGAMobId mobid;
2171    uint32 flags;
2172 } __packed
2173 SVGA3dCmdCondBindGBSurface;          /* SVGA_3D_CMD_COND_BIND_GB_SURFACE */
2174
2175 /*
2176  * Update an image in a guest-backed surface.
2177  * (Inform the device that the guest-contents have been updated.)
2178  */
2179
2180 typedef
2181 struct SVGA3dCmdUpdateGBImage {
2182    SVGA3dSurfaceImageId image;
2183    SVGA3dBox box;
2184 } __packed
2185 SVGA3dCmdUpdateGBImage;   /* SVGA_3D_CMD_UPDATE_GB_IMAGE */
2186
2187 /*
2188  * Update an entire guest-backed surface.
2189  * (Inform the device that the guest-contents have been updated.)
2190  */
2191
2192 typedef
2193 struct SVGA3dCmdUpdateGBSurface {
2194    uint32 sid;
2195 } __packed
2196 SVGA3dCmdUpdateGBSurface;   /* SVGA_3D_CMD_UPDATE_GB_SURFACE */
2197
2198 /*
2199  * Readback an image in a guest-backed surface.
2200  * (Request the device to flush the dirty contents into the guest.)
2201  */
2202
2203 typedef
2204 struct SVGA3dCmdReadbackGBImage {
2205    SVGA3dSurfaceImageId image;
2206 } __packed
2207 SVGA3dCmdReadbackGBImage;   /* SVGA_3D_CMD_READBACK_GB_IMAGE*/
2208
2209 /*
2210  * Readback an entire guest-backed surface.
2211  * (Request the device to flush the dirty contents into the guest.)
2212  */
2213
2214 typedef
2215 struct SVGA3dCmdReadbackGBSurface {
2216    uint32 sid;
2217 } __packed
2218 SVGA3dCmdReadbackGBSurface;   /* SVGA_3D_CMD_READBACK_GB_SURFACE */
2219
2220 /*
2221  * Readback a sub rect of an image in a guest-backed surface.  After
2222  * issuing this command the driver is required to issue an update call
2223  * of the same region before issuing any other commands that reference
2224  * this surface or rendering is not guaranteed.
2225  */
2226
2227 typedef
2228 struct SVGA3dCmdReadbackGBImagePartial {
2229    SVGA3dSurfaceImageId image;
2230    SVGA3dBox box;
2231    uint32 invertBox;
2232 } __packed
2233 SVGA3dCmdReadbackGBImagePartial; /* SVGA_3D_CMD_READBACK_GB_IMAGE_PARTIAL */
2234
2235 /*
2236  * Invalidate an image in a guest-backed surface.
2237  * (Notify the device that the contents can be lost.)
2238  */
2239
2240 typedef
2241 struct SVGA3dCmdInvalidateGBImage {
2242    SVGA3dSurfaceImageId image;
2243 } __packed
2244 SVGA3dCmdInvalidateGBImage;   /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE */
2245
2246 /*
2247  * Invalidate an entire guest-backed surface.
2248  * (Notify the device that the contents if all images can be lost.)
2249  */
2250
2251 typedef
2252 struct SVGA3dCmdInvalidateGBSurface {
2253    uint32 sid;
2254 } __packed
2255 SVGA3dCmdInvalidateGBSurface; /* SVGA_3D_CMD_INVALIDATE_GB_SURFACE */
2256
2257 /*
2258  * Invalidate a sub rect of an image in a guest-backed surface.  After
2259  * issuing this command the driver is required to issue an update call
2260  * of the same region before issuing any other commands that reference
2261  * this surface or rendering is not guaranteed.
2262  */
2263
2264 typedef
2265 struct SVGA3dCmdInvalidateGBImagePartial {
2266    SVGA3dSurfaceImageId image;
2267    SVGA3dBox box;
2268    uint32 invertBox;
2269 } __packed
2270 SVGA3dCmdInvalidateGBImagePartial; /* SVGA_3D_CMD_INVALIDATE_GB_IMAGE_PARTIAL */
2271
2272 /*
2273  * Define a guest-backed context.
2274  */
2275
2276 typedef
2277 struct SVGA3dCmdDefineGBContext {
2278    uint32 cid;
2279 } __packed
2280 SVGA3dCmdDefineGBContext;   /* SVGA_3D_CMD_DEFINE_GB_CONTEXT */
2281
2282 /*
2283  * Destroy a guest-backed context.
2284  */
2285
2286 typedef
2287 struct SVGA3dCmdDestroyGBContext {
2288    uint32 cid;
2289 } __packed
2290 SVGA3dCmdDestroyGBContext;   /* SVGA_3D_CMD_DESTROY_GB_CONTEXT */
2291
2292 /*
2293  * Bind a guest-backed context.
2294  *
2295  * validContents should be set to 0 for new contexts,
2296  * and 1 if this is an old context which is getting paged
2297  * back on to the device.
2298  *
2299  * For new contexts, it is recommended that the driver
2300  * issue commands to initialize all interesting state
2301  * prior to rendering.
2302  */
2303
2304 typedef
2305 struct SVGA3dCmdBindGBContext {
2306    uint32 cid;
2307    SVGAMobId mobid;
2308    uint32 validContents;
2309 } __packed
2310 SVGA3dCmdBindGBContext;   /* SVGA_3D_CMD_BIND_GB_CONTEXT */
2311
2312 /*
2313  * Readback a guest-backed context.
2314  * (Request that the device flush the contents back into guest memory.)
2315  */
2316
2317 typedef
2318 struct SVGA3dCmdReadbackGBContext {
2319    uint32 cid;
2320 } __packed
2321 SVGA3dCmdReadbackGBContext;   /* SVGA_3D_CMD_READBACK_GB_CONTEXT */
2322
2323 /*
2324  * Invalidate a guest-backed context.
2325  */
2326 typedef
2327 struct SVGA3dCmdInvalidateGBContext {
2328    uint32 cid;
2329 } __packed
2330 SVGA3dCmdInvalidateGBContext;   /* SVGA_3D_CMD_INVALIDATE_GB_CONTEXT */
2331
2332 /*
2333  * Define a guest-backed shader.
2334  */
2335
2336 typedef
2337 struct SVGA3dCmdDefineGBShader {
2338    uint32 shid;
2339    SVGA3dShaderType type;
2340    uint32 sizeInBytes;
2341 } __packed
2342 SVGA3dCmdDefineGBShader;   /* SVGA_3D_CMD_DEFINE_GB_SHADER */
2343
2344 /*
2345  * Bind a guest-backed shader.
2346  */
2347
2348 typedef struct SVGA3dCmdBindGBShader {
2349    uint32 shid;
2350    SVGAMobId mobid;
2351    uint32 offsetInBytes;
2352 } __packed
2353 SVGA3dCmdBindGBShader;   /* SVGA_3D_CMD_BIND_GB_SHADER */
2354
2355 /*
2356  * Destroy a guest-backed shader.
2357  */
2358
2359 typedef struct SVGA3dCmdDestroyGBShader {
2360    uint32 shid;
2361 } __packed
2362 SVGA3dCmdDestroyGBShader;   /* SVGA_3D_CMD_DESTROY_GB_SHADER */
2363
2364 typedef
2365 struct {
2366    uint32                  cid;
2367    uint32                  regStart;
2368    SVGA3dShaderType        shaderType;
2369    SVGA3dShaderConstType   constType;
2370
2371    /*
2372     * Followed by a variable number of shader constants.
2373     *
2374     * Note that FLOAT and INT constants are 4-dwords in length, while
2375     * BOOL constants are 1-dword in length.
2376     */
2377 } __packed
2378 SVGA3dCmdSetGBShaderConstInline;
2379 /* SVGA_3D_CMD_SET_GB_SHADERCONSTS_INLINE */
2380
2381 typedef
2382 struct {
2383    uint32               cid;
2384    SVGA3dQueryType      type;
2385 } __packed
2386 SVGA3dCmdBeginGBQuery;           /* SVGA_3D_CMD_BEGIN_GB_QUERY */
2387
2388 typedef
2389 struct {
2390    uint32               cid;
2391    SVGA3dQueryType      type;
2392    SVGAMobId mobid;
2393    uint32 offset;
2394 } __packed
2395 SVGA3dCmdEndGBQuery;                  /* SVGA_3D_CMD_END_GB_QUERY */
2396
2397
2398 /*
2399  * SVGA_3D_CMD_WAIT_FOR_GB_QUERY --
2400  *
2401  *    The semantics of this command are identical to the
2402  *    SVGA_3D_CMD_WAIT_FOR_QUERY except that the results are written
2403  *    to a Mob instead of a GMR.
2404  */
2405
2406 typedef
2407 struct {
2408    uint32               cid;
2409    SVGA3dQueryType      type;
2410    SVGAMobId mobid;
2411    uint32 offset;
2412 } __packed
2413 SVGA3dCmdWaitForGBQuery;          /* SVGA_3D_CMD_WAIT_FOR_GB_QUERY */
2414
2415 typedef
2416 struct {
2417    SVGAMobId mobid;
2418    uint32 fbOffset;
2419    uint32 initalized;
2420 } __packed
2421 SVGA3dCmdEnableGart;              /* SVGA_3D_CMD_ENABLE_GART */
2422
2423 typedef
2424 struct {
2425    SVGAMobId mobid;
2426    uint32 gartOffset;
2427 } __packed
2428 SVGA3dCmdMapMobIntoGart;          /* SVGA_3D_CMD_MAP_MOB_INTO_GART */
2429
2430
2431 typedef
2432 struct {
2433    uint32 gartOffset;
2434    uint32 numPages;
2435 } __packed
2436 SVGA3dCmdUnmapGartRange;          /* SVGA_3D_CMD_UNMAP_GART_RANGE */
2437
2438
2439 /*
2440  * Screen Targets
2441  */
2442 #define SVGA_STFLAG_PRIMARY (1 << 0)
2443
2444 typedef
2445 struct {
2446    uint32 stid;
2447    uint32 width;
2448    uint32 height;
2449    int32 xRoot;
2450    int32 yRoot;
2451    uint32 flags;
2452    uint32 dpi;
2453 } __packed
2454 SVGA3dCmdDefineGBScreenTarget;    /* SVGA_3D_CMD_DEFINE_GB_SCREENTARGET */
2455
2456 typedef
2457 struct {
2458    uint32 stid;
2459 } __packed
2460 SVGA3dCmdDestroyGBScreenTarget;  /* SVGA_3D_CMD_DESTROY_GB_SCREENTARGET */
2461
2462 typedef
2463 struct {
2464    uint32 stid;
2465    SVGA3dSurfaceImageId image;
2466 } __packed
2467 SVGA3dCmdBindGBScreenTarget;  /* SVGA_3D_CMD_BIND_GB_SCREENTARGET */
2468
2469 typedef
2470 struct {
2471    uint32 stid;
2472    SVGA3dRect rect;
2473 } __packed
2474 SVGA3dCmdUpdateGBScreenTarget;  /* SVGA_3D_CMD_UPDATE_GB_SCREENTARGET */
2475
2476 /*
2477  * Capability query index.
2478  *
2479  * Notes:
2480  *
2481  *   1. SVGA3D_DEVCAP_MAX_TEXTURES reflects the maximum number of
2482  *      fixed-function texture units available. Each of these units
2483  *      work in both FFP and Shader modes, and they support texture
2484  *      transforms and texture coordinates. The host may have additional
2485  *      texture image units that are only usable with shaders.
2486  *
2487  *   2. The BUFFER_FORMAT capabilities are deprecated, and they always
2488  *      return TRUE. Even on physical hardware that does not support
2489  *      these formats natively, the SVGA3D device will provide an emulation
2490  *      which should be invisible to the guest OS.
2491  *
2492  *      In general, the SVGA3D device should support any operation on
2493  *      any surface format, it just may perform some of these
2494  *      operations in software depending on the capabilities of the
2495  *      available physical hardware.
2496  *
2497  *      XXX: In the future, we will add capabilities that describe in
2498  *      detail what formats are supported in hardware for what kinds
2499  *      of operations.
2500  */
2501
2502 typedef enum {
2503    SVGA3D_DEVCAP_3D                                = 0,
2504    SVGA3D_DEVCAP_MAX_LIGHTS                        = 1,
2505    SVGA3D_DEVCAP_MAX_TEXTURES                      = 2,  /* See note (1) */
2506    SVGA3D_DEVCAP_MAX_CLIP_PLANES                   = 3,
2507    SVGA3D_DEVCAP_VERTEX_SHADER_VERSION             = 4,
2508    SVGA3D_DEVCAP_VERTEX_SHADER                     = 5,
2509    SVGA3D_DEVCAP_FRAGMENT_SHADER_VERSION           = 6,
2510    SVGA3D_DEVCAP_FRAGMENT_SHADER                   = 7,
2511    SVGA3D_DEVCAP_MAX_RENDER_TARGETS                = 8,
2512    SVGA3D_DEVCAP_S23E8_TEXTURES                    = 9,
2513    SVGA3D_DEVCAP_S10E5_TEXTURES                    = 10,
2514    SVGA3D_DEVCAP_MAX_FIXED_VERTEXBLEND             = 11,
2515    SVGA3D_DEVCAP_D16_BUFFER_FORMAT                 = 12, /* See note (2) */
2516    SVGA3D_DEVCAP_D24S8_BUFFER_FORMAT               = 13, /* See note (2) */
2517    SVGA3D_DEVCAP_D24X8_BUFFER_FORMAT               = 14, /* See note (2) */
2518    SVGA3D_DEVCAP_QUERY_TYPES                       = 15,
2519    SVGA3D_DEVCAP_TEXTURE_GRADIENT_SAMPLING         = 16,
2520    SVGA3D_DEVCAP_MAX_POINT_SIZE                    = 17,
2521    SVGA3D_DEVCAP_MAX_SHADER_TEXTURES               = 18,
2522    SVGA3D_DEVCAP_MAX_TEXTURE_WIDTH                 = 19,
2523    SVGA3D_DEVCAP_MAX_TEXTURE_HEIGHT                = 20,
2524    SVGA3D_DEVCAP_MAX_VOLUME_EXTENT                 = 21,
2525    SVGA3D_DEVCAP_MAX_TEXTURE_REPEAT                = 22,
2526    SVGA3D_DEVCAP_MAX_TEXTURE_ASPECT_RATIO          = 23,
2527    SVGA3D_DEVCAP_MAX_TEXTURE_ANISOTROPY            = 24,
2528    SVGA3D_DEVCAP_MAX_PRIMITIVE_COUNT               = 25,
2529    SVGA3D_DEVCAP_MAX_VERTEX_INDEX                  = 26,
2530    SVGA3D_DEVCAP_MAX_VERTEX_SHADER_INSTRUCTIONS    = 27,
2531    SVGA3D_DEVCAP_MAX_FRAGMENT_SHADER_INSTRUCTIONS  = 28,
2532    SVGA3D_DEVCAP_MAX_VERTEX_SHADER_TEMPS           = 29,
2533    SVGA3D_DEVCAP_MAX_FRAGMENT_SHADER_TEMPS         = 30,
2534    SVGA3D_DEVCAP_TEXTURE_OPS                       = 31,
2535    SVGA3D_DEVCAP_SURFACEFMT_X8R8G8B8               = 32,
2536    SVGA3D_DEVCAP_SURFACEFMT_A8R8G8B8               = 33,
2537    SVGA3D_DEVCAP_SURFACEFMT_A2R10G10B10            = 34,
2538    SVGA3D_DEVCAP_SURFACEFMT_X1R5G5B5               = 35,
2539    SVGA3D_DEVCAP_SURFACEFMT_A1R5G5B5               = 36,
2540    SVGA3D_DEVCAP_SURFACEFMT_A4R4G4B4               = 37,
2541    SVGA3D_DEVCAP_SURFACEFMT_R5G6B5                 = 38,
2542    SVGA3D_DEVCAP_SURFACEFMT_LUMINANCE16            = 39,
2543    SVGA3D_DEVCAP_SURFACEFMT_LUMINANCE8_ALPHA8      = 40,
2544    SVGA3D_DEVCAP_SURFACEFMT_ALPHA8                 = 41,
2545    SVGA3D_DEVCAP_SURFACEFMT_LUMINANCE8             = 42,
2546    SVGA3D_DEVCAP_SURFACEFMT_Z_D16                  = 43,
2547    SVGA3D_DEVCAP_SURFACEFMT_Z_D24S8                = 44,
2548    SVGA3D_DEVCAP_SURFACEFMT_Z_D24X8                = 45,
2549    SVGA3D_DEVCAP_SURFACEFMT_DXT1                   = 46,
2550    SVGA3D_DEVCAP_SURFACEFMT_DXT2                   = 47,
2551    SVGA3D_DEVCAP_SURFACEFMT_DXT3                   = 48,
2552    SVGA3D_DEVCAP_SURFACEFMT_DXT4                   = 49,
2553    SVGA3D_DEVCAP_SURFACEFMT_DXT5                   = 50,
2554    SVGA3D_DEVCAP_SURFACEFMT_BUMPX8L8V8U8           = 51,
2555    SVGA3D_DEVCAP_SURFACEFMT_A2W10V10U10            = 52,
2556    SVGA3D_DEVCAP_SURFACEFMT_BUMPU8V8               = 53,
2557    SVGA3D_DEVCAP_SURFACEFMT_Q8W8V8U8               = 54,
2558    SVGA3D_DEVCAP_SURFACEFMT_CxV8U8                 = 55,
2559    SVGA3D_DEVCAP_SURFACEFMT_R_S10E5                = 56,
2560    SVGA3D_DEVCAP_SURFACEFMT_R_S23E8                = 57,
2561    SVGA3D_DEVCAP_SURFACEFMT_RG_S10E5               = 58,
2562    SVGA3D_DEVCAP_SURFACEFMT_RG_S23E8               = 59,
2563    SVGA3D_DEVCAP_SURFACEFMT_ARGB_S10E5             = 60,
2564    SVGA3D_DEVCAP_SURFACEFMT_ARGB_S23E8             = 61,
2565    SVGA3D_DEVCAP_MAX_VERTEX_SHADER_TEXTURES        = 63,
2566
2567    /*
2568     * Note that MAX_SIMULTANEOUS_RENDER_TARGETS is a maximum count of color
2569     * render targets.  This does no include the depth or stencil targets.
2570     */
2571    SVGA3D_DEVCAP_MAX_SIMULTANEOUS_RENDER_TARGETS   = 64,
2572
2573    SVGA3D_DEVCAP_SURFACEFMT_V16U16                 = 65,
2574    SVGA3D_DEVCAP_SURFACEFMT_G16R16                 = 66,
2575    SVGA3D_DEVCAP_SURFACEFMT_A16B16G16R16           = 67,
2576    SVGA3D_DEVCAP_SURFACEFMT_UYVY                   = 68,
2577    SVGA3D_DEVCAP_SURFACEFMT_YUY2                   = 69,
2578    SVGA3D_DEVCAP_MULTISAMPLE_NONMASKABLESAMPLES    = 70,
2579    SVGA3D_DEVCAP_MULTISAMPLE_MASKABLESAMPLES       = 71,
2580    SVGA3D_DEVCAP_ALPHATOCOVERAGE                   = 72,
2581    SVGA3D_DEVCAP_SUPERSAMPLE                       = 73,
2582    SVGA3D_DEVCAP_AUTOGENMIPMAPS                    = 74,
2583    SVGA3D_DEVCAP_SURFACEFMT_NV12                   = 75,
2584    SVGA3D_DEVCAP_SURFACEFMT_AYUV                   = 76,
2585
2586    /*
2587     * This is the maximum number of SVGA context IDs that the guest
2588     * can define using SVGA_3D_CMD_CONTEXT_DEFINE.
2589     */
2590    SVGA3D_DEVCAP_MAX_CONTEXT_IDS                   = 77,
2591
2592    /*
2593     * This is the maximum number of SVGA surface IDs that the guest
2594     * can define using SVGA_3D_CMD_SURFACE_DEFINE*.
2595     */
2596    SVGA3D_DEVCAP_MAX_SURFACE_IDS                   = 78,
2597
2598    SVGA3D_DEVCAP_SURFACEFMT_Z_DF16                 = 79,
2599    SVGA3D_DEVCAP_SURFACEFMT_Z_DF24                 = 80,
2600    SVGA3D_DEVCAP_SURFACEFMT_Z_D24S8_INT            = 81,
2601
2602    SVGA3D_DEVCAP_SURFACEFMT_BC4_UNORM              = 82,
2603    SVGA3D_DEVCAP_SURFACEFMT_BC5_UNORM              = 83,
2604
2605    /*
2606     * Deprecated.
2607     */
2608    SVGA3D_DEVCAP_VGPU10                            = 84,
2609
2610    /*
2611     * This contains several SVGA_3D_CAPS_VIDEO_DECODE elements
2612     * ored together, one for every type of video decoding supported.
2613     */
2614    SVGA3D_DEVCAP_VIDEO_DECODE                      = 85,
2615
2616    /*
2617     * This contains several SVGA_3D_CAPS_VIDEO_PROCESS elements
2618     * ored together, one for every type of video processing supported.
2619     */
2620    SVGA3D_DEVCAP_VIDEO_PROCESS                     = 86,
2621
2622    SVGA3D_DEVCAP_LINE_AA                           = 87,  /* boolean */
2623    SVGA3D_DEVCAP_LINE_STIPPLE                      = 88,  /* boolean */
2624    SVGA3D_DEVCAP_MAX_LINE_WIDTH                    = 89,  /* float */
2625    SVGA3D_DEVCAP_MAX_AA_LINE_WIDTH                 = 90,  /* float */
2626
2627    SVGA3D_DEVCAP_SURFACEFMT_YV12                   = 91,
2628
2629    /*
2630     * Does the host support the SVGA logic ops commands?
2631     */
2632    SVGA3D_DEVCAP_LOGICOPS                          = 92,
2633
2634    /*
2635     * What support does the host have for screen targets?
2636     *
2637     * See the SVGA3D_SCREENTARGET_CAP bits below.
2638     */
2639    SVGA3D_DEVCAP_SCREENTARGETS                     = 93,
2640
2641    SVGA3D_DEVCAP_MAX                                  /* This must be the last index. */
2642 } SVGA3dDevCapIndex;
2643
2644 typedef union {
2645    Bool   b;
2646    uint32 u;
2647    int32  i;
2648    float  f;
2649 } SVGA3dDevCapResult;
2650
2651 typedef enum {
2652    SVGA3DCAPS_RECORD_UNKNOWN        = 0,
2653    SVGA3DCAPS_RECORD_DEVCAPS_MIN    = 0x100,
2654    SVGA3DCAPS_RECORD_DEVCAPS        = 0x100,
2655    SVGA3DCAPS_RECORD_DEVCAPS_MAX    = 0x1ff,
2656 } SVGA3dCapsRecordType;
2657
2658 typedef
2659 struct SVGA3dCapsRecordHeader {
2660    uint32 length;
2661    SVGA3dCapsRecordType type;
2662 }
2663 SVGA3dCapsRecordHeader;
2664
2665 typedef
2666 struct SVGA3dCapsRecord {
2667    SVGA3dCapsRecordHeader header;
2668    uint32 data[1];
2669 }
2670 SVGA3dCapsRecord;
2671
2672
2673 typedef uint32 SVGA3dCapPair[2];
2674
2675 #endif /* _SVGA3D_REG_H_ */