How it works

Basic Initial setup

This jigsaw generator generates the piece shapes through Voronoi tesselation. As-is it's a quick hack reusing many of the functionality from my other generator here borrowing the normal jigsaw puzzle tab generation form this generator by draradech. You're on your own for now, I'll write some documentation eventually on how eveyrthing is supposed to work.

Custom border mode usage

In this mode, the generator will use a custom border for the jigsaw, given by a border SVG file. When you set this mode, it will prompt you to select a custom SVG border file. The SVG border file must be an SVG file defining the intended border you want to use. It must contain at least one area enclosed by strokes, and it may have holes inside. The SVG border file will be preprocessed before generating the jigsaw. First, your SVG file will be flattened. That means that all the SVG transforms will be applied and burned in, and all the stroke and fill settings will be removed. Every element (basic shapes, paths) will be stripped of fill and stroke style attributes and set to no fill and a basic black stroke. The contents of the files will be moved to the upper left corner and the extent of the drawing will be set to exactly contain all the elements.

Also, your SVG file will be stripped of dimension units information (set to unitless) and interpreted as if its dimensions were millimeters. Finally, it will be scaled up or down by the Custom border scale factor.

FAQ

Where are my border files uploaded?

Nowhere. It all stays on your computer, the border file is just loaded into your browser and used exclusively within the browser. You're basically downloading a self-contained webapp and executing it locally, in fact you can download this for totally offline use, see below.

Is this free?

Yes, it is. The code falls under the MIT license

Where can I get the code?

Here

Can I use it offline somehow?

Sure, this is all executed in your browser. Just clone the github repo or right-click save the web from your browser. It will download all the required assets, and you may run it by just opening index.html using your favorite browser.

Which browsers are supported?

As far as I know, any modern browser should work. It's been tested on the most up to date versions (August 2024) of Firefox, Chrome, Edge, and Safari.

Is this all your job?

No, I use two third-party libraries.

• A heavily modified and stripped down version of imagetracerjs 1.2.6 for vectorization (for this generator it's actually not used per se, but kept there to avoid having to change the structure too much)
• Flatten.js for SVG transform flattening.
• Draradech's jigsaw generator where I borrowed the tab generating function from..

Any known issues?

Many. This should be considered beta software, use with caution. I recommend cutting in cheap material before committing for a design, to see any potential issues before wasting expensive material. I'm not responsible for any material waste

Do you have any other jigsaw generators for different jigsaw styles?

Sure, go suit yourself

I meant normal puzzles, with rectangular pieces with tabs

This one can do it if you set Initial Grid position noise to 0, but if you don't want custom border, then draradech has a better onehas a very good one, and it's also free.

How can I contact you?

Use whatever tools github provides here to report bugs or whatever you find.