Error-Checking In Preview Window for Customizable OpenSCAD Objects

thingiverse

The Thingiverse Customer provides a variety of input controls -- list boxes, sliders, etc. However, some things are missing. What if you need to ensure that a parameter is a number but a slider or list box isn't suitable for the range of values? Or what if more complex error checking is required, such as "these two parameters can't total more than 100"? This can be done in OpenSCAD code, but communicating the problem to the user is difficult, especially in an online environment like the Customizer where echo and assert may not work. This file allows you to create a simple shape, but that's not the point. The goal is to provide a relatively straightforward way to do parameter-checking and show the results in a format that's guaranteed to be visible -- in the preview window. You can see how this works by using the Customizer to customize this object. Try breaking it, for example, by leaving fields blank or setting things to negative or non-numeric values. If you do something that's not allowed, you'll see a message in the preview window explaining the problem. Here's how you use this approach in your own code: * Download the DisplayErrorsInPreview.scad file. * Include the appropriate parts of this code in your OpenSCAD file. * Set the "assertions" vector to the relevant error checks for your code. For each check, you'll just need to provide an OpenSCAD expression that returns true if that check passes and false if that check fails -- like "sides > 2" if the 'sides' variable should always be greater than 2 -- and an error message to display if the check fails. * Change your main drawing code to look like the sample below: if (anyassertionsfailed() { rotate([45,0,45]) showfailedassertions(); } else { dowhatyouactuallyneedtodotodrawyourobject(); } If you've customized the preview angle of your object, you'll want to change the parameters to the rotate; the .scad file comments tell you how to figure out what to use. Now, whenever the user changes parameter values in the Customizer, your error checks will run, and any errors will show up in the preview window, replacing your object. Even if someone downloads and manually changes the parameters in your .SCAD file, if they do it wrong, the error message will show up in their slicing/printer control software.