> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_TILE_REGION_SIZE

> Décrit la taille d'une région en mosaïque. (D3D12_TILE_REGION_SIZE)

Décrit la taille d'une région en mosaïque.

## Syntaxe

```cpp theme={null}
typedef struct D3D12_TILE_REGION_SIZE
{
    UINT NumTiles;
    BOOL UseBox;
    UINT Width;
    UINT16 Height;
    UINT16 Depth;
} D3D12_TILE_REGION_SIZE
```

### Membres

*NumTiles*\
Type : UINT

Nombre de vignettes dans la région en mosaïque.

*UseBox*\
Type : BOOL

Spécifie si le runtime utilise les membres **Width**, **Height** et **Depth** pour définir la région.

Si la valeur est **TRUE**, le runtime utilise les membres **Width**, **Height** et **Depth** pour définir la région. Dans ce cas, **NumTiles** doit être égal à **Width** \*  **Height** \* **Depth**.

Si la valeur est **FALSE**, le runtime ignore les membres **Width**, **Height** et **Depth** et utilise le membre **NumTiles** pour parcourir les vignettes de la ressource de façon linéaire selon x, puis y, puis z (le cas échéant), puis déborde sur les mipmaps/tableaux dans l'ordre des sous-ressources. Par exemple, utilisez cette technique pour mapper une ressource entière en une seule fois.

Que vous spécifiiez **TRUE** ou **FALSE** pour **UseBox**, vous utilisez une structure [D3D12\_TILED\_RESOURCE\_COORDINATE](/fr/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) pour spécifier l'emplacement de départ de la région dans la ressource, sous la forme d'un paramètre distinct en dehors de cette structure, à l'aide des coordonnées x, y et z.

Lorsque la région inclut des mipmaps empaquetés avec une disposition en mosaïque non standard, **UseBox** doit être **FALSE**, car les dimensions des vignettes ne sont pas standard et l'application connaît uniquement le nombre de vignettes consommées par la zone empaquetée, qui est défini par tranche de tableau. Dans ce cas, le paramètre (distinct) d'emplacement de départ correspondant utilise x comme décalage dans la plage plate de vignettes, et les coordonnées y et z doivent chacune être égales à 0.





*Width*\
Type : UINT

Largeur de la région en mosaïque, en vignettes. Utilisé pour les mémoires tampons et les textures 1D, 2D et 3D.

*Height*\
Type : UINT16

Hauteur de la région en mosaïque, en vignettes. Utilisé pour les textures 2D et 3D.

*Depth*\
Type : UINT16

Profondeur de la région en mosaïque, en vignettes. Utilisé pour les textures 3D ou les tableaux. Pour les tableaux, l'avancement en profondeur passe à la tranche suivante de même taille de mipmap, qui n'est pas contiguë dans l'espace de numérotation des sous-ressources s'il existe plusieurs mipmaps.

## Remarques

Cette structure est utilisée par les méthodes [CopyTiles](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public), [CopyTileMappings](/fr/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public) et [UpdateTileMappings](/fr/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public).

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge** : consoles XBOX Series et famille XBOX One

## Voir aussi

[CD3DX12\_TILE\_REGION\_SIZE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-tile-region-size)

[Structures principales](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [CopyTiles](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)
- [CopyTileMappings](/fr/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [D3D12_TILE_COPY_FLAGS](/fr/reference/graphics/d3d12/enums/d3d12_tile_copy_flags_public.md)
- [D3D12_TILE_SHAPE](/fr/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [D3D12_TILE_RANGE_FLAGS](/fr/reference/graphics/d3d12/enums/d3d12_tile_range_flags_public.md)