D3DXCreateTextureFromResourceEx, fonction
Crée une texture à partir d’une ressource. Il s’agit d’une fonction plus avancée que D3DXCreateTextureFromResource.
Syntaxe
HRESULT D3DXCreateTextureFromResourceEx(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_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
);
Paramètres
-
pDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture.
-
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.
-
Width [in]
-
Type : UINT
Largeur en pixels. Si cette valeur est égale à zéro ou D3DX_DEFAULT, les dimensions sont extraites du fichier.
-
Height [in]
-
Type : UINT
Hauteur, en pixels. Si cette valeur est égale à zéro ou D3DX_DEFAULT, les dimensions sont extraites du fichier.
-
MipLevels [in]
-
Type : UINT
Nombre de niveaux de mip demandés. Si cette valeur est égale à zéro ou D3DX_DEFAULT, une chaîne mipmap complète est créée.
-
Utilisation [in]
-
Type : DWORD
0, D3DUSAGE_RENDERTARGET ou D3DUSAGE_DYNAMIC. La définition de cet indicateur sur D3DUSAGE_RENDERTARGET indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être passée au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE_RENDERTARGET ou D3DUSAGE est spécifié, Pool doit être défini sur D3DPOOL_DEFAULT et l’application doit case activée que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. D3DUSAGE_DYNAMIC indique que la surface doit être gérée dynamiquement. Pour plus d’informations sur l’utilisation de textures dynamiques, consultez Optimisations des performances (Direct3D 9)Utilisation de textures dynamiques.
-
Format [in]
-
Type : D3DFORMAT
Membre du type énuméré D3DFORMAT , décrivant le format de pixel demandé pour la texture. La texture retournée peut avoir un format différent de celui spécifié par Format. Les applications doivent case activée le format de la texture retournée. Si D3DFMT_UNKNOWN, le format est extrait du fichier. Si D3DFMT_FROM_FILE, le format est exactement tel qu’il est dans le fichier, et l’appel échoue si cela viole les fonctionnalités de l’appareil.
-
Pool [in]
-
Type : D3DPOOL
Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture doit être placée.
-
Filtrer [in]
-
Type : DWORD
Combinaison d’un 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.
-
MipFilter [in]
-
Type : DWORD
Combinaison d’un 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_BOX.
-
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, out]
-
Type : D3DXIMAGE_INFO*
Pointeur vers une structure D3DXIMAGE_INFO à remplir avec une description des données dans le fichier image source ou NULL.
-
pPalette [out]
-
Type : PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY , représentant une palette de 256 couleurs à remplir ou NULL.
-
ppTexture [out]
-
Type : LPDIRECT3DTEXTURE9*
Adresse d’un pointeur vers une interface IDirect3DTexture9 , représentant l’objet de texture créé.
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_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
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 D3DXCreateTextureFromResourceExW. Sinon, l’appel de fonction est résolu en D3DXCreateTextureFromResourceExA, 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 prend en charge les formats de fichier suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi