[ Vulkan 연구 ] HLSL to SPIR-V : 4. DXC 필수 바이너리 및 기본 테스트

주의 : 초심자 튜토리얼은 아닙니다. 그러므로, 실제 API 호출 용례를 알고자 한다면, 샘플이나 튜토리얼을 찾아서 확인해 보세요.

주의 : 완전히 이해하고 작성한 글이 아니므로 잘못된 내용이 포함되어 있을 수 있습니다.

주의 : 이상하면 참고자료를 확인하세요.

---

DirectX Shader Compiler 프로젝트를 빌드하고 나면 엄청나게 많은 executable 및 library 들이 생깁니다. 

하지만 우리가 그것을 다 사용할 것이 아니기 때문에 필요한 것만 가져다가 사용해야 합니다. 

일단 "dxc.exe" 프로젝트만 빌드해서 executable 을 뽑아 봤는데, LLVM table 관련 executable 을 배제하면, 필수적인 바이너리의 목록은 다음과 같습니다.

• dxc.exe : 커맨드라인 프로그램.

• dxc.pdf : 디버깅할 거라면 필요함.

• dxcompiler.dll : 실제 구현이 포함되어 있는 동적 라이브러리.

• dxcompiler.pdb : 디버깅할 거라면 필요함.

저는 이것만 복사해서 제가 원하는 디렉토리에 복사했습니다.

이제 vertex shader 를 하나 만들어서 테스트해 보겠습니다. 옵션에 대한 자세한 정보는 [ Supported Command-line Options ] 에서 확인하실 수 있습니다.

struct VSInput { float4 Position : POSITION0; float4 Normal : NORMAL0; float4 TexCoord : TEXCOORD0; float4 Color : COLOR0; }; struct VSOutput { float4 Position : POSITION0; float4 Normal : NORMAL0; float4 TexCoord : TEXCOORD0; float4 Color : COLOR0; }; VSOutput mainVS( VSInput In ) { VSOutput Out = ( VSOutput )0; Out.Position = In.Position; Out.Normal = In.Normal; Out.Color = In.Color; return Out; }

다음과 같이 파워셸에서 테스트해 봤습니다.

PS C:\GIt\HairDresser\Distribution\Binaries\ThirdParty\dxc> .\dxc.exe -spirv -Fc -T vs_5_0 -E mainVS C:\GIt\HairDresser\Distribution\Binaries\ThirdParty\dxc\test.hlsl -Fo test.vertex

• -spirv : SPIR-V 를 생성.
• -E : 엔트리 포인트.
• -Fo : 아웃풋( SPIR-V )

혹시나 해서 dxcompiler.dll 을 지워 봤는데 에러가 발생하더군요.

dxc failed : error code 0x8007007e

다른 spir-v 관련 옵션들도 잘 동작하는지 테스트해 봤습니다.

PS C:\GIt\HairDresser\Distribution\Binaries\ThirdParty\dxc> .\dxc.exe -spirv -T vs_5_0 -E mainVS C:\GIt\HairDresser\Distribution\Binaries\ThirdParty\dxc\test.hlsl -Fo test.vertex -Fc test_dis.vertex

• -Fc : SPIR-V 디스어셈블리 생성.

다음과 같이 정상적으로 디스어셈블리가 생성되었습니다. 내용이 정확한지는 아직 모릅니다. 시리즈를 진행하면서 의미를 파악해 볼 계획입니다.

; SPIR-V ; Version: 1.0 ; Generator: Google spiregg; 0 ; Bound: 21 ; Schema: 0 OpCapability Shader OpMemoryModel Logical GLSL450 OpEntryPoint Vertex %mainVS "mainVS" %in_var_POSITION0 %in_var_NORMAL0 %in_var_TEXCOORD0 %in_var_COLOR0 %out_var_POSITION0 %out_var_NORMAL0 %out_var_TEXCOORD0 %out_var_COLOR0 OpSource HLSL 600 OpName %in_var_POSITION0 "in.var.POSITION0" OpName %in_var_NORMAL0 "in.var.NORMAL0" OpName %in_var_TEXCOORD0 "in.var.TEXCOORD0" OpName %in_var_COLOR0 "in.var.COLOR0" OpName %out_var_POSITION0 "out.var.POSITION0" OpName %out_var_NORMAL0 "out.var.NORMAL0" OpName %out_var_TEXCOORD0 "out.var.TEXCOORD0" OpName %out_var_COLOR0 "out.var.COLOR0" OpName %mainVS "mainVS" OpDecorate %in_var_POSITION0 Location 0 OpDecorate %in_var_NORMAL0 Location 1 OpDecorate %in_var_TEXCOORD0 Location 2 OpDecorate %in_var_COLOR0 Location 3 OpDecorate %out_var_POSITION0 Location 0 OpDecorate %out_var_NORMAL0 Location 1 OpDecorate %out_var_TEXCOORD0 Location 2 OpDecorate %out_var_COLOR0 Location 3 %float = OpTypeFloat 32 %v4float = OpTypeVector %float 4 %_ptr_Input_v4float = OpTypePointer Input %v4float %_ptr_Output_v4float = OpTypePointer Output %v4float %void = OpTypeVoid %15 = OpTypeFunction %void %in_var_POSITION0 = OpVariable %_ptr_Input_v4float Input %in_var_NORMAL0 = OpVariable %_ptr_Input_v4float Input %in_var_TEXCOORD0 = OpVariable %_ptr_Input_v4float Input %in_var_COLOR0 = OpVariable %_ptr_Input_v4float Input %out_var_POSITION0 = OpVariable %_ptr_Output_v4float Output %out_var_NORMAL0 = OpVariable %_ptr_Output_v4float Output %out_var_TEXCOORD0 = OpVariable %_ptr_Output_v4float Output %out_var_COLOR0 = OpVariable %_ptr_Output_v4float Output %16 = OpConstantNull %v4float %mainVS = OpFunction %void None %15 %17 = OpLabel %18 = OpLoad %v4float %in_var_POSITION0 %19 = OpLoad %v4float %in_var_NORMAL0 %20 = OpLoad %v4float %in_var_COLOR0 OpStore %out_var_POSITION0 %18 OpStore %out_var_NORMAL0 %19 OpStore %out_var_TEXCOORD0 %16 OpStore %out_var_COLOR0 %20 OpReturn OpFunctionEnd

단지 "Location" 과 같은 키워드가 있는 것으로 봐서는 따로 리플렉션 도구를 이용하지 않아도 이것을 파싱함으로써 정보를 얻을 수도 있겠다는 생각이 들긴 합니다.

참고 자료

[ 1 ] HLSL to SPIR-V Feature Mapping Manual, DirectXShaderCompiler.