D3DXCreateTorus 函式
使用左手座標系統來建立包含 Torus 的網格。
語法
HRESULT D3DXCreateTorus(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ FLOAT InnerRadius,
_In_ FLOAT OuterRadius,
_In_ UINT Sides,
_In_ UINT Rings,
_Out_ LPD3DXMESH *ppMesh,
_Out_ LPD3DXBUFFER *ppAdjacency
);
參數
-
pDevice [in]
-
IDirect3DDevice9介面的指標，代表與已建立的 torus 網格相關聯的裝置。
-
InnerRadius [in]
-
類型： FLOAT
圓圈的內部半徑。 值應大於或等於 0.0f。
-
OuterRadius [in]
-
類型： FLOAT
Torus 的外部半徑。 值應大於或等於 0.0f。
-
側邊 [in]
-
類型： UINT
交叉區段中的邊數。 值必須大於或等於 3。
-
環形 [in]
-
類型： UINT
構成環形的環形數目。 值必須大於或等於 3。
-
ppMesh [out]
-
類型： LPD3DXMESH*
輸出圖形指標的位址， ID3DXMesh 介面。
-
ppAdjacency [out]
-
類型： LPD3DXBUFFER*
ID3DXBuffer介面指標的位址。 當方法傳回時，這個參數會填入每個臉部三個 DWORD 的陣列，指定網格中每個臉部的三個芳鄰。 可以指定Null。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
備註
建立的圖文會置中于原點，且其座標軸與 Z 軸對齊。 torus 的內部半徑是交叉區段的半徑 (次要半徑) ，而 torus 的外部半徑是中央孔的半徑。
此函式會傳回網格，以供稍後用於應用程式繪製或操作。
此函式會使用D3DXMESH_MANAGED建立選項和D3DFVF_XYZ建立網格 |D3DFVF_NORMAL (FVF) 彈性頂點格式。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱