pqp

클린룸 스켈레톤 플레이어의 구현 경계와 블랙박스 검증

a6850516bdba79d26ec3aec3b89ec829c65672b2 · CI

{"commit_date":"2026-11-08T11:12:24Z","status":"completed","conclusion":"success","observed":"2026-11-16"}

1. 문제 정의와 입력 데이터 포맷

2D 게임에서 뼈대(스켈레톤) 기반 애니메이션을 웹 브라우저로 재생하려면 바이너리 골격 데이터와 텍스처 아틀라스를 해석해 시간축에 따라 관절 변형을 계산해야 합니다. portfolio.pqp.me/#skeleton에 소개된 클린룸 스켈레톤 플레이어는 Spine 4.2 규격의 .skel 파일과 .atlas 파일을 입력으로 받아 독립적으로 파싱하고 애니메이션을 실행하는 사례를 다룹니다.

2. 독립 구현의 경계와 기록 방식

기존 상용 런타임 코드를 그대로 가져다 쓰지 않고 독립 구현을 진행할 때는 무엇을 참고했고 무엇을 배제했는지 경계를 분명히 하는 것이 중요합니다. 프로젝트 설명에 따르면 이 구현은 포맷 문서, 수학적 변환 공식, 공개 API 동작 관찰, 그리고 작업 과정을 기록한 cleanroom_log.md를 근거로 작성되었습니다.

또한 데이터 분리 원칙에 따라 원본 게임의 리소스 데이터는 공개 저장소(github.com/moooohung/sts-skeleton-player)에 포함하지 않습니다. 이러한 작업 기록은 개발 과정의 투명성을 높이기 위한 프로젝트 문서이며, 제3자 법률 기관이 공식 독립 감사를 수행했다는 의미로 해석해서는 안 됩니다.

3. 그래픽 백엔드 선택과 렌더러 폴백

웹 브라우저는 운영체제, 그래픽 드라이버, 브라우저 설정에 따라 지원하는 그래픽 API가 다릅니다. 이를 처리하기 위해 플레이어는 출력 대상을 WebGPU → WebGL → Canvas2D 순서로 폴백(단계적 전환)하도록 설계되었습니다.

최신 GPU 가속 API인 WebGPU를 우선 시도하고, 환경이 지원하지 않으면 WebGL로 내려가며, 두 환경 모두 사용할 수 없는 경우 기본 2D 캔버스인 Canvas2D로 렌더링을 이어 갑니다. 이 구조는 다양한 브라우저 환경에서 화면 출력을 유지하기 위한 선택이지만, 모든 기기에서 일정한 프레임 속도(FPS)나 모바일 환경을 보증하는 장치는 아닙니다.

4. 블랙박스 비교 검증의 역할과 수치 해석

독립 구현에서 가장 까다로운 부분은 미세한 보간 오차나 본(Bone) 계층 계산 차이를 찾아내는 일입니다. 이를 확인하기 위해 프로젝트는 내부 코드를 들여다보지 않고 같은 입력에 대한 출력 결과를 대조하는 블랙박스 비교 검증을 수행했습니다. 공개 페이지에 보고된 프로젝트 자체 검증 수치는 다음과 같습니다.

이 수치들은 검증에 사용된 테스트 세트와 85만여 프레임 구간에서 기대 출력과 일치했음을 보여 주는 중요한 지표입니다. 그러나 테스트 케이스 통과 수치가 세상에 존재하는 모든 Spine 4.2 파일과 특이 케이스에서 예외가 전혀 발생하지 않음을 수학적으로 증명하는 것은 아닙니다.

5. 독자가 체험할 수 있는 부분과 한계

portfolio.pqp.me/#skeleton의 인터랙티브 데모에서는 독자가 직접 STS2 캐릭터 5종을 선택하고, 동작(액션) 전환, 전체 애니메이션 목록 탐색, 재생 속도 조절, 렌더러 전환(WebGPU·WebGL·Canvas2D)을 시험해 볼 수 있습니다.

정리하면, 클린룸 플레이어는 파일 포맷 파싱, 단계적 렌더러 폴백, 대규모 프레임 단위 블랙박스 검증이 어떻게 결합되는지 보여 주는 기술 사례입니다. 다만 라이선스의 법적 안전성을 최종 판단하거나 특정 기기 성능을 보증하는 자료는 아니므로, 공개된 검증 수치의 범위 안에서 참고하는 것이 적절합니다.