ih 0.2.0

A very persuasive package, for creating embroidery patterns

A very persuasive package, for creating embroidery patterns.

ih is a Python command-line tool for generating cross-stitch patterns from source images.

Would you prefer to use a website instead? Try ih as a Service

As seen at PyCon US 2019

How to cross-stitch

Check out this amazing Cross Stitch Carpentry lesson!

ih technical details

Installation

Requires Python 3.7+ and pip:

pip install ih

ih is now usable as a CLI.

CLI Usage

Usage: ih [OPTIONS] IMAGE

Options:
  -p, --palette TEXT     Choices: lego, floss, perler, alpaca, wool. Default:
                         wool
  -s, --scale INTEGER    Rescale factor. Default: 1
  -c, --colours INTEGER  Limit palette to at most N colors. Default: 256
  -r, --render           Render a preview (using thread images)
  -g, --guidelines       Render guidelines
  --help                 Show this message and exit.

Example usage:

ih -p alpaca -s 16 -r -c 4 demo_image.png

For the demo image (source, freetoedit) using the alpaca palette, and scaling the input image x16 smaller, render the result in up to 4 colours

Open demo_image.html to see the result.

Install from source

Using git and virtualenv:

git clone [e-mail]:glasnt/ih
cd ih
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

ih as a module

See its use in ih-aas

Package name origin

Disney's Lilo and Stitch:

Jumba: What?! After all you put me through you expect me to help you just like that?! Just like that?!
Stitch: Ih.
Jumba: Fine.
Pleakley: Fine? You're doing what he says?
Jumba: Uh, he's very persuasive.

Data provenance

floss

Sourced from http://www.damaniel.info/dmc/dmctorgb.html and http://threadcolors.com/

floss-dmc

Sourced from the medium colour on swatch previews from DMC.com

Oct 2020: This is the palette dervived during the PyCon 2019 talk, but was replaced with a better palette. It still remains available through floss-dmc

wool

Sourced from the medium colour on swatch previews from DMC.com

lego

Source from Kaggle dataset colors.csv https://www.kaggle.com/rtatman/lego-database

perler

Based on Perler Manufacturer as listed in:

• https://www.reddit.com/r/beadsprites/comments/291495/bead_list_with_rgb_values/
• https://docs.google.com/spreadsheets/d/1f988o68HDvk335xXllJD16vxLBuRcmm3vg6U9lVaYpA/edit#gid=0

alpaca

Source from Jill Rowling http://speleonics.com.au/jills/shared/alpaca.json

Attributions

LILO & STITCH is a trademark of Disney Enterprises, Inc.

LEGO® is a registered trademark of The Lego Group.

PERLER BEADS is a trademark of Stitch Acquisition Group.