Painting 데이터와 채널

PaintData 자산화, 채널 단위 페인팅, 저장/복제 동작에 관한 안내입니다.

PaintData 자산

페인팅 결과는 씬 안에만 머무르지 않고 프로젝트 폴더에 영구 자산 으로 저장됩니다. 저장 위치는 두 트리로 나뉘어 있으며 Editor 전용 자산 과 Runtime 빌드 포함 자산 이 분리됩니다.

{SaveDataFolder}/PaintData/{Material 이름}/{Channel 이름}/
    └─ <channel 이름>.asset

PaintData 는 에디터 전용 ScriptableObject 로, 빌드에는 포함되지 않습니다.

SaveDataFolder 기본값: Assets/UModelerXData/Editor

{PaintRuntimeFolder}/{Material 이름}/{Channel 이름}/
    ├─ <material 이름>.mat         (Runtime 머티리얼)
    └─ <channel 이름>.png          (Runtime 텍스쳐)

머티리얼과 텍스쳐는 런타임에 사용되는 자산이므로 별도의 Runtime 트리에 저장됩니다.

PaintRuntimeFolder 기본값: Assets/UModelerXData/Runtime/PaintData

오브젝트의 머티리얼 슬롯에 머티리얼이 들어가는 시점에 PaintData / 채널 / 레이어 자산이 자동으로 생성 되어 슬롯에 연결되고, 곧바로 페인팅을 시작할 수 있습니다.

다만 슬롯에 이미 들어 있는 머티리얼·텍스쳐의 종류에 따라 새 자산이 생성될지, 기존 자산을 그대로 사용할지가 달라집니다. 사용자가 의도치 않게 원본 에셋이 덮어써지는 일을 막기 위한 규칙입니다.

슬롯의 머티리얼	동작
없음 (`None`)	자동 셋업이 실행되지 않습니다. 머티리얼을 먼저 할당해야 페인팅을 시작할 수 있습니다
수정 가능한 `.mat` (프로젝트 `Assets/` 하위의 일반 머티리얼)	원본을 그대로 공유합니다. 같은 머티리얼을 사용하는 다른 오브젝트와 페인팅 결과가 함께 동기화됩니다
읽기 전용 머티리얼 (built-in, `Packages/`, UModelerX 패키지 내부 등)	PaintData 폴더에 `.mat` 클론 이 만들어지고 오브젝트의 슬롯도 클론으로 교체됩니다. 원본은 보존됩니다

슬롯의 텍스쳐	동작
없음 (빈 슬롯)	채널의 기본 배경색으로 채워진 새 PNG 가 만들어집니다
수정 가능한 `Texture2D` 자산 (`Assets/` 하위, 메인 자산)	그 텍스쳐를 그대로 채택해 페인팅 결과가 원본 PNG 에 직접 기록 됩니다. 같은 텍스쳐를 공유하는 모든 오브젝트가 함께 동기화됩니다
읽기 전용 / sub-asset / 다른 타입 (built-in, FBX 내부 텍스쳐, RenderTexture 등)	원본 픽셀을 초기값으로 복사한 새 PNG 가 만들어집니다. Apply 전부터 원본과 동일하게 보이며, 페인팅으로 원본이 덮어써지지 않습니다

각 채널(Albedo / Normal / Metallic / Roughness / Mask 등)은 별도의 채널 항목으로 관리되며, 같은 PNG 를 가리키는 채널들은 PaintData 인스턴스를 자동으로 공유합니다 (중복 저장 방지).

Painting 3D 인스펙터의 Channels 패널에서 현재 머티리얼이 가진 채널 목록을 확인하고, 해상도 조정 / 채널 선택을 할 수 있습니다. 자세한 내용은 Channels 그룹 페이지를 참조하세요.

브러시·도형·그라디언트 등 모든 페인팅 명령은 활성 채널 전체를 순회하며 한 번에 적용됩니다. 여러 채널에 동시에 같은 형태를 그릴 수 있어 PBR 머티리얼 작업이 빨라집니다.

씬을 저장하면 해당 씬 안의 UModelerX 컴포넌트들의 PaintData 도 함께 디스크에 반영됩니다. 저장 직후에도 RT 가 즉시 복원되어 작업을 이어갈 수 있습니다.

페인팅된 오브젝트를 복제하면 PaintData / 머티리얼(.mat) / 텍스쳐(.png) 자산도 함께 복제되어 원본과 분리됩니다. 한쪽을 수정해도 다른 쪽 페인팅에 영향을 주지 않습니다.

Prefab Stage 안에서 페인팅한 뒤 스테이지를 벗어날 때, 진행 중이던 PaintData 가 프리팹과 함께 정리되도록 후처리가 동작합니다. (프리팹 저장 자체는 Unity 기본 저장 흐름을 따릅니다.)

브러시의 현재 색은 채널별(Albedo / Metallic / Roughness …)로 자동 저장되어, 윈도우를 닫았다 다시 열어도 마지막 색이 그대로 유지됩니다.