Michael JohnsonPSD는 편집기에서 열리더라도 다르게 보일 수 있습니다. 마스크, 텍스트, 레이어 효과 또는 겹침 순서에서 차이가 생길 수 있습니다. 결과를 검증하는 한 가지 방법은 다시 구성한 이미지를 PSD 파일 자체에 내장된 합성 이미지와 비교하는 것입니다. 2026년 10월 11일 출시된 PhotoCraft v0.7.0은 Rust로 작성된 오픈소스 그래픽 편집기의 사례를 통해 이 엔지니어링 방식을 살펴볼 기회를 제공합니다.
릴리스에는 브러시, 선택 영역, 마스크, OpenRaster 가져오기 등 편집기의 여러 부분에 대한 변경 사항이 나열돼 있습니다. 개발자에게 특히 흥미로운 것은 프로젝트에서 공개한 문서입니다. 문서는 PSD 가져오기 테스트, 합성기 비교, 재현 가능한 검증에 사용되는 파일 모음을 설명합니다.
PSD에는 비교 기준이 들어 있습니다
다층 PSD에는 레이어 구조와 문서의 합성 이미지가 들어 있습니다. PhotoCraft는 레이어를 렌더링한 뒤 그 결과를 내장된 합성 이미지와 대조합니다. 이 테스트는 텍스트, 조정 레이어, 효과 및 기타 형식 기능을 처리할 때 프로그램이 문서의 모습을 얼마나 충실하게 재현하는지 확인합니다.
PhotoCraft 아키텍처 문서는 이 접근법을 ‘합성기 오라클’이라고 부릅니다. 테스트 문서에는 세 가지 PSD 파일 모음이 나옵니다. 팀이 Photoshop에서 만든 파일 256개, psd-tools 및 ag-psd 데이터 세트의 파일 170개, 그리고 별도의 psd-tools 파일 모음 309개입니다. 파일 모음은 고정된 버전으로 내려받으며 체크섬으로 검증합니다.
형식 개발자는 테스트를 각기 답하려는 질문에 따라 나누는 것이 유용합니다. 구조 분석은 문서를 읽을 수 있었는지 보여주고, 열기와 저장을 반복하는 테스트는 데이터가 보존됐는지 확인하며, 합성 이미지 비교는 시각적 결과가 얼마나 정확하게 재현됐는지 보여줍니다. PhotoCraft 문서에는 변경되지 않은 파일의 바이트 안정성 검사와 PSD 내장 합성 이미지 비교가 모두 나와 있습니다.
CPU 합성기는 기준 구현 역할을 합니다
프로젝트는 CPU 합성기를 내보내기와 테스트를 위한 기준 경로로 설명합니다. wgpu 기반 GPU 합성기는 캔버스에서 같은 작업 계획을 수행합니다. 아키텍처 문서에 따르면 결과는 8비트 출력 기준 최대 1/255의 허용 오차로 비교하며, CI에서는 소프트웨어 그래픽 어댑터를 포함해 CPU와 GPU 구현을 검증합니다.
GPU는 인터랙티브 캔버스에 필요하지만, 하드웨어 경로를 사용할 수 있는지는 문서와 실행 환경에 따라 달라집니다. 안내 문서에 따르면 다중 채널 문서와 텍스처 한도를 초과하는 영역은 CPU 합성기로 처리됩니다. GPU 장치가 사라진 경우에도 캔버스는 CPU로 전환됩니다. 이는 경로 전환이 필요한 구체적인 조건이지, 모든 장치에서 속도가 같다는 주장은 아닙니다.
같은 방식은 다른 계산 시스템에도 적용할 수 있습니다. 검증 가능한 기준 구현을 최적화된 경로와 함께 두고, 같은 입력으로 양쪽을 실행하는 것입니다. 데이터베이스라면 최적화된 엔진과 단순한 인터프리터를, 미디어 처리라면 하드웨어 가속 경로와 소프트웨어 경로를 함께 둘 수 있습니다. 결과를 비교하면 차이를 확인할 수 있고, 입력과 허용 오차 기준을 고정하면 재현 가능한 검증이 됩니다.
이 방식을 실제 테스트로 만드는 방법
- 규모는 작아도 다양하게 파일을 모으세요. 마스크, 텍스트, 그룹, 투명도, 효과, 색상 모드가 포함된 파일을 준비하세요. 이후 테스트에서 같은 입력을 사용할 수 있도록 파일의 출처와 데이터 세트 버전을 기록하세요.
- 기준과 허용 오차를 정하세요. PSD의 경우 결과를 내장된 합성 이미지와 비교할 수 있습니다. 허용 오차를 정하고, 애플리케이션에 중요하다면 크기, 색상 프로필, 알파 채널도 별도로 확인하세요.
- 가져오기, 저장, 렌더링 테스트를 분리하세요. 레이어 분석, 저장 후 다시 열기, 기준 이미지와의 일치 여부를 각각 테스트할 수 있습니다. 이렇게 하면 문제가 발생한 단계를 파악하기가 쉬워집니다.
- 같은 사례를 여러 백엔드에서 실행하세요. 타일 경계와 효과가 포함된 테스트를 비롯해 동일한 문서에서 CPU와 GPU 결과를 비교하세요. 회귀를 재현할 수 있도록 입력 파일과 시각적 차이를 보관하세요.
- 성능 측정 조건을 기록하세요. 문서 크기, 레이어 수, 하드웨어, 캐시 상태를 명시하세요. PhotoCraft 문서에는 개별 테스트와 합성기 비교를 위한 명령이 있으며, 문서에 제시된 측정값은 특정 구성과 시나리오에 해당합니다.
PhotoCraft 개발 안내서에는 PSD 파일 모음, 시각적 차이, 다양한 합성 경로의 동작을 검사하는 명령이 설명돼 있습니다. 편집기의 테스트 인프라를 살펴보는 구체적인 출발점으로 활용할 수 있습니다. 문서에 나온 성능 수치는 함께 제시된 입력과 하드웨어 구성을 고려해 해석해야 합니다.
PhotoCraft 사례가 보여주는 것
PhotoCraft v0.7.0 릴리스에는 편집기 자체의 변경 사항이 담겨 있으며, 프로젝트 문서는 별도의 엔지니어링 관행도 보여줍니다. 합성 결과 검증을 위한 기준 PSD와 GPU 경로를 비교하는 CPU 구현이 그것입니다. 편집기, 변환기 및 복잡한 파일을 다루는 도구를 만드는 개발자에게 주는 교훈은 간단합니다. 읽기, 저장, 시각적 결과를 각각 테스트하고, 고정된 입력을 사용해 가속 구현을 기준 버전과 비교하세요. 그러면 호환성과 성능을 프로그램의 검증 가능한 속성으로 만들 수 있습니다.