[workstream] Resources

[bogner]

HLSL has buffer, texture, and sampler types that need to be lowered to resource representations when lowered to DXIL and SPIR-V.

Milestones

Compile a runnable shader from clang (#7)

• [DirectX] DXIL "typed" resource handles and buffer operations llvm-project#101555
• [HLSL] Frontend handling of "typed" resource types and buffer operations llvm-project#101557
• [HLSL] Eliminate resource global variables from module llvm-project#104271

Compile particle_life.hlsl (#20)

• Structured buffers #88
• CBuffers #41
• [HLSL] Remove HLSLResource llvm-project#104862
• [HLSL] Remove old resource annotations llvm-project#114126
• Validation for resource element types #74

Compile all DML shaders, and they pass the validator (#11)

• ByteAddressBuffer support #10
• [HLSL] Use constructors for resource handle initialization llvm-project#111566

Render Simple Triangle (#13)

• [HLSL][DirectX] Texture and Sampler resource types and operations llvm-project#101558

Pixel and Vertex Shaders (#16)

• Sampler Feedback

Ray Tracing (#18)

• Ray tracing payloads
• Library shaders

V1 Release (#19)

• Work graph nodes
• Resources Backlog #46

[davidcook-msft]

Blocked on the design being finalized

[bogner]

For the middle/back end parts we need the following tasks:

• [DirectX] Introduce llvm.dx.handle.fromBinding intrinsic and lowering llvm-project#91366
• [DirectX] Introduce llvm.dx.handle.fromHeap intrinsic and lowering llvm-project#91406
• [DirectX] Introduce llvm.dx.updateCounter intrinsic and lower it to the dxil op llvm-project#92147
• [DirectX] Implement an analysis pass(es?) to derive IsGloballyCoherent and HasCounter, and wire this up to create handle lowering llvm-project#92148
• [DirectX] Introduce llvm.dx.typedBufferLoad/Store intrinsics and lower them to typed bufferLoad/bufferStore dxil ops llvm-project#91367
• Introduce llvm.dx.rawBufferLoad/Store and lower them to rawBufferLoad/Store dxil ops
• Implement llvm.dx.getDimensions and lower it to the dxil op
• Implement llvm intrinsics for texture sampling and lower them to the dxil ops
• Implement load/store (and other non-sampling) intrinsics for textures and lower them to dxil ops

I'll make a separate list for frontend parts

[bogner]

In clang, we'll need these tasks:

• Introduce an HLSLResource builtin type (See [HLSL] Add Intangible AST Type llvm-project#90631)
• [HLSL] Add DirectXTargetCodeGenInfo and the code paths to convert HLSL types to DirectX target types llvm-project#95952
• [HLSL] Introduce builtins to index into HLSLResource types llvm-project#95956
• [HLSL] Replace void * handles in HLSLExternalSemaSource with HLSLResource builtin types llvm-project#84824
• Implement builtins for texture sampling operations on HLSLResource types that will lower to the llvm intrinsics

[damyanp]

@bogner - particle life seems to coincidentally be using alignment for structured buffers that work well, but @python3kgae suggests that we'll need to has plan for the vector alignment difference between hlsl(the element) and c++(the whole vector) . (This note to remind us to capture this somewhere in our plans).