JoyPro2 Discord GitHub
GUI 페이지

HUD

표시:

HUD는 스트리머의 컨트롤러 오버레이처럼 게임하는 동안 화면에 장치를 보여 줍니다. 스틱 이미지는 스틱과 함께 기울고, 레버와 축은 막대로 움직이며, 누르고 있는 버튼은 이름과 함께 불이 들어오고, 한 줄에 누른 버튼이 실행 중인 게임에서 하는 일이 나옵니다("Gear Toggle"). 게임 위, OBS, 또는 둘 다에 보일 수 있으며, 각각 자체 위젯을 가집니다. 이 페이지는 그 디자이너입니다.

실시간 미리 보기가 있는 HUD 디자이너실시간 미리 보기가 있는 HUD 디자이너
실시간 미리 보기가 있는 HUD 디자이너 (그림은 영어로 된 앱을 보여 줍니다.)
flowchart LR
  D["내 장치"] --> P["HUD"]
  O["게임 안의<br/>내 바인딩"] --> P
  P --> S["내 화면"]
  P --> B["OBS용 페이지"]
  P --> W["방송 창"]
HUD는 실행 중인 게임에서 장치와 바인딩을 읽어 최대 세 곳에 동시에 보여 줍니다: 게임 위의 내 화면, OBS용 페이지, 방송 창.
초보자용

#클릭 세 번으로 HUD 시작

  1. 하단 바에서 HUD를 여세요. 스틱을 움직이면 미리 보기가 벌써 움직입니다.
  2. **내 화면 (게임 위)**를 체크된 상태로 두세요.
  3. HUD 시작을 누르세요(시작 페이지에도 있습니다). 게임을 시작하세요. HUD는 게임 위에 떠 있으며, 게임에서 마우스나 키보드를 빼앗지 않습니다.

HUD 중지(같은 버튼)는 HUD를 닫습니다. 여기서 설정한 모든 것은 유지되며 다시 시작한 뒤에도 그대로 있습니다.

#화면에 보이는 것

  • 장치마다 위젯 하나: 처음에는 스틱, 스로틀, 페달이 보이고 패널과 키보드는 숨겨집니다(위젯 목록에서 체크하세요). 각 위젯은 장치 사진, 스틱 위치, 막대로 된 축, 버튼과 햇을 보여 줄 수 있습니다.
  • 기체 위젯: 비행 중인 기체의 스틱과 스로틀을 게임이 그리는 모습 그대로 보여 주며, 내 장치와 함께 움직입니다.
  • 게임 헤더: 게임 또는 DCS 기체와 그 이미지.
  • 버튼의 기능: 마지막으로 누른 버튼들과 실행 중인 게임에서의 동작.

미리 보기에서 위젯을 끌어 옮기고, 클릭하면 오른쪽에서 바꿀 수 있습니다. 자동 정렬은 위젯을 아래쪽을 따라 놓습니다: 스로틀과 왼손 장치는 왼쪽, 페달은 가운데, 오른손 스틱은 오른쪽.

기체 위젯: 기체 자체의 스틱과 스로틀기체 위젯: 기체 자체의 스틱과 스로틀
기체 위젯: 기체 자체의 스틱과 스로틀
게임에서: 게임에서 보이는 것

HUD 창은 투명하며, 창 모드와 테두리 없는 창 모드 게임 위에 떠 있습니다. 클릭은 창을 통과해 게임으로 갑니다. 작업 표시줄이나 Alt+Tab에는 나오지 않습니다. 전용 전체 화면에서는 가려집니다(Windows의 한계). 게임을 테두리 없는 창 모드로 바꾸세요. 누른 버튼의 줄에는 그 게임과 기체의 동작 이름이 나옵니다. 예: F-16C에서는 "Weapon Release", IL-2에서는 "Fire guns".

고급

#HUD 표시 위치

세 가지 출력은 서로 독립적입니다:

출력 대상 방식
내 화면 (게임 위) 나 게임 위에 뜨는 투명한 창
OBS용 페이지 (브라우저 소스, 투명) 내 방송(권장) JoyPro가 이 PC에서만 페이지를 제공합니다. 복사는 그 주소를 클립보드에 넣습니다
스트림 창 (창 캡처) 창 캡처로 방송하는 경우 투명 또는 크로마 키 배경의 일반 창(게임 뒤에 있어도 됨)

내 화면의 체크를 해제하면 방송에는 HUD가 나오면서 내 화면은 깨끗한 채로 플레이할 수 있고, 각각에 다른 위젯을 보여 줄 수도 있습니다. 위젯마다 체크가 두 개 있습니다: 모니터(내 화면)와 OBS(방송). 미리 보기: 내 화면 / 스트림은 디자이너가 보여 주는 것을 바꿉니다. 초당 최대 업데이트 횟수(15, 30 또는 60. 30이면 부드럽고 가볍습니다).

#OBS 설정 (브라우저 소스)

  1. **OBS용 페이지 (브라우저 소스, 투명)**를 체크하고 HUD 시작을 누르세요.
  2. 주소(http://127.0.0.1:8765/hud) 옆의 복사를 누르세요.
  3. OBS에서: Sources > + > Browser. 주소를 URL에 붙여 넣고 Width 1920, Height 1080으로 하세요. 다른 것은 필요 없습니다. 배경은 투명하고 사용자 CSS도 필요 없습니다.
  4. 선택 사항: Shutdown source when not visible을 체크하면 이 소스가 없는 장면에서 OBS가 페이지를 멈춥니다.

이 페이지는 방송용으로 체크한 위젯을 앱과 같은 위치와 스타일로, 소스 크기에 맞춰 늘어나는 1920 x 1080 무대 위에 그립니다. 다른 프로그램이 포트를 쓰고 있나요? 포트에서 다른 포트를 고르고 주소를 다시 복사하세요.

OBS에 보이는 스트림 페이지OBS에 보이는 스트림 페이지
OBS에 보이는 스트림 페이지

대신 창 캡처 쓰기: 스트림 창을 체크하고 배경(투명, 초록, 자홍, 파랑 또는 원하는 색)을 고르세요. OBS에서 Window Capture를 *Capture Method: Windows 10 (1903 and up)*으로 추가하고, 색 배경이면 그 색으로 Chroma Key 필터를 추가하세요. OBS에서 투명 배경이 검게 보이면 브라우저 소스나 색 배경을 쓰세요.

OBS 브라우저 소스가 HUD를 받는 방식: 페이지 하나를 받은 뒤에는 바뀐 것만 받습니다.

# 누가 일어나는 일
1 OBS 브라우저 소스가 http://127.0.0.1:8765/hud을 엽니다.
2 JoyPro 페이지를 보냅니다: 레이아웃, 스타일, 그림.
3 OBS /hud/events을 엽니다. 계속 열려 있습니다.
4 JoyPro 상태(축, 버튼, 버튼이 하는 일)를 보냅니다. 1초에 최대 30번, 무언가 바뀌었을 때만 보냅니다.
5 JoyPro 위젯, 위치, 스타일이 바뀌면 레이아웃을 다시 보냅니다.

#위젯

위젯에는 모든 장치와 헤더, 바인딩 티커, 기체 위젯이 나열됩니다. 장치 새로 고침은 연결된 장치를 다시 읽고, 모두 표시는 모든 위젯을 내 화면용으로 체크하며, 자동 정렬과 위치 초기화는 위젯을 제자리에 놓습니다.

위젯마다(미리 보기나 목록에서 클릭):

  • 내 화면에 표시, 스트림에 표시, 크기, 이 위젯의 스타일(HUD의 스타일 또는 다른 스타일).
  • 표시: 이름, 종류(스틱, 스로틀), 이미지, 스틱을 따라 기울어지는 이미지, 버튼 점등, 누르고 있는 버튼 이름, 축과 레버, 축 이름, 축 값, 스틱 위치(짐벌), 햇. 헤더 위젯: 그 이미지.
  • 이미지: 사진(배경을 잘라 낸 제조사 이미지), 레이아웃(레이아웃 페이지의 내 JoyPro 레이아웃 이미지. 누른 버튼이 제자리에서 켜짐), 자동(사진이 있으면 사진).
  • 이 베이스의 그립: 그립을 여러 개 쓸 수 있는 베이스용(VPforce Rhino, Virpil WarBRD). 그립에 따라 이미지와 버튼 이름이 정해집니다.
  • 스틱 축: 스틱 요소의 X, Y, 비틀기를 어디서 가져올지. 자동은 장치 자체의 축을 씁니다. 축이 없는 별도 장치인 그립은 자기가 꽂힌 베이스의 축을 씁니다.
선택한 장치 위젯: 표시 항목, 이미지, 스틱 축선택한 장치 위젯: 표시 항목, 이미지, 스틱 축
선택한 장치 위젯: 표시 항목, 이미지, 스틱 축

기체 위젯: 스틱, 스로틀, 스로틀 이동 막대, 스틱 위치, 조작부 점등, 누르고 있는 조작부 이름. 기체(자동: 지금 비행 중인 기체, 또는 이 PC에 설정된 아무 이미지)와 연동 대상(위젯을 움직이는 스틱과 스로틀). 이미지는 게임 자체의 조종석 이미지(조종석 > 내 게임에서 이미지 만들기, 또는 이미지 팩)에서 오며, 없으면 실제 그립을 JoyPro가 선으로 그린 도면을 씁니다.

#40가지 스타일

스타일에는 프리셋 40개가 있습니다: 글래스, 네온, 미니멀, 깔끔한 것(반투명 유리 (밝게), 스트리머 깔끔, 스트리머 굵게, 컴팩트, 큰 글자, 파스텔, 윤곽선만), 조종석 디스플레이(밀리터리 그린 HUD, 앰버 MFD, 여객기 PFD, 글래스 콕핏, 야간 투시, 붉은 조종석 조명, 벡터 와이어프레임, 레트로 터미널, 워버드, 홀로그램), 게임과 장르(우주 시뮬 오렌지, 홀로 시안, 사이버펑크, 신스웨이브, 네온 핑크, 레이싱, 전술 황갈색, 네이비 & 골드, 스텔스, 고스트), 색 테마(북극, 사막, 바다, 노을, 로열, 카본), 가독성(고대비, 고대비 (밝게), 단색, 단색 (밝게)). **›**를 누르면 다음 스타일로 넘어갑니다.

40가지 스타일 중 몇 가지40가지 스타일 중 몇 가지
40가지 스타일 중 몇 가지

아래에는 한 번의 클릭으로 고르는 강조 색, 강조, 눌림, 불투명도가 있고, 그다음 요소별 디자인 옵션이 있습니다: 카드(배경, 테두리, 모서리, 그림자), 텍스트(글꼴, 크기, 자간, 색, 이름 굵게), 스틱 표시(링, 사각형, 십자선, 레이더, 점. 크기, 빛), 막대와 레버(모양, 높이, 빈 부분), 버튼과 칩(모양). 옵션을 하나라도 바꾸면 스타일이 "사용자 디자인(변경됨)"이 됩니다. 스타일 저장은 그것을 내 이름으로 보관하고, 변경 취소는 프리셋으로 돌아가며, 스타일 내보내기... / **스타일 가져오기...**는 파일로 공유하고, 삭제는 내 스타일을 지웁니다.

#버튼의 기능과 DCS 기체

버튼의 기능: 줄 수, 표시 시간(초), 글꼴 크기, 장치 및 버튼 표시, 게임 실행 중에만. 클릭 통과는 마우스 클릭이 HUD 창을 통과하게 합니다(HUD를 시작할 때 적용).

JoyPro는 실행 중인 게임을 프로세스로 찾아(DCS, IL-2, Star Citizen 및 JoyPro가 다루는 다른 모든 게임) 그 게임의 바인딩만 보여 줍니다. DCS는 기체도 알아야 합니다. DCS 기체에서 고르거나, DCS 후크 설치로 미션을 시작할 때마다 DCS가 JoyPro에 기체를 알려 주게 하세요(작은 Lua 파일과 Export.lua에 보호된 줄 하나. 먼저 백업합니다. 제거는 파일을 바이트 단위로 그대로 되돌립니다. 먼저 DCS를 닫으세요). 확인은 후크가 설치되어 있는지 알려 줍니다.

게임 위의 HUD게임 위의 HUD
게임 위의 HUD
기술 정보

#페이지의 내부

뷰 모델: MainWindowViewModel.Hud.cs(장치, 위젯, 배치), MainWindowViewModel.HudStyles.cs(프리셋, 내 스타일, 가져오기/내보내기), MainWindowViewModel.HudStream.cs(출력, 스트림 페이지, 기체 위젯), MainWindowViewModel.HudAxes.cs(스틱 축), MainWindowViewModel.Overlay.cs(시작/중지, 실행 중인 게임, 버튼 줄, DCS 후크). 뷰: Views/HudWindow.axaml, Views/Controls/HudSurface.axaml, HudElements.cs, HudPanel.cs. 프리셋: Models/HudStylePresets.cs.

  • 장치: engine hud devices는 연결된 각 장치의 모델, 종류, 손, 제품 이미지, 역할이 붙은 축, 이름과 조작부 id가 붙은 버튼(Controls, 기체 위젯용), 버튼 위치가 있는 레이아웃 이미지를 줍니다.
  • 실행 중인 게임의 바인딩: engine overlay map(--game, --plane, --unit): 수정키와 이름이 붙은 바인딩된 버튼. 수정키가 있는 바인딩은 그 수정키를 누르고 있는 동안 표시되며, 맞는 수정키가 가장 많은 바인딩이 우선합니다.
  • DCS 후크: engine overlay dcs-hook status / install / remove(--path, --dry-run): Scripts\JoyProOverlay.lua와 Export.lua에 pcall로 감싼 줄 하나. DCS가 유닛 종류를 127.0.0.1:1992(UDP)로 보냅니다. 후크는 자신이 대신하는 다른 스크립트(SRS, Tacview)의 내보내기 함수도 호출합니다.
  • 스트림 서버: Services/HudStreamServer.cs, HudStreamHub.cs, Resources/hud-stream.html. 127.0.0.1에만 바인딩되며, 다른 호스트 이름으로 온 요청은 거부합니다. GET /hud(페이지), /hud/events(Server-Sent Events: layout, state), /hud/img/<id>(PNG 이미지), /hud/state(JSON). 연결된 페이지가 없으면 대기만 합니다.
  • 플레이 중 부담: Services/HudInputPump.cs는 장치마다 가장 새로운 보고만 보관하고 선택한 빈도로 적용합니다. 요소는 바뀔 때만 다시 그리고, 보고마다 메모리를 할당하지 않으며, 이미지는 한 번만 잘라 냅니다(기체 그립은 높이 480 px). HUD 장시간 테스트가 CPU, 할당, 메모리 예산에 맞춰 측정합니다.
  • 설정: %APPDATA%\JoyPro2\hud.json(위치, 크기, 화면과 스트림용 위젯별 체크, 모든 옵션이 담긴 스타일, 내 스타일, 출력, 포트, 배경, 업데이트 빈도). 스타일 파일: *.joypro-hudstyle.json("format": "joypro-hud-style").

참고: hud.

#참고 자료

이 페이지의 바탕이 된 기능 문서(저장소에서 생성):

#이 페이지의 모든 컨트롤

프로그램 소스에서 읽은 조작 요소 42개: 작성됨 42개, 소스의 정보(툴팁, 코드 주석, 엔진 호출)가 있는 것 0개, 아직 보완할 것 0개.

#오버레이 전환

버튼작성됨

HUD 시작 / HUD 중지: 위에서 체크한 출력으로 HUD를 시작합니다: 필요하면 장치를 읽고, 실행 중인 게임을 찾아 그 바인딩을 불러옵니다.

다시 누르면 모든 출력을 닫습니다.

자세히 보기(영어)

#내 화면 (게임 위)

체크 상자작성됨

툴팁 게임 위에 표시되는 투명 HUD입니다. 체크를 해제하면 스트림에는 HUD가 계속 표시되고 내 화면은 깨끗하게 유지됩니다.

HUD를 게임 위에 투명한 창으로 표시합니다.

스트림에는 HUD를 계속 보여 주면서 내 화면은 깨끗하게 두려면 체크를 해제하세요.

자세히 보기(영어)

#OBS용 페이지 (브라우저 소스, 투명)

체크 상자작성됨

툴팁 JoyPro는 HUD를 이 PC에서만 웹 페이지로 제공합니다. OBS에서 이 주소로 브라우저 소스를 추가하세요. 배경이 투명하므로 사용자 지정 CSS가 필요 없습니다.

HUD가 실행되는 동안 JoyPro는 OBS 브라우저 소스용으로 이 PC에서만 HUD를 웹 페이지로 제공합니다: 투명 배경이며 사용자 CSS는 없습니다.

체크하면 복사가 있는 주소와 포트가 아래에 표시됩니다.

자세히 보기(영어)

#복사

버튼작성됨

OBS 페이지 주소를 클립보드에 복사합니다.

OBS에서: Sources > + > Browser를 열고 URL로 붙여 넣은 뒤 너비 1920, 높이 1080으로 설정하세요.

자세히 보기(영어)

#스트림 창 (창 캡처)

체크 상자작성됨

툴팁 별도의 창이며 맨 위에 표시되지 않으므로 게임 뒤에 있어도 됩니다. OBS에서: 캡처 방식이 Windows 10 (1903 이상)인 창 캡처를 사용하세요. 크로마 키 색상을 쓰는 경우 크로마 키 필터를 추가하세요.

HUD가 실행되는 동안 OBS의 창 캡처용으로 별도 창을 엽니다. 배경은 투명하거나 아래에서 고른 크로마 키 색입니다.

OBS에서: 캡처 방식은 Windows 10으로 하고, 색을 쓸 때는 Chroma Key 필터를 추가하세요.

자세히 보기(영어)

#내 화면에 표시

체크 상자작성됨

목록에 있는 위젯의 모니터 체크: 내 화면에 표시합니다.

자세히 보기(영어)

#스트림에 표시

체크 상자작성됨

목록에 있는 위젯의 OBS 체크: 스트림에 표시합니다.

자세히 보기(영어)

#장치 새로 고침

버튼작성됨

연결된 장치를 다시 읽습니다: 새 장치는 위젯을 받고, 이미지와 버튼 이름이 새로 고쳐집니다.

장치를 연결한 뒤에 사용하세요.

자세히 보기(영어)

#모두 표시

버튼작성됨

내 화면용으로 모든 위젯을 체크합니다. 원하지 않는 것은 목록에서 체크를 해제하세요.

자세히 보기(영어)

#자동 정렬

버튼작성됨

툴팁 스로틀과 왼손 장치는 왼쪽, 페달은 가운데, 오른손 스틱은 오른쪽, 아래쪽을 따라 배치

화면에 표시되는 장치 위젯을 아래쪽에 배치합니다: 스로틀과 왼손 장치는 왼쪽, 페달은 가운데, 오른손 스틱은 오른쪽이며, 들어가지 않는 것은 한 줄 위로 갑니다.

새 위치는 유지됩니다.

자세히 보기(영어)

#위치 초기화

버튼작성됨

모든 위젯을 기본 위치와 크기로 되돌립니다. 각 위젯이 표시하는 내용은 남습니다.

자세히 보기(영어)

#›

버튼작성됨

툴팁 다음 스타일

HUD를 스타일 목록의 다음 항목으로 바꿉니다.

자세히 보기(영어)

#강조 색상

버튼작성됨

스타일에 이 강조 색을 줍니다. HUD는 즉시 적용하며, 저장할 때까지 스타일은 "사용자 디자인"으로 표시됩니다.

자세히 보기(영어)

#이름 굵게

체크 상자작성됨

위젯 이름을 굵게 표시합니다. 스타일의 일부이므로 저장할 때까지 "사용자 디자인"으로 바뀝니다.

자세히 보기(영어)

#스타일 저장

버튼작성됨

현재 디자인을 옆에 입력한 이름으로 내 스타일로 보관하고 HUD의 스타일로 만듭니다.

프리셋 이름은 거부됩니다. 같은 이름의 내 스타일은 바뀝니다.

자세히 보기(영어)

#스타일 가져오기...

버튼작성됨

스타일 파일을 읽어 내 스타일 중 하나이자 HUD의 스타일로 만듭니다.

이미 쓰는 이름에는 번호가 붙습니다.

자세히 보기(영어)

#스타일 내보내기...

버튼작성됨

현재 디자인을 공유하거나 보관할 스타일 파일로 저장합니다. HUD는 바뀌지 않습니다.

자세히 보기(영어)

#변경 취소

버튼작성됨

툴팁 위에서 고른 스타일로 되돌리기

디자인을 직접 바꾸기 전의 스타일로 되돌립니다: 마지막으로 고르거나 저장하거나 가져온 스타일입니다.

자세히 보기(영어)

#삭제

버튼작성됨

고른 내 스타일을 삭제합니다. 그 스타일을 쓰던 위젯은 HUD의 스타일로 돌아가고, HUD는 현재 모양을 유지합니다.

자세히 보기(영어)

#장치 및 버튼 표시

체크 상자작성됨

버튼의 기능의 각 줄 아래에 장치와 버튼을 추가합니다.

자세히 보기(영어)

#게임 실행 중에만

체크 상자작성됨

지원되는 게임이 실행 중일 때만 버튼의 기능 줄을 표시합니다. 끄면 바탕 화면에서도 표시됩니다.

자세히 보기(영어)

#클릭 통과 (시작 시 적용)

체크 상자작성됨

마우스 클릭은 HUD 창을 통과해 게임으로 전달됩니다.

HUD가 시작될 때 적용됩니다: 이것을 바꾼 뒤에는 HUD를 중지했다가 다시 시작하세요.

자세히 보기(영어)

#DCS 후크 설치

버튼작성됨

DCS 후크를 설치합니다: Scripts\JoyProOverlay.lua와 Export.lua에 보호된 한 줄입니다.

먼저 DCS를 닫으세요.

자세히 보기(영어)

#제거

버튼작성됨

DCS 후크를 다시 제거합니다: Export.lua는 바이트 단위로 이전과 같아집니다.

먼저 DCS를 닫으세요.

자세히 보기(영어)

#확인

버튼작성됨

설정의 DCS 폴더에 DCS 후크가 설치되어 있는지 확인합니다.

아무것도 바꾸지 않습니다.

자세히 보기(영어)

#내 화면

옵션작성됨2 ×

내 화면 / 스트림: 디자이너 미리 보기에 표시할 것으로, 내 화면용으로 체크한 위젯 또는 스트림용으로 체크한 위젯입니다.

미리 보기만 바뀌며, 선택은 다음 시작 때도 유지됩니다.

자세히 보기(영어)

#스트림에 표시

체크 상자작성됨

선택한 위젯을 스트림에 표시합니다: OBS 페이지와 스트림 창입니다.

자세히 보기(영어)

#이름

체크 상자작성됨

위젯에 장치 이름을 표시합니다.

#이미지

체크 상자작성됨

게임 헤더 위젯: 게임이나 DCS 기체의 이미지를 이름 옆에 표시합니다.

#종류 (스틱, 스로틀)

체크 상자작성됨

장치 이름 아래에 장치 종류를 표시합니다.

자세히 보기(영어)

#스틱에 따라 이미지 기울이기

체크 상자작성됨

실제 스틱이 움직이는 것처럼 장치 이미지를 스틱에 따라 기울이고 비틉니다.

#버튼 점등

체크 상자작성됨2 ×

장치 위젯: 누르고 있는 버튼이 켜집니다. 기체 위젯: 내가 누른 버튼에 해당하는 기체의 조작 장치가 스틱이나 스로틀에서 켜집니다.

자세히 보기(영어)

#누르고 있는 버튼 이름

체크 상자작성됨2 ×

장치 위젯: 누르고 있는 버튼이 장치 카탈로그의 이름과 함께 칩으로 표시됩니다.

기체 위젯: 누르고 있는 기체의 조작 장치가 그립 아래에 이름으로 표시됩니다.

자세히 보기(영어)

#축과 레버

체크 상자작성됨2 ×

장치 위젯: 모든 축과 레버가 막대로 움직입니다.

기체 위젯: 스로틀 옆에 레버 위치를 나타내는 막대가 표시됩니다.

자세히 보기(영어)

#축 값

체크 상자작성됨

각 축의 값을 막대 옆에 씁니다.

#스틱 위치 (짐벌)

체크 상자작성됨2 ×

스틱 요소를 표시합니다: 스틱 위치에 있는 원 안의 점과, 비틀기를 나타내는 눈금입니다.

자세히 보기(영어)

#햇

체크 상자작성됨

햇을 표시합니다. 누른 방향이 켜집니다.

#스틱

체크 상자작성됨

기체 위젯: 기체 자체의 스틱 이미지를 표시하며, 내 스틱에 따라 기울어집니다.

#스로틀

체크 상자작성됨

기체 위젯: 기체 자체의 스로틀 이미지를 표시하며, 스로틀의 첫 번째 레버에 따라 움직입니다.