Platform SDK: DirectX

D3DXCreateCylinder

D3DXCreateCylinder 関数は、指定されたディメンジョンの円柱を作成する。

HRESULT D3DXCreateCylinder(
  LPDIRECT3DDEVICE7 pDevice,
  float baseRadius,
  float topRadius,
  float height,
  DWORD numSlices,
  DWORD numStacks,
  DWORD numTexCoords,
  ID3DXSimpleShape** ppShape
);

パラメータ

pDevice
デバイスの IDirect3DDevice7 インターフェイスへのポインタ。
baseRadius
円柱の底面の半径。デフォルト値は、1.0f である。このパラメータは、0.0f 以上でなければならない。
topRadius
円柱の上面の半径。デフォルト値は、1.0f である。このパラメータは、0.0f 以上でなければならない。
height
円柱の高さ。デフォルト値は、1.0f である。このパラメータは、0.0f 以上でなければならない。
numSlices
主軸を回転軸としたスライスの数。デフォルト値は 8 である。このパラメータには、D3DX_DEFAULT を入力可能である。
numStacks
主軸に沿ったスタック数。デフォルト値は 8 である。このパラメータには、D3DX_DEFAULT を入力可能である。
numTexCoords
出力頂点バッファの目的のテクスチャ座標数。デフォルト値は 1 である。このパラメータには、D3DX_DEFAULT を入力可能である。
ppShape
出力頂点バッファの ID3DXSimpleShape インターフェイスへのポインタのアドレス。

戻り値

成功すれば、S_OK を返す。

失敗すれば、次いずれかの値を返す。

CLASS_E_NOAGGREGATION
D3DERR_INVALIDPRIMITIVETYPE
D3DERR_INVALIDRAMPTEXTURE
D3DERR_INVALIDVERTEXFORMAT
D3DERR_INVALIDVERTEXTYPE
D3DERR_VBUF_CREATE_FAILED
D3DXERR_INVALIDPARAMETER
D3DXERR_NOMEMORY
D3DXERR_NULLPOINTER
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY
DDERR_WASSTILLDRAWING

注意

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以上が必要。Windows 95 用に再配布可能な形で使用可能。
  バージョン : DirectX 7.0 が必要。
  ヘッダー : d3dxshapes.h で宣言。
  ライブラリ : d3dx.lib を使用。

参照

D3DXCreateBoxD3DXCreatePolygonD3DXCreateSphereD3DXCreateTeapotD3DXCreateTorus