Skip to content

kkumyk/colour-to-dmc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Colours to DMC Threads

A CLI tool to translate image colours to closest DMC threads.

To find the colours, the image is quantized and then the nearest colour is looked up from a table of DMC colour threads.

The identified thread numbers will be returned and added to the quantized image.

The user can specify the number of colours to reduce the image to before looking up the threads.

The user can also specify the percentage number to use for filtering out the threads as opposed to the default which is set to return all threads used more than 1% in the image.

It's assumed that the user won't be using more than 50 threads to work on. Therefore, if more than 50 threads are returned, only the top 50 most used threads will be added to the output image.

Usage

Tested with Python 3.8.

pip install -r requirements.txt
$ python cli.py  -h
usage: cli.py [-h] [-o OUTPUT] [-p PERCENT] [-c COLOURS] input

Get a DMC colour palette for an image.

positional arguments:
  input                 an input file

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        an output file
  -p PERCENT, --percent PERCENT
                        percent number to use for filtering identified colours
  -c COLOURS, --colours COLOURS
                        a number to use to reduce the image to the specified nr of colours

Limitations

The input image should be at least 1000px in height.

License

MIT

Thanks

This is a Python learning project and was inspired by the embroidery-vision tool written by @healeycodes. Some of the code and the csv file were used from his project.

About

Translate image colours to DMC threads.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages