Skip to main content

Generate G-code to engrave raster images

Project description

RasterCarve: Generate G-code to engrave raster images

This is a little Python script I wrote to generate 3-axis toolpaths to engrave raster images.

Installation

pip install rastercarve

Usage

usage: rastercarve [-h] (--width WIDTH | --height HEIGHT) [-f FEED_RATE]
                   [-p PLUNGE_RATE] [--rapid RAPID_RATE] [-z SAFE_Z]
                   [--end-z TRAVERSE_Z] [-d MAX_DEPTH] [-t TOOL_ANGLE]
                   [-a LINE_ANGLE] [-s STEPOVER] [-r LINEAR_RESOLUTION]
                   [--no-line-numbers] [--debug] [-q] [--version]
                   filename

Generate G-code to engrave raster images.

positional arguments:
  filename              input image (any OpenCV-supported format)

optional arguments:
  -h, --help            show this help message and exit
  --debug               print debug messages
  -q                    disable progress and statistics
  --version             show program's version number and exit

output dimensions:
  Exactly one required.

  --width WIDTH         output width (in)
  --height HEIGHT       output height (in)

machine configuration:
  -f FEED_RATE          engraving feed rate (in/min) (default: 100)
  -p PLUNGE_RATE        engraving plunge rate (in/min) (default: 30)
  --rapid RAPID_RATE    rapid traverse rate (for time estimation only)
                        (default: 240)
  -z SAFE_Z             rapid Z traverse height (in) (default: 0.1)
  --end-z TRAVERSE_Z    Z height of final traverse (in) (default: 2)
  -d MAX_DEPTH          maximum engraving depth (in) (default: 0.08)
  -t TOOL_ANGLE         included angle of tool (deg) (default: 30)

engraving parameters:
  -a LINE_ANGLE         angle of grooves from horizontal (deg) (default: 22.5)
  -s STEPOVER           stepover percentage (affects spacing between lines)
                        (default: 110)
  -r LINEAR_RESOLUTION  distance between successive G-code points (in)
                        (default: 0.01)

G-code parameters:
  --no-line-numbers     suppress G-code line numbers (dangerous on ShopBot!)

Defaults are usually safe to leave unchanged.

Examples

rastercarve --width 10 examples/test.png > out.nc

Generate G-code to engrave examples/test.png into an image 10 inches wide. Output will be piped from stdout to out.nc.

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

rastercarve-1.0.2.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

rastercarve-1.0.2-py3.8.egg (13.3 kB view details)

Uploaded Egg

File details

Details for the file rastercarve-1.0.2.tar.gz.

File metadata

  • Download URL: rastercarve-1.0.2.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.8.0

File hashes

Hashes for rastercarve-1.0.2.tar.gz
Algorithm Hash digest
SHA256 f900749bb6f10b5a9f3ca0707a1bb040146e4f5301bd3b8d0b1b21492281c0ad
MD5 0c3b66aeaedd603839aeea66158a36ac
BLAKE2b-256 db4cf0ab9a27084a2cc4526156fa84dc7565c6ad3127804bfee9d1dbe53aacaa

See more details on using hashes here.

File details

Details for the file rastercarve-1.0.2-py3.8.egg.

File metadata

  • Download URL: rastercarve-1.0.2-py3.8.egg
  • Upload date:
  • Size: 13.3 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.39.0 CPython/3.8.0

File hashes

Hashes for rastercarve-1.0.2-py3.8.egg
Algorithm Hash digest
SHA256 d5e0db76676610a4631ad6bc7ae8c621be6893daebd16016d1f85990bc1ceaca
MD5 824bf7c2044295659986e72eeaf1e373
BLAKE2b-256 e1eee7d2ff29c749564de101867f7a636e7f6226e591027eb989f6e00b852c17

See more details on using hashes here.

Supported by

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