Función D3DXCreateCubeTextureFromResource
Crea una textura de cubo a partir de un recurso.
Sintaxis
HRESULT D3DXCreateCubeTextureFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_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 del cubo.
-
hSrcModule [in]
-
Tipo: HMODULE
Controle el módulo donde se encuentra el recurso o NULL para el módulo asociado a la imagen que el sistema operativo usó para crear el proceso actual.
-
pSrcResource [in]
-
Tipo: LPCTSTR
Puntero a una cadena que especifica el nombre del recurso. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos de cadena se resuelve en LPCSTR. Vea la sección Comentarios.
-
ppCubeTexture [out]
-
Tipo: LPDIRECT3DCUBETEXTURE9*
Dirección de un puntero a una interfaz IDirect3DCubeTexture9 , que representa el objeto de textura del cubo creado.
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 valores: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Observaciones
La configuración del compilador determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXCreateCubeTextureFromResourceW. De lo contrario, la llamada de función se resuelve en D3DXCreateCubeTextureFromResourceA porque se usan cadenas ANSI.
La función es equivalente a D3DXCreateCubeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).
Esta función admite los siguientes formatos de archivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm y .tga. Consulte D3DXIMAGE_FILEFORMAT.
Tenga en cuenta que un recurso creado con esta función cuando se llama desde un objeto IDirect3DDevice9 se colocará en la clase de memoria indicada por D3DPOOL_MANAGED. Cuando se llama a este método desde un objeto IDirect3DDevice9Ex, el recurso se colocará en la clase de memoria indicada por D3DPOOL_DEFAULT.
El filtrado se aplica automáticamente a una textura creada mediante este método. El filtrado es equivalente a D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER en D3DX_FILTER.
D3DXCreateCubeTextureFromResource usa el formato de archivo de la superficie de DirectDraw (DDS). El Editor de texturas de DirectX (Dxtex.exe) le permite generar un mapa de cubo a partir de otros formatos de archivo y guardarlo en el formato de archivo DDS. Puede obtener Dxtex.exe y obtener información sobre ella desde el SDK de DirectX. Para obtener información sobre el SDK de DirectX, consulte ¿Dónde está el SDK de DirectX?.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Vea también