D3DXCreateCubeTextureFromResourceEx, fonction

Crée une texture de cube à partir d’une ressource spécifiée par une chaîne. Il s’agit d’une fonction plus avancée que D3DXCreateCubeTextureFromResource.

Syntaxe

HRESULT D3DXCreateCubeTextureFromResourceEx(
  _In_    LPDIRECT3DDEVICE9      pDevice,
  _In_    HMODULE                hSrcModule,
  _In_    LPCTSTR                pSrcResource,
  _In_    UINT                   Size,
  _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_   LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture du cube.

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.

Taille [in]

Type : UINT

Largeur et hauteur de la texture du cube, en pixels. Par exemple, si la texture du cube est un cube de 8 pixels par 8 pixels, la valeur de ce paramètre doit être 8. Si cette valeur est 0 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 ou 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 est spécifié, 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 Utilisation de textures dynamiques.

Format [in]

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , décrivant le format de pixel demandé pour la texture de cube. La texture de cube 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 de cube 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 de cube doit être placée.

Filtrer [in]

Type : DWORD

Combinaison d’un ou de plusieurs D3DX_FILTER, contrôlant le filtrage de l’image. 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.

ppCubeTexture [out]

Type : LPDIRECT3DCUBETEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DCubeTexture9 , représentant l’objet de texture de cube 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_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

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

Cette fonction prend en charge les formats de fichier suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.

Les textures de cube diffèrent des autres surfaces en ce qu’il s’agit de collections de surfaces. Pour appeler SetRenderTarget avec une texture de cube, vous devez sélectionner un visage individuel à l’aide de GetCubeMapSurface et passer la surface obtenue à SetRenderTarget.

D3DXCreateCubeTextureFromResourceEx utilise le format de fichier DDS (DirectDraw surface). L’éditeur de texture DirectX (Dxtex.exe) vous permet de générer un mappage de cube à partir d’autres formats de fichiers et de l’enregistrer au format de fichier DDS. Vous pouvez obtenir des Dxtex.exe et en savoir plus à ce sujet à partir du Kit de développement logiciel (SDK) DirectX. Pour plus d’informations sur le Kit de développement logiciel (SDK) DirectX, consultez Où se trouve le Kit de développement logiciel (SDK) DirectX ?.

Spécifications

Voir aussi

D3DXCreateCubeTextureFromResource

Fonctions de texture dans D3DX 9