For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stage 2 · Settings

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

첫 설정은 Set capture zones → Post processing의 배경 학습 → OSC output 순서로 진행해주세요. 그 외 조정은 첫 송출을 확인한 뒤에 합니다.

Set capture zones

실시간 점군 위의 캡처 영역
바깥 cyan이 점군 영역, 안쪽 amber가 모션 캡처 영역입니다.
  • Point cloud capture zone(cyan, 바깥) — Source가 zone일 때 전송되는 범위입니다. 각 축의 min/max를 입력하거나 뷰포트에서 박스를 드래그해주세요.

  • Motion capture zone(amber, 안쪽) — human 소스와 모션 트래킹에 쓰는 범위입니다. cyan 영역 안에 있어야 합니다.

  • Zone presets — 현재 영역을 이름을 붙여 저장하고 다음 공연에서 불러올 수 있습니다.

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

캡처 영역 확인

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

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

Post processing

방향·배경 제거·점군·모션 후처리 설정
World orientation, 배경 제거, voxelization, motion smoothing.

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

배경 학습

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

  1. 무대를 비워주세요. 배경으로 취급할 고정 세트는 그대로 둡니다.

  2. Remove background를 켭니다.

  3. 확인창을 진행합니다. 첫 설정에서는 버튼이 Learn now 하나입니다. 이전에 저장한 배경이 있으면 Use the saved one과 Learn a new one이 나타나므로, 무대가 그대로면 앞쪽을, 바뀌었으면 뒤쪽을 선택합니다.

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

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

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

OSC output

OSC 목적지·소스·모션 캡처 설정
송출 대상과 데이터 소스. 라이브 전에 설정합니다.

수신 컴퓨터는 서버의 OSC 포트에 랜선으로 연결합니다. 공연 네트워크 스위치를 거쳐도 됩니다. LIDAR 포트는 센서 전용입니다.

  1. 수신 프로그램에서 OSC UDP 입력을 만듭니다. 그 컴퓨터의 유선 IPv4 주소와 입력이 듣는 포트를 Target IP와 Target port에 입력하고 Apply를 선택합니다. Wi-Fi 주소나 localhost는 쓸 수 없고, 수신 프로그램의 UDP 입력은 그 컴퓨터의 방화벽에서 허용해야 합니다.

  2. Test connection을 선택하고 수신 프로그램에서 /movin/test 메시지를 찾아보세요. 테스트 메시지는 프리뷰에서도 보내지만 실제 데이터는 GO LIVE 후에 흐릅니다.

    • 메시지가 보임 — 연결이 됐습니다.

    • 수신 컴퓨터는 응답했지만 메시지가 없음 — 수신 포트, UDP 입력, 주소 필터, 방화벽을 확인합니다.

    • 수신 컴퓨터가 응답하지 않음 — IP와 케이블을 확인합니다. ping을 막아도 UDP는 받는 컴퓨터가 있으니 수신 화면도 함께 보세요.

  3. 점군 Source를 선택합니다.

    • all — 전체 점군.

    • zone — cyan 영역 안의 점군.

    • human — amber 영역 안에서 배경을 제거한 점군.

  4. Mocap · on start에서 **Max tracked people (slots)**를 정합니다. 그 아래 읽기 전용 **Slot limit (this host)**가 이 서버의 상한입니다. 변경은 다음 시작이나 Restart 때 적용되고, Restart 중에는 처리와 송출이 잠시 멈춥니다.

스켈레톤은 점군 Source와 별개의 출력입니다. Source를 무엇으로 두어도 함께 전송됩니다. 메시지 구조는 OSC 메시지 형식을 참고하세요.

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

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

인원수나 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%)로 조정합니다. 값이 클수록 스켈레톤이 안정되지만 반응은 늦어집니다. 뷰포트에는 반영되지 않으므로 수신 프로그램에서 느린 동작과 빠른 동작을 모두 확인해주세요.

다음은 Stage 3 · Live입니다.

마지막 업데이트