meta data for this page
  •  

This is an old revision of the document!


Website

The JSCAD website can be used immediately by visiting the project website at www.openjscad.xyz

This is a great way to learn about JSCAD, view 3D and 2D designs, and create something new. That’s what 3D printing is about!

Viewing Designs

The website presents a page without an initial design, so select an example from the list under the (?) in the above right corner. Try the first example called '2D Primitives Demonstration'.

 List of Examples

Just click the (?) again to close the list of examples.

The website presents a view of available 2D shapes, which is created from the contents of the example. The view can be rotated, zoomed in or out, and moved by using the mouse buttons. (Or fingers if using a tablet or mobile phone.)

This time open the editor from the 'pen' mark in the upper right corner. Just click inside the popup window, and the JSCAD design will be shown.

 JSCAD Design

There’s not much else to learn, as you are already using JSCAD. You may want to try a few of the other examples, and explore some of the features of JSCAD.

Making Changes

While browsing examples, you may have noticed that the contents of the editor panel also changed. These are the actual designs, which were created by writing JSCAD scripts.

You can change each of the designs by opening the editor, and changing any of the values, etc.

Try it out. Open the '2D Primitives Demonstration' again, and change line 25. Just add '⁄⁄' in front of 'star'. Now hit RETURN+SHIFT.

Changing Parameters

Some of the examples show a small panel on the lower left, which allows changes to the design parameters. For example, the “Parametric Involute Gear” example allows different values for “Number of teeth”. Change that to “20” then hit the Update button.

 Example with Parameters

This is a unique feature of designs written in JSCAD. Any number of designs can be created by simply changing parameters.

Take the “Parametric Involute Gear” example for a spin. Click 'Instant Update'. Now change any of the parameters. Its really impressive, and fun.

Creating New Designs

Creating a new design is easy as well. Create a copy of an example by cutting and pasting the script into your favorite text editor. Then save the file with an appropriate name and extension (.js) Now the file can be dragged and dropped to the website.

Make a few changes, then save the file. Now, drag and drop again.

Have fun!

More Things

  • Use your favorite editor
  • Exporting designs
  • Importing designs
  • Sharing designs

Install Locally

There is no need to install anything. Just jump to the project website at www.openjscad.xyz and start in.

However, for those who want more control, the website can be installed and used locally. The browsers of today can open locally installed or downloaded website content. And that means, you can download the project website, view and explore the contents, read the examples, etc. Here's how.

  1. Download ZIP from GitHub
  2. Place the ZIP file into a directory
  3. Unzip the contents
  4. Open the folder called OpenJSCAD.org-master
  5. Then open index.html which is found in packages/web

For those with a little more technical background, the download can be done from the command line.

  1. cd OpenJSCAD.org
  2. Then open index.html which is found in packages/web

And for those that want to make changes to the website, there is a guide on making changes.

Integrate into a Website

The website can be integrated into an existing website.