Microsoft DirectX 8.0 (Visual Basic)

D3DX8.CreateTorus

トーラスのメッシュを作成する。

object.CreateTorus( _ 
    D3DDevice As Direct3DDevice8, _ 
    InnerRadius As Single, _ 
    OuterRadius As Single, _ 
    Sides As Long, _ 
    Rings As Long, _ 
    RetAdjacency As D3DXBuffer) As D3DXMesh

指定項目

object
D3DX8 オブジェクトを表すオブジェクト式。
D3DDevice
テクスチャに関連付けられているデバイスを表す Direct3DDevice8 オブジェクト。
InnerRadius
トーラスの内部の半径。値は 0 以上である必要がある。
OuterRadius
トーラスの外部の半径。値は 0 以上である必要がある。
Sides
横断面の辺の数。値は 3 以上である必要がある。
Rings
トーラスを構成する環の数。値は 3 以上である必要がある。
RetAdjacency
D3DXBuffer オブジェクト。メソッドが返ると、このパラメータには、メッシュに含まれる各面の 3 つの隣接面を指定する、1 面あたりの 3 つの Long 値の配列が入力される。

戻り値

作成されたトーラスを表す D3DXMesh オブジェクト。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

CreateTorus メソッドは、中心が (0, 0, 0) で軸が z 軸方向のドーナツ型の図形 (トーラス) を作成する。このトーラスの内部の半径は横断面の半径 (小さい方の半径)、外部の半径は中央の穴の半径である。

このメソッドは、後でアプリケーションにより描画したり、操作するときに使用できるメッシュを返す。