Skip to main content

A very persuasive package, for creating embroidery patterns

Project description

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|newlego|perler|alpaca|floss-pdx|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, --print-ready
                                  Show guidelines, and print without colour
                                  [default: False]

  -o, --fileformat [html|term]    Output file format  [default: html]
  -f, --outputfolder TEXT         Output folder
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Example usage:

ih -p alpaca -r -c 4 demo/demo_image.png -f demo/

For the demo image (source, freetoedit) using the alpaca palette, render the result in up to 4 colours, to the output folder demo/

Open demo/demo_image.html to see the result.

sample render

Printing

Use --print-ready 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 git@github.com: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 (source)

perler

Based on Perler Manufacturer information (source one, source two)

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/images/aurora.jpg) by Jonathan Bean from Unsplash: https://unsplash.com/photos/Ejpx_sdKEKo

Project details


Download files

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

Source Distribution

ih-0.6.0.tar.gz (97.0 kB view details)

Uploaded Source

Built Distribution

ih-0.6.0-py3-none-any.whl (88.8 kB view details)

Uploaded Python 3

File details

Details for the file ih-0.6.0.tar.gz.

File metadata

  • Download URL: ih-0.6.0.tar.gz
  • Upload date:
  • Size: 97.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for ih-0.6.0.tar.gz
Algorithm Hash digest
SHA256 1d830f0821075eb2002e5ceff1521de7e9f8a2e4845c9ed9990cb03076dde30d
MD5 c58a36fcc63d2feeecd0e099690693a6
BLAKE2b-256 b9b5b46179010c9975b65978cf2635f62e39412305f5a1e50440614f42c9d6b2

See more details on using hashes here.

File details

Details for the file ih-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: ih-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 88.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for ih-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 581e8b3f0ca5944e2947d9287ab16070af3a138cbc0b533388f7eab13d3bbd4d
MD5 ce5c44087e9f09df4e0b6de853a99538
BLAKE2b-256 a1dac9473ffe9fe0733b63a682c20190cd691817549c623528977b4d1d66726d

See more details on using hashes here.

Supported by

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