triangular 0.0.1 → 0.0.2

data/README.rdoc

@@ -7,25 +7,58 @@ The main purpose of Triangular is to enable its users to quickly create new soft
 Please note that Triangular requires Ruby 1.9+. Triangular is currently in the Alpha stage of development which means that the API can and will change, and that new features will be added often!
 
 === A Quick Example
+  
+  require "rubygems"
+  require "triangular"
 
   # Open and parse an STL file
   solid = Triangular.parse_file("test.stl")
   
-  # Cut a section slice of the model at a Z height of 1.0
-  slice = solid.slice_at_z(1.0)
+  # Set the units of measurement for the resulting solid to inches
+  solid.units = :inches
+
+  # Move the solid so that all of it's coordinates are in positive space (ie: greater than 0)
+  solid.align_to_origin!
+  
+  # Get the bounding box of the solid
+  bounds = solid.get_bounds
+
+  # Create a section plane ('slice') through the solid on the XY plane at a Z height of 0.7
+  slice = solid.slice_at_z(0.7)
+
+  # Open a file for SVG output
+  File.open("slice.svg", "w+") do |file|
   
-  # Create an SVG image of the slice for further manipulation
-  svg = slice.to_svg
+    # Output the slice as an SVG document (correctly scaled according to the solid's units)
+    file.puts slice.to_svg(bounds[1].x, bounds[1].y, solid.units)
+  end
 
 === Installation
 
 For ease of use the Triangular is packaged as a RubyGem. Providing you already have Ruby and RubyGems installing Triangular is as easy as entering the following command in a terminal:
 
   gem install triangular
+  
+=== Performance
+
+At the moment Triangular has not been optimized at all. The parser is a relatively naive one that was designed to be easy to read rather than performant. Once the feature-set of Triangular has stabilized I will be doing a pass over it in order to make it fast enough for production use. Right now it could definitely be improved.
+
+For example here is some information about run-times when processing a 51Mb STL file:
+
+  solid = Triangular.parse("big_file.stl")
+  # 65 seconds
+  
+  solid.align_to_origin!
+  # 8 seconds
+  
+  solid.slice_at_z(1.0)
+  # 2 seconds
 
 === Author & Credits
 
 Author:: {Aaron Gough}[mailto:aaron@aarongough.com]
 
+Special thanks go out to {Alkas Baybas}[https://github.com/abaybas] for lending me his massive brain!
+
 Copyright (c) 2011 {Aaron Gough}[http://thingsaaronmade.com/] ({thingsaaronmade.com}[http://thingsaaronmade.com/]), released under the MIT license
 

data/examples/slice_example.rb

@@ -2,8 +2,13 @@ require "bundler/setup"
 require "triangular"
 
 solid = Triangular.parse_file("#{File.dirname(__FILE__)}/example_files/y-axis-spacer.stl")
-polyline = solid.slice_at_z(-0.5)
+solid.units = :inches
+
+solid.align_to_origin!
+bounds = solid.get_bounds
+
+polyline = solid.slice_at_z(0.7)
 
 File.open(File.expand_path("~/Desktop/slice.svg"), "w+") do |file|
-  file.puts polyline.to_svg(10, 10)
+  file.puts polyline.to_svg(bounds[1].x, bounds[1].y, solid.units)
 end

data/lib/triangular.rb

@@ -4,6 +4,7 @@ require 'triangular/vector'
 require 'triangular/line'
 require 'triangular/polyline'
 require 'triangular/facet'
+require 'triangular/units'
 require 'triangular/solid'
 
 module Triangular

data/lib/triangular/facet.rb

@@ -44,6 +44,12 @@ module Triangular
       end
     end
     
+    def translate!(x, y, z)
+      @vertices.each do |vertex|
+        vertex.translate!(x, y, z)
+      end
+    end    
+    
     def self.parse(string)
       facets = []
       

data/lib/triangular/line.rb

@@ -31,8 +31,8 @@ module Triangular
       Point.new(x_intersect, y_intersect, z_plane)
     end
     
-    def to_svg_path
-      "<path d=\"M #{@start.x} #{@start.y} L #{@end.x} #{@end.y}\" fill=\"none\" stroke=\"black\" stroke-width=\"1\" />"
+    def to_svg_path(units)
+      "<path d=\"M #{@start.x} #{@start.y} L #{@end.x} #{@end.y}\" fill=\"none\" stroke=\"black\" stroke-width=\"#{Units.stroke_width(units)}\" />"
     end
   end
 end

data/lib/triangular/point.rb

@@ -13,6 +13,12 @@ module Triangular
       "#{@x.to_f} #{@y.to_f} #{@z.to_f}"
     end
     
+    def translate!(x, y, z)
+      @x += x
+      @y += y
+      @z += z
+    end
+    
     def ==(other)
       return false unless other.is_a?(Point)
       self.x == other.x && self.y == other.y && self.z == other.z

data/lib/triangular/polyline.rb

@@ -7,14 +7,14 @@ module Triangular
       @lines = lines
     end
     
-    def to_svg(x_offset = 20, y_offset = 20)
+    def to_svg(width, height, units, x_offset = 0, y_offset = 0)
       output  = '<?xml version="1.0" standalone="no"?>' + "\n"
       output << '<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">' + "\n"
-      output << '<svg xmlns="http://www.w3.org/2000/svg" version="1.1">' + "\n"
-      output << "  <g transform=\"translate(#{x_offset},#{y_offset})\">\n"
+      output << "<svg x=\"0\" y=\"0\" width=\"#{width}#{Units.svg_name(units)}\" height=\"#{height}#{Units.svg_name(units)}\" viewBox=\"0 0 #{width} #{height}\" xmlns=\"http://www.w3.org/2000/svg\" version=\"1.1\">\n"
+      output << "  <g transform=\"translate(#{x_offset}#{Units.svg_name(units)},#{y_offset}#{Units.svg_name(units)})\">\n"
       
       @lines.each do |line|
-        output << "    " + line.to_svg_path + "\n"
+        output << "    " + line.to_svg_path(units) + "\n"
       end
       
       output << '  </g>' + "\n"

data/lib/triangular/solid.rb

@@ -1,11 +1,12 @@
 module Triangular
   class Solid
     
-    attr_accessor :name, :facets
+    attr_accessor :name, :facets, :units
     
     def initialize(name, *args)
       @name = name
       @facets = args
+      @units = units
     end
     
     def to_s
@@ -24,6 +25,45 @@ module Triangular
       output
     end
     
+    def get_bounds
+      largest_x = @facets[0].vertices[0].x
+      largest_y = @facets[0].vertices[0].y
+      largest_z = @facets[0].vertices[0].z
+      
+      smallest_x = @facets[0].vertices[0].x
+      smallest_y = @facets[0].vertices[0].y
+      smallest_z = @facets[0].vertices[0].z
+      
+      @facets.each do |facet|
+        facet.vertices.each do |vertex|
+          largest_x = vertex.x if vertex.x > largest_x
+          largest_y = vertex.y if vertex.y > largest_y
+          largest_z = vertex.z if vertex.z > largest_z
+          
+          smallest_x = vertex.x if vertex.x < smallest_x
+          smallest_y = vertex.y if vertex.y < smallest_y
+          smallest_z = vertex.z if vertex.z < smallest_z
+        end
+      end
+      
+      [Point.new(smallest_x, smallest_y, smallest_z), Point.new(largest_x, largest_y, largest_z)]
+    end
+    
+    def align_to_origin!
+      bounds = self.get_bounds
+      self.translate!(-bounds[0].x, -bounds[0].y, -bounds[0].z)
+    end
+    
+    def center!
+      bounds = self.get_bounds
+      
+      x_translation = ((bounds[1].x - bounds[0].x).abs / 2) + -bounds[1].x
+      y_translation = ((bounds[1].y - bounds[0].y).abs / 2) + -bounds[1].y
+      z_translation = ((bounds[1].z - bounds[0].z).abs / 2) + -bounds[1].z
+      
+      self.translate!(x_translation, y_translation, z_translation)
+    end
+    
     def slice_at_z(z_plane)
       lines = @facets.map {|facet| facet.intersection_at_z(z_plane) }
       lines.compact!
@@ -31,6 +71,12 @@ module Triangular
       Polyline.new(lines)
     end
     
+    def translate!(x, y, z)
+      @facets.each do |facet|
+        facet.translate!(x, y, z)
+      end
+    end
+    
     def self.parse(string)
       partial_pattern = /\s* solid\s+ (?<name> [a-zA-Z0-9\-\_\.]+)?/x
       match_data = string.match(partial_pattern)

data/lib/triangular/units.rb

@@ -0,0 +1,30 @@
+require 'forwardable'
+
+module Triangular
+  class Units
+    
+    UNITS = {
+      :inches      => {:name => 'inches', :svg_name => 'in', :stroke_width => 0.005},
+      :centimeters => {:name => 'centimeters', :svg_name => 'cm', :stroke_width => 0.01},
+      :millimeters => {:name => 'millimeters', :svg_name => 'mm', :stroke_width => 0.1},
+      :none        => {:name => 'none', :svg_name => '', :stroke_width => 0.1}
+    }
+    
+    def self.get_property(unit, name)
+      raise "Unknown unit: #{unit}" unless UNITS.has_key?(unit)
+      UNITS[unit][name]
+    end
+    
+    def self.name(unit)
+      self.get_property(unit, :name)
+    end
+    
+    def self.svg_name(unit)
+      self.get_property(unit, :svg_name)
+    end
+    
+    def self.stroke_width(unit)
+      self.get_property(unit, :stroke_width)
+    end
+  end
+end

data/lib/triangular/version.rb

@@ -1,3 +1,3 @@
 module Triangular
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/triangular/vertex.rb

@@ -7,6 +7,7 @@ module Triangular
     def_delegator :@point, :x, :x
     def_delegator :@point, :y, :y
     def_delegator :@point, :z, :z
+    def_delegator :@point, :translate!, :translate!
     
     attr_accessor :point
     

data/spec/facet_spec.rb

@@ -154,52 +154,6 @@ describe Facet do
       end
     end
     
-    context "for a facet that intersects the target Z plane at an angle" do
-      before do
-        vertex1 = Vertex.new(0.0, 0.0, 0.0)
-        vertex2 = Vertex.new(0.0, 6.0, 6.0)
-        vertex3 = Vertex.new(6.0, 6.0, 6.0)
-        
-        @facet = Facet.new(nil, vertex1, vertex2, vertex3)
-      end
-      
-      context "when the target Z plane is 3.0" do
-        it "should return a line object" do
-          @facet.intersection_at_z(3.0).should be_a Line
-        end
-        
-        it "should return a line with the correct start value" do
-          @facet.intersection_at_z(3.0).start.x.should == 0.0
-          @facet.intersection_at_z(3.0).start.y.should == 3.0
-          @facet.intersection_at_z(3.0).start.z.should == 3.0
-        end
-        
-        it "should return a line with the correct end value" do
-          @facet.intersection_at_z(3.0).end.x.should == 3.0
-          @facet.intersection_at_z(3.0).end.y.should == 3.0
-          @facet.intersection_at_z(3.0).end.z.should == 3.0
-        end
-      end
-      
-      context "when the target Z plane is 6.0" do
-        it "should return a line object" do
-          @facet.intersection_at_z(6.0).should be_a Line
-        end
-        
-        it "should return a line with the correct start value" do
-          @facet.intersection_at_z(6.0).start.x.should == 0.0
-          @facet.intersection_at_z(6.0).start.y.should == 6.0
-          @facet.intersection_at_z(6.0).start.z.should == 6.0
-        end
-        
-        it "should return a line with the correct end value" do
-          @facet.intersection_at_z(6.0).end.x.should == 6.0
-          @facet.intersection_at_z(6.0).end.y.should == 6.0
-          @facet.intersection_at_z(6.0).end.z.should == 6.0
-        end
-      end
-    end
-    
     context "with vertices in both positive and negative space" do
       before do
         @facet = Facet.parse(<<-EOD)
@@ -254,4 +208,26 @@ describe Facet do
       end
     end
   end
+  
+  describe "#translate!" do
+    before do
+      @facet = Facet.parse(<<-EOD)
+        facet normal 0.0 0.0 -1.0
+        outer loop
+        vertex -16.5 0.0 -0.75
+        vertex 0.0 -9.5 -0.75
+        vertex 0.0 0.0 -0.75
+        endloop
+        endfacet
+      EOD
+    end
+    
+    it "should call translate on each of it's Vertices" do
+      @facet.vertices[0].should_receive(:translate!).with(16.5, 9.5, 0.75)
+      @facet.vertices[1].should_receive(:translate!).with(16.5, 9.5, 0.75)
+      @facet.vertices[2].should_receive(:translate!).with(16.5, 9.5, 0.75)
+      
+      @facet.translate!(16.5, 9.5, 0.75)
+    end
+  end
 end

data/spec/line_spec.rb

@@ -37,115 +37,33 @@ describe Line do
   
   describe "#intersection_at_z" do
     context "for a line that intersects the target Z plane" do
-      context "and is located at the origin" do
+      context "and spans both positive and negative space" do
         context "with a positive Z vector" do
           before do
-            @line = Line.new(Vertex.new(0.0, 0.0, 0.0), Vertex.new(0.0, 0.0, 6.0))
-          end
-          
-          it "should return a a Point" do
-            @line.intersection_at_z(3.0).should be_a Point
+            @line = Line.new(Vertex.new(-1.0, 1.0, 1.0), Vertex.new(1.0, 1.0, -1.0))
           end
           
           it "should return a Point representing the intersection" do
-            @line.intersection_at_z(3.0).x.should == 0.0
-            @line.intersection_at_z(3.0).y.should == 0.0
-            @line.intersection_at_z(3.0).z.should == 3.0
+            @line.intersection_at_z(0).x.should == 0.0
+            @line.intersection_at_z(0).y.should == 1.0
+            @line.intersection_at_z(0).z.should == 0.0
           end
         end
         
         context "with a negative Z vector" do
           before do
-            @line = Line.new(Vertex.new(0.0, 0.0, 6.0), Vertex.new(0.0, 0.0, 0.0))
+            @line = Line.new(Vertex.new(1.0, 1.0, 1.0), Vertex.new(-1.0, -1.0, -1.0))
           end
           
           it "should return a Point representing the intersection" do
-            @line.intersection_at_z(3.0).x.should == 0.0
-            @line.intersection_at_z(3.0).y.should == 0.0
-            @line.intersection_at_z(3.0).z.should == 3.0
-          end
-        end
-      end
-      
-      context "and is located away from the origin" do
-        context "with a positive Z vector" do
-          before do
-            @line = Line.new(Vertex.new(7.0, 7.0, 1.0), Vertex.new(7.0, 7.0, 7.0))
-          end
-          
-          it "should return a Point representing the intersection" do
-            @line.intersection_at_z(4.0).x.should == 7.0
-            @line.intersection_at_z(4.0).y.should == 7.0
-            @line.intersection_at_z(4.0).z.should == 4.0
-          end
-        end
-        
-        context "with a negative Z vector" do
-          before do
-            @line = Line.new(Vertex.new(7.0, 7.0, 7.0), Vertex.new(1.0, 1.0, 1.0))
-          end
-          
-          it "should return a Point representing the intersection" do
-            @line.intersection_at_z(4.0).x.should == 4.0
-            @line.intersection_at_z(4.0).y.should == 4.0
-            @line.intersection_at_z(4.0).z.should == 4.0
+            @line.intersection_at_z(0).x.should == 0
+            @line.intersection_at_z(0).y.should == 0
+            @line.intersection_at_z(0).z.should == 0
           end
         end
       end
     end
-    
-    context "and is located in negative space" do
-      context "with a negative Z vector" do
-        before do
-          @line = Line.new(Vertex.new(-1.0, -1.0, -1.0), Vertex.new(-7.0, -7.0, -7.0))
-        end
-        
-        it "should return a Point representing the intersection" do
-          @line.intersection_at_z(-4.0).x.should == -4.0
-          @line.intersection_at_z(-4.0).y.should == -4.0
-          @line.intersection_at_z(-4.0).z.should == -4.0
-        end
-      end
-      
-      context "with a positive Z vector" do
-        before do
-          @line = Line.new(Vertex.new(-7.0, -7.0, -7.0), Vertex.new(-1.0, -1.0, -1.0))
-        end
-        
-        it "should return a Point representing the intersection" do
-          @line.intersection_at_z(-4.0).x.should == -4.0
-          @line.intersection_at_z(-4.0).y.should == -4.0
-          @line.intersection_at_z(-4.0).z.should == -4.0
-        end
-      end
-    end
-    
-    context "and spans both positive and negative space" do
-      context "with a positive Z vector" do
-        before do
-          @line = Line.new(Vertex.new(-1.0, 1.0, 1.0), Vertex.new(1.0, 1.0, -1.0))
-        end
-        
-        it "should return a Point representing the intersection" do
-          @line.intersection_at_z(0).x.should == 0.0
-          @line.intersection_at_z(0).y.should == 1.0
-          @line.intersection_at_z(0).z.should == 0.0
-        end
-      end
       
-      context "with a negative Z vector" do
-        before do
-          @line = Line.new(Vertex.new(1.0, 1.0, 1.0), Vertex.new(-1.0, -1.0, -1.0))
-        end
-        
-        it "should return a Point representing the intersection" do
-          @line.intersection_at_z(0).x.should == 0
-          @line.intersection_at_z(0).y.should == 0
-          @line.intersection_at_z(0).z.should == 0
-        end
-      end
-    end
-    
     context "for a line that lies on the target Z plane" do
       before do
         @line = Line.new(Vertex.new(0.0, 0.0, 3.0), Vertex.new(0.0, 6.0, 3.0))
@@ -182,9 +100,9 @@ describe Line do
   describe "#to_svg_path" do 
     it "should return a string containing an SVG path" do
       line = Line.new(Vertex.new(0.0, 0.0, 0.0), Vertex.new(1.0, 1.0, 1.0))
-      expected_output = '<path d="M 0.0 0.0 L 1.0 1.0" fill="none" stroke="black" stroke-width="1" />'
+      expected_output = '<path d="M 0.0 0.0 L 1.0 1.0" fill="none" stroke="black" stroke-width="0.005" />'
       
-      line.to_svg_path.should == expected_output
+      line.to_svg_path(:inches).should == expected_output
     end
   end
 end

data/spec/point_spec.rb

@@ -64,4 +64,25 @@ describe Point do
       (Point.new(1.0, 2.0, -3.1) == Point.new(1.0, 2.0, -3.2)).should be_false
     end
   end
+  
+  describe "#translate!" do
+    before do
+      @point = Point.new(1.0, 1.0, 1.0)
+    end
+    
+    it "should add the supplied value to X" do
+      @point.translate!(16.5, 9.5, 0.75)
+      @point.x.should == 17.5
+    end
+    
+    it "should add the supplied value to Y" do
+      @point.translate!(16.5, 9.5, 0.75)
+      @point.y.should == 10.5
+    end
+    
+    it "should add the supplied value to Z" do
+      @point.translate!(16.5, 9.5, 0.75)
+      @point.z.should == 1.75
+    end
+  end
 end

data/spec/polyline_spec.rb

@@ -8,13 +8,13 @@ describe Polyline do
       
       expected_svg  = '<?xml version="1.0" standalone="no"?>' + "\n"
       expected_svg += '<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">' + "\n"
-      expected_svg += '<svg xmlns="http://www.w3.org/2000/svg" version="1.1">' + "\n"
-      expected_svg += '  <g transform="translate(2,2)">' + "\n"
-      expected_svg += "    #{line.to_svg_path}\n"
+      expected_svg += '<svg x="0" y="0" width="20in" height="30in" viewBox="0 0 20 30" xmlns="http://www.w3.org/2000/svg" version="1.1">' + "\n"
+      expected_svg += '  <g transform="translate(1in,2in)">' + "\n"
+      expected_svg += "    #{line.to_svg_path(:inches)}\n"
       expected_svg += '  </g>' + "\n"
       expected_svg += '</svg>'
       
-      polyline.to_svg(2, 2).should == expected_svg
+      polyline.to_svg(20, 30, :inches, 1, 2).should == expected_svg
     end
   end
 end

data/spec/solid_spec.rb

@@ -79,7 +79,130 @@ describe Solid do
     it "should return a Polyline" do
       @solid.slice_at_z(0).should be_a Polyline
     end
+  end
+  
+  describe "#get_bounds" do
+    before do
+      @solid = Solid.parse(<<-EOD)
+        solid y-axis-spacer
+        facet normal 0.0 0.0 -1.0
+        outer loop
+        vertex -16.5 0.0 -0.75
+        vertex 0.0 -9.5 -0.75
+        vertex 0.0 0.0 -0.75
+        endloop
+        endfacet
+        facet normal -0.0 1.0 0.0
+        outer loop
+        vertex 0.0 -1.87 0.0
+        vertex 16.5 -1.87 -0.13
+        vertex 0.0 1.87 -0.13
+        endloop
+        endfacet
+        endsolid y-axis-spacer
+      EOD
+    end
+    
+    it "should return an array" do
+      @solid.get_bounds.should be_a Array
+    end
+    
+    it "should return a point with the smallest bounds" do
+      @solid.get_bounds[0].x.should == -16.5
+      @solid.get_bounds[0].y.should == -9.5
+      @solid.get_bounds[0].z.should == -0.75
+    end
     
+    it "should return a point with the largest bounds" do
+      @solid.get_bounds[1].x.should == 16.5
+      @solid.get_bounds[1].y.should == 1.87
+      @solid.get_bounds[1].z.should == 0.0
+    end
+  end
+  
+  describe "#translate!" do
+    before do
+      @solid = Solid.parse(<<-EOD)
+        solid y-axis-spacer
+        facet normal 0.0 0.0 -1.0
+        outer loop
+        vertex -16.5 0.0 -0.75
+        vertex 0.0 -9.5 -0.75
+        vertex 0.0 0.0 -0.75
+        endloop
+        endfacet
+        facet normal -0.0 1.0 0.0
+        outer loop
+        vertex 0.0 -1.87 0.0
+        vertex 16.5 -1.87 -0.13
+        vertex 0.0 1.87 -0.13
+        endloop
+        endfacet
+        endsolid y-axis-spacer
+      EOD
+    end
     
+    it "should call translate on each of it's Facets" do
+      @solid.facets[0].should_receive(:translate!).with(16.5, 9.5, 0.75)
+      @solid.facets[1].should_receive(:translate!).with(16.5, 9.5, 0.75)
+      
+      @solid.translate!(16.5, 9.5, 0.75)
+    end
+  end
+  
+  describe "#align_to_origin!" do
+    before do
+      @solid = Solid.parse(<<-EOD)
+        solid y-axis-spacer
+        facet normal 0.0 0.0 -1.0
+        outer loop
+        vertex -16.5 0.0 5.0
+        vertex 0.0 -9.5 10.0
+        vertex 0.0 0.0 5.0
+        endloop
+        endfacet
+        facet normal -0.0 1.0 0.0
+        outer loop
+        vertex 0.0 -1.87 5.0
+        vertex 16.5 -1.87 11.0
+        vertex 0.0 1.87 6.0
+        endloop
+        endfacet
+        endsolid y-axis-spacer
+      EOD
+    end
+    
+    it "should translate solid so the lowermost XYZ edges are all 0.0" do
+      @solid.should_receive(:translate!).with(16.5, 9.5, -5.0)
+      @solid.align_to_origin!
+    end
+  end
+  
+  describe "#center!" do
+    before do
+      @solid = Solid.parse(<<-EOD)
+        solid y-axis-spacer
+        facet normal 0.0 0.0 -1.0
+        outer loop
+        vertex -16.5 0.0 5.0
+        vertex 0.0 -9.5 10.0
+        vertex 0.0 0.0 5.0
+        endloop
+        endfacet
+        facet normal -0.0 1.0 0.0
+        outer loop
+        vertex 0.0 -1.87 5.0
+        vertex 17.5 -1.87 11.0
+        vertex 0.0 1.5 6.0
+        endloop
+        endfacet
+        endsolid y-axis-spacer
+      EOD
+    end
+    
+    it "should translate solid so the lowermost XYZ edges are all 0.0" do
+      @solid.should_receive(:translate!).with(-0.5, 4.0, -8.0)
+      @solid.center!
+    end
   end
 end

data/spec/units_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe Units do
+  describe ".name" do
+    it "should return 'inches' for :inches" do
+      Units.name(:inches).should == 'inches'
+    end
+    
+    it "should return 'centimeters' for :centimeters" do
+      Units.name(:centimeters).should == 'centimeters'
+    end
+    
+    it "should return 'millimeters' for :millimeters" do
+      Units.name(:millimeters).should == 'millimeters'
+    end
+    
+    it "should return 'none' for :none" do
+      Units.name(:none).should == 'none'
+    end
+    
+    it "should raise an exception if called with an unknown unit" do
+      lambda {
+        Units.name(:error)
+      }.should raise_error
+    end
+  end
+  
+  describe ".svg_name" do
+    it "should return 'in' for :inches" do
+      Units.svg_name(:inches).should == 'in'
+    end
+    
+    it "should return 'cm' for :centimeters" do
+      Units.svg_name(:centimeters).should == 'cm'
+    end
+    
+    it "should return 'mm' for :millimeters" do
+      Units.svg_name(:millimeters).should == 'mm'
+    end
+    
+    it "should return '' for :none" do
+      Units.svg_name(:none).should == ''
+    end
+    
+    it "should raise an exception if called with an unknown unit" do
+      lambda {
+        Units.svg_name(:error)
+      }.should raise_error
+    end
+  end
+  
+  describe ".stroke_width" do
+    it "should return 'in' for :inches" do
+      Units.stroke_width(:inches).should == 0.005
+    end
+    
+    it "should return 'cm' for :centimeters" do
+      Units.stroke_width(:centimeters).should == 0.01
+    end
+    
+    it "should return 'mm' for :millimeters" do
+      Units.stroke_width(:millimeters).should == 0.1
+    end
+    
+    it "should return '' for :none" do
+      Units.stroke_width(:none).should == 0.1
+    end
+    
+    it "should raise an exception if called with an unknown unit" do
+      lambda {
+        Units.stroke_width(:error)
+      }.should raise_error
+    end
+  end
+end

metadata

@@ -2,7 +2,7 @@
 name: triangular
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Aaron Gough
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-10-17 00:00:00 Z
+date: 2011-10-19 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: bundler
@@ -59,6 +59,7 @@ files:
 - lib/triangular/point.rb
 - lib/triangular/polyline.rb
 - lib/triangular/solid.rb
+- lib/triangular/units.rb
 - lib/triangular/vector.rb
 - lib/triangular/version.rb
 - lib/triangular/vertex.rb
@@ -71,6 +72,7 @@ files:
 - spec/solid_spec.rb
 - spec/spec_helper.rb
 - spec/triangular_spec.rb
+- spec/units_spec.rb
 - spec/vertex_spec.rb
 - triangular.gemspec
 homepage: http://rubygems.org/gems/triangular