Función D3DXCreateCubeTexture

Crea una textura de cubo vacía, ajustando los parámetros de llamada según sea necesario.

Sintaxis

HRESULT D3DXCreateCubeTexture(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  UINT                   Size,
  _In_  UINT                   MipLevels,
  _In_  DWORD                  Usage,
  _In_  D3DFORMAT              Format,
  _In_  D3DPOOL                Pool,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero a una interfaz IDirect3DDevice9 , que representa el dispositivo que se va a asociar a la textura.

Tamaño [in]

Tipo: UINT

Ancho y alto de la textura del cubo, en píxeles. Por ejemplo, si la textura del cubo es un cubo de 8 píxeles por 8 píxeles, el valor de este parámetro debe ser 8.

MipLevels [in]

Tipo: UINT

Número de niveles mip solicitados. Si este valor es cero o D3DX_DEFAULT, se crea una cadena de mapas MIP completa.

Uso [in]

Tipo: DWORD

0, D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC. Establecer esta marca en D3DUSAGE_RENDERTARGET indica que la superficie se va a usar como destino de representación. A continuación, el recurso se puede pasar al parámetro pNewRenderTarget del método SetRenderTarget . Si se especifica D3DUSAGE_RENDERTARGET, la aplicación debe comprobar que el dispositivo admite esta operación mediante una llamada a CheckDeviceFormat. Para obtener más información sobre el uso de texturas dinámicas, consulte Uso de texturas dinámicas.

Formato [in]

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato de píxel solicitado para la textura del cubo. La textura de cubo devuelta podría tener un formato diferente del especificado por Format. Las aplicaciones deben comprobar el formato de la textura de cubo devuelta.

Piscina [in]

Tipo: D3DPOOL

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

ppCubeTexture [out]

Tipo: LPDIRECT3DCUBETEXTURE9*

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

Valor devuelto

Tipo: HRESULT

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

Comentarios

Las texturas de cubo difieren de otras superficies en que son colecciones de superficies.

Internamente, D3DXCreateCubeTexture usa D3DXCheckCubeTextureRequirements para ajustar los parámetros de llamada. Por lo tanto, las llamadas a D3DXCreateCubeTexture a menudo se realizarán correctamente en las llamadas a CreateCubeTexture .

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9