meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
en:user_guide_website [2021/05/03 08:47]
JSCAD Editor [Changing Parameters] 		en:user_guide_website [2021/09/14 01:22] (current)
JSCAD Editor [Trouble Shooting Designs]
Line 33: Line 33:
 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. 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.
  
-{{ :wiki:jscad_screen_04.png | List of Examples}}+{{ :wiki:jscad_screen_04.png | Example with Parameters}}
  
 **This is a unique feature of designs written in JSCAD. Any number of designs can be created by simply changing parameters.** **This is a unique feature of designs written in JSCAD. Any number of designs can be created by simply changing parameters.**
Line 41: Line 41:
 ==== Creating New Designs ==== ==== Creating New Designs ====
  
-tbw+Creating a new design is easy as well. Just make 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.
  
-==== More Things ====+Make a few changes, then save the file. Now, drag and drop again.
  
-  * Use your favorite editor +There's more information on the Anatomy of A Design, etc. on the left. Have a quick read and have fun!
-  * Exporting designs +
-  * Importing designs +
-  * Sharing designs+
  
 +==== Exporting Designs ====
  
 +JSCAD was created for 3D printing enthusiasts. Any design can be exported to another format, e.g. STL meshes, SVG images, etc. The supported file formats are listed on the left.
 +
 +Exporting is initiated by selecting the format, and pushing the Export button. A small pop-up window will be presented, allowing the contents to be saved as a file.
 +==== Sharing Designs ====
 +
 +Designs can be easily shared with others as file attachments to mail, messages, etc.
 +
 +In addition, a design (which is available online) can be shared using a special link (URL). You can copy and paste the link into many applications, and send. The design will be loaded and shown immediately. Here's how...
 +
 +First, obtain the link (URL) to the online design content. Here's a link to a design on Thingiverse.
 +
 +https://www.thingiverse.com/thing:1422172
 +
 +By clicking on the "Thing Files", the file called 'sliding-door-bolt.js" will be shown. COPY the link shown while hovering over the "Download" button (This should be https://www.thingiverse.com/download:9621819)
 +
 +This link (URL) can be provided as a parameter to the JSCAD website; www.openjscad.xyz
 +
 +https://www.openjscad.xyz/?uri=https://www.thingiverse.com/download:9621819
 +
 +Try it out!
 +
 +==== Trouble Shooting Designs ====
 +
 +Hopefully creating designs will be easy. The best approach is making small incremental changes and testing the results. Small parts can be created and tested separately, and brought together into the large design later.
 +
 +However, there are times when all goes wrong, and some trouble shooting is required. First, make sure the browser has the 'browser tools' or 'developer tools' enabled, as the tools are turned off sometimes. Second, open the 'tools' which is just a menu selection.
 +
 +The browser window will now have two sections; the JSCAD design and the tools. The tool of interest is the 'console', which shows errors, warning, messages, etc. This console can be cleared anytime, and will clear if the JSCAD design is reloaded.
 +
 +What's so valuable about the console?
 +
 +This will show more information about the errors. There should be a 'stack trace' as to where the error occurred.
 +
 +Also, additional messages can be sent to the console, making trouble shooting easier. For example, the contents of a parameter can be sent to the console by:
 +
 +<code javascript>
 +console.log('parameter',parameter)
 +</code>
 +
 +Hopefully, these pointers will be enough to trouble shoot any issues. If not then please contact User Group for some great help.
 ==== Install Locally ==== ==== Install Locally ====
  
Line 62: Line 100:
   - Then open index.html which is found in packages/web   - Then open index.html which is found in packages/web
  
-For those with a little more technical background, the download can be down from the command line.+For those with a little more technical background, the download can be done from the command line.
   - git clone https://github.com/jscad/OpenJSCAD.org.git   - git clone https://github.com/jscad/OpenJSCAD.org.git
   - cd OpenJSCAD.org   - cd OpenJSCAD.org
Line 69: Line 107:
 And for those that want to make changes to the website, there is [[https://github.com/jscad/OpenJSCAD.org/blob/master/CONTRIBUTING.md|a guide on making changes]]. And for those that want to make changes to the website, there is [[https://github.com/jscad/OpenJSCAD.org/blob/master/CONTRIBUTING.md|a guide on making changes]].
  
-==== Integrate into a Website ==== 
  
-The website can be integrated into an existing website.