Fonction D3DXLoadSurfaceFromSurface

Article
06/13/2023

Charge une surface à partir d’une autre surface avec conversion de couleur.

Syntaxe

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
);

Paramètres

pDestSurface [in]

Type : LPDIRECT3DSURFACE9

Pointeur vers une interface IDirect3DSurface9 . Spécifie la surface de destination, qui reçoit l’image.

pDestPalette [in]

Type : const PALETTEENTRY*

Pointeur vers une structure PALETTEENTRY , la palette de destination de 256 couleurs ou NULL.

pDestRect [in]

Type : const RECT*

Pointeur vers une structure RECT . Spécifie le rectangle de destination. Définissez ce paramètre sur NULL pour spécifier la surface entière.

pSrcSurface [in]

Type : LPDIRECT3DSURFACE9

Pointeur vers une interface IDirect3DSurface9 , représentant la surface source.

pSrcPalette [in]

Type : const PALETTEENTRY*

Pointeur vers une structure PALETTEENTRY , palette source de 256 couleurs ou NULL.

pSrcRect [in]

Type : const RECT*

Pointeur vers une structure RECT . Spécifie le rectangle source. Définissez ce paramètre sur NULL pour spécifier la surface entière.

Filtrer [in]

Type : DWORD

Combinaison d’une ou de plusieurs D3DX_FILTER, contrôlant la façon dont l’image est filtrée. Spécifier D3DX_DEFAULT pour ce paramètre équivaut à spécifier D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Type : D3DCOLOR

Valeur D3DCOLOR à remplacer par un noir transparent ou 0 pour désactiver la touche de couleur. Il s’agit toujours d’une couleur ARGB 32 bits, indépendamment du format d’image source. Alpha est significatif et doit généralement être défini sur FF pour les touches de couleur opaques. Ainsi, pour le noir opaque, la valeur serait égale à 0xFF000000.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Notes

Cette fonction gère la conversion vers et à partir des formats de texture compressés.

L’écriture dans une surface non de niveau zéro n’entraîne pas la mise à jour du rectangle sale. Si D3DXLoadSurfaceFromSurface est appelé et que la surface n’était pas déjà sale (ce qui est peu probable dans les scénarios d’utilisation normale), l’application doit appeler explicitement AddDirtyRect sur la surface.

Spécifications

Condition requise	Valeur
En-tête	D3dx9tex.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions de texture dans D3DX 9

Partager via