src/external/3rd/library/directx9/include/d3dx9core.h

   1 ///////////////////////////////////////////////////////////////////////////
   2 //
   3 //  Copyright (C) Microsoft Corporation.  All Rights Reserved.
   4 //
   5 //  File:       d3dx9core.h
   6 //  Content:    D3DX core types and functions
   7 //
   8 ///////////////////////////////////////////////////////////////////////////
   9
  10 #include "d3dx9.h"
  11
  12 #ifndef __D3DX9CORE_H__
  13 #define __D3DX9CORE_H__
  14
  15
  16 ///////////////////////////////////////////////////////////////////////////
  17 // D3DX_SDK_VERSION:
  18 // -----------------
  19 // This identifier is passed to D3DXCheckVersion in order to ensure that an
  20 // application was built against the correct header files and lib files.
  21 // This number is incremented whenever a header (or other) change would
  22 // require applications to be rebuilt. If the version doesn't match,
  23 // D3DXCreateVersion will return FALSE. (The number itself has no meaning.)
  24 ///////////////////////////////////////////////////////////////////////////
  25
  26 #define D3DX_VERSION 0x0902
  27 #define D3DX_SDK_VERSION 22
  28
  29 #ifdef __cplusplus
  30 extern "C" {
  31 #endif //__cplusplus
  32
  33 BOOL WINAPI
  34     D3DXCheckVersion(UINT D3DSdkVersion, UINT D3DXSdkVersion);
  35
  36 #ifdef __cplusplus
  37 }
  38 #endif //__cplusplus
  39
  40
  41 ///////////////////////////////////////////////////////////////////////////
  42 // D3DXDebugMute
  43 //    Mutes D3DX and D3D debug spew (TRUE - mute, FALSE - not mute)
  44 //
  45 //  returns previous mute value
  46 //
  47 ///////////////////////////////////////////////////////////////////////////
  48
  49 #ifdef __cplusplus
  50 extern "C" {
  51 #endif //__cplusplus
  52
  53 BOOL WINAPI
  54     D3DXDebugMute(BOOL Mute);
  55
  56 #ifdef __cplusplus
  57 }
  58 #endif //__cplusplus
  59
  60
  61 ///////////////////////////////////////////////////////////////////////////
  62 // D3DXGetDriverLevel:
  63 //    Returns driver version information:
  64 //
  65 //    700 - DX7 level driver
  66 //    800 - DX8 level driver
  67 //    900 - DX9 level driver
  68 ///////////////////////////////////////////////////////////////////////////
  69
  70 #ifdef __cplusplus
  71 extern "C" {
  72 #endif //__cplusplus
  73
  74 UINT WINAPI
  75     D3DXGetDriverLevel(LPDIRECT3DDEVICE9 pDevice);
  76
  77 #ifdef __cplusplus
  78 }
  79 #endif //__cplusplus
  80
  81
  82 ///////////////////////////////////////////////////////////////////////////
  83 // ID3DXBuffer:
  84 // ------------
  85 // The buffer object is used by D3DX to return arbitrary size data.
  86 //
  87 // GetBufferPointer -
  88 //    Returns a pointer to the beginning of the buffer.
  89 //
  90 // GetBufferSize -
  91 //    Returns the size of the buffer, in bytes.
  92 ///////////////////////////////////////////////////////////////////////////
  93
  94 typedef interface ID3DXBuffer ID3DXBuffer;
  95 typedef interface ID3DXBuffer *LPD3DXBUFFER;
  96
  97 // {8BA5FB08-5195-40e2-AC58-0D989C3A0102}
  98 DEFINE_GUID(IID_ID3DXBuffer,
  99 0x8ba5fb08, 0x5195, 0x40e2, 0xac, 0x58, 0xd, 0x98, 0x9c, 0x3a, 0x1, 0x2);
 100
 101 #undef INTERFACE
 102 #define INTERFACE ID3DXBuffer
 103
 104 DECLARE_INTERFACE_(ID3DXBuffer, IUnknown)
 105 {
 106     // IUnknown
 107     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 108     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 109     STDMETHOD_(ULONG, Release)(THIS) PURE;
 110
 111     // ID3DXBuffer
 112     STDMETHOD_(LPVOID, GetBufferPointer)(THIS) PURE;
 113     STDMETHOD_(DWORD, GetBufferSize)(THIS) PURE;
 114 };
 115
 116
 117
 118 //////////////////////////////////////////////////////////////////////////////
 119 // D3DXSPRITE flags:
 120 // -----------------
 121 // D3DXSPRITE_DONOTSAVESTATE
 122 //   Specifies device state is not to be saved and restored in Begin/End.
 123 // D3DXSPRITE_DONOTMODIFY_RENDERSTATE
 124 //   Specifies device render state is not to be changed in Begin.  The device
 125 //   is assumed to be in a valid state to draw vertices containing POSITION0,
 126 //   TEXCOORD0, and COLOR0 data.
 127 // D3DXSPRITE_OBJECTSPACE
 128 //   The WORLD, VIEW, and PROJECTION transforms are NOT modified.  The
 129 //   transforms currently set to the device are used to transform the sprites
 130 //   when the batch is drawn (at Flush or End).  If this is not specified,
 131 //   WORLD, VIEW, and PROJECTION transforms are modified so that sprites are
 132 //   drawn in screenspace coordinates.
 133 // D3DXSPRITE_BILLBOARD
 134 //   Rotates each sprite about its center so that it is facing the viewer.
 135 // D3DXSPRITE_ALPHABLEND
 136 //   Enables ALPHABLEND(SRCALPHA, INVSRCALPHA) and ALPHATEST(alpha > 0).
 137 //   ID3DXFont expects this to be set when drawing text.
 138 // D3DXSPRITE_SORT_TEXTURE
 139 //   Sprites are sorted by texture prior to drawing.  This is recommended when
 140 //   drawing non-overlapping sprites of uniform depth.  For example, drawing
 141 //   screen-aligned text with ID3DXFont.
 142 // D3DXSPRITE_SORT_DEPTH_FRONTTOBACK
 143 //   Sprites are sorted by depth front-to-back prior to drawing.  This is
 144 //   recommended when drawing opaque sprites of varying depths.
 145 // D3DXSPRITE_SORT_DEPTH_BACKTOFRONT
 146 //   Sprites are sorted by depth back-to-front prior to drawing.  This is
 147 //   recommended when drawing transparent sprites of varying depths.
 148 //////////////////////////////////////////////////////////////////////////////
 149
 150 #define D3DXSPRITE_DONOTSAVESTATE               (1 << 0)
 151 #define D3DXSPRITE_DONOTMODIFY_RENDERSTATE      (1 << 1)
 152 #define D3DXSPRITE_OBJECTSPACE                  (1 << 2)
 153 #define D3DXSPRITE_BILLBOARD                    (1 << 3)
 154 #define D3DXSPRITE_ALPHABLEND                   (1 << 4)
 155 #define D3DXSPRITE_SORT_TEXTURE                 (1 << 5)
 156 #define D3DXSPRITE_SORT_DEPTH_FRONTTOBACK       (1 << 6)
 157 #define D3DXSPRITE_SORT_DEPTH_BACKTOFRONT       (1 << 7)
 158
 159
 160 //////////////////////////////////////////////////////////////////////////////
 161 // ID3DXSprite:
 162 // ------------
 163 // This object intends to provide an easy way to drawing sprites using D3D.
 164 //
 165 // Begin -
 166 //    Prepares device for drawing sprites.
 167 //
 168 // Draw -
 169 //    Draws a sprite.  Before transformation, the sprite is the size of
 170 //    SrcRect, with its top-left corner specified by Position.  The color
 171 //    and alpha channels are modulated by Color.
 172 //
 173 // Flush -
 174 //    Forces all batched sprites to submitted to the device.
 175 //
 176 // End -
 177 //    Restores device state to how it was when Begin was called.
 178 //
 179 // OnLostDevice, OnResetDevice -
 180 //    Call OnLostDevice() on this object before calling Reset() on the
 181 //    device, so that this object can release any stateblocks and video
 182 //    memory resources.  After Reset(), the call OnResetDevice().
 183 //////////////////////////////////////////////////////////////////////////////
 184
 185 typedef interface ID3DXSprite ID3DXSprite;
 186 typedef interface ID3DXSprite *LPD3DXSPRITE;
 187
 188
 189 // {BA0B762D-7D28-43ec-B9DC-2F84443B0614}
 190 DEFINE_GUID(IID_ID3DXSprite,
 191 0xba0b762d, 0x7d28, 0x43ec, 0xb9, 0xdc, 0x2f, 0x84, 0x44, 0x3b, 0x6, 0x14);
 192
 193
 194 #undef INTERFACE
 195 #define INTERFACE ID3DXSprite
 196
 197 DECLARE_INTERFACE_(ID3DXSprite, IUnknown)
 198 {
 199     // IUnknown
 200     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 201     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 202     STDMETHOD_(ULONG, Release)(THIS) PURE;
 203
 204     // ID3DXSprite
 205     STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
 206
 207     STDMETHOD(GetTransform)(THIS_ D3DXMATRIX *pTransform) PURE;
 208     STDMETHOD(SetTransform)(THIS_ CONST D3DXMATRIX *pTransform) PURE;
 209
 210     STDMETHOD(SetWorldViewRH)(THIS_ CONST D3DXMATRIX *pWorld, CONST D3DXMATRIX *pView) PURE;
 211     STDMETHOD(SetWorldViewLH)(THIS_ CONST D3DXMATRIX *pWorld, CONST D3DXMATRIX *pView) PURE;
 212
 213     STDMETHOD(Begin)(THIS_ DWORD Flags) PURE;
 214     STDMETHOD(Draw)(THIS_ LPDIRECT3DTEXTURE9 pTexture, CONST RECT *pSrcRect, CONST D3DXVECTOR3 *pCenter, CONST D3DXVECTOR3 *pPosition, D3DCOLOR Color) PURE;
 215     STDMETHOD(Flush)(THIS) PURE;
 216     STDMETHOD(End)(THIS) PURE;
 217
 218     STDMETHOD(OnLostDevice)(THIS) PURE;
 219     STDMETHOD(OnResetDevice)(THIS) PURE;
 220 };
 221
 222
 223 #ifdef __cplusplus
 224 extern "C" {
 225 #endif //__cplusplus
 226
 227 HRESULT WINAPI
 228     D3DXCreateSprite(
 229         LPDIRECT3DDEVICE9   pDevice,
 230         LPD3DXSPRITE*       ppSprite);
 231
 232 #ifdef __cplusplus
 233 }
 234 #endif //__cplusplus
 235
 236
 237
 238 //////////////////////////////////////////////////////////////////////////////
 239 // ID3DXFont:
 240 // ----------
 241 // Font objects contain the textures and resources needed to render a specific
 242 // font on a specific device.
 243 //
 244 // GetGlyphData -
 245 //    Returns glyph cache data, for a given glyph.
 246 //
 247 // PreloadCharacters/PreloadGlyphs/PreloadText -
 248 //    Preloads glyphs into the glyph cache textures.
 249 //
 250 // DrawText -
 251 //    Draws formatted text on a D3D device.  Some parameters are
 252 //    surprisingly similar to those of GDI's DrawText function.  See GDI
 253 //    documentation for a detailed description of these parameters.
 254 //    If pSprite is NULL, an internal sprite object will be used.
 255 //
 256 // OnLostDevice, OnResetDevice -
 257 //    Call OnLostDevice() on this object before calling Reset() on the
 258 //    device, so that this object can release any stateblocks and video
 259 //    memory resources.  After Reset(), the call OnResetDevice().
 260 //////////////////////////////////////////////////////////////////////////////
 261
 262 typedef struct _D3DXFONT_DESCA
 263 {
 264     INT Height;
 265     UINT Width;
 266     UINT Weight;
 267     UINT MipLevels;
 268     BOOL Italic;
 269     BYTE CharSet;
 270     BYTE OutputPrecision;
 271     BYTE Quality;
 272     BYTE PitchAndFamily;
 273     CHAR FaceName[LF_FACESIZE];
 274
 275 } D3DXFONT_DESCA, *LPD3DXFONT_DESCA;
 276
 277 typedef struct _D3DXFONT_DESCW
 278 {
 279     INT Height;
 280     UINT Width;
 281     UINT Weight;
 282     UINT MipLevels;
 283     BOOL Italic;
 284     BYTE CharSet;
 285     BYTE OutputPrecision;
 286     BYTE Quality;
 287     BYTE PitchAndFamily;
 288     WCHAR FaceName[LF_FACESIZE];
 289
 290 } D3DXFONT_DESCW, *LPD3DXFONT_DESCW;
 291
 292 #ifdef UNICODE
 293 typedef D3DXFONT_DESCW D3DXFONT_DESC;
 294 typedef LPD3DXFONT_DESCW LPD3DXFONT_DESC;
 295 #else
 296 typedef D3DXFONT_DESCA D3DXFONT_DESC;
 297 typedef LPD3DXFONT_DESCA LPD3DXFONT_DESC;
 298 #endif
 299
 300
 301 typedef interface ID3DXFont ID3DXFont;
 302 typedef interface ID3DXFont *LPD3DXFONT;
 303
 304
 305 // {D79DBB70-5F21-4d36-BBC2-FF525C213CDC}
 306 DEFINE_GUID(IID_ID3DXFont,
 307 0xd79dbb70, 0x5f21, 0x4d36, 0xbb, 0xc2, 0xff, 0x52, 0x5c, 0x21, 0x3c, 0xdc);
 308
 309
 310 #undef INTERFACE
 311 #define INTERFACE ID3DXFont
 312
 313 DECLARE_INTERFACE_(ID3DXFont, IUnknown)
 314 {
 315     // IUnknown
 316     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 317     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 318     STDMETHOD_(ULONG, Release)(THIS) PURE;
 319
 320     // ID3DXFont
 321     STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9 *ppDevice) PURE;
 322     STDMETHOD(GetDescA)(THIS_ D3DXFONT_DESCA *pDesc) PURE;
 323     STDMETHOD(GetDescW)(THIS_ D3DXFONT_DESCW *pDesc) PURE;
 324     STDMETHOD_(BOOL, GetTextMetricsA)(THIS_ TEXTMETRICA *pTextMetrics) PURE;
 325     STDMETHOD_(BOOL, GetTextMetricsW)(THIS_ TEXTMETRICW *pTextMetrics) PURE;
 326
 327     STDMETHOD_(HDC, GetDC)(THIS) PURE;
 328     STDMETHOD(GetGlyphData)(THIS_ UINT Glyph, LPDIRECT3DTEXTURE9 *ppTexture, RECT *pBlackBox, POINT *pCellInc) PURE;
 329
 330     STDMETHOD(PreloadCharacters)(THIS_ UINT First, UINT Last) PURE;
 331     STDMETHOD(PreloadGlyphs)(THIS_ UINT First, UINT Last) PURE;
 332     STDMETHOD(PreloadTextA)(THIS_ LPCSTR pString, INT Count) PURE;
 333     STDMETHOD(PreloadTextW)(THIS_ LPCWSTR pString, INT Count) PURE;
 334
 335     STDMETHOD_(INT, DrawTextA)(THIS_ LPD3DXSPRITE pSprite, LPCSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
 336     STDMETHOD_(INT, DrawTextW)(THIS_ LPD3DXSPRITE pSprite, LPCWSTR pString, INT Count, LPRECT pRect, DWORD Format, D3DCOLOR Color) PURE;
 337
 338     STDMETHOD(OnLostDevice)(THIS) PURE;
 339     STDMETHOD(OnResetDevice)(THIS) PURE;
 340
 341 #ifdef __cplusplus
 342 #ifdef UNICODE
 343     HRESULT GetDesc(D3DXFONT_DESCW *pDesc) { return GetDescW(pDesc); }
 344     HRESULT PreloadText(LPCWSTR pString, INT Count) { return PreloadTextW(pString, Count); }
 345 #else
 346     HRESULT GetDesc(D3DXFONT_DESCA *pDesc) { return GetDescA(pDesc); }
 347     HRESULT PreloadText(LPCSTR pString, INT Count) { return PreloadTextA(pString, Count); }
 348 #endif
 349 #endif //__cplusplus
 350 };
 351
 352 #ifndef GetTextMetrics
 353 #ifdef UNICODE
 354 #define GetTextMetrics GetTextMetricsW
 355 #else
 356 #define GetTextMetrics GetTextMetricsA
 357 #endif
 358 #endif
 359
 360 #ifndef DrawText
 361 #ifdef UNICODE
 362 #define DrawText DrawTextW
 363 #else
 364 #define DrawText DrawTextA
 365 #endif
 366 #endif
 367
 368
 369 #ifdef __cplusplus
 370 extern "C" {
 371 #endif //__cplusplus
 372
 373
 374 HRESULT WINAPI
 375     D3DXCreateFontA(
 376         LPDIRECT3DDEVICE9       pDevice,
 377         INT                     Height,
 378         UINT                    Width,
 379         UINT                    Weight,
 380         UINT                    MipLevels,
 381         BOOL                    Italic,
 382         DWORD                   CharSet,
 383         DWORD                   OutputPrecision,
 384         DWORD                   Quality,
 385         DWORD                   PitchAndFamily,
 386         LPCSTR                  pFaceName,
 387         LPD3DXFONT*             ppFont);
 388
 389 HRESULT WINAPI
 390     D3DXCreateFontW(
 391         LPDIRECT3DDEVICE9       pDevice,
 392         INT                     Height,
 393         UINT                    Width,
 394         UINT                    Weight,
 395         UINT                    MipLevels,
 396         BOOL                    Italic,
 397         DWORD                   CharSet,
 398         DWORD                   OutputPrecision,
 399         DWORD                   Quality,
 400         DWORD                   PitchAndFamily,
 401         LPCWSTR                 pFaceName,
 402         LPD3DXFONT*             ppFont);
 403
 404 #ifdef UNICODE
 405 #define D3DXCreateFont D3DXCreateFontW
 406 #else
 407 #define D3DXCreateFont D3DXCreateFontA
 408 #endif
 409
 410
 411 HRESULT WINAPI
 412     D3DXCreateFontIndirectA(
 413         LPDIRECT3DDEVICE9       pDevice,
 414         CONST D3DXFONT_DESCA*   pDesc,
 415         LPD3DXFONT*             ppFont);
 416
 417 HRESULT WINAPI
 418     D3DXCreateFontIndirectW(
 419         LPDIRECT3DDEVICE9       pDevice,
 420         CONST D3DXFONT_DESCW*   pDesc,
 421         LPD3DXFONT*             ppFont);
 422
 423 #ifdef UNICODE
 424 #define D3DXCreateFontIndirect D3DXCreateFontIndirectW
 425 #else
 426 #define D3DXCreateFontIndirect D3DXCreateFontIndirectA
 427 #endif
 428
 429
 430 #ifdef __cplusplus
 431 }
 432 #endif //__cplusplus
 433
 434
 435
 436 ///////////////////////////////////////////////////////////////////////////
 437 // ID3DXRenderToSurface:
 438 // ---------------------
 439 // This object abstracts rendering to surfaces.  These surfaces do not
 440 // necessarily need to be render targets.  If they are not, a compatible
 441 // render target is used, and the result copied into surface at end scene.
 442 //
 443 // BeginScene, EndScene -
 444 //    Call BeginScene() and EndScene() at the beginning and ending of your
 445 //    scene.  These calls will setup and restore render targets, viewports,
 446 //    etc..
 447 //
 448 // OnLostDevice, OnResetDevice -
 449 //    Call OnLostDevice() on this object before calling Reset() on the
 450 //    device, so that this object can release any stateblocks and video
 451 //    memory resources.  After Reset(), the call OnResetDevice().
 452 ///////////////////////////////////////////////////////////////////////////
 453
 454 typedef struct _D3DXRTS_DESC
 455 {
 456     UINT                Width;
 457     UINT                Height;
 458     D3DFORMAT           Format;
 459     BOOL                DepthStencil;
 460     D3DFORMAT           DepthStencilFormat;
 461
 462 } D3DXRTS_DESC, *LPD3DXRTS_DESC;
 463
 464
 465 typedef interface ID3DXRenderToSurface ID3DXRenderToSurface;
 466 typedef interface ID3DXRenderToSurface *LPD3DXRENDERTOSURFACE;
 467
 468
 469 // {6985F346-2C3D-43b3-BE8B-DAAE8A03D894}
 470 DEFINE_GUID(IID_ID3DXRenderToSurface,
 471 0x6985f346, 0x2c3d, 0x43b3, 0xbe, 0x8b, 0xda, 0xae, 0x8a, 0x3, 0xd8, 0x94);
 472
 473
 474 #undef INTERFACE
 475 #define INTERFACE ID3DXRenderToSurface
 476
 477 DECLARE_INTERFACE_(ID3DXRenderToSurface, IUnknown)
 478 {
 479     // IUnknown
 480     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 481     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 482     STDMETHOD_(ULONG, Release)(THIS) PURE;
 483
 484     // ID3DXRenderToSurface
 485     STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
 486     STDMETHOD(GetDesc)(THIS_ D3DXRTS_DESC* pDesc) PURE;
 487
 488     STDMETHOD(BeginScene)(THIS_ LPDIRECT3DSURFACE9 pSurface, CONST D3DVIEWPORT9* pViewport) PURE;
 489     STDMETHOD(EndScene)(THIS_ DWORD MipFilter) PURE;
 490
 491     STDMETHOD(OnLostDevice)(THIS) PURE;
 492     STDMETHOD(OnResetDevice)(THIS) PURE;
 493 };
 494
 495
 496 #ifdef __cplusplus
 497 extern "C" {
 498 #endif //__cplusplus
 499
 500 HRESULT WINAPI
 501     D3DXCreateRenderToSurface(
 502         LPDIRECT3DDEVICE9       pDevice,
 503         UINT                    Width,
 504         UINT                    Height,
 505         D3DFORMAT               Format,
 506         BOOL                    DepthStencil,
 507         D3DFORMAT               DepthStencilFormat,
 508         LPD3DXRENDERTOSURFACE*  ppRenderToSurface);
 509
 510 #ifdef __cplusplus
 511 }
 512 #endif //__cplusplus
 513
 514
 515
 516 ///////////////////////////////////////////////////////////////////////////
 517 // ID3DXRenderToEnvMap:
 518 // --------------------
 519 // This object abstracts rendering to environment maps.  These surfaces
 520 // do not necessarily need to be render targets.  If they are not, a
 521 // compatible render target is used, and the result copied into the
 522 // environment map at end scene.
 523 //
 524 // BeginCube, BeginSphere, BeginHemisphere, BeginParabolic -
 525 //    This function initiates the rendering of the environment map.  As
 526 //    parameters, you pass the textures in which will get filled in with
 527 //    the resulting environment map.
 528 //
 529 // Face -
 530 //    Call this function to initiate the drawing of each face.  For each
 531 //    environment map, you will call this six times.. once for each face
 532 //    in D3DCUBEMAP_FACES.
 533 //
 534 // End -
 535 //    This will restore all render targets, and if needed compose all the
 536 //    rendered faces into the environment map surfaces.
 537 //
 538 // OnLostDevice, OnResetDevice -
 539 //    Call OnLostDevice() on this object before calling Reset() on the
 540 //    device, so that this object can release any stateblocks and video
 541 //    memory resources.  After Reset(), the call OnResetDevice().
 542 ///////////////////////////////////////////////////////////////////////////
 543
 544 typedef struct _D3DXRTE_DESC
 545 {
 546     UINT        Size;
 547     UINT        MipLevels;
 548     D3DFORMAT   Format;
 549     BOOL        DepthStencil;
 550     D3DFORMAT   DepthStencilFormat;
 551
 552 } D3DXRTE_DESC, *LPD3DXRTE_DESC;
 553
 554
 555 typedef interface ID3DXRenderToEnvMap ID3DXRenderToEnvMap;
 556 typedef interface ID3DXRenderToEnvMap *LPD3DXRenderToEnvMap;
 557
 558
 559 // {313F1B4B-C7B0-4fa2-9D9D-8D380B64385E}
 560 DEFINE_GUID(IID_ID3DXRenderToEnvMap,
 561 0x313f1b4b, 0xc7b0, 0x4fa2, 0x9d, 0x9d, 0x8d, 0x38, 0xb, 0x64, 0x38, 0x5e);
 562
 563
 564 #undef INTERFACE
 565 #define INTERFACE ID3DXRenderToEnvMap
 566
 567 DECLARE_INTERFACE_(ID3DXRenderToEnvMap, IUnknown)
 568 {
 569     // IUnknown
 570     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 571     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 572     STDMETHOD_(ULONG, Release)(THIS) PURE;
 573
 574     // ID3DXRenderToEnvMap
 575     STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
 576     STDMETHOD(GetDesc)(THIS_ D3DXRTE_DESC* pDesc) PURE;
 577
 578     STDMETHOD(BeginCube)(THIS_
 579         LPDIRECT3DCUBETEXTURE9 pCubeTex) PURE;
 580
 581     STDMETHOD(BeginSphere)(THIS_
 582         LPDIRECT3DTEXTURE9 pTex) PURE;
 583
 584     STDMETHOD(BeginHemisphere)(THIS_
 585         LPDIRECT3DTEXTURE9 pTexZPos,
 586         LPDIRECT3DTEXTURE9 pTexZNeg) PURE;
 587
 588     STDMETHOD(BeginParabolic)(THIS_
 589         LPDIRECT3DTEXTURE9 pTexZPos,
 590         LPDIRECT3DTEXTURE9 pTexZNeg) PURE;
 591
 592     STDMETHOD(Face)(THIS_ D3DCUBEMAP_FACES Face, DWORD MipFilter) PURE;
 593     STDMETHOD(End)(THIS_ DWORD MipFilter) PURE;
 594
 595     STDMETHOD(OnLostDevice)(THIS) PURE;
 596     STDMETHOD(OnResetDevice)(THIS) PURE;
 597 };
 598
 599
 600 #ifdef __cplusplus
 601 extern "C" {
 602 #endif //__cplusplus
 603
 604 HRESULT WINAPI
 605     D3DXCreateRenderToEnvMap(
 606         LPDIRECT3DDEVICE9       pDevice,
 607         UINT                    Size,
 608         UINT                    MipLevels,
 609         D3DFORMAT               Format,
 610         BOOL                    DepthStencil,
 611         D3DFORMAT               DepthStencilFormat,
 612         LPD3DXRenderToEnvMap*   ppRenderToEnvMap);
 613
 614 #ifdef __cplusplus
 615 }
 616 #endif //__cplusplus
 617
 618
 619
 620 ///////////////////////////////////////////////////////////////////////////
 621 // ID3DXLine:
 622 // ------------
 623 // This object intends to provide an easy way to draw lines using D3D.
 624 //
 625 // Begin -
 626 //    Prepares device for drawing lines
 627 //
 628 // Draw -
 629 //    Draws a line strip in screen-space.
 630 //    Input is in the form of a array defining points on the line strip. of D3DXVECTOR2
 631 //
 632 // DrawTransform -
 633 //    Draws a line in screen-space with a specified input transformation matrix.
 634 //
 635 // End -
 636 //     Restores device state to how it was when Begin was called.
 637 //
 638 // SetPattern -
 639 //     Applies a stipple pattern to the line.  Input is one 32-bit
 640 //     DWORD which describes the stipple pattern. 1 is opaque, 0 is
 641 //     transparent.
 642 //
 643 // SetPatternScale -
 644 //     Stretches the stipple pattern in the u direction.  Input is one
 645 //     floating-point value.  0.0f is no scaling, whereas 1.0f doubles
 646 //     the length of the stipple pattern.
 647 //
 648 // SetWidth -
 649 //     Specifies the thickness of the line in the v direction.  Input is
 650 //     one floating-point value.
 651 //
 652 // SetAntialias -
 653 //     Toggles line antialiasing.  Input is a BOOL.
 654 //     TRUE  = Antialiasing on.
 655 //     FALSE = Antialiasing off.
 656 //
 657 // SetGLLines -
 658 //     Toggles non-antialiased OpenGL line emulation.  Input is a BOOL.
 659 //     TRUE  = OpenGL line emulation on.
 660 //     FALSE = OpenGL line emulation off.
 661 //
 662 // OpenGL line:     Regular line:
 663 //   *\                *\
 664 //   | \              /  \
 665 //   |  \            *\   \
 666 //   *\  \             \   \
 667 //     \  \             \   \
 668 //      \  *             \   *
 669 //       \ |              \ /
 670 //        \|               *
 671 //         *
 672 //
 673 // OnLostDevice, OnResetDevice -
 674 //    Call OnLostDevice() on this object before calling Reset() on the
 675 //    device, so that this object can release any stateblocks and video
 676 //    memory resources.  After Reset(), the call OnResetDevice().
 677 ///////////////////////////////////////////////////////////////////////////
 678
 679
 680 typedef interface ID3DXLine ID3DXLine;
 681 typedef interface ID3DXLine *LPD3DXLINE;
 682
 683
 684 // {D379BA7F-9042-4ac4-9F5E-58192A4C6BD8}
 685 DEFINE_GUID(IID_ID3DXLine,
 686 0xd379ba7f, 0x9042, 0x4ac4, 0x9f, 0x5e, 0x58, 0x19, 0x2a, 0x4c, 0x6b, 0xd8);
 687
 688 #undef INTERFACE
 689 #define INTERFACE ID3DXLine
 690
 691 DECLARE_INTERFACE_(ID3DXLine, IUnknown)
 692 {
 693     // IUnknown
 694     STDMETHOD(QueryInterface)(THIS_ REFIID iid, LPVOID *ppv) PURE;
 695     STDMETHOD_(ULONG, AddRef)(THIS) PURE;
 696     STDMETHOD_(ULONG, Release)(THIS) PURE;
 697
 698     // ID3DXLine
 699     STDMETHOD(GetDevice)(THIS_ LPDIRECT3DDEVICE9* ppDevice) PURE;
 700
 701     STDMETHOD(Begin)(THIS) PURE;
 702
 703     STDMETHOD(Draw)(THIS_ CONST D3DXVECTOR2 *pVertexList,
 704         DWORD dwVertexListCount, D3DCOLOR Color) PURE;
 705
 706     STDMETHOD(DrawTransform)(THIS_ CONST D3DXVECTOR3 *pVertexList,
 707         DWORD dwVertexListCount, CONST D3DXMATRIX* pTransform,
 708         D3DCOLOR Color) PURE;
 709
 710     STDMETHOD(SetPattern)(THIS_ DWORD dwPattern) PURE;
 711     STDMETHOD_(DWORD, GetPattern)(THIS) PURE;
 712
 713     STDMETHOD(SetPatternScale)(THIS_ FLOAT fPatternScale) PURE;
 714     STDMETHOD_(FLOAT, GetPatternScale)(THIS) PURE;
 715
 716     STDMETHOD(SetWidth)(THIS_ FLOAT fWidth) PURE;
 717     STDMETHOD_(FLOAT, GetWidth)(THIS) PURE;
 718
 719     STDMETHOD(SetAntialias)(THIS_ BOOL bAntialias) PURE;
 720     STDMETHOD_(BOOL, GetAntialias)(THIS) PURE;
 721
 722     STDMETHOD(SetGLLines)(THIS_ BOOL bGLLines) PURE;
 723     STDMETHOD_(BOOL, GetGLLines)(THIS) PURE;
 724
 725     STDMETHOD(End)(THIS) PURE;
 726
 727     STDMETHOD(OnLostDevice)(THIS) PURE;
 728     STDMETHOD(OnResetDevice)(THIS) PURE;
 729 };
 730
 731
 732 #ifdef __cplusplus
 733 extern "C" {
 734 #endif //__cplusplus
 735
 736
 737 HRESULT WINAPI
 738     D3DXCreateLine(
 739         LPDIRECT3DDEVICE9   pDevice,
 740         LPD3DXLINE*         ppLine);
 741
 742 #ifdef __cplusplus
 743 }
 744 #endif //__cplusplus
 745
 746 #endif //__D3DX9CORE_H__
 747