---
title: Pixel Camera 독립 도구 구현과 실행 검증
date: 2026-10-31T18:31:59.379Z
version: v1.0.5
status: 작업 중
state: progress
project: turnroom
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 공통 템플릿 창, 공유 프리셋, 카메라 픽셀화와 후순위 레이어를 구현합니다.
format: tracefolio-v2
priority: normal
manual_id: pixel-camera-20261101
round: 5
manual_state: active
payload: ../assets/submissions/2026-10-31-manual-pixel-camera-20261101-20261031183159379-v1.0.5.json
---

## 목표와 완료 기준

Pixel Camera 유료 제품용 기능 보완과 두 파이프라인 실제 검증

완료 기준: 기존 원래 기준을 유지하며 전체 12개 맵의 렌더·Play·Overlay UI, 작은 픽셀 프리셋, 실제 Affinity 로고 및 새 설정 창 디자인 검증을 추가합니다. 외곽선·격자 안정화·팔레트 실제픽셀 비교, Built-in 최적화 경로, URP17 RenderGraph 실제실행, 기존프리셋호환, 네이티브입력·Undo 검증.

후속 5회차 · 순차 진행 · 전체 6개 · 이번 실행 T02, T06, T03, T04, T05

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 템플릿과 렌더 환경 확인 | 템플릿 지침·API·Unity 버전·패키지 확인 | 실제 지원 범위와 상속 구조 확인 | 원본 문서와 소스·설정을 대조 | 완료 |
| T02 | 런타임과 프리셋 구현 | 프리셋, 저해상도 카메라 캡처, 색상 처리, 클리핑, 후순위 레이어 구현; 외곽선·격자 안정화·팔레트·자동 렌더 경로 구현 | 프리셋을 공유하고 장면 렌더링에 적용 | 실제 Unity 렌더 결과 픽셀 비교, 저장·재로드, 가림과 관통 대조 | 진행 |
| T06 | URP17 RenderGraph 통합 | 독립 통합 어셈블리·RendererFeature·설치 가이드·URP 테스트 프로젝트 구현 | URP17에서 실제 렌더와 새 효과 작동, Built-in 프로젝트는 URP 설치 없이 컴파일 | Unity6000.0.83f1/URP17.0.4 RenderGraph 실제 픽셀 비교와 샘플Play | 대기 |
| T03 | 템플릿 설정 창 | 공통 제목줄·입력·테마·미리보기·컴포넌트 적용; 카드 레이아웃·5단계 픽셀 버튼·Affinity 벡터 로고; 새 기능 카드 및 팔레트 Inspector | 독립 창에서 프리셋 편집과 적용 | 실제 Unity 창과 바인딩·Undo·저장 확인 | 대기 |
| T04 | 샘플·문서·패키지 | 12개 전체 맵, Overlay UI, 5개 해상도 프리셋, 9개 언어 문서 및 새 Unity 패키지; 상업용 기능 예제와 Built-in/URP 패키지 설치 검사 | 분리 설치 가능한 제품과 사용 안내; TurnRoom Assets 안에 실제 맵 씬이 존재하고 Unity 임포트·렌더·입력을 확인 | 샘플 실행 및 패키지 파일 목록, 실제 화면 대조 | 대기 |
| T05 | 최종 QA와 공개 보고 | 회귀 검증·실제 화면·공개 HTML 보고서 배포 | 검증 근거와 외부 접근 가능한 개별 보고서 | 빌드·링크·배포와 실제 공개 본문 확인 | 대기 |

## QA 반복 기록

### Q01 · step · 2026-10-31T15:38:53.4377559Z

템플릿과 프로젝트 설정 대조

- T01 r1 · pass: ToolWindow 상속, UITemplate.Apply/CreateDocumentChrome, Unity 6000.0.83f1 및 SRP 패키지 미설치 확인 · 근거: Docs/Development/TempleteGallery.md; TempleteRoadmap.md; Assets/TurnRoom/Templete/Editor/ToolWindow.cs; Packages/manifest.json; ProjectSettings/ProjectVersion.txt
### Q02 · step · 2026-10-31T15:42:18.9628348Z

미표시 검증 창 Close에서 NullReferenceException. 실제 UI 입력 QA가 아니라 검증 코드 수명 오류였습니다.

- T03 r1 · fail: 미표시 검증 창 Close에서 NullReferenceException. 실제 UI 입력 QA가 아니라 검증 코드 수명 오류였습니다. · 근거: qa.first.json
### Q03 · step · 2026-10-31T15:43:40.3659247Z

씬 전환으로 임시 RenderTexture가 해제되어 샘플 렌더 QA 실패. HideAndDontSave 수명 설정 후 재검증했습니다.

- T04 r1 · fail: 씬 전환으로 임시 RenderTexture가 해제되어 샘플 렌더 QA 실패. HideAndDontSave 수명 설정 후 재검증했습니다. · 근거: qa.second.json
### Q04 · step · 2026-10-31T15:44:45.5456507Z

클리핑 샘플의 근거리 평면이 비교 피사체까지 제거해 다중 색상 검사 실패. 샘플 클리핑 값을 수정했습니다.

- T04 r1 · fail: 클리핑 샘플의 근거리 평면이 비교 피사체까지 제거해 다중 색상 검사 실패. 샘플 클리핑 값을 수정했습니다. · 근거: qa.third.json
### Q05 · regression · 2026-10-31T16:01:18.3625227Z

모델 4종을 포함한 Unity 에디터 54개 검사 통과. 원래 UI 완료 기준의 실제 입력 검사는 미실행으로 구분합니다.

- T02 r1 · pass: 실제 렌더 픽셀·프리셋 저장·공유·클리핑·깊이 제어 통과 · 근거: qa.json: 54 checks passed, sourceHash 689d49094afa00ca2721f5736b227aa90aeb09c3a7e06696f38ba285017ca8de
- T03 r1 · not_run: 바인딩·직접 적용·Undo/Redo 통과. 실제 키보드·마우스와 테마 화면 검사는 보류 · 근거: qa.json 및 사용자 화면 전환 금지 요청
- T04 r2 · pass: 모델 4종·씬 10개 실제 렌더와 Pixora 경로 의존성 제거 검사 통과 · 근거: qa.json, Samples/Artwork/Provenance.json
### Q06 · final · 2026-10-31T16:20:40.7090225Z

전체 QA 점검: 실행 검증·패키지는 통과, 실제 입력·테마 화면·최종 공개 확인은 미실행이므로 메뉴얼을 완료 처리하지 않습니다.

- T01 r1 · pass: 템플릿과 Built-in 환경 확인 · 근거: 기존 Q01 원본 대조
- T02 r1 · pass: 54개 에디터 검사·15개 재개방 검사·2개 플레이어 렌더 검사 통과 · 근거: qa.json, reopen.json, player-models.json
- T03 r1 · not_run: 실제 입력 및 설정 창 테마 화면 검사 보류 · 근거: 사용자 화면 전환 금지 요청
- T04 r2 · not_run: 모델·문서·패키지 정적 검사는 통과, 설정 창 가이드 캡처는 남음 · 근거: package-verification.json, ScreenshotManifest.json
- T05 r1 · not_run: 보고서 생성과 공개 배포 준비 중. 전체 QA 통과 미충족 · 근거: result.json
### Q07 · step · 2026-10-31T16:47:18.2308276Z

TurnRoom 안의 맵 2개 정적 검사와 Unity 어셈블리 대상 C# 컴파일 통과. Unity 실행 검증은 미실행.

- T04 r3 · not_run: 각 씬 649개 직렬화 레코드, 메시 126개·모델 6개. 로컬 fileID·외부 GUID 연결·단위 회전·크기·해시 검사 통과. C# 오류·경고 0개. Unity 임포트·실제 렌더·입력은 미실행. · 근거: Docs/Testing/2026-11-01/pixel-camera-map/static-verification.json; compile.txt
### Q08 · step · 2026-10-31T17:36:33.904Z

실제 TurnRoom 12개 맵 렌더/Play와 UI·미세 픽셀·설정 테마·패키지 검증

- T03 r2 · not_run: 설정 창 라이트/다크·미리보기·로고 시각 검증 통과. 네이티브 팝업 입력은 부모 창 활성화로 실패하여 미검증. · 근거: SettingsDark.png, SettingsLight.png; native-settings270-readback referenceHeight180(기대270) 보존
- T04 r4 · pass: 12개 맵 렌더/Play·Overlay UI·native540/270/원본 전환·9개 언어 문서 링크/캡처 해시·새 패키지 원본 대조 통과 · 근거: play-all-03.json; all-scenes-render-02.json; native-key4-readback.json; native-button270-readback.json; native-bypass-readback.json; package-verification.json

## 남은 작업과 다음 반복

새 기능 구현·두 파이프라인 실행·네이티브입력·문서·패키지·공개보고 진행

이전 회차: [메뉴얼 열기](../../../projects/turnroom/reports/2026-10-31-manual-pixel-camera-20261101-20261031173653258-v1.0.4.html)

## 작업 시간

- 제안 시간: 60~90분. 시작 2026-11-01 03:26:13 KST.
- 실제로 완료된 시간: 구현·검증 진행 중; 완료시각 없음
- XERJ: 사용 — 실제 권한에서 XERJ Status 정상, TemplateAssetInspector 검색 5개 후보를 현재 모체 소스와 대조. 샌드박스 접속 실패를 노드 미실행으로 단정하지 않음.
