vector2d 0.0.5 → 0.5.2

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Inge Jørgensen
+
+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

@@ -0,0 +1,32 @@
+== Vector2d
+
+Vector2d allows for easy handling of two-dimensionals coordinates and vectors.
+It's very flexible, most methods accepts arguments as strings, arrays, hashes
+or Vector2d objects.
+
+== Licence
+
+(The MIT License)
+
+Copyright (c) 2006-2009 Inge Jørgensen
+ 
+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/Rakefile

@@ -0,0 +1,83 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "vector2d"
+    gem.summary = %Q{Vector2d allows for easy handling of two-dimensionals coordinates and vectors}
+    gem.email = "inge@elektronaut.no"
+    gem.homepage = "http://github.com/elektronaut/vector2d"
+    gem.authors = ["Inge Jørgensen"]
+	gem.rubyforge_project = 'vector2d'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+begin
+  require 'rake/contrib/sshpublisher'
+  namespace :rubyforge do
+
+    desc "Release gem and RDoc documentation to RubyForge"
+    task :release => ["rubyforge:release:gem", "rubyforge:release:docs"]
+
+    namespace :release do
+      desc "Publish RDoc to RubyForge."
+      task :docs => [:rdoc] do
+        config = YAML.load(
+            File.read(File.expand_path('~/.rubyforge/user-config.yml'))
+        )
+
+        host = "#{config['username']}@rubyforge.org"
+        remote_dir = "/var/www/gforge-projects/the-perfect-gem/"
+        local_dir = 'rdoc'
+
+        Rake::SshDirPublisher.new(host, remote_dir, local_dir).upload
+      end
+    end
+  end
+rescue LoadError
+  puts "Rake SshDirPublisher is unavailable or your rubyforge environment is not configured."
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "vector2d #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+

data/VERSION

@@ -0,0 +1 @@
+0.5.2

data/lib/vector2d.rb

@@ -1,157 +1,151 @@
-#--
-# Copyright (c) 2006 Inge Jørgensen <inge@elektronaut.no>
-#
-# 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.
-#++
-
-
-# Class for for easy handling of two-dimensional coordinates. It's forte is argument flexibility, 
-# methods that take vectors accepts arguments in many forms. See Vector2d.new for details and examples.
-class Vector2d
-
-  # X axis
-  attr_accessor :x
-  # Y axis
-  attr_accessor :y
-
-
-
-  # Create a new vector from args. The following examples are equal:
-  #   Vector2d.new( 150, 100 )
-  #   Vector2d.new( 150.0, 100.0 )
-  #   Vector2d.new( "150x100" )
-  #   Vector2d.new( "150.0x100.0" )
-  #   Vector2d.new( [150,100} )
-  #   Vector2d.new( { :x => 150, :y => 100 } )
-  #   Vector2d.new( { "x" => 150.0, "y" => 100.0 } )
-  #   Vector2d.new( Vector2d.new( 150, 100 ) )
-  def initialize( *args )
-    args.flatten!
-	if ( args.length == 1 )
-		if ( args[0].kind_of?( String ) && args[0].match( /^[\s]*[\d\.]*[\s]*x[\s]*[\d\.]*[\s]*$/ ) )
-			args = args[0].split( "x" )
-		elsif args[0].kind_of?( Vector2d )
-			args = [ args[0].x, args[0].y ]
-		elsif args[0].kind_of?( Hash )
-			args[0] = args[0][:x]  if args[0][:x]
-			args[0] = args[0]["x"] if args[0]["x"]
-			args[1] = args[0][:y]  if args[0][:y]
-			args[1] = args[0]["y"] if args[0]["y"]
-		else
-			args = [ args[0], args[0] ]
-		end
-	end
-	@x, @y = args[0].to_f, args[1].to_f
-  end
-
-
-
-  # Compare two vectors
-  def ==( comp )
-	( comp.x == @x && comp.y == y )
-  end
-
-
-
-  # Get a String representation of vector.
-  #   Vector2d.new( 150, 100 ).to_s  # "150x100"
-  def to_s; "#{@x}x#{@y}"; end
-  
-  
-  
-  # Get length of vector.
-  def length; Math.sqrt((@x*@x)+(@y*@y)); end
-  
-  # Set new length.
-  def length= ( new_length )
-    v = self * (new_length/length)
-    @x, @y = v.x, v.y
-  end
-  
-  
-  
-  # Normalize vector (set length to 1.0)
-  def normalize;  self.dup.normalize!; end
-  # In-place form of Vector2d.normalize.
-  def normalize!; length = 1.0; self; end
-
-
-  # Round coordinates to nearest integer.
-  def round; self.dup.round!; end
-  # In-place form of Vector2d.round.
-  def round!; @x, @y = @x.round, @y.round; self; end
-
-
-  # Get the aspect ratio of the vector, returns a Float.
-  def aspect_ratio; (@x/@y).abs; end
-  
-  
-
-  # Multiply vectors. If args is a single Numeric, both axis will be multiplied.
-  def * ( *vector_or_number ); v = Vector2d::new( vector_or_number ); Vector2d.new( @x * v.x, @y * v.y ); end
-  # Divide vectors. If args is a single Numeric, both axis will be divided.
-  def / ( *vector_or_number ); v = Vector2d::new( vector_or_number ); Vector2d.new( @x / v.x, @y / v.y ); end
-  # Add vectors. If args is a single Numeric, it will be added to both axis.
-  def + ( *vector_or_number ); v = Vector2d::new( vector_or_number ); Vector2d.new( @x + v.x, @y + v.y ); end
-  # Subtract vectors. If args is a single Numeric, it will be subtracted from both axis.
-  def - ( *vector_or_number ); v = Vector2d::new( vector_or_number ); Vector2d.new( @x - v.x, @y - v.y ); end
-  
-  
-  
-  # Constrain/expand so that both coordinates fit within (the square implied by) another vector.
-  # This is useful for resizing images to fit a certain size while keeping aspect ratio.
-  #
-  # == Examples
-  #
-  #   my_image = Vector2d.new( "320x200" )  # Creates a new vector object
-  #   my_image.constrain_both( 100 )        # Returns a new vector: x=100, y=63
-  #   my_image.constrain_both( 150, 50 )    # Returns a new vector: x=80, y=50
-  #   my_image.constrain_both( "150x50" )   # Equal to constrain_both( 150, 50 )
-  #   my_image.constrain_both( "x100" )     # Returns a new vector: x=160, y=100
-  #
-  # == Note
-  #
-  # Either axis will be disregarded if zero or nil (see the last example). This is a feature, not a bug. ;)
-  def constrain_both( *vector_or_number )
-    scale = Vector2d::new( vector_or_number ) / self
-    ( self * ( (scale.y==0||(scale.x>0&&scale.x<scale.y) ) ? scale.x : scale.y ) )
-  end
-    
-    
-  
-  # Constrain/expand so that one of the coordinates fit within (the square implied by) another vector.
-  #
-  # == Example
-  #  
-  #   my_image = Vector2d.new( "320x200" )  # Creates a new vector object
-  #   my_image.constrain_one( 100, 100 )    # Returns a new vector: x=160, y=100
-  def constrain_one( *vector_or_number )
-    scale = Vector2d::new( vector_or_number ) / self
-    if ( scale.x > 0 && scale.y > 0 )
-	  scale = ( scale.x<scale.y) ? scale.y : scale.x
-	  self * scale
-    else
-      constrain_both( args )
-    end
-  end
-  
-end #class Vector2d
-
-
+# Vector2d allows for easy handling of two-dimensionals coordinates and vectors.
+# It's very flexible, most methods accepts arguments as strings, arrays, hashes
+# or Vector2d objects.
+class Vector2d
+
+	# X axis
+	attr_accessor :x
+	# Y axis
+	attr_accessor :y
+
+	# Creates a new vector.
+	# The following examples are all valid:
+	#
+	#   Vector2d.new(150, 100)
+	#   Vector2d.new(150.0, 100.0)
+	#   Vector2d.new("150x100")
+	#   Vector2d.new("150.0x100.0")
+	#   Vector2d.new([150,100})
+	#   Vector2d.new({:x => 150, :y => 100})
+	#   Vector2d.new({"x" => 150.0, "y" => 100.0})
+	#   Vector2d.new(Vector2d.new(150, 100))
+	def initialize(*args)
+		args.flatten!
+		if (args.length == 1)
+			if (args[0].kind_of?(String) && args[0].match(/^[\s]*[\d\.]*[\s]*x[\s]*[\d\.]*[\s]*$/))
+				args = args[0].split("x")
+			elsif args[0].kind_of?(Vector2d)
+				args = [args[0].x, args[0].y]
+			elsif args[0].kind_of?(Hash)
+				args[0] = args[0][:x]  if args[0][:x]
+				args[0] = args[0]["x"] if args[0]["x"]
+				args[1] = args[0][:y]  if args[0][:y]
+				args[1] = args[0]["y"] if args[0]["y"]
+			else
+				args = [args[0], args[0]]
+			end
+		end
+		@x, @y = args[0].to_f, args[1].to_f
+	end
+
+	# Compares two vectors.
+	def ==(comp)
+		( comp.x == @x && comp.y == y )
+	end
+
+	# Returns a string representation of the vector.
+	#
+	# Example:
+	#   Vector2d.new( 150, 100 ).to_s  # "150x100"
+	def to_s
+		"#{@x}x#{@y}"
+	end
+
+	# Length of vector
+	def length
+		Math.sqrt((@x*@x)+(@y*@y))
+	end
+
+	# Set new length.
+	def length=(new_length)
+		v = self * (new_length/length)
+		@x, @y = v.x, v.y
+	end
+
+	# Returns a normalized (length = 1.0) version of the vector.
+	def normalize
+		self.dup.normalize!
+	end
+
+	# In-place form of Vector2d.normalize.
+	def normalize!
+		self.length = 1.0
+		self
+	end
+
+	# Rounds coordinates to nearest integer.
+	def round
+		self.dup.round!
+	end
+
+	# In-place form of Vector2d.round.
+	def round!
+		@x, @y = @x.round, @y.round
+		self
+	end
+
+	# Returns the aspect ratio of the vector.
+	def aspect_ratio
+		(@x/@y).abs
+	end
+
+	# Multiply vectors. If args is a single Numeric, both axis will be multiplied.
+	def *(*vector_or_number)
+		v = Vector2d::new(vector_or_number)
+		Vector2d.new(@x*v.x, @y*v.y)
+	end
+
+	# Divide vectors. If args is a single Numeric, both axis will be divided.
+	def /(*vector_or_number)
+		v = Vector2d::new(vector_or_number)
+		Vector2d.new(@x/v.x, @y/v.y)
+	end
+
+	# Add vectors. If args is a single Numeric, it will be added to both axis.
+	def +(*vector_or_number)
+		v = Vector2d::new(vector_or_number)
+		Vector2d.new(@x+v.x, @y+v.y)
+	end
+
+	# Subtract vectors. If args is a single Numeric, it will be subtracted from both axis.
+	def -(*vector_or_number)
+		v = Vector2d::new(vector_or_number)
+		Vector2d.new(@x-v.x, @y-v.y)
+	end
+
+	# Constrain/expand so that both coordinates fit within (the square implied by) another vector.
+	# This is useful for resizing images to fit a certain size while keeping aspect ratio.
+	#
+	# == Examples
+	#
+	#   my_image = Vector2d.new("320x200")  # Creates a new vector object
+	#   my_image.constrain_both(100)        # Returns a new vector: x=100, y=63
+	#   my_image.constrain_both(150, 50)    # Returns a new vector: x=80, y=50
+	#   my_image.constrain_both("150x50")   # Equal to constrain_both( 150, 50 )
+	#   my_image.constrain_both("x100")     # Returns a new vector: x=160, y=100
+	#
+	# == Note
+	#
+	# Either axis will be disregarded if zero or nil (see the last example). This is a feature, not a bug. ;)
+	def constrain_both(*vector_or_number)
+		scale = Vector2d::new(vector_or_number) / self
+		(self * ((scale.y==0||(scale.x>0&&scale.x<scale.y)) ? scale.x : scale.y))
+	end
+
+	# Constrain/expand so that one of the coordinates fit within (the square implied by) another vector.
+	#
+	# == Example
+	#  
+	#   my_image = Vector2d.new("320x200")  # Creates a new vector object
+	#   my_image.constrain_one(100, 100)    # Returns a new vector: x=160, y=100
+	def constrain_one( *vector_or_number )
+		scale = Vector2d::new(vector_or_number) / self
+		if (scale.x > 0 && scale.y > 0)
+			scale = (scale.x<scale.y) ? scale.y : scale.x
+			self * scale
+		else
+			constrain_both(args)
+		end
+	end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'vector2d'
+
+class Test::Unit::TestCase
+end

data/test/vector2d_test.rb

@@ -0,0 +1,7 @@
+require 'test_helper'
+
+class Vector2dTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/vector2d.gemspec

@@ -0,0 +1,48 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{vector2d}
+  s.version = "0.5.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Inge J\303\270rgensen"]
+  s.date = %q{2009-05-20}
+  s.email = %q{inge@elektronaut.no}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "lib/vector2d.rb",
+     "test/test_helper.rb",
+     "test/vector2d_test.rb",
+     "vector2d.gemspec"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/elektronaut/vector2d}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{vector2d}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Vector2d allows for easy handling of two-dimensionals coordinates and vectors}
+  s.test_files = [
+    "test/test_helper.rb",
+     "test/vector2d_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -1,46 +1,64 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.0
-specification_version: 1
 name: vector2d
 version: !ruby/object:Gem::Version 
-  version: 0.0.5
-date: 2006-12-10 00:00:00 +01:00
-summary: A simplistic class for handling two-dimensional vectors.
-require_paths: 
-- lib
-email: inge@elektronaut.no
-homepage: http://rubyforge.org/projects/vector2d/
-rubyforge_project: vector2d
-description: 
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: false
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 0.5.2
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - "Inge J\xC3\xB8rgensen"
-files: 
-- lib/vector2d.rb
-test_files: []
-
-rdoc_options: []
+autorequire: 
+bindir: bin
+cert_chain: []
 
-extra_rdoc_files: []
+date: 2009-05-20 00:00:00 +02:00
+default_executable: 
+dependencies: []
 
+description: 
+email: inge@elektronaut.no
 executables: []
 
 extensions: []
 
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/vector2d.rb
+- test/test_helper.rb
+- test/vector2d_test.rb
+- vector2d.gemspec
+has_rdoc: true
+homepage: http://github.com/elektronaut/vector2d
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: []
-
+rubyforge_project: vector2d
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Vector2d allows for easy handling of two-dimensionals coordinates and vectors
+test_files: 
+- test/test_helper.rb
+- test/vector2d_test.rb