Generating Notation
===================

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

*Download:* :download:`06_notation.py <downloads/tutorial_06_notation/06_notation.py>`

Plays a simple C Major arpeggio, and generates notation for it.

*Topics:* :doc:`Notation & engraving › Basics <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/06_notation.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/06_notation.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

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

   # begin transcribing (defaults to transcribing all instruments within the session)
   s.start_transcribing()

   # play an arpeggio
   for pitch in [60, 64, 67, 72]:
       violin.play_note(pitch, 1, 0.5)

   # stop the transcription and save the recorded note events as a Performance
   # a Performance is essentially a note event list representing exactly
   # when and how notes were played back, in continuous time
   performance = s.stop_transcribing()
   # quantize and convert the performance to a Score object and
   # open it as a PDF (by default this is done via abjad)
   performance.to_score().show()

   exit()  # the other options below will not be run unless you comment out this line

   # -------------------------------------------- MusicXML Notation ----------------------------------------------

   # If instead you want the notation created in MusicXML format
   # and opened up in MuseScore, Sibelius, or Finale, run this command:
   performance.to_score().show_xml()
   # Note that by default, SCAMP tries to find an appropriate application to open MusicXML files when it is first run
   # If you want to change which application SCAMP uses (e.g. to Sibelius), run the following command
   engraving_settings.set_show_music_xml_application("Sibelius")
   # ... and then run this command so that SCAMP remembers the setting
   engraving_settings.make_persistent()

   # ----------------------------------------- Export Rather Than Show -------------------------------------------

   # if, instead of opening up the notation, you merely want to save it to a file, you can run one of the following:
   performance.to_score().export_lilypond("NotationExample.ly")
   performance.to_score().export_music_xml("NotationExample.xml")

   # -------------------------------------- Printing MusicXML / LilyPond -----------------------------------------

   # if you just want to print the LilyPond or MusicXML markup, you can instead run:
   performance.to_score().print_lilypond()
   performance.to_score().print_music_xml()