共用方式為


D3D12_RAYTRACING_INSTANCE_DESC 結構 (d3d12.h)

描述加速結構建置程式期間,GPU 記憶體中使用的光線追蹤加速結構的實例。

語法

typedef struct D3D12_RAYTRACING_INSTANCE_DESC {
  FLOAT                     Transform[3][4];
  UINT                      InstanceID : 24;
  UINT                      InstanceMask : 8;
  UINT                      InstanceContributionToHitGroupIndex : 24;
  UINT                      Flags : 8;
  D3D12_GPU_VIRTUAL_ADDRESS AccelerationStructure;
} D3D12_RAYTRACING_INSTANCE_DESC;

成員

Transform[3]

類型: FLOAT [3][4]

代表實例對世界轉換之資料列主要配置中的 3x4 轉換矩陣。 實作會轉換光線,而不是轉換所有幾何或 AAB。

注意

的版面配置 Transform 是一種轉置方式,也就是通常儲存在記憶體中的Affine 矩陣的方式。 而不是四個 3 向量, Transform 會配置為三個 4 向量。

InstanceID

類型: UINT :24

在支援的著色器類型中使用內建函式存取的 InstanceID 任意 24 位值。

InstanceMask

類型: UINT :8

指派給 實例的 8 位遮罩,可用來依每一光線包含/拒絕實例群組。 如果值為零,則永遠不會包含 實例,因此這通常應該設定為一些非零值。 如需詳細資訊, InstanceInclusionMask 請參閱 TraceRay 函式的參數。

InstanceContributionToHitGroupIndex

類型: UINT :24

任意的 24 位值,代表要加入著色器資料表索引的個別實例參與,以選取要使用的點擊群組。

Flags

類型: UINT :8

8 位遮罩,代表要套用至 實例 之D3D12_RAYTRACING_INSTANCE_FLAGS 旗標。

AccelerationStructure

類型: D3D12_GPU_VIRTUAL_ADDRESS

正在實例之底層加速結構的位址。 位址必須對齊 256 個位元組,定義為 D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT。 此處傳入的任何現有加速結構都必須以這類對齊方式放置。

指向 的記憶體必須處於 狀態D3D12_RESOURCE_STATE_RAYTRACING_ACCELERATION_STRUCTURE

備註

如果您要先在 CPU 上產生實例資料,然後再上傳至 GPU,這個 C++ 結構定義會很有用。 但您的應用程式也可以直接從計算著色器產生 GPU 記憶體 (實例描述,例如,遵循相同的配置) 。

需求

   
標頭 d3d12.h