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

> XBTCBlockCompressTexture 的編碼選項。

[XBTCBlockCompressTexture](/zh-TW/reference/graphics/xbtc/functions/xbtcblockcompresstexture) 的編碼選項。

## 語法

```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  
```

### 成員

*PCAPowerIterations*\
類型: uint32\_t

控制用來解決主成分分析 (PCA) 問題的反覆運算次數。這需要反覆的矩陣乘法與重新正規化，以近似特徵矩陣/向量組。

*RefinementIterations*\
類型: uint32\_t

控制端點精簡的反覆運算次數。在 3D 點雲中搜尋端點時，模擬退火或其他程序可能會評估是否能找到更好的端點。

*ChannelCountMinusOne*\
類型: uint32\_t

指定有多少紋理通道包含重要資訊。這對於同時具有 RGB 和 RGBA 模式的 BC7 編碼特別重要。

*BC7ModeMask*\
類型: uint32\_t

用於限制 BC7 編碼行為的選擇性遮罩。限制為一或兩種模式時，紋理通常更容易壓縮，但品質會降低。日後將會推出自動平衡壓縮與品質的策略。

*QualityLevel*\
類型: uint32\_t

已保留但尚未實作。控制品質與可壓縮性之間的取捨。預設值 15 代表最高品質與最低壓縮。品質為 0 時，使用 BCPack 的壓縮效果最佳，但品質會變差。

*ContainsColorMap*\
類型: uint32\_t

已保留但尚未實作。引導編碼器減少 RGB 誤差。

*ContainsNormalMap*\
類型: uint32\_t

已保留但尚未實作。在假設紋理取樣會正規化的情況下，引導編碼器減少法線貼圖誤差。

## 需求

**標頭:** XBTC.h\
**支援的平台**: XBOX Series 主機

## 另請參閱

[XBTC](/zh-TW/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)