Platform SDK: DirectX |
D3DXCreateTextureFromFile 関数は、スタンドアロン ファイルまたはリソースからテクスチャ オブジェクトを作成する。
HRESULT D3DXCreateTextureFromFile( LPDIRECT3DDEVICE7 pd3dDevice, LPDWORD pFlags, LPDWORD pWidth, LPDWORD pHeight, D3DX_SURFACEFORMAT* pPixelFormat, LPDIRECTDRAWPALETTE pDDPal, LPDIRECTDRAWSURFACE7* ppDDSurf, LPDWORD pNumMipMaps, LPSTR pSrcName, D3DX_FILTERTYPE filterType );
成功すれば、S_OK を返す。
失敗すれば、NULL または次のいずれかの値を返す。
実行可能ファイルのリソース部分でサポートされているのは、BMP ファイルと DIB ファイルだけである。
pSrcName パラメータで、16bpp、24bpp、32bpp の正のカラーと 8bpp のパレット化の場合は TGA がサポートされている。また、8bpp と 16bpp のグレー スケールもサポートされている。前の TGA フォーマットである RLE バージョンもサポートされている。ただし TGA ファイルでは、カラー キー化したアルファや左方乗法されたアルファは現在サポートされていない。
pSrcName パラメータに数値 ID を指定した場合、D3DXLoadTextureFromFile 関数に実行可能ファイルのリソースからビットマップ イメージをロードするように指示される。それ以外の場合、pSrcName はファイル名であると見なされる。ただし、D3DXCreateTextureFromFile 関数では文字列ポインタがファイル名として扱われるので、文字列のリソース名は使用できない。
pFlags パラメータがミップマップを作成しないように特に設定されていない限り、最低レベル サイズの 1 x 1 に達するまでミップマップは生成される。
ミップマップの詳細については、「ミップマップによるテクスチャ フィルタリング」を参照すること。
幅、高さ、ピクセル フォーマットは、使用可能なハードウェアに基づいて変わる。たとえば、ミップマップ ディメンジョンは 2 の累乗でなければならず、また幅は正方形テクスチャの高さと等しくなければならない。さらに、指定されたピクセル フォーマットを使用できない場合、最適に適合される。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以上が必要。Windows 95 用に再配布可能な形で使用可能。
バージョン : DirectX 7.0 が必要。
ヘッダー : d3dxcore.h で宣言。
ライブラリ : d3dx.lib を使用。