mirror of
https://github.com/BelfrySCAD/BOSL2.git
synced 2024-12-28 15:59:45 +00:00
The Belfry OpenScad Library, v2.0. An OpenSCAD library of shapes, masks, and manipulators to make working with OpenSCAD easier. BETA
d3f13ab0dc
Currently, affine2d_skew and affine3d_skew_xy have different behaviour. Similarly, affine3d_skew_xz and affine3d_skew_yz do not skew the same was as affine2d_skew does (if you were to look down the third axis at the relevant plane). This commit brings them into agreement. |
||
|---|---|---|
| .github | ||
| examples | ||
| images | ||
| scripts | ||
| tests | ||
| tutorials | ||
| .gitignore | ||
| .openscad_docsgen_rc | ||
| .openscad_mdimggen_rc | ||
| affine.scad | ||
| attachments.scad | ||
| beziers.scad | ||
| bosl1compat.scad | ||
| bottlecaps.scad | ||
| builtins.scad | ||
| color.scad | ||
| comparisons.scad | ||
| constants.scad | ||
| CONTRIBUTING.md | ||
| coords.scad | ||
| cubetruss.scad | ||
| distributors.scad | ||
| drawing.scad | ||
| fnliterals.scad | ||
| gears.scad | ||
| geometry.scad | ||
| hingesnaps.scad | ||
| joiners.scad | ||
| LICENSE | ||
| linalg.scad | ||
| linear_bearings.scad | ||
| lists.scad | ||
| masks2d.scad | ||
| masks3d.scad | ||
| math.scad | ||
| metric_screws.scad | ||
| modular_hose.scad | ||
| mutators.scad | ||
| nema_steppers.scad | ||
| partitions.scad | ||
| paths.scad | ||
| polyhedra.scad | ||
| README.md | ||
| regions.scad | ||
| rounding.scad | ||
| screw_drive.scad | ||
| screws.scad | ||
| shapes2d.scad | ||
| shapes3d.scad | ||
| skin.scad | ||
| sliders.scad | ||
| std.scad | ||
| strings.scad | ||
| structs.scad | ||
| threading.scad | ||
| transforms.scad | ||
| trigonometry.scad | ||
| turtle3d.scad | ||
| utility.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