svg2gcode 2.8.7

svg2gcode: convert an SVG (Scalable Vector Graphic) image to gcode.

svg2gcode

A commandline steering program that enables laser cutting of svg drawings<svg:path ..>tags and combined engraving of svg images<svg:image ..>tags. It is based on library SvgToGcode (fork: https://github.com/johannesnoordanus/SvgToGcode) which should be installed ^(*).

Drawings and images can be composed using Inkscape (for example) and saved to a .svg file. This file can be converted to gcode by svg2gcode. Gcode produced in this way has the advantage that drawings and images have the same - relative - position and orientation as can be seen on the composer window. This makes combined cutting and engraving as easy as orientating the (wood) slab once.

Controlling laser power, pixel size and other settings can be done via commandline parameters (see below) or within Inkscape using the XMLeditor. Image attributes gcode_pixelsize, gcode_maxpower, gcode_speed, gcode_noise, gcode_speedmoves, gcode_overscan and gcode_showoverscan can be set per object (they must be created: use +). Note that this overrides explicit or default commandline settings.

You have full control over the coordinate system of the result gcode file via option --origin and --scale. Option --selfcenter can be used to set the origin at the center of the image. Note that gcode file headers contain compile information like the boundingbox and boundingbox center coordinates.

Version 2.0.0 and above have important new speed optimizations. Engravings run significantly faster and skip from one image zone to the other at maximum speed. See options --speedmoves and --noise for example.

To summarize:

Optimized gcode

• draw pixels in one go until change of power
• emit X/Y coordinates only when they change
• emit linear move 'G1/G0' code minimally
• does not emit zero power (or below cutoff) pixels

General optimizations

• laser head has defered and sparse moves. (XY locations are virtual, head does not always follow)
• moves at high speed (G0) over 10mm (default) or more zero pixels
• low burn levels (stray pixels) can be suppressed (default off)
• option --constantburn selects constant burn mode M3 (for cutting and engraving) instead of default dynamic burn mode M4

Tip: use commandline program grblhud (https://github.com/johannesnoordanus/grblhud) to have full control over gcode execution, also, program image2gcode has similar capabilities but handles raster images files (like png and jpg) directly.

Install:

> 
> pip install svg2gcode

^(*) Note that this library is included.

Usage:

See notes below.

svg2gcode --help
usage: runsvg2gcode [-h] [--showimage] [--selfcenter] [--pixelsize <default:0.1>] [--imagespeed <default:800>] [--cuttingspeed <default:1000>]
                    [--imagepower <default:300>] [--poweroffset <default:0>] [--cuttingpower <default:850>] [--passes <default:1>] [--pass_depth <default:0>]
                    [--rapidmove <default:10>] [--noise <default:0>] [--overscan <default:0>] [--showoverscan] [--constantburn] [--origin Xdelta Ydelta]
                    [--scale Xfactor Yfactor] [--rotate <default:0>] [--splitfile] [--xmaxtravel <default:300>] [--ymaxtravel <default:400>] [--fan] [-V]
                    svg gcode

Convert svg to gcode for GRBL v1.1 compatible diode laser engravers.

positional arguments:
  svg                   svg file to be converted to gcode
  gcode                 gcode output file

options:
  -h, --help            show this help message and exit
  --showimage           show b&w converted image
  --selfcenter          self center the gcode (--origin cannot be used at the same time)
  --pixelsize <default:0.1>
                        pixel size in mm (XY-axis): each image pixel is drawn this size
  --imagespeed <default:800>
                        image draw speed in mm/min
  --cuttingspeed <default:1000>
                        cutting speed in mm/min
  --imagepower <default:300>
                        maximum laser power while drawing an image (as a rule of thumb set to 1/3 of the machine maximum for a 5W laser)
  --poweroffset <default:0>
                        pixel intensity to laser power: shift power range [0-imagepower]
  --cuttingpower <default:850>
                        sets laser power of line drawings/cutting
  --passes <default:1>  Number of passes (iterations) for line drawings, only active when pass_depth is set
  --pass_depth <default:0>
                        cutting depth in mm for one pass, only active for passes > 1
  --rapidmove <default:10>
                        generate G0 moves between shapes, for images: G0 moves when skipping more than 10mm (default), 0 is no G0 moves
  --noise <default:0>   reduces image noise by not emitting pixels with power lower or equal than this setting
  --overscan <default:0>
                        overscan image lines to avoid incorrect power levels for pixels at left and right borders, number in pixels, default off
  --showoverscan        show overscan pixels (note that this is visible and part of the gcode emitted!)
  --constantburn        use constant burn mode M3 (a bit more dangerous!), instead of dynamic burn mode M4
  --origin delta-x delta-y
                        translate origin by vector (delta-x,delta-y) in mm (default not set, option --selfcenter cannot be used at the same time)
  --scale factor-x factor-y
                        scale svg with (factor-x,factor-y) (default not set)
  --rotate <default:0>  number of degrees to rotate
  --splitfile           split gcode output of SVG path and image objects
  --xmaxtravel <default:300>
                        machine x-axis lengh in mm
  --ymaxtravel <default:400>
                        machine y-axis lengh in mm
  --fan                 set machine fan on
  -V, --version         show version number and exit

You can also store those settings in ~/.config/svg2gcode.toml, eg:

xmaxtravel= 400
ymaxtravel= 400
imagespeed = 6000

It can be used with any parameter which takes a value, and alows to persist your laser settings.

Notes:

• example command to create two types of gcode file, one containing the drawings of the .svg, the other containing the images:

  > svg2gcode --splitfile ambachtmanlogo.svg logo.gc
  > ..
  > ls *.gc 
  > logo.gc             # all drawings
  > logo_images.gc      # all images

• drawing objects - within the composer - must be converted to apathto be translated to a gcode sequence
• also, image objects should not be converted to a path
• images must be linked or embedded using base64.
• images can be in several formats (my tests included .png and .jpg image files)
• SVG source documents must be in unit 'mm' (and set to 1 'user unit' is 1 mm) which is the default for Inkscape (check document settings and look at the 'scaling' parameter)