mirror of
https://github.com/BelfrySCAD/BOSL2.git
synced 2025-01-01 09:49:45 +00:00
The Belfry OpenScad Library, v2.0. An OpenSCAD library of shapes, masks, and manipulators to make working with OpenSCAD easier. BETA
ba4c00f77e
internal: can set bevel to true and get non-garbage result
bevel is always set by thread depth
acme takes tpi
square threads are at angle 0
added generic_threaded_{rod,nut}
eliminated metric_trapezoidal_*
cleaned up matrices some in generic_threaded_rod
threaded_rod can produce spec-true ISO/UTS profile with a triplet input for the diameter.
Added bevel1 and bevel2 to all modules. Made default uniformly false for every case instead of
sometimes true, sometimes false
Profiles that go over zero are not clipped, and bevels are based on actual profile top, not nominal
When bevel is given to nuts it bevels the outside of the nut by thread depth
higbee looks best with quincunx, but it's more expensive. Select quincunx when higbee is used, min_edge otherwise
Current code uses difference to remove excess length in the rod. This gives faster renders at the cost
of more complex code and green top/bottom surfaces.
Changed slop to 4 * $slop. I got good results printing with $slop=0.05 with this setting.
Removed excess threads from vnf (affects case where starts>1), don't force threads to be even
Fixed higbee in spiral_sweep for properly centered scaling and for staying on the internal/external base of threads
Fixed bug in spiral_sweep where two segments were missing if higbee is zero
|
||
|---|---|---|
| .github | ||
| examples | ||
| images | ||
| scripts | ||
| tests | ||
| tutorials | ||
| .gitignore | ||
| .openscad_gendocs_rc | ||
| affine.scad | ||
| arrays.scad | ||
| attachments.scad | ||
| beziers.scad | ||
| bosl1compat.scad | ||
| bottlecaps.scad | ||
| common.scad | ||
| constants.scad | ||
| CONTRIBUTING.md | ||
| coords.scad | ||
| cubetruss.scad | ||
| debug.scad | ||
| distributors.scad | ||
| edges.scad | ||
| fnliterals.scad | ||
| gears.scad | ||
| geometry.scad | ||
| hingesnaps.scad | ||
| hull.scad | ||
| joiners.scad | ||
| knurling.scad | ||
| LICENSE | ||
| linear_bearings.scad | ||
| masks.scad | ||
| math.scad | ||
| metric_screws.scad | ||
| modular_hose.scad | ||
| mutators.scad | ||
| nema_steppers.scad | ||
| partitions.scad | ||
| paths.scad | ||
| phillips_drive.scad | ||
| polyhedra.scad | ||
| primitives.scad | ||
| quaternions.scad | ||
| queues.scad | ||
| README.md | ||
| regions.scad | ||
| rounding.scad | ||
| screws.scad | ||
| shapes.scad | ||
| shapes2d.scad | ||
| skin.scad | ||
| sliders.scad | ||
| stacks.scad | ||
| std.scad | ||
| strings.scad | ||
| structs.scad | ||
| threading.scad | ||
| torx_drive.scad | ||
| transforms.scad | ||
| triangulation.scad | ||
| turtle3d.scad | ||
| vectors.scad | ||
| version.scad | ||
| vnf.scad | ||
| walls.scad | ||
| wiring.scad | ||
| WRITING_DOCS.md | ||
BOSL2
The Belfry OpenScad Library, v2
A library for OpenSCAD, filled with useful tools, shapes, masks, math and manipulators, designed to make OpenSCAD easier to use.
- NOTE: BOSL2 IS BETA CODE. THE CODE IS STILL BEING REORGANIZED.
- NOTE2: CODE WRITTEN FOR BOSLv1 PROBABLY WON'T WORK WITH BOSL2!
Installation
- Download the .zip or .tar.gz release file for this library.
- Unpack it. Make sure that you unpack the whole file structure. Some zipfile unpackers call this option "Use folder names". It should create either a
BOSL-v2.0orBOSL2-masterdirectory with the library files within it. You should see "examples", "scripts", "tests", and other subdirectories. - Rename the unpacked main directory to
BOSL2. - Move the
BOSL2directory into the apropriate OpenSCAD library directory for your platform:- Windows:
My Documents\OpenSCAD\libraries\ - Linux:
$HOME/.local/share/OpenSCAD/libraries/ - Mac OS X:
$HOME/Documents/OpenSCAD/libraries/
- Windows:
- Restart OpenSCAD.
Examples
A lot of the features of this library are to allow shorter, easier-to-read, intent-based coding. For example:
BOSL2/transforms.scad Examples |
Raw OpenSCAD Equivalent |
|---|---|
up(5) |
translate([0,0,5]) |
xrot(30,cp=[0,10,20]) |
translate([0,10,20]) rotate([30,0,0]) translate([0,-10,-20]) |
xcopies(20,n=3) |
for (dx=[-20,0,20]) translate([dx,0,0]) |
zrot_copies(n=6,r=20) |
for (zr=[0:5]) rotate([0,0,zr*60]) translate([20,0,0]) |
skew_xy(xa=30,ya=45) |
multmatrix([[1,0,tan(30),0],[0,1,tan(45),0],[0,0,1,0],[0,0,0,1]]) |
BOSL2/shapes.scad Examples |
Raw OpenSCAD Equivalent |
|---|---|
cube([10,20,30], anchor=BOTTOM); |
translate([0,0,15]) cube([10,20,30], center=true); |
cuboid([20,20,30], fillet=5); |
minkowski() {cube([10,10,20], center=true); sphere(r=5, $fn=32);} |
prismoid([30,40],[20,30],h=10); |
hull() {translate([0,0,0.005]) cube([30,40,0.01], center=true); translate([0,0,9.995]) cube([20,30,0.01],center=true);} |
xcyl(l=20,d=4); |
rotate([0,90,0]) cylinder(h=20, d=4, center=true); |
cyl(l=100, d=40, fillet=5); |
translate([0,0,50]) minkowski() {cylinder(h=90, d=30, center=true); sphere(r=5);} |
Documentation
The full library docs can be found at https://github.com/revarbat/BOSL2/wiki