api/include/d3dx8shape.h

///////////////////////////////////////////////////////////////////////////
//
//  Copyright (C) 1999 Microsoft Corporation.  All Rights Reserved.
//
//  File:       d3dx8shapes.h
//  Content:    D3DX simple shapes
//
///////////////////////////////////////////////////////////////////////////

#include "d3dx8.h"

#ifndef __D3DX8SHAPES_H__
#define __D3DX8SHAPES_H__

///////////////////////////////////////////////////////////////////////////
// Functions:
///////////////////////////////////////////////////////////////////////////

#ifdef __cplusplus
extern "C" {
#endif //__cplusplus


//-------------------------------------------------------------------------
// D3DXCreatePolygon: 
// ------------------
// Creates a mesh containing an n-sided polygon.  The polygon is centered
// at the origin.
//
// Parameters:
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  Length      Length of each side.
//  Sides       Number of sides the polygon has.  (Must be >= 3)
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI 
    D3DXCreatePolygon(
        LPDIRECT3DDEVICE8   pDevice,
        FLOAT               Length, 
        UINT                Sides, 
        LPD3DXMESH*         ppMesh,
        LPD3DXBUFFER*       ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateBox: 
// --------------
// Creates a mesh containing an axis-aligned box.  The box is centered at
// the origin.
//
// Parameters:
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  Width       Width of box (along X-axis)
//  Height      Height of box (along Y-axis)
//  Depth       Depth of box (along Z-axis)
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI 
    D3DXCreateBox(
        LPDIRECT3DDEVICE8   pDevice, 
        FLOAT               Width,
        FLOAT               Height,
        FLOAT               Depth,
        LPD3DXMESH*         ppMesh,
        LPD3DXBUFFER*       ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateCylinder:
// -------------------
// Creates a mesh containing a cylinder.  The generated cylinder is
// centered at the origin, and its axis is aligned with the Z-axis.
//
// Parameters:
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  Radius1     Radius at -Z end (should be >= 0.0f)
//  Radius2     Radius at +Z end (should be >= 0.0f)
//  Length      Length of cylinder (along Z-axis)
//  Slices      Number of slices about the main axis
//  Stacks      Number of stacks along the main axis
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI 
    D3DXCreateCylinder(
        LPDIRECT3DDEVICE8   pDevice,
        FLOAT               Radius1, 
        FLOAT               Radius2, 
        FLOAT               Length, 
        UINT                Slices, 
        UINT                Stacks,   
        LPD3DXMESH*         ppMesh,
        LPD3DXBUFFER*       ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateSphere:
// -----------------
// Creates a mesh containing a sphere.  The sphere is centered at the
// origin.
//
// Parameters:
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  Radius      Radius of the sphere (should be >= 0.0f)
//  Slices      Number of slices about the main axis
//  Stacks      Number of stacks along the main axis
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI
    D3DXCreateSphere(
        LPDIRECT3DDEVICE8  pDevice, 
        FLOAT              Radius, 
        UINT               Slices, 
        UINT               Stacks,
        LPD3DXMESH*        ppMesh,
        LPD3DXBUFFER*      ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateTorus:
// ----------------
// Creates a mesh containing a torus.  The generated torus is centered at
// the origin, and its axis is aligned with the Z-axis.
//
// Parameters: 
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  InnerRadius Inner radius of the torus (should be >= 0.0f)
//  OuterRadius Outer radius of the torue (should be >= 0.0f)
//  Sides       Number of sides in a cross-section (must be >= 3)
//  Rings       Number of rings making up the torus (must be >= 3)
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI
    D3DXCreateTorus(
        LPDIRECT3DDEVICE8   pDevice,
        FLOAT               InnerRadius,
        FLOAT               OuterRadius, 
        UINT                Sides,
        UINT                Rings, 
        LPD3DXMESH*         ppMesh,
        LPD3DXBUFFER*       ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateTeapot: 
// -----------------
// Creates a mesh containing a teapot.
//
// Parameters: 
//
//  pDevice     The D3D device with which the mesh is going to be used.
//  ppMesh      The mesh object which will be created
//  ppAdjacency Returns a buffer containing adjacency info.  Can be NULL.
//-------------------------------------------------------------------------
HRESULT WINAPI
    D3DXCreateTeapot(
        LPDIRECT3DDEVICE8   pDevice,
        LPD3DXMESH*         ppMesh,
        LPD3DXBUFFER*       ppAdjacency);


//-------------------------------------------------------------------------
// D3DXCreateText: 
// --------------- 
// Creates a mesh containing the specified text using the font associated
// with the device context.
//
// Parameters:
//
//  pDevice       The D3D device with which the mesh is going to be used.
//  hDC           Device context, with desired font selected
//  pText         Text to generate
//  Deviation     Maximum chordal deviation from true font outlines
//  Extrusion     Amount to extrude text in -Z direction
//  ppMesh        The mesh object which will be created
//  pGlyphMetrics Address of buffer to receive glyph metric data (or NULL)
//-------------------------------------------------------------------------
HRESULT WINAPI
    D3DXCreateTextA(
        LPDIRECT3DDEVICE8   pDevice,
        HDC                 hDC,
        LPCSTR              pText,
        FLOAT               Deviation,
        FLOAT               Extrusion,
        LPD3DXMESH*         ppMesh,
        LPGLYPHMETRICSFLOAT pGlyphMetrics);

HRESULT WINAPI
    D3DXCreateTextW(
        LPDIRECT3DDEVICE8   pDevice,
        HDC                 hDC,
        LPCWSTR             pText,
        FLOAT               Deviation,
        FLOAT               Extrusion,
        LPD3DXMESH*         ppMesh,
        LPGLYPHMETRICSFLOAT pGlyphMetrics);

#ifdef UNICODE
#define D3DXCreateText D3DXCreateTextW
#else
#define D3DXCreateText D3DXCreateTextA
#endif


#ifdef __cplusplus
}
#endif //__cplusplus    

#endif //__D3DX8SHAPES_H__
1	bearsoft	1.1	///////////////////////////////////////////////////////////////////////////
2			//
3			// Copyright (C) 1999 Microsoft Corporation. All Rights Reserved.
4			//
5			// File: d3dx8shapes.h
6			// Content: D3DX simple shapes
7			//
8			///////////////////////////////////////////////////////////////////////////
9
10			#include "d3dx8.h"
11
12			#ifndef __D3DX8SHAPES_H__
13			#define __D3DX8SHAPES_H__
14
15			///////////////////////////////////////////////////////////////////////////
16			// Functions:
17			///////////////////////////////////////////////////////////////////////////
18
19			#ifdef __cplusplus
20			extern "C" {
21			#endif //__cplusplus
22
23
24			//-------------------------------------------------------------------------
25			// D3DXCreatePolygon:
26			// ------------------
27			// Creates a mesh containing an n-sided polygon. The polygon is centered
28			// at the origin.
29			//
30			// Parameters:
31			//
32			// pDevice The D3D device with which the mesh is going to be used.
33			// Length Length of each side.
34			// Sides Number of sides the polygon has. (Must be >= 3)
35			// ppMesh The mesh object which will be created
36			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
37			//-------------------------------------------------------------------------
38			HRESULT WINAPI
39			D3DXCreatePolygon(
40			LPDIRECT3DDEVICE8 pDevice,
41			FLOAT Length,
42			UINT Sides,
43			LPD3DXMESH* ppMesh,
44			LPD3DXBUFFER* ppAdjacency);
45
46
47			//-------------------------------------------------------------------------
48			// D3DXCreateBox:
49			// --------------
50			// Creates a mesh containing an axis-aligned box. The box is centered at
51			// the origin.
52			//
53			// Parameters:
54			//
55			// pDevice The D3D device with which the mesh is going to be used.
56			// Width Width of box (along X-axis)
57			// Height Height of box (along Y-axis)
58			// Depth Depth of box (along Z-axis)
59			// ppMesh The mesh object which will be created
60			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
61			//-------------------------------------------------------------------------
62			HRESULT WINAPI
63			D3DXCreateBox(
64			LPDIRECT3DDEVICE8 pDevice,
65			FLOAT Width,
66			FLOAT Height,
67			FLOAT Depth,
68			LPD3DXMESH* ppMesh,
69			LPD3DXBUFFER* ppAdjacency);
70
71
72			//-------------------------------------------------------------------------
73			// D3DXCreateCylinder:
74			// -------------------
75			// Creates a mesh containing a cylinder. The generated cylinder is
76			// centered at the origin, and its axis is aligned with the Z-axis.
77			//
78			// Parameters:
79			//
80			// pDevice The D3D device with which the mesh is going to be used.
81			// Radius1 Radius at -Z end (should be >= 0.0f)
82			// Radius2 Radius at +Z end (should be >= 0.0f)
83			// Length Length of cylinder (along Z-axis)
84			// Slices Number of slices about the main axis
85			// Stacks Number of stacks along the main axis
86			// ppMesh The mesh object which will be created
87			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
88			//-------------------------------------------------------------------------
89			HRESULT WINAPI
90			D3DXCreateCylinder(
91			LPDIRECT3DDEVICE8 pDevice,
92			FLOAT Radius1,
93			FLOAT Radius2,
94			FLOAT Length,
95			UINT Slices,
96			UINT Stacks,
97			LPD3DXMESH* ppMesh,
98			LPD3DXBUFFER* ppAdjacency);
99
100
101			//-------------------------------------------------------------------------
102			// D3DXCreateSphere:
103			// -----------------
104			// Creates a mesh containing a sphere. The sphere is centered at the
105			// origin.
106			//
107			// Parameters:
108			//
109			// pDevice The D3D device with which the mesh is going to be used.
110			// Radius Radius of the sphere (should be >= 0.0f)
111			// Slices Number of slices about the main axis
112			// Stacks Number of stacks along the main axis
113			// ppMesh The mesh object which will be created
114			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
115			//-------------------------------------------------------------------------
116			HRESULT WINAPI
117			D3DXCreateSphere(
118			LPDIRECT3DDEVICE8 pDevice,
119			FLOAT Radius,
120			UINT Slices,
121			UINT Stacks,
122			LPD3DXMESH* ppMesh,
123			LPD3DXBUFFER* ppAdjacency);
124
125
126			//-------------------------------------------------------------------------
127			// D3DXCreateTorus:
128			// ----------------
129			// Creates a mesh containing a torus. The generated torus is centered at
130			// the origin, and its axis is aligned with the Z-axis.
131			//
132			// Parameters:
133			//
134			// pDevice The D3D device with which the mesh is going to be used.
135			// InnerRadius Inner radius of the torus (should be >= 0.0f)
136			// OuterRadius Outer radius of the torue (should be >= 0.0f)
137			// Sides Number of sides in a cross-section (must be >= 3)
138			// Rings Number of rings making up the torus (must be >= 3)
139			// ppMesh The mesh object which will be created
140			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
141			//-------------------------------------------------------------------------
142			HRESULT WINAPI
143			D3DXCreateTorus(
144			LPDIRECT3DDEVICE8 pDevice,
145			FLOAT InnerRadius,
146			FLOAT OuterRadius,
147			UINT Sides,
148			UINT Rings,
149			LPD3DXMESH* ppMesh,
150			LPD3DXBUFFER* ppAdjacency);
151
152
153			//-------------------------------------------------------------------------
154			// D3DXCreateTeapot:
155			// -----------------
156			// Creates a mesh containing a teapot.
157			//
158			// Parameters:
159			//
160			// pDevice The D3D device with which the mesh is going to be used.
161			// ppMesh The mesh object which will be created
162			// ppAdjacency Returns a buffer containing adjacency info. Can be NULL.
163			//-------------------------------------------------------------------------
164			HRESULT WINAPI
165			D3DXCreateTeapot(
166			LPDIRECT3DDEVICE8 pDevice,
167			LPD3DXMESH* ppMesh,
168			LPD3DXBUFFER* ppAdjacency);
169
170
171			//-------------------------------------------------------------------------
172			// D3DXCreateText:
173			// ---------------
174			// Creates a mesh containing the specified text using the font associated
175			// with the device context.
176			//
177			// Parameters:
178			//
179			// pDevice The D3D device with which the mesh is going to be used.
180			// hDC Device context, with desired font selected
181			// pText Text to generate
182			// Deviation Maximum chordal deviation from true font outlines
183			// Extrusion Amount to extrude text in -Z direction
184			// ppMesh The mesh object which will be created
185			// pGlyphMetrics Address of buffer to receive glyph metric data (or NULL)
186			//-------------------------------------------------------------------------
187			HRESULT WINAPI
188			D3DXCreateTextA(
189			LPDIRECT3DDEVICE8 pDevice,
190			HDC hDC,
191			LPCSTR pText,
192			FLOAT Deviation,
193			FLOAT Extrusion,
194			LPD3DXMESH* ppMesh,
195			LPGLYPHMETRICSFLOAT pGlyphMetrics);
196
197			HRESULT WINAPI
198			D3DXCreateTextW(
199			LPDIRECT3DDEVICE8 pDevice,
200			HDC hDC,
201			LPCWSTR pText,
202			FLOAT Deviation,
203			FLOAT Extrusion,
204			LPD3DXMESH* ppMesh,
205			LPGLYPHMETRICSFLOAT pGlyphMetrics);
206
207			#ifdef UNICODE
208			#define D3DXCreateText D3DXCreateTextW
209			#else
210			#define D3DXCreateText D3DXCreateTextA
211			#endif
212
213
214			#ifdef __cplusplus
215			}
216			#endif //__cplusplus
217
218			#endif //__D3DX8SHAPES_H__