次の方法で共有

D3DXCreateCubeTextureFromFileInMemoryEx

  • [アーティクル]

メモリーにロードされたファイルを元にキューブ テクスチャーを作成します。これは、D3DXCreateCubeTextureFromFileInMemory の上位の関数です。

HRESULT 
D3DXCreateCubeTextureFromFileInMemoryEx(
  LPDIRECT3DDEVICE9 pDevice,
  LPCVOID pSrcData,
  UINT SrcDataSize,
  UINT Size,
  UINT MipLevels,
  DWORD Usage,
  D3DFORMAT Format,
  D3DPOOL Pool,
  DWORD Filter,
  DWORD MipFilter,
  D3DCOLOR ColorKey,
  D3DXIMAGE_INFO * pSrcInfo,
  PALETTEENTRY * pPalette,
  LPDIRECT3DCUBETEXTURE9 * ppCubeTexture
);

パラメータ

  • pDevice
    IDirect3DDevice9 インターフェイスへのポインターです。キューブ テクスチャーに関連付けられるデバイスを示します。
  • pSrcData
    キューブ テクスチャーの作成に使用するメモリー内のファイルへのポインターです。「解説」を参照してください。
  • SrcDataSize
    メモリー内のサイズ (バイト単位) です。
  • Size
    幅または高さ (ピクセル単位) です。この値が 0 または D3DX_DEFAULT の場合、これらのサイズはファイルから取得されます。
  • MipLevels
    ミップマップ レベル数の要求値です。この値が 0 または D3DX_DEFAULT の場合は、完全なミップマップのチェーンが作成されます。
  • Usage
    0、D3DUSAGE_RENDERTARGET、または D3DUSAGE_DYNAMIC。このフラグを D3DUSAGE_RENDERTARGET に指定すると、サーフェスをレンダー ターゲットとして使用します。その後でリソースを IDirect3DDevice9::SetRenderTarget メソッドの pNewRenderTarget パラメーターとして渡すことができます。D3DUSAGE_RENDERTARGET を指定する場合は、アプリケーションで IDirect3D9::CheckDeviceFormat を呼び出して、デバイスがこの処理をサポートしていることを確認する必要があります。動的テクスチャーの使用の詳細については、「動的テクスチャーの使用」を参照してください。
  • Format
    D3DFORMAT 列挙型のメンバーです。キューブ テクスチャーに対して要求されたピクセル フォーマットを示します。返されるテクスチャーのフォーマットは、Format で指定されたものと異なる場合があります。アプリケーションでは、返されるテクスチャーのフォーマットをチェックする必要があります。D3DFMT_UNKNOWN の場合、ファイルからフォーマットが取得されます。D3DFMT_FROM_FILE の場合、フォーマットはファイル内にあるとおり正確に取得され、デバイスの能力に違反する場合は呼び出しに失敗します。
  • Pool
    D3DPOOL 列挙型のメンバーです。キューブ テクスチャーを配置するメモリー クラスを示します。
  • Filter
    イメージのフィルタリング方法を指定する、1 つ以上の D3DX_FILTER の組み合わせです。このパラメーターに D3DX_DEFAULT を指定すると、D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER を指定したのと同じ結果になります。
  • MipFilter
    イメージのフィルタリング方法を指定する、1 つ以上の D3DX_FILTER の組み合わせです。このパラメーターに D3DX_DEFAULT を指定すると、D3DX_FILTER_BOX を指定したのと同じ結果になります。さらに、ビット 27 ～ 31 を使用して、.dds テクスチャーがメモリーにロードされたときに (ミップマップ チェーンのトップから) スキップするミップ レベルの数を指定します。32 レベルまでスキップ可能です。
  • ColorKey
    透明な黒と置き換える D3DCOLOR 値、またはカラーキーを無効にする 0 を指定します。この値は、元のイメージのフォーマットに関係なく常に 32 ビットの ARGB カラーになります。最上位には、アルファ値を指定します。カラー キーを不透明にする場合には FF に設定します。したがって、不透明な黒の場合には、値が 0xFF000000 になります。
  • pSrcInfo
    ソース イメージ ファイル内のデータの記述を格納する D3DXIMAGE_INFO 構造体へのポインター、または NULL です。
  • pPalette
    PALETTEENTRY 構造体へのポインターです。カラー値を格納する 256 色パレットを示します。または NULL です。「解説」を参照してください。
  • ppCubeTexture
    作成されたキューブ テクスチャー オブジェクトを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレスです。

戻り値

成功すると、D3D_OK を返します。失敗した場合は、次の戻り値のいずれかを返します。D3DERR_INVALIDCALL

D3DERR_NOTAVAILABLED3DERR_OUTOFVIDEOMEMORYD3DXERR_INVALIDDATAE_OUTOFMEMORY

解説　

この関数は、.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga ファイル形式をサポートします。「D3DXIMAGE_FILEFORMAT」を参照してください。

キューブ テクスチャーは他のサーフェスと異なり、サーフェスのコレクションになります。キューブ テクスチャーで IDirect3DDevice9::SetRenderTarget を呼び出すには、IDirect3DCubeTexture9::GetCubeMapSurface を使用して個別の面を選択し、その結果のサーフェスを IDirect3DDevice9::SetRenderTarget に渡す必要があります。

このメソッドは、アプリケーション定義リソース (未処理のデータ) の RT_RCDATA として格納されているイメージ ファイルのロードに使用します。他の種類のファイルに対して使用すると、このメソッドは失敗します。

PALETTEENTRY の詳細については、Platform SDK を参照してください。Microsoft DirectX 8.0 の PALETTEENTRY 構造体の peFlags メンバーは Platform SDK の記述とは異なることに注意してください。peFlags メンバーは、現在、8 ビット パレット化フォーマットのアルファ チャンネルです。

D3DXCreateCubeTextureFromFileInMemoryEx は DirectDraw サーフェス (DDS) ファイル フォーマットを使用します。DirectX テクスチャー エディター (Dxtex.exe) を使用すると、他のファイル形式からキューブ マップを生成し、DDS ファイル形式で保存できます。

.dds ファイルのロード中にミップマップ レベルをスキップする場合は、D3DX_SKIP_DDS_MIP_LEVELS マクロを使用して MipFilter 値を生成します。このマクロはスキップするレベル数とフィルター タイプを取得し、フィルター値を返します。フィルター値は MipFilter パラメーターに渡されます。

要件

ヘッダー: D3dx9tex.h 宣言

ライブラリ: D3dx9.lib 内容

関連項目

D3DX 9 のテクスチャー関数