openscad/dotSCAD
1
0
Fork 0
mirror of https://github.com/JustinSDK/dotSCAD.git synced 2025-08-11 17:24:20 +02:00
Code Issues Releases Wiki Activity

update doc

Browse Source
This commit is contained in:
Justin Lin
2022-08-27 15:13:05 +08:00
parent ea8fc1da2b
commit d0ea27a76c
2 changed files with 12 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/lib3x-t3d.md
View File

@@ -12,6 +12,7 @@ For more details, please see [3D turtle graphics](https://openhome.cc/eGossip/Op
- `cmd` : It accepts a string or a list of commands. - `cmd` : It accepts a string or a list of commands.
- Given a string: `"xturn"`, `"yturn"`, `"zturn"`, `"xforward"`, `"yforward"`, `"zforward"`, `"point"` or `"unit_vectors"`. If `"xturn"`, `"yturn"` or `"zturn"` is provided, the `angle` parameter is required. If `"xforward"`, `"yforward"` or `"zforward"` is provided, `leng` is required. `"point"` and `"unit_vectors"` are used to get respective data from a turtle. - Given a string: `"xturn"`, `"yturn"`, `"zturn"`, `"xforward"`, `"yforward"`, `"zforward"`, `"point"` or `"unit_vectors"`. If `"xturn"`, `"yturn"` or `"zturn"` is provided, the `angle` parameter is required. If `"xforward"`, `"yforward"` or `"zforward"` is provided, `leng` is required. `"point"` and `"unit_vectors"` are used to get respective data from a turtle.
- Given a list: `[[cmd1, value], [cmd2, value2], ...]`. For example, `[["xforward", 10], ["zturn", 120]]` will forward a turtle 10mm along the x axis and turn it 120 degrees around the z axis from your viewpoint. - Given a list: `[[cmd1, value], [cmd2, value2], ...]`. For example, `[["xforward", 10], ["zturn", 120]]` will forward a turtle 10mm along the x axis and turn it 120 degrees around the z axis from your viewpoint.
- `"roll"`, `"pitch"`, `"turn"` and `"forward"` are supported since 3.3.
- `point` : Set the position of a turtle. - `point` : Set the position of a turtle.
- `unit_vectors` : Set the unit vectors of a turtle. - `unit_vectors` : Set the unit vectors of a turtle.
- `angle` : Set the angle of a turtle if `cmd` is not provided. Turn a turtle if `cmd` is `"xturn"`, `"yturn"` or `"zturn"`. - `angle` : Set the angle of a turtle if `cmd` is not provided. Turn a turtle if `cmd` is `"xturn"`, `"yturn"` or `"zturn"`.
@@ -27,14 +28,14 @@ For more details, please see [3D turtle graphics](https://openhome.cc/eGossip/Op
thickness = 1; thickness = 1;
t = t3d(point = [0, 0, 0]); t = t3d(point = [0, 0, 0]);
t2 = t3d(t, "xforward", leng = leng); t2 = t3d(t, "forward", leng = leng);
t3 = t3d(t2, [ t3 = t3d(t2, [
["zturn", angle], ["turn", angle],
["xforward", leng] ["forward", leng]
]); ]);
t4 = t3d(t3, [ t4 = t3d(t3, [
["zturn", angle], ["turn", angle],
["xforward", leng] ["forward", leng]
]); ]);
polyline_join( polyline_join(
@@ -49,20 +50,20 @@ For more details, please see [3D turtle graphics](https://openhome.cc/eGossip/Op
module tree(t, leng, leng_scale1, leng_scale2, leng_limit, module tree(t, leng, leng_scale1, leng_scale2, leng_limit,
angleZ, angleX, width) { angleZ, angleX, width) {
if(leng > leng_limit) { if(leng > leng_limit) {
t2 = t3d(t, "xforward", leng = leng); t2 = t3d(t, "forward", leng = leng);
line3d( line3d(
t3d(t, "point"), t3d(t2, "point"), t3d(t, "point"), t3d(t2, "point"),
width); width);
tree( tree(
t3d(t2, "zturn", angle = angleZ), t3d(t2, "turn", angle = angleZ),
leng * leng_scale1, leng_scale1, leng_scale2, leng_limit, leng * leng_scale1, leng_scale1, leng_scale2, leng_limit,
angleZ, angleX, angleZ, angleX,
width); width);
tree( tree(
t3d(t2, "xturn", angle = angleX), t3d(t2, "roll", angle = angleX),
leng * leng_scale2, leng_scale1, leng_scale2, leng_limit, leng * leng_scale2, leng_scale1, leng_scale2, leng_limit,
angleZ, angleX, angleZ, angleX,
width); width);
@@ -82,4 +83,4 @@ For more details, please see [3D turtle graphics](https://openhome.cc/eGossip/Op
tree(t, leng, leng_scale1, leng_scale2, leng_limit, tree(t, leng, leng_scale1, leng_scale2, leng_limit,
angleZ, angleX, width); angleZ, angleX, width);
![t2d](images/lib3x-t3d-2.JPG) ![t3d](images/lib3x-t3d-2.JPG)

2
src/experimental/note.md
View File

@@ -11,7 +11,6 @@ new:
- surface/sf_cylinder? - surface/sf_cylinder?
- noise/worley_sphere? - noise/worley_sphere?
- voronoi/vrn_sphere? - voronoi/vrn_sphere?
- t3d - roll/pitch/forward
- polyline_join: doc multi-childs - polyline_join: doc multi-childs
- lemniscate_curve? - lemniscate_curve?
@@ -32,3 +31,4 @@ doc-ed
- triangle/tri_subdivide - triangle/tri_subdivide
- lsystem2, lsystem3, add seed param - lsystem2, lsystem3, add seed param
- t3d - roll/pitch/turn/forward