Class: HeadMusic::Position

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/head_music/content/position.rb

Overview

A position is a moment in time within the rhythmic framework of a composition.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(composition, code_or_bar, count = nil, tick = nil) ⇒ Position

Returns a new instance of Position.



11
12
13
14
15
16
17
18
 
# File 'lib/head_music/content/position.rb', line 11

def initialize(composition, code_or_bar, count = nil, tick = nil)
  if code_or_bar.is_a?(String) && code_or_bar =~ /\D/
    bar_number, count, tick = code_or_bar.split(/\D+/)
    ensure_state(composition, bar_number, count, tick)
  else
    ensure_state(composition, code_or_bar, count, tick)
  end
end

Instance Attribute Details

#bar_number ⇒ Object (readonly)

Returns the value of attribute bar_number.



7
8
9
 
# File 'lib/head_music/content/position.rb', line 7

def bar_number
  @bar_number
end

#composition ⇒ Object (readonly)

Returns the value of attribute composition.



7
8
9
 
# File 'lib/head_music/content/position.rb', line 7

def composition
  @composition
end

#count ⇒ Object (readonly)

Returns the value of attribute count.



7
8
9
 
# File 'lib/head_music/content/position.rb', line 7

def count
  @count
end

#tick ⇒ Object (readonly)

Returns the value of attribute tick.



7
8
9
 
# File 'lib/head_music/content/position.rb', line 7

def tick
  @tick
end

Instance Method Details

#+(other) ⇒ Object 



58
59
60
61
 
# File 'lib/head_music/content/position.rb', line 58

def +(other)
  other = HeadMusic::RhythmicValue.new(other) if [HeadMusic::RhythmicUnit, Symbol, String].include?(other.class)
  self.class.new(composition, bar_number, count, tick + other.ticks)
end

#<=>(other) ⇒ Object 



41
42
43
44
 
# File 'lib/head_music/content/position.rb', line 41

def <=>(other)
  other = self.class.new(composition, other) if other.is_a?(String) && other =~ /\D/
  values <=> other.values
end

#code ⇒ Object 



24
25
26
27
 
# File 'lib/head_music/content/position.rb', line 24

def code
  tick_string = tick.to_s.rjust(3, "0")
  [bar_number, count, tick_string].join(":")
end

#meter ⇒ Object 



20
21
22
 
# File 'lib/head_music/content/position.rb', line 20

def meter
  composition.meter_at(bar_number)
end

#start_of_next_bar ⇒ Object 



63
64
65
 
# File 'lib/head_music/content/position.rb', line 63

def start_of_next_bar
  self.class.new(composition, bar_number + 1, 1, 0)
end

#state ⇒ Object 



29
30
31
 
# File 'lib/head_music/content/position.rb', line 29

def state
  [composition.name, code].join(" ")
end

#strength ⇒ Object 



46
47
48
 
# File 'lib/head_music/content/position.rb', line 46

def strength
  meter.beat_strength(count, tick: tick)
end

#strong? ⇒ Boolean

Returns:

  • (Boolean) 


50
51
52
 
# File 'lib/head_music/content/position.rb', line 50

def strong?
  strength >= 80
end

#values ⇒ Object 



33
34
35
 
# File 'lib/head_music/content/position.rb', line 33

def values
  [bar_number, count, tick]
end

#weak? ⇒ Boolean

Returns:

  • (Boolean) 


54
55
56
 
# File 'lib/head_music/content/position.rb', line 54

def weak?
  !strong?
end

#within_placement?(placement) ⇒ Boolean

Returns:

  • (Boolean) 


37
38
39
 
# File 'lib/head_music/content/position.rb', line 37

def within_placement?(placement)
  placement.position <= self && placement.next_position > self
end