ehashman / ih

🧶 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 [lego|floss|floss-dmc|perler|alpaca|wool]
                                  Palette to use. See README.md for provenance
                                  [default: wool]

  -s, --scale INTEGER             Rescale factor  [default: 1]
  -c, --colors INTEGER            Limit palette to at most N colors.
                                  [default: 256]

  -r, --render                    Render preview of resulting artwork
                                  [default: False]

  -g, --guidelines                Show guidelines. Recommended for printing.
                                  [default: False]

  --print-ready                   Print black and white version
  -o, --fileformat [html|term]    Output file format  [default: html]
  --version                       Show the version and exit.
  --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.

Printing

Use -g for printing. ih will:

• Use print-css functionality to ensure the print view is black+white
• Use js to dynamically split wide charts. Requires jQuery via CDN.

When printing, the page order will be legend, then a series of columns of chart.

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

floss-pdx

Yet another floss-to-hex palette offered by http://pdxstitch.net/tools/tools.html and converted to ih format. The original spreadsheet can be found here.

Note that they also provide a couple of other handy tools including a floss use calculator!

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.

Aurora test image (test_image.jpg) by Jonathan Bean from Unsplash: https://unsplash.com/photos/Ejpx_sdKEKo