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

# XBTCTileAndCompressTexture

> 將線性紋理並排、壓縮並寫入封存。

將線性紋理並排、壓縮並寫入封存。

## 語法

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

### 參數

*pArchive*   \_Inout\_\
類型: XBTCArchiveWriter\*

指向 `XBTCArchiveWriter` 執行個體的指標。

*pStats*   \_Out\_opt\_\
類型: [XBTC\_COMPRESSION\_STATS\*](/zh-TW/reference/graphics/xbtc/structs/xbtc_compression_stats)

傳回時包含壓縮作業的統計資料。

*pTextureContainer*   \_In\_\
類型: XBTCTextureContainer\*

指向 `XBTCTextureContainer` 的指標。

*TilingMode*   \_In\_\
類型: [XBTC\_TILING\_MODE](/zh-TW/reference/graphics/xbtc/enums/xbtc_tiling_mode)

Swizzle 模式與並排大小。

*MipStreams*   \_In\_\
類型: size\_t

基底紋理之後可串流的詳細程度 (LOD) 數目。

*Granularity*   \_In\_\
類型: [XBTC\_STREAM\_GRANULARITY](/zh-TW/reference/graphics/xbtc/enums/xbtc_stream_granularity)

指定串流資料粒度大小。如果不進行串流，請指定 XBTC\_STREAM\_GRANULARITY\_WHOLE\_MIPS。

*Flags*   \_In\_\
類型: [XBTC\_COMPRESSION\_FLAGS](/zh-TW/reference/graphics/xbtc/enums/xbtc_compression_flags)

紋理壓縮選項。

*Loss*   \_In\_\
類型: size\_t

壓縮的失真層級，範圍為 0-15。失真越多，壓縮比越好。\
失真為 0 (無失真) 時，不會以速率失真最佳化重新編碼 BC 紋理。
如果紋理經過重新編碼，pTextureContainer 的內容將會被覆寫。
非 BC 紋理永遠不會產生失真。

### 傳回值

類型: HRESULT

HRESULT 成功或錯誤碼。

## 備註

`XBTCTileAndCompressTexture` 會將紋理並排、壓縮，並附加至封存。
如需 Swizzle 模式與並排粒度的詳細資訊，請參閱 [XBTC\_TILING\_MODE](/zh-TW/reference/graphics/xbtc/enums/xbtc_tiling_mode)。
如需紋理壓縮選項的詳細資訊，請參閱 [XBTC\_COMPRESSION\_FLAGS](/zh-TW/reference/graphics/xbtc/enums/xbtc_compression_flags)。

## 需求

**標頭:** XBTC.h

**支援的平台**: XBOX One 系列主機與 XBOX Series 主機

## 另請參閱

[XBTC\_TILING\_MODE](/zh-TW/reference/graphics/xbtc/enums/xbtc_tiling_mode)\
[XBTC\_COMPRESSION\_FLAGS](/zh-TW/reference/graphics/xbtc/enums/xbtc_compression_flags)
[XBTC](/zh-TW/reference/graphics/xbtc/xbtc_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/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)
- [XBOX Texture Compressor (XBTC) 工具参考](/zh-CN/build/core-features/graphics/newfeatures/xbtc/index.md)