D3D11_TEXTURE2D_DESC 構造体 (d3d11.h)
2D テクスチャについて説明します。
構文
typedef struct D3D11_TEXTURE2D_DESC {
UINT Width;
UINT Height;
UINT MipLevels;
UINT ArraySize;
DXGI_FORMAT Format;
DXGI_SAMPLE_DESC SampleDesc;
D3D11_USAGE Usage;
UINT BindFlags;
UINT CPUAccessFlags;
UINT MiscFlags;
} D3D11_TEXTURE2D_DESC;
メンバー
Width
型: UINT
テクスチャの幅 (テクセル単位)。 範囲は 1 ~ D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384) です。 テクスチャ キューブ マップの場合、範囲は 1 ~ D3D11_REQ_TEXTURECUBE_DIMENSION (16384) です。 ただし、範囲は実際にはレンダリング デバイスを作成する 機能レベル によって制限されます。 制限の詳細については、「解説」を参照してください。
Height
型: UINT
テクスチャの高さ (テクセル単位)。 範囲は 1 ~ D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384) です。 テクスチャ キューブ マップの場合、範囲は 1 ~ D3D11_REQ_TEXTURECUBE_DIMENSION (16384) です。 ただし、範囲は実際にはレンダリング デバイスを作成する 機能レベル によって制限されます。 制限の詳細については、「解説」を参照してください。
MipLevels
型: UINT
テクスチャ内のミップマップ レベルの最大数。 D3D11_TEX1D_SRVの解説を参照してください。 マルチサンプリング テクスチャには 1 を使用します。または 0 を指定すると、サブテキストの完全なセットが生成されます。
ArraySize
型: UINT
テクスチャ配列内のテクスチャの数。 範囲は 1 ~ D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048) です。 テクスチャ キューブ マップの場合、この値は 6 の倍数 (つまり、D3D11_TEXCUBE_ARRAY_SRV の NumCubes メンバーの値の 6 倍) であり、範囲は 6 から 2046 です。 範囲は実際には、レンダリング デバイスを作成する 機能レベル によって制限されます。 制限の詳細については、「解説」を参照してください。
Format
種類: DXGI_FORMAT
テクスチャ形式 ( 「DXGI_FORMAT」を参照)。
SampleDesc
種類: DXGI_SAMPLE_DESC
テクスチャのマルチサンプリング パラメーターを指定する構造体。 「DXGI_SAMPLE_DESC」を参照してください。
Usage
種類: D3D11_USAGE
テクスチャの読み取りと書き込み方法を識別する値。 最も一般的な値はD3D11_USAGE_DEFAULTです。使用可能なすべての値については 、「D3D11_USAGE 」を参照してください。
BindFlags
型: UINT
パイプライン ステージにバインドするためのフラグ ( D3D11_BIND_FLAGを参照)。 フラグは、ビットごとの OR で組み合わせることができます。
CPUAccessFlags
型: UINT
許可される CPU アクセスの種類を指定するためのフラグ ( D3D11_CPU_ACCESS_FLAGを参照)。 CPU アクセスが必要ない場合は、0 を使用します。 これらのフラグは、ビットごとの OR と組み合わせることができます。
MiscFlags
型: UINT
他のあまり一般的でないリソース オプションを識別するフラグ ( D3D11_RESOURCE_MISC_FLAGを参照)。 これらのフラグが適用されない場合は、0 を使用します。 これらのフラグは、ビットごとの OR を使用して組み合わせることができます。 テクスチャ キューブ マップの場合は、 D3D11_RESOURCE_MISC_TEXTURECUBE フラグを設定します。 キューブ マップ配列 (つまり、 ArraySize> 6) には、 D3D_FEATURE_LEVEL_10_1以上の 機能レベルが必要です。
注釈
この構造体は、 ID3D11Device::CreateTexture2D の呼び出しで使用されます。
この構造に加えて、D3D11.h で定義され、継承されたクラスのように動作する CD3D11_TEXTURE2D_DESC 派生構造体を使用して、テクスチャの説明を作成することもできます。
デバイスは、サブサンプリング、ブロック圧縮、またはビット形式のリソースに対して、サイズ制限 (最小サイズの倍数である必要があります) を設定します。
テクスチャ サイズの範囲は、Microsoft Direct3D インターフェイス バージョンではなく、デバイスを作成する 機能レベル によって決まります。 たとえば、機能レベル 10 (D3D_FEATURE_LEVEL_10_0) で Microsoft Direct3D 10 ハードウェアを使用し、 D3D11CreateDevice を呼び出して ID3D11Device を作成する場合、2D テクスチャを作成するときに最大テクスチャ サイズを D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192) に制限する必要があります。
要件
| 要件 | 値 |
|---|---|
| Header | d3d11.h |