Class: Geometry::Square

Inherits:
Object
  • Object
show all
Includes:
ClusterFactory
Defined in:
lib/geometry/square.rb

Overview

The Square class cluster is like the Rectangle class cluster, but not longer in one direction.

Constructors

Square.new from:[1,2], to:[2,3]	# Using two corners
Square.new origin:[3,4], size:5	# Using an origin point and a size
Square.new center:[5,5], size:5	# Using a center point and a size
Square.new size:5			# Centered on the origin

Direct Known Subclasses

CenteredSquare, SizedSquare

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ClusterFactory

included

Constructor Details

#initialize(options = {}) ⇒ Square

Creates a Geometry::Square given two Points

Parameters:

  • options (Hash) (defaults to: {}) —

    a customizable set of options

Options Hash (options):

  • :from (Point) —

    A corner (ie. bottom-left)

  • :to (Point) —

    The other corner (ie. top-right)

  • :origin (Point) —

    The lower left corner

Raises:

  • (ArgumentError) 


57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/geometry/square.rb', line 57

def initialize(options={})
    origin = options[:from] || options[:origin]
    origin = origin ? Point[origin] : PointZero.new

    if options.has_key? :to
	point1 = options[:to]
    end

    point1 = Point[point1]
    raise(ArgumentError, "Point sizes must match (#{origin.size} != #{point1.size})") unless origin.is_a?(PointZero) || (origin.size == point1.size)

    # Reorder the points to get lower-left and upper-right
    minx, maxx = [origin.x, point1.x].minmax
    miny, maxy = [origin.y, point1.y].minmax
    @points = [Point[minx, miny], Point[maxx, maxy]]

    raise(NotSquareError) if height != width
end

Instance Attribute Details

#closed? ⇒ Boolean

Returns:

  • (Boolean) 


79
80
81
 
# File 'lib/geometry/square.rb', line 79

def closed?
    true
end

#edges ⇒ Object (readonly) 



85
86
87
 
# File 'lib/geometry/square.rb', line 85

def edges
    (points + [points.first]).each_cons(2).map {|v1,v2| Edge.new v1, v2}
end

#origin ⇒ Point

Returns The lower left corner.

Returns:

  • (Point) —

    The lower left corner



21
22
23
 
# File 'lib/geometry/square.rb', line 21

def origin
  @origin
end

#points ⇒ Object

Returns the value of attribute points.



25
26
27
 
# File 'lib/geometry/square.rb', line 25

def points
  @points
end

Class Method Details

.new(: origin, : size) ⇒ CenteredSquare

Creates a Geometry::Square with the given origin and size

Returns:



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/geometry/square.rb', line 33

def self.new(*args)
    options, args = args.partition {|a| a.is_a? Hash}
    options = options.reduce({}, :merge)

    if options.key?(:size)
	unless options[:size].is_a? Numeric
	    raise NotSquareError, 'Size must be a square' unless options[:size].all? {|a| a == options[:size].first}
	    options[:size] = options[:size].first
	end

	if options.key? :origin
	    SizedSquare.new(options[:origin], options[:size])
	else
	    CenteredSquare.new(options[:center] || PointZero.new, options[:size])
	end
    elsif options.key?(:from) and options.key?(:to)
	original_new(from: options[:from], to: options[:to])
    end
end

Instance Method Details

#height ⇒ Object 



115
116
117
118
 
# File 'lib/geometry/square.rb', line 115

def height
    min, max = @points.minmax {|a,b| a.y <=> b.y}
    max.y - min.y
end

#max ⇒ Point

Returns The upper right corner of the bounding Rectangle.

Returns:



90
91
92
 
# File 'lib/geometry/square.rb', line 90

def max
    @points.last
end

#min ⇒ Point

Returns The lower left corner of the bounding Rectangle.

Returns:



95
96
97
 
# File 'lib/geometry/square.rb', line 95

def min
    @points.first
end

#minmax ⇒ Array<Point>

Returns The lower left and upper right corners of the bounding Rectangle.

Returns:

  • (Array<Point>) —

    The lower left and upper right corners of the bounding Rectangle



100
101
102
 
# File 'lib/geometry/square.rb', line 100

def minmax
    [self.min, self.max]
end

#vertices ⇒ Object

Returns the value of attribute points.



26
27
28
 
# File 'lib/geometry/square.rb', line 26

def points
  @points
end

#width ⇒ Object 



120
121
122
123
 
# File 'lib/geometry/square.rb', line 120

def width
    min, max = @points.minmax {|a,b| a.x <=> b.x}
    max.x - min.x
end