D3DXLoadVolumeFromFileInMemory, fonction
Charge un volume à partir d’un fichier en mémoire.
Syntaxe
HRESULT D3DXLoadVolumeFromFileInMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
Paramètres
-
pDestVolume [in]
-
Type : LPDIRECT3DVOLUME9
Pointeur vers une interface IDirect3DVolume9 . Spécifie le volume de destination.
-
pDestPalette [in]
-
Type : const PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY , la palette de destination de 256 couleurs ou NULL.
-
pDestBox [in]
-
Type : const D3DBOX*
Pointeur vers une structure D3DBOX . Spécifie la zone de destination. Définissez ce paramètre sur NULL pour spécifier le volume entier.
-
pSrcData [in]
-
Type : LPCVOID
Pointeur vers le fichier en mémoire à partir duquel charger le volume.
-
SrcDataSize [in]
-
Type : UINT
Taille en octets du fichier en mémoire.
-
pSrcBox [in]
-
Type : const D3DBOX*
Pointeur vers une structure D3DBOX . Spécifie la zone source. Définissez ce paramètre sur NULL pour spécifier le volume entier.
-
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. Ainsi, pour le noir opaque, la valeur serait égale à 0xFF000000.
-
pSrcInfo [in]
-
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 suivantes : D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Notes
Cette fonction gère la conversion vers et depuis les formats de texture compressés et prend en charge les formats de fichier suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.
L’écriture sur une surface autre que le niveau zéro de la texture du volume n’entraîne pas la mise à jour du rectangle sale. Si D3DXLoadVolumeFromFileInMemory est appelé et que la texture n’était pas déjà sale (ce qui est peu probable dans les scénarios d’utilisation normale), l’application doit appeler explicitement IDirect3DVolumeTexture9::AddDirtyBox sur la texture du volume.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi