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

# XBTC_ENCODING_OPTIONS

> Options d'encodage pour XBTCBlockCompressTexture.

Options d'encodage pour [XBTCBlockCompressTexture](/fr/reference/graphics/xbtc/functions/xbtcblockcompresstexture).

## Syntaxe

```cpp theme={null}
typedef struct XBTC_ENCODING_OPTIONS {  
    uint32_t PCAPowerIterations : 4;  
    uint32_t RefinementIterations : 4;  
    uint32_t ChannelCountMinusOne : 2;  
    uint32_t BC7ModeMask : 8;  
    uint32_t QualityLevel : 4;  
    uint32_t ContainsColorMap : 1;  
    uint32_t ContainsNormalMap : 1;  
} XBTC_ENCODING_OPTIONS  
```

### Membres

*PCAPowerIterations*\
Type : uint32\_t

Contrôle le nombre d'itérations utilisées pour résoudre le problème d'analyse en composantes principales (PCA). Cela nécessite une multiplication matricielle itérative et une renormalisation pour approximer la paire matrice propre/vecteur propre.

*RefinementIterations*\
Type : uint32\_t

Contrôle le nombre d'itérations d'affinage des points de terminaison. Lors de la recherche de points de terminaison dans un nuage de points 3D, un recuit simulé ou un autre processus peut évaluer s'il est possible de trouver de meilleurs points de terminaison.

*ChannelCountMinusOne*\
Type : uint32\_t

Spécifie le nombre de canaux de texture qui contiennent des informations importantes. Ceci est particulièrement important pour l'encodage BC7, qui comporte à la fois des modes RGB et RGBA.

*BC7ModeMask*\
Type : uint32\_t

Masque facultatif permettant de restreindre le comportement de l'encodage BC7. En se limitant à un ou deux modes, une texture est généralement plus compressible, mais la qualité est réduite. Des stratégies seront introduites ultérieurement pour équilibrer automatiquement la compression et la qualité.

*QualityLevel*\
Type : uint32\_t

Réservé mais non implémenté. Contrôle le compromis entre qualité et compressibilité. La valeur par défaut de 15 représente une qualité maximale avec une compression minimale. Une qualité de 0 offre la meilleure compression avec BCPack, mais au détriment de la qualité.

*ContainsColorMap*\
Type : uint32\_t

Réservé mais non implémenté. Guide l'encodeur afin de réduire l'erreur RGB.

*ContainsNormalMap*\
Type : uint32\_t

Réservé mais non implémenté. Guide l'encodeur afin de réduire l'erreur de la carte des normales, en supposant que les échantillons de texture seront normalisés.

## Configuration requise

**En-tête :** XBTC.h\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[XBTC](/fr/reference/graphics/xbtc/xbtc_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [XBOX Texture Compressor (XBTC) tool reference](/build/core-features/graphics/newfeatures/xbtc/index.md)
- [XBOX Texture Compressor (XBTC) 도구 참고서](/ko/build/core-features/graphics/newfeatures/xbtc/index.md)