estrutura D3D11_TEXTURE3D_DESC1 (d3d11_3.h)
Descreve uma textura 3D.
Sintaxe
typedef struct D3D11_TEXTURE3D_DESC1 {
UINT Width;
UINT Height;
UINT Depth;
UINT MipLevels;
DXGI_FORMAT Format;
D3D11_USAGE Usage;
UINT BindFlags;
UINT CPUAccessFlags;
UINT MiscFlags;
D3D11_TEXTURE_LAYOUT TextureLayout;
} D3D11_TEXTURE3D_DESC1;
Membros
Width
Largura da textura (em texels). O intervalo é de 1 a D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). No entanto, o intervalo é, na verdade, restrito pelo nível de recurso no qual você cria o dispositivo de renderização. Para obter mais informações sobre restrições, consulte Comentários.
Height
Altura da textura (em texels). O intervalo é de 1 a D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). No entanto, o intervalo é, na verdade, restrito pelo nível de recurso no qual você cria o dispositivo de renderização. Para obter mais informações sobre restrições, consulte Comentários.
Depth
Profundidade de textura (em texels). O intervalo é de 1 a D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). No entanto, o intervalo é, na verdade, restrito pelo nível de recurso no qual você cria o dispositivo de renderização. Para obter mais informações sobre restrições, consulte Comentários.
MipLevels
O número máximo de níveis de mipmap na textura. Consulte as observações em D3D11_TEX1D_SRV. Use 1 para uma textura multiplatafa; ou 0 para gerar um conjunto completo de subtexturas.
Format
Formato de textura (consulte DXGI_FORMAT).
Usage
Valor que identifica como a textura deve ser lida e gravada. O valor mais comum é D3D11_USAGE_DEFAULT; consulte D3D11_USAGE para todos os valores possíveis.
BindFlags
Sinalizadores (consulte D3D11_BIND_FLAG) para associação a estágios de pipeline. Os sinalizadores podem ser combinados por um OR bit a bit.
CPUAccessFlags
Sinalizadores (consulte D3D11_CPU_ACCESS_FLAG) para especificar os tipos de acesso de CPU permitidos. Use 0 se o acesso à CPU não for necessário. Esses sinalizadores podem ser combinados com um OR bit a bit.
MiscFlags
Sinalizadores (consulte D3D11_RESOURCE_MISC_FLAG) que identificam outras opções de recurso menos comuns. Use 0 se nenhum desses sinalizadores se aplicar. Esses sinalizadores podem ser combinados com um OR bit a bit.
TextureLayout
Um valor do tipo D3D11_TEXTURE_LAYOUT que identifica o layout da textura.
O parâmetro TextureLayout seleciona o layout real da textura na memória e o layout visível para o aplicativo enquanto a textura é mapeada. Esses sinalizadores podem não ser solicitados sem o acesso à CPU também solicitado.
É inválido definir sinalizadores de acesso de CPU em texturas padrão sem também definir Layout como um valor diferente de D3D11_TEXTURE_LAYOUT_UNDEFINED.
D3D11_TEXTURE_LAYOUT_ROW_MAJOR pode não ser usado com texturas 3D. D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE pode não ser usado com texturas 3D que têm mipmaps.
Comentários
Essa estrutura é usada em uma chamada para ID3D11Device3::CreateTexture3D1.
Além dessa estrutura, você também pode usar o CD3D11_TEXTURE3D_DESC1 estrutura derivada, que é definida em D3D11_3.h e se comporta como uma classe herdada, para ajudar a criar uma descrição de textura.
O dispositivo restringe o tamanho dos recursos de formato subsampledo, de bloco compactado e de bit para ter múltiplos de tamanhos específicos para cada formato.
O intervalo de tamanho da textura é determinado pelo nível de recurso no qual você cria o dispositivo e não a versão da interface Do Microsoft Direct3D. Por exemplo, se você usar o hardware do Microsoft Direct3D 10 no nível de recurso 10 (D3D_FEATURE_LEVEL_10_0) e chamar D3D11CreateDevice para criar um ID3D11Device, deverá restringir o tamanho máximo da textura para D3D10_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) ao criar sua textura 3D.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | d3d11_3.h |