PosterChild: Blend‐Aware Artistic Posterization (EGSR 2021). Please read paper for more details.

[Cheng-Kang Ted Chao, Karan Singh, Yotam Gingold.]

This work is dual-licensed under Apache 2.0 and MIT.

SPDX-License-Identifier: Apache-2.0 and MIT

Use Poetry. Install Poetry itself via pip install poetry or brew install poetry. Then:

poetry install --no-root
poetry shell

To create a double-clickable .app for macOS users, run (inside a poetry shell):

pyinstaller posterization_gui.spec

A double-clickable Posterization GUI.app will appear inside the dist/ directory.

Install Anaconda or Miniconda. (Miniconda is faster to install.) Choose the 64-bit Python 3.x version. Launch the Anaconda shell from the Start menu and navigate to the posterization directory. Then:

conda env create -f environment.yml
conda activate posterization

To update an already created environment if the environment.yml file changes, first activate and then run conda env update --file environment.yml --prune.

Launch the GUI:

python src/gui.py

Command line example:

python src/cli.py [source-image-path] [output-image-path] [output-additive-mixing-path] [0 or 1 (indicating if using downsampled approach)]