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

> 紋理串流選項。

串流資料粒度是指為了串流而個別壓縮的紋理區域大小。預設會獨立壓縮整個 mip 層級。採用 PRT 或 SFS 時，紋理串流必須是 64KB 虛擬記憶體分頁大小的倍數。它們也需要 64KB 並排模式。

## 語法

```cpp theme={null}
enum XBTC_STREAM_GRANULARITY
{
  XBTC_STREAM_GRANULARITY_WHOLE_MIPS = 0x0,
  XBTC_STREAM_GRANULARITY_64KB = 0x1,
  XBTC_STREAM_GRANULARITY_128KB = 0x2,
  XBTC_STREAM_GRANULARITY_256KB = 0x3
}
```

## 常數

| 常數 | 描述 |
| - | - |
| XBTC\_STREAM\_GRANULARITY\_WHOLE\_MIPS | 壓縮整個 mip 以進行串流。 |
| XBTC\_STREAM\_GRANULARITY\_64KB | 壓縮個別分頁以進行串流 (需要 64KB 並排)。 |
| XBTC\_STREAM\_GRANULARITY\_128KB | 壓縮 2x1 (連續) 分頁以進行串流 (需要 64KB 並排)。 |
| XBTC\_STREAM\_GRANULARITY\_256KB | 壓縮 2x2 分頁叢集以進行串流 (需要 64KB 並排)。 |

## 備註

*XBTC\_STREAM\_GRANULARITY* 用於 [XBTC\_TEXTURE\_INFO](/zh-TW/reference/graphics/xbtc/structs/xbtc_texture_info) 結構中。

XBTC\_STREAM\_GRANULARITY\_64KB 等同於已淘汰的並排模式 XBTC\_TILING\_SCARLETT\_64KB\_PRT。

*注意:* XBTC\_STREAM\_GRANULARITY\_256KB 假設 VM 分頁採用正方形 2x2 排列。由於分頁以線性 (打字機) 順序出現，兩半部分在 VM 位址空間中可能不連續。若要避免次要複製，請使用 DirectStorage 寫入 VM 分頁 ID 陣列的功能。

下列函式會使用此列舉：

* [XBTCCompressTexture](/zh-TW/reference/graphics/xbtc/functions/xbtccompresstexture)
* [XBTCTileAndCompressTexture](/zh-TW/reference/graphics/xbtc/functions/xbtctileandcompresstexture)

## 需求

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

## 另請參閱

[XBTC 成員](/zh-TW/reference/graphics/xbtc/xbtc_members)\
[XBTC 概觀](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/newfeatures/xbtc/xbtc)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/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)