Función D3DXLoadSurfaceFromSurface
Carga una superficie de otra superficie con conversión de color.
Sintaxis
HRESULT D3DXLoadSurfaceFromSurface(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
Parámetros
-
pDestSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Puntero a una interfaz IDirect3DSurface9 . Especifica la superficie de destino, que recibe la imagen.
-
pDestPalette [in]
-
Tipo: const PALETTEENTRY*
Puntero a una estructura PALETTEENTRY , la paleta de destino de 256 colores o NULL.
-
pDestRect [in]
-
Tipo: const RECT*
Puntero a una estructura RECT . Especifica el rectángulo de destino. Establezca este parámetro en NULL para especificar toda la superficie.
-
pSrcSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Puntero a una interfaz IDirect3DSurface9 , que representa la superficie de origen.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntero a una estructura PALETTEENTRY , la paleta de origen de 256 colores o NULL.
-
pSrcRect [in]
-
Tipo: const RECT*
Puntero a una estructura RECT . Especifica el rectángulo de origen. Establezca este parámetro en NULL para especificar toda la superficie.
-
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 equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
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.
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, D3DXERR_INVALIDDATA.
Comentarios
Esta función controla la conversión a y desde formatos de textura comprimidos.
Escribir en una superficie que no sea de nivel cero no hará que se actualice el rectángulo sucio. Si se llama a D3DXLoadSurfaceFromSurface y la superficie aún no estaba sucia (esto es poco probable en escenarios de uso normales), la aplicación debe llamar explícitamente a AddDirtyRect en la superficie.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también