Microsoft DirectX 8.0 (Visual Basic)

D3DX8.CreateTextureFromFileEx

ファイルを元にしてテクスチャを作成する。これは、D3DX8.CreateTextureFromFile よりも高度なメソッドである。

object.CreateTextureFromFileEx( _ 
    Device As Direct3DDevice8, _ 
    SrcFile As String, _ 
    Width As Long, _ 
    Height As Long, _ 
    MipLevels As Long, _ 
    Usage As Long, _ 
    Format As CONST_D3DFORMAT, _ 
    Pool As CONST_D3DPOOL, _ 
    Filter As Long, _ 
    MipFilter As Long, _ 
    ColorKey As Long, _ 
    SrcInfo As Any _ 
    Palette As Any) As Direct3DTexture8

指定項目

object
D3DX8 オブジェクトを表すオブジェクト式。
Device
テクスチャに関連付けられているデバイスを表す Direct3DDevice8 オブジェクト。
SrcFile
テクスチャの作成に使用するファイルを指定する String 値。
Width
幅 (ピクセル単位)。この値が 0、または CONST_D3DXENUM 列挙で定義される D3DX_DEFAULT の場合、サイズはファイルから取得される。
Height
高さ (ピクセル単位)。この値が 0 または CONST_D3DXENUM 列挙で定義される D3DX_DEFAULT の場合、サイズはファイルから取得される。
MipLevels
要求されたミップ レベルの数。この値が 0 または CONST_D3DXENUM 列挙で定義される D3DX_DEFAULT の場合は、完全なミップマップ チェーンが作成される。
Usage
0 または CONST_D3DUSAGEFLAGS 列挙の D3DUSAGE_RENDERTARGET メンバ。D3DUSAGE_RENDERTARGET を指定すると、そのサーフェスはレンダリング ターゲットとして使用されることを示す。リソースは、SetRenderTarget メソッドの NewRenderTarget パラメータに渡すことができる。D3DUSAGE_RENDERTARGET を指定する場合、アプリケーションは Direct3D8.CheckDeviceFormat を呼び出して、デバイスがこれらの処理をサポートしていることを確認する必要がある。
Format
テクスチャに対して要求されたピクセル フォーマットを記述する CONST_D3DFORMAT 列挙のメンバ。返されるテクスチャのフォーマットは Format で指定されたフォーマットと異なる場合がある。アプリケーションは、返されたテクスチャのフォーマットを確認する必要がある。Format が D3DFMT_UNKNOWN の場合、フォーマットはファイルから取得される。
Pool
テクスチャの配置先となるメモリ クラスを記述する、CONST_D3DPOOL 列挙のメンバ。
Filter
イメージをフィルタリングする方法を制御する、CONST_D3DXENUM 列挙で定義される 1 つ以上のフィルタ フラグの組み合わせ。このパラメータに D3DX_DEFAULT を指定することは、D3DX_FILTER_DITHER OR D3DX_FILTER_TRIANGLE を指定することと等しい。
MipFilter
イメージをフィルタリングする方法を制御する、CONST_D3DXENUM 列挙で定義される 1 つ以上のミップ フィルタ フラグの組み合わせ。このパラメータに D3DX_DEFAULT を指定することは、D3DX_FILTER_BOX を指定することと等しい。
ColorKey
透明となる値。カラーキーを無効にする場合は 0 を指定する。ソース イメージのフォーマットとは関係なく、これは常に 32 ビットの ARGB カラーである。アルファが有意であり、通常はカラーキーを不透明にする場合は FF を指定する。したがって、不透明な黒の場合、値は &HFF000000 となる。
SrcInfo
ソース イメージ ファイル内のデータの記述を格納する D3DXIMAGE_INFO 構造体、または ByVal 0。
Palette
格納する 256 PALETTEENTRY 型の配列の最初の要素、または ByVal 0。「注意」を参照すること。

戻り値

作成されたテクスチャを表す Direct3DTexture8 オブジェクト。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
D3DXERR_INVALIDDATA
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

ミップマップされたテクスチャの各レベルには、ロードされたテクスチャが自動的に格納される。

ミップマップされたテクスチャにイメージをロードするとき、デバイスによっては、1x1 のイメージに変換できず、関数が失敗することがある。このような場合は、イメージを手動でロードする必要がある。

PALETTEENTRY の詳細については、Microsoft Platform Software Development Kit (SDK) を参照すること。Microsoft DirectX® 8.0 の時点で、PALETTEENTRY 構造体の peFlags メンバは、Platform SDK に説明されているようには機能しない。peFlags メンバは現在、8 ビットのパレット化されたフォーマット用のアルファ チャネルである。