NEUJOH.img

NEUJOH.img는 이미지의 색과 구조를 보존하면서 문자로 다시 그리는 컬러 ASCII 아트 렌더러입니다.

Neural Edge Understanding for Joint Optical Halftoning, using Image-Mapped Glyphs

NEUJOH.img로 변환한 컬러 ASCII 아트 예시

무엇이 다른가요?

보통의 ASCII 아트가 밝기에 따라 문자를 고른다면, NEUJOH.img는 글리프의 실제 모양과 이미지의 국소 구조를 함께 비교합니다. 그래서 어두운 영역도 빈 공간이 되지 않고, 윤곽과 질감이 문자 안에 남습니다.

  • 글리프를 4×8 잉크 커버리지 벡터로 바꾸고 형태가 가까운 문자를 선택합니다.
  • DoG와 Sobel 방향을 이용해 강한 경계를 -, /, |, \\로 보강합니다.
  • 선형 광과 OKLab에서 색을 처리해 컬러 ASCII 특유의 탁함을 줄입니다.
  • 인물 매트를 선택적으로 사용해 피사체와 배경의 디테일을 따로 조절합니다.
  • PNG, SVG, 일반 텍스트, 24비트 ANSI 출력을 지원합니다.

설치

Python 3.12 이상이 필요합니다. 기본 변환 기능은 PyPI에서 설치할 수 있습니다.

pip install neujoh-img

피사체 분리 기능까지 사용하려면 matte 추가 의존성을 함께 설치합니다.

pip install "neujoh-img[matte]"

저장소를 내려받아 개발하려면 다음을 사용합니다.

git clone https://github.com/emjdp/NEUJOH.img.git
cd NEUJOH.img

# 기본 설치
pip install -e .

# rembg와 ONNX Runtime을 포함한 전체 설치
pip install -e ".[matte]"

rembg 모델은 매트 기능의 첫 실행 때 내려받을 수 있으며, 기본 설치에서는 --no-matte를 사용하면 됩니다.

사용법

neujoh input.jpg \
  --cols 100 \
  --aspect 1:1 \
  --look film \
  --scale 2 \
  --svg \
  --ansi \
  -o result

이 명령은 result.png와 result.txt를 만들고, 옵션에 따라 result.svg와 result.ans도 만듭니다.

자주 쓰는 옵션:

옵션 설명
--cols 문자 격자의 가로 칸 수
--charset ascii, code, blocks, mixed, minimal
--look neutral, film, sunlit, neon, cold, mono
--aspect 1:1, 16:9 같은 출력 비율
--zoom, --focus-y 크롭 배율과 세로 초점
--detail, --structure 국소 디테일과 문자 구조 강도
--edges 방향성 경계 보강 강도
--bg-gain, --energy 셀 배경색과 광량 보존 정도
--invert 밝은 종이에 어두운 글자 스타일
--no-matte 피사체 분리 없이 변환

전체 옵션은 다음 명령으로 확인할 수 있습니다.

neujoh --help

python -m neujoh도 같은 명령을 실행합니다. 기존 저장소 사용자를 위해 python ascii_art.py 실행 방식도 유지됩니다.

Python 코드에서는 렌더러 API를 직접 사용할 수 있습니다.

from PIL import Image
from neujoh import Config, composite, convert

source = Image.open("input.jpg")
config = Config(cols=100, matte=False)
result = convert(source, config)
composite(result, config).save("result.png")

파이프라인

  1. 폰트의 각 글리프를 래스터라이즈하고 작은 커버리지 벡터로 압축합니다.
  2. 선택적으로 피사체 매트를 계산해 전경과 배경을 분리합니다.
  3. CLAHE, 언샤프, 국소 대비 정규화로 문자 선택용 디테일 채널을 만듭니다.
  4. 방향성 경계를 검출해 실루엣과 주요 선을 보강합니다.
  5. 선형 광에서 셀 색을 평균내고 OKLab에서 색감을 조정합니다.
  6. 글리프 커버리지를 고려해 잉크와 배경의 광량을 보존하며 합성합니다.

핵심 합성식은 다음과 같습니다.

coverage × ink + (1 − coverage) × wash = cell color

글자가 셀의 일부만 채우는 점을 보정하기 때문에 밝은 영역이 지나치게 어두워지지 않습니다.

구성

  • pyproject.toml: 패키지 메타데이터, 의존성, neujoh 명령 정의
  • src/neujoh/renderer.py: 변환 및 합성 파이프라인
  • src/neujoh/cli.py: 명령줄 인터페이스
  • src/neujoh/fonts/: 패키지에 포함되는 JetBrains Mono 폰트
  • ascii_art.py: 기존 실행 방식과의 호환용 진입점
  • make_profile.py: 여러 크롭과 해상도를 한 번에 만드는 배치 예제
  • sweep.py: 주요 파라미터를 비교하는 콘택트 시트 생성기

라이선스

  • 소스 코드와 문서는 MIT License로 공개합니다.
  • 패키지에 포함된 JetBrains Mono 파일은 SIL Open Font License 1.1을 따릅니다.
  • README 미리보기인 docs/full_wide.png는 MIT License 적용 대상이 아니며, 별도의 재사용 권한을 부여하지 않습니다.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for emjdp from gravatar.com emjdp

Credits

Author: emjdp

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Provides Extra

matte

Tags

ascii-art color-ascii-art image-processing oklab terminal-art

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neujoh_img-0.1.0.tar.gz (414.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neujoh_img-0.1.0-py3-none-any.whl (412.0 kB view details)

Uploaded Python 3

File details

Details for the file neujoh_img-0.1.0.tar.gz.

File metadata

  • Download URL: neujoh_img-0.1.0.tar.gz
  • Upload date:
  • Size: 414.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for neujoh_img-0.1.0.tar.gz
Algorithm Hash digest
SHA256 bc93b2f7e83b0666c120f2f367a47f3f575143a253097dc679fc63a4803cf99a
MD5 c29d0ac531cc516f1c8e6c3bbc52579b
BLAKE2b-256 ff0760fe08a3fd0d95b5a1001940610dd89772fbb727f2c6fed6f3129208b2e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for neujoh_img-0.1.0.tar.gz:

Publisher: publish.yml on emjdp/NEUJOH.img

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file neujoh_img-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: neujoh_img-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 412.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for neujoh_img-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 074b630d569242f33551cf4ffce0d06794195c067fe6f3cc2ac7203bd6e6a527
MD5 28d87e13159f09b4d3d0c5717b421eeb
BLAKE2b-256 5b9e36a980955272c025289f3767ac592d195da0e7cb494e51ae0b8c75f055c5

See more details on using hashes here.

Provenance

The following attestation bundles were made for neujoh_img-0.1.0-py3-none-any.whl:

Publisher: publish.yml on emjdp/NEUJOH.img

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page