D3DXLoadSurfaceFromResource, fonction

Article
06/03/2023

Charge une surface à partir d’une ressource.

Syntaxe

HRESULT D3DXLoadSurfaceFromResource(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          HMODULE            hSrcModule,
  _In_          LPCTSTR            pSrcResource,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

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.

hSrcModule [in]

Type : HMODULE

Gérez le module où se trouve la ressource, ou NULL pour le module associé à l’image utilisée par le système d’exploitation pour créer le processus actuel.

pSrcResource [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de la ressource. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

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 l’image 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 revient à spécifier D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Type : D3DCOLOR

Valeur D3DCOLOR à remplacer par le noir transparent, ou 0 pour désactiver la touche colorkey. 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 clés de couleur opaques. Par conséquent, pour le noir opaque, la valeur est égale à 0xFF000000.

pSrcInfo [in, out]

Type : D3DXIMAGE_INFO*

Pointeur vers une structure D3DXIMAGE_INFO à remplir avec une description des données dans le fichier image source ou NULL.

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 valeurs suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Notes

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXLoadSurfaceFromResourceW. Sinon, l’appel de fonction est résolu en D3DXLoadSurfaceFromResourceA, car les chaînes ANSI sont utilisées.

La ressource chargée doit être de type RT_BITMAP ou RT_RCDATA. Le type de ressource RT_RCDATA est utilisé pour charger d’autres formats que les bitmaps (tels que .tga, .jpg et .dds).

Cette fonction gère la conversion vers et depuis les formats de texture compressés.

L’écriture sur une surface autre que le niveau zéro n’entraîne pas la mise à jour du rectangle sale. Si D3DXLoadSurfaceFromFile est appelé et que la surface n’était pas déjà sale (cela 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