장 1

시작하기

JustMakeQ는 멀티미디어 쇼 컨트롤 소프트웨어입니다. 공연이 진행되는 동안 "cue" 목록(오디오, 비디오, 이미지, MIDI, OSC 등)을 순서대로 재생하며, GO 키로 하나씩 실행합니다.

JustMakeQ 설치 및 실행

다운로드 공간에서 사용 중인 시스템에 맞는 설치 프로그램을 내려받아 실행하세요. 처음 실행하면 시작 화면이 표시됩니다:

시작 화면: 새 프로젝트 만들기, 기존 프로젝트 열기, 최근 프로젝트 불러오기.

라이선스 상태는 로고 아래에 표시됩니다("라이선스 활성화됨"이 녹색으로). 아직 활성화되지 않았다면 "라이선스 관리" 버튼으로 브라우저에서 license.justmakeq.com이 열립니다: 로그인(Breizhzion SSO)한 뒤 대시보드에서 라이선스 키를 복사해 애플리케이션의 활성화 창에 붙여넣으세요.

첫 프로젝트 만들기

"새 Q"를 클릭해 빈 프로젝트를 시작하세요. 아직 비어 있는 cue 목록과 함께 메인 창이 열립니다:

메인 창: 상단에 트랜스포트 바(GO/Stop/Pause), 그 아래에 cue 추가 버튼, 왼쪽에 cue 목록, 오른쪽에 인스펙터.

cue를 추가하려면 "+ Cue" 바에서 유형을 클릭하세요(Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Play, Pause, Stop, Wait, Group, Sep). 바로 cue 목록에 나타납니다:

Audio cue가 방금 추가되었습니다. 파일이 지정되기 전까지는 빨강/주황으로 표시됩니다.

목록에서 cue를 클릭하면 오른쪽 인스펙터에 열립니다. 모든 매개변수는 여기에서 설정하며, 먼저 "설정" 탭에서 재생할 파일을 지정합니다.

선택된 cue: 인스펙터에 정보(이름, 번호, 색상)와 타이밍(pre-wait, post-wait, auto-follow/auto-continue)이 표시됩니다.

공연 시작하기

• 스페이스 또는 GO 버튼: 재생 커서(cue 목록의 주황색 삼각형) 위치의 cue를 실행하고 커서를 다음으로 옮깁니다.
• Esc 또는 Stop All 버튼: 재생 중인 모든 것을 정지합니다.
• P 또는 Pause 버튼: 선택한 cue를 일시정지합니다. Pause All은 전체를 일시정지합니다(기본 단축키 없음).
• H 또는 Set Head 버튼: 선택한 cue로 재생 커서를 옮기되 실행하지는 않습니다.
• ↓ / ↑: 재생 커서를 다음/이전 cue로 옮기되 실행하지는 않습니다.

기본 단축키이며, 환경설정 > 키보드 단축키에서 변경할 수 있습니다.

각 cue에는 시작 전 대기 시간(pre-wait)과, "Auto-continue"가 켜져 있을 때 다음 cue가 자동으로 이어지기까지의 대기 시간(post-wait)을 설정할 수 있습니다. "Auto-follow"는 현재 cue가 끝나면 다음 cue를 실행하고, "Auto-continue"는 다음 cue를 동시에 실행합니다.

QLab 쇼 파일 가져오기

☰ 파일 > 쇼 파일 가져오기...는 QLab 5에서 만든 쇼 파일(.qlab5 파일 또는 자동 백업 .qlab5backup)을 QLab 없이도 가져옵니다. 가져오기는 워크스페이스 이름을 딴 새 cue 목록을 만들고 이를 활성 목록으로 지정합니다. 열려 있는 쇼와 원본 파일은 건드리지 않습니다. QLab의 cue 번호는 그대로 유지됩니다. 이름, 메모, 대기 시간, 연결(auto-continue, auto-follow), 오디오·비디오 cue(레벨, 구간, 반복), Fade, Stop, Play, Pause, GoTo, Wait, OSC, MIDI, 그룹을 가져옵니다. 대응하는 것이 없는 cue(타이틀, 카메라, 조명, 스크립트 등)는 번호와 이름을 유지한 채 비활성(disarmed) 상태로 보관됩니다. 가져오기가 끝나면 보고서가 열려, cue마다 가져온 것, 일부만 가져온 것, 가져오지 못한 것을 알려 줍니다. 미디어는 워크스페이스 옆에서 먼저 찾고, 그다음 원래 위치에서 찾습니다.

장 2

환경설정

도구 모음의 "환경설정" 버튼을 누르면 특정 프로젝트에 종속되지 않는 모든 설정(하드웨어, 네트워크, 단축키)을 모아 놓은 탭 대화상자가 열립니다. 각 탭은 아래에서 설명하며, 키보드 단축키는 3장, AI 제어는 13장에서 따로 다룹니다.

일반

테마, 비디오 GPU 가속, GO 보호(연속 입력 방지 최소 지연), Stop All 동작(즉시 정지 또는 페이드), cue 목록 클릭 옵션, 설정 내보내기/가져오기.

하단의 "설정 내보내기..." / "설정 가져오기..."는 하드웨어와 무관한 항목(테마, 언어, OSC 패치, 서버, 단축키)을 파일로 저장하거나 옮깁니다. 다른 컴퓨터에 설정을 그대로 옮길 때 유용합니다. 설치마다 다른 화면, 사운드 카드, 비디오 서피스는 포함되지 않습니다.

비디오 렌더링. 환경설정 > 일반 > 비디오 렌더링의 “GPU 가속 (OpenGL)” 항목은 기본적으로 해제되어 있으며 다음 재생부터 적용됩니다. 체크하면 렌더링이 그래픽 카드를 거치며, 여러 영상을 동시에 재생하거나 4K를 다룰 때 특히 효과가 큽니다. 표면의 지오메트리, 즉 warp, keystone, edge blending, 도형, 마스크(도형 기준 또는 이미지 기준), 맞춤 도우미, 구면·360° 미디어(정방형, 돔마스터, 구나 원통 위의 더블 피시아이), 불투명도 페이드를 모두 포함하며, NV12, P010, YUV420P 프레임의 YUV에서 RGB로의 변환도 그래픽 카드에서 이루어집니다. 보급형 PC(GTX 1060 그래픽 카드, i5-9400F 프로세서)에서 측정한 결과, warp, keystone, edge blending, 마스크를 적용한 4K 60프레임 영상은 GPU 렌더링에서 초당 약 58~60프레임을 유지했고, 소프트웨어 렌더링에서는 18~23프레임이었습니다. 소프트웨어 렌더링으로 남는 경우: cue의 3D 회전, 텍스트 cue, 비디오 이펙트, 인스펙터 미리보기, 열려 있는 동안의 프리뷰 모니터, 설정을 읽을 수 없는 표면, OpenGL을 사용할 수 없는 컴퓨터. 항목 아래의 “마지막 비디오 출력: GPU 렌더링” 또는 “마지막 비디오 출력: 소프트웨어 렌더링” (사유) 줄은 마지막 재생에서 실제로 일어난 일을 알려 주며, 가속이 체크되어 있는데 쓰이지 않을 때는 대체 사유가 로그에도 기록됩니다(메뉴 ? > 로그 보기...).

HDR 영상. JustMakeQ는 자체적으로 HDR 변환을 하지 않습니다. HDR 영상(HLG 또는 PQ, BT.2020)은 Qt가 직접 SDR BT.709로 변환하며, 소프트웨어는 그 결과를 소프트웨어 렌더링에서든 GPU 렌더링에서든 그대로 표시합니다. 따라서 출력은 항상 SDR입니다(Qt에서 OpenGL을 쓸 수 없는 컴퓨터에서는 변환이 이루어지지 않아 영상이 변환 없이 표시됩니다). iPhone의 HDR 영상은 더 이상 두 번 변환되지 않으며, 예전에는 이 때문에 너무 어둡고 채도가 지나치게 높았습니다.

Audio > Routing

각 물리 출력(사운드 카드)은 한 번만 선언합니다: 이름, 인터페이스, 채널 수.

Audio > Patch

각 patch 채널(7장의 Audio cue 믹서에서 사용)은 여기에서 자유롭게 이름을 정하고, Routing에 선언된 출력의 실제 채널로 라우팅합니다.

Audio > 입력

In Audio cue(15장)에서 사용하는 이름 있는 라이브 오디오 입력을 최대 5개까지 설정할 수 있습니다. 각 입력은 "장치"(사운드 카드나 USB 콘솔 입력, Dante Virtual Soundcard가 노출하는 Dante 채널 포함, 캡처 채널 수 선택 가능) 또는 "NDI"(네트워크의 NDI 소스 오디오) 유형입니다. "장치 새로 고침" 버튼은 목록을 다시 불러오고 NDI 소스를 검색합니다.

비디오 > 라우팅

각 물리 출력(화면)은 한 번만 이름을 정합니다. 보정용 테스트 패턴(격자, 체커보드 등)을 바로 띄워 올바른 화면에 제대로 맞았는지 확인할 수 있습니다.

비디오 > 표면

"서피스"는 직사각형 영역을 Routing에 선언된 출력과 연결합니다. Video/Image cue가 목적지로 선택하는 대상이 바로 이것입니다(8장). "지오메트리" 탭:

이름, 대상 비디오 출력, 이 서피스 전용 보정 패턴, 해상도(출력의 해상도를 가져오는 버튼 포함), 그리고 여러 출력에 걸치도록 하는 "멀티스크린 서피스" 옵션.

"Warp" 탭: 투사 왜곡(평탄하지 않은 벽, 프로젝터 각도)을 보정합니다.

왜곡 메시(Linear 또는 Bézier 모드), 포인트의 행/열 수, 마우스 드래그 또는 키보드(화살표, Shift 조합 시 10px 단위) 이동, 서피스 전체를 옮기는 중앙 포인트, 휠 확대/축소.

Vidéo > 입력

In Video cue(15장)에서 사용하는 이름 있는 라이브 비디오 입력을 최대 5개까지 설정할 수 있습니다. 각 입력은 "장치"(웹캠이나 캡처 카드, 연결할 오디오 소스 선택 가능: "(자동)"은 같은 장치의 마이크를 사용) 또는 "NDI"(내장 오디오를 포함한 네트워크 소스) 유형입니다. 밀리초 단위의 A/V 동기화 필드로 소리와 영상을 맞춥니다: 음수 = 영상 지연, 양수 = 소리 지연, cue 재생 중에도 실시간으로 조정할 수 있습니다. 입력은 영구 식별되므로 장치를 뽑았다 다시 꽂아도 cue가 깨지지 않습니다.

OSC > Sortant (Patch)

최대 6개의 patch를 만들 수 있으며, 각각 프로토콜, 뱅크(대상 콘솔/소프트웨어), 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다. OSC cue에서 사용합니다(10장).

OSC > Entrant (Serveur)

OSC 명령을 수신해 JustMakeQ를 원격 제어합니다(GO, Stop, Pause, 다음/이전 cue, 특정 cue 번호로 이동).

기본은 UDP, TCP는 선택 사항. 서버는 UDP로 수신합니다. TCP로만 보내는 컨트롤러가 있다면 환경설정 > OSC > 입력 (서버)에서 “OSC를 TCP로도 받기”를 체크한 뒤 적용 또는 OK를 누르세요. 그러면 서버가 UDP와 같은 포트 번호로 TCP도 수신합니다. 이 항목은 기본적으로 해제되어 있으며, 해제된 동안에는 TCP 연결을 받지 않습니다. 패널에는 전송 방식이 표시됩니다. “UDP만”, “UDP와 TCP”, 또는 TCP 포트를 다른 프로그램이 이미 쓰고 있을 때의 “UDP만 (TCP 사용 불가: 사유)”(이 경우 UDP는 계속 동작합니다). TCP 위에서 OSC를 구분하는 두 방식인 OSC 1.0(각 패킷 앞에 크기를 붙임)과 OSC 1.1(SLIP)은 연결마다 자동으로 인식됩니다. 64 KiB를 넘는 패킷은 연결을 끊으며, 동시에 받는 연결은 최대 16개입니다.

PJLink

최대 10대의 프로젝터를 patch할 수 있으며(이름, 송신 인터페이스, 목적지, 포트, 선택적 비밀번호), PJLink cue에서 사용합니다(11장). "?" 버튼을 누르면 이 화면에서 바로 프로젝터 상태를 조회합니다.

MIDI

최대 4개의 출력 포트(MIDI cue용, 9장)와 4개의 입력 포트(MIDI Learn 단축키, 믹싱 콘솔)를 시작 시 자동으로 엽니다.

장 3

키보드 단축키

환경설정 > 키보드 단축키에서 각 단축키를 변경할 수 있으며, 실제 MIDI 컨트롤러(풋스위치, 컨트롤 서피스 등)로 트랜스포트를 제어하는 "MIDI Learn" 기능도 제공합니다.

기본 키보드 단축키와 그 아래의 MIDI Learn 단축키("MIDI Learn"을 클릭한 뒤 CC 또는 Note 메시지를 보내면 컨트롤이 연결됩니다).

"기본값으로 재설정"을 누르면 변경한 설정이 문제를 일으킬 때 원래 값을 한 번에 되돌릴 수 있습니다.

장 4

인터페이스

메인 창은 세 영역으로 나뉩니다:

위에서 아래로: 트랜스포트 바, cue 추가 바, 그리고 세 영역(활성 미디어, cue 목록, 인스펙터).

• 트랜스포트 바(상단): GO, Stop All, Pause, Pause All, 이전/다음 이동, Set Head, 그리고 Inspector, 환경설정, Console(믹싱), Preview(미리보기 모니터) 버튼.
• "+ Cue" 바: cue 유형별 버튼(5장 참고)과, cue 목록의 끌어다 놓기를 잠그는 자물쇠(공연 중 실수로 순서가 바뀌는 것을 막되, 새 파일 추가는 계속 허용).
• 활성 미디어(왼쪽 위): cue 목록의 커서 위치와 무관하게, 실제로 재생 중인 항목을 실시간으로 보여주는 목록.
• cue 목록(왼쪽 아래): 공연의 시퀀스. 열 구성: #(번호), Type, Name, Pre/Dur/Post(시간), 루프, 마커, Notes. 주황색 삼각형은 재생 커서(playhead)로, GO를 누르면 실행될 다음 cue를 가리킵니다.
• 인스펙터(오른쪽): 선택한 cue의 설정을 두 개의 탭으로 제공합니다. "정보"(이름, 번호, 색상, 타이밍, auto-follow/auto-continue로 모든 유형 공통)와 "설정"(cue 유형별, 이후 장 참고).

"☰ 파일" 메뉴에서는 새 프로젝트, 열기, 저장, 번들 만들기(프로젝트와 미디어를 하나의 이동 가능한 폴더로 모음), 그리고 Coworking 세션...(16장)을 사용할 수 있습니다. "?" 메뉴에서는 도움말, 진단 로그, 라이선스 관리를 엽니다.

장 5

cue 유형

JustMakeQ는 20가지 cue 유형을 제공하며, 각각 cue 목록에서 고유한 색으로 표시되어 한눈에 구분됩니다:

위에서 아래로: Audio, Video, Image, MIDI, OSC, PJLink, HTTP, Fade, Group. 각각 고유한 색을 가집니다.

• Audio: 사운드 파일 재생, 채널별 라우팅 지원(7장).
• Video / Image: 투사면에 표시하며, 지오메트리와 효과를 지원합니다(8장).
• Stream: 라이브 네트워크 비디오 스트림을 투사면에 표시합니다(13장).
• In Video: 라이브 비디오 입력(웹캠, 캡처 카드, NDI 소스)을 소스의 소리와 함께 표시합니다 (15장).
• In Audio: 라이브 오디오 입력(사운드 카드, USB 콘솔, Dante, NDI 오디오)을 표준 라우팅으로 재생합니다 (15장).
• Text: 표면에 스타일 텍스트를 표시합니다. 무대 자막 투사를 위해 설계되었으며 .srt 파일을 가져올 수 있습니다 (16장).
• MIDI: 하나 이상의 MIDI 메시지를 전송합니다(9장).
• OSC: 사전 설정 뱅크 또는 수동으로 OSC 명령을 전송합니다(10장).
• PJLink: 네트워크로 연결된 프로젝터를 제어합니다(11장).
• HTTP: 외부 서비스로 웹 요청을 보내며, 바로 쓸 수 있는 템플릿을 제공합니다(12장).
• VISCA / ONVIF: 전동 카메라의 팬/틸트/줌 제어(14장).
• Fade: 이미 실행 중인 다른 cue의 볼륨, 불투명도, 위치, 속도를 점진적으로 변화시킵니다.
• Play / Pause: 특정한 다른 cue를 실행하거나 일시정지하며, 주 재생 커서는 움직이지 않습니다.
• Stop: 특정 cue를 정지합니다(대상을 지정하지 않으면 전체).
• Wait: 시퀀스 안의 단순한 시간 대기.
• GoTo: 재생 커서를 목록의 다른 cue로 옮깁니다(반복, 분기).
• Group: 여러 cue를 묶어 순차 재생("Playlist")하거나 동시에 재생("동시")합니다. 6장 참고.
• Sep(구분선): cue 목록의 시각적 구분 또는 장 표시일 뿐 재생에는 영향이 없으며, GO는 자동으로 건너뜁니다.

장 6

공연 운영하기

재생 커서(playhead, 주황색 삼각형)는 GO를 누를 때마다 한 cue씩 이동합니다. 각 cue에는 시작 전 대기(pre-wait)와 이후 대기(post-wait)를 설정할 수 있습니다. 정보 탭의 두 체크박스가 자동 연결을 제어합니다:

• Auto-follow: 현재 cue가 끝나면(post-wait 이후) 다음 cue가 시작됩니다.
• Auto-continue: 현재 cue의 post-wait가 지나면 GO를 다시 누르지 않아도 다음 cue가 현재 cue와 동시에 자동으로 시작됩니다.

비활성화된 cue("Armed" 체크 해제)는 일반 cue와 동일한 지연을 따르지만 미디어를 재생하지 않습니다. 아직 준비되지 않은 영상이나 음향을 실행하지 않고 리허설할 때, 또는 cue를 삭제하지 않고 잠시 꺼둘 때 유용합니다. cue 목록에서 이름에 취소선이 표시됩니다.

그룹: Playlist 또는 동시

Group cue는 여러 하위 cue를 묶습니다(안으로 끌어다 놓거나, 선택한 뒤 오른쪽 클릭 메뉴의 "그룹화" 사용). 모드는 설정 탭에서 선택합니다:

그룹 모드는 여기에서 선택합니다: Playlist(순차) 또는 동시.

• Playlist(순차): 하위 cue들이 차례로 이어지며, 각각 자신의 pre/post-wait를 따릅니다.
• 동시: 모든 하위 cue가 동시에 시작됩니다.

그룹은 모드에 따라 cue 목록에서 고유한 색으로 표시되며, 선택한 상태에서 "<"/">" 키로 펼치거나 접을 수 있습니다.

장 7

Audio cue

Audio cue의 설정 탭에서는 파일 선택, 시작/종료 지점 지정(일부 구간만 재생), 루프, 재생 속도, 그리고 물리 출력으로의 라우팅을 설정할 수 있습니다.

파일, 시작/종료, Loop, 속도, 그리고 채널별 믹서(Master와 환경설정 > Audio에서 지정한 채널들).

• 속도: 0.25배에서 4배까지. 속도를 바꾸면 음정도 함께 변합니다(가변 속도 테이프처럼). 피치 보정은 의도적으로 넣지 않았습니다.
• Mixer / Routing: 설정된 출력 채널마다 페이더가 하나씩(환경설정 > Audio > Routing에서 이름 지정) 있고, Master도 있습니다. "콘솔 설정 붙여넣기"는 출력 콘솔에서 실시간으로 맞춘 레벨을 그대로 가져옵니다(9장).
• 오디오 효과(믹서 아래): 저음/고음 EQ, 컴프레서/리미터, 16밴드 이퀄라이저(전용 그래픽 인터페이스), 리버브(알고리즘 방식, 컨볼루션 아님), 딜레이. cue당 한 번에 하나의 효과만 활성화됩니다.

이 cue를 대상으로 하는 Fade cue는 이미 재생 중인 볼륨이나 속도를 점진적으로 변화시킬 수 있습니다.

장 8

Video 및 Image cue

Video 또는 Image cue를 실행하려면 먼저 환경설정 > Video > Surfaces에서 투사 "서피스"를 하나 이상 정의해야 하며(2장), 그 서피스는 Routing 탭에 선언된 물리 출력(화면)과 연결되어 있어야 합니다.

서피스가 준비되면 Video/Image cue에서 다음을 설정할 수 있습니다:

파일, 대상 서피스, 그리고 지오메트리(전체 화면, 불투명도, 크기, 위치, 3D X/Y/Z 회전).

• 지오메트리: 크기, 위치, 3D 회전, 불투명도. 모두 Fade cue로 점진적으로 변화시킬 수 있습니다.
• Warp(서피스 편집기, 환경설정 > Video > Surfaces, 2장): 메시 기반 변형으로, 평탄하지 않은 면이나 프로젝터 각도로 인한 왜곡을 보정합니다.
• 구면 미디어: 360° 영상, 돔마스터, 듀얼 어안의 형식으로, 구체나 원통에 투사됩니다(18장).
• 효과(Video/Image 공통, 지오메트리 아래): 채도, 대비, 밝기, 흑백, 세피아.
• 재생 속도(Video 전용): 0.25배에서 4배까지. 영상과 내장 음향은 동기 상태를 유지합니다.

Image cue는 Video cue와 동일한 지오메트리와 효과를 사용합니다(여기에서는 채도를 선택한 상태).

트랜스포트 바의 "Preview" 버튼은 선택한 출력에서 현재 활성화된 모든 미디어를 합성한 미리보기를 열며, 아무것도 실행하지 않습니다. 공연 전에 화면 구도를 확인할 때 유용합니다.

장 9

MIDI cue와 믹싱 콘솔

MIDI cue는 설정된 출력 포트로 하나 이상의 메시지를 보냅니다:

출력 포트, 그리고 자유롭게 추가·삭제할 수 있는 메시지 목록(Note On/Off, Control Change, SysEx, NRPN 등).

포트는 환경설정 > MIDI에서 선언합니다(출력 4개, 입력 4개까지):

입력 포트는 MIDI 명령(MIDI Learn 단축키, 믹싱 콘솔)을 수신하며 시작 시 자동으로 열립니다.

출력 콘솔

트랜스포트 바의 "Console" 버튼을 누르면 믹싱 콘솔이 열립니다. Master와 10개의 출력 채널, VU 미터, 그리고 페이더별 MIDI Learn 할당(실제 컨트롤러로 각 채널을 제어)을 제공합니다.

"설정 복사"는 이 레벨을 선택한 Audio cue의 믹서로 옮기고, "전체 0 dB로 재설정"은 모든 페이더를 기준값으로 되돌립니다.

장 10

OSC cue

OSC cue는 외부 소프트웨어나 콘솔로 명령을 보냅니다. 설정 탭에 두 가지 모드가 있습니다:

"수동" 모드: host/포트/OSC 주소를 직접 입력하며, 인자(Args)의 자료형(숫자, 불리언, 텍스트)은 자동으로 인식됩니다.

• Patch(사전 설정 뱅크): 환경설정 > OSC > 송신에서 선언한 patch를 선택한 뒤, 대상 제품에 맞게 준비된 목록에서 명령을 고릅니다(ETC Eos, QLab, Midas/Behringer, grandMA3, Resolume, OBS 등).
• 수동(host / 직접 주소): 뱅크가 지원하지 않는 경우, host/포트/주소/인자를 직접 입력합니다.

송신 patch와 수신 서버는 환경설정 > OSC에서 설정합니다:

최대 6개의 송신 patch를 만들 수 있으며, 각각 프로토콜, 뱅크, 송신 네트워크 인터페이스, 목적지, 그리고 프로토콜에 따라 선택적인 비밀번호를 갖습니다.

JustMakeQ의 기본 포트: 53025(일반 patch)와 53026(로컬 수신 서버). QLab의 기본 포트와 겹치지 않도록 의도적으로 다르게 정했습니다.

장 11

PJLink cue

PJLink는 프로젝터를 제어하기 위한 표준 네트워크 프로토콜입니다(전원 켜기·끄기, 입력 선택, 화면 차단 등). 프로젝터는 환경설정 > PJLink에서 한 번만 patch합니다(10개 슬롯):

각 프로젝터의 이름, 송신 네트워크 인터페이스, 목적지 IP 주소, 포트, 선택적 비밀번호를 설정합니다. 행 끝의 "?" 버튼은 프로젝터를 직접 조회합니다(이름, 제조사, 모델, 전원, 활성 입력, 셔터, 램프, 오류). 마지막 조회 일시는 해당 열에 계속 표시됩니다.

PJLink cue는 patch된 프로젝터와 명령을 고르기만 하면 됩니다:

cue는 선택한 프로젝터와 명령에 맞춰 자동으로 이름이 바뀝니다.

장 12

HTTP cue

HTTP cue는 외부 서비스로 웹 요청(GET/POST/PUT/PATCH/DELETE)을 보냅니다. 웹 API를 제공하는 거의 모든 장치나 소프트웨어를 제어할 수 있습니다(스마트 조명, 알림, 홈 오토메이션 등).

"제품" 다음 "동작"으로 이어지는 선택 흐름이 바로 쓸 수 있는 템플릿을 제공하며, 메서드·URL·헤더·요청 본문은 자유롭게 수정할 수 있습니다.

vMix, WLED, Bitfocus Companion, Philips Hue, Shelly, Home Assistant, Discord, Pushover, ntfy, PTZOptics 호환 PTZ 카메라 등 15종 안팎의 흔한 제품용 템플릿이 미리 채워져 있어, 매 요청을 직접 작성할 필요가 없습니다. "마지막 응답" 필드는 서버의 응답을 실시간으로 보여 주므로, 공연 전에 요청이 제대로 동작하는지 확인할 때 유용합니다.

"지정 시간 후 자동 재시도" 옵션은 첫 전송이 실패했을 때(일시적인 네트워크 장애) 선택한 시간이 지난 뒤 요청을 한 번만 다시 보냅니다. 두 번 모두 실패한 경우에만 cue가 오류 상태가 됩니다.

장 13

라이브 스트림 cue (Stream)

Stream cue는 네트워크 비디오 라이브 스트림을 투사면에 표시합니다. 표준 스트림을 제공하는 IP 카메라, 인코더, 비디오 믹서를 사용할 수 있습니다. 지오메트리(위치, 크기, 회전), 비디오 효과, 오디오 믹싱(채널별 라우팅, 효과)은 일반 Video cue(8장)와 동일하며, 소스만 다릅니다.

입력한 URL의 접두사로 자동 인식되는 프로토콜: rtsp://, rtsps://, rtmp://, rtmps://, srt://, rist://, udp://, rtp://, tcp://, 그리고 HLS(.m3u8) 또는 DASH(.mpd) 스트림용 http:///https://.

장 14

VISCA 및 ONVIF cue (PTZ 카메라)

두 가지 전용 cue로 별도의 소프트웨어 없이 팬/틸트/줌(PTZ) 전동 카메라를 cue에서 직접 제어할 수 있습니다. 이동, 줌, 프리셋 호출 및 저장을 지원합니다.

VISCA-over-IP

대부분의 프로/방송용 PTZ 카메라(Sony 및 호환 기기)가 채택한 표준 바이너리 프로토콜입니다. 각 카메라는 환경설정 > VISCA에서 한 번만 patch하고(목적지, 포트 기본값 52381, VISCA 버스 주소 1~7), 이후 각 VISCA cue에서 patch된 카메라와 명령을 선택합니다(4방향 팬/틸트와 정지, 줌 인/아웃/정지, 홈 위치, 0~127번 프리셋 호출 또는 저장).

ONVIF

SOAP/HTTP 기반의 개방형 표준으로, IP 감시 카메라와 일부 방송용 기기에서 널리 쓰입니다. 각 카메라는 환경설정 > ONVIF에서 patch합니다(목적지, 포트, 사용자 이름/비밀번호, 미디어 프로필, 서비스 경로 — 기본값이 모든 제조사에 맞지는 않으므로 모델별로 확인 필요). 사용 가능한 명령: 연속 이동(팬/틸트/줌 속도 조절), 정지, 홈 위치, 프리셋 호출/저장(VISCA처럼 번호가 아니라 자유로운 이름으로 식별).

장 15

라이브 입력 (In Video, In Audio)

두 가지 cue 유형으로 라이브 소스를 시퀀스에 넣을 수 있습니다. 파일이 아니라 환경설정(2장)에서 한 번 구성한 입력을 재생하며, 각 cue는 그 이름으로 입력을 참조합니다.

Cue In Video

라이브 비디오 입력을 투사 표면에 표시합니다: 웹캠, USB/PCIe 캡처 카드, 네트워크의 NDI 소스(OBS, NDI 카메라, 모바일 앱). Image cue와 같은 인터페이스입니다: 표면, 지속 시간(0 = 정지할 때까지 유지), 전체 지오메트리(전체 화면, 불투명도, 크기, 위치, 3D 회전), 비디오 효과, 그리고 Fade cue와의 호환성.

소스의 소리(웹캠 마이크, NDI 스트림의 내장 오디오)는 Video cue처럼 라우팅됩니다: 인스펙터의 마스터 콘솔 + 채널별 페이더, 재생 중 실시간 조정, Fade cue를 통한 볼륨 페이드.

Cue In Audio

라이브 오디오 입력을 표준 라우팅으로 재생합니다: 모든 사운드 카드나 USB 콘솔 입력, Dante 채널(사운드 카드처럼 노출하는 Dante Virtual Soundcard 사용), 또는 NDI 소스의 오디오만(이때 비디오는 전송되지 않아 네트워크 부담이 줄어듭니다). Audio cue와 같은 마스터 콘솔 + 페이더, 선택적 지속 시간, Fade cue를 통한 페이드.

오디오/비디오 동기화

일부 소스는 소리가 영상보다 늦게(모바일 NDI 앱에서 흔함) 또는 그 반대로 도착합니다. 각 비디오 입력의 A/V 동기화 필드(환경설정 > 비디오 > 입력)로 둘 중 하나를 지연시킵니다: In Video cue가 재생되는 동안 귀로 들으며 조정하세요. 효과는 즉시 나타납니다.

장 16

Text cue와 자막 투사 (.srt)

Text cue는 투사 표면에 텍스트를 표시합니다: 오페라나 외국어 연극의 자막 투사, 접근성, 화면 메시지. 텍스트는 여러 줄이며 일반적인 스타일 설정을 제공합니다: 글꼴과 크기, 굵게/기울임/밑줄, 색상, 형광펜(텍스트 뒤 색상), 세로 위치(기본 아래, 중앙 또는 위), 그리고 기본 투명 배경(이때 텍스트는 표면에서 이미 재생 중인 것, 예를 들어 비디오 위에 겹쳐집니다) 또는 원하는 색상의 배경.

각 Text cue에는 페이드 인과 페이드 아웃(기본 1초), 그리고 선택적 지속 시간(0 = 정지할 때까지 유지)이 있습니다. 모든 설정은 표시 중에 실시간으로 적용됩니다. cue의 이름은 직접 바꾸기 전까지 텍스트의 첫 줄을 자동으로 따릅니다.

핵심 동작: 다른 텍스트가 표시된 곳에 Text cue를 실행하면 이전 텍스트가 크로스페이드로 교체됩니다. 이전 텍스트를 멈출 필요 없이 텍스트를 이어갈 수 있습니다.

.srt 파일 가져오기

파일 > 자막 가져오기(.srt)는 자막당 하나의 Text cue를 담은 그룹을 만듭니다. 부스에서는 모든 것을 스페이스 바로 조작합니다: 첫 GO가 첫 줄을 표시하고(재생 커서는 그룹에 머뭅니다), 이후 GO마다 크로스페이드로 다음 줄로 넘어가며, 파일이 끝나면 커서는 다음 cue로 이어집니다.

장 17

타임라인 뷰

툴바의 “⏱ 타임라인” 버튼을 누르면 cue 목록 아래에 공연 진행을 시간순으로 보여 주는 뷰가 열립니다. 목록을 대체하지 않고 보완하며, cue가 겹치는 구간을 확인하고 대기 시간을 맞추는 데 쓰입니다. 열림/닫힘 상태는 다음 실행에도 유지됩니다.

뷰 읽는 법

cue에는 고정된 시각이 없습니다. GO를 누르는 순간 시작합니다. 그래서 이 뷰는 pre-wait, 길이, post-wait, 그리고 Auto-continue(다음 cue를 동시에 시작)와 Auto-follow(이 cue가 끝나면 다음 cue를 시작) 체크 상태로부터 계산됩니다. 수동 GO마다 하나의 블록이 닫히며 점선 “GO” 막대로 표시됩니다. 두 블록 사이의 시간은 임의로 만들어 내지 않습니다.

눈금자

패널 막대의 버튼으로 “누적 시간”과 “블록별 시간”을 전환합니다. 누적 시간에서는 블록이 하나의 연속된 눈금자 위에 이어 붙고, 블록별 시간에서는 각 블록이 0에서 다시 시작합니다. 누적 모드에 표시되는 합계는 “최소 길이”입니다. 모든 수동 GO를 기다림 없이 눌렀다고 가정한 값으로, 실제 공연에서는 그렇지 않기 때문입니다. 같은 막대의 확대/축소 및 맞춤 버튼으로 전체 진행을 화면 너비에 맞출 수 있습니다.

트랙, 길이 없는 cue, 그룹

클립은 비디오, 이미지, 텍스트, 오디오, 제어, 진행 트랙으로 나뉘어 배치됩니다. 길이가 없는 cue(MIDI, OSC, Stop, GoTo 등)는 마름모로 표시됩니다. 해제된(disarmed) cue는 빗금으로 표시되며, 폭은 유지하지만 시간은 차지하지 않습니다. 반복 재생되는 미디어는 한 바퀴 길이로 그려집니다. 그룹은 하위 클립으로 펼쳐지며 다른 클립처럼 편집할 수 있습니다.

화면과 충돌

각 하위 줄에는 cue가 표시되는 화면의 이름이 붙습니다. 두 개의 영상·이미지 cue가 같은 화면을 동시에 차지하면 빨간 윤곽선, 경고 삼각형, 패널 막대의 카운터로 표시됩니다. 한쪽이 다른 쪽을 가리기 때문입니다. 같은 채널의 오디오 두 개는 섞이고, 같은 서피스의 Text cue 두 개는 서로를 교체하므로 충돌이 아닙니다.

대기 시간 조정

클립 본체를 끌면 진입 대기(pre-wait)가 바뀌고, 그에 따라 블록의 나머지도 함께 이동합니다. 오른쪽 가장자리를 끌면 길이가 바뀝니다. 왼쪽 가장자리를 끌면 끝은 그대로 두고 시작 부분을 잘라냅니다. 조작하는 동안 값이 배지로 표시됩니다. 가장자리는 같은 블록 안의 다른 클립 가장자리에 달라붙으며, Alt 키를 누르면 이 기능이 꺼집니다. 한 번의 조작은 Ctrl+Z 한 번으로 취소됩니다. 툴바의 자물쇠는 타임라인도 보호합니다. 이때 패널 막대에 “🔒 잠김”이 표시되고 조작이 거부됩니다.

키보드

뷰를 선택한 상태에서: 왼쪽·오른쪽 화살표로 cue 사이를 이동하고, Home과 End로 처음과 끝으로 이동하며, Shift + 화살표로 0.1초 단위, Ctrl + Shift + 화살표로 0.01초 단위의 미세 이동을 하고, +, -, 0 키로 확대·축소와 맞춤을 합니다. Ctrl + 마우스 휠은 포인터를 중심으로 확대합니다. 위·아래 화살표는 기존대로 cue 탐색에 쓰입니다. 클립을 더블 클릭하면 애플리케이션의 플레이헤드가 그 클립으로 이동합니다.

재생 중

초록색 선과 눈금자에 놓인 작은 깃발로 이루어진 플레이헤드가 가장 많이 진행된 cue의 진행을 따라가며, 점선 표식은 다음 GO에서 시작될 cue를 가리킵니다. 플레이헤드는 재생 중인 것에서 계산됩니다. 재생 중인 것이 없으면 표시되지 않고, 반복 재생 미디어에서는 그려진 클립을 넘어서 계속 이동합니다. 코워킹에서는 클라이언트 컴퓨터에서도 함께 움직입니다.

장 18

지오메트리, 마스크, 워프: 도형, 구체, 360° 영상

이 설정은 환경설정의 비디오 탭, 서피스 하위 탭에 있습니다. 서피스를 선택한 뒤 “지오메트리 / 마스크” 탭과 “Warp” 탭을 여세요. 서피스는 항상 같은 경로를 따릅니다. 이미지는 먼저 워프를 거쳐 변형되고, 그다음 마스크를 거쳐 도형 부분만 보이게 됩니다. 마스크는 레이어 마스크처럼 출력에 고정되어 이미지를 절대 변형하지 않으며, 이미지를 도형에 맞추는 것은 워프입니다.

서피스의 도형

“지오메트리 / 마스크” 탭의 “모양” 목록은 투사 대상 물체를 나타냅니다. 없음(일반 직사각형 화면), 구체, 원통, 직사각형, 삼각형, 다각형 중에서 고릅니다. 다각형은 변이 3개에서 12개이고, 원통은 기둥(세로) 또는 눕힌 관(가로)입니다.

• 크기: 너비와 높이를 서피스의 5%에서 200%까지 정합니다. “비율”은 크기를 키울 때 가로세로 비율을 유지합니다. “정형 모양”은 전체 높이의 규칙적인 도형을, “전체 화면”은 가운데 정렬된 서피스 전체를 지정합니다. 직사각형은 전체 화면에서 시작하고, 삼각형과 다각형은 꼭짓점을 위로 하여 상자를 가장자리까지 채웁니다.
• 위치와 회전: 화살표로 도형을 1픽셀 또는 10픽셀씩 옮기고, “가운데로”로 다시 중앙에 놓습니다. -180°에서 +180°까지의 회전은 비스듬히 놓인 물체에 맞추는 것으로, 내용이 아니라 도형을 돌립니다.

마스크

도형 밖의 모든 것은 어떤 경우에도 출력에서 검게 표시됩니다. 워프가 바깥으로 밀어낸 부분도, 큐가 페이드되는 동안에도 마찬가지입니다. “마스크” 목록에서는 기본값인 “형태에 따라” 또는 “이미지에서”를 고를 수 있습니다.

“이미지에서”는 레이어 마스크처럼 흑백 이미지를 사용합니다. 흰색은 보이고, 검은색은 가려지고, 회색은 절반만 보이며, 투명한 영역은 검은색으로 간주됩니다. 이미지는 서피스 크기에 맞게 늘어나 서피스와 함께 저장되므로, 따로 파일을 옮기지 않아도 코워킹과 다른 컴퓨터에서 서피스를 따라갑니다. 도형과 마스크는 함께 쓸 수 있습니다. 예를 들어 구체에 이미지 마스크를 쓰면 영상을 구체 안에 투사하면서 받침대 부분은 잘라낼 수 있습니다. “형태에 따라”으로 돌아가도 이미지는 나중을 위해 보관됩니다.

투사 영역 밖의 배경

“지오메트리 / 마스크” 탭의 “투사 영역 밖을 검정으로 (바탕화면 숨김)” 항목은 사용 영역(warp, keystone, 축소된 표면) 주위에 무엇이 보일지를 정합니다. 새 표면에서는 기본적으로 체크되어 있습니다. 이미지 밖은 모두 검정이 되고, cue 페이드는 검정으로 향합니다. 체크를 해제하면 표면은 투명하게 남아, 페이드가 그 뒤에 있는 것(바탕화면이나 다른 표면)을 향합니다. 자막(surtitle)처럼 겹쳐 쓰는 구성에 유용합니다. 이전 버전의 소프트웨어에서 만든 표면은 그때의 설정을 그대로 유지합니다.

워프와 맞춤 도우미

“Warp” 탭의 그리드는 이미지를 변형해 도형에 맞춥니다. 점을 하나씩 손으로 옮기거나, 0%(이미지 그대로)에서 100%(도형을 정확히 채움)까지의 “맞춤 도우미”를 사용합니다. 모든 변경은 “적용” 버튼 없이 바로 보입니다. 그리드의 점들은 도형 위에 놓이고, 손으로 한 수정은 해당 점에 붙어 있으므로 비율을 바꿔도 사라지지 않습니다. 0%에서는 기존의 워프와 같습니다.

구면 미디어와 360° 영상

미디어의 형식은 해당 큐(비디오, 스트림, 이미지, 비디오 입력)의 “구면 미디어” 그룹, “형식” 목록에서 정합니다. 기본값인 일반, 돔마스터(원 하나, 반구), 등장방형(구 전체를 덮는 2:1 이미지로, 360° 영상의 일반적인 형식), 듀얼 어안(렌즈 두 개짜리 360° 카메라의 나란한 원 두 개) 중에서 고릅니다. 구형 형식을 고르면 다음 항목이 나타납니다.

• 방향: 실시간으로 작동하는 슬라이더 세 개로, 관객을 향할 미디어 부분을 고르고, 구체 위에서 올리거나 내리고, 프로젝터 축을 중심으로 돌립니다.
• 렌즈(90°~250°), 두 가지 어안 형식용: 촬영한 렌즈의 실제 화각입니다.
• 미러: 360° 영상이나 돔마스터는 안쪽(헤드셋, 돔)에서 보도록 만들어집니다. 구체의 바깥면에서는 좌우가 뒤집혀 보이므로 “미러”로 바로잡습니다. 바깥에서 본 모습으로 그린 세계 지도는 뒤집지 않습니다. 판단 기준은 콘텐츠입니다.

구면 미디어는 구체 또는 원통 서피스에서만, 그리고 자동으로 도형 안에 투사됩니다. 다른 도형에서는 그대로 마스크만 적용되어 지나갑니다. 평면 영상은 저절로 변환되지 않습니다. 구체에 맞게 휘게 하려면 맞춤 도우미를 사용하세요.

테스트 패턴과 미리보기는 실제 물체처럼 도형을 고정해 그립니다. 윤곽선, 그리고 구체라면 경선과 위선까지 그립니다. 워프는 테스트 패턴의 그리드에만 나타나므로, 움직이지 않는 도형 아래에서 이미지가 미끄러지는 모습을 볼 수 있습니다.

변형 내보내기와 가져오기

“변형 내보내기…”는 그리드를 .jmqw 파일로 저장하고, “변형 가져오기…”는 서피스의 그리드를 파일의 그리드로 바꿉니다. 다른 컴퓨터에서 만든 파일도 가능합니다. 이동하는 것은 그리드뿐입니다. 열, 행, 보간 모드와 각 점의 위치는 포함되지만 서피스 이름, 출력, 지오메트리, edge blending은 포함되지 않습니다. 가져오기는 warp를 켜지 않으므로, 그리드를 확인한 뒤 직접 켜세요. 일관성이 없는 파일은 메시지와 함께 거부됩니다.

장 19

AI 제어 (MCP)

JustMakeQ에는 MCP(Model Context Protocol) 서버가 내장되어 있어, 호환되는 AI 어시스턴트(Claude Code, Claude Desktop, Codex 등)가 열려 있는 세션을 제어할 수 있습니다. cue 목록 조회, 생성, 수정, 순서 변경과 GO/Stop/Pause 실행이 가능합니다.

기본적으로 비활성화되어 있습니다. 수신 포트(53020)와 네트워크 인터페이스(기본값 localhost), 그리고 모든 연결에 필요한 액세스 토큰을 여기에서 설정합니다.

서버를 활성화하면, 주요 AI 클라이언트용 설정 예시를 그대로 복사할 수 있도록 탭에서 제공합니다(CLI 명령, .mcp.json 파일, config.toml).

장 20

협업

Coworking을 사용하면 여러 오퍼레이터가 서로 다른 컴퓨터에서 같은 시퀀스를 동시에 다룰 수 있습니다. 호스트가 실제로 미디어를 재생하고, 접속한 클라이언트는 상태(cue 목록, 상태, playhead)를 실시간으로 확인하며, 권한 수준에 따라 시퀀스를 편집하거나 트랜스포트 명령을 실행할 수 있습니다.

파일 > "Coworking 세션..." 메뉴에서 사용합니다. 호스트로 세션을 시작하거나, 로컬 네트워크에서 자동으로 발견된 세션에 참여할 수 있습니다. 호스트는 새 연결을 하나씩 직접 승인하며, "협업자" 대화상자에서 각 클라이언트의 권한 수준(읽기 전용, 편집, 전체 제어)을 언제든 조정할 수 있습니다.

장 21

문제 해결

로그 보기

"?" > "로그 보기..." 메뉴를 선택하면 로그 파일이 들어 있는 폴더가 바로 열립니다. 로그는 실행할 때마다 시각이 기록됩니다. 충돌이 발생한 경우 이 폴더에는 전체 Python 예외가 담기거나, 더 낮은 수준(네이티브)의 충돌이라면 오류 시점의 모든 스레드 스택이 담긴 *_fault.log 파일이 따로 생성됩니다. 지원 요청 시 이 파일들을 함께 보내면 진단이 훨씬 빨라집니다.

자주 발생하는 문제

• Video/Image cue에 아무것도 표시되지 않음: 해당 cue의 설정에서 서피스가 선택되어 있는지, 그리고 그 서피스가 환경설정 > Video > Routing에서 실제 물리 출력과 연결되어 있는지 확인하세요.
• 소리가 나지 않음: 환경설정 > Audio > Routing에서 선택한 인터페이스와, cue의 설정 탭에 있는 채널별 라우팅을 확인하세요.
• OSC/HTTP/PJLink 명령이 전송되지 않음: "마지막 응답" 필드(HTTP)나 메인 창 오른쪽 아래의 서버 상태 표시등을 보면 네트워크 연결이 실제로 있는지 확인할 수 있습니다.
• 라이선스: "?" > "라이선스 관리" 메뉴에서 상세 상태를 확인할 수 있습니다. 활성화 중 네트워크 오류가 발생하면, 이제 메시지가 원인을 알려 줍니다(시스템 시계, 방화벽, DNS, 프록시).

여기에서 다루지 않은 질문은 지원 페이지에서 팀에 직접 문의하실 수 있습니다.