Class: Sevgi::Sundries::Tile

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/sevgi/sundries/tile.rb

Overview

Repeats a geometry element over a rectangular row and column layout.

Direct Known Subclasses

Grid

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(element, position: Geometry::Origin, nx: 1, ny: 1) ⇒ void

Creates a tile from a source geometry element.

Parameters:

  • element (Sevgi::Geometry::Element) —

    geometry element to repeat

  • position (Sevgi::Geometry::Point, Array<Numeric>) (defaults to: Geometry::Origin) —

    tile origin

  • nx (Integer) (defaults to: 1) —

    number of columns

  • ny (Integer) (defaults to: 1) —

    number of rows

Raises:

  • (Sevgi::ArgumentError) —

    when element is not a geometry element

  • (Sevgi::ArgumentError) —

    when nx or ny is not a positive integer

  • (Sevgi::ArgumentError) —

    when position is not a point or two-number array



28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/sevgi/sundries/tile.rb', line 28

def initialize(element, position: Geometry::Origin, nx: 1, ny: 1)
  ArgumentError.("Must be an Element object: #{element}") unless element.is_a?(Geometry::Element)
  ArgumentError.("Tile nx must be positive") unless nx.is_a?(::Integer) && nx.positive?
  ArgumentError.("Tile ny must be positive") unless ny.is_a?(::Integer) && ny.positive?

  @element = element
  @position = self.class.send(:position, position)

  @nx = nx
  @ny = ny
end

Instance Attribute Details

#element ⇒ Sevgi::Geometry::Element (readonly)

Returns source element repeated by the tile.

Returns:

  • (Sevgi::Geometry::Element) —

    source element repeated by the tile



17
18
19
 
# File 'lib/sevgi/sundries/tile.rb', line 17

def element
  @element
end

#nx ⇒ Integer (readonly)

Returns number of columns.

Returns:

  • (Integer) —

    number of columns



17
 
# File 'lib/sevgi/sundries/tile.rb', line 17

attr_reader :element, :position, :nx, :ny

#ny ⇒ Object (readonly)

Returns the value of attribute ny.



17
 
# File 'lib/sevgi/sundries/tile.rb', line 17

attr_reader :element, :position, :nx, :ny

#position ⇒ Sevgi::Geometry::Point (readonly)

Returns tile origin.

Returns:

  • (Sevgi::Geometry::Point) —

    tile origin



17
 
# File 'lib/sevgi/sundries/tile.rb', line 17

attr_reader :element, :position, :nx, :ny

Instance Method Details

#[](i) ⇒ Array<Sevgi::Geometry::Element>?

Returns a row by index.

Parameters:

  • i (Integer) —

    row index

Returns:

  • (Array<Sevgi::Geometry::Element>, nil) 


43
 
# File 'lib/sevgi/sundries/tile.rb', line 43

def [](i) = rows[i]

#box ⇒ Sevgi::Geometry::Rect

Returns the bounding rectangle of the whole tile.

Returns:

  • (Sevgi::Geometry::Rect) 


47
 
# File 'lib/sevgi/sundries/tile.rb', line 47

def box = @box ||= Geometry::Rect[nx * element.box.width, ny * element.box.height, position:]

#cell ⇒ Sevgi::Geometry::Element

Returns the first cell in the tile.

Returns:

  • (Sevgi::Geometry::Element) 


51
 
# File 'lib/sevgi/sundries/tile.rb', line 51

def cell = row.first

#col(i = 0) ⇒ Array<Sevgi::Geometry::Element>?

Returns a column by index.

Parameters:

  • i (Integer) (defaults to: 0) —

    column index

Returns:

  • (Array<Sevgi::Geometry::Element>, nil) 


65
 
# File 'lib/sevgi/sundries/tile.rb', line 65

def col(i = 0) = cols[i]

#colbox(i = 0) ⇒ Sevgi::Geometry::Rect

Returns the bounding rectangle of a column.

Parameters:

  • i (Integer) (defaults to: 0) —

    column index

Returns:

  • (Sevgi::Geometry::Rect) 


56
 
# File 'lib/sevgi/sundries/tile.rb', line 56

def colbox(i = 0) = Geometry::Rect[element.box.width, box.height, position: coordinate(0, i)]

#cols ⇒ Array<Array<Sevgi::Geometry::Element>>

Returns cells grouped by column.

Returns:

  • (Array<Array<Sevgi::Geometry::Element>>) 


60
 
# File 'lib/sevgi/sundries/tile.rb', line 60

def cols = @cols ||= rows.transpose

#each {|row| ... } ⇒ Enumerator, Array<Array<Sevgi::Geometry::Element>> Also known as: each_row

Iterates over rows.

Yields:

  • (row) —

    each row

Yield Parameters:

  • row (Array<Sevgi::Geometry::Element>) —

    row cells

Yield Returns:

  • (void)

Returns:

  • (Enumerator, Array<Array<Sevgi::Geometry::Element>>) —

    enumerator without a block, otherwise rows



72
 
# File 'lib/sevgi/sundries/tile.rb', line 72

def each(...) = rows.each(...)

#each_col {|column| ... } ⇒ Enumerator, Array<Array<Sevgi::Geometry::Element>>

Iterates over columns.

Yields:

  • (column) —

    each column

Yield Parameters:

  • column (Array<Sevgi::Geometry::Element>) —

    column cells

Yield Returns:

  • (void)

Returns:

  • (Enumerator, Array<Array<Sevgi::Geometry::Element>>) —

    enumerator without a block, otherwise columns



79
 
# File 'lib/sevgi/sundries/tile.rb', line 79

def each_col(...) = cols.each(...)

#row(i = 0) ⇒ Array<Sevgi::Geometry::Element>?

Returns a row by index.

Parameters:

  • i (Integer) (defaults to: 0) —

    row index

Returns:

  • (Array<Sevgi::Geometry::Element>, nil) 


84
 
# File 'lib/sevgi/sundries/tile.rb', line 84

def row(i = 0) = rows[i]

#rowbox(i = 0) ⇒ Sevgi::Geometry::Rect

Returns the bounding rectangle of a row.

Parameters:

  • i (Integer) (defaults to: 0) —

    row index

Returns:

  • (Sevgi::Geometry::Rect) 


89
 
# File 'lib/sevgi/sundries/tile.rb', line 89

def rowbox(i = 0) = Geometry::Rect[box.width, element.box.height, position: coordinate(i)]

#rows ⇒ Array<Array<Sevgi::Geometry::Element>>

Returns cells grouped by row.

Returns:

  • (Array<Array<Sevgi::Geometry::Element>>) 


93
 
# File 'lib/sevgi/sundries/tile.rb', line 93

def rows = @rows ||= (0...ny).map { |i| (0...nx).map { |j| element.at(coordinate(i, j)) } }