Función D3DXCreateTorus

Usa un sistema de coordenadas a la izquierda para crear una malla que contenga un toruso.

Sintaxis

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

Puntero a una interfaz IDirect3DDevice9 , que representa el dispositivo asociado a la malla torus creada.

InnerRadius [in]

Tipo: FLOAT

Radio interior del toruso. El valor debe ser mayor o igual que 0,0f.

OuterRadius [in]

Tipo: FLOAT

Radio exterior del toruso. El valor debe ser mayor o igual que 0,0f.

Lados [in]

Tipo: UINT

Número de lados de una sección transversal. El valor debe ser mayor o igual que 3.

Anillos [in]

Tipo: UINT

Número de anillos que componen el toruso. El valor debe ser mayor o igual que 3.

ppMesh [out]

Tipo: LPD3DXMESH*

Dirección de un puntero a la forma de salida, una interfaz ID3DXMesh .

ppAdjacency [out]

Tipo: LPD3DXBUFFER*

Dirección de un puntero a una interfaz ID3DXBuffer . Cuando el método devuelve, este parámetro se rellena con una matriz de tres DWORD por cara que especifican los tres vecinos para cada cara de la malla. Se puede especificar NULL.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Comentarios

El torus creado se centra en el origen y su eje se alinea con el eje z. El radio interno del toruso es el radio de la sección transversal (el radio menor) y el radio exterior del toruso es el radio del agujero central.

Esta función devuelve una malla que se puede usar más adelante para dibujar o manipular mediante la aplicación.

Esta función crea una malla con la opción de creación D3DXMESH_MANAGED y D3DFVF_XYZ | D3DFVF_NORMAL formato de vértice flexible (FVF).

Requisitos

Consulte también

Funciones de dibujo de formas