D3DX8.CreateCubeTextureFromFileEx
ファイルを元にしてキューブ テクスチャを作成する。これは、D3DX8.CreateCubeTextureFromFile よりも高度なメソッドである。
object.CreateCubeTextureFromFileEx( _
Device As Direct3DDevice8, _
SrcFile As String, _
TextureSize 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 Direct3DCubeTexture8
パラメータ
- object
- D3DX8 オブジェクトを表すオブジェクト式。
- Device
- キューブ テクスチャに関連付けられたデバイスを表す、Direct3DDevice8 オブジェクト。
- SrcFile
- キューブ テクスチャの作成に使用するファイルを指定する文字列。「注意」を参照すること。
- TextureSize
- キューブ テクスチャの幅と高さ (ピクセル単位)。キューブ テクスチャが 8 × 8 ピクセルのキューブである場合、このパラメータの値は 8 である。この値は 0 以外である必要がある。この値が 0 または 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 色パレットを表すオブジェクト、または Nothing。
戻り値
作成されたキューブ テクスチャを表す、Direct3DCubeTexture8 オブジェクト。
エラー コード
失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
注意
キューブ テクスチャは、サーフェスのコレクションである点でほかのサーフェスとは異なる。キューブ テクスチャを指定して SetRenderTarget を呼び出すには、Direct3DCubeTexture8.GetCubeMapSurface を使用して個々の面を選択し、結果サーフェスを SetRenderTarget に渡す必要がある。
CreateCubeTextureFromFileEx は、DirectDrawSurface (DDS) ファイル フォーマットを使用する。DXTex ツールによって、ほかのファイル フォーマットからキューブ マップを生成し、それを DDS ファイル フォーマットで保存することができる。