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

# XG 參考 (API 內容) (XBOX One 系列)

> XG 是一個輔助圖形程式庫，用於準備資源，以及執行 Direct3D 執行階段範圍以外的其他圖形相關工作。

XG 是一個輔助圖形程式庫，用於準備資源，以及執行 Direct3D 執行階段介面範圍以外的其他圖形相關工作。標頭：`xg.h`。

<Warning>
  本節可能未與 Microsoft Game Development Kit (GDK) 同步更新，並將在未來的版本中更新。Microsoft Game Development Kit (GDK) 不支援 D3D11。
</Warning>

## 介面

| 介面 | 描述 |
| - | - |
| [XGTextureAddressComputer](/zh-TW/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/xgtextureaddresscomputer) | 保存指定紋理資源的已計算紋理配置。也保存可讓使用者執行紋理元素微型並排與巨集並排的其他狀態。 |

## 函式

| 函式 | 描述 |
| - | - |
| [XGComputeBankRotationAddress](/zh-TW/reference/graphics/xg__NR/functions/xgcomputebankrotationaddress) | 計算 2D 並排表面的記憶體庫輪替位址。 |
| [XGComputeBufferLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputebufferlayout) | 計算緩衝區的硬體對齊。 |
| [XGComputeOptimalDepthStencilTileModes](/zh-TW/reference/graphics/xg__NR/functions/xgcomputeoptimaldepthstenciltilemodes) | 計算指定深度樣板設定的正確並排模式。 |
| [XGComputeOptimalTileMode](/zh-TW/reference/graphics/xg__NR/functions/xgcomputeoptimaltilemode) | 計算指定紋理設定的頻寬最佳並排模式。 |
| [XGComputeTexture1DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture1dlayout) | 計算 1D 紋理的硬體配置。 |
| [XGComputeTexture2DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture2dlayout) | 計算 2D 紋理的硬體配置。 |
| [XGComputeTexture3DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture3dlayout) | 計算 3D 紋理的硬體配置。 |
| [XGComputeTileShape](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetileshape) | 傳回指定格式的單一並排資源圖格形狀。 |
| [XGCreateTexture1DComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexture1dcomputer) | 為指定的 1D 紋理描述建立紋理位址計算器物件。 |
| [XGCreateTexture2DComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexture2dcomputer) | 為指定的 2D 紋理描述建立紋理位址計算器物件。 |
| [XGCreateTexture3DComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexture3dcomputer) | 為指定的 3D 紋理描述建立紋理位址計算器物件。 |
| [XGCreateTextureComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexturecomputer) | 為指定的 D3D12 樣式資源描述建立紋理位址計算器物件。 |
| [XGCreateTextureComputerFromDescriptor](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexturecomputerfromdescriptor) | 為指定的紋理描述元建立紋理位址計算器物件。 |
| [XGCreateTextureComputerWithPitch](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexturecomputerwithpitch) | 為 Direct3D12 樣式資源描述建立紋理位址計算器物件。 |
| [XGDecodeDCC](/zh-TW/reference/graphics/xg__NR/functions/xgdecodedcc) | 解碼 (解壓縮) 差異色彩壓縮的表面。 |
| [XGEnableExclusiveLocking](/zh-TW/reference/graphics/xg__NR/functions/xgenableexclusivelocking) | 啟用或停用紋理位址計算 API 的獨佔鎖定。 |
| [XGEncodeDCC](/zh-TW/reference/graphics/xg__NR/functions/xgencodedcc) | 使用差異色彩壓縮 (DCC) 編碼 (壓縮) 表面。 |
| [XGEnterExclusiveLock](/zh-TW/reference/graphics/xg__NR/functions/xgenterexclusivelock) | 進入獨佔鎖定，用來將 XGSetHardwareVersion 的呼叫與 XG 紋理計算器的建立同步。 |
| [XGLeaveExclusiveLock](/zh-TW/reference/graphics/xg__NR/functions/xgleaveexclusivelock) | 離開獨佔鎖定，該鎖定用來將 XGSetHardwareVersion 的呼叫與 XG 紋理計算器的建立同步。 |
| [XGSetHardwareVersion](/zh-TW/reference/graphics/xg__NR/functions/xgsethardwareversion) | 為指定的硬體版本設定 XG。 |
| [XGValidateDepthStencilTileMode](/zh-TW/reference/graphics/xg__NR/functions/xgvalidatedepthstenciltilemode) | 檢查指定的並排模式對深度樣板格式和取樣數是否有效。 |
| [XGValidateJpegFile](/zh-TW/reference/graphics/xg__NR/functions/xgvalidatejpegfile) | 驗證 JPEG 檔案是否可進行硬體解碼。 |

## 結構

| 結構 | 描述 | |
| - | - | - |
| [XG\_BUFFER\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_buffer_desc) | 描述緩衝區資源。 | |
| [XG\_DCC\_OPTIONS](/zh-TW/reference/graphics/xg__NR/structs/xg_dcc_options) | 設定差異色彩壓縮 (DCC) 組態選項。 | |
|  | [XG\_DESCRIPTOR\_TEXTURE\_VIEW](/zh-TW/reference/graphics/xg__NR/structs/xg_descriptor_texture_view) | 代表紋理的原生繫結描述元。 |
| [XG\_MIPLEVEL\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_miplevel_layout) | 描述紋理硬體配置中的單一 MIP 層級。 | |
| [XG\_PACKED\_MIP\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_packed_mip_desc) | 描述具有 MIP 對應之並排資源的圖格結構。 | |
| [XG\_PLANE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_plane_layout) | 描述紋理硬體配置中的 MIP 鏈結。 | |
| [XG\_RESOURCE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_resource_desc) | 描述 XG 資源。 | |
| [XG\_RESOURCE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_resource_layout) | 描述單一資源的完整硬體配置。 | |
| [XG\_SAMPLE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_sample_desc) | 描述資源的多重取樣參數。 | |
| [XG\_SUBRESOURCE\_TILING](/zh-TW/reference/graphics/xg__NR/structs/xg_subresource_tiling) | 控制子資源的並排。 | |
| [XG\_TEXTURE1D\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_texture1d_desc) | 為 XG 紋理配置 API 描述 1D 紋理。 | |
| [XG\_TEXTURE2D\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_texture2d_desc) | 為 XG 紋理配置 API 描述 2D 紋理。 | |
| [XG\_TEXTURE3D\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_texture3d_desc) | 為 XG 紋理配置 API 描述 3D 紋理。 | |
| [XG\_TILE\_SHAPE\_ELEMENTS](/zh-TW/reference/graphics/xg__NR/structs/xg_tile_shape_elements) | 儲存圖格的寬度、高度和深度 (以元素為單位)。 | |
| [XG\_TILE\_SHAPE](/zh-TW/reference/graphics/xg__NR/structs/xg_tile_shape) | 儲存圖格的寬度、高度和深度 (以紋素為單位)。 | |
| [XG\_VALIDATED\_JPEG\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_validated_jpeg_desc) | 保存 JPEG 檔案資料流的驗證結果。 | |

## 列舉

| 列舉 | 描述 |
| - | - |
| [XG\_BIND\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_bind_flag) | 指定資源繫結至管線的方式。 |
| [XG\_CPU\_ACCESS\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_cpu_access_flag) | 指定資源允許的 CPU 存取類型。 |
| [XG\_DCC\_COLOR\_TRANSFORM](/zh-TW/reference/graphics/xg__NR/enums/xg_dcc_color_transform) | 設定在差異色彩壓縮 (DCC) 之前執行的色彩轉換。 |
| [XG\_DCC\_COMPRESSION\_LEVEL](/zh-TW/reference/graphics/xg__NR/enums/xg_dcc_compression_level) | 設定差異色彩壓縮 (DCC) 單位大小的上限。 |
| [XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format) | 資源資料格式，包括完整類型和無類型格式。 |
| [XG\_HARDWARE\_VERSION](/zh-TW/reference/graphics/xg__NR/enums/xg_hardware_version) | 代表 XBOX One 系列裝置中的不同硬體版本。 |
| [XG\_PLANE\_USAGE](/zh-TW/reference/graphics/xg__NR/enums/xg_plane_usage) | 代表紋理資源中平面的預期用途。 |
| [XG\_RESOURCE\_DIMENSION](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_dimension) | 識別資源的類型。 |
| [XG\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_misc_flag) | 識別資源的選項。 |
| [XG\_TEXTURE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/enums/xg_texture_layout) | 指定紋理配置的選項。在 XBOX 上，此列舉包含 XBOX 延伸模組成員。 |
| [XG\_TILE\_MODE](/zh-TW/reference/graphics/xg__NR/enums/xg_tile_mode) | 代表 1D、2D 或 3D 紋理所使用的並排模式。紋理的特殊用途 (例如深度、樣板和可呈現的緩衝區) 需要使用特定的並排模式索引。 |
| [XG\_USAGE](/zh-TW/reference/graphics/xg__NR/enums/xg_usage) | 識別轉譯期間資源的預期用途。用途直接反映資源是否可由 CPU 和/或 GPU 存取。 |
| [XG12\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg12_resource_misc_flag) | 識別資源的選項。 |


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX GDK 主機開發的 NDA 主題索引](/zh-TW/nda/nda-overview.md)
- [工具 API 參考](/zh-TW/reference/tools/gc-reference-tools-toc.md)
- [PIXBeginEvent 參考](/zh-TW/reference/tools/pix3/functions/pixbeginevent_3.md)
- [PIXEndEvent 參考](/zh-TW/reference/tools/pix3/functions/pixendevent.md)
