solidruby 0.1.0

data/lib/solidruby/primitives/polygon.rb

@@ -0,0 +1,26 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Polygon < Primitive
+    def to_rubyscad
+      RubyScadBridge.new.polygon(@attributes)
+    end
+  end
+
+  def polygon(args)
+    Polygon.new(args)
+  end
+end

data/lib/solidruby/primitives/polyhedron.rb

@@ -0,0 +1,30 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Polyhedron < Primitive
+    alias_attr :faces
+    alias_attr :points
+    alias_attr :convexity
+    
+    def to_rubyscad
+      RubyScadBridge.new.polyhedron(@attributes)
+    end
+  end
+
+  def polyhedron(args)
+    Polyhedron.new(args)
+  end
+end

data/lib/solidruby/primitives/primitive.rb

@@ -0,0 +1,19 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+
+module SolidRuby::Primitives
+  class Primitive < SolidRuby::SolidRubyObject
+  end
+end

data/lib/solidruby/primitives/render.rb

@@ -0,0 +1,48 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Render < Primitive
+    alias_attr :convexity, :co
+
+    def initialize(object, attr={})
+      @operation = 'render'
+      @children = [object]
+
+      super(attr)
+    end
+
+    def to_rubyscad
+      ret = RubyScadBridge.new.render(@attributes) + "{\n"
+
+      @children ||= []
+      @children.each do |child|
+        begin
+          ret += child.walk_tree
+        rescue NoMethodError
+        end
+      end
+      ret += '}'
+    end
+  end
+
+  def render(args = {})
+    if args.is_a? SolidRubyObject
+      Render.new(args)
+    else
+      Render.new(self, args)
+    end
+  end
+end

data/lib/solidruby/primitives/sphere.rb

@@ -0,0 +1,49 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Sphere < Primitive
+    alias_attr :d, :diameter
+    alias_attr :r, :radius
+
+    def initialize(args={})
+      d = args[:diameter] || args[:d]
+      @r = args[:radius] || args[:r] || d/2.0
+      super(args)
+    end
+
+    def get_point_on(args = {})
+      #approximate a cube the size of this sphere
+      args[:x] = @r*Math.sqrt(2)
+      args[:y] = @r*Math.sqrt(2)
+      args[:z] = @r*Math.sqrt(2)
+      args[:centered] = true
+      args[:centered_z] = true
+      args[:transformations] = @transformations
+      calculate_point_on(args)
+    end
+
+    def to_rubyscad
+      RubyScadBridge.new.sphere(@attributes)
+    end
+  end
+
+  def sphere(args)
+    if args.is_a? Numeric
+      args = {r: args}
+    end
+    Sphere.new(args)
+  end
+end

data/lib/solidruby/primitives/square.rb

@@ -0,0 +1,88 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Square < Primitive
+    alias_attr :size
+
+    def initialize(att)
+      if att.is_a? Array
+        att = { size: att }
+      elsif att.is_a? Numeric
+        att = { size: att }
+      end
+
+      att[:center] ||= att.delete(:c)
+      att.delete(:center) unless att[:center]
+
+      super(att)
+
+      unless @attributes[:size]
+        x = @attributes.delete(:x) || 0
+        y = @attributes.delete(:y) || 0
+        @attributes[:size] = [x, y]
+      end
+    end
+
+    def x
+      if @attributes[:size].is_a? Array
+        @attributes[:size][0]
+      else
+        @attributes[:size]
+      end
+    end
+
+    def y
+      if @attributes[:size].is_a? Array
+        @attributes[:size][1]
+      else
+        @attributes[:size]
+      end
+    end
+
+    def to_rubyscad
+      RubyScadBridge.new.square(@attributes)
+    end
+
+    def center_xy
+      @attributes[:center] = true
+      self
+    end
+    alias center center_xy
+
+    def center_x
+      @transformations << Translate.new(x: -self.x / 2.0)
+      self
+    end
+
+    def center_y
+      @transformations << Translate.new(y: -self.y / 2.0)
+      self
+    end
+
+    def centered?
+      return @attributes[:center] || false
+    end
+  end
+
+  def square(args, y = nil)
+    if args.is_a?(Numeric) && !!y == y
+      args = { size: args, center: y}
+    elsif args.is_a?(Numeric) && y.is_a?(Numeric)
+      args = { size: [args, y] }
+    end
+    Square.new(args)
+  end
+end

data/lib/solidruby/primitives/surface.rb

@@ -0,0 +1,44 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Surface < Primitive
+    alias_attr :file
+    alias_attr :invert
+    alias_attr :center, :ce
+    alias_attr :convexity, :co
+
+    def initialize(attributes)
+      @transformations = []
+      @children = []
+
+      if attributes.is_a? String
+        attributes = {file: attributes}
+      end
+      abs_path = attributes.delete(:absolue_path) || false
+
+      super(attributes)
+      @attributes[:file] = File.expand_path(@attributes[:file]) if abs_path
+    end
+
+    def to_rubyscad
+      RubyScadBridge.new.surface(@attributes)
+    end
+  end
+
+  def surface(args)
+    Surface.new(args)
+  end
+end

data/lib/solidruby/primitives/text.rb

@@ -0,0 +1,43 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+#
+module SolidRuby::Primitives
+  class Text < Primitive
+    alias_attr :text
+    alias_attr :size
+    alias_attr :font
+    alias_attr :valign, :va
+    alias_attr :halign, :ha
+    alias_attr :spacing, :sp
+    alias_attr :direction
+    alias_attr :language
+    alias_attr :script, :sc
+
+    def initialize(attributes)
+      if attributes.is_a? String
+        attributes = {text: attributes}
+      end
+      super(attributes)
+    end
+
+    def to_rubyscad
+      RubyScadBridge.new.text(@attributes)
+    end
+  end
+
+  def text(args = {})
+    Text.new(args)
+  end
+end

data/lib/solidruby/printed_thread.rb

@@ -0,0 +1,163 @@
+#    This file is part of SolidRuby.
+#
+#    SolidRuby 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.
+#
+#    SolidRuby 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 SolidRuby.  If not, see <http://www.gnu.org/licenses/>.
+
+module SolidRuby::PrintedThreads
+  # Ported from
+  # http://dkprojects.net/openscad-threads/threads.scad
+  #
+  # original Author Dan Kirshner - dan_kirshner@yahoo.com
+
+  class PrintedThread
+    # internal - true = clearances for internal thread (e.g., a nut).
+    #            false = clearances for external thread (e.g., a bolt).
+    #            (Internal threads should be "cut out" from a solid using
+    #            difference()).
+    # number_of_starts - Number of thread starts (e.g., DNA, a "double helix," has
+    #            n_starts=2).  See wikipedia Screw_thread.
+    def initialize(args = {})
+      @args = args
+      @args[:diameter] ||= 8
+      @args[:pitch] ||= 1.25
+      @args[:length] ||= 10
+      @args[:internal] ||= false
+      @args[:number_of_starts] ||= 1
+    end
+
+    def show
+      output
+    end
+
+    def output
+      number_of_turns = (@args[:length].to_f / @args[:pitch].to_f).floor
+      number_of_segments = segments(@args[:diameter])
+      h = @args[:pitch] * Math.cos(radians(30))
+
+      res = nil
+      ((-1 * @args[:number_of_starts])..(number_of_turns + 1)).each do |i|
+        res += metric_thread_turn(@args[:diameter], @args[:pitch], @args[:internal], @args[:number_of_starts]).translate(z: i * @args[:pitch])
+      end
+      # cut to length
+      res *= cube(x: @args[:diameter] * 1.1, y: @args[:diameter] * 1.1, z: @args[:length]).center.translate(z: @args[:length] / 2.0)
+
+      if @args[:internal]
+        # Solid center, including Dmin truncation.
+        res += cylinder(r: @args[:diameter] / 2.0 - h * 5.0 / 8.0, h: @args[:length], segments: number_of_segments)
+      else
+        # External thread includes additional relief.
+        res += cylinder(r: @args[:diameter] / 2.0 - h * 5.3 / 8.0, h: @args[:length], segments: number_of_segments)
+      end
+
+      res
+    end
+
+    def segments(diameter)
+      [50, (diameter * 6).ceil].min
+    end
+
+    def metric_thread_turn(diameter, pitch, internal, number_of_starts)
+      number_of_segments = segments(diameter)
+      fraction_circle = 1.0 / number_of_segments
+      res = nil
+
+      (0..number_of_segments - 1).each do |i|
+        res += thread_polyhedron(diameter / 2.0, pitch, internal, number_of_starts).translate(z: i * number_of_starts * pitch * fraction_circle).rotate(z: i * 360 * fraction_circle)
+      end
+      res
+    end
+
+    # z (see diagram) as function of current radius.
+    # (Only good for first half-pitch.)
+    def z_fct(current_radius, radius, pitch)
+      0.5 * (current_radius - (radius - 0.875 * pitch * Math.cos(radians(30)))) / Math.cos(radians(30))
+    end
+
+#
+# 				(angles x0 and x3 inner are actually 60 deg)
+#
+# 				                      /\  (x2_inner, z2_inner) [2]
+# 				                     /  \
+# 			 (x3_inner, z3_inner) /    \
+# 				              [3]   \     \
+# 				                    |\     \ (x2_outer, z2_outer) [6]
+# 				                    | \    /
+# 				                    |  \  /|
+# 				         z          |   \/ / (x1_outer, z1_outer) [5]
+# 				         |          |   | /
+# 				         |   x      |   |/
+# 				         |  /       |   / (x0_outer, z0_outer) [4]
+# 				         | /        |  /     (behind: (x1_inner, z1_inner) [1]
+# 				         |/         | /
+# 				y________|          |/
+# 			 (r)                  / (x0_inner, z0_inner) [0]
+#
+#
+    def thread_polyhedron(radius, pitch, internal, n_starts)
+      n_segments = segments(radius * 2)
+      fraction_circle = 1.0 / n_segments
+
+      h = pitch * Math.cos(radians(30))
+      outer_r = radius + (internal ? h / 20 : 0) # Adds internal relief.
+
+      inner_r = radius - 0.875 * h #  Does NOT do Dmin_truncation - do later with cylinder.
+
+      # Make these just slightly bigger (keep in proportion) so polyhedra will overlap.
+      x_incr_outer = outer_r * fraction_circle * 2 * Math::PI * 1.005
+      x_incr_inner = inner_r * fraction_circle * 2 * Math::PI * 1.005
+      z_incr = n_starts * pitch * fraction_circle * 1.005
+
+      #TODO: test code to see if x1_outer and/or z1_outer are needed
+      #x1_outer = outer_r * fraction_circle * 2 * Math::PI
+
+      z0_outer = z_fct(outer_r, radius, pitch)
+      #z1_outer = z0_outer + z_incr
+      # Rule for triangle ordering: look at polyhedron from outside: points must
+      # be in clockwise order.
+
+      points = [
+        [-x_incr_inner / 2, -inner_r, 0],                         # [0]
+        [x_incr_inner / 2, -inner_r, z_incr],                     # [1]
+        [x_incr_inner / 2, -inner_r, pitch + z_incr],             # [2]
+        [-x_incr_inner / 2, -inner_r, pitch],                     # [3]
+
+        [-x_incr_outer / 2, -outer_r, z0_outer],                  # [4]
+        [x_incr_outer / 2, -outer_r, z0_outer + z_incr],          # [5]
+        [x_incr_outer / 2, -outer_r, pitch - z0_outer + z_incr],  # [6]
+        [-x_incr_outer / 2, -outer_r, pitch - z0_outer]           # [7]
+      ]
+
+      triangles = [
+        [0, 3, 4],  # This-side trapezoid, bottom
+        [3, 7, 4],  # This-side trapezoid, top
+
+        [1, 5, 2],  # Back-side trapezoid, bottom
+        [2, 5, 6],  # Back-side trapezoid, top
+
+        [0, 1, 2],  # Inner rectangle, bottom
+        [0, 2, 3],  # Inner rectangle, top
+
+        [4, 6, 5],  # Outer rectangle, bottom
+        [4, 7, 6],  # Outer rectangle, top
+
+        [7, 2, 6],  # Upper rectangle, bottom
+        [7, 3, 2],  # Upper rectangle, top
+
+        [0, 5, 1],  # Lower rectangle, bottom
+        [0, 4, 5]   # Lower rectangle, top
+      ]
+
+       polyhedron(points: points, triangles: triangles)
+    end
+  end
+end