Função D3DXCreateTorus
Usa um sistema de coordenadas canhoto para criar uma malha que contém um torus.
Sintaxe
HRESULT D3DXCreateTorus(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ FLOAT InnerRadius,
_In_ FLOAT OuterRadius,
_In_ UINT Sides,
_In_ UINT Rings,
_Out_ LPD3DXMESH *ppMesh,
_Out_ LPD3DXBUFFER *ppAdjacency
);
Parâmetros
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Ponteiro para uma interface IDirect3DDevice9 , representando o dispositivo associado à malha de torus criada.
-
InnerRadius [in]
-
Tipo: FLOAT
Raio interno do toro. O valor deve ser maior ou igual a 0,0f.
-
OuterRadius [in]
-
Tipo: FLOAT
Raio externo do toro. O valor deve ser maior ou igual a 0,0f.
-
Lados [in]
-
Tipo: UINT
Número de lados em uma seção cruzada. O valor deve ser maior ou igual a 3.
-
Anéis [in]
-
Tipo: UINT
Número de anéis que compõem o torus. O valor deve ser maior ou igual a 3.
-
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 torus criado é centralizado na origem e seu eixo é alinhado com o eixo z. O raio interno do toro é o raio da seção cruzada (o raio secundário) e o raio externo do toro é o raio do buraco central.
Essa função retorna uma malha que pode ser usada posteriormente para desenho ou manipulação pelo aplicativo.
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 |
|
| Biblioteca |
|
Confira também