2020-08-05 17:27:55 +08:00
# dotSCAD 2.4
2017-03-11 17:49:46 +08:00
2020-03-25 17:56:38 +08:00
> **Reduce the burden of mathematics when playing OpenSCAD.**
2017-03-11 17:49:46 +08:00
2020-08-05 17:27:55 +08:00
2017-05-08 17:18:56 +08:00
2019-08-31 17:21:32 +08:00
[](https://github.com/JustinSDK/lib-openscad/blob/master/LICENSE)
2017-03-15 15:30:24 +08:00
2017-03-27 17:36:32 +08:00
## Introduction
2020-04-10 08:05:19 +08:00
**Based on OpenSCAD 2019.05.**
2019-07-17 08:45:07 +08:00
2017-04-23 08:47:39 +08:00
OpenSCAD uses three library locations, the installation library, built-in library, and user defined libraries. It's convenient to set `OPENSCADPATH` . Check [Setting OPENSCADPATH ](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries#Setting_OPENSCADPATH ) in [OpenSCAD User Manual/Libraries ](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries ) for details.
2020-07-08 22:02:35 +08:00
**I set `OPENSCADPATH` to the `src` folder of dotSCAD so all examples here start searching modules or functions from `src` .**
2020-01-28 17:52:30 +08:00
Every module or function is located in the file which has the same name as the module or the function. For example, if you want to use the `line2d` module to draw a line, `use <line2d.scad>;` first.
2017-03-27 17:34:32 +08:00
2020-01-28 17:52:30 +08:00
use < line2d.scad > ;
2017-03-27 17:35:13 +08:00
2017-03-27 17:34:32 +08:00
line2d(p1 = [0, 0], p2 = [5, 0], width = 1);
2019-06-20 14:35:53 +08:00
Some module files are organized in a directory. For example, px_circle.scad exists in `pixel` directory. You have to prefix the directory name when including `px_circle` .
2020-01-28 17:52:30 +08:00
use < pixel / px_circle . scad > ;
2020-01-28 20:51:04 +08:00
2019-06-21 17:47:00 +08:00
points = px_circle(radius = 10);
2019-06-20 14:35:53 +08:00
for(pt = points) {
2019-06-20 18:33:22 +08:00
translate(pt) square(1);
2019-06-20 14:35:53 +08:00
}
2019-12-14 21:25:40 +08:00
## Examples
2020-10-20 17:10:30 +08:00
These examples incubate dotSCAD and dotSCAD refactors these examples. See [examples ](examples#dogfooding-examples ).
2019-12-14 21:25:40 +08:00
2020-07-19 16:53:22 +08:00
[](examples#dogfooding -examples)
2019-12-14 21:25:40 +08:00
2017-03-17 08:37:19 +08:00
## Documentation
2020-03-31 08:55:13 +08:00
### 2D Module
- [arc ](https://openhome.cc/eGossip/OpenSCAD/lib2x-arc.html )
- [pie ](https://openhome.cc/eGossip/OpenSCAD/lib2x-pie.html )
- [rounded_square ](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_square.html )
- [line2d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-line2d.html )
- [polyline2d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-polyline2d.html )
- [hull_polyline2d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-hull_polyline2d.html )
- [hexagons ](https://openhome.cc/eGossip/OpenSCAD/lib2x-hexagons.html )
- [polytransversals ](https://openhome.cc/eGossip/OpenSCAD/lib2x-polytransversals.html )
- [multi_line_text ](https://openhome.cc/eGossip/OpenSCAD/lib2x-multi_line_text.html )
### 3D Module
- [rounded_cube ](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_cube.html )
- [rounded_cylinder ](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_cylinder.html )
- [crystal_ball ](https://openhome.cc/eGossip/OpenSCAD/lib2x-crystal_ball.html )
- [line3d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-line3d.html )
- [polyline3d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-polyline3d.html )
- [hull_polyline3d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-hull_polyline3d.html )
- [function_grapher ](https://openhome.cc/eGossip/OpenSCAD/lib2x-function_grapher.html )
2020-04-08 09:54:40 +08:00
- [sweep ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sweep.html )
- [loft ](https://openhome.cc/eGossip/OpenSCAD/lib2x-loft.html )
2020-03-31 08:55:13 +08:00
- [starburst ](https://openhome.cc/eGossip/OpenSCAD/lib2x-starburst.html )
### Transformation
- [along_with ](https://openhome.cc/eGossip/OpenSCAD/lib2x-along_with.html )
- [hollow_out ](https://openhome.cc/eGossip/OpenSCAD/lib2x-hollow_out.html )
- [bend ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bend.html )
- [shear ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shear.html )
### 2D Function
- [in_shape ](https://openhome.cc/eGossip/OpenSCAD/lib2x-in_shape.html )
- [bijection_offset ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bijection_offset.html )
- [trim_shape ](https://openhome.cc/eGossip/OpenSCAD/lib2x-trim_shape.html )
- [triangulate ](https://openhome.cc/eGossip/OpenSCAD/lib2x-triangulate.html )
2020-04-08 13:09:30 +08:00
- [contours ](https://openhome.cc/eGossip/OpenSCAD/lib2x-contours.html )
2020-08-05 17:27:55 +08:00
- [lines_intersection ](https://openhome.cc/eGossip/OpenSCAD/lib2x-lines_intersection.html )
2020-03-31 08:55:13 +08:00
### 2D/3D Function
- [cross_sections ](https://openhome.cc/eGossip/OpenSCAD/lib2x-cross_sections.html )
- [paths2sections ](https://openhome.cc/eGossip/OpenSCAD/lib2x-paths2sections.html )
- [path_scaling_sections ](https://openhome.cc/eGossip/OpenSCAD/lib2x-path_scaling_sections.html )
- [bezier_surface ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_surface.html )
- [bezier_smooth ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_smooth.html )
- [midpt_smooth ](https://openhome.cc/eGossip/OpenSCAD/lib2x-midpt_smooth.html )
- [in_polyline ](https://openhome.cc/eGossip/OpenSCAD/lib2x-in_polyline.html )
2020-04-08 13:09:30 +08:00
2020-03-31 08:55:13 +08:00
### Path
- [arc_path ](https://openhome.cc/eGossip/OpenSCAD/lib2x-arc_path.html )
- [bspline_curve ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bspline_curve.html )
- [bezier_curve ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_curve.html )
- [helix ](https://openhome.cc/eGossip/OpenSCAD/lib2x-helix.html )
- [golden_spiral ](https://openhome.cc/eGossip/OpenSCAD/lib2x-golden_spiral.html )
- [archimedean_spiral ](https://openhome.cc/eGossip/OpenSCAD/lib2x-archimedean_spiral.html )
- [sphere_spiral ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sphere_spiral.html )
- [torus_knot ](https://openhome.cc/eGossip/OpenSCAD/lib2x-torus_knot.html )
### Extrusion
- [box_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-box_extrude.html )
- [ellipse_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ellipse_extrude.html )
- [stereographic_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-stereographic_extrude.html )
- [rounded_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_extrude.html )
- [bend_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bend_extrude.html )
### 2D Shape
- [shape_taiwan ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_taiwan.html )
- [shape_arc ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_arc.html )
- [shape_pie ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_pie.html )
2020-04-08 09:55:37 +08:00
- [shape_circle ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_circle.html )
2020-03-31 08:55:13 +08:00
- [shape_ellipse ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_ellipse.html )
- [shape_square ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_square.html )
- [shape_trapezium ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_trapezium.html )
- [shape_cyclicpolygon ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_cyclicpolygon.html )
- [shape_pentagram ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_pentagram.html )
- [shape_starburst ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_starburst.html )
- [shape_superformula ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_superformula.html )
- [shape_glued2circles ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_glued2circles.html )
- [shape_path_extend ](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_path_extend.html )
### 2D Shape Extrusion
- [path_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-path_extrude.html )
- [ring_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ring_extrude.html )
- [helix_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-helix_extrude.html )
- [golden_spiral_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-golden_spiral_extrude.html )
- [archimedean_spiral_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-archimedean_spiral_extrude.html )
- [sphere_spiral_extrude ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sphere_spiral_extrude.html )
### Util
- [util/sub_str ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sub_str.html )
- [util/split_str ](https://openhome.cc/eGossip/OpenSCAD/lib2x-split_str.html )
- [util/parse_number ](https://openhome.cc/eGossip/OpenSCAD/lib2x-parse_number.html )
- [util/reverse ](https://openhome.cc/eGossip/OpenSCAD/lib2x-reverse.html )
- [util/slice ](https://openhome.cc/eGossip/OpenSCAD/lib2x-slice.html )
- [util/sort ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sort.html )
- [util/rand ](https://openhome.cc/eGossip/OpenSCAD/lib2x-rand.html )
- [util/fibseq ](https://openhome.cc/eGossip/OpenSCAD/lib2x-fibseq.html )
2020-04-08 09:54:40 +08:00
- [util/bsearch ](https://openhome.cc/eGossip/OpenSCAD/lib2x-bsearch.html )
- [util/has ](https://openhome.cc/eGossip/OpenSCAD/lib2x-has.html )
- [util/dedup ](https://openhome.cc/eGossip/OpenSCAD/lib2x-dedup.html )
- [util/flat ](https://openhome.cc/eGossip/OpenSCAD/lib2x-flat.html )
2020-08-05 17:27:55 +08:00
- [util/sum ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sum.html )
- [util/zip ](https://openhome.cc/eGossip/OpenSCAD/lib2x-zip.html )
2020-03-31 08:55:13 +08:00
### Matrix
- [matrix/m_cumulate ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_cumulate.html )
- [matrix/m_translation ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_translation.html )
- [matrix/m_rotation ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_rotation.html )
- [matrix/m_scaling ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_scaling.html )
- [matrix/m_mirror ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_mirror.html )
- [matrix/m_shearing ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_shearing.html )
2020-08-05 17:27:55 +08:00
- [matrix/m_determinant ](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_determinant.html )
2020-03-31 08:55:13 +08:00
2020-04-08 09:54:40 +08:00
### Point Transformation
2020-03-31 08:55:13 +08:00
- [ptf/ptf_rotate ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_rotate.html )
- [ptf/ptf_x_twist ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_x_twist.html )
- [ptf/ptf_y_twist ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_y_twist.html )
- [ptf/ptf_circle ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_circle.html )
- [ptf/ptf_bend ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_bend.html )
- [ptf/ptf_ring ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_ring.html )
- [ptf/ptf_sphere ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_sphere.html )
- [ptf/ptf_torus ](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_torus.html )
2020-03-30 09:26:57 +08:00
2020-03-17 11:48:20 +08:00
----
2020-03-31 08:55:13 +08:00
### Turtle
- [turtle/turtle2d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-turtle2d.html )
- [turtle/turtle3d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-turtle3d.html )
- [turtle/t2d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-t2d.html )
- [turtle/t3d ](https://openhome.cc/eGossip/OpenSCAD/lib2x-t3d.html )
2020-08-05 17:27:55 +08:00
- [turtle/footprints2 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-footprints2.html )
- [turtle/footprints3 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-footprints3.html )
- [turtle/lsystem2 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-lsystem2.html )
- [turtle/lsystem3 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-lsystem3.html )
2020-03-31 08:55:13 +08:00
2020-08-05 17:27:55 +08:00
### Voxel
- [voxel/vx_line ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_line.html )
- [voxel/vx_polyline ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_polyline.html )
- [voxel/vx_circle ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_circle.html )
- [voxel/vx_cylinder ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_cylinder.html )
- [voxel/vx_sphere ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_sphere.html )
- [voxel/vx_polygon ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_polygon.html )
- [voxel/vx_from ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_from.html )
- [voxel/vx_ascii ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_ascii.html )
- [voxel/vx_gray ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_gray.html )
- [voxel/vx_union ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_union.html )
- [voxel/vx_intersection ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_intersection.html )
- [voxel/vx_difference ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vx_difference.html )
2020-03-31 08:55:13 +08:00
### Part
- [part/connector_peg ](https://openhome.cc/eGossip/OpenSCAD/lib2x-connector_peg.html )
- [part/cone ](https://openhome.cc/eGossip/OpenSCAD/lib2x-cone.html )
- [part/joint_T ](https://openhome.cc/eGossip/OpenSCAD/lib2x-joint_T.html )
2020-04-08 09:54:40 +08:00
### Surface
2020-03-31 08:55:13 +08:00
- [surface/sf_square ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_square.html )
2020-04-01 09:16:03 +08:00
- [surface/sf_bend ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_bend.html )
2020-04-01 16:29:33 +08:00
- [surface/sf_ring ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_ring.html )
2020-04-02 17:10:47 +08:00
- [surface/sf_sphere ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_sphere.html )
2020-04-02 17:48:38 +08:00
- [surface/sf_torus ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_torus.html )
2020-04-02 18:15:05 +08:00
- [surface/sf_solidify ](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_solidify.html )
2020-03-31 08:55:13 +08:00
2020-04-08 09:54:40 +08:00
### Noise
2020-04-05 20:12:08 +08:00
- [noise/nz_perlin1 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1.html )
- [noise/nz_perlin1s ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1s.html )
2020-04-06 09:21:53 +08:00
- [noise/nz_perlin2 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2.html )
- [noise/nz_perlin2s ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2s.html )
2020-04-06 13:17:50 +08:00
- [noise/nz_perlin3 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3.html )
- [noise/nz_perlin3s ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3s.html )
2020-04-06 17:29:11 +08:00
- [noise/nz_worley2 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2.html )
2020-04-06 17:42:48 +08:00
- [noise/nz_worley2s ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2s.html )
2020-04-07 17:57:27 +08:00
- [noise/nz_worley3 ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3.html )
- [noise/nz_worley3s ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3s.html )
2020-04-08 09:33:25 +08:00
- [noise/nz_cell ](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_cell.html )
2020-03-30 09:29:28 +08:00
2020-06-10 20:17:33 +08:00
### Voronoi
2020-08-05 17:27:55 +08:00
2020-06-17 21:07:40 +08:00
- [voronoi/vrn2_from ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn2_from.html )
2020-06-21 09:38:37 +08:00
- [voronoi/vrn2_space ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn2_space.html )
2020-06-20 14:48:19 +08:00
- [voronoi/vrn2_cells_from ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn2_cells_from.html )
2020-07-04 11:06:25 +08:00
- [voronoi/vrn2_cells_space ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn2_cells_space.html )
2020-07-07 11:31:49 +08:00
- [voronoi/vrn3_from ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn3_from.html )
2020-07-19 16:38:28 +08:00
- [voronoi/vrn3_space ](https://openhome.cc/eGossip/OpenSCAD/lib2x-vrn3_space.html )
2020-06-10 20:17:33 +08:00
2020-05-24 16:24:26 +08:00
----
2020-05-24 09:57:22 +08:00
2017-03-29 11:52:52 +08:00
## Bugs and Feedback
For bugs, questions and discussions please use the [Github Issues ](https://github.com/JustinSDK/dotSCAD/issues ).
2017-03-27 17:34:32 +08:00
## About dotSCAD
2020-07-19 16:53:22 +08:00
I've been using OpenSCAD for years. Some of [my works ](examples#dogfooding-examples ) include reusable implementations so I elaborate them into this library.
2017-03-30 14:46:10 +08:00
The idea of the name dotSCAD comes from the filename extension ".scad" of OpenSCAD.
