solidruby 0.1.0

data/lib/solidruby/solidruby.rb

@@ -0,0 +1,150 @@
+#    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/>fre.
+
+$fn = 64
+
+module SolidRuby
+  include SolidRuby::BillOfMaterial
+  include SolidRuby::ScrewThreads
+  include SolidRuby::PrintedThreads
+  include SolidRuby::Extras
+  include SolidRuby::Helpers
+  include SolidRuby::Primitives
+  include SolidRuby::CSGModelling
+  include SolidRuby::CSGModifiers
+  include SolidRuby::Assemblies
+  include SolidRuby::Transformations
+  include Math
+
+  #	Deprecated: Stacks parts along the Z axis
+  # works on all Assemblies that have a @height definition
+  # TODO: Make a better functionality similar to this, that is:
+  #				- easier to use
+  #				- throws better error messages
+  #				- doesn't assume that everything falls down like gravity in every case
+  def stack(args = {}, *parts)
+    args[:method] ||= 'show'
+    args[:spacing] ||= 0
+    warn 'SolidRuby Warning: Please note that the stack method is deprecated and will be removed or replaced in the future'
+    @assembly = nil
+    z = 0
+    parts.each do |part|
+      item = (part.send args[:method])
+      next if item.nil? || !item.respond_to?('translate')
+      @assembly += item.translate(z: z)
+      z += part.height	+ args[:spacing]
+    end
+    @assembly
+  end
+
+  def get_position_rec(obj, level = 0)
+    position = [0, 0, 0]
+    return position if obj.nil?
+    obj.each do |o|
+      o.transformations.each do |t|
+        next unless t.class == Translate
+        t.args[:x] ||= 0
+        t.args[:y] ||= 0
+        t.args[:z] ||= 0
+        position[0] += t.args[:x]
+        position[1] += t.args[:y]
+        position[2] += t.args[:z]
+      end
+      #		puts "  " * level + position.inspect
+      x, y, z = get_position_rec(o.children, level + 1)
+      position[0] += x
+      position[1] += y
+      position[2] += z
+    end
+    position
+  end
+
+  #	this is experimental, does only work on simple parts. example:
+  # The bolt head is on the -z plane, this will move it to "zero"
+  def position(obj)
+    get_position_rec(obj.children)
+  end
+
+  # produces a hull() of 2 cylidners
+  # accepts d,r,h for cylinder options
+  # l long slot length
+  def long_slot(args)
+    hull(cylinder(d: args[:d], r: args[:r], h: args[:h]), cylinder(d: args[:d], r: args[:r], h: args[:h]).translate(x: args[:l]))
+  end
+
+  def radians(a)
+    a / 180.0 * Math::PI
+  end
+
+  def degrees(a)
+    a * 180 / Math::PI
+  end
+
+  def save!
+    Dir.glob('lib/**/*.rb').map { |l| get_classes_from_file(l) }.flatten.map { |l| save_all(l) }
+  end
+
+  # Saves all files generated of a SolidRuby file
+  # Saves outputs of
+  # - show
+  # - output
+  # - view*
+  def save_all(class_name, fn = $fn)
+    res = class_name.send :new
+
+    # skip defined classes
+    skip = class_name.send :get_skip
+    skip = [] if skip.nil?
+    skip << 'show_hardware'
+    added_views = class_name.send :get_views
+
+    # regexp for output* view* show*
+    (res.methods.grep(Regexp.union(/^output/, /^view/, /^show/)) + added_views).each do |i|
+      next if skip.include? i.to_s
+      output = nil
+
+      res.send :initialize # ensure default values are loaded at each interation
+      output = res.send i
+
+      # if previous call resulted in a SolidRubyObject, don't call the show method again,
+      # otherwise call it.
+      unless	output.is_a? SolidRubyObject
+        output = if i.to_s.include? 'output'
+                   res.output
+                 else
+                   res.show
+                 end
+      end
+
+      output.save("output/#{res.class}_#{i}.scad", "$fn=#{fn};") unless output.nil?
+    end
+  end
+
+  def get_classes_from_file(filename)
+    classes = []
+    File.readlines(filename).find_all { |l| l.include?('class') }.each do |line|
+      # strip all spaces, tabs
+      line.strip!
+      # ignore comments (Warning: will not worth with ruby multi line comments)
+      next if line[0..0] == '#'
+      #	strip class definition
+      line = line[6..-1]
+      # strip until space appears - or if not, to the end
+      classes << Object.const_get(line[0..line.index(' ').to_i - 1])
+    end
+
+    classes
+  end
+end

data/lib/solidruby/solidruby_object.rb

@@ -0,0 +1,176 @@
+#    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
+  class SolidRubyObject
+    attr_accessor :attributes
+    attr_accessor :transformations
+    attr_accessor :children
+    attr_accessor :siblings
+
+    def initialize(*attributes)
+      @transformations = []
+      @siblings = []
+      @attributes = attributes.flatten
+      @attributes = @attributes[0] if @attributes[0].is_a? Hash
+      @debug_obj = false
+
+      @@attr_aliases ||= {}
+      @@attr_aliases[self.class.name] ||= {}
+      @@attr_aliases[self.class.name].each do |k, v|
+        @attributes[v] ||= @attributes.delete(k) unless @attributes[k].nil?
+      end
+    end
+
+    def rotate(args)
+      # always make sure we have a z parameter; otherwise RubyScad will produce a 2-dimensional output
+      # which can result in openscad weirdness
+      args[:z] = 0 if args[:z].nil?
+      @transformations ||= []
+      @transformations << Rotate.new(args)
+      self
+    end
+
+    def rotate_around(point, args)
+      x = point.x
+      y = point.y
+      z = point.z
+      translate(x: -x, y: -y, z: -z).rotate(args).translate(x: x, y: y, z: z)
+    end
+
+    def translate(args)
+      return self if (args[:x] || 0) == 0 && (args[:y] || 0) == 0 && (args[:z] || 0) == 0
+      @transformations ||= []
+      @transformations << Translate.new(args)
+      self
+    end
+
+    def union(args)
+      @transformations ||= []
+      @transformations << Union.new(args)
+      self
+    end
+
+    def mirror(args)
+      @transformations ||= []
+      @transformations << Mirror.new(args)
+      self
+    end
+
+    def scale(args)
+      args = { v: args } if args.is_a?(Numeric) || args.is_a?(Array)
+      @transformations ||= []
+      @transformations << Scale.new(args)
+      self
+    end
+
+    def place(args={})
+      return self if args.nil? || self.nil? || args[:onto].nil?
+
+      onto = args[:onto]
+      face = args[:face] || :top
+      edge = args[:edge] || :center
+      corner = args[:corner] || :center
+      face_offset = args[:face_offset] || 0
+      edge_offset = args[:edge_offset] || 0
+      corner_offset = args[:corner_offset] || 0
+
+      if onto.respond_to? :get_point_on
+        move_to = onto.get_point_on(
+          face: face,
+          edge: edge,
+          corner: corner,
+          face_offset: face_offset,
+          edge_offset: edge_offset,
+          corner_offset: corner_offset
+        )
+
+        if (self.respond_to? :get_point_on)
+          move_me = self.get_point_on(face: :center, edge: :center, corner: :center)
+          move_to[:x] -= move_me[:x]
+          move_to[:y] -= move_me[:y]
+          move_to[:z] -= move_me[:z]
+        end
+
+        self.translate(move_to)
+      end
+
+      self
+    end
+
+    def &(obj)
+      @siblings << obj
+      self
+    end
+
+    def debug
+      @debug_obj = true
+      self
+    end
+
+    def debug?
+      @debug_obj
+    end
+
+    def walk_tree
+      res = ''
+
+      @transformations.reverse.each do |trans|
+        res += trans.walk_tree
+      end
+      res += '#' if self.debug?
+      res += to_rubyscad.to_s + "\n"
+      @siblings.each do |s|
+        res += s.walk_tree
+      end
+      res
+    end
+
+    alias scad_output walk_tree
+
+    def walk_tree_classes
+      res = []
+      @transformations.reverse.each do |trans|
+        res += trans.walk_tree_classes
+      end
+      res << self.class
+      res
+    end
+
+    def to_rubyscad
+      ''
+    end
+
+    def save(filename, start_text = nil)
+      file = File.open(filename, 'w')
+      file.puts start_text unless start_text.nil?
+      file.puts scad_output
+      file.close
+    end
+
+    def self.alias_attr(long, short=nil)
+      short ||= long[0].downcase.to_sym
+      @@attr_aliases ||= {}
+      @@attr_aliases[self.name] ||= {}
+      @@attr_aliases[self.name][short] = long
+
+      self.class_eval {
+        define_method long do
+          @attributes[long]
+        end
+      }
+    end
+  end
+end

data/lib/solidruby/transformations/mirror.rb

@@ -0,0 +1,22 @@
+#    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::Transformations
+  class Mirror < Transformation
+    def to_rubyscad
+      RubyScadBridge.new.mirror(@args)
+    end
+  end
+end

data/lib/solidruby/transformations/rotate.rb

@@ -0,0 +1,22 @@
+#    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::Transformations
+  class Rotate < Transformation
+    def to_rubyscad
+      RubyScadBridge.new.rotate(@args).delete('"')
+    end
+  end
+end

data/lib/solidruby/transformations/scale.rb

@@ -0,0 +1,22 @@
+#    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::Transformations
+  class Scale < Transformation
+    def to_rubyscad
+      RubyScadBridge.new.scale(@args)
+    end
+  end
+end

data/lib/solidruby/transformations/transformation.rb

@@ -0,0 +1,29 @@
+#    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::Transformations
+  class Transformation
+    attr_accessor :args
+    def initialize(*args)
+      @args = args.flatten
+      @args = @args[0] if @args[0].is_a? Hash
+    end
+
+    def walk_tree
+      to_rubyscad.to_s + "\n"
+    end
+
+  end
+end

data/lib/solidruby/transformations/translate.rb

@@ -0,0 +1,32 @@
+#    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::Transformations
+  attr_accessor :x, :y, :z
+  class Translate < Transformation
+    def initialize(args={})
+      super(args)
+      @x = args[:x] || 0
+      @y = args[:y] || 0
+      @z = args[:z] || 0
+    end
+
+    def to_rubyscad
+      #ignore empty transformations
+      return '' if @x == 0 && @y == 0 && @z == 0
+      RubyScadBridge.new.translate({x: @x, y: @y, z: @z}).delete('"')
+    end
+  end
+end