head_music 8.3.0 → 11.0.0

data/lib/head_music/locales/de.yml

@@ -1,5 +1,11 @@
 de:
   head_music:
+    alterations:
+      sharp: Kreuz
+      flat: Be
+      natural: Auflösungszeichen
+      double_sharp: Doppelkreuz
+      double_flat: Doppel-Be
     chromatic_intervals:
       perfect_unison: reine Prime
       minor_second: kleine Sekunde
@@ -153,6 +159,8 @@ de:
       descant: Diskant
       didgeridoo: Didgeridoo
       double_bass: Kontrabass
+      drum_kit: Schlagzeug
+      floor_tom: Floor-Tom
       double_contrabass_recorder: Doppelkontrabassblockflöte
       english_horn: Englischhorn
       euphonium: Euphonium
@@ -173,6 +181,7 @@ de:
       harpsichord: Cembalo
       hautbois_d_amour: Liebeshoboe
       hi-hat: Hi-Hat
+      high_tom: High-Tom
       horn: Horn
       kettledrum: Pauke
       kick_drum: Große Trommel
@@ -184,6 +193,7 @@ de:
       mezzo: Mezzo
       mezzo_soprano: Mezzosopran
       mezzo_soprano_voice: Mezzosopran
+      mid_tom: Mid-Tom
       military_drum: Militärtrommel
       mouth_organ: Mundharmonika
       natural_horn: Waldhorn
@@ -272,6 +282,25 @@ de:
       woodblock: Holzblock
       xylophone: Xylophon
       zither: Zither
+    instrument_families:
+      drum_kit: Schlagzeug
+      hi_hat: Hi-Hat
+      tom_tom: Tom-Tom
+    playing_techniques:
+      bell: Glocke
+      bow: Bogen
+      brush: Bürste
+      choked: Erstickt
+      closed: Geschlossen
+      cross_stick: Querstöckchen
+      damped: Gedämpft
+      hand: Hand
+      let_ring: Ausklingen lassen
+      mallet: Schläger
+      open: Offen
+      pedal: Pedal
+      rim_shot: Rimshot
+      stick: Stick
     locales:
       de: Deutsch
       en: Englisch

data/lib/head_music/locales/en.yml

@@ -1,5 +1,11 @@
 en:
   head_music:
+    alterations:
+      sharp: sharp
+      flat: flat
+      natural: natural
+      double_sharp: double sharp
+      double_flat: double flat
     chromatic_intervals:
       perfect_unison: perfect unison
       minor_second: minor second
@@ -270,6 +276,7 @@ en:
       cymbal: cymbal
       descant: descant
       didgeridoo: didgeridoo
+      drum_kit: drum kit
       double_bass: double bass
       double_contrabass_recorder: double-contrabass recorder
       electronic_keyboard: electronic keyboard
@@ -277,6 +284,7 @@ en:
       euphonium: euphonium
       fiddle: fiddle
       field_drum: field drum
+      floor_tom: floor tom
       flugelhorn: flugelhorn
       flute: flute
       fortepiano: fortepiano
@@ -293,6 +301,7 @@ en:
       harpsichord: harpsichord
       hautbois_d_amour: hautbois d'amour
       hi-hat: hi-hat
+      high_tom: high tom
       horn: horn
       kettledrum: kettledrum
       kick_drum: kick drum
@@ -304,6 +313,7 @@ en:
       mezzo: mezzo
       mezzo_soprano: mezzo-soprano
       mezzo_soprano_voice: mezzo-soprano
+      mid_tom: mid tom
       military_drum: military drum
       mouth_organ: mouth_organ
       natural_horn: natural horn
@@ -391,6 +401,102 @@ en:
       woodblock: woodblock
       xylophone: xylophone
       zither: zither
+    instrument_families:
+      drum_kit: drum kit
+      hi_hat: hi-hat
+      tom_tom: tom-tom
+    playing_techniques:
+      aeolian: aeolian
+      air: air
+      alla_chitarra: alla chitarra
+      arco: arco
+      artificial_harmonic: artificial harmonic
+      au_talon: au talon
+      barre: barré
+      bell: bell
+      bisbigliando: bisbigliando
+      bow: bow
+      brush: brush
+      bucket_mute: bucket mute
+      center: center
+      choked: choked
+      closed: closed
+      col_legno: col legno
+      col_legno_battuto: col legno battuto
+      col_legno_tratto: col legno tratto
+      con_bocca_chiusa: con bocca chiusa
+      con_sordino: con sordino
+      cross_stick: cross stick
+      cuivre: cuivré
+      cup_mute: cup mute
+      damped: damped
+      dead_stroke: dead stroke
+      detache: détaché
+      edge: edge
+      flautando: flautando
+      flutter_tongue: flutter tongue
+      frullato: frullato
+      half_barre: half barré
+      hand: hand
+      harmonic: harmonic
+      jete: jeté
+      harmon_mute: harmon mute
+      harmon_mute_stem_in: harmon mute stem in
+      harmon_mute_stem_out: harmon mute stem out
+      key_clicks: key clicks
+      laissez_vibrer: laissez vibrer
+      left_hand: left hand
+      legato: legato
+      let_ring: let ring
+      mallet: mallet
+      marcato: marcato
+      martele: martelé
+      martellato: martellato
+      modo_ordinario: modo ordinario
+      motor_off: motor off
+      motor_on: motor on
+      muffled: muffled
+      multiphonic: multiphonic
+      natural_harmonic: natural harmonic
+      naturale: naturale
+      non_laissez_vibrer: non laissez vibrer
+      non_vibrato: non vibrato
+      open: open
+      open_percussion: open
+      ordinario: ordinario
+      half_pedal: half pedal
+      mano_destra: mano destra
+      mano_sinistra: mano sinistra
+      palm_mute: palm mute
+      pedal: pedal
+      pizzicato: pizzicato
+      plunger_mute: plunger mute
+      poco_vibrato: poco vibrato
+      punta_d_arco: punta d'arco
+      quarter_pedal: quarter pedal
+      pres_de_la_table: près de la table
+      right_hand: right hand
+      rim_shot: rim shot
+      saltando: saltando
+      senza_sordino: senza sordino
+      senza_vibrato: senza vibrato
+      slap_tongue: slap tongue
+      snares_off: snares off
+      snares_on: snares on
+      sopra: sopra
+      sostenuto_pedal: sostenuto pedal
+      sotto: sotto
+      spiccato: spiccato
+      stick: stick
+      stopped: stopped
+      straight_mute: straight mute
+      sul_ponticello: sul ponticello
+      sul_tasto: sul tasto
+      three_quarter_pedal: three quarter pedal
+      tre_corde: tre corde
+      una_corda: una corda
+      vibrato: vibrato
+      whistle_tone: whistle tone
     locales:
       de: German
       en: English

data/lib/head_music/locales/es.yml

@@ -1,5 +1,11 @@
 es:
   head_music:
+    alterations:
+      sharp: sostenido
+      flat: bemol
+      natural: becuadro
+      double_sharp: doble sostenido
+      double_flat: doble bemol
     chromatic_intervals:
       perfect_unison: unísono perfecto
       minor_second: segunda menor
@@ -149,6 +155,8 @@ es:
       descant: flauta dulce soprano
       didgeridoo: didgeridoo
       double_bass: contrabajo
+      drum_kit: batería
+      floor_tom: tom de piso
       double_contrabass_recorder: flauta dulce subcontrabajo
       english_horn: corno inglés
       euphonium: euphonium
@@ -170,6 +178,7 @@ es:
       harpsichord: clavecín
       hautbois_d_amour: oboe de amor
       hi-hat: charles
+      high_tom: tom agudo
       horn: corno
       kettledrum: timbal
       kick_drum: bombo
@@ -181,6 +190,7 @@ es:
       mezzo: mezzosoprano
       mezzo_soprano: mezzosoprano
       mezzo_soprano_voice: voz de mezzosoprano
+      mid_tom: tom grave
       military_drum: tambor militar
       mouth_organ: armónica
       natural_horn: trompa natural
@@ -269,6 +279,25 @@ es:
       woodblock: bloque de madera
       xylophone: xilofón
       zither: cítara
+    instrument_families:
+      drum_kit: batería
+      hi_hat: charles
+      tom_tom: tom-tom
+    playing_techniques:
+      bell: campana
+      bow: arco
+      brush: cepillo
+      choked: apagado
+      closed: cerrado
+      cross_stick: baqueta inversa
+      damped: amortiguado
+      hand: mano
+      let_ring: dejar sonar
+      mallet: baqueta
+      open: abierto
+      pedal: pedal
+      rim_shot: golpe de borde
+      stick: baqueta
     locales:
       de: alemán
       en: inglés

data/lib/head_music/locales/fr.yml

@@ -1,5 +1,11 @@
 fr:
   head_music:
+    alterations:
+      sharp: dièse
+      flat: bémol
+      natural: bécarre
+      double_sharp: double dièse
+      double_flat: double bémol
     chromatic_intervals:
       perfect_unison: unisson parfait
       minor_second: seconde mineure
@@ -156,6 +162,8 @@ fr:
       descant: dessus
       didgeridoo: didgeridoo
       double_bass: contrebasse
+      drum_kit: batterie
+      floor_tom: tom de sol
       double_contrabass_recorder: flûte à bec double-contrebasse
       english_horn: cor anglais
       euphonium: euphonium
@@ -177,6 +185,7 @@ fr:
       harpsichord: clavecin
       hautbois_d_amour: hautbois d'amour
       hi-hat: charleston
+      high_tom: tom aigu
       horn: cor
       kettledrum: timbale
       kick_drum: grosse caisse
@@ -188,6 +197,7 @@ fr:
       mezzo: mezzo
       mezzo_soprano: mezzo-soprano
       mezzo_soprano_voice: voix de mezzo-soprano
+      mid_tom: tom grave
       military_drum: tambour militaire
       mouth_organ: harmonica
       natural_horn: cor naturel
@@ -275,6 +285,25 @@ fr:
       woodblock: bloc de bois
       xylophone: xylophone
       zither: cithare
+    instrument_families:
+      drum_kit: batterie
+      hi_hat: charleston
+      tom_tom: tom-tom
+    playing_techniques:
+      bell: cloche
+      bow: archet
+      brush: brosse
+      choked: étouffé
+      closed: fermé
+      cross_stick: baguette croisée
+      damped: amorti
+      hand: main
+      let_ring: laisser résonner
+      mallet: maillet
+      open: ouvert
+      pedal: pédale
+      rim_shot: coup de bord
+      stick: baguette
     locales:
       de: allemand
       en: anglais

data/lib/head_music/locales/it.yml

@@ -1,5 +1,11 @@
 it:
   head_music:
+    alterations:
+      sharp: diesis
+      flat: bemolle
+      natural: bequadro
+      double_sharp: doppio diesis
+      double_flat: doppio bemolle
     chromatic_intervals:
       perfect_unison: unisono perfetto
       minor_second: seconda minore
@@ -151,6 +157,8 @@ it:
       descant: soprano
       didgeridoo: didgeridoo
       double_bass: contrabbasso
+      drum_kit: batteria
+      floor_tom: tom a terra
       double_contrabass_recorder: doppio flauto dolce contrabbasso
       english_horn: corno inglese
       euphonium: eufonio
@@ -172,6 +180,7 @@ it:
       harpsichord: clavicembalo
       hautbois_d_amour: oboe d'amore
       hi-hat: hi-hat
+      high_tom: tom acuto
       horn: corno
       kettledrum: timpano
       kick_drum: grancassa
@@ -183,6 +192,7 @@ it:
       metal_block: blocco metallico
       mezzo: mezzosoprano
       mezzo_soprano_voice: mezzosoprano
+      mid_tom: tom grave
       military_drum: tamburo militare
       mouth_organ: armonica a bocca
       natural_horn: corno naturale
@@ -268,6 +278,25 @@ it:
       woodblock: legnetto
       xylophone: xilofono
       zither: cetra da tavolo
+    instrument_families:
+      drum_kit: batteria
+      hi_hat: hi-hat
+      tom_tom: tom-tom
+    playing_techniques:
+      bell: campana
+      bow: arco
+      brush: spazzola
+      choked: soffocato
+      closed: chiuso
+      cross_stick: bacchetta incrociata
+      damped: smorzato
+      hand: mano
+      let_ring: lasciar vibrare
+      mallet: bacchetta
+      open: aperto
+      pedal: pedale
+      rim_shot: colpo di rimshot
+      stick: bacchetta
     locales:
       de: tedesco
       en: inglese

data/lib/head_music/locales/ru.yml

@@ -1,5 +1,11 @@
 ru:
   head_music:
+    alterations:
+      sharp: диез
+      flat: бемоль
+      natural: бекар
+      double_sharp: дубль-диез
+      double_flat: дубль-бемоль
     chromatic_intervals:
       perfect_unison: чистый унисон
       minor_second: малая секунда
@@ -97,6 +103,8 @@ ru:
       descant: дискант
       didgeridoo: диджериду
       double_bass: контрабас
+      drum_kit: барабанная установка
+      floor_tom: том для пола
       double_contrabass_recorder: двойная контрабасовая флейта
       english_horn: английский рожок
       euphonium: эуфониум
@@ -118,6 +126,7 @@ ru:
       harpsichord: клавесин
       hautbois_d_amour: гобой д'амур
       hi-hat: хай-хет
+      high_tom: том высокий
       horn: валторна
       kettledrum: тимпан
       kick_drum: бас-барабан
@@ -128,6 +137,7 @@ ru:
       mezzo: меццо
       mezzo_soprano: меццо-сопрано
       mezzo_soprano_voice: голос меццо-сопрано
+      mid_tom: том средний
       military_drum: военный барабан
       mouth_organ: губная гармоника
       natural_horn: натуральный рог
@@ -215,6 +225,25 @@ ru:
       woodblock: деревянный блок
       xylophone: ксилофон
       zither: цитра
+    instrument_families:
+      drum_kit: барабанная установка
+      hi_hat: хай-хет
+      tom_tom: том-том
+    playing_techniques:
+      bell: колокол
+      bow: смычок
+      brush: щётка
+      choked: задушенный
+      closed: закрытый
+      cross_stick: крест-стик
+      damped: приглушённый
+      hand: рука
+      let_ring: дать звучать
+      mallet: молоточек
+      open: открытый
+      pedal: педаль
+      rim_shot: удар по ободу
+      stick: палочка
     locales:
       de: Немецкий
       en: Английский

data/lib/head_music/{rudiment → notation}/musical_symbol.rb

@@ -1,8 +1,8 @@
-# A module for music rudiments
-module HeadMusic::Rudiment; end
+# A module for visual music notation
+module HeadMusic::Notation; end
 
 # A symbol is a mark or sign that signifies a particular rudiment of music
-class HeadMusic::Rudiment::MusicalSymbol
+class HeadMusic::Notation::MusicalSymbol
   attr_reader :ascii, :unicode, :html_entity
 
   def initialize(ascii: nil, unicode: nil, html_entity: nil)

data/lib/head_music/notation/staff_mapping.rb

@@ -0,0 +1,70 @@
+# A module for visual music notation
+module HeadMusic::Notation; end
+
+# Represents the mapping of an instrument (and optional playing technique) to a staff position
+#
+# @example Basic mapping
+#   mapping = StaffMapping.new({
+#     "staff_position" => 4,
+#     "instrument" => "snare_drum"
+#   })
+#   mapping.instrument.name    #=> "snare drum"
+#   mapping.position_index     #=> 4
+#
+# @example Mapping with playing technique
+#   mapping = StaffMapping.new({
+#     "staff_position" => -1,
+#     "instrument" => "hi_hat",
+#     "playing_technique" => "pedal"
+#   })
+#   mapping.playing_technique.name  #=> "pedal"
+class HeadMusic::Notation::StaffMapping
+  attr_reader :staff_position, :instrument_key, :playing_technique_key
+
+  # Initialize a new StaffMapping
+  #
+  # @param attributes [Hash] the mapping attributes
+  # @option attributes [Integer, String] "staff_position" the staff position index
+  # @option attributes [String] "instrument" the instrument key
+  # @option attributes [String] "playing_technique" optional playing technique key
+  def initialize(attributes)
+    @staff_position = HeadMusic::Notation::StaffPosition.new(attributes["staff_position"].to_i)
+    @instrument_key = attributes["instrument"]
+    @playing_technique_key = attributes["playing_technique"]
+  end
+
+  # Get the Instrument object
+  #
+  # @return [Instrument, nil] the instrument or nil if not found
+  def instrument
+    HeadMusic::Instruments::Instrument.get(instrument_key) if instrument_key
+  end
+
+  # Get the PlayingTechnique object
+  #
+  # @return [PlayingTechnique, nil] the playing technique or nil if not specified
+  def playing_technique
+    HeadMusic::Instruments::PlayingTechnique.get(playing_technique_key) if playing_technique_key
+  end
+
+  # Get the staff position index
+  #
+  # @return [Integer] the position index
+  def position_index
+    staff_position.index
+  end
+
+  # String representation of this mapping
+  #
+  # @return [String] human-readable description
+  # @example
+  #   mapping.to_s  #=> "snare drum at line 3"
+  #   mapping.to_s  #=> "hi hat (pedal) at Space 0"
+  def to_s
+    parts = []
+    parts << (instrument&.name || instrument_key) if instrument_key
+    parts << "(#{playing_technique})" if playing_technique_key
+    parts << "at #{staff_position}"
+    parts.compact.join(" ")
+  end
+end

data/lib/head_music/notation/staff_position.rb

@@ -0,0 +1,62 @@
+# A module for visual music notation
+module HeadMusic::Notation; end
+
+class HeadMusic::Notation::StaffPosition
+  attr_reader :index  # Integer, even = line, odd = space; bottom line = 0
+
+  NAMES = {
+    -2 => ["ledger line below staff"],
+    -1 => ["space below staff"],
+    0 => ["bottom line", "line 1"],
+    1 => ["bottom space", "space 1"],
+    2 => ["line 2"],
+    3 => ["space 2"],
+    4 => ["middle line", "line 3"],
+    5 => ["space 3"],
+    6 => ["line 4"],
+    7 => ["space 4"],
+    8 => ["top line", "line 5"],
+    9 => ["space above staff"],
+    10 => ["ledger line above staff"]
+  }.freeze
+
+  # Accepts a name (string or symbol) and returns the corresponding StaffPosition index (integer), or nil if not found
+  def self.name_to_index(name)
+    NAMES.each do |index, names|
+      if names.map { |n|
+        HeadMusic::Utilities::Case.to_snake_case(n)
+      }.include?(HeadMusic::Utilities::Case.to_snake_case(name))
+        return index
+      end
+    end
+    nil
+  end
+
+  def initialize(index)
+    @index = index
+  end
+
+  def line?
+    index.even?
+  end
+
+  def space?
+    index.odd?
+  end
+
+  def line_number
+    return nil unless line?
+    (index / 2) + 1
+  end
+
+  def space_number
+    return nil unless space?
+    ((index - 1) / 2) + 1
+  end
+
+  def to_s
+    return NAMES[index].first if NAMES.key?(index)
+
+    line? ? "line #{line_number}" : "space #{space_number}"
+  end
+end

data/lib/head_music/notation.rb

@@ -0,0 +1,7 @@
+# A module for visual music notation
+module HeadMusic::Notation; end
+
+# Load notation classes
+require "head_music/notation/musical_symbol"
+require "head_music/notation/staff_position"
+require "head_music/notation/staff_mapping"