> 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/movin-tracin-stage-kr/setup/live-settings.md).

# Stage 2 · Settings

Settings에 들어가면 파이프라인(센서 데이터를 받아 처리하는 시스템)이 프리뷰 모드로 시작됩니다. 실시간 데이터는 보이지만 아직 송출은 하지 않습니다. 워밍업에 5\~15초 정도 걸리며, 그동안 화면이 비어 보일 수 있습니다.

첫 설정은 **Set capture zones → Post processing의 배경 학습 → OSC output** 순서로 진행해주세요. 그 외 조정은 [첫 데이터 수신 확인](/movin-tracin-stage-kr/setup/receive-output.md)을 마친 뒤에 합니다.

## Set capture zones

<figure><img src="https://518203207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWohoYugNjJnOZ3hgyK81%2Fuploads%2Fgit-blob-bdf0b88549740f5858e70e8864e038565679e595%2Flive-01-zones.png?alt=media" alt="실시간 점군 위의 캡처 영역"><figcaption><p>바깥 cyan이 점군 영역, 안쪽 amber가 모션 캡처 영역입니다.</p></figcaption></figure>

* **Point cloud capture zone**(cyan, 바깥) — **Source**가 **zone**일 때 전송되는 범위입니다. 각 축의 min/max를 입력하거나 뷰포트에서 박스를 드래그해주세요.
* **Motion capture zone**(amber, 안쪽) — **human** 소스와 모션 트래킹에 쓰는 범위입니다. cyan 영역 안에 있어야 합니다.
* **Zone presets** — 현재 영역을 이름을 붙여 저장하고 다음 공연에서 불러올 수 있습니다.

{% hint style="info" %}
두 영역의 크기가 같으면 박스가 하나로 보입니다. 이때 나타나는 **Pad capture zone** 버튼을 누르면 두 영역이 분리되어 각각 편집할 수 있습니다.
{% endhint %}

### 캡처 영역 확인

단위는 미터입니다. 뷰포트의 축 표시와 Top, Front, Side 뷰를 보면서 조정해주세요. 화면의 좌우가 무대의 좌우와 같다고 가정하지 말고 축 표시로 확인합니다. Amber 영역이 공연자의 키 전체와 이동 범위를 덮고 cyan 영역 안에 들어가면 됩니다. 변경 내용은 자동 저장됩니다.

배경 학습을 마친 뒤 한 사람이 영역의 중앙과 가장자리를 걸어보게 해주세요. 점군이 영역 안에 남아 있고 **People**이 진입에 반응하면 정상입니다. 가장자리에서 사라지면 라이브 전에 영역 경계와 센서 시야를 먼저 확인합니다.

## Post processing

<figure><img src="https://518203207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWohoYugNjJnOZ3hgyK81%2Fuploads%2Fgit-blob-928a043d1feebd223b223de08a9b6bf52672c8fd%2Flive-02-postproc.png?alt=media" alt="방향·배경 제거·점군·모션 후처리 설정"><figcaption><p>World orientation, 배경 제거, voxelization, motion smoothing.</p></figcaption></figure>

먼저 아래 **배경 학습**을 진행해주세요. GO LIVE 전에 반드시 필요합니다. 무대 방향을 바꿔야 하면 **World orientation**을 먼저 적용하고, 그 방향에서 배경을 학습합니다.

### 배경 학습

빈 무대를 점군으로 학습해 배경을 제거합니다. **human** 소스와 모션 캡처에만 적용되고, **all**과 **zone**에는 영향이 없습니다.

1. 무대를 비워주세요. 배경으로 취급할 고정 세트는 그대로 둡니다.
2. **Remove background**를 켭니다.
3. 확인창을 진행합니다. 첫 설정에서는 버튼이 **Learn now** 하나입니다. 이전에 저장한 배경이 있으면 **Use the saved one**과 **Learn a new one**이 나타나므로, 무대가 그대로면 앞쪽을, 바뀌었으면 뒤쪽을 선택합니다.

학습은 약 10초 걸리고, 진행 상황이 이 섹션에 표시됩니다.

{% hint style="warning" %}
학습 중에는 아무도 무대에 들어가지 않게 해주세요. 그때 서 있던 사람은 배경으로 학습되어, 나중에 같은 자리에 선 사람의 점군이 잘려 나갑니다.
{% endhint %}

세트가 바뀌면 다시 학습해주세요. 학습 뒤에 추가한 물체는 점군에 남고, 치운 물체 자리에 선 사람은 점군이 일부 잘립니다.

{% hint style="info" %}
섹션 제목 옆의 **Learn now** 또는 **Re-learn** 버튼은 배경에 조치가 필요할 때만 나타납니다. 정상으로 표시된 배경을 새로 학습하려면 **Remove background**를 껐다 켜고 **Learn a new one**을 선택합니다.
{% endhint %}

## OSC output

<figure><img src="https://518203207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWohoYugNjJnOZ3hgyK81%2Fuploads%2Fgit-blob-d089927ef9f399eacd024f63a507fbffd22f378d%2Flive-03-osc.png?alt=media" alt="OSC 목적지·소스·모션 캡처 설정"><figcaption><p>송출 대상과 데이터 소스. 라이브 전에 설정합니다.</p></figcaption></figure>

1. **Target IP**와 **Target port**를 입력하고 **Apply**를 선택합니다. IP는 수신 컴퓨터의 공연 네트워크 주소입니다. **Test connection**은 수신 컴퓨터에 ping과 `/movin/test` 메시지를 보냅니다.
2. 점군 **Source**를 선택합니다.
   * **all** — 전체 점군.
   * **zone** — cyan 영역 안의 점군.
   * **human** — amber 영역 안에서 배경을 제거한 점군.
3. **Mocap · on start**에서 \*\*Max tracked people (slots)\*\*를 정합니다. 그 아래 읽기 전용 \*\*Slot limit (this host)\*\*가 이 서버의 상한입니다. 변경은 다음 시작이나 **Restart** 때 적용되고, Restart 중에는 처리와 송출이 잠시 멈춥니다.

스켈레톤은 점군 Source와 별개의 출력입니다. Source를 무엇으로 두어도 함께 전송됩니다.

**Mocap backend** 메뉴가 보이면 MOVIN 지원 팀의 요청이 없는 한 그대로 두세요. 변경은 다음 시작이나 Restart 때 적용됩니다.

{% hint style="info" %}
소품은 개별로 추적하지 않습니다. 점군에는 나타나고, 형태와 관측 조건에 따라 추적 후보로 잡힐 수 있습니다. 멀리 있거나 많이 가려진 사람은 놓칠 수 있으니 실제 세트와 동선으로 확인하고, 필요하면 MOVIN 지원 팀에 문의해주세요.
{% endhint %}

**인원수나 backend를 바꿨다면** 프리뷰 상태에서 상단 **Restart**를 선택하고 확인합니다. 프리뷰가 돌아오면 **People**과 배경 학습 상태를 확인한 뒤 수신 테스트로 넘어갑니다.

## 선택적인 품질 조정

기본 설정이 정상 동작한 뒤에 필요한 항목만 조정해주세요. 따로 표시가 없으면 즉시 적용됩니다.

| 항목                           | 조작과 영향                                                                                                         |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **World orientation**        | **Yaw** 0·90·180·270도 또는 **Mirror X**를 선택하고 **Apply**. 캡처 영역도 함께 돌아갑니다. 배경은 돌아가지 않으므로 다시 학습해야 합니다.             |
| **Point cloud voxelization** | **Voxelize**를 켜고 **Voxel size**를 정합니다. 가까운 점을 합쳐 전송량을 줄입니다. 뷰포트에서는 **Zone**·**Human** 표시에서만 보입니다.              |
| **Motion smoothing**         | **Strength**(0\~100%)로 조정합니다. 값이 클수록 스켈레톤이 안정되지만 반응은 늦어집니다. 뷰포트에는 반영되지 않으므로 수신 프로그램에서 느린 동작과 빠른 동작을 모두 확인해주세요. |

다음은 [첫 데이터 수신 확인](/movin-tracin-stage-kr/setup/receive-output.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, and the optional `goal` query parameter:

```
GET https://help.movin3d.com/movin-tracin-stage-kr/setup/live-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.