Volume Envelope
===============

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

*Download:* :download:`17_volume_envelope.py <downloads/tutorial_17_volume_envelope/17_volume_envelope.py>`

Plots an envelope representing a forte-piano-crescendo dynamic, and then uses it to affect the dynamics of a note's playback. This example shows that an Envelope can be passed to the volume argument of "play_note", just like it can to the pitch argument. (The list short-hand also works, by the way.)

*Topics:* :doc:`Envelopes › As note parameters <envelopes>`

.. raw:: html

   <div style="margin:0.4em 0"><figure style="display:inline-block;vertical-align:top;margin:0.2em 0.4em"><img src="../_static/media/Tutorial/17_volume_envelope.plot.svg" alt="envelope plot" style="max-width:100%;height:auto;display:block"></figure></div>

.. raw:: html

   <div style="margin:0.6em 0"><audio controls preload="none" src="../_static/media/Tutorial/17_volume_envelope.mp3" style="width:100%;max-width:520px"></audio></div>

.. code-block:: python

   from scamp import *

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

   fp_cresc = Envelope(
       [0.8, 0.3, 1],
       [0.2, 3.8],
       curve_shapes=[2, 4]
   )

   # plot the dynamic curve
   fp_cresc.show_plot("fp cresc.")

   # play a note with the dynamic curve
   viola.play_note(48, fp_cresc, 4)