Unity HLSL 셰이더의 프리 프로세서 지시문 사용하기

개요

Unity의 HLSL(Higher Level Shading Language)을 사용하여 셰이더를 작성할 때, 다양한 그래픽스 API와 플랫폼을 타겟팅하기 위해 프리 프로세서 지시문을 사용하는 방법을 설명합니다. 이 가이드는 그래픽스 API를 포함하거나 제외할 수 있는 방법과 특정 그래픽스 티어에 대한 셰이더 배리언트를 생성하는 방법을 소개합니다.

특정 그래픽스 API 포함 또는 제외하기

기본적으로 Unity는 현재 빌드 타겟에 맞춰 모든 그래픽스 API를 위한 셰이더를 컴파일합니다. 하지만 특정 그래픽스 API에만 셰이더를 컴파일하는 것이 필요할 수 있습니다. 이를 위해 다음과 같은 지시문을 사용할 수 있습니다.

특정 API만을 위한 셰이더 컴파일

  • #pragma only_renderers

여러 개의 API를 공백으로 구분하여 지정할 수 있습니다.

# pragma only_renderers metal vulkan

특정 컴파일러에서 셰이더 코드 제외하기

  • #pragma exclude_renderers

마찬가지로 공백으로 여러 API를 명시할 수 있습니다.

# pragma exclude_renderers metal vulkan

그래픽스 티어를 위한 셰이더 배리언트 생성

Unity는 빌트인 렌더 파이프라인에서 그래픽스 티어에 상응하는 셰이더 배리언트를 자동으로 생성합니다. 필요시 강제로 생성하도록 지시할 수 있습니다.

셰이더 배리언트 강제 생성

  • #pragma hardware_tier_variants

예를 들어, Metal을 위한 티어 셰이더 배리언트를 강제 생성하려면 다음과 같이 작성합니다.

# pragma hardware_tier_variants metal

유효한 파라미터 값 리스트

아래는 지원되는 값의 목록입니다.

설명
d3d11 DirectX 11 기능 레벨 10 이상, DirectX 12
gles OpenGL ES 2.0, WebGL 1.0
gles3 OpenGL ES 3.x, WebGL 2.0
ps4 PlayStation 4
xboxone Xbox One 및 GameCore, DirectX 11 및 DirectX 12
metal iOS/Mac Metal
glcore OpenGL 3.x, OpenGL 4.x
vulkan Vulkan
switch Nintendo Switch
ps5 PlayStation 5

결론

HLSL의 프리 프로세서 지시문을 활용하여 특정 그래픽스 API를 타겟팅하거나, 필요에 따라 셰이더 배리언트를 자동으로 생성하는 방법에 대해 알아보았습니다. 이러한 기술을 활용하면 각 플랫폼에 최적화된 성능을 갖춘 그래픽스를 제공할 수 있습니다.

Read more

Unity 매뉴얼 스크립팅 API 해설

이 문서는 Unity의 매뉴얼 스크립팅 API에 대한 간단한 해설과 활용 예제들을 포함하고 있습니다. Unity는 게임 개발 플랫폼으로, 스크립팅 API를 통해 게임의 다양한 기능을 제어하고 수정할 수 있습니다. 버전 Unity 스크립팅 API는 여러 버전으로 제공됩니다. 주의 깊게 선택하여 사용하는 것이 중요합니다. 버전 설명 2023.2 최신 기능 및 버그 수정이 추가됨

By 이재협/실장/시스템개발실/PHYSIA

Unity 매뉴얼 스크립팅 API 설명서 해설

이 문서는 Unity의 매뉴얼 스크립팅 API에 대한 정보를 제공하며, 버전에 따라 다르게 적용되는 내용들을 설명합니다. 본 문서에서는 주요 내용을 간단히 정리하고 활용 가능 예제를 통해 이해를 돕겠습니다. 기본 개념 Unity에서 스크립팅 API는 게임 오브젝트와 그들의 동작을 제어하기 위한 강력한 도구입니다. 이를 통해 게임의 로직, 물리 엔진, 애니메이션 및 사용자 인터페이스를

By 이재협/실장/시스템개발실/PHYSIA

Unity 스크립팅 API 가이드

이 문서는 Unity의 스크립팅 API에 대해 설명합니다. Unity는 게임 개발을 위한 인기 있는 엔진으로, 강력한 스크립팅 기능을 제공합니다. 이 가이드는 Unity에서 스크립트를 작성하고 사용하는 방법을 이해하는 데 도움을 드립니다. 목차 * Unity 스크립팅 소개 * 기본 스크립트 생성 * 스크립트 사용 예제 * 응용 프로그램 * 참고 자료 Unity 스크립팅 소개 Unity는 C# 프로그래밍 언어를

By 이재협/실장/시스템개발실/PHYSIA