crystalscad 0.3.6 → 0.3.7

data/examples/threads.rb

@@ -0,0 +1,186 @@
+#!/usr/bin/ruby1.9.3
+require "rubygems"
+require "crystalscad"
+include CrystalScad
+
+# This example shows the use of ScrewThreads in CrystalScad.
+
+class BlackBox < CrystalScad::Assembly
+	# This is a box (the part that you want to make a mount for)
+
+	def initialize
+		@x=200
+		@y=100
+		@z=50
+	end
+	
+	#	note: when you design a box like that, make sure that it starts at 0,0,0
+	def show
+		cube([@x,@y,@z]).color(r:10,b:10,g:10,a:150)
+	end
+
+	# We're defining threads on every side. It must be called thread_side
+	# where side is either top, bottom, left, right, front, back
+	def threads_top
+		holes =*ScrewThread.new(x:50,y:50,size:8,depth:10)	 # note that =* creates an Array
+		holes << ScrewThread.new(x:150,y:50,size:8,depth:10)	# and << adds stuff to an Array
+	end 
+	
+	def threads_bottom
+		holes =*ScrewThread.new(x:50,y:50,size:8,depth:10)	
+	end
+
+	# note that the coordinates for the threads are needed in 2 directions from 0,0,0
+	# on top and bottom you're defining x & y
+	# on left and right you're defining y & z
+	# on front and back you're defining x & z
+	def threads_left
+		holes =*ScrewThread.new(y:15,z:10,size:3,depth:5)	
+		holes << ScrewThread.new(y:40,z:30,size:3,depth:5)	
+	end
+
+	def threads_right
+		holes =*ScrewThread.new(y:15,z:10,size:3,depth:5)	
+		holes << ScrewThread.new(y:40,z:30,size:3,depth:5)	
+	end
+
+	# this example has different thread sizes for m3 and m6
+	def threads_front
+		holes =*ScrewThread.new(x:20,z:10,size:3,depth:5)	
+		holes << ScrewThread.new(x:100,z:20,size:6,depth:25)	
+		holes << ScrewThread.new(x:140,z:20,size:6,depth:25)	
+		holes << ScrewThread.new(x:180,z:45,size:3,depth:5)	
+	end
+
+	def threads_back
+		holes =*ScrewThread.new(x:20,z:10,size:3,depth:5)	
+		holes << ScrewThread.new(x:100,z:25,size:12,depth:25)	
+		holes << ScrewThread.new(x:180,z:45,size:3,depth:5)	
+	end
+	
+end
+
+# this is what a basic mount looks like. 
+class BlackBoxMountTop < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:200,y:100,z:7)
+		# the mount should either be a cube or an object that returns x,y,z as dimensions
+		# if you have a complicated part, split the cube and add it later on to your object
+		# Alternatively, define height in the arguments.
+	
+		# create_bolts needs the face as first argument, your new mount as second argument
+		# and the object that has the threads as third argument
+		# it accepts an hash of arguments as 4th argument. You can define
+		#	height: define a custom height of your mount
+		# bolt_height: custom height for your bolt(s). Can also be an array for different lengths.
+		#							 This is useful if the automatic length calculation doesn't produce values
+		#							 that are available.  
+		# 						 This example would, without the setting 16 produce a M8x17 bolt. We don't have
+		#							 that size, so we use M8x16 instead.
+
+		bolts = create_bolts("top",mount,box,bolt_height:16)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(z:box.z)
+		res += box.show if show
+		res	
+	end
+end
+
+class BlackBoxMountBottom < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:200,y:100,z:z=2)
+		# note that the bolt height bom output is unchecked in this and the following examples
+		bolts = create_bolts("bottom",mount,box)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(z:-z)
+		res += box.show if show
+		res
+	end
+end
+
+class BlackBoxMountLeft < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:x=5,y:100,z:50)
+
+
+		bolts = create_bolts("left",mount,box)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(x:-x)
+		res += box.show if show
+		res
+	end
+end
+
+class BlackBoxMountRight < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:5,y:100,z:50)
+		
+		bolts = create_bolts("right",mount,box)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(x:box.x)
+		res += box.show if show
+		res
+	end
+end
+
+class BlackBoxMountFront < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:box.x,y:y=15,z:box.z)
+		
+		bolts = create_bolts("front",mount,box)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(y:-y)
+		res += box.show if show
+		res
+	end
+end
+
+class BlackBoxMountBack < CrystalScad::Printed
+	def part(show)
+		box = BlackBox.new
+		mount = cube(x:box.x,y:35,z:box.z)
+		
+		bolts = create_bolts("back",mount,box)
+		mount-=bolts
+		mount+=bolts if show
+
+		res = mount.translate(y:box.y)
+		res += box.show if show
+		res
+	end
+end
+
+
+b=CrystalScadObject.new
+
+# uncomment as many mounts as you like here
+
+b +=BlackBoxMountTop.new.show
+#b +=BlackBoxMountBottom.new.show
+#b +=BlackBoxMountLeft.new.show
+#b +=BlackBoxMountRight.new.show
+#b +=BlackBoxMountFront.new.show
+#b +=BlackBoxMountBack.new.show
+
+# you can also try output instead of show
+#b =BlackBoxMountTop.new.output
+
+# Uncomment this for checking the BOM output
+# puts @@bom.output
+
+b.save("threads.scad")

data/lib/crystalscad.rb

@@ -4,6 +4,6 @@ require 'crystalscad/Assembly'
 require 'crystalscad/Hardware'
 require 'crystalscad/LinearBearing'
 require 'crystalscad/Gears'
-require 'crystalscad/BoltHoles'
+require 'crystalscad/ScrewThreads'
 require 'crystalscad/CrystalScad'
 

data/lib/crystalscad/Assembly.rb

@@ -15,7 +15,7 @@
 
 module CrystalScad
 	class Assembly
-		attr_accessor :height
+		attr_accessor :height,:x,:y,:z
 
 	  def initialize(args={})
 	    @args = args if @args == nil

data/lib/crystalscad/CrystalScad.rb

@@ -21,7 +21,7 @@ module CrystalScad
 	include CrystalScad::Hardware
 	include CrystalScad::LinearBearing
 	include CrystalScad::Gears
-	include CrystalScad::BoltHoles
+	include CrystalScad::ScrewThreads
 
 	
 	class CrystalScadObject
@@ -178,6 +178,13 @@ module CrystalScad
 	end
 
 	def square(args)
+		if args.kind_of? Array
+			args = {size:args}
+		elsif args.kind_of? Hash
+		  args[:x] ||= 0
+		  args[:y] ||= 0
+		  args = {size:[args[:x],args[:y]]}		
+		end
 		Square.new(args)	
 	end
 
@@ -351,7 +358,13 @@ module CrystalScad
 			if attributes.kind_of? String
 				attributes = "\"#{attributes}\""			
 			elsif attributes.kind_of? Hash
-				# FIXME
+				attributes[:a] ||= 255
+				
+				r = attributes[:r].to_f / 255.0
+				g = attributes[:g].to_f / 255.0
+				b = attributes[:b].to_f / 255.0
+				a = attributes[:a].to_f / 255.0
+				attributes = [r,g,b,a]
 			end
 			
 			super(object, attributes)
@@ -385,11 +398,19 @@ module CrystalScad
 	end
 
 	def linear_extrude(args)
+		if args[:h]	# rename to height
+			args[:height] = args[:h]
+			args.delete(:h)
+		end
 		args = args.collect { |k, v| "#{k} = #{v}" }.join(', ')
 		return LinearExtrude.new(self,args)				
 	end
 
 	def rotate_extrude(args)
+		if args[:h]	# rename to height
+			args[:height] = args[:h]
+			args.delete(:h)
+		end
 		args = args.collect { |k, v| "#{k} = #{v}" }.join(', ')
 		return RotateExtrude.new(self,args)				
 	end

data/lib/crystalscad/Hardware.rb

@@ -128,13 +128,24 @@ module CrystalScad::Hardware
 			@args[:type] ||= "125"
 			@args[:material] ||= "steel"
 			@args[:surface] ||= "zinc plated"			
-
+	
 			@chart_din125 = { 3.2 => {outer_diameter:7, height:0.5},
- 											  4.3 => {outer_diameter:9, height:0.8},
+												3.7 => {outer_diameter:8, height:0.5}, 											  
+												4.3 => {outer_diameter:9, height:0.8},
 												5.3 => {outer_diameter:10, height:1.0},
+												6.4 => {outer_diameter:12, height:1.6},
+												8.4 => {outer_diameter:16, height:1.6},
+												10.5 => {outer_diameter:20, height:2.0},
+												13.0 => {outer_diameter:24, height:2.5},
 
 											}
+			if @chart_din125[@size] == nil
+				sizes = @chart_din125.map{|k,v| k}.sort.reverse.map{|s| s > @size ? size=s :nil}
+				@size = size
+			end			
 			@height = @chart_din125[@size][:height]
+			
+
 		end
 
 		def description

data/lib/crystalscad/{BoltHoles.rb → ScrewThreads.rb}

@@ -13,8 +13,8 @@
 #    You should have received a copy of the GNU General Public License
 #    along with CrystalScad.  If not, see <http://www.gnu.org/licenses/>.
 
-module CrystalScad::BoltHoles
-	class BoltHole
+module CrystalScad::ScrewThreads
+	class ScrewThread
 		# I would name this Thread but that's already taken by something else
 
 		attr_accessor :x,:y,:z,:size, :depth
@@ -39,23 +39,37 @@ module CrystalScad::BoltHoles
 
 		# we need to know obj1 height (if not supplied by user)
 		height ||= args[:height]			
-		height ||= obj1.z rescue nil
+		case face
+			when "top"
+				height ||= obj1.z rescue nil
+			when "bottom"
+				height ||= obj1.z rescue nil
+			when "left"
+				height ||= obj1.x rescue nil
+			when "right"
+				height ||= obj1.x rescue nil
+			when "front"
+				height ||= obj1.y rescue nil
+			when "back"
+				height ||= obj1.y rescue nil
+		end		
 		height ||= obj1.height rescue nil
 		if height == nil
 			raise "the object we're substracting from doesn't have a height defined; please define manually"
 			return
 		end			
 		
-		# lets check if the obj2 responds to the bolt_holes_[face] method
+		# lets check if the obj2 responds to the threads_[face] method
 		
-		meth = "bolt_holes_#{face}"
+		meth = "threads_#{face}"
 		
 		unless obj2.respond_to?(meth)
-			raise "The object you're trying to get bolts holes from doesn't supply any on the face '#{face}'. Please add a method #{meth} to this object"				
+			raise "The object you're trying to get bolts from doesn't supply any on the face '#{face}'. Please add a method #{meth} to this object"				
 			return
 		end
 		holes = obj2.send(meth)		
 		
+		return if holes == nil
 
 		# let the user either define bolt_heights as integer, array or none (will be guessed)
 		if args[:bolt_height].kind_of? Array
@@ -78,10 +92,26 @@ module CrystalScad::BoltHoles
 		ret = []
 		holes.each_with_index do |hole,i|
 			bolt = Bolt.new(hole.size,bolt_heights[i])
-
-		  # FIXME: this all currently only works for "top"	
-			bolt.transformations << Rotate.new(x:180)	
-			bolt.transformations << Translate.new({x:hole.x,y:hole.y,z:hole.z+height})		
+			puts bolt_heights[i]
+		  case face
+				when "top"
+					bolt.transformations << Rotate.new(x:180)	
+					bolt.transformations << Translate.new({x:hole.x,y:hole.y,z:hole.z+height})		
+				when "bottom"
+					bolt.transformations << Translate.new({x:hole.x,y:hole.y,z:hole.z})		
+				when "left"
+					bolt.transformations << Rotate.new(y:90)						
+					bolt.transformations << Translate.new({x:hole.x,y:hole.y,z:hole.z+height})		
+				when "right"
+					bolt.transformations << Rotate.new(y:-90)						
+					bolt.transformations << Translate.new({x:hole.x+height,y:hole.y,z:hole.z})		
+				when "front"
+					bolt.transformations << Rotate.new(x:-90)						
+					bolt.transformations << Translate.new({x:hole.x,y:hole.y,z:hole.z})		
+				when "back"
+					bolt.transformations << Rotate.new(x:90)						
+					bolt.transformations << Translate.new({x:hole.x,y:hole.y+height,z:hole.z})		
+			end
 
 			ret << bolt
 		end

data/lib/crystalscad/version.rb

@@ -1,4 +1,4 @@
 module CrystalScad
-  VERSION = "0.3.6"
+  VERSION = "0.3.7"
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: crystalscad
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 29
   prerelease: 
   segments: 
   - 0
   - 3
-  - 6
-  version: 0.3.6
+  - 7
+  version: 0.3.7
 platform: ruby
 authors: 
 - Joachim Glauche
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-12-25 00:00:00 Z
+date: 2013-12-29 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rubyscad
@@ -64,14 +64,15 @@ files:
 - crystalscad.gemspec
 - examples/gear.rb
 - examples/stack.rb
+- examples/threads.rb
 - lib/crystalscad.rb
 - lib/crystalscad/Assembly.rb
 - lib/crystalscad/BillOfMaterial.rb
-- lib/crystalscad/BoltHoles.rb
 - lib/crystalscad/CrystalScad.rb
 - lib/crystalscad/Gears.rb
 - lib/crystalscad/Hardware.rb
 - lib/crystalscad/LinearBearing.rb
+- lib/crystalscad/ScrewThreads.rb
 - lib/crystalscad/version.rb
 - skeleton_project/assemblies/example.rb
 - skeleton_project/observe.sh