Skip to main content
Describe el tamaño de una región en mosaico.

Sintaxis

Miembros

NumTiles
Tipo: UINT
El número de mosaicos de la región en mosaico. UseBox
Tipo: BOOL
Especifica si el entorno de ejecución usa los miembros Width, Height y Depth para definir la región. Si es TRUE, el entorno de ejecución usa los miembros Width, Height y Depth para definir la región. En este caso, NumTiles debe ser igual a Width * Height * Depth. Si es FALSE, el entorno de ejecución omite los miembros Width, Height y Depth y usa el miembro NumTiles para recorrer los mosaicos del recurso linealmente por x, después y y después z (según corresponda), y a continuación se desborda a los mipmaps o matrices en el orden de los subrecursos. Por ejemplo, use esta técnica para asignar un recurso completo de una vez. Independientemente de si especifica TRUE o FALSE para UseBox, use una estructura D3D12_TILED_RESOURCE_COORDINATE para especificar la ubicación inicial de la región dentro del recurso como un parámetro independiente fuera de esta estructura mediante las coordenadas x, y y z. Cuando la región incluye mipmaps empaquetados con mosaico no estándar, UseBox debe ser FALSE porque las dimensiones de los mosaicos no son estándar y la aplicación solo conoce un recuento de cuántos mosaicos consume el área empaquetada, que es por segmento de matriz. En este caso, el parámetro de ubicación inicial (independiente) correspondiente usa x para el desplazamiento dentro del intervalo plano de mosaicos, y las coordenadas y y z deben ser 0. Width
Tipo: UINT
El ancho de la región en mosaico, en mosaicos. Se usa para búferes y texturas 1D, 2D y 3D. Height
Tipo: UINT16
El alto de la región en mosaico, en mosaicos. Se usa para texturas 2D y 3D. Depth
Tipo: UINT16
La profundidad de la región en mosaico, en mosaicos. Se usa para texturas 3D o matrices. Para las matrices, se usa para avanzar en profundidad saltando al siguiente segmento del mismo tamaño de mipmap, que no es contiguo en el espacio de recuento de subrecursos si hay varios mipmaps.

Comentarios

Esta estructura la usan los métodos CopyTiles, CopyTileMappings y UpdateTileMappings.

Requisitos

Encabezado: d3d12_xs.h o d3d12_x.h
Biblioteca: d3d12_xs.lib o d3d12_x.lib
Plataformas compatibles: consolas XBOX Series y familia XBOX One

Consulte también

CD3DX12_TILE_REGION_SIZE Estructuras principales
Última modificación el 28 de agosto de 2026