openscad_soften 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cc236e80666fea49bde70b97225afe914f6a4d1a0c6071ad82366c5961af2732
+  data.tar.gz: 87e3b8303b177cd8cb32679dd7ee554c125ec7311cfc4afca4852d8763cb0361
+SHA512:
+  metadata.gz: d327581765071212010717acf0fa37a18d5c9fb5d9a0a0a4de4fd29488daf0b80063c3899c8454057741c8402f1b187f1f0f0034dfa45cb225e8fcd9632845d5
+  data.tar.gz: 8648c8d01e06e79d5108f5c8ca127288919f4a2bb57c0b0fe25af8cfd988eb3a4592ba9511547cf26c14425dc1c8ad3ed0615858fd54bddda6692e9853598691

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Joe Francis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/openscad_soften.gemspec

@@ -0,0 +1,20 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "openscad_soften"
+  spec.version       = '0.1.0'
+  spec.authors       = ["Joe Francis"]
+  spec.email         = ["joe@lostapathy.com"]
+  spec.homepage      = 'https://github.com/lostapathy/openscad-libs/'
+
+  spec.summary       = %q{OpenSCAD modules for generating a collection of shapes and solids that have been softened with rounded edges, chamfers, round overs, or fillets.}
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.add_dependency "openscad_util", '~> 0'
+end

data/soften/chamfer.scad

@@ -0,0 +1,15 @@
+include <constants/all.scad>
+
+module chamfer(length, r, axis=x_axis) {
+  rotates = [[0,90,0],[90,0,0],[0,0,0]];
+  mirrors = [[0,0,1],[0,1,0],[0,0,0]];
+  mirror(mirrors[axis])
+    rotate(rotates[axis]) linear_extrude(length) {
+      chamfer_profile(r);
+  }
+}
+
+module chamfer_profile(r) {
+  polygon([[-r,0], [-r,epsilon], [epsilon, epsilon], [epsilon, -r],[0,-r]]);
+}
+

data/soften/cube.scad

@@ -0,0 +1,34 @@
+use <layout/layout.scad>
+use <validation/validate.scad>
+use <soften/fillet.scad>
+use <soften/square.scad>
+include <constants/all.scad>
+
+module soft_cube(size, r=0, center=false, sidesonly=true) {
+  x_dim = len(size) ? size.x : size;
+  y_dim = len(size) ? size.y : size;
+  z_dim = len(size) ? size.z : size;
+  if(r == 0) {
+    cube(size, center);
+  } else if(sidesonly) {
+    render()
+      translate(center ? [0,0,-z_dim/2] : [x_dim/2, y_dim/2,0])
+        linear_extrude(z_dim)
+          soft_square([x_dim, y_dim], r, center=true);
+  } else {
+    // FIXME: this has different $fn for different corners
+    hull() 
+    difference() {
+      soft_cube(size,r=r,center=true);
+      mirror_xyz()
+        translate([-x_dim/2, -y_dim/2, -z_dim/2]) fillet(x_dim, r, x_axis);
+      mirror_xyz()
+        translate([-x_dim/2, -y_dim/2, -z_dim/2]) fillet(y_dim, r, y_axis);
+
+      mirror_xyz() difference() {
+        translate([-x_dim/2, -y_dim/2, -z_dim/2]) cube(r);
+        translate([-x_dim/2+r, -y_dim/2+r, -z_dim/2+r]) sphere(r=r);
+      }
+    }
+  }
+}

data/soften/cylinder.scad

@@ -0,0 +1,37 @@
+include <constants/all.scad>
+include <soften/fillet.scad>
+
+module soft_cylinder(d, r, h,
+                     d1, d2, chamfer=0,
+                     roundover_r=0, fillet_r=0,
+                     fillet_angle=360) {
+  my_d = d ? d : d1;
+  d1 = d1 ? d1 : my_d;
+  d2 = d2 ? d2 : my_d;
+  $fn = fn(my_d/2+fillet_r);
+  hull() difference() {
+    union() {
+      height = fillet_r ? h + epsilon : h;
+      translate([0,0,fillet_r? -epsilon : 0]) cylinder(d1=d1,d2=d2,h=height);
+    }
+    if(chamfer > 0) {
+      rotate_extrude()
+        translate([d/2,h-chamfer])
+          polygon([ [epsilon,epsilon],
+                    [-chamfer-epsilon, chamfer+epsilon],
+                    [epsilon, chamfer]]);
+    }
+    else if(roundover_r > 0) {
+      rotate_extrude()
+        translate([d/2-roundover_r,h-roundover_r])
+          difference() {
+            square(roundover_r+2*epsilon);
+            circle(r=roundover_r);
+          }
+    }
+  }
+  if(fillet_r > 0) {
+    circular_fillet(d=d, r=fillet_r, angle=fillet_angle);
+  }
+}
+

data/soften/demo/chamfer-demo.scad

@@ -0,0 +1,5 @@
+use <soften/chamfer.scad>
+
+chamfer_profile(10);
+
+translate([5,0,0]) chamfer(100, 10);

data/soften/demo/cube-demo.scad

@@ -0,0 +1,5 @@
+use <soften/cube.scad>
+
+soft_cube(25, center=true, r=3, sidesonly=false);
+translate([35,0,0]) soft_cube(25, center=true, r=3);
+translate([55,0,0]) soft_cube(25);

data/soften/demo/cylinder-demo.scad

@@ -0,0 +1,4 @@
+use <soften/cylinder.scad>
+
+soft_cylinder(d1=10, d2=5, h=15);
+translate([25,0,0]) soft_cylinder(d=12, h=15,roundover_r=5, fillet_r=3, fillet_angle=180);

data/soften/demo/fillet-demo.scad

@@ -0,0 +1,10 @@
+use <soften/fillet.scad>
+include <constants/all.scad>
+
+fillet_profile(10,120);
+
+translate([25,0,0]) inside_fillets([25,25,15], fillet_r=3);
+
+translate([50,0,0]) fillet(25,5,x_axis);
+
+translate([90,0,0]) fillet_corner(5);

data/soften/demo/hole-demo.scad

@@ -0,0 +1,4 @@
+use <soften/hole.scad>
+
+hole(h=20,d1=10, d2=5);
+translate([25,0,0]) hole(d=10, h=25, top_r=3);

data/soften/demo/square-demo.scad

@@ -0,0 +1,7 @@
+use <soften/square.scad>
+
+soft_square(25);
+translate([30,0,0]) soft_square(25, r=3);
+translate([75,0,0]) soft_square(25, r=5, center=true);
+
+//translate([105,0,0]) soft_square(25, r=15, center=true);

data/soften/fillet.scad

@@ -0,0 +1,86 @@
+include <constants/all.scad>
+use <layout/layout.scad>
+use <soften/hole.scad>
+use <soften/cylinder.scad>
+
+function fillet_fn(fn, r) = ceil(min(max(fn, 12), r*6) / 4) * 8;
+
+module fillet(length, r, axis=x_axis) {
+  $fn = fillet_fn($fn, r);
+  rotates = [[0,90,0],[90,0,0],[0,0,0]];
+  mirrors = [[0,0,1],[0,1,0],[0,0,0]];
+  mirror(mirrors[axis])
+    rotate(rotates[axis])
+      linear_extrude(length)
+        fillet_profile(r, 90);
+}
+
+
+module circular_fillet(d,r=5, angle=360,fillet_angle=90) {
+  rotate_extrude(angle=angle)
+    translate([d/2,0])
+      fillet_profile(r,fillet_angle, $fn = fillet_fn($fn, r));
+}
+
+module fillet_corner(r=0) {
+    render() intersection() {
+        fillet(r+epsilon, r, x_axis);
+        fillet(r+epsilon,r,y_axis);
+    }
+}
+
+module fillet_profile(r, angle) {
+  $fn = fillet_fn($fn, r);
+  chord = r * sin(angle/2);
+  leg = tan(90-angle/2)*r;
+  rotate(-angle/2)
+    difference() {
+      rotate(angle/2)
+        polygon([
+          [-epsilon, -epsilon],
+          [-epsilon, leg], [0,leg],
+          [sin(angle)*leg, cos(angle)*leg],
+          [sin(angle)*leg, cos(angle)*leg-epsilon]
+        ]);
+      translate([0,r/cos(90-angle/2)])
+        circle(r=r);
+    }
+}
+
+module filleted_cube(size, fillet_r=0) {
+  translate([0,0,-epsilon/2])
+    cube(size+[0,0,epsilon], center=true);
+  mirror_y() {
+    translate([-size[0]/2,size[1]/2,-size[2]/2]) fillet(size[0],fillet_r,x_axis);
+  }
+  mirror_x() {
+      translate([size[0]/2,-size[1]/2,-size[2]/2]) fillet(size[1],fillet_r,y_axis);
+  }
+
+  mirror_xy() {
+      translate([size[0]/2, size[1]/2, -size[2]/2]) fillet_corner(fillet_r);
+  }
+}
+
+module inside_fillets(size, fillet_r=0) {
+  $fn = fillet_fn($fn, fillet_r);
+  mirror_y() {
+    translate([-size[0]/2,-size[1]/2,0]) fillet(size[0],fillet_r,x_axis);
+  }
+  mirror_x() {
+      translate([-size[0]/2,-size[1]/2,0]) fillet(size[1],fillet_r,y_axis);
+  }
+
+  // vericals only if h>0?
+  mirror_xy() {
+    translate([-size[0]/2,-size[1]/2,0]) fillet(size[2],fillet_r,z_axis);
+  }
+
+  // FIXME: extract this into some sort of inside_fillet()-type module
+  mirror_xy() {
+     difference() {
+        translate([-size[0]/2,-size[1]/2,0]) cube([fillet_r,fillet_r,fillet_r]);
+        translate([-size[0]/2+fillet_r,-size[1]/2+fillet_r,fillet_r]) sphere(r=fillet_r);
+     }
+  }
+}

data/soften/hole.scad

@@ -0,0 +1,53 @@
+use <validation/validate.scad>
+include <constants/all.scad>
+
+module hole(h, d, d1, d2, bottom_r=0, top_chamfer=0, top_r=0) {
+
+  function apothem(d, n) = d / 2 / cos (180 / n);
+
+  input_top_d = d1 ? d1 : d;
+  input_bot_d = d2 ? d2 : d;
+
+  n = max(round(input_top_d * 2), 12, $fn);
+
+  bot_d = apothem(input_bot_d, n)*2;
+  top_d = apothem(input_top_d, n)*2;
+
+  $fn = n;
+  height = h + epsilon;
+  d = d ? d : d1;
+  translate([0,0,-h]) hull() difference() {
+
+    cylinder(h = height, d1=bot_d, d2=top_d, $fn = n);
+    if(bottom_r > 0) {
+      validate(bot_d >= 2*bottom_r, "bottom_r must be less than  half x-dimension");
+      rotate_extrude($fn=n) translate([d/2-bottom_r, 0]) {
+        difference() {
+          translate([0, -2*epsilon]) square(bottom_r+2*epsilon);
+          translate([0, bottom_r]) circle(r=bottom_r);
+        }
+      }
+    }
+  }
+
+  validate(top_chamfer == 0 || top_r == 0, "cannot both chamfer and round top of a hole");
+  if(top_chamfer > 0){
+    translate([0,0,-top_chamfer]) {
+      // FIXME: this hull() is a hack to get around $fn mismatch
+      hull()
+        rotate_extrude()
+          translate([d/2-epsilon,0])
+            polygon([[0,0], [0,top_chamfer+epsilon], [top_chamfer+epsilon, top_chamfer+epsilon]]);
+    }
+  } else if(top_r > 0) {
+    // FIXME: extract profile like we did on circular_fillet
+    translate([0,0,-top_r])
+      rotate_extrude()
+        translate([d/2-epsilon,0])
+          difference() {
+            square(top_r+epsilon);
+            translate([top_r+epsilon,0]) circle(r=top_r);
+          }
+  }
+}
+

data/soften/square.scad

@@ -0,0 +1,23 @@
+use <validation/validate.scad>
+use <layout/layout.scad>
+
+module soft_square(size, r=0, center=false) {
+  x_dim = len(size) ? size.x : size;
+  y_dim = len(size) ? size.y : size;
+
+  validate(x_dim >= 2*r, "radius must be less than  half x-dimension");
+
+  translate(center ? [0,0] : [x_dim/2, y_dim/2]) {
+    if(r > 0) {
+      hull() {
+        square([x_dim, y_dim-2*r], center=true);
+        square([x_dim-2*r, y_dim], center=true);
+         mirror_xy() {
+          translate([x_dim/2-r, y_dim/2-r]) circle(r=r);
+        }
+      }
+    } else {
+      square([x_dim, y_dim], center=true);
+    }
+  }
+}

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: openscad_soften
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Joe Francis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: openscad_util
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- joe@lostapathy.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- openscad_soften.gemspec
+- soften/chamfer.scad
+- soften/cube.scad
+- soften/cylinder.scad
+- soften/demo/chamfer-demo.scad
+- soften/demo/cube-demo.scad
+- soften/demo/cylinder-demo.scad
+- soften/demo/fillet-demo.scad
+- soften/demo/hole-demo.scad
+- soften/demo/square-demo.scad
+- soften/fillet.scad
+- soften/hole.scad
+- soften/square.scad
+homepage: https://github.com/lostapathy/openscad-libs/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.3
+signing_key: 
+specification_version: 4
+summary: OpenSCAD modules for generating a collection of shapes and solids that have
+  been softened with rounded edges, chamfers, round overs, or fillets.
+test_files: []