2017-08-30 00:59:43 +00:00
|
|
|
# BOSL
|
|
|
|
The Belfry OpenScad Library - A library of tools, shapes, and helpers to make OpenScad easier to use.
|
|
|
|
|
|
|
|
This library is a set of useful tools, shapes and manipulators that I developed while working on various
|
|
|
|
projects, including large ones like the Snappy-Reprap printed 3D printer.
|
|
|
|
|
2019-02-22 06:00:32 +00:00
|
|
|
|
|
|
|
## Terminology
|
|
|
|
For purposes of the BOSL library, the following terms apply:
|
|
|
|
- **Left**: Towards X-
|
|
|
|
- **Right**: Towards X+
|
|
|
|
- **Front**/**Forward**: Towards Y-
|
|
|
|
- **Back**/**Behind**: Towards Y+
|
|
|
|
- **Bottom**/**Down**/**Below**: Towards Z-
|
|
|
|
- **Top**/**Up**/**Above**: Towards Z+
|
|
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
A lot of the features of this library are to allow shorter, easier-to-read, intent-based coding. For example:
|
|
|
|
|
|
|
|
`BOSL/transforms.scad` Examples | Raw OpenSCAD Equivalent
|
|
|
|
------------------------------------ | -------------------------------
|
|
|
|
`up(5) ...` | `translate([0,0,5]) ...`
|
|
|
|
`yrot(45) ...` | `rotate([0,45,0]) ...`
|
|
|
|
`xrot(30, cp=[0, 10, 20]) ...` | `translate([0,10,20]) rotate([30,0,0]) translate([0,-10,-20]) ...`
|
|
|
|
`xspread(20, n=3) ...` | `for (dx=[-20,0,20]) translate([dx,0,0]) ...`
|
|
|
|
`zring(n=6, r=20) ...` | `for (zr=[0:5]) rotate([0,0,zr*60]) translate([20,0,0]) ...`
|
|
|
|
`zflip_copy() shape();` | `shape(); mirror([0,0,1]) shape();`
|
|
|
|
`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]]) ...`
|
|
|
|
`top_half(100) shape();` | `difference() {shape(); translate([0,0,-50]) cube(100, center=true);}`
|
|
|
|
|
|
|
|
`BOSL/shapes.scad` Examples | Raw OpenSCAD Equivalent
|
|
|
|
------------------------------------ | -------------------------------
|
|
|
|
`upcube([10,20,30]);` | `translate([0,0,15]) cube([10,20,30], center=true);`
|
|
|
|
`rcube([20,20,30], r=5, $fn=32);` | `minkowski() {cube([10,10,20], center=true); sphere(r=5, $fn=32);}`
|
|
|
|
`chamfcube([20,20,30], chamfer=5);` | `hull() {cube([10,10,30], center=true); cube([10,20,20], center=true); cube([20,10,20], center=true); cube([15,15,25], center=true);}`
|
|
|
|
`trapezoid([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);`
|
|
|
|
`rcylinder(h=100, d=40, fillet=5);` | `translate([0,0,50]) minkowski() {cylinder(h=90, d=30, center=true); sphere(r=5);}`
|
|
|
|
`torus(r=30, r2=5);` | `rotate_extrude(convexity=4) translate([30,0,0]) circle(r=5);`
|
|
|
|
|
|
|
|
`BOSL/masks.scad` Examples | Raw Openscad Equivalent
|
|
|
|
------------------------------------ | -------------------------------
|
|
|
|
`chamfer_mask_z(l=20, chamfer=5);` | `rotate(45) cube([5*sqrt(2), 5*sqrt(2), 20], center=true);`
|
|
|
|
`fillet_mask_z(l=20, fillet=5);` | `difference() {cube([10,10,20], center=true); for(dx=[-5,5],dy=[-5,5]) translate([dx,dy,0]) cylinder(h=20.1, r=5, center=true);}`
|
|
|
|
`fillet_hole_mask(r=30, fillet=5);` | `difference() {cube([70,70,10], center=true); translate([0,0,-5]) rotate_extrude(convexity=4) translate([30,0,0]) circle(r=5);}`
|
|
|
|
|
|
|
|
|
|
|
|
## The Library Files
|
2017-08-30 01:57:37 +00:00
|
|
|
The library files are as follows:
|
2017-08-30 00:59:43 +00:00
|
|
|
|
2019-02-22 06:00:32 +00:00
|
|
|
### Commonly Used
|
|
|
|
- [`transforms.scad`](wiki/transforms.scad): The most commonly used transformations, manipulations, and shortcuts are in this file.
|
|
|
|
- [`shapes.scad`](wiki/shapes.scad): Common useful shapes and structured objects.
|
|
|
|
- [`masks.scad`](wiki/masks.scad): Shapes that are useful for masking with `difference()` and `intersect()`.
|
|
|
|
- [`threading.scad`](wiki/threading.scad): Modules to make triangular and trapezoidal threaded rods and nuts.
|
|
|
|
- [`paths.scad`](wiki/paths.scad): Functions and modules to work with arbitrary 3D paths.
|
|
|
|
- [`beziers.scad`](wiki/beziers.scad): Functions and modules to work with bezier curves.
|
2017-08-30 00:59:43 +00:00
|
|
|
|
2019-02-22 06:00:32 +00:00
|
|
|
### Standard Parts
|
|
|
|
- [`involute_gears.scad`](wiki/involute_gears.scad): Modules and functions to make involute gears and racks.
|
|
|
|
- [`joiners.scad`](wiki/joiners.scad): Modules to make joiner shapes for connecting separately printed objects.
|
|
|
|
- [`sliders.scad`](wiki/sliders.scad): Modules for creating simple sliders and rails.
|
|
|
|
- [`metric_screws.scad`](wiki/metric_screws.scad): Functions and modules to make metric screws, nuts, and screwholes.
|
|
|
|
- [`linear_bearings.scad`](wiki/linear_bearings.scad): Modules to make mounts for LMxUU style linear bearings.
|
|
|
|
- [`nema_steppers.scad`](wiki/nema_steppers.scad): Modules to make mounting holes for NEMA motors.
|
|
|
|
- [`phillips_drive.scad`](wiki/phillips_drive.scad): Modules to create Phillips screwdriver tips.
|
|
|
|
- [`torx_drive.scad`](wiki/torx_drive.scad): Functions and Modules to create Torx bit drive holes.
|
|
|
|
- [`wiring.scad`](wiki/wiring.scad): Modules to render routed bundles of wires.
|
2017-08-30 01:57:37 +00:00
|
|
|
|
2019-02-22 06:00:32 +00:00
|
|
|
### Miscellaneous
|
|
|
|
- [`math.scad`](wiki/math.scad): Useful helper functions.
|
|
|
|
- [`constants.scad`](wiki/constants.scad): Useful constants for vectors, edges, etc.
|
|
|
|
- [`quaternions.scad`](wiki/quaternions.scad): Functions to work with quaternion rotations.
|
|
|
|
- [`debug.scad`](wiki/debug.scad): Modules to help debug creation of beziers, `polygons()`s and `polyhedron()`s
|
2017-08-31 03:29:49 +00:00
|
|
|
|
|
|
|
## Documentation
|
|
|
|
The full library docs can be found at https://github.com/revarbat/BOSL/wiki
|
|
|
|
|