Class: Vedeu::Geometry::Area

Inherits:
Object
  • Object
show all
Defined in:
lib/vedeu/geometry/area.rb

Overview

Define an area from dimensions or points.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(y:, yn:, x:, xn:) ⇒ Vedeu::Geometry::Area

Returns a new instance of Vedeu::Area.

Parameters:

  • y (Fixnum) —

    The starting row/line position.

  • yn (Fixnum) —

    The ending row/line position.

  • x (Fixnum) —

    The starting column/character position.

  • xn (Fixnum) —

    The ending column/character position.



78
79
80
81
82
83
 
# File 'lib/vedeu/geometry/area.rb', line 78

def initialize(y:, yn:, x:, xn:)
  @y  = y
  @yn = yn
  @x  = x
  @xn = xn
end

Instance Attribute Details

#x ⇒ Fixnum (readonly) Also known as: left

Returns the left coordinate (column/character start position) of the interface.

Returns:

  • (Fixnum) —

    Returns the left coordinate (column/character start position) of the interface.



24
25
26
 
# File 'lib/vedeu/geometry/area.rb', line 24

def x
  @x
end

#xn ⇒ Fixnum (readonly) Also known as: right

Returns the right coordinate (column/ character end position) of the interface.

Returns:

  • (Fixnum) —

    Returns the right coordinate (column/ character end position) of the interface.



30
31
32
 
# File 'lib/vedeu/geometry/area.rb', line 30

def xn
  @xn
end

#y ⇒ Fixnum (readonly) Also known as: top

Returns the top coordinate (row/line start position) of the interface.

Returns:

  • (Fixnum) —

    Returns the top coordinate (row/line start position) of the interface.



12
13
14
 
# File 'lib/vedeu/geometry/area.rb', line 12

def y
  @y
end

#yn ⇒ Fixnum (readonly) Also known as: bottom

Returns the bottom coordinate (row/line end position) of the interface.

Returns:

  • (Fixnum) —

    Returns the bottom coordinate (row/line end position) of the interface.



18
19
20
 
# File 'lib/vedeu/geometry/area.rb', line 18

def yn
  @yn
end

Class Method Details

.from_attributes(attributes = {}) ⇒ Vedeu::Geometry::Area

Parameters:

  • attributes (Hash) (defaults to: {})

Options Hash (attributes):

  • y (Fixnum)
  • yn (Fixnum)
  • y_yn (Fixnum)
  • y_default (Fixnum)
  • x (Fixnum)
  • xn (Fixnum)
  • x_xn (Fixnum)
  • x_default (Fixnum)
  • maximised (Boolean)
  • centred (Boolean)
  • alignment (Symbol)

Returns:



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/vedeu/geometry/area.rb', line 46

def self.from_attributes(attributes = {})
  y_attributes = {
    d:         attributes[:y],
    dn:        attributes[:yn],
    d_dn:      attributes[:y_yn],
    default:   Vedeu.height,
    maximised: attributes[:maximised],
    centred:   attributes[:centred],
    # alignment: attributes[:alignment],
  }
  x_attributes = {
    d:         attributes[:x],
    dn:        attributes[:xn],
    d_dn:      attributes[:x_xn],
    default:   Vedeu.width,
    maximised: attributes[:maximised],
    centred:   attributes[:centred],
    alignment: attributes[:alignment],
  }
  y_yn = Vedeu::Geometry::Dimension.pair(y_attributes)
  x_xn = Vedeu::Geometry::Dimension.pair(x_attributes)

  new(y: y_yn[0], yn: y_yn[-1], x: x_xn[0], xn: x_xn[-1])
end

Instance Method Details

#centre ⇒ Array<Fixnum>

Returns an array containing the centred y and x coordinates of the interface.

Returns:

  • (Array<Fixnum>) 


99
100
101
 
# File 'lib/vedeu/geometry/area.rb', line 99

def centre
  [centre_y, centre_x]
end

#centre_x ⇒ Fixnum

Returns the centred x coordinate (the horizontal centre character) of the interface.

Returns:

  • (Fixnum) 


115
116
117
 
# File 'lib/vedeu/geometry/area.rb', line 115

def centre_x
  (width / 2) + x
end

#centre_y ⇒ Fixnum

Returns the centred y coordinate (the vertical centre row) of the interface.

Returns:

  • (Fixnum) 


107
108
109
 
# File 'lib/vedeu/geometry/area.rb', line 107

def centre_y
  (height / 2) + y
end

#east(offset = 1) ⇒ Fixnum

Returns the column after right by default.

Examples:

`right` or `xn` is 19.

east     # => 20
east(2)  # => 21 (positive goes 'more' east)
east(-4) # => 15 (negative goes west)

Parameters:

  • offset (Fixnum) (defaults to: 1)

Returns:

  • (Fixnum) 


159
160
161
 
# File 'lib/vedeu/geometry/area.rb', line 159

def east(offset = 1)
  xn + offset
end

#eql?(other) ⇒ Boolean Also known as: ==

An object is equal when its values are the same.

Parameters:

Returns:

  • (Boolean) 


89
90
91
92
 
# File 'lib/vedeu/geometry/area.rb', line 89

def eql?(other)
  self.class == other.class && y == other.y && yn == other.yn &&
    x == other.x && xn == other.xn
end

#height ⇒ Fixnum

Returns the height of the interface.

Returns:

  • (Fixnum) 


122
123
124
 
# File 'lib/vedeu/geometry/area.rb', line 122

def height
  (y..yn).size
end

#north(offset = 1) ⇒ Fixnum

Returns the row above the top by default.

Examples:

`top` or `y` is 4.

north     # => 3
north(2)  # => 2 (positive goes 'more' north)
north(-4) # => 8 (negative goes south)

Parameters:

  • offset (Fixnum) (defaults to: 1)

Returns:

  • (Fixnum) 


144
145
146
 
# File 'lib/vedeu/geometry/area.rb', line 144

def north(offset = 1)
  y - offset
end

#south(offset = 1) ⇒ Fixnum

Returns the row below the bottom by default.

Examples:

`bottom` or `yn` is 12.

south     # => 13
south(2)  # => 14 (positive goes 'more' south)
south(-4) # => 8  (negative goes north)

Parameters:

  • offset (Fixnum) (defaults to: 1)

Returns:

  • (Fixnum) 


174
175
176
 
# File 'lib/vedeu/geometry/area.rb', line 174

def south(offset = 1)
  yn + offset
end

#west(offset = 1) ⇒ Fixnum

Returns the column before left by default.

Examples:

`left` or `x` is 8.

west      # => 7
west(2)   # => 6  (positive goes 'more' west)
west(-4)  # => 12 (negative goes east)

Parameters:

  • offset (Fixnum) (defaults to: 1)

Returns:

  • (Fixnum) 


189
190
191
 
# File 'lib/vedeu/geometry/area.rb', line 189

def west(offset = 1)
  x - offset
end

#width ⇒ Fixnum

Returns the width of the interface.

Returns:

  • (Fixnum) 


129
130
131
 
# File 'lib/vedeu/geometry/area.rb', line 129

def width
  (x..xn).size
end