Skip to content
Switch branches/tags

Velocity Painting

I'd love this to evolve into something cool. All I ask is that you use the term Velocity Painting, tag things with #VelocityPainting, and ack that I, Mark Wheadon, started this bizarre journey with the idea, the name, and some functional though fragile code ;-) See the licence at the bottom of this document.

If you improve this code then it would be great if you could submit a pull request back to the repository -- so others can benefit from the work.

What's here

So, this is a rough and ready perl script that when given an image file and a GCODE file, processes the GCODE to change print speeds according to the intensity of the image pixels -- thus mapping the image onto the model. If a GCODE vector crosses a pattern boundary then the vector is split to allow a change in velocity to occur at that boundary.

An FAQ is available here.

In use

Slice your model with all speeds set to (say) 3000mm/min, then use the 3000 as the first argument to the script. Don't forget to switch off anything in the slicer that changes print speed according to layer time and anything that under-speeds infill, outer perimeters, bridges etc. Note: At time of writing I have only run this code on the output from Simplify3D -- it hasn't been tried on output from Slic3r, Cura, etc.

Run the script with no arguments to get some usage instructions.


The script relies on the Imager perl module and Math::Trig.


Run the resulting GCODE though a GCODE previewer before sending it to a printer. Especially once you start to change the script. Messing up the co-ordinates will send the print head places it should never go and that could easily damage your printer. I drag the GCODE onto Simplify3D to preview it -- Simplify3D even colour codes the print velocity, which is exactly what you need!


Velocity Painting by Mark Wheadon is licensed under a Creative Commons Attribution 4.0 International License. Based on a work at

Mark Wheadon [Email mark.wheadon at the usual gmail domain]


#VelocityPainting: patterning 3D prints by modulating the print speed




No releases published


No packages published