module SolidRuby

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 <www.gnu.org/licenses/>.

This file is part of SolidRuby.

You should have received a copy of the GNU General Public License along with SolidRuby. If not, see <www.gnu.org/licenses/>.

Constants

VERSION

Public Instance Methods

degrees(a) click to toggle source

# File lib/solidruby/solidruby.rb, line 91
def degrees(a)
  a * 180 / Math::PI
end

get_classes_from_file(filename) click to toggle source

# File lib/solidruby/solidruby.rb, line 135
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

get_position_rec(obj, level = 0) click to toggle source

# File lib/solidruby/solidruby.rb, line 52
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

long_slot(args) click to toggle source

produces a hull() of 2 cylidners accepts d,r,h for cylinder options l long slot length

# File lib/solidruby/solidruby.rb, line 83
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

position(obj) click to toggle source

this is experimental, does only work on simple parts. example:

The bolt head is on the -z plane, this will move it to “zero”

# File lib/solidruby/solidruby.rb, line 76
def position(obj)
  get_position_rec(obj.children)
end

radians(a) click to toggle source

# File lib/solidruby/solidruby.rb, line 87
def radians(a)
  a / 180.0 * Math::PI
end

save!() click to toggle source

# File lib/solidruby/solidruby.rb, line 95
def save!
  Dir.glob('lib/**/*.rb').map { |l| get_classes_from_file(l) }.flatten.map { |l| save_all(l) }
end

save_all(class_name, fn = $fn) click to toggle source

Saves all files generated of a SolidRuby file Saves outputs of

show
output
view*

# File lib/solidruby/solidruby.rb, line 104
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

stack(args = {}, *parts) click to toggle source

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

# File lib/solidruby/solidruby.rb, line 37
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