home *** CD-ROM | disk | FTP | other *** search
/ Beginning Direct3D Game Programming / Direct3D.iso / directx / dxf / include / d3dxshapes.h < prev    next >
C/C++ Source or Header  |  2000-09-22  |  10KB  |  210 lines
  1. ///////////////////////////////////////////////////////////////////////////
  2. //
  3. //  Copyright (C) 1999 Microsoft Corporation.  All Rights Reserved.
  4. //
  5. //  File:       d3dxshapes.h
  6. //  Content:    D3DX simple shapes
  7. //
  8. ///////////////////////////////////////////////////////////////////////////
  9.  
  10. #ifndef __D3DXSHAPES_H__
  11. #define __D3DXSHAPES_H__
  12.  
  13. #include <d3d.h>
  14. #include <limits.h>
  15. #include "d3dxerr.h"
  16.  
  17.  
  18. typedef struct ID3DXSimpleShape *LPD3DXSIMPLESHAPE;
  19.  
  20. // {CFCD4602-EB7B-11d2-A440-00A0C90629A8}
  21. DEFINE_GUID( IID_ID3DXSimpleShape, 
  22. 0xcfcd4602, 0xeb7b, 0x11d2, 0xa4, 0x40, 0x0, 0xa0, 0xc9, 0x6, 0x29, 0xa8 );
  23.  
  24.  
  25. ///////////////////////////////////////////////////////////////////////////
  26. // Interfaces:
  27. ///////////////////////////////////////////////////////////////////////////
  28.  
  29. //-------------------------------------------------------------------------
  30. // ID3DXSimpleShape interface: 
  31. //-------------------------------------------------------------------------
  32.  
  33. DECLARE_INTERFACE_(ID3DXSimpleShape, IUnknown)
  34. {
  35.     // IUnknown methods 
  36.     STDMETHOD(QueryInterface)(THIS_ REFIID  riid, LPVOID* ppvObj) PURE;
  37.     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
  38.     STDMETHOD_(ULONG,Release)(THIS) PURE;
  39.  
  40.     // ID3DXSimpleShape methods
  41.     STDMETHOD_(LPDIRECT3DVERTEXBUFFER7, GetVB)(THIS) PURE;
  42.     STDMETHOD_(DWORD, GetIndices)(THIS_ LPWORD *ppIndices) PURE;
  43.     STDMETHOD(Draw)(THIS) PURE;
  44. };
  45.  
  46.  
  47.  
  48. ///////////////////////////////////////////////////////////////////////////
  49. // Functions:
  50. ///////////////////////////////////////////////////////////////////////////
  51.  
  52. #ifdef __cplusplus
  53. extern "C" {
  54. #endif //__cplusplus
  55.  
  56.  
  57. //-------------------------------------------------------------------------
  58. // D3DXCreatePolygon: Creates an 'n' sided polygon using the device
  59. // ----------------  specified. It returns a vertex buffer that can be used
  60. //                   for drawing or manipulation by the program later on.
  61. //
  62. // Params: 
  63. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  64. //     [in]  float sideSize: Length of a side.
  65. //     [in]  DWORD numTexCoords:   The number of texture coordinates desired
  66. //                                 in the vertex-buffer. (Default is 1)
  67. //                                 D3DX_DEFAULT is a valid input.
  68. //     [out] IDirect3DVertexBuffer7** ppVB: The output shape interface.
  69. //-------------------------------------------------------------------------
  70. HRESULT WINAPI 
  71.     D3DXCreatePolygon(LPDIRECT3DDEVICE7  pDevice,
  72.                       float              sideSize, 
  73.                       DWORD              numSides, 
  74.                       DWORD              numTexCoords, 
  75.                       LPD3DXSIMPLESHAPE* ppShape );
  76.  
  77. //-------------------------------------------------------------------------
  78. // D3DXCreateBox: Creates a box (cuboid) of given dimensions using the  
  79. // ------------  device. It returns a vertex buffer that can
  80. //               be used for drawing or manipulation by the program later on.
  81. //
  82. // Params: 
  83. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  84. //     [in]  float width: Width of the box (along x-axis)
  85. //     [in]  float height: Height of the box (along y-axis)
  86. //     [in]  float depth: Depth of the box (along z-axis)
  87. //     [in]  DWORD numTexCoords: The number of texture coordinates desired
  88. //                               in the vertex-buffer. Default is 1. 
  89. //                               D3DX_DEFAULT is a valid input here.
  90. //     [out] LPD3DXSIMPLESHAPE* ppShape: The output vertex-buffer.
  91. //-------------------------------------------------------------------------
  92. HRESULT WINAPI 
  93.     D3DXCreateBox(LPDIRECT3DDEVICE7  pDevice, 
  94.                   float              width,
  95.                   float              height,
  96.                   float              depth,
  97.                   DWORD              numTexCoords, 
  98.                   LPD3DXSIMPLESHAPE* ppShape );
  99.  
  100. //-------------------------------------------------------------------------
  101. // D3DXCreateCylinder: Creates a cylinder of given dimensions using the  
  102. // -----------------  device. It returns a vertex buffer that
  103. //                    can be used for drawing or manipulation by the program
  104. //                    later on.
  105. //
  106. // Params: 
  107. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  108. //     [in]  float baseRadius: Base-radius (default is 1.0f, shd be >= 0.0f)
  109. //     [in]  float topRadius: Top-radius (default is 1.0f, shd be >= 0.0f)
  110. //     [in]  float height: Height (default is 1.0f, shd be >= 0.0f)
  111. //     [in]  DWORD numSlices: Number of slices about the main axis.
  112. //                            (default is 8) D3DX_DEFAULT is a valid input.
  113. //     [in]  DWORD numStacks: Number of stacks along the main axis. 
  114. //                            (default is 8) D3DX_DEFAULT is a valid input.
  115. //     [in]  DWORD numTexCoords: The number of texture coordinates desired
  116. //                               in the vertex-buffer. Default is 1. 
  117. //                               D3DX_DEFAULT is a valid input here.
  118. //     [out] LPD3DXSIMPLESHAPE* ppShape: The output shape interface.
  119. //-------------------------------------------------------------------------
  120. HRESULT WINAPI 
  121.     D3DXCreateCylinder(LPDIRECT3DDEVICE7  pDevice,
  122.                        float              baseRadius, 
  123.                        float              topRadius, 
  124.                        float              height, 
  125.                        DWORD              numSlices, 
  126.                        DWORD              numStacks,   
  127.                        DWORD              numTexCoords, 
  128.                        LPD3DXSIMPLESHAPE* ppShape );
  129.  
  130.  
  131. //-------------------------------------------------------------------------
  132. // D3DXCreateTorus: Creates a torus of given dimensions using the  
  133. // --------------  device specified. It returns a vertex buffer that can
  134. //                 be used for drawing or manipulation by the program later
  135. //                 on. It draws a doughnut, centered at (0, 0, 0) whose axis 
  136. //                 is aligned with the z-axis. With the innerRadius used
  137. //                 as the radius of the cross-section (minor-Radius) and 
  138. //                 the outerRadius used as the radius of the central 'hole'. 
  139. //
  140. // Params: 
  141. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  142. //     [in]  float innerRadius: inner radius (default is 1.0f, shd be >= 0.0f)
  143. //     [in]  float outerRadius: outer radius (default is 2.0f, shd be >= 0.0f)
  144. //     [in]  DWORD numSides: Number of sides in the cross-section 
  145. //                           (default is 8). D3DX_DEFAULT is a valid input.
  146. //     [in]  DWORD numRings: Number of rings making up the torus 
  147. //                           (default is 8) D3DX_DEFAULT is a valid input.
  148. //     [in]  DWORD numTexCoords: The number of texture coordinates desired
  149. //                                 in the vertex-buffer. Default is 1. 
  150. //                                 D3DX_DEFAULT is a valid input here.
  151. //     [out] LPD3DXSIMPLESHAPE* ppShape: The output shape interface.
  152. //-------------------------------------------------------------------------
  153. HRESULT WINAPI
  154.     D3DXCreateTorus(LPDIRECT3DDEVICE7  pDevice,
  155.                     float              innerRadius,
  156.                     float              outerRadius, 
  157.                     DWORD              numSides,
  158.                     DWORD              numRings, 
  159.                     DWORD              numTexCoords,  
  160.                     LPD3DXSIMPLESHAPE* ppShape );
  161.  
  162. //-------------------------------------------------------------------------
  163. // D3DXCreateTeapot: Creates a teapot using the device specified. 
  164. // ----------------  It returns a vertex buffer that can be used for
  165. //                   drawing or manipulation by the program later on.
  166. //
  167. // Params: 
  168. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  169. //     [in]  DWORD numTexCoords: The number of texture coordinates desired
  170. //                               in the vertex-buffer. Default is 1. 
  171. //                               D3DX_DEFAULT is a valid input here.
  172. //     [out] LPD3DXSIMPLESHAPE* ppShape: The output shape interface.
  173. //-------------------------------------------------------------------------
  174. HRESULT WINAPI
  175.     D3DXCreateTeapot(LPDIRECT3DDEVICE7  pDevice,
  176.                      DWORD              numTexCoords, 
  177.                      LPD3DXSIMPLESHAPE* ppShape);
  178.  
  179. //-------------------------------------------------------------------------
  180. // D3DXCreateSphere: Creates a cylinder of given dimensions using the
  181. // ----------------  device specified. 
  182. //                   It returns a vertex buffer that can be used for
  183. //                   drawing or manipulation by the program later on.
  184. //
  185. // Params: 
  186. //     [in]  LPDIRECT3DDEVICE7 pDevice: The device to create off. 
  187. //     [in]  float radius: radius (default is 1.0f, shd be >= 0.0f)
  188. //     [in]  float height: Height (default is 1.0f, shd be >= 0.0f)
  189. //     [in]  DWORD numSlices: Number of slices about the main axis
  190. //                            (default is 8) D3DX_DEFAULT is a valid input.
  191. //     [in]  DWORD numStacks: Number of stacks along the main axis
  192. //                            (default is 8) D3DX_DEFAULT is a valid input.
  193. //     [in]  DWORD numTexCoords: The number of texture coordinates desired
  194. //                               in the vertex-buffer. Default is 1. 
  195. //                               D3DX_DEFAULT is a valid input here.
  196. //     [out] LPD3DXSIMPLESHAPE* ppShape: The output shape interface.
  197. //-------------------------------------------------------------------------
  198. HRESULT WINAPI
  199.     D3DXCreateSphere(LPDIRECT3DDEVICE7  pDevice, 
  200.                      float              radius, 
  201.                      DWORD              numSlices, 
  202.                      DWORD              numStacks,
  203.                      DWORD              numTexCoords, 
  204.                      LPD3DXSIMPLESHAPE* ppShape);
  205.  
  206. #ifdef __cplusplus
  207. }
  208. #endif //__cplusplus    
  209. #endif //__D3DXSHAPES_H__
  210.