Función D3DXCreateTextureFromFileInMemoryEx
Crea una textura a partir de un archivo en memoria. Se trata de una función más avanzada que D3DXCreateTextureFromFileInMemory.
Sintaxis
HRESULT D3DXCreateTextureFromFileInMemoryEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_In_ DWORD Filter,
_In_ DWORD MipFilter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo,
_Out_ PALETTEENTRY *pPalette,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
Parámetros
-
pDevice [in]
-
Tipo: LPDIRECT3DDEVICE9
Puntero a una interfaz IDirect3DDevice9 , que representa el dispositivo que se va a asociar a la textura.
-
pSrcData [in]
-
Tipo: LPCVOID
Puntero al archivo en memoria desde el que se va a crear la textura.
-
SrcDataSize [in]
-
Tipo: UINT
Tamaño del archivo en memoria, en bytes.
-
Ancho [in]
-
Tipo: UINT
Ancho en píxeles. Si este valor es cero o D3DX_DEFAULT, las dimensiones se toman del archivo.
-
Alto [in]
-
Tipo: UINT
Alto, en píxeles. Si este valor es cero o D3DX_DEFAULT, las dimensiones se toman del archivo.
-
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 o D3DUSAGE_DYNAMIC, Pool debe establecerse en D3DPOOL_DEFAULT y 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. La textura devuelta puede tener un formato diferente del especificado por Format. Las aplicaciones deben comprobar el formato de la textura devuelta. Si D3DFMT_UNKNOWN, el formato se toma del archivo. Si D3DFMT_FROM_FILE, el formato se toma exactamente como está en el archivo y se producirá un error en la llamada si esto infringe las funcionalidades del dispositivo.
-
Piscina [in]
-
Tipo: D3DPOOL
Miembro del tipo enumerado D3DPOOL , que describe la clase de memoria en la que se debe colocar la textura.
-
Filtro [in]
-
Tipo: DWORD
Combinación de una o varias marcas que controlan cómo se filtra la imagen. Especificar D3DX_DEFAULT para este parámetro es equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER. Cada filtro válido debe contener una de las marcas de D3DX_FILTER.
-
MipFilter [in]
-
Tipo: DWORD
Combinación de una o varias marcas que controlan cómo se filtra la imagen. Especificar D3DX_DEFAULT para este parámetro es equivalente a especificar D3DX_FILTER_BOX. Cada filtro válido debe contener una de las marcas de D3DX_FILTER. Además, use bits 27-31 para especificar el número de niveles mip que se omitirán (desde la parte superior de la cadena de mapas MIP) cuando se carga una textura .dds en la memoria; esto le permite omitir hasta 32 niveles.
-
ColorKey [in]
-
Tipo: D3DCOLOR
Valor D3DCOLOR que se va a 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. Alfa es significativo y normalmente debe establecerse en FF para las teclas de color opaco. Por lo tanto, para negro opaco, el valor sería igual a 0xFF000000.
-
pSrcInfo [in, out]
-
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.
-
pPalette [out]
-
Tipo: PALETTEENTRY*
Puntero a una estructura PALETTEENTRY , que representa una paleta de 256 colores para rellenar o NULL. Vea la sección Comentarios.
-
ppTexture [out]
-
Tipo: LPDIRECT3DTEXTURE9*
Dirección de un puntero a una interfaz IDirect3DTexture9 , que representa el objeto de textura 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_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Comentarios
Esta función admite los siguientes formatos de archivo: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm y .tga. Consulte D3DXIMAGE_FILEFORMAT.
Para más información sobre PALETTEENTRY, consulte El SDK de plataforma. Tenga en cuenta que a partir de DirectX 8.0, el miembro peFlags de la estructura PALETTEENTRY no funciona como se documenta en Platform SDK. El miembro peFlags es ahora el canal alfa para formatos paletizados de 8 bits.
Al omitir los niveles de mapa mip al cargar un archivo .dds, use la macro D3DX_SKIP_DDS_MIP_LEVELS para generar el valor de MipFilter. Esta macro toma el número de niveles que se omitirán y el tipo de filtro y devuelve el valor de filtro, que luego se pasará al parámetro MipFilter.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también