diff options
| -rw-r--r-- | openscad.html.markdown | 57 |
1 files changed, 27 insertions, 30 deletions
diff --git a/openscad.html.markdown b/openscad.html.markdown index 4e0fc696..e09b5109 100644 --- a/openscad.html.markdown +++ b/openscad.html.markdown @@ -2,42 +2,38 @@ language: openscad filename: learnopenscad.scad contributors: - - ["Thomas Preston", "https://github.com/tompreston/"] + - ["Tom Preston", "https://github.com/tompreston/"] --- Draw 3D models with code using [OpenSCAD](https://openscad.org/). ```openscad -// Single-line comments start with // +// Comments look like this -/* -Multi-line comments look like this. -*/ - -/* 3D Primitives */ +// 3D Primitives cube(10); cube([5, 10, 20]); sphere(10); -/* Transformations */ +// Transformations translate([20, 0, 0]) cube(10); rotate([0, 20, 30]) cube(10); translate([20, 0, 0]) rotate([0, 20, 30]) cube(10); rotate([0, 20, 30]) translate([20, 0, 0]) cube(10); -/* Modifiers - * * disable - * ! show only - * # highlight / debug - * % transparent / background - */ -/* For example, show only the rotated cube at the origin, before we translate it. */ +// Modifiers +// +// * disable +// ! show only +// # highlight / debug +// % transparent / background +// +// For example, show only the rotated cube at the origin, before we translate it. translate([20, 0, 0]) !rotate([0, 20, 30]) cube(10); -/* Formatting - * The following models are the same. The official docs prefer the second. - */ +// Formatting +// The following models are the same. The official docs prefer the second. rotate([0, 20, 30]) translate([20, 0, 0]) cube(10); rotate([0, 20, 30]) @@ -50,7 +46,7 @@ rotate([0, 20, 30]) { } } -/* Loops */ +// Loops num_cubes = 5; r = 20; cube_len = 5; @@ -62,11 +58,12 @@ for (i = [0:num_cubes]) { cube(cube_len, center=true); } -/* Boolean operations. - * union() - the sum of both shapes - * difference() - the first shape, minus the second shape - * intersection() - only parts of both shapes which intersect - */ +// Boolean operations +// +// union() - the sum of both shapes +// difference() - the first shape, minus the second shape +// intersection() - only parts of both shapes which intersect +// cube_l = 20; cube_w = 10; cube_h = 10; @@ -82,12 +79,12 @@ difference() { cylinder(cube_w, r=hole_r); } -/* Functions calculate values. */ +// Functions calculate values function inch2mm(i) = i * 25.4; cube(inch2mm(2)); -/* Modules create objects you want to use later. */ +// Modules create objects you want to use later module house(roof="flat", paint=[1,0,0]) { color(paint) if (roof=="flat") { @@ -101,7 +98,7 @@ module house(roof="flat", paint=[1,0,0]) { translate([0,-1,0]) { translate([0.5,0.5,1]) sphere(r=0.5,$fn=20); - cube(); + cube(); } } } @@ -109,9 +106,9 @@ module house(roof="flat", paint=[1,0,0]) { house("pitched"); translate([2, 0, 0]) house("domical"); -/* Import modules and function from other files. */ -include <filename> /* Import the content of the file as if they were written in this file. */ -use <filename> /* Import modules and functions, but do not execute any commands. */ +// Import modules and function from other files +include <filename> // Import the content of the file as if they were written in this file +use <filename> // Import modules and functions, but do not execute any commands ``` ## Further Reading |