렌더 파이프라인 컨버터

렌더 파이프라인 컨버터는 빌트인 렌더 파이프라인 프로젝트용으로 제작된 에셋을 URP와 호환되는 에셋으로 전환합니다.

참고: 전환 프로세스는 프로젝트에 되돌릴 수 없는 변경 사항을 적용합니다. 전환하기 전에 프로젝트를 백업하십시오.

렌더 파이프라인 컨버터를 사용하는 방법

프로젝트 에셋을 전환하려면 다음 단계를 따르십시오.

Window > Rendering > Render Pipeline Converter를 선택합니다. Unity에 Render Pipeline Converter 창이 열립니다.
전환 타입을 선택합니다.
전환 타입에 따라 다이얼로그에 사용 가능한 컨버터가 표시됩니다. 컨버터 이름 옆의 체크박스를 선택하거나 선택 해제하여 컨버터를 활성화 또는 비활성화합니다.

사용 가능한 컨버터 리스트는 컨버터 섹션을 참조하십시오.
Initialize Converters를 클릭합니다. 렌더 파이프라인 컨버터가 프로젝트의 에셋을 전처리하고 전환할 요소 리스트를 표시합니다. 에셋 옆의 체크박스를 선택하거나 선택 해제하여 전환 프로세스에서 포함하거나 제외합니다.

다음 그림에는 초기화된 컨버터가 나와 있습니다.

컨버터를 클릭하면 컨버터가 전환할 항목 리스트가 표시됩니다.

노란색 아이콘: 요소 옆에 노란색 아이콘은 전환을 실행하기 위해 사용자 작업이 필요할 수 있음을 나타냅니다. 마우스 포인터를 아이콘 위에 올려놓으면 문제에 대한 설명을 볼 수 있습니다.
Convert Assets를 클릭하여 전환 프로세스를 시작합니다.

참고: 전환 프로세스는 프로젝트에 되돌릴 수 없는 변경 사항을 적용합니다. 전환하기 전에 프로젝트를 백업하십시오.

전환 프로세스가 완료되면 창에 각 컨버터의 상태가 표시됩니다.

녹색 체크마크: 전환이 문제없이 진행되었습니다.

노란색 아이콘: 전환이 완료되었지만, 경고가 표시되어 사용자 조치가 필요할 수 있습니다.

빨간색 아이콘: 전환이 실패했습니다.
컨버터를 클릭하면 해당 컨버터에서 처리된 항목 리스트가 표시됩니다.

전환된 프로젝트를 검토한 후 Render Pipeline Converter 창을 닫습니다.

전환 타입 및 컨버터

렌더 파이프라인 컨버터를 사용하면 다음 전환 타입 중 하나를 선택할 수 있습니다.

빌트인 렌더 파이프라인을 URP로 전환
빌트인 렌더 파이프라인 2D에서 URP 2D로 전환
2D URP 에셋 업그레이드

전환 타입 중 하나를 선택하면 툴에 사용 가능한 컨버터가 표시됩니다.

다음 섹션에서는 각 전환 타입에 사용할 수 있는 컨버터에 대해 설명합니다.

빌트인 렌더 파이프라인을 URP로 전환

이 전환 타입은 프로젝트 요소를 빌트인 렌더 파이프라인에서 URP로 전환합니다.

사용 가능 컨버터:

Rendering Settings

이 컨버터는 URP 에셋과 렌더러 에셋을 생성합니다. 그런 다음, 빌트인 렌더 파이프라인 프로젝트의 설정을 평가하여 URP 에셋의 동등한 프로퍼티로 전환합니다.
Material Upgrade

이 컨버터는 머티리얼을 전환합니다. 컨버터는 Unity에서 제공하는 미리 빌드된 머티리얼에서 작동하며, 커스텀 셰이더가 포함된 머티리얼은 지원하지 않습니다.
Animation Clip Converter

이 컨버터는 애니메이션 클립을 전환합니다. Material Upgrade 컨버터가 완료된 후에 실행됩니다.

참고: 이 컨버터는 프로젝트에 머티리얼 프로퍼티 또는 포스트 프로세싱 스택 v2 프로퍼티에 영향을 주는 애니메이션이 포함된 경우에만 사용할 수 있습니다.
Read-only Material Converter

이 컨버터는 Material Upgrade 컨버터가 셰이더를 대체할 수 없는 미리 빌드된 읽기 전용 머티리얼을 전환합니다. 이 컨버터는 프로젝트를 인덱싱하고 임시 .index 파일을 생성하므로 상당한 시간이 소요될 수 있습니다.

읽기 전용 머티리얼의 예: Default-Diffuse, Default-Line, Dafault-Terrain-Diffuse 등
Post-Processing Stack v2 Converter

이 컨버터는 PPv2 볼륨, 프로파일, 레이어를 URP 볼륨, 프로파일, 카메라로 전환합니다. 이 컨버터는 프로젝트를 인덱싱하고 임시 .index 파일을 생성하므로 상당한 시간이 소요될 수 있습니다.

빌트인 렌더 파이프라인 2D에서 URP 2D로 전환

이 전환 타입은 프로젝트 요소를 빌트인 렌더 파이프라인 2D에서 URP 2D로 전환합니다.

사용 가능 컨버터:

Material and Material Reference Upgrade

이 컨버터는 모든 머티리얼 및 머티리얼 레퍼런스를 빌트인 렌더 파이프라인 2D에서 URP 2D로 전환합니다.

2D URP 에셋 업그레이드

이 전환 타입은 2D 프로젝트의 에셋을 예전 URP 버전에서 최신 URP 버전으로 업그레이드합니다.

사용 가능 컨버터:

Parametric to Freeform Light Upgrade

이 컨버터는 모든 파라메트릭 광원을 자유형 광원으로 전환합니다.

API 또는 CLI를 사용하여 전환 실행

렌더 파이프라인 컨버터는 커맨드 라인에서 전환 프로세스를 실행할 수 있는 RunInBatchMode 메서드와 함께 Converters 클래스를 구현합니다.

예를 들어 다음 스크립트는 Material Upgrade 및 Read-only Material Converter 컨버터를 초기화하고 실행합니다.

using System.Collections;
using System.Collections.Generic;
using UnityEditor;
using UnityEditor.Rendering.Universal;
using UnityEngine;

public class MyUpgradeScript : MonoBehaviour
{
    public static void ConvertBuiltinToURPMaterials()
    {
        Converters.RunInBatchMode(
            ConverterContainerId.BuiltInToURP
            , new List<ConverterId> {
                ConverterId.Material,
                ConverterId.ReadonlyMaterial
            }
            , ConverterFilter.Inclusive
        );
        EditorApplication.Exit(0);
    }
}

커맨드 라인에서 예제 전환을 실행하려면 다음 커맨드를 사용하십시오.

"<path to Unity application> -projectPath <project path> -batchmode -executeMethod MyUpgradeScript.ConvertBuiltinToURPMaterials

참고 항목: Unity 에디터 커맨드 라인 인자.