KennethJAllen/proper-pixel-art

해결하는 문제

AI 생성 모델이나 저품질 웹 업로드로 인해 생성된 픽셀 아트처럼 보이는 노이즈 많은 고해상도 이미지를 깨끗한 실제 해상도의 픽셀 아트 에셋으로 변환합니다. 이미지에 불균일한 그리드와 무작위 아티팩트가 포함되어 있어 표준 다운샘플링이 실패하는 문제를 해결합니다.

작동 원리

이 도구는 다단계 컴퓨터 비전 파이프라인을 사용하여 원래의 픽셀 그리드를 복구합니다:

1. 전처리: 가장자리를 다듬고 투명도를 처리합니다.
2. 에지 검출: Canny 에지 검출 및 모폴로지 닫기 연산을 사용하여 "픽셀"의 경계를 찾습니다.
3. 그리드 복구: 확률적 허프 변환 (Probabilistic Hough transform)을 사용하여 수직 및 수평선을 찾고, 이를 클러스터링한 뒤 그래디언트 투영 프로파일 피크에 스냅하여 픽셀 메시를 구축합니다.
4. 그리드 검증: 선 간격을 기반으로 픽셀 너비를 추정하고 재구성 오차(셀 내 색상 분산)를 사용하여 검증합니다.
5. 색상 처리: 이미지를 고정 팔레트로 양자화하거나 주요 색상 방법을 사용하여 원래 색상을 보존합니다.
6. 최종화: 메시의 각 셀에 대표 색상을 할당하여 실제 해상도의 이미지를 생성합니다.

비디오 및 GIF의 경우, 이 도구는 몇 개의 프레임을 샘플링하여 단일 공유 그리드와 팔레트를 결정함으로써 애니메이션이 깜박임 없이 일관성을 유지하도록 합니다.

대상 사용자

• AI로 생성된 픽셀 아트를 정리해야 하는 게임 개발자 및 아티스트.
• 픽셀 아트의 저품질 웹 스크린샷을 사용 가능한 에셋으로 변환하려는 사용자.
• 픽셀 아트 스타일 애니메이션 (GIFs/MP4s)을 다루는 크리에이터.

주요 특징

• 애니메이션 지원: 비디오 및 GIF를 프레임 간 일관성을 유지하며 처리합니다.
• 자동 그리드 검출: 소스 이미지의 픽셀 너비와 메시를 자동으로 검출합니다.
• 유연한 색상 제어: 주요 색상 보존 및 고정 팔레트 양자화 기능을 모두 제공합니다.
• 다양한 인터페이스: CLI, Python API 및 Hugging Face Spaces를 통한 웹 인터페이스로 제공됩니다.