1
0
mirror of https://github.com/JustinSDK/dotSCAD.git synced 2025-01-17 14:18:13 +01:00
dotSCAD/docs/lib3x-crystal_ball.md
2022-06-06 13:11:46 +08:00

46 lines
1.5 KiB
Markdown

# crystal_ball
Uses spherical coordinate system to create a crystal ball.
![Spherical coordinates (r, θ, φ) often used in mathematics](https://upload.wikimedia.org/wikipedia/commons/d/dc/3D_Spherical_2.svg)
## Parameters
- `radius` : The radial distance r.
- `theta` : The azimuthal angle. It defaults to 360. It also accepts a 2 element vector. The first element of the vector is the beginning angle in degrees, and the second element is the ending angle.
- `phi` : The polar angle. It defaults to 180. It also accepts a 2 element vector. The first element of the vector is the beginning angle in degrees, and the second element is the ending angle.
- `thickness` : The thickness of the ball. **Since:** 2.1
- `$fa`, `$fs`, `$fn` : Check [the circle module](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Using_the_2D_Subsystem#circle) or [the sphere module](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Primitive_Solids#sphere) for more details. The final fragments will be a multiple of 4 to fit edges.
## Examples
use <crystal_ball.scad>
crystal_ball(radius = 6);
translate([12, 0, 0])
crystal_ball(
radius = 6,
theta = 270,
thickness = 1,
$fn = 12
);
translate([24, 0, 0])
crystal_ball(
radius = 6,
theta = 270,
phi = 90,
$fn = 12
);
translate([36, 0, 0])
crystal_ball(
radius = 6,
theta = [-30, 270],
phi = [30, 60],
thickness = 2
);
![crystal_ball](images/lib3x-crystal_ball-1.JPG)