Pular para o conteúdo principal
Descreve o tamanho de uma região em blocos.

Sintaxe

Membros

NumTiles
Tipo: UINT
O número de blocos na região em blocos. UseBox
Tipo: BOOL
Especifica se o runtime usa os membros Width, Height e Depth para definir a região. Se TRUE, o runtime usará os membros Width, Height e Depth para definir a região. Nesse caso, NumTiles deve ser igual a Width * Height * Depth. Se FALSE, o runtime ignorará os membros Width, Height e Depth e usará o membro NumTiles para percorrer os blocos no recurso linearmente ao longo de x, depois y, depois z (conforme aplicável) e, em seguida, continuará pelos mipmaps/matrizes na ordem dos sub-recursos. Por exemplo, use essa técnica para mapear um recurso inteiro de uma só vez. Independentemente de você especificar TRUE ou FALSE para UseBox, você usa uma estrutura D3D12_TILED_RESOURCE_COORDINATE para especificar o local inicial da região dentro do recurso como um parâmetro separado fora desta estrutura, usando as coordenadas x, y e z. Quando a região inclui mipmaps empacotados com organização em blocos não padrão, UseBox deve ser FALSE, pois as dimensões dos blocos não são padrão e o aplicativo só sabe quantos blocos são consumidos pela área empacotada, o que é por fatia de matriz. Nesse caso, o parâmetro (separado) correspondente de local inicial usa x como deslocamento no intervalo plano de blocos, e as coordenadas y e z devem ser 0. Width
Tipo: UINT
A largura da região em blocos, em blocos. Usada para buffers e texturas 1D, 2D e 3D. Height
Tipo: UINT16
A altura da região em blocos, em blocos. Usada para texturas 2D e 3D. Depth
Tipo: UINT16
A profundidade da região em blocos, em blocos. Usada para texturas 3D ou matrizes. Para matrizes, é usada para avançar em profundidade, saltando para a próxima fatia de mesmo tamanho de mipmap, que não é contígua no espaço de contagem de sub-recursos se houver vários mipmaps.

Comentários

Esta estrutura é usada pelos métodos CopyTiles, CopyTileMappings e UpdateTileMappings.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

CD3DX12_TILE_REGION_SIZE Estruturas principais
Última modificação em 6 de outubro de 2026