> ## 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.

# XBTCCompressTexture

> Compresse une texture en tiles et l'ajoute à l'archive.

Compresse une texture en tiles et l'ajoute à l'archive

## Syntaxe

```cpp theme={null}
HRESULT XBTCCompressTexture(  
         XBTCArchiveWriter* pArchive,  
         XBTC_COMPRESSION_STATS* pStats,  
         const XBTCTextureContainer* pTextureContainer,  
         size_t MipStreams,  
         XBTC_STREAM_GRANULARITY Granularity,  
         XBTC_COMPRESSION_FLAGS Flags,  
         size_t Loss = 0  
)  
```




### Paramètres

*pArchive*   \_Inout\_\
Type : [XBTCArchiveWriter](/fr/reference/graphics/xbtc/interfaces/XBTCArchiveWriter/xbtcarchivewriter)\*

Pointeur vers une instance de `XBTCArchiveWriter`.

*pStats*   \_Out\_opt\_\
Type : [XBTC\_COMPRESSION\_STATS\*](/fr/reference/graphics/xbtc/structs/xbtc_compression_stats)

Au retour, contient les statistiques de l'opération de compression.

*pTextureContainer*   \_In\_\
Type : [XBTCTextureContainer](/fr/reference/graphics/xbtc/interfaces/XBTCTextureContainer/xbtctexturecontainer)\*

Pointeur vers un `XBTCTextureContainer`.

*MipStreams*   \_In\_\
Type : size\_t

Nombre de niveaux de détail (LOD) pouvant être streamés après la texture de base.

*Granularity*   \_In\_\
Type : [XBTC\_STREAM\_GRANULARITY](/fr/reference/graphics/xbtc/enums/xbtc_stream_granularity)

Spécifie la taille de granularité du streaming. En l'absence de streaming, spécifiez XBTC\_STREAM\_GRANULARITY\_WHOLE\_MIPS.

*Flags*   \_In\_\
Type : [XBTC\_COMPRESSION\_FLAGS](/fr/reference/graphics/xbtc/enums/xbtc_compression_flags)

Options de compression de texture.

*Loss*   \_In\_\
Type : size\_t

Niveau de perte de la compression, de 0 à 15. Une perte plus importante améliore les taux de compression.\
Une perte de 0 (sans perte) ne réencode pas une texture BC avec l'optimisation débit-distorsion.
Si la texture est réencodée, le contenu de pTextureContainer est remplacé.
Aucune perte n'est jamais introduite pour les textures non BC.

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite ; sinon, retourne un code d'erreur HRESULT.

## Remarques

`XBTCCompressTexture` compresse la texture source en tiles et l'ajoute à l'archive.\
Pour plus d'informations sur les paramètres de compression, consultez [XBTC\_COMPRESSION\_FLAGS](/fr/reference/graphics/xbtc/enums/xbtc_compression_flags).

## Configuration requise

**En-tête :** XBTC.h

**Plateformes prises en charge** : consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[XBTC\_COMPRESSION\_FLAGS](/fr/reference/graphics/xbtc/enums/xbtc_compression_flags)
[XBTC](/fr/reference/graphics/xbtc/xbtc_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Référence de l'outil XBOX Texture Compressor (XBTC)](/fr/build/core-features/graphics/newfeatures/xbtc/index.md)
- [D3D12_TEXTURE_COPY_LOCATION](/fr/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_TEXTURE_COPY_TYPE](/fr/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_TEXTURE_BARRIER (consoles XBOX Series)](/fr/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)