Notation & engraving
====================


Basics
------

- :doc:`Generating Notation <tutorial_06_notation>` — Plays a simple C Major arpeggio, and generates notation for it.
- :doc:`Time Signatures <tutorial_07_time_signature>` — 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
- :doc:`Export to MIDI File <notation_engraving_basics_record_and_export_midi>` — Records glissandi with microtonal pitches and playback params (fast-forwarded), then exports the performance as a MIDI file.


Quantization
------------

- :doc:`Quantization of Random Floating-Point Durations <tutorial_08_random_quantized>` — Similar to the "Random Durations and Rests" example, except that now we generate notation.
- :doc:`Simplified Quantization <tutorial_09_simplified_quantization>` — Same as last example except that we see two different levers for simplifying the notation: `max_divisor` (which defaults to 8) sets a hard cap on how finely we can divide the beat.
- :doc:`Quantization Comparison <notation_engraving_quantization_quantization>` — Records a loose piano improvisation against a metronome, then plays back the quantized version.
- :doc:`Piano Phase <composition_form_larger_scale_form_reich_piano_phase>` — Steve Reich's Piano Phase: the same figure forked at 100 vs.


Special notations
-----------------

- :doc:`Note Properties <tutorial_20_note_properties>` — Shows how the fourth (optional) properties argument to "play_note" can be used to affect other aspects of playback and notation, such as articulation and noteheads.
- :doc:`Staff Text <tutorial_22_staff_text>` — Demonstrates various ways of adding text annotations to notes that are played.
- :doc:`Special Notations <tutorial_23_special_notations>` — Ornaments, tremolo and other single-note notations.
- :doc:`Spanners <tutorial_29_spanners>` — Demonstration of starting and stopping various spanners, such as slurs, hairpins, trills, brackets, and pedal lines.
- :doc:`Multiple Voices <notation_engraving_special_notations_voices>` — Demonstration of how to place notes in specific voices within a staff/part.
- :doc:`Multiple Voices with Octave Lines <notation_engraving_special_notations_voices_with_octave_lines>` — Same as the voices example, but with ottava applied to certain voices.
- :doc:`Microtonal Playback and Notation <tutorial_18_microtonal>` — Plays a few microtonal chords and notates them, turning on exact microtonal annotations.
- :doc:`Performance Post-Processing <notation_engraving_special_notations_post_processing>` — Post-processes a recorded Performance of a random walk of thirds and fifths, so that every time three consecutive notes are a triad, they are slurred together and spelled consistently.


Abjad & pymusicxml tweaks
-------------------------

- :doc:`Key Signature via pymusicxml <notation_engraving_abjad_pymusicxml_tweaks_key_sig>` — Adds a key signature by exporting through pymusicxml and setting it on the first measure.
- :doc:`Double Score <notation_engraving_abjad_pymusicxml_tweaks_double_score>` — Records two performances, turns them into scores, renders to abjad, and sticks them together!


From live input
---------------

- :doc:`Notating Computer Keyboard Input <notation_engraving_from_live_input_keyboard_input_with_notation>` — Same as Computer Keyboard Input, except that a metronome is playing back while the user plays notes with the keyboard, and the result is rendered as music notation.
- :doc:`Run as Server and Render Scores <notation_engraving_from_live_input_run_as_server_render_scores>` — Runs the session as a server, repeatedly recording short fragments and popping up a score for each.


Other
-----

- :doc:`Note Graph <notation_engraving_other_note_graph_example>` — Renders a saved Performance two ways: as graphic notation via PartNoteGraph (note height = pitch, width = volume, color = vibrato frequency), and as a traditional quantized score. *(needs scamp_extensions)*