notParsec / 문서전체 문서

설명·설계 문서

원격 화면 플로팅 메뉴 · Parsec 대조와 구현

design/PARSEC_OVERLAY_COMPARISON.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

후속 구현: 다중 화면·자체 VDD·프라이버시 개발 과정에서 /7 화면 추가·전환·별도 창을 연결했습니다. 아래 단일 모니터/비활성 메뉴 설명은 최초 구현 당시의 기록입니다.

2026-09-24 후속: D3D11 직접 표시 변경에서 영상 CPU readback·Glow 재업로드를 제거하고 큐/표시 계측을 추가했습니다. 아래 이전 구현 설명과 수치의 시점을 구별하세요. 실제 Windows GPU·원본 성능 대조는 아직 미검증입니다.

후속 갱신: F15 영상 복구에서 자체 프로토콜을 /4로 올렸다. 아래 /3은 메뉴 구현 당시의 기록이며 새 빌드와 호환되지 않는다.

확인일: 2026-09-24. 대상 F35/F51/F52/F68, U20/U21/U23/U25/U26. 부분 구현 / 원본과 차이 있음. F36 다중 모니터는 구현하지 않았다.

사용 방법

동일한 새 notparsec.exe를 접속하는 PC와 접속받는 PC에 설치한다. 두 역할은 여전히 한 실행파일이다. 기기 승인·비밀번호 인증 후 원격 화면은 기본 전체 화면으로 열린다. 앱의 탐색 메뉴와 상태 표시줄은 원격 화면을 가리지 않는다.

Escape는 메뉴가 열렸을 때 메뉴를 닫는다. 메뉴가 닫혀 있을 때에는 원격 PC로 전달한다. 메뉴 버튼, 하위 메뉴, 그래프를 조작할 때의 클릭·키와 로컬 단축키는 원격 PC에 보내지 않는다. 이미 보낸 키/버튼은 ReleaseAll로 해제한다.

고정 원본과 출처 구별

기준은 Windows Parsec 150-104a, 보관 분석의 코어 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 이번 환경의 DLL은 Git LFS 포인터이므로 새 바이너리 실행·재해시가 아니라 저장된 분석 결과를 참조했다. 원본 전체 소스 복원이 아니다. 아래 함수는 디컴파일 의사 코드, 구현은 별도로 작성한 Rust/egui 코드다.

근거 확인한 내용
180027800 40×40 버튼, 흰색과 붉은 아이콘, radius 4, viewport 내 제한, 좁은 화면의 위쪽 여백
180027550, 180029830 드래그와 클릭 구별, 좌표 정규화·저장, 초기 위치 읽기
180021930 행 간격 33, 텍스트·단축키 폭 계산, 화면 위치에 따른 메뉴 방향
180025e30 기본 메뉴 순서, 세션 숨김, 창 모드, 음소거, 조건부 Devices/화면 항목/Guests, Video Settings, Metrics Graphs, Disconnect
180023110 Immersive 임시 Toggle와 저장된 모드
1800241b0 영상 하위 메뉴 순서, 해상도·대역폭 목록, H.264 / Prefer H.265, decoder, 4:4:4, 10-bit, Constant FPS와 변경 콜백
180025b20 Basic Performance / Audio Performance / Advanced Metrics
설정 근거 client_overlay=true, client_windowed=false, button x=60000000/y=80000000 (정규화 6%/8%), client_immersive=0

공식 Overlay 설명과 첨부 화면을 시각적으로 확인했다. 첨부 화면의 Windows 시계는 2022-09-19이고 앱 버전·DPI는 표시되지 않는다. 이 화면은 Codec/Decoder 등을 주 메뉴에 직접 놓는 이전 배치다. 150-104a의 Video Settings 그룹과 동일 버전 화면으로 취급하지 않았다. 흰 버튼, 검은 메뉴, 좌측 아이콘/우측 단축키·화살표, 붉은 Disconnect, 상단 성능 표시의 참고다. 단축키는 공식 Hotkeys 설명과 함께 확인했으며 사용자 지정 키 전체 매핑은 남은 작업이다.

실제 적용 범위와 차이

항목 이번 구현 원본과의 차이 / 남은 작업
버튼·메뉴 40px, radius 4, 33px 행, RGB(24,24,26) 배경 / (249,250,252) 글자 / (238,61,49) Disconnect. 6%/8% 초기 위치, 드래그·저장·세션 숨김 독립 제작 벡터 아이콘과 egui 글꼴. 폭 290px 기준이며 원본의 동적 폭·font atlas·DPI별 배치와 픽셀 일치 미검증. 드래그 시작 임계값은 egui 사용
전체 화면 기본 전체 화면, 창 모드 전환·저장, 종료 후 이전 상태 복원 실제 Windows 모니터/DPI/작업 표시줄 동작 미검증
Resolution 원본의 Client/Host + 15개 크기 선택을 노출. 실제 캡처 종횡비를 보존하며 선택 크기 이내로 GPU 축소, 최대 3840×2160 호스트 디스플레이 모드는 변경하지 않는다. 원본 해상도 변경·회전·다중 화면과 다름. 업스케일 안 함
Bandwidth Limit 원본의 3/5/7/10/15/20/25/30/35/40/45/50Mbps를 GPU 인코더에 적용 VBR 목표값이며 순간 전송률의 엄격한 상한은 아님. 전송 적응 정책은 원본과 다름
Codec H.264 또는 Prefer H.265. 클라이언트에서 실제 프로브한 decoder와 호스트 encoder 양쪽을 확인, HEVC 실패 시 H.264 NVIDIA NVENC / 나머지 hardware MFT. 코덱 차이 유지
Decoder 자동 선택한 hardware 사용 표시 vendor별 수동 선택·Software decoder 없음
Constant FPS 꺼짐: 바뀐 화면 중심 + 1초 keepalive. 켜짐: 정지 화면도 요청 최대 60fps로 제출 GPU·대역폭·처리 속도에 따라 실제 FPS는 낮을 수 있음. Parsec 타이밍 완전 일치 미검증
Immersive Mouse confinement, Off, 임시 Toggle Keyboard/Both는 비활성. 시스템 키 hook·상대 마우스/게임 조작 미구현
성능 메뉴가 열렸을 때 상단 codec/실제 협상 크기/4:2:0/8-bit 표시. 입출력 timestamp를 대응한 프레임 시간·호스트 Encode·중계 RTT·payload bitrate·단계별 FPS와 Basic 그래프 Decode는 GPU readback/변환을 포함. Encode는 호스트 입력 준비부터 압축 출력까지. Network는 서버 중계 RTT이며 P2P와 다름. 측정 경계·미검증을 따르며 그래프는 원본 전체 시리즈/배치와 다름
그 밖의 항목 Chat, Sound, Add Screens, CTRL+ALT+DEL, 4:4:4, 10-bit, 미지원 그래프는 비활성+이유. Switch Display는 현재 주 화면 하나 원본의 조건부 항목을 일부 비활성으로 보여주는 차이. 미구현 기능 완료로 세지 않음. 원본 Devices/Guests는 현재 지원·참여자 정보가 없어 표시하지 않음

기능을 최종 제외하거나 예외로 승인한 기록이 아니다. 해당 기능 구현과 원본 대조가 남아 있다. 원본의 전체 Hotkeys 사용자 매핑도 아직 없다. 영상·오버레이 저장값은 현재 앱 프로필 공통이며 원본의 스트림별 설정 슬롯과 다르다.

연결 중 설정 변경

UI → 뷰어 → 인증된 세션 → GPU encoder로 연결했다.

  1. 프로브한 코덱과 제한된 해상도/대역폭으로 설정 요청을 만든다. 한 번에 하나만 처리하며 UI 변경 중복을 막는다.
  2. 호스트는 원격 입력을 해제하고 새 색 변환기/encoder를 먼저 생성한다. 초기화에 실패하면 기존 encoder와 설정을 유지하고 이유를 응답한다. NVIDIA 동시 encoder 세션 한도가 낮으면 이 단계에서 변경이 거절될 수 있다.
  3. 성공 응답과 새 Format을 영상과 같은 순서 보장 큐에 넣는다. 이 앞은 이전 encoder의 패킷, 이 뒤는 새 IDR/헤더부터의 패킷이다. 전체 packet sequence는 연속이다.
  4. 클라이언트 decode worker가 해당 경계에서 decoder를 교체한 뒤 새 영상을 디코딩한다. UI는 성공 응답 후에만 설정을 저장한다. decoder 교체 실패는 연결 종료 오류로 표시한다.
  5. 호스트는 500ms 이내 연속 변경을 거절하고, 클라이언트는 응답이 없으면 15초 제한으로 종료한다. 인증·기기 승인·접속 비밀번호·lease와 해제 처리는 유지한다.

이것은 기존 자체 프로토콜을 확장한 **notparsec-remote/3**이며 Parsec BUD 프로토콜을 복원한 것이 아니다. 이전 /2 EXE와 호환되지 않으므로 양쪽 앱을 업데이트해야 한다. 서버는 암호화된 중계만 계속 수행한다. CPU readback·egui 표시·WSS 중계 차이도 그대로 남아 있으며 이번 UI 변경으로 프레임 드롭이 해결되었다고 주장하지 않는다.

검증과 재현

실제 검증은 두 PC를 같은 EXE hash로 갱신한 뒤 메뉴 열기·드래그·숨김/복원·화면 모드 전환·5↔20Mbps·H.264↔Prefer H.265·720p↔Client·Constant FPS를 순서대로 적용하고, 호스트 키/마우스 오동작과 영상 재개/오류를 확인한다. 변경 실패 시 이전 영상 유지도 확인한다.

빌드와 게시 상태

실제 EXE hash·빌드 번호·검사와 미검증 항목은 검증 기록에 있다. 현재 배포 번들은 dist/gpu-update-preview이며 이전 번들은 backups에 보존했다. 운영 게시에는 sudo 비밀번호가 필요해 이 작업에서 자동 적용하지 못했다.

sudo /home/ahn/notparsec/dist/gpu-update-preview/apply.sh

게시 후 관리자 다운로드와 자동 업데이트에 새 빌드가 노출된다. Ctrl+Shift+M 메뉴를 확인하려면 양쪽 PC를 새 EXE로 업데이트한다.