`_
* **ly_staff_size**\ : staff size used by Lilypond. Defaults to ``14``.
* **load_ekmelily**\ : whether the *ekmelily* system should be loaded for microtonal notation (\ ``yes``\ ) or not (\ ``no``\ ). Defaults to ``yes``.
It is also possible to assign keys to values obtained by a shell command. The syntax for this is ``key = $cmd``, where ``cmd`` is the command yielding the desired value. For instance, to assign the keyword ``pdf_viewer`` to the address of the evince PDF viewer, one can write:
.. code-block::
pdf_viewer = $which evince
----
Metadata examples
=================
*\ ``from lento import *`` applies to all of the code snippets and will be omitted in the following.*
.. raw:: html
timesig:
The following metadata:
.. raw:: html
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"timesig": {
(1, 12): (3, 8),
(4, 7): [2, 32],
17: (5, 4),
(19, 20): (1, 8)
}}))
will be processed in the following way:
#. beat 0 (\ **4/4**\ , default time signature) to beat 1 results in a **1/4**
#. beat 1 (\ **3/8**\ ) to beat 4 results in a **3/8**
#. beat 4 (\ **2/32**\ ) to beat 7 results in one **2/32** and a remainder of **1/32**
#. beat 7 resets to **3/8** till beat 12, resulting in one **3/8** and a remainder of **2/8**
#. beat 12 resets to **4/4** (default time signature) till beat 17, resulting in one **4/4** and a remainder of **1/4**
#. from beat 17 on **5/4**
and produce:
.. image:: timesig_out.jpg
:target: timesig_out.jpg
:alt: timesig_out
----
.. raw:: html
clef:
.. raw:: html
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"clef": {
(0.5, 8+1/3): "alto",
(4, 6): "tenor",
8+2/3: "treble+9",
13.5: "treble-8",
16: "soprano"
}}))
.. image:: clef_out.jpg
:target: clef_out.jpg
:alt: clef_out
----
.. raw:: html
notehead:
The following metadata:
.. raw:: html
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"notehead": {
(.5, 8+1/3): "mensural",
(4, 6): "harmonic",
8+2/3: "cross",
13.5: "triangle",
16: "xcircle"
}}))
will be processed in the following way:
#. nearest existing note to the beat 0.5 is on beat 0 (0.5 will be rounded downwards), from beat 0 to beat 4 are ``"mensural"``
#. from beat 4 to 6 are ``"harmonic"``
#. nearest existing note to the beat 8.333333333333334 is on beat 8, from beat 6 to beat 8 are set back to ``"mensural"``
#. nearest existing note to the beat 8.666666666666666 is on beat 9, beat 8 to beat 9 is set back to ``"default"``
#. nearest existing note to the beat 13.5 is on beat 13 (again 0.5 will be rounded downwards), from beat 9 to beat 13 are ``"cross"``
#. from beat 13 to beat 16 are ``"triangle"``
#. from beat 16 onwards are ``"xcircle"``
and produce:
.. image:: notehead_out.jpg
:target: notehead_out.jpg
:alt: notehead_out
----
.. raw:: html
barline:
.. raw:: html
def merge_dicts(d1, *ds):
"""merge two or more dictionaries"""
for d in ds:
d1.update(d)
return d1
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"barline": merge_dicts(
# make the default barlines invisible
{beat: "" for beat in range(3, 24, 4)},
# set new barlines after each third beat
{beat: "!" for beat in range(2, 24, 3)},
# and a closing barline at the end
{23: "|."}
)}))
.. image:: barline_out.jpg
:target: barline_out.jpg
:alt: barline_out
.. raw:: html
lento(Part({"notes":[range(48, 84)] * 3,
"beats": [range(36)] * 3},
{"staff": {"n": 3, "bind": "grand"},
"barline": {
# define new barlines and use them
0: {n * 4 - 1: "= => = _ _" for n in range(1, 10)},
1: {n * 4 - 1: "] => ] _ _" for n in range(1, 10)},
2: {n * 4 - 1: "[ => [ _ _" for n in range(1, 10)}
}}))
.. image:: barline_define_out.jpg
:target: barline_define_out.jpg
:alt: barline_define_out
----
.. raw:: html
dynamic:
.. raw:: html
lento(Part({"notes": range(60, 72),
"beats": [n * .5 for n in range(12)]},
{"dynamic": {(0, 5.5): "<"}}))
.. image:: dynamic_out_1.jpg
:target: dynamic_out_1.jpg
:alt: dynamic_out_1
.. raw:: html
def merge_dicts(d1, d2):
"""merge two dictionaries"""
d1.update(d2)
return d1
lento(Part(events={"notes": [range(60, 72), range(72, 60, -1)] * 5,
"beats": [range(12)] * 10},
metadata={"staff": {"n": 10, "bind": "grand"},
"dynamic": merge_dicts(
{v: {3: "p", 7: "sf", (0, 11): ">"}
for v in range(0, 10, 2)},
{v: {2: "sf", (0, 11): "<"}
for v in range(1, 10, 2)})
}))
.. image:: dynamic_out_2.jpg
:target: dynamic_out_2.jpg
:alt: dynamic_out_2
.. raw:: html
lento(Part({"notes": range(60, 72),
"beats": range(12)},
{"dynamic": {(0, 11): "<",
(4, 8): ">",
6: "ppp"}}))
.. image:: dynamic_out_3.jpg
:target: dynamic_out_3.jpg
:alt: dynamic_out_3
.. code-block::
def merge_dicts(d1, *ds):
"""merge two or more dictionaries"""
for d in ds:
d1.update(d)
return d1
lento(Part(events={"notes": range(60, 72),
"beats": range(12)},
metadata={"dynamic": merge_dicts(
# define some new absolute dynamics
{0: "starf => * Drfz *"},
{1: "roundp => ( Dp )"},
# now they can be accessed just as any other dynamics
{beat: "starf" for beat in range(2, 12, 2)},
{beat: "roundp" for beat in range(3, 12, 2)}
)}))
.. image:: dynamic_out_4.jpg
:target: dynamic_out_4.jpg
:alt: dynamic_out_4
.. code-block::
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"dynamic": {
(0, 6): "<",
(2, 5.1): ">",
5.5: "sf",
4: "mp",
(6.5, 23): "dim",
(10+2/3, 15.5): "cr",
13+3/7: "p",
23: "rfz"
}}))
.. image:: dynamic_out.jpg
:target: dynamic_out.jpg
:alt: dynamic_out
---------------
Legato Examples
===============
:raw-html-m2r:`legato:
`
.. code-block::
lento(Part(events={"notes": range(60, 84),
"beats": range(24)},
metadata={"legato": {
"solid": ((1, 15.5),
(3+1/3, 5),
(5, 7)),
"halfdashed": [(7, 12.5),
(12.5, 17)],
"dotted": ((8, 9),
(16, 23))
}}))
- - -
articulation:
lento(Part(events={"notes": range(60, 72),
"beats": range(12)},
metadata={"articulation": {
3: (">", "."),
(1, 7): "staccatissimo",
(4, 6): ["prall", "^", "trill", "turn"],
10.5: ("fermata", "trill"),
11: "<>"
}}))
.. image:: articulation_out.jpg
:target: articulation_out.jpg
:alt: articulation_out