Microtonal Playback and Notation
================================

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

*Download:* :download:`18_microtonal.py <downloads/tutorial_18_microtonal/18_microtonal.py>`

Plays a few microtonal chords and notates them, turning on exact microtonal annotations.

*Topics:* :doc:`Pitch › Scales & microtonality <pitch>`, :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/Tutorial/18_microtonal.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/18_microtonal.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

   s = Session()
   piano = s.new_part("piano")

   s.start_transcribing()

   # this causes the true pitches to be written into the score by the notes, as midi pitch values.
   engraving_settings.show_microtonal_annotations = True
   # this can be used to control the max precision shown in the annotations (the default is 2 digits).
   # in this case, it doesn't really do anything, since the pitches are already rounded to 1 digit
   engraving_settings.microtonal_annotation_digits = 3

   # playing microtonal pitches is as simple as using floating-point values for pitch
   piano.play_chord([62.7, 71.3], 1.0, 1)
   piano.play_chord([65.2, 70.9], 1.0, 1)
   piano.play_chord([71.5, 74.3], 1.0, 1)

   s.stop_transcribing().to_score().show()