svg-halftone

Tool for converting raster images (png, jpg, gif) to SVG halftone patterns that can be cut on a laser cutter, turning the halftone dots into holes.

The tool comes as a CLI, detailed below, and as a web-based version at halftone.vestera.as

Installation

There are precompiled binaries of releases on the releases page.

If you have Rust installed you can build from source with:

cargo install --git https://github.com/evestera/svg-halftone

svg-halftone my-image.jpg

From svg-halftone --help

--shape <shape>: Shape used for samples. "circle", "hex" or "diamond". Defaults to the shape best suited to the chosen grid.
--grid <grid>: Grid to lay samples out on. "rect", "hex", "diamond" or "poisson". Defaults to the grid best suited to the chosen shape.
--contrast <contrast>: Adjust contrast of input image before processing. Positive numbers increase contrast, negative numbers decrease it.
--invert: Make shapes black on white. I.e. holes show a darker background.
--output <output>: Output path [default: out.svg]
--output-width <output-width>: Output width in mm [default: 300]
--spacing <spacing>: Horizontal spacing between samples in mm [default: 5]
--cut-paths: Draw cut paths only (no fill and background). I.e. make a file ready for cutting.

Image used as input for these examples:

--shape circle --grid rect (default)

--shape circle --grid poisson

--shape hex (also sets --grid hex)

--shape diamond (also sets --grid diamond)

remove.bg: Easily replace backgrounds of images of people with a single color.
Gapplin (macOS): SVG viewer which automatically redraws the file when it is updated.

This project is licensed under the MIT License.