語法
成員
SizeBytes類型:UINT64 此 mip 層級的大小 (以位元組為單位)。對於具有多個配量的陣列紋理,SizeBytes 只會反映此 mip 層級在單一配量中的大小。對於體積紋理,SizeBytes 會反映此 mip 層級所有「深度配量」的累計大小,但它們在記憶體中可能不連續。 OffsetBytes
類型:UINT64 OffsetBytes 會反映此 mip 層級在第一個陣列配量中的位移。若要計算此 mip 層級在配量 1-n 中的位移,請將 OffsetBytes 加上平面配置的 SliceSizeBytes 乘以配量索引的值。 Slice2DSizeBytes
類型:UINT64 對於 2D (陣列) 紋理,Slice2DSizeBytes 等同於 SizeBytes;對於 3D 紋理,則為一個深度配量的大小。 PitchPixels
類型:UINT32 此 mip 層級的間距 (以像素為單位)。 PitchBytes
類型:UINT32 此 mip 層級的間距 (以位元組為單位)。 AlignmentBytes
類型:UINT32 此 mip 層級的對齊 (以位元組為單位)。對於標準 mip 層級,這等於 Swizzle 模式區塊大小;對於封裝 mip 尾端的 mip 層級,則為 256 個位元組。 PaddedWidthElements
類型:UINT32 mip 層級填補後的寬度 (以元素為單位)。請注意,對於某些格式,一個元素的寬度和/或高度可能超過一個像素。 PaddedHeightElements
類型:UINT32 mip 層級填補後的高度 (以元素為單位)。 PaddedDepthOrArraySize
類型:UINT32 mip 層級填補後的深度或陣列大小。 WidthElements
類型:UINT32 mip 層級的寬度 (以元素為單位)。 HeightElements
類型:UINT32 mip 層級的高度 (以元素為單位)。 WidthPixels
類型:UINT32 mip 層級的寬度 (以像素為單位)。 HeightPixels
類型:UINT32 mip 層級的高度 (以像素為單位)。 DepthOrArraySize
類型:UINT32 mip 層級的深度或陣列大小。 SampleCount
類型:UINT32 取樣數目。 SwizzleMode
類型:XG_SWIZZLE_MODE mip 層級的 Swizzle 模式。 BankRotationAddressBitMask
類型:UINT64 對應於紋理基底位址中可套用記憶庫輪替之位置的位元遮罩。如果不支援記憶庫輪替,此值將為 0。 BankRotationBytesPerSlice
類型:UINT64 當記憶庫輪替的陣列紋理資源繫結為轉譯目標時,套用至每個配量基底位址的記憶庫輪替位元組數。 SliceDepthElements
類型:UINT32 對於體積紋理,這是體積配量的深度 (以元素為單位)。體積紋理 mip 層級可能由多個體積配量組成。 IsMipTail
類型:UINT32 如果此 mip 層級不是封裝 mip 尾端的一部分,則為零。如果此 mip 層級是封裝 mip 尾端的一部分,則為一。 MipTailOffsetElementsX
類型:UINT32 如果此 mip 層級是 mip 尾端,則描述 mip 影像位置在 mip 尾端區塊內的 x 位移。 MipTailOffsetElementsY
類型:UINT32 如果此 mip 層級是 mip 尾端,則描述 mip 影像位置在 mip 尾端區塊內的 y 位移。 MipTailOffsetElementsZ
類型:UINT32 如果此 mip 層級是 mip 尾端,則描述 mip 影像位置在 mip 尾端區塊內的 z 位移。
備註
體積紋理 Mip 層級
請注意,對於體積紋理,每個 mip 層級在記憶體中可能不連續。 若要判斷體積 mip 層級所佔用的記憶體範圍,請使用下列以 DepthSliceIndex 為索引的公式。mip 層級的深度配量數目為 MipLayout.DepthOrArraySize 除以 MipLayout.SliceDepthElements。 深度配量的起始位移:PlaneLayout.SliceSizeBytes * DepthSliceIndex + MipLayout.OffsetBytes 深度配量的結束位移:StartOffset + MipLayout.Slice2DSizeBytes * MipLayout.SliceDepthElements 上述計算適用於所有非尾端 mip。由於尾端 mip 會封裝至單一區塊中,其範圍會交錯,無法個別定址。如果您將這些計算套用至尾端 mip,所有此類層級都會得到相同的起始和結束位移。需求
標頭: xg_xs.h支援的平台: XBOX Series 主機
