# OpenJSCAD.org **Repository Path**: mirrors_jcoleman/OpenJSCAD.org ## Basic Information - **Project Name**: OpenJSCAD.org - **Description**: OpenSCAD + JavaScript = OpenJSCAD, edit locally or remote online, preview in browser direct via WebGL. - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-09-25 - **Last Updated**: 2026-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

OpenJSCAD.org

Version 0.5.2 (ALPHA) OpenJSCAD.org is a more up-to-date OpenJsCAD frontend where you can edit .jscad files either locally or online via JS editor (built-in). A few functions are available to make the transition from OpenSCAD to OpenJSCAD easier (OpenSCAD.jscad built-in), as well CLI (command-line interface) for server-side computations with NodeJS.

Installation

Immediate Use: No installation, go to OpenJSCAD.org (Google Chrome, Firefox) Local Web Use:

% git clone https://github.com/Spiritdude/OpenJSCAD.org
% cd OpenJSCAD.org
% make install

and then access the files via local web-site and your web-browser. Local CLI Use: For CLI (command-line interface) rendering install NodeJS as well, e.g. apt-get install nodejs (be aware NodeJS > 0.8.1 or newer is required) and then test it:

% cd examples/
% openjscad example005.jscad                         # -- creates example005.stl as default
% openjscad example001.jscad -o test.stl
% openjscad example001.scad -o example001scad.jscad  # -- convert .scad into .jscad
% openjscad frog.stl -o test.jscad                   # -- convert .stl into .jscad
% openjscad logo.jscad -of amf                       # -- convert logo.jscad into logo.amf

Note: on some systems the NodeJS executable is node (default) or nodejs, edit openjscad first line to reflect this.

History

2016/10/01: 0.5.2: updated documentation links by Z3 Dev, updated Ace editor to 1.2.4, fixed AMF export to set colors only when provided, enhanced Processor constructor to support Viewer options, added big.html to provide an example of using Processor and Viewer options, enhanced Processor to retain multiple returned objects, fixed difference() and intersection() functions for CAG by fischman
2016/06/27: 0.5.1: refactored AMF import and export, enhanced STL import by adding support for MM colors by Z3 Dev,added local storage by Robert Starkey
2016/05/01: 0.5.0: added SVG import and export, added options to Processor and View classes, allow more flexibility in HTML by Z3 Dev
2016/02/25: 0.4.0: refactored, functionality split up into more files, mostly done by Z3 Dev
2015/10/23: 0.3.1: including new parameter options by Z3 Dev
2015/07/02: 0.3.0: format.js (Stefan Baumann), and Blob.js/openjscad improved by Z3 Dev
2015/05/20: 0.2.4: renumbering, latest csg.js from http://joostn.github.com/OpenJsCad/ adapted
2015/04/08: 0.024: dev branch opened
2015/02/14: 0.023: bumping version based on openscad.js
2015/02/04; 0.020: browser window resizing done properly, thanks to Z3 devs via pull request
2015/01/07: 0.019: various pull requests from github merged again
2014/10/05: 0.018: various pull requests from github merged
2013/04/11: 0.017: alpha channel supported in color() and .setColor()
2013/04/07: 0.016: csg.js: solidFromSlices() and .setColor() on polygon level, and examples by Eduard Bespalov
2013/04/05: 0.015: rudimentary AMF export and import, web and cli
2013/04/03: 0.014: multiple files via drag & drop, developing locally
2013/04/01: 0.013: include() on web-online & drag & drop (but not off-line) and cli (server-side)
2013/03/20: 0.012: improved UI (slider from the left)
2013/03/28: 0.011: added support for rectangular_extrude(), rotate_extrude() and torus()
2013/03/22: 0.010: leave .scad file intact, and translate on-the-fly
2013/03/20: 0.009: OpenSCAD .scad syntax support included via openscad-openjscad-translator module, on web and cli; and experimental .stl import support (binary & ascii)
2013/03/15: 0.008: circle(), square(), polygon() partially and linear_extrude() implemented (openscad-like)
2013/03/14: 0.007: integrating jQuery for new features; draggable hint window
2013/03/12: 0.006: included examples available in the web-frontend direct
2013/03/12: 0.005: supporting webgui parameters as of original OpenJsCad (see examples/example030.jscad)
2013/03/11: 0.004: openscad.js: many improvements, more OpenSCAD-like functions
2013/03/10: 0.003: solidify the functionality (few bug fixes)
2013/03/10: 0.001: initial version

See for more details G+ OpenJSCAD.org Announcements and G+ OpenJSCAD Community to discuss with other user and developers.

Todo

3d primitive: torus() (done)
~~OpenSCAD .scad support for both Web-GUI and CLI~~ (done)
include() for Web-GUI and CLI to include libraries and modules, support of multiple .jscad drag & drop with include() (done)
~~save from built-in editor to local~~ (done)
~~complete 2D primitives and transformations~~ (done)
~~implementation of linear_extrude() rotate_extrude(), parameter compatible to OpenSCAD~~ (done)
~~example of platonic solids (in progress, requires include())~~ (done)
~~simple 2D/3D text~~ (done)
~~2d operation: hull()~~ (done)
processing/progress bar (0..100%), perhaps even visual progress seen in the model direct
~~STL importer~~ (done) & AMF importer / exporter
integration into RepRap Cloud as first stage of the workflow

Documentation

Screenshots

Simple JSCAD example (example000.jscad):

More sophisticated JSCAD example, fully object-oriented (OO) programmed with interactive parameters (example031.jscad):

Import of STL models:

Drag & drop a local file:

Drag & drop multiple files (Chrome & Firefox) or a folder (Chrome):