D3DX11_IMAGE_LOAD_INFO構造体

  • [アーティクル]

注意

D3DX (D3DX 9、D3DX 10、D3DX 11) ユーティリティ ライブラリは、Windows 8では非推奨となり、Windows ストア アプリではサポートされていません。

必要に応じて、テクスチャ ローダー API に情報を提供して、テクスチャの読み込み方法を制御します。 これらのパラメーターに対して D3DX11_DEFAULT の値を指定すると、D3DX はソース ファイルの値を自動的に使用します。

構文

typedef struct D3DX11_IMAGE_LOAD_INFO {
  UINT              Width;
  UINT              Height;
  UINT              Depth;
  UINT              FirstMipLevel;
  UINT              MipLevels;
  D3D11_USAGE       Usage;
  UINT              BindFlags;
  UINT              CpuAccessFlags;
  UINT              MiscFlags;
  DXGI_FORMAT       Format;
  UINT              Filter;
  UINT              MipFilter;
  D3DX11_IMAGE_INFO *pSrcInfo;
} D3DX11_IMAGE_LOAD_INFO, *LPD3DX11_IMAGE_LOAD_INFO;

メンバー

Width

型: UINT

テクスチャのターゲット幅。 テクスチャの実際の幅がこの値より大きいか小さい場合、テクスチャはこのターゲット幅に合わせてスケールアップまたはスケールダウンされます。

Height

型: UINT

テクスチャのターゲットの高さ。 テクスチャの実際の高さがこの値より大きいか小さい場合、テクスチャはこのターゲットの高さに合わせてスケールアップまたはスケールダウンされます。

[奥行]

型: UINT

テクスチャの深さ。 これは、ボリューム テクスチャにのみ適用されます。

FirstMipLevel

型: UINT

テクスチャの最高解像度のミップマップ レベル。 これが 0 より大きい場合、テクスチャが読み込まれた後、FirstMipLevel は mipmap レベル 0 にマップされます。

MipLevels

型: UINT

テクスチャ内のミップマップ レベルの最大数。 D3D11_TEX1D_SRVの解説を参照してください。 0 またはD3DX11_DEFAULTを使用すると、完全なミップマップ チェーンが作成されます。

使用方法

種類: D3D11_USAGE

テクスチャ リソースの使用方法。 「D3D11_USAGE」を参照してください。

BindFlags

型: UINT

テクスチャのバインドが許可されるパイプライン ステージ。 「D3D11_BIND_FLAG」を参照してください。

CpuAccessFlags

型: UINT

cpu がテクスチャ リソースに対して持つアクセス許可。 「D3D11_CPU_ACCESS_FLAG」を参照してください。

MiscFlags

型: UINT

その他のリソース プロパティ ( D3D11_RESOURCE_MISC_FLAGを参照)。

Format

種類: DXGI_FORMAT

テクスチャ が 読み込まれた後に適用される形式を示すDXGI_FORMAT列挙。

Assert

型: UINT

指定したフィルターを使用してテクスチャをフィルター処理します (再サンプリングの場合のみ)。 「D3DX11_FILTER_FLAG」を参照してください。

MipFilter

型: UINT

指定したフィルターを使用してテクスチャ ミップ レベルをフィルター処理します (ミップマップを生成する場合のみ)。 有効な値は、D3DX11_FILTER_NONE、D3DX11_FILTER_POINT、D3DX11_FILTER_LINEAR、またはD3DX11_FILTER_TRIANGLEです。 「D3DX11_FILTER_FLAG」を参照してください。

pSrcInfo

種類: D3DX11_IMAGE_INFO*

元のイメージに関する情報。 「D3DX11_IMAGE_INFO」を参照してください。 D3DX11GetImageInfoFromFile、D3DX11GetImageInfoFromMemory、または D3DX11GetImageInfoFromResource を使用して取得できます。

解説

構造体を初期化するときに、任意のメンバーを D3DX11_DEFAULT に設定すると、テクスチャが読み込まれるときに D3DX によってソース テクスチャの既定値で初期化されます。

この構造体は、次の API で使用できます。

既定値は次のとおりです。

    Width = D3DX11_DEFAULT;
    Height = D3DX11_DEFAULT;
    Depth = D3DX11_DEFAULT;
    FirstMipLevel = D3DX11_DEFAULT;
    MipLevels = D3DX11_DEFAULT;
    Usage = (D3D11_USAGE) D3DX11_DEFAULT;
    BindFlags = D3DX11_DEFAULT;
    CpuAccessFlags = D3DX11_DEFAULT;
    MiscFlags = D3DX11_DEFAULT;
    Format = DXGI_FORMAT_FROM_FILE;
    Filter = D3DX11_DEFAULT;
    MipFilter = D3DX11_DEFAULT;
    pSrcInfo = NULL;

テクスチャの読み込み時にこの構造体を使用してピクセル形式を指定する簡単な例を次に示します。 完全なコードについては、 HDRToneMappingCS11 サンプルの HDRFormats10.cpp に関するページを参照してください。

ID3D11ShaderResourceView* pCubeRV = NULL;
WCHAR strPath[MAX_PATH];
D3DX11_IMAGE_LOAD_INFO LoadInfo;

    DXUTFindDXSDKMediaFileCch( strPath, MAX_PATH, 
        L"Light Probes\\uffizi_cross.dds" );

    LoadInfo.Format = DXGI_FORMAT_R16G16B16A16_FLOAT;

    hr = D3DX11CreateShaderResourceViewFromFile( pd3dDevice, strPath, 
        &LoadInfo, NULL, &pCubeRV, NULL );

必要条件

要件 値
ヘッダー
D3DX11tex.h

関連項目

D3DX 構造体