데모 & 런타임 가이드

작은 화면에서는 넓은 표를 좌우로 스크롤하여 모든 열을 확인할 수 있습니다.

데모를 실행하고 구성 요소 확인하기

1. Assets/DPTGames/Vertex_3D_Terrain/Vertex3DTerrain_Demo/VertexTerrain_DemoScene.unity를 엽니다.
2. Terrain Material과 Ground Library를 확인합니다. 해당 Material을 Dynamic Biome Demo Controller에 지정하고 필요한 경우 방향광을 Sun에 할당합니다.
3. Terrain Material Inspector에서 첫 번째 환경을 구성합니다. 데모 컨트롤러의 + Capture Current Settings as NEW Profile을 클릭해 캡처한 뒤 Spring과 같은 이름을 지정합니다.
4. 실제 Material 설정을 변경해 두 번째 환경을 구성합니다. 다시 캡처하고 Summer로 이름을 지정합니다. 같은 방법으로 Autumn, Winter 또는 다른 환경을 추가합니다.
5. 저장한 상태로 돌아가 편집하려면 해당 프로파일의 Apply Profile To Material을 클릭합니다. 그러면 저장된 설정이 실제 Shared Material에 적용됩니다. 수정한 내용을 유지하려면 나중에 Capture Profile From Material을 클릭합니다.
6. 첫 번째 프로파일을 포함한 각 프로파일에서 Transition Seconds, Easing 및 Channels to Animate을 설정합니다. Biome Slot, Lighting 및 선택적 Wind 채널을 지정합니다. 해당 프로파일의 Animate To Profile을 클릭하면 그 상태로 전환한 뒤 유지합니다.
7. 전체 시퀀스를 시험하려면 두 개 이상의 프로파일을 캡처하고 Run Sequence From Start를 클릭합니다. 두 재생 방식 모두 Edit Mode와 Play Mode에서 작동합니다. Pause, Resume, Stop & Restore로 제어할 수 있으며 Edit Mode 스크럽은 전체 시퀀스에 적용됩니다.
8. 원한다면 Play On Start를 활성화해 Play Mode 진입 시 시퀀스를 자동 실행합니다. Demo Camera로 결과를 확인합니다.
9. Surface Raycast Tester를 사용해 Painted Surface에서 반환하는 Biome ID를 확인합니다.

Dynamic Biome Demo Controller

컴포넌트 Inspector 상단의 Open Documentation 버튼이나 헤더의 Help 아이콘을 클릭하면 온라인 데모 및 런타임 가이드를 열 수 있습니다.

GameObject에 DPT → Dynamic Biome Demo Controller를 추가합니다. Terrain Material을 직접 지정하거나, Renderer가 있는 GameObject에 컴포넌트를 배치해 해당 Renderer의 Shared Material을 자동으로 참조하게 합니다. 방향광의 회전, Intensity 및 Colour도 함께 보간하려면 Sun을 지정합니다.

환경 설정은 Material Inspector에서 작성합니다. Dynamic Biome Slot, 대상 ID, Dusting, Scatter Density 및 Colour, Surface Override, Flow 등을 이곳에서 설정합니다. 데모 컨트롤러는 이러한 옵션을 중복 표시하지 않으며 캡처 버튼을 누른 시점에만 Material의 값을 읽어 저장합니다.

동일한 Material을 사용하는 모든 Terrain Object는 같은 변경 사항을 적용받습니다. 여러 인접 Tile을 함께 변경할 때 유용합니다. 개별 Terrain을 독립적으로 제어하려면 별도의 Material을 사용하십시오.

Inspector 구성

프로파일에 저장되는 항목

각 프로파일에는 Modifier Slot 네 개의 활성 상태, Biome ID, Weight, Smoothness, Normal, Parallax, Emission, Flow, Dusting 및 Scatter Response가 독립적으로 캡처됩니다. 지원되는 Stylized Lighting의 값, 지정한 Sun의 회전, Intensity 및 Colour와 함께 Terrain Material의 Wind 활성 상태, Strength, Direction 및 Height To Tip도 저장됩니다.

프로파일은 Material의 실시간 값에 연결되어 있지 않습니다. Winter를 만들기 위해 Material을 수정하더라도 이전에 캡처한 Autumn Snapshot은 변경되지 않습니다. 기존 Snapshot을 수정하려면 해당 프로파일의 캡처 버튼으로 다시 저장해야 합니다.

Apply Profile To Material은 Channels to Animate 선택과 관계없이 캡처된 전체 Snapshot을 Shared Material과 선택적 Sun에 즉시 적용합니다. Edit Mode에서 재생과 미리 보기를 중지한 상태로 사용하면 저장된 모습으로 돌아가 편집하기 편리합니다. Unity Undo를 지원하며 저장된 프로파일 자체는 변경하지 않습니다.

Animate To Profile은 현재 모습에서 출발해 대상 프로파일에서 체크한 채널만 보간하고 결과를 유지합니다. Edit Mode와 Play Mode에서 사용할 수 있으며 다른 프로파일 전환이 진행 중일 때도 요청할 수 있습니다.

Shader 옵션 자체는 Terrain Material 설정을 참고하십시오. Biome의 Scatter Response가 Instanced Vegetation에 미치는 영향은 3D Scatter 가이드에서 설명합니다.

Environment Profiles 및 타임라인

Environment Profile은 계절 변화, 가뭄, 홍수 및 온도 변화 등을 표현하는 데 사용할 수 있습니다. Run Sequence From Start는 첫 번째 프로파일에서 체크한 채널을 초기 모습으로 적용한 뒤 뒤따르는 프로파일로 이동합니다. Animate To Profile을 사용하면 첫 번째 프로파일을 포함한 캡처된 프로파일로 곧바로 전환하도록 요청할 수 있습니다.

첫 번째 프로파일도 다른 프로파일과 동일한 컨트롤을 제공합니다. Transition Seconds, Easing, Slot 1–4, Stylized Lighting, Directional Light 및 Wind를 각각 설정할 수 있습니다. 체크하지 않은 채널은 현재 값을 유지합니다. 최초로 캡처한 첫 번째 프로파일은 모든 채널이 기본 선택되며 이후 캡처에서는 직전의 확정된 상태와 비교해 변경된 채널을 감지합니다. 이미 선택한 체크박스는 그대로 보존됩니다.

프로파일 시퀀스 캡처하기

1. Spring: Material과 필요한 경우 Sun을 설정하고 + Capture Current Settings as NEW Profile을 클릭합니다. 새 프로파일을 Spring으로 바꾸면 타임라인의 시작 상태가 됩니다.
2. Summer: Material과 Light를 여름 모습으로 바꾼 뒤 같은 버튼으로 캡처합니다. Summer로 이름을 지정하고 Transition Seconds에 원하는 전환 시간을 설정합니다.
3. Autumn: Dusting, Scatter 및 Lighting 등을 필요에 따라 조절한 뒤 세 번째 프로파일로 캡처하고 Autumn으로 이름을 지정합니다.
4. Winter: 눈을 표현할 Dusting, 줄어든 식생, 차가운 Lighting을 설정합니다. 네 번째 프로파일로 캡처하고 전환 시간을 설정합니다.
5. 첫 번째 프로파일 이후에는 이전의 확정된 상태와 달라진 Biome, Lighting 및 Wind 채널이 자동으로 체크됩니다. 첫 번째 프로파일을 포함해 각 프로파일의 Channels to Animate을 수동으로 변경할 수도 있습니다. 체크하지 않은 채널은 현재 값을 유지합니다.
6. Preview In Edit Mode와 Preview Normalized로 전체 시퀀스를 확인한 뒤 Stop Preview & Restore Material을 클릭합니다. Loop가 활성화되어 있으면 마지막 상태에서 첫 번째 프로파일에서 체크한 채널로 돌아갑니다. 체크하지 않은 채널은 변경되지 않습니다.

주요 설정과 버튼

특정 프로파일로 전환하고 상태 유지하기

1. 원하는 모습을 캡처합니다. 개별 프로파일 요청은 캡처된 프로파일이 하나만 있어도 가능합니다.
2. 목표 프로파일의 Transition Seconds, Easing 및 체크할 채널을 설정합니다. 첫 번째 프로파일에도 동일한 옵션이 있습니다.
3. Animate To Profile 버튼을 클릭합니다. 완료되면 진행 표시줄에 Holding: 프로파일 이름이 표시됩니다.
4. 다른 모습이 필요해지면 해당 프로파일을 요청합니다. 이전 전환이 진행 중이어도 새로운 요청은 최초 상태로 돌아가지 않고 현재 보간된 모습에서 출발합니다.

목표 상태는 다음 프로파일 요청, Stop & Restore, 시퀀스 재시작 또는 컴포넌트 정리 시점까지 유지됩니다. Loop가 개별 요청을 자동으로 진행시키지는 않습니다. Pause는 완료되지 않은 전환을 멈추고 Resume은 이어서 진행합니다. 이미 Holding 중인 완료 상태에는 재개할 진행 구간이 없습니다.

환경 프로파일의 Wind 설정

Terrain Material Inspector에서 Enable Wind, Wind Strength, Wind Direction 및 Height To Tip을 구성한 뒤 프로파일에 캡처합니다. Wind 설정을 애니메이션하려면 해당 프로파일의 Wind 채널을 체크합니다. 체크하지 않으면 현재 Wind 상태가 그대로 유지됩니다.

Wind를 끌 때는 Strength가 0으로 감소한 뒤 목표 지점에서 Shader 기능이 비활성화됩니다. 켤 때는 0에서 캡처된 Strength까지 증가합니다. Direction 및 Height To Tip도 보간됩니다. Stylized Lighting과 달리 Wind 채널을 선택하면 Wind의 활성 상태도 변경할 수 있습니다.

Wind 데이터가 캡처되지 않은 이전 프로파일은 Wind 체크박스가 선택되어 있어도 현재 Wind를 변경하지 않습니다. Wind 설정을 추가하려면 Stop & Restore를 실행하고 기존 프로파일을 적용한 뒤 Material에서 Wind를 설정하고 다시 캡처하십시오. Scatter Group에도 개별 Enable Wind 선택 및 호환되는 Material이 필요합니다. 전역 Wind를 캡처하더라도 각 그룹의 Wind 선택은 바뀌지 않습니다.

코드 또는 UnityEvent에서 프로파일 요청하기

이름으로 선택하려면 AnimateToProfile(string profileName)을, 목록 위치로 선택하려면 AnimateToProfile(int profileIndex)를 호출합니다. Index는 0부터 시작하므로 controller.AnimateToProfile(0)은 첫 번째 프로파일을 요청합니다. 이름 검색은 대소문자를 구분하지 않으며 같은 이름이 여러 개라면 첫 번째 항목이 선택되므로 고유한 이름을 사용하십시오. 잘못된 요청이나 캡처되지 않은 프로파일에는 경고가 표시되고 진행 중인 전환은 그대로 유지됩니다.

다음 예제를 EnvironmentProfileRequests.cs로 저장해 GameObject에 추가하고 Demo Controller 참조를 지정하십시오. 먼저 Winter 및 Summer 프로파일을 캡처한 뒤 자신의 게임 로직이나 UI에서 해당 메서드를 호출합니다.

using UnityEngine;
using DPT.Vertex3DTerrain.Demo;

public class EnvironmentProfileRequests : MonoBehaviour
{
    [SerializeField] private DPT_DynamicBiomeDemoController controller;

    public void RequestWinter()
    {
        if (controller != null)
            controller.AnimateToProfile("Winter");
    }

    public void RequestSummer()
    {
        if (controller != null)
            controller.AnimateToProfile("Summer");
    }
}

별도의 Wrapper Script 없이 UnityEvent 연결하기

1. 예를 들어 UI Button의 On Click()에 이벤트 항목을 추가합니다.
2. Dynamic Biome Demo Controller가 있는 GameObject를 할당합니다.
3. 문자열 또는 정수를 받는 AnimateToProfile 메서드를 선택합니다.
4. Winter 같은 프로파일 이름 또는 0부터 시작하는 Index를 입력합니다. 이벤트를 호출하면 Inspector 버튼과 동일하게 전환 후 상태를 유지합니다.

재생 상태 확인하기

PlayFromStart()는 전체 시퀀스를 실행합니다. PauseTimeline(), ResumeTimeline() 및 StopAndRestore()는 두 재생 방식에 모두 사용할 수 있습니다. SetTimelineNormalized(float)는 개별 요청 세션이 존재하면 0부터 1까지 그 전환 위치를 변경하며, 그렇지 않으면 전체 시퀀스를 제어합니다. ApplyProfileToMaterial(int)와 CaptureCurrentMaterialIntoProfile(int)는 재생과 미리 보기를 중지한 Edit Mode에서 사용하는 설정 작성용 메서드입니다.

Lighting 및 전환의 제약 사항

• Stylized Lighting은 선택 사항입니다. 미리 보기 또는 재생을 시작할 때 _STYLIZED_LIGHTING이 이미 활성화되어 있어야 해당 값이 애니메이션됩니다. 컨트롤러는 Shader Keyword를 직접 켜거나 끄지 않으며 Sun의 전환은 독립적으로 작동합니다.
• 수치와 색상은 보간됩니다. Weight, Dusting Strength, Scatter Density 및 Colour, Flow Speed, Emission, Shading, Sun 회전 등은 설정한 시간에 따라 변경됩니다.
• ID와 Switch는 단계적으로 변경됩니다. Target Biome ID, Overlay Biome ID 및 Shader 기능 스위치는 연속적으로 보간되지 않습니다. 자연스러운 전환이 필요할 때는 가능한 한 같은 Target Biome ID를 유지하고 Strength, Weight 또는 Density 값을 조절하십시오.
• Terrain Material에서 Dynamic Biomes를 활성화해야 합니다. 마스터 스위치가 꺼져 있다면 프로파일이 전환되어도 Live Modifier 효과가 표시되지 않습니다.
• Preview는 Shared Material을 임시로 변경합니다. Asset을 저장하거나 Material을 편집하기 전에 중지하고 복원하십시오. Editor가 비정상 종료되는 상황에 대비해 원본 Material을 별도로 저장해 두는 것이 좋습니다.

프로파일은 Terrain을 다시 Paint하거나 Geometry 또는 Seam을 수정하지 않으며 물 높이를 실제로 올리거나 강수 현상을 구현하지 않습니다. Live Weight는 이미 Paint한 Biome의 기여도에 적용됩니다. Snow Dusting을 사용하려면 적절한 Biome ID와 기존에 Paint한 Dusting Mask가 필요합니다.

안정적인 Scatter 페이드와 편집 중 표시

Scatter 배치는 Paint된 Biome Coverage에 따라 생성됩니다. Dynamic Weight Multiplier와 Scatter Density는 렌더링 시 기존 Clump의 안정적인 집합을 선택적으로 줄입니다. 진흙, 누렇게 변한 풀 또는 가뭄을 표현하기 위해 Grass Strength를 낮추더라도 전환 단계마다 Scatter를 다시 배치하지 않습니다. Strength를 원래대로 되돌리면 이전의 동일한 배치가 복구되며 Colour 변화도 실시간으로 반영됩니다.

Strength는 Scatter의 Fade 제어 값으로, 상한이 1입니다. Strength가 0이면 해당 Dynamic Scatter가 숨겨지고 0.5이면 대략 절반, 1 이상이면 설정된 Painted Coverage만큼 표시됩니다. 1보다 높은 값은 Terrain Shading에 영향을 줄 수 있지만 Scatter를 더 조밀하게 만들지는 않습니다. 최대 밀도를 높이려면 Scatter Group의 Density를 높이십시오. Strength와 Scatter Density Response는 서로 곱해지며 겹치는 Slot의 Weight Multiplier는 상한을 적용하기 전에 합쳐집니다.

수정이나 계절 변화에 반응해서는 안 되는 Crystal 등의 그룹은 Wind 옆에 있는 Static Scatter를 활성화합니다. Static Group은 Dynamic Biome Weight, Scatter Density 및 Colour/Surface Override를 무시합니다. 하지만 Paint나 Sculpt 작업으로 배치가 갱신되며 공통 Instance 제한은 그대로 적용됩니다.

Scatter Settings의 Disable While Brushing을 사용하면 Surface 또는 Geometry Tool이 하나라도 선택된 동안 Stroke 사이를 포함해 Scatter를 숨기고 배치 갱신을 일시 중지합니다. 두 도구 선택이 모두 None이 되거나 Terrain Tool 창을 닫으면 다시 표시됩니다. 이 옵션은 Edit Mode에만 적용됩니다. Update After Stroke는 숨기기가 꺼져 있을 때 Stroke 중에도 배치를 표시하고 손을 뗀 후 영향받은 Source를 갱신하는 별도의 옵션입니다.

Surface Raycast Tester

Raycast는 Unity에 “이 선을 따라 어떤 Collider가 있는가?”라고 묻습니다. Tester는 해당 Hit를 표시한 다음 Terrain의 Surface Target에 Biome을 요청합니다. 두 단계는 별개입니다. Collider에 Hit했다고 해서 Terrain Surface Data가 있다는 뜻은 아닙니다.

자신의 Terrain에 Probe 설정하기

1. 작은 Painted Test Terrain을 완성하고 Mesh를 저장합니다.
2. Bake하려는 Mesh와 Triangle Layout이 일치하는 MeshCollider를 지정합니다.
3. Terrain Tool에서 Bake Surface Data를 사용합니다.
4. 적절한 Terrain Object에 DPT → Terrain Surface Target이 있고 Bake된 Surface Data Asset이 지정되어 있는지 확인합니다. Renderer가 필요합니다.
5. Terrain 위에 별도 Empty Object를 만들고 DPT → Surface Raycast Tester를 추가합니다.
6. Downward Probe, 충분한 Max Ray Distance 및 Terrain Collider가 포함된 Layer Mask를 선택합니다.
7. Scene Gizmos 또는 Game HUD를 활성화하고 Hit Object, Triangle Index, Biome ID 및 Name을 확인합니다. Probe를 서로 확실히 다른 두 Painted Area 사이로 이동합니다.

결과 읽기

Hit Object는 Ray를 가로챈 Collider입니다. Triangle Index는 Lookup에 사용된 Triangle을 식별합니다. Biome ID and Name은 Surface Query Result입니다. Hit Point, Normal and Distance는 물리적인 Intersection을 설명합니다.

Collider가 Hit했지만 Biome을 알 수 없다면 Surface Target과 Data를 확인합니다. Triangle 기반 Lookup에서 Box 또는 Sphere Collider는 일치하는 Terrain MeshCollider를 대체할 수 없습니다. Negative 또는 다른 유효하지 않은 Triangle Index를 정상적인 Terrain Query로 취급하지 마십시오.

Terrain Demo Camera

검사용 Camera에 DPT → Terrain Demo Camera를 추가합니다. Free Movement와 Mouse Look을 제공합니다. Walking Physics, Collision Avoidance, Grounded Movement 또는 Planet Gravity는 제공하지 않습니다.

Movement Speed는 일반 이동 속도, Fast Multiplier는 Shift Boost, Mouse Sensitivity는 Look Response를 설정합니다. 선택적인 Controls Overlay는 처음 익힐 때 유용합니다. 작은 Feature를 살펴볼 때는 낮은 Speed를, 큰 Terrain을 가로지를 때는 높은 Speed를 사용합니다.

이 Camera는 검사 Rig이므로 Terrain을 통과할 수 있습니다. Bridge, Cave 또는 Staircase를 실제로 통과할 수 있는지 시험할 때는 자신의 Gameplay Controller로 교체하십시오.

Gameplay에서 Surface Data 사용하기

의도된 흐름은 Terrain 페인트 → Surface Data Bake → Data를 Terrain에 연결 → 일치하는 Collider에 Raycast → Biome ID 읽기 → Gameplay Response 선택입니다.

Baked Asset은 Live Reweighting에 사용되는 Candidate ID와 Weight를 포함해 Triangle마다 대표적인 Biome 정보를 기록합니다. Surface Target은 해당 정보와 Terrain Material의 현재 Modifier를 읽습니다. Hit 하나에 대해 하나의 Biome ID를 반환하며 전체 Texture나 보이는 모든 Surface 목록을 반환하는 것은 아닙니다.

간단한 Integration Example

다음 코드를 TerrainSurfaceProbe.cs로 저장하고 Test Terrain 위의 Object에 추가합니다. Terrain Layer Mask와 Distance를 설정합니다. Component Context Menu의 Read Surface를 사용해 Query를 한 번 실행합니다. Console Message는 예시일 뿐입니다. Gameplay에 연결할 때는 자신의 Sound, Particle 또는 Movement Lookup으로 교체하십시오.

using UnityEngine;
using DPT.Vertex3DTerrain;

public class TerrainSurfaceProbe : MonoBehaviour
{
    public LayerMask terrainLayers = ~0;
    public float distance = 2f;

    [ContextMenu("Read Surface")]
    public void ReadSurface()
    {
        if (!Physics.Raycast(transform.position, Vector3.down,
                out RaycastHit hit, distance, terrainLayers))
        {
            Debug.Log("No collider within the probe distance.");
            return;
        }

        if (hit.triangleIndex < 0)
        {
            Debug.Log("This collider has no usable terrain triangle index.");
            return;
        }

        if (DPT_TerrainSurfaceTarget.TryGetHitBiome(
                hit, out int biomeID, out string biomeName))
        {
            Debug.Log($"Surface: {biomeName} (ID {biomeID})");
            // Choose your project's response using biomeID.
        }
        else
        {
            Debug.Log("The hit has no linked terrain surface data.");
        }
    }
}

Footstep에서는 Footstep이 발생하는 시점에 적절한 Foot 또는 Character Position에서 Query를 호출합니다. 반환된 ID를 자신의 Audio/Effect Table에 연결합니다. Library 변경에 맞춰 해당 Table도 갱신하십시오. Biome Name은 Label로 유용하지만 Query가 반환하는 Numeric Value는 Library ID입니다.

Planet 또는 Custom Gravity System에서는 Example의 World-down Direction을 게임의 Local Gravity Direction으로 바꿉니다. 이 Script에서 Tool이 해당 방향을 자동으로 추론하지는 않습니다.

언제 다시 Bake해야 하나요?

• Gameplay에서 Query할 영역을 다시 페인트한 뒤.
• Biome 추가, 삭제 또는 재정렬로 Data에서 사용하는 ID가 변경된 뒤.
• Subdivision, Deletion, Tunnel Creation, Simplification 또는 Triangle을 변경하는 다른 작업 뒤.
• Bake 또는 대표 Surface 정보에 영향을 주는 다른 Geometry 변경 뒤.
• Simplified LOD Collider를 포함해 다른 Collider Mesh로 전환할 때.

지원되는 일반 Live Material Multiplier는 Target이 Query 시점에 읽기 때문에 Terrain을 다시 페인트하거나 Triangle Data를 다시 만들지 않고 평가할 수 있습니다. 하지만 여전히 Bake된 Candidate를 사용하므로 오래된 Bake에서 새로 페인트된 정보를 복구할 수는 없습니다.

Query 결과는 화면과 얼마나 일치하나요?

제공되는 Query는 대표적인 Terrain Surface를 선택하는 데 유용하지만 Shader가 Render하는 결과를 Pixel-perfect하게 Sample하는 기능은 아닙니다. 모든 Edge 또는 Snow Patch가 Cursor 아래의 화면과 정확히 같은 결과를 반환한다고 가정하지 말고 자신의 Gameplay 요구사항에 맞춰 시험하십시오.

Gameplay에 정확한 Small Patch, Local-gravity-aware Snow 또는 Precise Per-pixel Coverage가 필요하다면 해당 규칙에 맞는 Query를 별도로 만들고 검증하십시오. 제공되는 Component는 위의 제한을 가진 출발점입니다.

Runtime 및 Demo 문제

지원

도움이 필요하다면 예상한 결과, 사용한 Control 및 실제로 나타난 결과를 설명하십시오. Unity 버전, 선택한 Surface Pipeline 및 관련 설정의 스크린샷을 함께 제공하면 좋습니다. Runtime Query 문제라면 Collider Type과 마지막으로 Surface Data를 Bake한 시점도 포함하십시오.

DPT Games 문의 양식을 사용하거나 DPT Games Discord에 참여할 수 있습니다.

맨 위로