:orphan:

Multiple Voices
===============

*Example script* (scamp): `examples/Notation & engraving/Special notations/voices.py <https://github.com/MarcTheSpark/scamp/blob/main/examples/Notation & engraving/Special notations/voices.py>`__

*Download:* :download:`voices.py <downloads/notation_engraving_special_notations_voices/voices.py>`

Demonstration of how to place notes in specific voices within a staff/part. Named voices keep notes together in the same voice, and numbered voices determine exactly which voice they go in. By default SCAMP allows up to four voices per staff, but this can easily become quite messy. Set `engraving_settings.max_voices_per_staff` to limit the number of voices per staff, placing overflow voices on separate staves.

*Topics:* :doc:`Notation & engraving › Special notations <notation_engraving>`

.. raw:: html

   <div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Notation%20%26%20engraving/Special%20notations/voices.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Notation%20%26%20engraving/Special%20notations/voices-2.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Notation%20%26%20engraving/Special%20notations/voices-3.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="margin:0.6em 0"><audio controls preload="none" src="../_static/media/Notation%20%26%20engraving/Special%20notations/voices.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

   s = Session()

   piano = s.new_part("piano")

   melody = (
       (0, 0.5), (3, 1/2 + 1/3), (2, 1/3), (5, 1/3), (3, 0.5), (None, 1.0), (5, 0.25), (6, 0.75), (7, 0.5)
   )


   def _do_melody(start_pitch, dilation_factor=1.0, properties=None):
       for interval, dur in melody:
           piano.play_note(start_pitch + interval if interval is not None else None,
                           0.7,
                           dur * dilation_factor,
                           properties)


   def fork_melody(start_pitch, dilation_factor=1.0, properties=None):
       fork(_do_melody, args=(start_pitch, dilation_factor, properties))


   s.start_transcribing()

   fork_melody(70, properties="voice: A")
   wait(2)
   fork_melody(85, 2, properties="voice: B")
   wait(4)
   fork_melody(67, properties="voice: C")
   wait(2)
   fork_melody(59, 0.5, properties="voice: 4")
   wait_for_children_to_finish()

   perf = s.stop_transcribing()

   # default: allow up to 4 voices per staff, so all four fit on one staff
   perf.to_score().show()

   # cap at 2 voices per staff, so the overflow voices spill onto a second staff
   engraving_settings.max_voices_per_staff = 2
   perf.to_score().show()

   # cap at 1 voice per staff, so every voice gets its own staff
   engraving_settings.max_voices_per_staff = 1
   perf.to_score().show()