Time Signatures
===============

*Example script* (scamp): `examples/Tutorial/07_time_signature.py <https://github.com/MarcTheSpark/scamp/blob/main/examples/Tutorial/07_time_signature.py>`__

*Download:* :download:`07_time_signature.py <downloads/tutorial_07_time_signature/07_time_signature.py>`

Plays a simple C Major arpeggio, and generates notation for it in three different ways: - with a 3/8 time signature - with a 3/8 time signature for the first measure followed by 2/4 - with alternating 3/8 and 2/4 time signatures - with a list of bar lengths determining time signatures

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

.. raw:: html

   <div style="font-weight:bold;margin:0.6em 0 0.2em">Specify one time signature throughout</div><div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Tutorial/07_time_signature.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="font-weight:bold;margin:0.6em 0 0.2em">Specify a list of time signatures by measure</div><div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Tutorial/07_time_signature-2.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="font-weight:bold;margin:0.6em 0 0.2em">Alternate time signatures</div><div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Tutorial/07_time_signature-3.svg" alt="score" style="max-width:100%;height:auto;display:block"></div>

.. raw:: html

   <div style="font-weight:bold;margin:0.6em 0 0.2em">Specify barline locations</div><div style="border:1px solid #ccc;padding:8px;margin:0.2em 0 0.6em;display:inline-block;max-width:100%"><img src="../_static/media/Tutorial/07_time_signature-4.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/Tutorial/07_time_signature.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

   s = Session()
   violin = s.new_part("Violin")

   # begin recording (defaults to transcribing
   # all instruments within the session)
   s.start_transcribing()
   for _ in range(4):
       for pitch in [60, 64, 67, 72]:
           violin.play_note(pitch, 1, 0.5)
           # stop the recording and save the recorded
           # note events as a performance

   performance = s.stop_transcribing()
   # quantize and convert the performance to a Score object and open it as a PDF,
   # this time imposing a time signature of 3/8
   performance.to_score(time_signature="3/8",
                        title="Specify one time signature throughout").show()

   # a list is interpreted as a (non-repeating) sequence of time signatures
   performance.to_score(time_signature=["3/8", "2/4"],
                        title="Specify a list of time signatures by measure").show()

   # if a repeating sequence of time signatures is desires, end the list with "loop"
   performance.to_score(time_signature=["3/8", "2/4", "loop"],
                        title="Alternate time signatures").show()

   # Alternatively, bar line locations can be given and sensible time signatures will be selected
   performance.to_score(bar_line_locations=[1.5, 3.5, 8],
                        title="Specify barline locations").show()