TL;DR

  • Pixora는 Pillow 기반의 경량 Python 라이브러리이자 명령줄 도구로, 파일 경로와 메모리 객체를 입력받아 일반 이미지를 레트로 스타일 픽셀 아트로 변환함.
  • 픽셀 크기를 조정할 수 있으며, 라이브러리 API와 명령줄 인터페이스(CLI)에서 이미지 변환과 그레이스케일 처리를 지원함.
  • 최근 버전 0.4에는 블록별 평균 색상·최빈 색상·중앙값을 사용하는 MeanBlock, ModeBlock, MedianBlock 알고리즘이 포함됨.
  • 사용 가능한 알고리즘은 NearestNeighbor, Bilinear, Bicubic, Lanczos, MeanBlock, ModeBlock, MedianBlock임.
  • 패키지는 pip install pixora==0.4로 설치할 수 있으며, 릴리스 파일은 소스 배포본과 Python 3용 휠로 제공됨.

개요

  • Pixora는 일반 이미지를 레트로 스타일 픽셀 아트로 변환하는 경량 Python 라이브러리이자 명령줄 도구임.
  • Pillow를 기반으로 하며, 조정 가능한 픽셀 크기와 파일 경로 및 메모리 객체 입력을 지원함.
  • 게임 에셋 제작, 픽셀화 아바타 생성, 이미지에 복고풍 시각 효과 적용 등에 사용할 수 있음.

설치

소스 코드

  • 버전 0.4 또는 최신 소스 코드를 내려받은 뒤 pip install . 명령으로 설치함.

PyPI

  • Python 패키징 사용자 안내서에 따라 pip install pixora==0.4 명령으로 설치함.

사용법

라이브러리

  • NearestNeighbor 또는 Lanczos 알고리즘을 선택해 pixelize 함수로 이미지를 변환함.
  • 입력 이미지와 출력 경로를 지정하거나, 결과 이미지를 객체로 받아 표시할 수 있음.
  • pixel_size로 픽셀 크기를 설정하고 grayscale=True로 그레이스케일 처리를 지정함.

명령줄 인터페이스

  • pixora input.png output.png 형식으로 입력 및 출력 파일을 지정함.
  • --pixel-size=12로 픽셀 크기를 지정하고, --algorithm="bilinear"로 알고리즘을 선택함.
  • --grayscale 옵션으로 그레이스케일 변환을 적용함.

사용 가능한 알고리즘

  • 예시 알고리즘은 모두 같은 입력 이미지와 pixel_size=8 설정을 사용함.
  • NearestNeighbor: 최근접 이웃 리샘플링으로 픽셀화함.
  • Bilinear: 쌍선형 리샘플링으로 픽셀화함.
  • Bicubic: 쌍삼차 리샘플링으로 픽셀화함.
  • Lanczos: 란초스 리샘플링으로 픽셀화함.
  • MeanBlock: 각 블록의 평균 RGB 색상으로 픽셀화함.
  • ModeBlock: 각 블록에서 가장 자주 나타나는 색상으로 대체함.
  • MedianBlock: 각 블록의 중앙값 RGB 색상으로 대체함.

이슈 및 버그 보고

  • 이슈를 작성해 문제를 설명하고 이슈 템플릿을 작성하는 방식임.

변경 기록

  • 미출시(Unreleased) 변경 사항은 별도로 기재되어 있지 않음.
  • 0.4 — 2026-10-02
  • 추가 항목: MeanBlock, ModeBlock, MedianBlock 알고리즘.
  • 변경 항목: 테스트 시스템 수정, README.md 업데이트.
  • 0.3 — 2026-08-23
  • 추가 항목: grayscale 매개변수, --grayscale CLI 인수.
  • 변경 항목: 이미지 열기 버그 수정, --info·--algorithm CLI 인수 버그 수정, 저장 메서드 수정, 픽셀 크기 검증 버그 수정, CLI 구조 수정, 테스트 시스템 수정, README.md 업데이트.
  • 0.2 — 2026-07-27
  • 추가 항목: Lanczos, Bilinear, Bicubic 알고리즘, 로고.
  • 변경 항목: 테스트 시스템 수정, README.md 업데이트.
  • 0.1 — 2026-07-14
  • 추가 항목: NearestNeighbor 알고리즘, pixelize 함수, Converter 클래스, PixoraError, PixoraImageError, PixoraValidationError 예외 클래스.

배포 메타데이터

  • 버전 0.4의 소스 배포본(pixora-0.4.tar.gz) 크기는 16.8 kB, Python 3용 휠(pixora-0.4-py3-none-any.whl) 크기는 17.1 kB이며 전체 배포 크기는 33.9 kB임.
  • 두 배포 파일의 업로드 날짜는 2026년 10월 2일이며, Python 3, ABI none, 플랫폼 any 태그를 가진 휠이 제공됨.
  • 소스 배포본 SHA-256 체크섬은 131cf0f5c8efabe3a5539eaf1b0ec45bfb94bcacd46f45dac86484f2a337d922, BLAKE2b-256 체크섬은 7aa0da65bacdbb45fd9e5526485b8dda13ea45f5a4f0a7ad32835c2446e05e12임.
  • 휠 SHA-256 체크섬은 594dbf63ff358af3010c6b1f627cbbf87ef66d55867b850617df857a401c711f, BLAKE2b-256 체크섬은 631ec767c8184e8eb4bf60cce9a38072d13442af777b5fa3c781c51c4140f7e2임.
  • 두 파일 모두 Trusted Publishing을 사용하지 않았으며, twine/7.0.0 CPython/3.14.7을 통해 업로드됨.
  • 릴리스 기록은 0.0.0 — 2026-07-04, 0.1 — 2026-07-14, 0.2 — 2026-07-27, 0.3 — 2026-08-23, 0.4 — 2026-10-02 순임.