D3DX11_IMAGE_LOAD_INFO構造体

[アーティクル]
06/13/2023

注意

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 で使用できます。

D3DX11CreateTextureFromFile や D3DX11CreateShaderResourceViewFromFile などのリソースを作成します。
D3DX11CreateAsyncTextureInfoProcessor や D3DX11CreateAsyncShaderResourceViewProcessor などのデータプロセッサを作成します。

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

    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

次の方法で共有

D3DX11_IMAGE_LOAD_INFO構造体

構文

メンバー

解説

必要条件

関連項目

フィードバック

その他のリソース