> For the complete documentation index, see [llms.txt](https://help.movin3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.movin3d.com/kr/movin-studio-usage-guide/project-toolbar-and-puppet-mode.md).

# Project, Toolbar and Puppet Mode

## 프로젝트 (Project)

<figure><img src="/files/OfTjWEshaNGC8rYU1bwS" alt=""><figcaption></figcaption></figure>

프로젝트 (Project) 는 상단 패널 중앙에 표기되며, 모든 클립, 액터, 캐릭터 리타게팅 값들이 하나의 프로젝트에서 관리됩니다. 해당 데이터가 섞이지 않기를 원한다면, 새로운 프로젝트를 생성해 클립, 액터 및 캐릭터 리타게팅 값들이 서로 겹치지 않도록 관리해보세요.

프로젝트는 하나의 폴더를 기반으로 동작합니다. 만약 다른 컴퓨터에서 기존에 작업하던 값을 그대로 이어서 진행하고 싶다면, 해당 컴퓨터로 프로젝트 폴더를 복사한 뒤 해당 폴더를 프로젝트로 열어주세요.

### 새 프로젝트 생성하기 (Create New Project)

* 프로젝트는 폴더 기반으로 작동하므로, 새 프로젝트를 만들려면 새 폴더가 필요합니다.
* 상단 패널 중앙의 드롭다운을 클릭한 뒤, 'Open new or existing project'를 클릭해주세요.
* 원하는 위치에 폴더를 생성한 뒤, 해당 폴더를 선택해 프로젝트로 지정해주세요.

### 프로젝트 열기 (Open Project)

* 상단 패널 중앙의 드롭다운을 클릭해 원하는 프로젝트를 선택해주세요.
* 만약 프로젝트가 목록에 보이지 않을 경우, 'Open new or existing project'를 클릭한 뒤, 데이터가 들어있는 프로젝트 폴더를 선택해 열어주세요.

### 프로젝트 디렉토리 열람하기 (Open Project Directory)

* 프로젝트 폴더를 확인하려면 상단 패널 중앙의 '폴더' 아이콘을 클릭해주세요.

## 툴바 (Toolbar)

<figure><img src="/files/fnNlsP8tHkdy8okcrLLX" alt=""><figcaption></figcaption></figure>

툴바 (Toolbar) 는 중앙 패널 상단에 위치하며, 환경을 세팅하거나 모션 데이터를 확인하는 등 모션캡처를 진행하며 가장 많이 사용할 법한 기능들을 모아뒀습니다.

### 퍼펫 모드 (Puppet Mode)

<figure><img src="/files/oyCjilYuvxOI3N5wtTWD" alt=""><figcaption></figcaption></figure>

* 퍼펫 모드는 툴바의 첫 번째에 위치해 있으며, 모션캡처 공간에 가상의 퍼펫을 세워 특정 동작을 수행하도록 설정할 수 있습니다.&#x20;
  * 퍼펫 모드를 통해 혼자서 모션캡처를 진행하더라도 편하게 환경을 설정할 수 있습니다.
  * 퍼펫 모드를 킨 상태에서 [Hands Motion Capture (Beta)](/kr/movin-studio-usage-guide/hands-setting/hands-motion-capture-beta.md)나 [Integrate with 3rd Party Gloves](/kr/movin-studio-usage-guide/hands-setting/integrate-with-3rd-party-gloves.md)를 진행하는 경우, 클립에 포함된 손 모션이 아닌 핸즈 트래킹 기반 손 움직임이 퍼펫에게 표시되니 참고해주세요.
* 퍼펫이 취할 수 있는 동작은 현재 7가지가 존재합니다.
  * Idle (A-pose, walk): A-pose와 제자리 걷기 등의 동작을 취합니다.
  * Idle (Arm & Head): 팔 돌리기, 목 돌리기 등 팔과 머리를 중점적으로 움직이는 동작입니다.
  * Idle (Standing): 제자리에서 서 있는 동작을 취합니다.
  * Jumps: 제자리 뛰기, 옆으로 뛰기, 돌면서 뛰기 등 뛰는 것을 중점적으로 진행합니다.
  * Running: 모션캡처 구역을 이곳저곳 뛰어다니는 동작입니다.
  * Sitting: 앉아 있는 동작입니다.
  * Subtle: 몸통 앞에서 손 움직이기, 앉아서 손 움직이기 등 작고 사소한 동작들을 취합니다.
* 퍼펫 모드에서는 지정된 클립 외에도 직접 촬영한 클립을 재생할 수 있습니다.
  * 필요한 동작을 촬영한 뒤 이를 편하게 재생해보세요.

### 발 접지 (Foot Contact)

<figure><img src="/files/fKdBupdqYlep6PTdQmBV" alt=""><figcaption></figcaption></figure>

* 발 접지 버튼은 툴바의 두 번째에 위치해 있으며, 해당 버튼을 클릭하면 발바닥이 땅에 접지되었을 때 발바닥 주위를 표시해줍니다.
  * 해당 기능을 사용해, 모션캡처 데이터의 발 부분이 땅에 붙어 있는지를 명확하게 확인할 수 있습니다.

### 스켈레톤 시각화 (Skeleton Visualization)

<figure><img src="/files/fVDwxKYNve7BgOSGUTPp" alt=""><figcaption></figcaption></figure>

* 스켈레톤 시각화 버튼은 툴바의 세 번째에 위치해 있으며, 해당 버튼을 클릭하면 스켈레톤의 관절 및 뼈대 구조를 확인할 수 있습니다.
  * 모션캡처 데이터의 품질을 검수하거나 리타게팅을 진행할 때, 뼈대의 위치와 움직임을 직관적으로 확인하는 용도로 사용하세요.

### 거울 모드 (Mirror Mode)

<figure><img src="/files/pm38ZI68M7yMP5HyWRtT" alt=""><figcaption></figcaption></figure>

* 거울 모드 버튼은 툴바의 네 번째에 위치해 있으며, 해당 버튼을 클릭하면 모션캡처 데이터의 좌우가 반전됩니다.
  * 모션캡처 구역 앞에 스크린을 두고 촬영하며 모션 데이터를 확인하는 경우 활용해주세요.

### 제자리 모드 (Inplace Mode)

<figure><img src="/files/R8vPpcJRV1Af4mmsfnjw" alt=""><figcaption></figcaption></figure>

* 제자리 모드 버튼은 툴바의 다섯 번째에 위치해 있으며, 해당 버튼을 클릭하면 모션캡처 구역 중앙에 캐릭터가 고정되어 움직입니다.
  * 액터가 정면을 향하고 있지 않을 때의 모션 데이터를 확인하고 싶은 경우 활용해주세요.

### 라이브 스트리밍 (Live-streaming)

<figure><img src="/files/4ktOMitm3KkEV3wJJZZw" alt=""><figcaption></figcaption></figure>

라이브 스트리밍 버튼은 툴바의 여섯 번째에 위치해 있으며, 우측 패널 세 번째의 'Streaming' 탭과 동일한 내용이 표기됩니다.

* 보다 빠르게 라이브 스트리밍을 끄고 켜고 싶을 때 활용해주세요.
* 라이브 스트리밍과 관련된 자세한 설명은 [Live-streaming](/kr/movin-studio-usage-guide/live-streaming.md)을 참고해주세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.movin3d.com/kr/movin-studio-usage-guide/project-toolbar-and-puppet-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
