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
Check out this amazing Cross Stitch Carpentry lesson!
Requires Python 3.7+ and pip
:
pip install ih
ih
is now usable as a CLI.
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.
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.
Using git
and virtualenv
:
git clone git@github.com:glasnt/ih
cd ih
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
See its use in ih-aas
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.
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
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