Skip to content

NK-Studio/Vertex-Flow

Repository files navigation

🎨 Vertex Flow 사용 설명서

Vertex Flow는 유니티 에디터 환경에서 빠르고 직관적으로 버텍스 컬러(Vertex Color)를 칠할 수 있게 해주는 강력한 도구입니다. 원본 메시(Mesh) 데이터를 안전하게 보호하면서도 부드러운 페인팅 워크플로우를 제공합니다.

자, 이제 차근차근 사용법을 알아볼까요?


📦 설치 방법 (Git UPM)

유니티 패키지 매니저(Package Manager)를 통해 쉽게 설치할 수 있습니다.

  1. 유니티 에디터에서 Window > Package Manager를 엽니다.
  2. 좌측 상단의 + 버튼을 누르고 "Add package from git URL..." 을 선택합니다.
  3. 아래의 URL을 입력하고 Add 버튼을 누릅니다.
    https://github.com/NK-Studio/Vertex-Flow.git
    

1. 툴 열기 및 기본 설정

가장 먼저 Vertex Flow 창을 열어야 합니다. 유니티 에디터 상단 메뉴에서 [Tools] > [Vertex Flow] 를 클릭해 주세요.

창이 열리면 가장 먼저 우측 상단에서 언어를 설정할 수 있습니다. (한국어, English, 日本語 지원) 원하는 언어를 선택하면 즉시 UI에 반영됩니다.

메인 창 및 언어 설정


2. 페인팅 준비: 메시 복제하기

Vertex Flow의 가장 큰 장점은 원본 모델(FBX, OBJ 등)을 훼손하지 않는다는 점입니다. 이를 위해 페인팅을 시작하기 전, 메시를 유니티 에셋(.asset)으로 복제하는 과정을 거칩니다.

  1. 하이어라키(Hierarchy) 창에서 MeshFilter 컴포넌트가 있는 오브젝트를 선택합니다.
  2. 아직 복제되지 않은 원본 메시라면, 툴 창에 노란색 경고 박스와 함께 [페인팅을 위해 메시 복제 및 저장] 버튼이 나타납니다.
  3. 해당 버튼을 누르고 프로젝트 폴더 내 원하는 위치에 메시 에셋을 저장해 주세요.

메시 복제 및 저장 과정

저장이 완료되면, 오브젝트에 자동으로 Vertex Painted Mesh 컴포넌트가 부착되며 본격적인 페인팅 툴이 화면에 나타납니다.


3. 버텍스 페인팅 시작하기!

메시 준비가 끝났다면 이제 색을 칠할 차례입니다.

페인팅 툴 및 브러시 설정

🟢 페인팅 활성화

가장 상단의 [페인팅 활성화] 토글을 켜주세요. 활성화되면 토글 배경이 푸른색으로 빛나며 씬(Scene) 뷰에서 마우스를 올렸을 때 브러시 모양이 나타납니다.

🖌️ 브러시 모드

  • Paint (페인트): 선택한 색상을 버텍스에 칠합니다.
  • Erase (지우기): 칠해진 색상을 지우고 원래 상태(흰색)로 되돌립니다.
  • Smooth (스무스): 주변 버텍스 컬러들의 평균값을 계산하여 색상 경계를 부드럽게 섞어줍니다.

🎨 브러시 설정

인스펙터 컴포넌트 확인

  • Color Palette & RGB: 직관적인 팔레트에서 색상을 고르거나 슬라이더를 통해 미세한 색상을 조정할 수 있습니다.
  • 크기 (Size) 및 강도 (Strength): 브러시의 반경과 칠해지는 세기를 조절합니다.
    • 단축키 꿀팁: 씬 뷰에서 [ 키와 ] 키를 누르면 마우스를 움직이면서 즉시 브러시 크기를 조절할 수 있습니다!

↩️ 실행 취소 / 다시 실행 (Undo / Redo)

페인팅 중 실수를 하셨나요? 걱정 마세요. 자체적인 50단계의 Undo/Redo 스택을 지원합니다. 창에 있는 버튼을 누르거나, 씬 뷰에서 Ctrl + Z (Mac은 Cmd + Z) / Ctrl + Y 키를 눌러 손쉽게 되돌릴 수 있습니다.

🛠️ 유틸리티

버텍스 전체를 한 번에 흰색, 검은색, 또는 현재 선택된 색상으로 덮어씌울 수 있으며, 언제든 원본 상태로 싹 초기화할 수도 있습니다.


4. 인스펙터 컴포넌트 관리 및 안전장치

인스펙터 컴포넌트 확인

메시를 복제하면 오브젝트의 인스펙터에 Vertex Painted Mesh 라는 커스텀 컴포넌트가 추가됩니다.

이 컴포넌트는 여러분이 실수로 원본 메시나 페인팅된 메시를 건드리지 않도록 참조 필드를 읽기 전용(Readonly) 으로 잠가두어 프로젝트를 안전하게 보호합니다.

⚠️ 만약 참조가 끊긴다면? 프로젝트를 정리하다가 실수로 페인팅된 에셋 파일을 삭제하거나 경로를 옮겨서 메시 참조가 유실(null)될 수 있습니다. 이 경우, 인스펙터에 즉시 붉은색 에러 메시지가 나타나며, 잠겨있던 필드가 다시 활성화됩니다. 이때 당황하지 마시고 원본 메시와 올바른 페인팅 메시 에셋을 다시 슬롯에 드래그 앤 드롭해주시면 복구가 완료됩니다!


💡 요약: 빠른 페인팅 순서

  1. MeshFilter가 있는 오브젝트 선택
  2. 메시 복제 및 저장
  3. [페인팅 활성화] 체크
  4. 씬 뷰에서 마우스 좌클릭 + 드래그로 칠하기!

이제 Vertex Flow와 함께 자유롭게 오브젝트에 생동감을 불어넣어 보세요!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages