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



34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/sevgi/sundries/tile.rb', line 34

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 the source geometry element.

Returns:

  • (Sevgi::Geometry::Element) 


11
12
13
 
# File 'lib/sevgi/sundries/tile.rb', line 11

def element
  @element
end

#nx ⇒ Integer (readonly)

Returns the number of columns.

Returns:

  • (Integer) 


19
20
21
 
# File 'lib/sevgi/sundries/tile.rb', line 19

def nx
  @nx
end

#ny ⇒ Integer (readonly)

Returns the number of rows.

Returns:

  • (Integer) 


23
24
25
 
# File 'lib/sevgi/sundries/tile.rb', line 23

def ny
  @ny
end

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

Returns the tile origin.

Returns:

  • (Sevgi::Geometry::Point) 


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

def position
  @position
end

Instance Method Details

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

Returns a row by index.

Parameters:

  • i (Integer) —

    row index

Returns:

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


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

def [](i) = rows[i]

#box ⇒ Sevgi::Geometry::Rect

Returns the bounding rectangle of the whole tile.

Returns:

  • (Sevgi::Geometry::Rect) 


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

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) 


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

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) 


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

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) 


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

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. The outer and nested collections are frozen and must be treated as immutable.

Returns:

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

    frozen columns



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

def cols = @cols ||= rows.transpose.map(&:freeze).freeze

#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



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

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



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

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) 


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

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) 


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

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. The outer and nested collections are frozen and must be treated as immutable.

Returns:

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

    frozen rows



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

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