NopSCADlib/utils/core/teardrops.scad

//
// NopSCADlib Copyright Chris Palmer 2018
// nop.head@gmail.com
// hydraraptor.blogspot.com
//
// This file is part of NopSCADlib.
//
// NopSCADlib is free software: you can redistribute it and/or modify it under the terms of the
// GNU General Public License as published by the Free Software Foundation, either version 3 of
// the License, or (at your option) any later version.
//
// NopSCADlib is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
// without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
// See the GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License along with NopSCADlib.
// If not, see <https://www.gnu.org/licenses/>.
//

//
//! For making horizontal holes that don't need support material.
//! Small holes can get away without it, but they print better with truncated teardrops.
//
module teardrop(h, r, center = true, truncate = true, chamfer = 0) { //! For making horizontal holes that don't need support material, set ```truncate = false``` to make traditional RepRap teardrops that don't even need bridging
    module teardrop_2d(r, truncate) {
        hull() {
            circle4n(r);
            if(truncate)
                translate([0, r / 2])
                    square([2 * r * (sqrt(2) - 1), r], center = true);
            else
                polygon([[0, 0], [eps, 0], [0, r * sqrt(2)]]);
        }
    }

    render(convexity = 5)
        extrude_if(h, center)
            teardrop_2d(r, truncate);

    teardrop_chamfer(h, center, chamfer) {
        linear_extrude(eps, center = true)
            teardrop_2d(r + chamfer / 2, truncate);
        translate_z(-chamfer / 2)
            linear_extrude(eps, center = true)
                teardrop_2d(r, truncate);
    }
}

module semi_teardrop(h, r, d = undef, center = true, chamfer = 0) { //! A semi teardrop in the positive Y domain
    module semi_teardrop_2d(r, d) {
        intersection() {
            R = is_undef(d) ? r : d / 2;
            teardrop(r = R, h = 0);

            sq = R + 1;
            translate([-sq, 0])
                square([2 * sq, sq]);
        }
    }

    render(convexity = 5)
        extrude_if(h, center)
            semi_teardrop_2d(r, d);

    teardrop_chamfer(h, center, chamfer) {
        linear_extrude(eps, center = true)
            semi_teardrop_2d(r + chamfer / 2, d);
        translate_z(-chamfer / 2)
            linear_extrude(eps, center = true)
                semi_teardrop_2d(r, d);
    }
}

module teardrop_plus(h, r, center = true, truncate = true, chamfer = 0) //! Slightly bigger teardrop to allow for the 3D printing staircase effect
    teardrop(h, r + layer_height / 4, center, truncate, chamfer);

module tearslot(h, r, w, center = true, chamfer = 0) { //! A horizontal slot that doesn't need support material
    module tearslot_2d(r, w) {
        hull() {
            translate([-w / 2, 0]) teardrop(r = r, h = 0);
            translate([w / 2, 0]) teardrop(r = r, h = 0);
        }
    }

    extrude_if(h, center)
        tearslot_2d(r, w);

    teardrop_chamfer(h, center, chamfer) {
        linear_extrude(eps, center = true)
            tearslot_2d(r + chamfer / 2, w);
        translate_z(-chamfer / 2)
            linear_extrude(eps, center = true)
                tearslot_2d(r, w);
    }
}

module vertical_tearslot(h, r, l, center = true, chamfer = 0) { //! A vertical slot that doesn't need support material
    module vertical_tearslot_2d(r, l) {
        hull() {
            translate([0,  l / 2]) teardrop(0, r, true);
            translate([0, -l / 2]) circle4n(r);
        }
    }

    extrude_if(h, center)
        vertical_tearslot_2d(r, l);

    teardrop_chamfer(h, center, chamfer) {
        linear_extrude(eps, center = true)
            vertical_tearslot_2d(r + chamfer / 2, l);
        translate_z(-chamfer / 2)
            linear_extrude(eps, center = true)
                vertical_tearslot_2d(r, l);
    }
}

module teardrop_chamfer(h, center, chamfer) { //! Helper module for adding chamfer to a teardrop
    if(h && chamfer)
        translate_z(center ? 0 : h / 2)
            for(m = [0, 1])
                mirror([0, 0, m])
                    translate_z((h - eps ) / 2)
                        hull()
                            children();
}