mirror of
https://github.com/JustinSDK/dotSCAD.git
synced 2025-01-17 14:18:13 +01:00
104 lines
2.7 KiB
Markdown
104 lines
2.7 KiB
Markdown
# along_with
|
|
|
|
If you want to place objects precisely, their points and angles are required. When you have only points or you don't care their precise angles, `along_with` puts children along the given path. If there's only one child, it will put the child for each point.
|
|
|
|
## Parameters
|
|
|
|
- `points` : The points along the path.
|
|
- `angles` : Rotate before translate each child. If not given, rotate children automatically according to `points` and `method`.
|
|
- `twist` : If given, each child will be twisted before applying each element of `points` and `angles`.
|
|
- `scale` : If given, each child will be scaled before applying each element of `points` and `angles`. It accepts a single value, `[sx, sy]` or `[sx, sy, sz]`.
|
|
- `method` : Which method does `along_with` take to **guess** how to rotate children if `angles` is not specified? It accepts two value, `"AXIS_ANGLE"` (default) and `"EULER_ANGLE"`. See `path_extrude` for more information. **Since:** 1.3
|
|
|
|
## Examples
|
|
|
|
use <along_with.scad>;
|
|
use <shape_circle.scad>;
|
|
|
|
$fn = 24;
|
|
|
|
points = shape_circle(radius = 50);
|
|
|
|
along_with(points)
|
|
sphere(5);
|
|
|
|
![along_with](images/lib3x-along_with-1.JPG)
|
|
|
|
use <along_with.scad>;
|
|
use <shape_circle.scad>;
|
|
|
|
$fn = 24;
|
|
|
|
points = shape_circle(radius = 50);
|
|
|
|
along_with(points) {
|
|
linear_extrude(10, center = true) text("A", valign = "center", halign = "center");
|
|
linear_extrude(5, center = true) circle(2);
|
|
sphere(1);
|
|
cube(5);
|
|
linear_extrude(10, center = true) text("A", valign = "center", halign = "center");
|
|
linear_extrude(5, center = true) circle(2);
|
|
sphere(1);
|
|
cube(5);
|
|
}
|
|
|
|
![along_with](images/lib3x-along_with-2.JPG)
|
|
|
|
use <along_with.scad>;
|
|
use <golden_spiral.scad>;
|
|
|
|
pts_angles = golden_spiral(
|
|
from = 5,
|
|
to = 11,
|
|
point_distance = 4
|
|
);
|
|
|
|
points = [for(p_a = pts_angles) p_a[0]];
|
|
angles = [for(p_a = pts_angles) p_a[1]];
|
|
|
|
along_with(points, angles)
|
|
rotate([90, 0, 0])
|
|
linear_extrude(1, center = true)
|
|
text("A", valign = "center", halign = "center");
|
|
|
|
![along_with](images/lib3x-along_with-3.JPG)
|
|
|
|
use <bezier_curve.scad>;
|
|
use <along_with.scad>;
|
|
|
|
module scales() {
|
|
module one_scale() {
|
|
rotate([0, 60, 0])
|
|
linear_extrude(1, center = true)
|
|
scale([2, 1])
|
|
circle(1.25, $fn = 24);
|
|
}
|
|
|
|
for(a = [0:30:330]) {
|
|
rotate(a)
|
|
translate([5, 0, 0])
|
|
one_scale();
|
|
|
|
rotate(a + 15)
|
|
translate([5, 0, 1.75])
|
|
one_scale();
|
|
}
|
|
}
|
|
|
|
t_step = 0.01;
|
|
|
|
p0 = [0, 0, 0];
|
|
p1 = [0, 50, 35];
|
|
p2 = [-100, 70, 0];
|
|
p3 = [30, 120, -35];
|
|
p4 = [30, 150, -40];
|
|
p5 = [0, 200, -3];
|
|
|
|
path_pts = bezier_curve(t_step,
|
|
[p0, p1, p2, p3, p4, p5]
|
|
);
|
|
|
|
along_with(path_pts, scale = 0.5)
|
|
scales();
|
|
|
|
![along_with](images/lib3x-along_with-4.JPG) |