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

> Opções de codificação para XBTCBlockCompressTexture.

Opções de codificação para [XBTCBlockCompressTexture](/pt-BR/reference/graphics/xbtc/functions/xbtcblockcompresstexture).

## Sintaxe

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

### Membros

*PCAPowerIterations*\
Tipo: uint32\_t

Controla o número de iterações usadas para resolver o problema da Análise de Componentes Principais. Isso requer multiplicação iterativa de matrizes e renormalização para aproximar o par de automatriz/autovetor.

*RefinementIterations*\
Tipo: uint32\_t

Controla o número de iterações de refinamento de pontos de extremidade. Ao procurar pontos de extremidade em uma nuvem de pontos 3D, o recozimento simulado ou outro processo pode avaliar se é possível encontrar pontos de extremidade melhores.

*ChannelCountMinusOne*\
Tipo: uint32\_t

Especifica quantos canais de textura contêm informações importantes. Isso é particularmente importante para a codificação BC7, que tem modos RGB e RGBA.

*BC7ModeMask*\
Tipo: uint32\_t

Uma máscara opcional para restringir o comportamento da codificação BC7. Ao restringir a um ou dois modos, uma textura geralmente fica mais compactável, mas a qualidade é reduzida. Estratégias serão introduzidas posteriormente para equilibrar compactação e qualidade automaticamente.

*QualityLevel*\
Tipo: uint32\_t

Reservado, mas não implementado. Controla o equilíbrio entre qualidade e capacidade de compactação. O padrão de 15 representa a qualidade máxima com compactação mínima. Uma qualidade de 0 proporcionará a melhor compactação usando BCPack, mas a qualidade será prejudicada.

*ContainsColorMap*\
Tipo: uint32\_t

Reservado, mas não implementado. Orienta o codificador a reduzir o erro RGB.

*ContainsNormalMap*\
Tipo: uint32\_t

Reservado, mas não implementado. Orienta o codificador a reduzir o erro do mapa normal, supondo que as amostras de textura serão normalizadas.

## Requisitos

**Cabeçalho:** XBTC.h\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[XBTC](/pt-BR/reference/graphics/xbtc/xbtc_members)


## Related topics

- [Referência da ferramenta XBOX Texture Compressor (XBTC)](/pt-BR/build/core-features/graphics/newfeatures/xbtc/index.md)
- [Ferramentas de linha de comando para desenvolvimento em console](/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)
- [XAppCaptureVideoEncoding](/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [game_chat_audio_encoding_bitrate](/pt-BR/reference/chat/gamechat2/enums/game_chat_audio_encoding_bitrate.md)
- [chat_manager::audio_encoding_bitrate](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_audio_encoding_bitrate.md)