triangular 0.0.1

data/spec/fixtures/test_cube.stl

@@ -0,0 +1,58 @@
+solid model
+facet normal -0.0 1.0 -0.0
+outer loop
+vertex -1.0 1.0 1.0
+vertex 0.999999999999999 1.0 -1.0
+vertex -1.0 1.0 -1.0
+endloop
+endfacet
+facet normal -0.0 1.0 -0.0
+outer loop
+vertex 0.999999999999999 1.0 -1.0
+vertex -1.0 1.0 1.0
+vertex 0.999999999999999 1.0 1.0
+endloop
+endfacet
+facet normal 1.0 -0.0 -0.0
+outer loop
+vertex 0.999999999999999 1.0 -1.0
+vertex 0.999999999999999 -1.0 1.0
+vertex 0.999999999999999 -1.0 -1.0
+endloop
+endfacet
+facet normal 1.0 -0.0 -0.0
+outer loop
+vertex 0.999999999999999 -1.0 1.0
+vertex 0.999999999999999 1.0 -1.0
+vertex 0.999999999999999 1.0 1.0
+endloop
+endfacet
+facet normal 0.0 -1.0 0.0
+outer loop
+vertex 0.999999999999999 -1.0 1.0
+vertex -1.0 -1.0 -1.0
+vertex 0.999999999999999 -1.0 -1.0
+endloop
+endfacet
+facet normal 0.0 -1.0 0.0
+outer loop
+vertex -1.0 -1.0 -1.0
+vertex 0.999999999999999 -1.0 1.0
+vertex -1.0 -1.0 1.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex -1.0 1.0 1.0
+vertex -1.0 -1.0 -1.0
+vertex -1.0 -1.0 1.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex -1.0 -1.0 -1.0
+vertex -1.0 1.0 1.0
+vertex -1.0 1.0 -1.0
+endloop
+endfacet
+endsolid model

data/spec/fixtures/y-axis-spacer.stl

@@ -0,0 +1,310 @@
+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 0.0 -1.0
+outer loop
+vertex 0.0 -9.5 -0.75
+vertex 16.5 0.0 -0.75
+vertex 16.5 -9.5 -0.75
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 16.5 -9.5 0.0
+vertex 0.0 -9.5 -0.75
+vertex 16.5 -9.5 -0.75
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 0.0 -9.5 -0.75
+vertex 16.5 -9.5 0.0
+vertex 0.0 -9.5 0.0
+endloop
+endfacet
+facet normal -0.0 1.0 0.0
+outer loop
+vertex 0.0 0.0 0.0
+vertex 16.5 0.0 -0.75
+vertex 0.0 0.0 -0.75
+endloop
+endfacet
+facet normal -0.0 1.0 0.0
+outer loop
+vertex 16.5 0.0 -0.75
+vertex 0.0 0.0 0.0
+vertex 16.5 0.0 0.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 -2.13 0.0
+vertex 0.0 -7.37 -0.13
+vertex 0.0 -7.37 0.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 0.0 0.0
+vertex 0.0 -1.87 -0.13
+vertex 0.0 -1.87 0.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 -7.63 0.0
+vertex 0.0 -9.5 -0.75
+vertex 0.0 -9.5 0.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 -9.5 -0.75
+vertex 0.0 -7.63 0.0
+vertex 0.0 -7.63 -0.13
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 -9.5 -0.75
+vertex 0.0 -7.63 -0.13
+vertex 0.0 0.0 -0.75
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 0.0 -0.75
+vertex 0.0 -7.63 -0.13
+vertex 0.0 -7.37 -0.13
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 0.0 -0.75
+vertex 0.0 -7.37 -0.13
+vertex 0.0 -2.13 -0.13
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 -2.13 -0.13
+vertex 0.0 -7.37 -0.13
+vertex 0.0 -2.13 0.0
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 0.0 -0.75
+vertex 0.0 -2.13 -0.13
+vertex 0.0 -1.87 -0.13
+endloop
+endfacet
+facet normal -1.0 0.0 0.0
+outer loop
+vertex 0.0 0.0 -0.75
+vertex 0.0 -1.87 -0.13
+vertex 0.0 0.0 0.0
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 0.0 -0.75
+vertex 16.5 -9.5 0.0
+vertex 16.5 -9.5 -0.75
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -9.5 0.0
+vertex 16.5 0.0 -0.75
+vertex 16.5 -7.63 -0.13
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -7.63 -0.13
+vertex 16.5 0.0 -0.75
+vertex 16.5 -7.37 -0.13
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -7.37 -0.13
+vertex 16.5 0.0 -0.75
+vertex 16.5 -7.37 0.0
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -7.37 0.0
+vertex 16.5 0.0 -0.75
+vertex 16.5 -2.13 -0.13
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -2.13 -0.13
+vertex 16.5 0.0 -0.75
+vertex 16.5 -1.87 -0.13
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -1.87 -0.13
+vertex 16.5 0.0 -0.75
+vertex 16.5 -1.87 0.0
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -1.87 0.0
+vertex 16.5 0.0 -0.75
+vertex 16.5 0.0 0.0
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -2.13 0.0
+vertex 16.5 -7.37 0.0
+vertex 16.5 -2.13 -0.13
+endloop
+endfacet
+facet normal 1.0 -5.23431439438796e-32 -6.31593542897867e-15
+outer loop
+vertex 16.5 -7.63 0.0
+vertex 16.5 -9.5 0.0
+vertex 16.5 -7.63 -0.13
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 16.5 -1.87 0.0
+vertex 0.0 0.0 0.0
+vertex 0.0 -1.87 0.0
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 0.0 0.0 0.0
+vertex 16.5 -1.87 0.0
+vertex 16.5 0.0 0.0
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 16.5 -9.5 0.0
+vertex 0.0 -7.63 0.0
+vertex 0.0 -9.5 0.0
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 0.0 -7.63 0.0
+vertex 16.5 -9.5 0.0
+vertex 16.5 -7.63 0.0
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 16.5 -7.37 0.0
+vertex 0.0 -2.13 0.0
+vertex 0.0 -7.37 0.0
+endloop
+endfacet
+facet normal -0.0 -0.0 1.0
+outer loop
+vertex 0.0 -2.13 0.0
+vertex 16.5 -7.37 0.0
+vertex 16.5 -2.13 0.0
+endloop
+endfacet
+facet normal 0.0 0.0 -1.0
+outer loop
+vertex 16.5 -7.37 -0.13
+vertex 0.0 -7.63 -0.13
+vertex 0.0 -7.37 -0.13
+endloop
+endfacet
+facet normal 0.0 0.0 -1.0
+outer loop
+vertex 0.0 -7.63 -0.13
+vertex 16.5 -7.37 -0.13
+vertex 16.5 -7.63 -0.13
+endloop
+endfacet
+facet normal -0.0 1.0 0.0
+outer loop
+vertex 0.0 -7.37 0.0
+vertex 16.5 -7.37 -0.13
+vertex 0.0 -7.37 -0.13
+endloop
+endfacet
+facet normal -0.0 1.0 0.0
+outer loop
+vertex 16.5 -7.37 -0.13
+vertex 0.0 -7.37 0.0
+vertex 16.5 -7.37 0.0
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 16.5 -7.63 0.0
+vertex 0.0 -7.63 -0.13
+vertex 16.5 -7.63 -0.13
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 0.0 -7.63 -0.13
+vertex 16.5 -7.63 0.0
+vertex 0.0 -7.63 0.0
+endloop
+endfacet
+facet normal 0.0 0.0 -1.0
+outer loop
+vertex 16.5 -1.87 -0.13
+vertex 0.0 -2.13 -0.13
+vertex 0.0 -1.87 -0.13
+endloop
+endfacet
+facet normal 0.0 0.0 -1.0
+outer loop
+vertex 0.0 -2.13 -0.13
+vertex 16.5 -1.87 -0.13
+vertex 16.5 -2.13 -0.13
+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
+facet normal -0.0 1.0 0.0
+outer loop
+vertex 16.5 -1.87 -0.13
+vertex 0.0 -1.87 0.0
+vertex 16.5 -1.87 0.0
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 16.5 -2.13 0.0
+vertex 0.0 -2.13 -0.13
+vertex 16.5 -2.13 -0.13
+endloop
+endfacet
+facet normal -0.0 -1.0 -0.0
+outer loop
+vertex 0.0 -2.13 -0.13
+vertex 16.5 -2.13 0.0
+vertex 0.0 -2.13 0.0
+endloop
+endfacet
+endsolid y-axis-spacer

data/spec/line_spec.rb

@@ -0,0 +1,190 @@
+require 'spec_helper'
+
+describe Line do
+  describe "#intersects_z?" do 
+    context "for a line that intersects the target Z plane" 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 true" do
+          @line.intersects_z?(3.0).should be_true
+        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))
+        end
+        
+        it "should return true" do
+          @line.intersects_z?(3.0).should be_true
+        end
+      end
+    end
+    
+    context "for a line that does not intersect the target Z plane" do
+      before do
+        @line = Line.new(Vertex.new(0.0, 0.0, 4.0), Vertex.new(0.0, 0.0, 6.0))
+      end
+      
+      it "should return false" do
+        @line.intersects_z?(3.0).should be_false
+      end
+    end
+  end
+  
+  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 "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
+          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
+        
+        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))
+          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
+          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))
+      end
+      
+      it "should raise an error" do
+        lambda{
+          @line.intersection_at_z(3.0)
+        }.should raise_error
+      end
+    end
+    
+    context "for a line that does not intersect the target Z plane" do
+      before do
+        @line = Line.new(Vertex.new(0.0, 0.0, 4.0), Vertex.new(0.0, 0.0, 6.0))
+      end
+      
+      it "should return nil" do
+        @line.intersection_at_z(3.0).should be_nil
+      end
+    end
+  end
+  
+  describe "==" do
+    it "should return true when the two lines are identical" do
+      (Line.new(Vertex.new(-1.0, -1.0, -1.0), Vertex.new(1.0, 1.0, 1.0)) == Line.new(Vertex.new(-1.0, -1.0, -1.0), Vertex.new(1.0, 1.0, 1.0))).should be_true
+    end
+    
+    it "should not return true when the lines are not identical" do
+      (Line.new(Vertex.new(-1.0, -1.0, -1.1), Vertex.new(1.0, 1.0, 1.0)) == Line.new(Vertex.new(-1.0, -1.0, -1.0), Vertex.new(1.0, 1.0, 1.0))).should be_false
+    end
+  end
+  
+  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" />'
+      
+      line.to_svg_path.should == expected_output
+    end
+  end
+end