#오버레이 전환
버튼작성됨HUD 시작 / HUD 중지: 위에서 체크한 출력으로 HUD를 시작합니다: 필요하면 장치를 읽고, 실행 중인 게임을 찾아 그 바인딩을 불러옵니다.
다시 누르면 모든 출력을 닫습니다.
HUD는 스트리머의 컨트롤러 오버레이처럼 게임하는 동안 화면에 장치를 보여 줍니다. 스틱 이미지는 스틱과 함께 기울고, 레버와 축은 막대로 움직이며, 누르고 있는 버튼은 이름과 함께 불이 들어오고, 한 줄에 누른 버튼이 실행 중인 게임에서 하는 일이 나옵니다("Gear Toggle"). 게임 위, OBS, 또는 둘 다에 보일 수 있으며, 각각 자체 위젯을 가집니다. 이 페이지는 그 디자이너입니다.


flowchart LR D["내 장치"] --> P["HUD"] O["게임 안의<br/>내 바인딩"] --> P P --> S["내 화면"] P --> B["OBS용 페이지"] P --> W["방송 창"]
HUD 중지(같은 버튼)는 HUD를 닫습니다. 여기서 설정한 모든 것은 유지되며 다시 시작한 뒤에도 그대로 있습니다.
미리 보기에서 위젯을 끌어 옮기고, 클릭하면 오른쪽에서 바꿀 수 있습니다. 자동 정렬은 위젯을 아래쪽을 따라 놓습니다: 스로틀과 왼손 장치는 왼쪽, 페달은 가운데, 오른손 스틱은 오른쪽.


HUD 창은 투명하며, 창 모드와 테두리 없는 창 모드 게임 위에 떠 있습니다. 클릭은 창을 통과해 게임으로 갑니다. 작업 표시줄이나 Alt+Tab에는 나오지 않습니다. 전용 전체 화면에서는 가려집니다(Windows의 한계). 게임을 테두리 없는 창 모드로 바꾸세요. 누른 버튼의 줄에는 그 게임과 기체의 동작 이름이 나옵니다. 예: F-16C에서는 "Weapon Release", IL-2에서는 "Fire guns".
세 가지 출력은 서로 독립적입니다:
| 출력 | 대상 | 방식 |
|---|---|---|
| 내 화면 (게임 위) | 나 | 게임 위에 뜨는 투명한 창 |
| OBS용 페이지 (브라우저 소스, 투명) | 내 방송(권장) | JoyPro가 이 PC에서만 페이지를 제공합니다. 복사는 그 주소를 클립보드에 넣습니다 |
| 스트림 창 (창 캡처) | 창 캡처로 방송하는 경우 | 투명 또는 크로마 키 배경의 일반 창(게임 뒤에 있어도 됨) |
내 화면의 체크를 해제하면 방송에는 HUD가 나오면서 내 화면은 깨끗한 채로 플레이할 수 있고, 각각에 다른 위젯을 보여 줄 수도 있습니다. 위젯마다 체크가 두 개 있습니다: 모니터(내 화면)와 OBS(방송). 미리 보기: 내 화면 / 스트림은 디자이너가 보여 주는 것을 바꿉니다. 초당 최대 업데이트 횟수(15, 30 또는 60. 30이면 부드럽고 가볍습니다).
http://127.0.0.1:8765/hud) 옆의 복사를 누르세요.이 페이지는 방송용으로 체크한 위젯을 앱과 같은 위치와 스타일로, 소스 크기에 맞춰 늘어나는 1920 x 1080 무대 위에 그립니다. 다른 프로그램이 포트를 쓰고 있나요? 포트에서 다른 포트를 고르고 주소를 다시 복사하세요.


대신 창 캡처 쓰기: 스트림 창을 체크하고 배경(투명, 초록, 자홍, 파랑 또는 원하는 색)을 고르세요. 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 | 위젯, 위치, 스타일이 바뀌면 레이아웃을 다시 보냅니다. |
위젯에는 모든 장치와 헤더, 바인딩 티커, 기체 위젯이 나열됩니다. 장치 새로 고침은 연결된 장치를 다시 읽고, 모두 표시는 모든 위젯을 내 화면용으로 체크하며, 자동 정렬과 위치 초기화는 위젯을 제자리에 놓습니다.
위젯마다(미리 보기나 목록에서 클릭):


기체 위젯: 스틱, 스로틀, 스로틀 이동 막대, 스틱 위치, 조작부 점등, 누르고 있는 조작부 이름. 기체(자동: 지금 비행 중인 기체, 또는 이 PC에 설정된 아무 이미지)와 연동 대상(위젯을 움직이는 스틱과 스로틀). 이미지는 게임 자체의 조종석 이미지(조종석 > 내 게임에서 이미지 만들기, 또는 이미지 팩)에서 오며, 없으면 실제 그립을 JoyPro가 선으로 그린 도면을 씁니다.
스타일에는 프리셋 40개가 있습니다: 글래스, 네온, 미니멀, 깔끔한 것(반투명 유리 (밝게), 스트리머 깔끔, 스트리머 굵게, 컴팩트, 큰 글자, 파스텔, 윤곽선만), 조종석 디스플레이(밀리터리 그린 HUD, 앰버 MFD, 여객기 PFD, 글래스 콕핏, 야간 투시, 붉은 조종석 조명, 벡터 와이어프레임, 레트로 터미널, 워버드, 홀로그램), 게임과 장르(우주 시뮬 오렌지, 홀로 시안, 사이버펑크, 신스웨이브, 네온 핑크, 레이싱, 전술 황갈색, 네이비 & 골드, 스텔스, 고스트), 색 테마(북극, 사막, 바다, 노을, 로열, 카본), 가독성(고대비, 고대비 (밝게), 단색, 단색 (밝게)). **›**를 누르면 다음 스타일로 넘어갑니다.


아래에는 한 번의 클릭으로 고르는 강조 색, 강조, 눌림, 불투명도가 있고, 그다음 요소별 디자인 옵션이 있습니다: 카드(배경, 테두리, 모서리, 그림자), 텍스트(글꼴, 크기, 자간, 색, 이름 굵게), 스틱 표시(링, 사각형, 십자선, 레이더, 점. 크기, 빛), 막대와 레버(모양, 높이, 빈 부분), 버튼과 칩(모양). 옵션을 하나라도 바꾸면 스타일이 "사용자 디자인(변경됨)"이 됩니다. 스타일 저장은 그것을 내 이름으로 보관하고, 변경 취소는 프리셋으로 돌아가며, 스타일 내보내기... / **스타일 가져오기...**는 파일로 공유하고, 삭제는 내 스타일을 지웁니다.
버튼의 기능: 줄 수, 표시 시간(초), 글꼴 크기, 장치 및 버튼 표시, 게임 실행 중에만. 클릭 통과는 마우스 클릭이 HUD 창을 통과하게 합니다(HUD를 시작할 때 적용).
JoyPro는 실행 중인 게임을 프로세스로 찾아(DCS, IL-2, Star Citizen 및 JoyPro가 다루는 다른 모든 게임) 그 게임의 바인딩만 보여 줍니다. DCS는 기체도 알아야 합니다. DCS 기체에서 고르거나, DCS 후크 설치로 미션을 시작할 때마다 DCS가 JoyPro에 기체를 알려 주게 하세요(작은 Lua 파일과 Export.lua에 보호된 줄 하나. 먼저 백업합니다. 제거는 파일을 바이트 단위로 그대로 되돌립니다. 먼저 DCS를 닫으세요). 확인은 후크가 설치되어 있는지 알려 줍니다.


뷰 모델: 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): 수정키와 이름이 붙은 바인딩된 버튼. 수정키가 있는 바인딩은 그 수정키를 누르고 있는 동안 표시되며, 맞는 수정키가 가장 많은 바인딩이 우선합니다.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가 계속 표시되고 내 화면은 깨끗하게 유지됩니다.
툴팁 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는 현재 모양을 유지합니다.
버튼의 기능의 각 줄 아래에 장치와 버튼을 추가합니다.
지원되는 게임이 실행 중일 때만 버튼의 기능 줄을 표시합니다. 끄면 바탕 화면에서도 표시됩니다.
내 화면 / 스트림: 디자이너 미리 보기에 표시할 것으로, 내 화면용으로 체크한 위젯 또는 스트림용으로 체크한 위젯입니다.
미리 보기만 바뀌며, 선택은 다음 시작 때도 유지됩니다.
선택한 위젯을 내 화면에 표시합니다.
선택한 위젯을 스트림에 표시합니다: OBS 페이지와 스트림 창입니다.
위젯에 장치 이름을 표시합니다.
게임 헤더 위젯: 게임이나 DCS 기체의 이미지를 이름 옆에 표시합니다.
장치 이름 아래에 장치 종류를 표시합니다.
장치 이미지를 표시합니다.
실제 스틱이 움직이는 것처럼 장치 이미지를 스틱에 따라 기울이고 비틉니다.
장치 위젯: 누르고 있는 버튼이 켜집니다. 기체 위젯: 내가 누른 버튼에 해당하는 기체의 조작 장치가 스틱이나 스로틀에서 켜집니다.
각 축의 이름을 막대 옆에 씁니다.
각 축의 값을 막대 옆에 씁니다.
스틱 요소를 표시합니다: 스틱 위치에 있는 원 안의 점과, 비틀기를 나타내는 눈금입니다.
햇을 표시합니다. 누른 방향이 켜집니다.
기체 위젯: 기체 자체의 스틱 이미지를 표시하며, 내 스틱에 따라 기울어집니다.
기체 위젯: 기체 자체의 스로틀 이미지를 표시하며, 스로틀의 첫 번째 레버에 따라 움직입니다.