elektronaut-vector2d 0.5.1

data/History.txt

@@ -0,0 +1,14 @@
+== 0.5.1 2009-05-20
+
+* 1 minor enhancements:
+  * Cleaned up
+
+== 0.5.0 2007-08-29
+
+* 1 major enhancements:
+  * Included tests and documentation
+
+== 0.0.5 2006-12-10
+
+* 1 major enhancement:
+  * Initial release

data/MIT-LICENSE.txt

@@ -0,0 +1,22 @@
+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/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/lib/vector2d.rb

@@ -0,0 +1,155 @@
+$:.unshift File.dirname(__FILE__)
+
+# 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
+
+	VERSION_STRING = [0, 5, 1].join('.') #:nodoc:
+
+	# 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

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification 
+name: elektronaut-vector2d
+version: !ruby/object:Gem::Version 
+  version: 0.5.1
+platform: ruby
+authors: 
+- "Inge J\xC3\xB8rgensen"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-20 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Vector2d allows for easy handling of two-dimensionals coordinates and vectors.
+email: inge@melektronaut.no
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- History.txt
+- README.rdoc
+- MIT-LICENSE.txt
+- lib/vector2d.rb
+has_rdoc: true
+homepage: http://github.com/elektronaut/Vector2d
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --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: []
+
+rubyforge_project: vector2d
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Vector2d allows for easy handling of two-dimensionals coordinates and vectors.
+test_files: []
+