CNC, Maker, Programming, Woodworking, X-Carve

Generating and Cutting Halftone Images on the X-Carve

Halftone is an app I’ve written for making halftone-style carves with Inventables’s Easel CNC design platform. A halftone image uses different sized dots to represent light and dark areas.

Upload an image, and Halftone will convert it to a grid of holes with each hole sized to reflect the brightness of the image at that point. Darker areas are represented by wider holes; if you’re going to backlight your carve, you can invert it and have lighter areas use wider holes.

Using Halftone

Choose an image to upload:

Halftone will generate the appropriate cuts at the default resolution.

Increase the resolution to raise the number of holes that will be carved.

This is the result of running Halftone on the above image at a resolution of 100. This carve used a 1/16″ bit, so any holes smaller than that were skipped.

Setting Up Halftone

Halftone hasn’t yet been approved by Inventables for public use, but until it is, you can run it by following these steps:

  1. Visit and click “New App.”
  2. Create a new app called Halftone. (You may need to request access to the app development system from Inventables first.) Upload a thumbnail and choose API version 2.0.0.
  3. Replace all of the code in the editor with the code from
  4. Click Save.

Open or refresh Easel, click on the Apps button, and if you scroll all the way down, you should see your Halftone app, ready to use.

If you stop now, Halftone should work just fine, but it will be sending your images to my server for processing. If you’re not comfortable with that, follow these steps to set up image processing on your own server:

  1. Copy the code from and upload it to a location of your choosing.
  2. Modify your Halftone app code in Easel and replace with the URL that you uploaded the code to in the previous step.

Your images should now be processed on your own server.

All of the code for Halftone is available on GitHub. If you have any issues with it, feel free to comment below, open a GitHub issue, or email me directly at If you use Halftone to carve something, post a picture of it in the comments; I’d love to see it.


2 comments on “Generating and Cutting Halftone Images on the X-Carve

  1. Steven says:

    That’s so cool! I could see this being used for an awesome personalized gift. Like wedding photos and such. Thanks for sharing with the world!

Leave a Reply

Your email address will not be published. Required fields are marked *