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 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.

sample render

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.

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.

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.0.2.tar.gz (68.8 kB view hashes)

Uploaded Source

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