Microsoft DirectX 8.0 (C++)

D3DXCreateTorus

左手座標系を使用し、トーラスのメッシュを作成する。

HRESULT D3DXCreateTorus(
  LPDIRECT3DDEVICE8 pDevice,
  FLOAT InnerRadius,
  FLOAT OuterRadius,
  UINT Sides,
  UINT Rings,
  LPD3DXMESH* ppMesh,
  LPD3DXBUFFER* ppAdjacency
);

パラメータ

pDevice
[in] 作成されるトーラス メッシュに関連付けられるデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
InnerRadius
[in] トーラスの内部の半径。値は 0.0f 以上である必要がある。
OuterRadius
[in] トーラスの外部の半径。値は 0.0f 以上である必要がある。
Sides
[in] 横断面の辺の数。値は 3 以上である必要がある。
Rings
[in] トーラスを構成する環の数。値は 3 以上である必要がある。
ppMesh
[out] ID3DXMesh インターフェイスの出力形状へのポインタのアドレス。
ppAdjacency
[out] ID3DXBuffer インターフェイスへのポインタのアドレス。メソッドが返ると、このパラメータには、メッシュに含まれる各面の 3 つの隣接面を指定する、1 面あたりの 3 つの DWORD の配列が入力される。NULL を指定できる。

戻り値

成功した場合は D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

注意

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

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

動作環境

  ヘッダー : D3dx8shape.h で宣言。
  インポート ライブラリ : D3dx8.lib を使用。