Start and End Note
==================

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

*Download:* :download:`16_start_and_end_note.py <downloads/tutorial_16_start_and_end_note/16_start_and_end_note.py>`

Plays notes by calling start_note (or start_chord) and then manipulating them afterward, instead of defining the course of the note from the beginning with "play_note". The "start_note" and "start_chord" functions return handles that can be used to change the pitch, volume or other parameters of the note after they have started, as well as end the note.

*Topics:* :doc:`Playback › Note handles <playback>`

.. 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/16_start_and_end_note.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/16_start_and_end_note.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

   s = Session()

   violin = s.new_part("violin")

   s.start_transcribing()

   # start a violin note on middle C with volume 1. By default a started note is fully fixed (it plays at the given
   # velocity and can't change); pass fixed=False so we can gliss its pitch.
   note_handle1 = violin.start_note(60, 1.0, fixed=False)
   wait(1)
   # after 1 second, start a chord on Bb4 / D5 / F#5 with volume 1
   note_handle2 = violin.start_chord([70, 74, 78], 1.0, fixed=False)
   # change the pitch of the first note to F#3, glissing over the course of 2 seconds
   note_handle1.change_pitch(54, 2.0)
   wait(1)
   # one second later, start changing the pitch of the chord so that its first note (the Bb4) glisses up to E5
   # over the course of one second. The other notes of the chord will move in parallel to Ab5 and C6.
   note_handle2.change_pitch(76, 1.0)
   wait(2)
   # after 2 seconds, end the first note and start a fade out to volume 0 over the course of 2 seconds on the chord.
   note_handle1.end()
   note_handle2.change_volume(0, 2)
   # wait 2 seconds and then end the second chord
   wait(2)
   note_handle2.end()

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