Método IDirect3DDevice9::CreateCubeTexture (d3d9.h)

Artículo
08/23/2023

Crea un recurso de textura de cubo.

Sintaxis

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Parámetros

[in] EdgeLength

Tipo: UINT

Tamaño de los bordes de todas las caras de nivel superior de la textura del cubo. Las dimensiones de píxeles de los niveles posteriores de cada cara serán el valor truncado de la mitad de la dimensión de píxel del nivel anterior (independientemente). Cada dimensión se fija en un tamaño de 1 píxel. Por lo tanto, si la división en 2 da como resultado 0 (cero), se tomará 1 en su lugar.

[in] Levels

Tipo: UINT

Número de niveles en cada cara de la textura del cubo. Si es cero, Direct3D generará todos los subveles de textura del cubo hasta 1x1 píxeles para cada cara para el hardware que admita texturas de cubo mipmapped. Llame a IDirect3DBaseTexture9::GetLevelCount para ver el número de niveles generados.

[in] Usage

Tipo: DWORD

El uso puede ser 0, lo que indica que no hay ningún valor de uso. Sin embargo, si se desea el uso, use una combinación de una o varias constantes D3DUSAGE . Se recomienda hacer coincidir el parámetro de uso en CreateCubeTexture con las marcas de comportamiento en IDirect3D9::CreateDevice. Para obtener más información, vea la sección Comentarios.

[in] Format

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato de todos los niveles en todas las caras de la textura del cubo.

[in] Pool

Tipo: D3DPOOL

Miembro del tipo enumerado D3DPOOL , que describe la clase de memoria en la que se debe colocar la textura del cubo.

[out, retval] ppCubeTexture

Tipo: IDirect3DCubeTexture9**

Dirección de un puntero a una interfaz IDirect3DCubeTexture9 , que representa el recurso de textura del cubo creado.

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Establezca este parámetro en NULL. Este parámetro se puede usar en Direct3D 9 para Windows Vista para compartir recursos.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Comentarios

Un mapa mip (textura) es una colección de superficies de muestreo descendentes sucesivamente (mipmapped). Por otro lado, una textura de cubo (creada por IDirect3DDevice9::CreateCubeTexture) es una colección de seis texturas (mapas mip), una para cada cara. Todas las caras deben estar presentes en la textura del cubo. Además, una superficie de mapa de cubo debe tener el mismo tamaño de píxel en las tres dimensiones (x, y y z).

Una aplicación puede detectar compatibilidad con la generación automática de mapas Mip (Direct3D 9) en un formato determinado llamando a IDirect3D9::CheckDeviceFormat con D3DUSAGE_AUTOGENMIPMAP. Si IDirect3D9::CheckDeviceFormat devuelve D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture se realizará correctamente, pero devolverá una textura de un nivel.