gmath3D 0.2.5 → 1.0.0

data/.document

@@ -1,5 +1,5 @@
-lib/**/*.rb
-bin/*
-- 
-features/**/*.feature
-LICENSE.txt
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -1,5 +1,5 @@
-source "http://rubygems.org"
-group :development do
-  gem "bundler", "~> 1.0.0"
-  gem "jeweler", "~> 1.6.4"
-end
+source "http://rubygems.org"
+group :development do
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+end

data/LICENSE.txt

@@ -1,20 +1,20 @@
-Copyright (c) 2011 Toshiyasu Shimizu
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Copyright (c) 2011 Toshiyasu Shimizu
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -1,19 +1,19 @@
-= gmath3D
-
-This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements.
-
-== Class list in gmath3D
-* Vector3 class signifies point and vector in 3D.
-* Line class signifies inifinite line in 3D.
-* FiniteLine class signifies finite line in 3D.
-* Plane class signifies inifinite plane in 3D.
-* Rectangle class signifies finite plane that has 4 edges in 3.
-* Triangle class signifies finite plane that has 3 edges in 3.
-* Box class signifies axially aligned box.
-* Geom class is parent class of all 3D elements.
-
-== Copyright
-
-Copyright (c) 2011 Toshiyasu Shimizu. See LICENSE.txt for
-further details.
-
+= gmath3D
+
+This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements.
+
+== Class list in gmath3D
+* Vector3 class signifies point and vector in 3D.
+* Line class signifies inifinite line in 3D.
+* FiniteLine class signifies finite line in 3D.
+* Plane class signifies inifinite plane in 3D.
+* Rectangle class signifies finite plane that has 4 edges in 3.
+* Triangle class signifies finite plane that has 3 edges in 3.
+* Box class signifies axially aligned box.
+* Geom class is parent class of all 3D elements.
+
+== Copyright
+
+Copyright (c) 2011 Toshiyasu Shimizu. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -1,45 +1,45 @@
-# encoding: utf-8
-
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'rake'
-
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
-  gem.name = "gmath3D"
-  gem.homepage = "http://github.com/toshi0328/gmath3D"
-  gem.license = "MIT"
-  gem.summary = %Q{Geometric elements in 3D}
-  gem.description = %Q{This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements.}
-  gem.email = "toshi0328@gmail.com"
-  gem.authors = ["Toshiyasu Shimizu"]
-  # dependencies defined in Gemfile
-end
-Jeweler::RubygemsDotOrgTasks.new
-
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-end
-
-task :default => :test
-
-require 'rake/rdoctask'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "gmath3D #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "gmath3D"
+  gem.homepage = "http://github.com/toshi0328/gmath3D"
+  gem.license = "MIT"
+  gem.summary = %Q{Geometric elements in 3D}
+  gem.description = %Q{This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements.}
+  gem.email = "toshi0328@gmail.com"
+  gem.authors = ["Toshiyasu Shimizu"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "gmath3D #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -1 +1 @@
-0.2.5
+1.0.0

data/gmath3D.gemspec

@@ -1,79 +1,79 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{gmath3D}
-  s.version = "0.2.5"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Toshiyasu Shimizu"]
-  s.date = %q{2011-12-01}
-  s.description = %q{This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements.}
-  s.email = %q{toshi0328@gmail.com}
-  s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.rdoc"
-  ]
-  s.files = [
-    ".document",
-    "Gemfile",
-    "LICENSE.txt",
-    "README.rdoc",
-    "Rakefile",
-    "VERSION",
-    "gmath3D.gemspec",
-    "lib/box.rb",
-    "lib/ellipse.rb",
-    "lib/ext.rb",
-    "lib/finite_line.rb",
-    "lib/geom.rb",
-    "lib/gmath3D.rb",
-    "lib/line.rb",
-    "lib/plane.rb",
-    "lib/polyline.rb",
-    "lib/quat.rb",
-    "lib/rectangle.rb",
-    "lib/tri_mesh.rb",
-    "lib/triangle.rb",
-    "lib/util.rb",
-    "lib/vector3.rb",
-    "test/helper.rb",
-    "test/test_box.rb",
-    "test/test_ellipse.rb",
-    "test/test_finite_line.rb",
-    "test/test_geom.rb",
-    "test/test_line.rb",
-    "test/test_matrix_util.rb",
-    "test/test_plane.rb",
-    "test/test_polyline.rb",
-    "test/test_quat.rb",
-    "test/test_rectangle.rb",
-    "test/test_tri_mesh.rb",
-    "test/test_triangle.rb",
-    "test/test_util.rb",
-    "test/test_vector3.rb"
-  ]
-  s.homepage = %q{http://github.com/toshi0328/gmath3D}
-  s.licenses = ["MIT"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.7.2}
-  s.summary = %q{Geometric elements in 3D}
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
-    else
-      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
-      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
-    end
-  else
-    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
-    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
-  end
-end
-
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "gmath3D"
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Toshiyasu Shimizu"]
+  s.date = "2011-12-11"
+  s.description = "This library defines 3D geometric elements(point, line, plane etc..). It can get two(or more) elements relation, like distance between two elements."
+  s.email = "toshi0328@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "gmath3D.gemspec",
+    "lib/box.rb",
+    "lib/ellipse.rb",
+    "lib/ext.rb",
+    "lib/finite_line.rb",
+    "lib/geom.rb",
+    "lib/gmath3D.rb",
+    "lib/line.rb",
+    "lib/plane.rb",
+    "lib/polyline.rb",
+    "lib/quat.rb",
+    "lib/rectangle.rb",
+    "lib/tri_mesh.rb",
+    "lib/triangle.rb",
+    "lib/util.rb",
+    "lib/vector3.rb",
+    "test/helper.rb",
+    "test/test_box.rb",
+    "test/test_ellipse.rb",
+    "test/test_finite_line.rb",
+    "test/test_geom.rb",
+    "test/test_line.rb",
+    "test/test_matrix_util.rb",
+    "test/test_plane.rb",
+    "test/test_polyline.rb",
+    "test/test_quat.rb",
+    "test/test_rectangle.rb",
+    "test/test_tri_mesh.rb",
+    "test/test_triangle.rb",
+    "test/test_util.rb",
+    "test/test_vector3.rb"
+  ]
+  s.homepage = "http://github.com/toshi0328/gmath3D"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.11"
+  s.summary = "Geometric elements in 3D"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+    else
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    end
+  else
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+  end
+end
+

data/lib/box.rb

@@ -1,145 +1,146 @@
-require 'gmath3D'
-
-module GMath3D
-  #
-  # Box represents an axitially aligned box on 3D space.
-  #
-  class Box < Geom
-    attr_reader :min_point
-    attr_reader :max_point
-
-    # [Input]
-    #  _point1_ and _point2_ should be Vector3.
-    #  Each points are opposing corners.
-    # [Output]
-    #  return new instance of Box.
-    def initialize(point1 = Vector3.new(0,0,0), point2 = Vector3.new(1,1,1))
-      Util3D.check_arg_type(Vector3, point1)
-      Util3D.check_arg_type(Vector3, point2)
-      super()
-      @min_point = Vector3.new();
-      @max_point = Vector3.new();
-      @min_point.x = [ point1.x, point2.x ].min
-      @min_point.y = [ point1.y, point2.y ].min
-      @min_point.z = [ point1.z, point2.z ].min
-      @max_point.x = [ point1.x, point2.x ].max
-      @max_point.y = [ point1.y, point2.y ].max
-      @max_point.z = [ point1.z, point2.z ].max
-    end
-
-    # [Input]
-    #  _points_ should be Array of Vector3.
-    #  Each points are opposing corners.
-    # [Output]
-    #  return new instance of Box.
-    def self.from_points( points )
-      return nil if (points == nil || points.size <=0)
-      box = Box.new(points[0], points[0])
-      box += points
-      return box
-    end
-
-    def to_s
-      "Box[min#{min_point.to_element_s}, max#{max_point.to_element_s}]"
-    end
-
-    def ==(rhs)
-      equals_inner(rhs)
-    end
-
-    # [Input]
-    #  _rhs_ shold be Vector3 or Box or Array of them.
-    # [Output]
-    #  return added result as Box.
-    def +(rhs)
-      add(rhs)
-    end
-
-    # [Output]
-    #  return cente point of Box as Vector3.
-    def center
-      return (@min_point + @max_point) * 0.5
-    end
-
-    # [Output]
-    #  return width, height, depth as [Numeric, Numeric, Numeric]
-    def length
-      return max_point.x - min_point.x, max_point.y - min_point.y, max_point.z - min_point.z
-    end
-
-    # [Output]
-    #  return volume of Box as Numeric.
-    def volume
-      width, height, depth = self.length
-      return width*height*depth
-    end
-
-    # [Output]
-    #  return all vertices of Box.
-    def vertices
-      verts = Array.new(8)
-      length_ary = self.length
-      verts[0] = @min_point.clone
-      verts[1] = @min_point + Vector3.new(length_ary[0],             0,            0 )
-      verts[2] = @min_point + Vector3.new(length_ary[0], length_ary[1],            0 )
-      verts[3] = @min_point + Vector3.new(            0, length_ary[1],            0 )
-      verts[4] = @min_point + Vector3.new(            0,             0, length_ary[2])
-      verts[5] = @min_point + Vector3.new(length_ary[0],             0, length_ary[2])
-      verts[6] = @min_point + Vector3.new(length_ary[0], length_ary[1], length_ary[2])
-      verts[7] = @min_point + Vector3.new(            0, length_ary[1], length_ary[2])
-      return verts
-    end
-
-    # [input]
-    #  _vec_ should be Vector3.
-    # [Output]
-    #  return translated box as Box.
-    def translate(vec)
-      return Box.new(min_point + vec, max_point + vec)
-    end
-
-    # [input]
-    #  _quat_ should be Quat.
-    # [Output]
-    #  return rotated box as Box.
-    #  since Box is AABB, returned box might be bigger than original one.
-    def rotate(quat)
-      rot_matrix = Matrix.from_quat(quat)
-      verts = self.vertices
-      verts = verts.collect {|item| rot_matrix*item}
-      return Box.from_points(verts)
-    end
-
-private
-    def equals_inner(rhs)
-      return false if( !rhs.kind_of?(Box) )
-      return false if(self.min_point != rhs.min_point)
-      return false if(self.max_point != rhs.max_point)
-      true
-    end
-    def add(rhs)
-      return self if (rhs == nil)
-      if( rhs.kind_of?(Vector3))
-        added_box = Box.new()
-        added_box.min_point.x = [ self.min_point.x, rhs.x ].min
-        added_box.min_point.y = [ self.min_point.y, rhs.y ].min
-        added_box.min_point.z = [ self.min_point.z, rhs.z ].min
-        added_box.max_point.x = [ self.max_point.x, rhs.x ].max
-        added_box.max_point.y = [ self.max_point.y, rhs.y ].max
-        added_box.max_point.z = [ self.max_point.z, rhs.z ].max
-        return added_box
-      elsif( rhs.kind_of?(Box))
-        min_max_point_ary = [rhs.min_point, rhs.max_point]
-        return self + min_max_point_ary
-      elsif(rhs.kind_of?(Array))
-        added_box = self;
-        rhs.each do |item|
-          added_box = added_box + item
-        end
-        return added_box
-      end
-      Util3D.raise_argurment_error(rhs)
-    end
-  end
-end
-
+require 'gmath3D'
+
+module GMath3D
+  #
+  # Box represents an axitially aligned box on 3D space.
+  #
+  class Box < Geom
+    attr_reader :min_point
+    attr_reader :max_point
+
+    # [Input]
+    #  _point1_ and _point2_ should be Vector3.
+    #  Each points are opposing corners.
+    # [Output]
+    #  return new instance of Box.
+    def initialize(point1 = Vector3.new(0,0,0), point2 = Vector3.new(1,1,1))
+      Util3D.check_arg_type(Vector3, point1)
+      Util3D.check_arg_type(Vector3, point2)
+      super()
+      @min_point = Vector3.new();
+      @max_point = Vector3.new();
+      @min_point.x = [ point1.x, point2.x ].min
+      @min_point.y = [ point1.y, point2.y ].min
+      @min_point.z = [ point1.z, point2.z ].min
+      @max_point.x = [ point1.x, point2.x ].max
+      @max_point.y = [ point1.y, point2.y ].max
+      @max_point.z = [ point1.z, point2.z ].max
+    end
+
+    # [Input]
+    #  _points_ should be Array of Vector3.
+    #  Each points are opposing corners.
+    # [Output]
+    #  return new instance of Box.
+    def self.from_points( points )
+      return nil if (points == nil || points.size <=0)
+      box = Box.new(points[0], points[0])
+      box += points
+      return box
+    end
+
+    def to_s
+      "Box[min#{min_point.to_element_s}, max#{max_point.to_element_s}]"
+    end
+
+    def ==(rhs)
+      equals_inner(rhs)
+    end
+
+    # [Input]
+    #  _rhs_ shold be Vector3 or Box or Array of them.
+    # [Output]
+    #  return added result as Box.
+    def +(rhs)
+      add(rhs)
+    end
+
+    # [Output]
+    #  return cente point of Box as Vector3.
+    def center
+      return (@min_point + @max_point) * 0.5
+    end
+
+    # [Output]
+    #  return width, height, depth as [Numeric, Numeric, Numeric]
+    def length
+      return max_point.x - min_point.x, max_point.y - min_point.y, max_point.z - min_point.z
+    end
+
+    # [Output]
+    #  return volume of Box as Numeric.
+    def volume
+      width, height, depth = self.length
+      return width*height*depth
+    end
+
+    # [Output]
+    #  return all vertices of Box.
+    def vertices
+      verts = Array.new(8)
+      length_ary = self.length
+      verts[0] = @min_point.clone
+      verts[1] = @min_point + Vector3.new(length_ary[0],             0,            0 )
+      verts[2] = @min_point + Vector3.new(length_ary[0], length_ary[1],            0 )
+      verts[3] = @min_point + Vector3.new(            0, length_ary[1],            0 )
+      verts[4] = @min_point + Vector3.new(            0,             0, length_ary[2])
+      verts[5] = @min_point + Vector3.new(length_ary[0],             0, length_ary[2])
+      verts[6] = @min_point + Vector3.new(length_ary[0], length_ary[1], length_ary[2])
+      verts[7] = @min_point + Vector3.new(            0, length_ary[1], length_ary[2])
+      return verts
+    end
+
+    # [input]
+    #  _vec_ should be Vector3.
+    # [Output]
+    #  return translated box as Box.
+    def translate(vec)
+      return Box.new(min_point + vec, max_point + vec)
+    end
+
+    # [input]
+    #  _quat_ should be Quat.
+    # [Output]
+    #  return rotated box as Box.
+    #  since Box is AABB, returned box might be bigger than original one.
+    def rotate(quat)
+      rot_matrix = Matrix.from_quat(quat)
+      verts = self.vertices
+      inv_mat = rot_matrix.inv
+      verts = verts.collect {|item| inv_mat*item}
+      return Box.from_points(verts)
+    end
+
+private
+    def equals_inner(rhs)
+      return false if( !rhs.kind_of?(Box) )
+      return false if(self.min_point != rhs.min_point)
+      return false if(self.max_point != rhs.max_point)
+      true
+    end
+    def add(rhs)
+      return self if (rhs == nil)
+      if( rhs.kind_of?(Vector3))
+        added_box = Box.new()
+        added_box.min_point.x = [ self.min_point.x, rhs.x ].min
+        added_box.min_point.y = [ self.min_point.y, rhs.y ].min
+        added_box.min_point.z = [ self.min_point.z, rhs.z ].min
+        added_box.max_point.x = [ self.max_point.x, rhs.x ].max
+        added_box.max_point.y = [ self.max_point.y, rhs.y ].max
+        added_box.max_point.z = [ self.max_point.z, rhs.z ].max
+        return added_box
+      elsif( rhs.kind_of?(Box))
+        min_max_point_ary = [rhs.min_point, rhs.max_point]
+        return self + min_max_point_ary
+      elsif(rhs.kind_of?(Array))
+        added_box = self;
+        rhs.each do |item|
+          added_box = added_box + item
+        end
+        return added_box
+      end
+      Util3D.raise_argurment_error(rhs)
+    end
+  end
+end
+