Función D3DXLoadVolumeFromFile

Carga un volumen desde un archivo.

Sintaxis

HRESULT D3DXLoadVolumeFromFile(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCTSTR           pSrcFile,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

Parámetros

pDestVolume [in]

Tipo: LPDIRECT3DVOLUME9

Puntero a una interfaz IDirect3DVolume9 . Especifica el volumen de destino.

pDestPalette [in]

Tipo: const PALETTEENTRY*

Puntero a una estructura PALETTEENTRY , la paleta de destino de 256 colores o NULL.

pDestBox [in]

Tipo: const D3DBOX*

Puntero a una estructura D3DBOX . Especifica el cuadro de destino. Establezca este parámetro en NULL para especificar todo el volumen.

pSrcFile [in]

Tipo: LPCTSTR

Puntero a una cadena que especifica el nombre de archivo. 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.

pSrcBox [in]

Tipo: const D3DBOX*

Puntero a una estructura D3DBOX . Especifica el cuadro de origen. Establezca este parámetro en NULL para especificar todo el volumen.

Filtro [in]

Tipo: DWORD

Combinación de una o varias D3DX_FILTER, controlando cómo se filtra la imagen. Especificar D3DX_DEFAULT para este parámetro es el equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Tipo: D3DCOLOR

Valor D3DCOLOR para reemplazar por negro transparente o 0 para deshabilitar la clave de color. Siempre es un color ARGB de 32 bits, independientemente del formato de imagen de origen. El alfa es significativo y normalmente debe establecerse en FF para las teclas de color opacos. Por lo tanto, para negro opaco, el valor sería igual a 0xFF000000.

pSrcInfo [in]

Tipo: D3DXIMAGE_INFO*

Puntero a una estructura de D3DXIMAGE_INFO que se va a rellenar con una descripción de los datos del archivo de imagen de origen o 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 valores: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentarios

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXLoadVolumeFromFileW. De lo contrario, la llamada de función se resuelve en D3DXLoadVolumeFromFileA porque se usan cadenas ANSI.

Esta función controla la conversión a y desde formatos de textura comprimidos y admite los siguientes formatos de archivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm y .tga. Consulte D3DXIMAGE_FILEFORMAT.

Escribir en una superficie que no sea de nivel cero de la textura del volumen no hará que se actualice el rectángulo sucio. Si se llama a D3DXLoadVolumeFromFile y la textura aún no estaba sucia (esto es poco probable en escenarios de uso normales), la aplicación debe llamar explícitamente a IDirect3DVolumeTexture9::AddDirtyBox en la textura del volumen.

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

D3DXLoadVolumeFromFileInMemory

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

Funciones de textura en D3DX 9