Compartilhar via


Função D3DXCreateCylinder

Usa um sistema de coordenadas canhoto para criar uma malha contendo um cilindro.

Sintaxe

HRESULT D3DXCreateCylinder(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  FLOAT             Radius1,
  _In_  FLOAT             Radius2,
  _In_  FLOAT             Length,
  _In_  UINT              Slices,
  _In_  UINT              Stacks,
  _Out_ LPD3DXMESH        *ppMesh,
  _Out_ LPD3DXBUFFER      *ppAdjacency
);

Parâmetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Ponteiro para uma interface IDirect3DDevice9 , representando o dispositivo associado à malha de cilindro criada.

Radius1 [in]

Tipo: FLOAT

Raio na extremidade Z negativa. O valor deve ser maior ou igual a 0,0f.

Radius2 [in]

Tipo: FLOAT

Raio na extremidade Z positiva. O valor deve ser maior ou igual a 0,0f.

Comprimento [in]

Tipo: FLOAT

Comprimento do cilindro ao longo do eixo z.

Fatias [in]

Tipo: UINT

Número de fatias sobre o eixo main.

Pilhas [in]

Tipo: UINT

Número de pilhas ao longo do eixo main.

ppMesh [out]

Tipo: LPD3DXMESH*

Endereço de um ponteiro para a forma de saída, uma interface ID3DXMesh .

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Endereço de um ponteiro para uma interface ID3DXBuffer . Quando o método retorna, esse parâmetro é preenchido com uma matriz de três DWORDs por rosto que especificam os três vizinhos para cada rosto na malha. NULL pode ser especificado.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.

Comentários

O cilindro criado é centralizado na origem e seu eixo é alinhado com o eixo z.

Essa função cria uma malha com a opção de criação D3DXMESH_MANAGED e D3DFVF_XYZ | D3DFVF_NORMAL FVF (formato de vértice flexível).

Requisitos

Requisito Valor
parâmetro
D3dx9shape.h
Biblioteca
D3dx9.lib

Confira também

Funções de desenho de forma