notParsec / 문서전체 문서

설명·설계 문서

Windows Parsec 150-104a 기반 UI 복구

design/UI_RECOVERY.ko.md

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

이 문서의 목차

2026-09-24. 적용 대상은 같은 notparsec.exe의 Computers·Settings·탐색 메뉴·상단 기기 표시다. 렌더링 미리보기, 검증 기록. 2026-10-02의 간격·긴 이름·오류 표시 후속 수정은 클라이언트 배치 점검에 기록한다.

이전 화면은 150-83c 참고 이미지와 자체 아이콘·폰트·가변 카드 크기를 사용했다. 이번 변경은 보관한 150-104a DLL의 실제 이미지·폰트 및 디컴파일된 그리기 함수를 기준으로 교체한다. 사용자 승인·비밀번호 모달·관리자 서버 연결은 유지한다.

출처와 복구 방법

기준 DLL SHA-256: 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f.

재현: python3 analysis/parsec/scripts/recover_ui_assets.py --check. 입력은 정확한 baseline DLL이어야 하며 다른 버전은 거부한다.

원본 함수 → 구현 대조

수치는 DPI 적용 전 기준이다. 색상은 원본 ImGui의 packed ABGR을 RGB로 해석했다.

영역 원본 근거 이번 구현
기본 배치 180033bb0, 180032300 폭 768 초과: 왼쪽 64 탐색. 768 이하: 아래 64 탐색과 가로형 PC 카드. 상단 64
탐색 아이콘 180031f40, 180032300 실제 아이콘 폰트 Computers EA03, Settings EA07, Friends EA1D, Help EA04. 50×50 원형 영역·아이콘 24·세로 간격 12
배경·강조색 180033bb0, 18000c2e0 본문 #29292a, 탐색/카드 받침 #212224, 선/자기 PC #38383a, 글자 #f9fafc, 파랑 #25abff, Setup 주황 #ffae11
제목·본문 1800093b0, 180034ca0, 180033640 원본 Source Sans Pro Light 68, Regular 20/16, Bold 20/16. 한국어는 설치된 Malgun의 누락 글리프 보완
글꼴 크기 환산 TTF head/hhea, ImGui stb, egui 0.33 FontExt Source Sans는 units/em=1000, ascent=984, descent=-273. 원본 pixel-height를 egui em으로 1000/1257 환산. 같은 숫자만 지정해 글자가 커지던 차이 제거
제목 영역 180033640, 1800339d0 위 10, 부제 왼쪽 5, 부제 뒤 15, 구분선 3, 도구 모음 전후 15
카드 받침 180033bb0, 18002c800 안쪽 여백 40, 카드 간격 20, 둥근 모서리 12. 폭 기반 열 수 1–5개. 카드가 적어도 원본 열 수 규칙 유지
데스크톱 카드 18002ad10 220×280. 이미지 110×110, 위 30. 카드 내 좌우 20, 이름 Bold 20, 두 번째 줄 Regular 16, 버튼 180×36
작은 창 카드 18002ad10 높이 75, 좌우 바깥 여백 7.5%, 아바타 46, 이름 왼쪽 86, 오른쪽 버튼 95×36
PC 그림 18002ad10 자기 PC 1802ea4a0, 상대 PC 1802c1b50의 PNG 원본 사용. 상대 이미지 안에 원본 기본 아바타 합성. 팀 PNG는 추출하되 팀 기능 구현을 주장하지 않음
검색·Reload 18002c4a0, 18002ce40, 18000c050 검색 아이콘 EA0B, 검색 폭 비율 47%, 오른쪽 Reload, 검색 결과 없음·Clear Search·갱신 대기
설정 탭 1800192e0 Client, Host, Approved Apps, Network, Hotkeys, Gamepad, Account 순서. Regular 20 / 선택 Bold 20, 간격 20
설정 행 180012c50, 180010cf0, 180011100, 180012140 최대 폭 750, 설명/조작을 절반씩 배치, 가운데 여백 20씩, 설명 Regular 16, 행 뒤 40
연결 동작 기존 E01 모달 구현 Connect 클릭 시 해당 기기 비밀번호 모달. 빈 입력/오프라인 차단, Enter 연결·Esc 취소·비밀번호 삭제 유지

Computers의 연결 버튼은 실제 hosting·목록 유효 기간·진행 중 작업 상태를 사용한다. 자기 PC의 Setup은 같은 앱의 Host 설정으로 이동하며, 설정값은 기존 실행 엔진과 저장 경로에 연결된다. 개발용 카탈로그는 Console의 접힌 영역으로 이동했다. UI를 바꾸기 위해 새 장치 신원이나 자격 증명을 만들지 않는다.

예외·남은 차이

F24/F64의 parity는 different, 구현·시험은 partial로 유지한다. 정적 함수·자원 비교와 자체 동작 시험을 전체 원본 일치 판정으로 올리지 않는다.

검증·적용

재현 명령:

python3 analysis/parsec/scripts/recover_ui_assets.py --check
cargo test -p notparsec-desktop-ui --locked
cargo run -p notparsec-desktop-ui --example recovered_ui_preview --features ui-preview --locked -- /tmp/notparsec-recovered-ui
python3 design/build_ui_recovery.py

일반/좁은 창과 100/150/200% 배율에서 실제 Connect 영역·클릭·탐색 위치를 검사한다. 정상 기기 선택, 오프라인 차단, 검색 결과·초기화·Reload, 기존 비밀번호 모달 시험을 수행한다. Windows 교차 빌드와 정적 분석은 별도 로그로 보관한다. 미리보기 렌더러는 Linux 소프트웨어 Vulkan이며 Windows D3D11 실기 캡처가 아니다.

최종 EXE hash·빌드 번호·배포 여부는 검증 기록을 따른다. 현재 작업 폴더의 기존 Direct UDP /6 변경을 함께 포함하므로 연결하는 양쪽 PC를 같은 버전으로 업데이트해야 한다. 해당 전송 변경의 별도 근거와 한계는 Direct UDP 문서에 남아 있다.