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

> 壓縮並排紋理，並將其附加至封存。

壓縮並排紋理，並將其附加至封存

## 語法

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

### 參數

*pArchive*   \_Inout\_\
類型：[XBTCArchiveWriter](/zh-TW/reference/graphics/xbtc/interfaces/XBTCArchiveWriter/xbtcarchivewriter)\*

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

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

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

*pTextureContainer*   \_In\_\
類型：[XBTCTextureContainer](/zh-TW/reference/graphics/xbtc/interfaces/XBTCTextureContainer/xbtctexturecontainer)\*

指向 `XBTCTextureContainer` 的指標。

*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

如果成功，則傳回 `S_OK`；否則會傳回 HRESULT 錯誤碼。

## 備註

`XBTCCompressTexture` 會壓縮並排的來源紋理，並將其附加至封存。\
如需壓縮設定的詳細資訊，請參閱 [XBTC\_COMPRESSION\_FLAGS](/zh-TW/reference/graphics/xbtc/enums/xbtc_compression_flags)。

## 需求

**標頭:** XBTC.h

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

## 另請參閱

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


## Related topics

- [XBOX Texture Compressor (XBTC) 工具參考](/zh-TW/build/core-features/graphics/newfeatures/xbtc/index.md)
- [D3D12_TEXTURE_COPY_LOCATION](/zh-TW/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_TEXTURE_COPY_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_TEXTURE_BARRIER (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)
- [HCHttpCallResponseSetGzipCompressed](/zh-TW/reference/live/httpclient/httpclient/functions/hchttpcallresponsesetgzipcompressed.md)