@kairotic/app 0.0.0-stage → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -2
- package/index.html +1101 -0
- package/kairotic/api.cljs +362 -0
- package/kairotic/assistant.cljs +505 -0
- package/kairotic/backends/gun-backend.js +371 -0
- package/kairotic/canvas.cljs +751 -0
- package/kairotic/code.cljs +108 -0
- package/kairotic/components.cljs +838 -0
- package/kairotic/core.cljs +96 -0
- package/kairotic/corefns.cljs +473 -0
- package/kairotic/docs.mjs +2 -0
- package/kairotic/engine.cljs +482 -0
- package/kairotic/examples.mjs +96 -0
- package/kairotic/faust.cljs +225 -0
- package/kairotic/help.cljs +1036 -0
- package/kairotic/hiccup.cljs +566 -0
- package/kairotic/input.cljs +271 -0
- package/kairotic/kfile.mjs +138 -0
- package/kairotic/library.cljs +214 -0
- package/kairotic/links.cljs +41 -0
- package/kairotic/mt.cljs +1604 -0
- package/kairotic/mtboxes.cljs +276 -0
- package/kairotic/packages/analysis.mjs +64 -0
- package/kairotic/packages/controls.mjs +28 -0
- package/kairotic/packages/data.mjs +22 -0
- package/kairotic/packages/faust-units/cmaes.mjs +82 -0
- package/kairotic/packages/faust-units/graph.mjs +212 -0
- package/kairotic/packages/faust-units/listen.mjs +125 -0
- package/kairotic/packages/faust-units/notation.mjs +139 -0
- package/kairotic/packages/faust-units/parse.mjs +439 -0
- package/kairotic/packages/faust-units/recipe.mjs +195 -0
- package/kairotic/packages/faust-units/render.mjs +69 -0
- package/kairotic/packages/faust-units/units.mjs +130 -0
- package/kairotic/packages/faust-units/view.mjs +353 -0
- package/kairotic/packages/faust-units.mjs +9 -0
- package/kairotic/packages/io.mjs +58 -0
- package/kairotic/packages/net.mjs +28 -0
- package/kairotic/packages/patterns.mjs +34 -0
- package/kairotic/packages/spatial.mjs +22 -0
- package/kairotic/packages/spectral/shift.mjs +169 -0
- package/kairotic/packages/spectral.mjs +16 -0
- package/kairotic/packages/synth.mjs +28 -0
- package/kairotic/packages/theory/counterpoint.mjs +798 -0
- package/kairotic/packages/theory/mirror.mjs +221 -0
- package/kairotic/packages/theory.mjs +46 -0
- package/kairotic/patterns.cljs +538 -0
- package/kairotic/presets.cljs +227 -0
- package/kairotic/quantize.cljs +782 -0
- package/kairotic/record.cljs +169 -0
- package/kairotic/release.cljs +90 -0
- package/kairotic/ring.cljs +129 -0
- package/kairotic/ringaudio.cljs +232 -0
- package/kairotic/ringcore.mjs +270 -0
- package/kairotic/score.cljs +176 -0
- package/kairotic/shapes.cljs +283 -0
- package/kairotic/signal.cljs +327 -0
- package/kairotic/sounds.cljs +565 -0
- package/kairotic/sounds.mjs +108 -0
- package/kairotic/span.cljs +129 -0
- package/kairotic/spell.cljs +281 -0
- package/kairotic/structure.cljs +145 -0
- package/kairotic/talk.cljs +115 -0
- package/kairotic/tempo.cljs +226 -0
- package/kairotic/treecanvas.cljs +299 -0
- package/kairotic/tutorials.mjs +1283 -0
- package/kairotic/vendor/codemirror.mjs +23 -0
- package/package.json +23 -4
- package/page/00-work.cljs +862 -0
- package/page/01-commands.cljs +1219 -0
- package/page/02-patch-view.cljs +1051 -0
- package/page/03-history-view.cljs +481 -0
- package/page/04-panels.cljs +448 -0
- package/page/05-gestures.cljs +1247 -0
- package/page/06-connection.cljs +219 -0
- package/page/07-claude.cljs +430 -0
- package/page/08-sessions.cljs +423 -0
- package/page/09-learn.cljs +602 -0
- package/page/10-embed.cljs +469 -0
- package/page/11-startup.cljs +61 -0
- package/page/12-feedback.cljs +172 -0
- package/page/13-perform.cljs +325 -0
- package/page/14-editor.cljs +656 -0
- package/page/15-presets.cljs +230 -0
- package/page/16-release.cljs +242 -0
- package/page/17-sounds.cljs +147 -0
- package/page/18-lines.cljs +594 -0
- package/page/19-files.cljs +247 -0
- package/page/19-html.cljs +152 -0
- package/page/20-talk.cljs +527 -0
- package/page/21-net.cljs +110 -0
- package/page/22-learn.cljs +303 -0
- package/page/23-ids.cljs +233 -0
- package/page/24-clipboard.cljs +136 -0
- package/page/25-tidy.cljs +74 -0
- package/page/26-probes.cljs +111 -0
- package/sources.mjs +2 -0
|
@@ -0,0 +1,1283 @@
|
|
|
1
|
+
// Generated by docs/tutorials/build.mjs — edit the .md files, not this.
|
|
2
|
+
export default {
|
|
3
|
+
"tutorials": [
|
|
4
|
+
{
|
|
5
|
+
"id": "patch-to-code",
|
|
6
|
+
"track": "patch-code",
|
|
7
|
+
"order": 1,
|
|
8
|
+
"title": {
|
|
9
|
+
"en": "From patch to code",
|
|
10
|
+
"es": "Del patch al código"
|
|
11
|
+
},
|
|
12
|
+
"steps": [
|
|
13
|
+
{
|
|
14
|
+
"title": {
|
|
15
|
+
"en": "Before starting",
|
|
16
|
+
"es": "Antes de empezar"
|
|
17
|
+
},
|
|
18
|
+
"note": {
|
|
19
|
+
"en": "Kairotic shows the same work in three ways at once: the **patch** (boxes and wires, on the left), its **code** (the Code tab, on the right) and its **history** (below), where every gesture is a point you can go back to.\n\nThis lesson builds a small instrument step by step. Each step is a point of the history: ◀ ▶ in this bar travel between them, and the REPL (at the bottom) shows, line by line, the gestures each step makes.\n\nPut on headphones or turn the volume down a little: there will be sound.",
|
|
20
|
+
"es": "Kairotic muestra la misma obra de tres maneras a la vez: el **patch** (cajas y cables, a la izquierda), su **código** (la pestaña Code, a la derecha) y su **historia** (abajo), donde cada gesto es un punto al que puedes volver.\n\nEsta lección construye un pequeño instrumento paso a paso. Cada paso es un punto de la historia: ◀ ▶ en esta barra viajan entre ellos, y la REPL (abajo del todo) muestra, línea a línea, los gestos que hace cada paso.\n\nPonte auriculares o baja un poco el volumen: habrá sonido."
|
|
21
|
+
},
|
|
22
|
+
"try": {
|
|
23
|
+
"en": "",
|
|
24
|
+
"es": ""
|
|
25
|
+
},
|
|
26
|
+
"code": []
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"title": {
|
|
30
|
+
"en": "A box",
|
|
31
|
+
"es": "Una caja"
|
|
32
|
+
},
|
|
33
|
+
"note": {
|
|
34
|
+
"en": "A box is a line of text. The first word is its **class** (what it is: `osc~`, a sine oscillator) and the rest are its **arguments** (here, 220 Hz). The ~ marks classes that work with sound signals.\n\nLook at the Code tab: the box is the line `(box :b1 \"osc~ 220\" 40 110)` — its id `:b1`, its text, and where it sits (x 40, y 110). The patch and the code are two views of the same thing.",
|
|
35
|
+
"es": "Una caja es una línea de texto. La primera palabra es su **clase** (lo que es: `osc~`, un oscilador sinusoidal) y el resto son sus **argumentos** (aquí, 220 Hz). La ~ marca las clases que trabajan con señales de sonido.\n\nMira la pestaña Code: la caja es la línea `(box :b1 \"osc~ 220\" 40 110)` — su id `:b1`, su texto y dónde está (x 40, y 110). El patch y el código son dos vistas de lo mismo."
|
|
36
|
+
},
|
|
37
|
+
"try": {
|
|
38
|
+
"en": "⌘/Ctrl+click the box: below it you can change its argument. Then look at the Code tab again.",
|
|
39
|
+
"es": "Haz ⌘/Ctrl+clic en la caja: debajo puedes cambiar su argumento. Luego vuelve a mirar la pestaña Code."
|
|
40
|
+
},
|
|
41
|
+
"code": [
|
|
42
|
+
"(box :b1 \"osc~ 220\" 40 110)"
|
|
43
|
+
]
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"title": {
|
|
47
|
+
"en": "Wires",
|
|
48
|
+
"es": "Cables"
|
|
49
|
+
},
|
|
50
|
+
"note": {
|
|
51
|
+
"en": "Alone, an oscillator is not heard. A `gain~` sets its level and `dac~` is the sound card: one inlet per channel, left and right.\n\nEach wire is a `connect`: from an **outlet** of a box to an **inlet** of another, both numbered from 0, left to right. `(connect :b2 0 :b3 1)` takes the left outlet of the gain~ to the right inlet of the dac~.\n\nPress ▶ (or the space bar) to start the engine.",
|
|
52
|
+
"es": "Solo, un oscilador no se oye. Un `gain~` fija su nivel y `dac~` es la tarjeta de sonido: una entrada por canal, izquierda y derecha.\n\nCada cable es un `connect`: de una **salida** de una caja a una **entrada** de otra, ambas numeradas desde 0, de izquierda a derecha. `(connect :b2 0 :b3 1)` lleva la salida izquierda del gain~ a la entrada derecha del dac~.\n\nPulsa ▶ (o la barra espaciadora) para poner en marcha el motor."
|
|
53
|
+
},
|
|
54
|
+
"try": {
|
|
55
|
+
"en": "Click a wire and press Delete: the right channel goes quiet. Draw it again from the outlet (the small mark at the bottom of the box) to the inlet.",
|
|
56
|
+
"es": "Haz clic en un cable y pulsa Supr: el canal derecho se calla. Vuelve a dibujarlo desde la salida (la pequeña marca abajo de la caja) hasta la entrada."
|
|
57
|
+
},
|
|
58
|
+
"code": [
|
|
59
|
+
"(box :b2 \"gain~ 0.2\" 40 170)",
|
|
60
|
+
"(box :b3 \"dac~\" 40 230)",
|
|
61
|
+
"(connect :b1 0 :b2 0)",
|
|
62
|
+
"(connect :b2 0 :b3 0)",
|
|
63
|
+
"(connect :b2 0 :b3 1)"
|
|
64
|
+
]
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"title": {
|
|
68
|
+
"en": "Messages that play",
|
|
69
|
+
"es": "Mensajes que tocan"
|
|
70
|
+
},
|
|
71
|
+
"note": {
|
|
72
|
+
"en": "A `number` box sends a number whenever it changes. Wired to the left inlet of the oscillator, it changes its frequency.\n\nThere are two kinds of wire: **messages** (numbers, lists, words, sent from time to time) and **signals** (sound, 48 000 values per second). A message into `osc~` sets its frequency; a signal into the same inlet *is* its frequency.",
|
|
73
|
+
"es": "Una caja `number` envía un número cada vez que cambia. Conectada a la entrada izquierda del oscilador, cambia su frecuencia.\n\nHay dos tipos de cable: **mensajes** (números, listas, palabras, enviados de vez en cuando) y **señales** (sonido, 48 000 valores por segundo). Un mensaje a `osc~` fija su frecuencia; una señal a esa misma entrada *es* su frecuencia."
|
|
74
|
+
},
|
|
75
|
+
"try": {
|
|
76
|
+
"en": "With the engine running, drag the number up and down (⇧ for finer steps).",
|
|
77
|
+
"es": "Con el motor en marcha, arrastra el número arriba y abajo (⇧ para pasos más finos)."
|
|
78
|
+
},
|
|
79
|
+
"code": [
|
|
80
|
+
"(box :b4 \"number 220\" 40 40)",
|
|
81
|
+
"(connect :b4 0 :b1 0)"
|
|
82
|
+
]
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"title": {
|
|
86
|
+
"en": "The REPL speaks the same language",
|
|
87
|
+
"es": "La REPL habla el mismo idioma"
|
|
88
|
+
},
|
|
89
|
+
"note": {
|
|
90
|
+
"en": "Everything you do with the mouse is written as one of these lines, and anything you type in the REPL becomes a gesture of the patch. Here, a `msg` box with a MIDI pitch (57, the A below middle C) goes through `mtof` (MIDI to frequency) into the oscillator: 220 Hz again.\n\nClick any `code` in these notes and it goes to the REPL, ready to run with Enter.",
|
|
91
|
+
"es": "Todo lo que haces con el ratón se escribe como una de estas líneas, y lo que escribes en la REPL se convierte en un gesto del patch. Aquí, una caja `msg` con una altura MIDI (57, el la por debajo del do central) pasa por `mtof` (de MIDI a frecuencia) hasta el oscilador: 220 Hz otra vez.\n\nHaz clic en cualquier `code` de estas notas y va a la REPL, lista para ejecutarse con Intro."
|
|
92
|
+
},
|
|
93
|
+
"try": {
|
|
94
|
+
"en": "Type `(box \"msg 64\" 260 20)` in the REPL and wire it to the mtof; click both messages with the engine running. Or click `(send! :b5 60)`.",
|
|
95
|
+
"es": "Escribe `(box \"msg 64\" 260 20)` en la REPL y conéctala al mtof; pulsa los dos mensajes con el motor en marcha. O haz clic en `(send! :b5 60)`."
|
|
96
|
+
},
|
|
97
|
+
"code": [
|
|
98
|
+
"(box :b5 \"msg 57\" 170 20)",
|
|
99
|
+
"(box :b6 \"mtof\" 170 60)",
|
|
100
|
+
"(connect :b5 0 :b6 0)",
|
|
101
|
+
"(connect :b6 0 :b1 0)"
|
|
102
|
+
]
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"title": {
|
|
106
|
+
"en": "From code to patch",
|
|
107
|
+
"es": "Del código al patch"
|
|
108
|
+
},
|
|
109
|
+
"note": {
|
|
110
|
+
"en": "Changing the text of a box is a gesture too: `(text! :b2 \"gain~ 0.1\")` is what the inspector writes when you change the argument of the gain~ below it.\n\nThe Code tab goes the other way: edit the code there and run it with Ctrl+Enter, and the whole patch is rebuilt from it (as one single event in the history).",
|
|
111
|
+
"es": "Cambiar el texto de una caja también es un gesto: `(text! :b2 \"gain~ 0.1\")` es lo que escribe el inspector cuando cambias el argumento del gain~ debajo de la caja.\n\nLa pestaña Code va en sentido contrario: edita allí el código y ejecútalo con Ctrl+Intro, y todo el patch se reconstruye a partir de él (como un único evento en la historia)."
|
|
112
|
+
},
|
|
113
|
+
"try": {
|
|
114
|
+
"en": "In the Code tab, change `osc~ 220` to `osc~ 330`, or move a box by changing its numbers, and press Ctrl+Enter.",
|
|
115
|
+
"es": "En la pestaña Code, cambia `osc~ 220` por `osc~ 330`, o mueve una caja cambiando sus números, y pulsa Ctrl+Intro."
|
|
116
|
+
},
|
|
117
|
+
"code": [
|
|
118
|
+
"(text! :b2 \"gain~ 0.1\")"
|
|
119
|
+
]
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"title": {
|
|
123
|
+
"en": "The history keeps everything",
|
|
124
|
+
"es": "La historia lo guarda todo"
|
|
125
|
+
},
|
|
126
|
+
"note": {
|
|
127
|
+
"en": "Every step of this lesson is a point in the history (the timeline below). Click any point, or use Ctrl+Z, to go back to that moment: the patch and its code are as they were then.\n\nIf you change something in the past, nothing is lost: a **branch** of your own is born from there, and the lesson stays on its line. ◀ ▶ in this bar take you back to it.",
|
|
128
|
+
"es": "Cada paso de esta lección es un punto de la historia (la línea de tiempo de abajo). Haz clic en cualquier punto, o usa Ctrl+Z, para volver a ese momento: el patch y su código están como estaban entonces.\n\nSi cambias algo en el pasado no se pierde nada: nace una **rama** tuya desde ahí, y la lección sigue en su línea. ◀ ▶ en esta barra te devuelven a ella."
|
|
129
|
+
},
|
|
130
|
+
"try": {
|
|
131
|
+
"en": "Go back to the step \"Wires\", add a second `osc~` to the gain~, and look at the new branch in the history. Then press ▶ here.",
|
|
132
|
+
"es": "Vuelve al paso «Cables», añade un segundo `osc~` al gain~ y mira la rama nueva en la historia. Luego pulsa ▶ aquí."
|
|
133
|
+
},
|
|
134
|
+
"code": []
|
|
135
|
+
},
|
|
136
|
+
{
|
|
137
|
+
"title": {
|
|
138
|
+
"en": "What next",
|
|
139
|
+
"es": "Y ahora"
|
|
140
|
+
},
|
|
141
|
+
"note": {
|
|
142
|
+
"en": "Select any box and press **?**: the Help tab tells what each inlet and outlet does, and most classes have a **help patch** that opens like this lesson.\n\nOther tutorials are in the Help tab. When you want to keep what you build, open Sessions and create a work of your own (solo) or a room to share it.",
|
|
143
|
+
"es": "Selecciona cualquier caja y pulsa **?**: la pestaña Help explica qué hace cada entrada y salida, y la mayoría de clases tiene un **patch de ayuda** que se abre como esta lección.\n\nHay más tutoriales en la pestaña Help. Cuando quieras guardar lo que construyes, abre Sessions y crea una obra tuya (solo) o una sala para compartirla."
|
|
144
|
+
},
|
|
145
|
+
"try": {
|
|
146
|
+
"en": "",
|
|
147
|
+
"es": ""
|
|
148
|
+
},
|
|
149
|
+
"code": []
|
|
150
|
+
}
|
|
151
|
+
]
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"id": "annotations",
|
|
155
|
+
"track": "patch-code",
|
|
156
|
+
"order": 2,
|
|
157
|
+
"title": {
|
|
158
|
+
"en": "Annotations and layers",
|
|
159
|
+
"es": "Anotaciones y capas"
|
|
160
|
+
},
|
|
161
|
+
"steps": [
|
|
162
|
+
{
|
|
163
|
+
"title": {
|
|
164
|
+
"en": "A patch to write on",
|
|
165
|
+
"es": "Un patch sobre el que escribir"
|
|
166
|
+
},
|
|
167
|
+
"note": {
|
|
168
|
+
"en": "A patch can carry its own notes: texts, lines and arrows drawn on **layers** over or under the boxes. They are part of the work like any box: each mark is one event of the history and a line of its code, and they travel in links and embeds.\n\nHere is a small patch to annotate: a number sets the frequency of an oscillator.",
|
|
169
|
+
"es": "Un patch puede llevar sus propias notas: textos, líneas y flechas dibujados en **capas** por encima o por debajo de las cajas. Forman parte de la obra como cualquier caja: cada marca es un evento de la historia y una línea de su código, y viajan en los enlaces y los embeds.\n\nAquí hay un patch pequeño para anotar: un número fija la frecuencia de un oscilador."
|
|
170
|
+
},
|
|
171
|
+
"try": {
|
|
172
|
+
"en": "",
|
|
173
|
+
"es": ""
|
|
174
|
+
},
|
|
175
|
+
"code": [
|
|
176
|
+
"(box :b1 \"number 220\" 60 60)",
|
|
177
|
+
"(box :b2 \"osc~ 220\" 60 130)",
|
|
178
|
+
"(box :b3 \"gain~ 0.2\" 60 190)",
|
|
179
|
+
"(box :b4 \"dac~\" 60 250)",
|
|
180
|
+
"(connect :b1 0 :b2 0)",
|
|
181
|
+
"(connect :b2 0 :b3 0)",
|
|
182
|
+
"(connect :b3 0 :b4 0)",
|
|
183
|
+
"(connect :b3 0 :b4 1)"
|
|
184
|
+
]
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"title": {
|
|
188
|
+
"en": "A text and an arrow",
|
|
189
|
+
"es": "Un texto y una flecha"
|
|
190
|
+
},
|
|
191
|
+
"note": {
|
|
192
|
+
"en": "`mark` draws on a layer (`:notes` here). Each point of a mark is **anchored**: to a box, as `[:b1 dx dy]` from its top-left corner, or to the paper, as `[:patch x y]`. A point anchored to a box follows it.\n\nWith the mouse: **Annotate** in the bar above the patch opens the tools (Draw, Arrow, Text, Move, Erase); each point drawn is anchored to the box nearest it.",
|
|
193
|
+
"es": "`mark` dibuja en una capa (aquí `:notes`). Cada punto de una marca está **anclado**: a una caja, como `[:b1 dx dy]` desde su esquina superior izquierda, o al papel, como `[:patch x y]`. Un punto anclado a una caja la sigue.\n\nCon el ratón: **Annotate** en la barra sobre el patch abre las herramientas (Draw, Arrow, Text, Move, Erase); cada punto dibujado se ancla a la caja más cercana."
|
|
194
|
+
},
|
|
195
|
+
"try": {
|
|
196
|
+
"en": "Drag the number box somewhere else: the arrow follows it, the text stays on the paper. Then try `(move-mark :a1 0 40)`.",
|
|
197
|
+
"es": "Arrastra la caja del número a otro sitio: la flecha la sigue, el texto se queda en el papel. Prueba después `(move-mark :a1 0 40)`."
|
|
198
|
+
},
|
|
199
|
+
"code": [
|
|
200
|
+
"(mark :notes :a1 {:kind :text :at [:patch 260 40] :txt \"drag up and down\"})",
|
|
201
|
+
"(mark :notes :a2 {:kind :arrow :pts [[:patch 255 46] [:b1 96 12]]})"
|
|
202
|
+
]
|
|
203
|
+
},
|
|
204
|
+
{
|
|
205
|
+
"title": {
|
|
206
|
+
"en": "Layers",
|
|
207
|
+
"es": "Capas"
|
|
208
|
+
},
|
|
209
|
+
"note": {
|
|
210
|
+
"en": "A layer goes **over** or **under** the boxes, and shows in the patch view, in the presentation, or both: `(layer :guide {:z :under :show #{:patch :present}})`. Marks under the boxes are good for regions and paths; marks over them, for notes.\n\n`(layer :guide nil)` removes a layer with its marks; `(unmark :a3)` erases one.",
|
|
211
|
+
"es": "Una capa va **por encima** o **por debajo** de las cajas, y se ve en la vista del patch, en la presentación o en ambas: `(layer :guide {:z :under :show #{:patch :present}})`. Las marcas bajo las cajas sirven para regiones y recorridos; las de encima, para notas.\n\n`(layer :guide nil)` quita una capa con sus marcas; `(unmark :a3)` borra una."
|
|
212
|
+
},
|
|
213
|
+
"try": {
|
|
214
|
+
"en": "Delete the gain~ box: the end of the line anchored to it stays on the paper, where it was.",
|
|
215
|
+
"es": "Borra la caja gain~: el extremo de la línea anclado a ella se queda en el papel, donde estaba."
|
|
216
|
+
},
|
|
217
|
+
"code": [
|
|
218
|
+
"(layer :guide {:z :under :show #{:patch :present}})",
|
|
219
|
+
"(mark :guide :a3 {:kind :line :pts [[:b1 -20 -14] [:b3 160 -14] [:b4 160 50]]})",
|
|
220
|
+
"(mark :guide :a4 {:kind :text :at [:b4 0 60] :txt \"the signal path\"})"
|
|
221
|
+
]
|
|
222
|
+
},
|
|
223
|
+
{
|
|
224
|
+
"title": {
|
|
225
|
+
"en": "Drawing from messages",
|
|
226
|
+
"es": "Dibujar con mensajes"
|
|
227
|
+
},
|
|
228
|
+
"note": {
|
|
229
|
+
"en": "Marks are written by you. A `draw` box draws what arrives to it: shapes as messages (`circle 60 55 22 accent hit sun`), or any shape of `kairotic.shapes` from code. A shape with `hit` is a part that can be pressed: it sends its name.\n\nSo a patch can draw its own score as it plays, or offer a performer a few things to touch.",
|
|
230
|
+
"es": "Las marcas las escribes tú. Una caja `draw` dibuja lo que le llega: figuras como mensajes (`circle 60 55 22 accent hit sun`), o cualquier figura de `kairotic.shapes` desde el código. Una figura con `hit` es una parte que se puede pulsar: envía su nombre.\n\nAsí un patch puede dibujar su propia partitura mientras suena, u ofrecer a quien toca unas pocas cosas que tocar."
|
|
231
|
+
},
|
|
232
|
+
"try": {
|
|
233
|
+
"en": "Click the two messages, then press the circles: print writes sun or moon. Connect the outlet of draw to a msg 330 and then to the number: a circle that changes the pitch.",
|
|
234
|
+
"es": "Haz clic en los dos mensajes y pulsa los círculos: print escribe sun o moon. Conecta la salida de draw a un msg 330 y este al número: un círculo que cambia la altura."
|
|
235
|
+
},
|
|
236
|
+
"code": [
|
|
237
|
+
"(box :b5 \"msg :circle 60 55 22 :accent :hit :sun\" 300 150)",
|
|
238
|
+
"(box :b6 \"msg :circle 160 55 14 :kairos :hit :moon\" 300 190)",
|
|
239
|
+
"(box :b7 \"draw 240 120\" 300 240)",
|
|
240
|
+
"(box :b8 \"print\" 300 390)",
|
|
241
|
+
"(connect :b5 0 :b7 0)",
|
|
242
|
+
"(connect :b6 0 :b7 0)",
|
|
243
|
+
"(connect :b7 0 :b8 0)"
|
|
244
|
+
]
|
|
245
|
+
}
|
|
246
|
+
]
|
|
247
|
+
},
|
|
248
|
+
{
|
|
249
|
+
"id": "motif-transformations",
|
|
250
|
+
"track": "theory",
|
|
251
|
+
"order": 1,
|
|
252
|
+
"title": {
|
|
253
|
+
"en": "A motif and its transformations",
|
|
254
|
+
"es": "Un motivo y sus transformaciones"
|
|
255
|
+
},
|
|
256
|
+
"steps": [
|
|
257
|
+
{
|
|
258
|
+
"title": {
|
|
259
|
+
"en": "Music as data",
|
|
260
|
+
"es": "La música como datos"
|
|
261
|
+
},
|
|
262
|
+
"note": {
|
|
263
|
+
"en": "In Kairotic a fragment of music can be written as a **tree** of data: `[:tag {attributes} children…]`. A `:voice` holds `:measure`s, a measure holds notes, rests, chords and tuplets, and any container can hold others. Strings like `\"c4/1 e4/.5\"` are a shorthand for notes: pitch / duration in beats (a quarter note = 1).\n\nThe same tree can be shown as a score, played, and transformed by the `mt` boxes. In this lesson we take a motif through the classical transformations of counterpoint: transposition, inversion, retrograde, augmentation and canon.\n\nA tree sends itself whenever it changes, so every score below follows it at once. ▶ (or the space bar) is only needed to hear it, at the end.",
|
|
264
|
+
"es": "En Kairotic un fragmento de música se puede escribir como un **árbol** de datos: `[:etiqueta {atributos} hijos…]`. Una `:voice` contiene `:measure` (compases), un compás contiene notas, silencios, acordes y grupos irregulares, y cualquier contenedor puede contener otros. Los textos como `\"c4/1 e4/.5\"` son una abreviatura de notas: altura / duración en pulsos (la negra = 1).\n\nEl mismo árbol se puede ver como partitura, tocar y transformar con las cajas `mt`. En esta lección llevamos un motivo por las transformaciones clásicas del contrapunto: transposición, inversión, retrogradación, aumentación y canon.\n\nUn árbol se envía solo cada vez que cambia, así que cada partitura lo sigue al momento. ▶ (o la barra espaciadora) solo hace falta para escucharlo, al final."
|
|
265
|
+
},
|
|
266
|
+
"try": {
|
|
267
|
+
"en": "",
|
|
268
|
+
"es": ""
|
|
269
|
+
},
|
|
270
|
+
"code": []
|
|
271
|
+
},
|
|
272
|
+
{
|
|
273
|
+
"title": {
|
|
274
|
+
"en": "The motif",
|
|
275
|
+
"es": "El motivo"
|
|
276
|
+
},
|
|
277
|
+
"note": {
|
|
278
|
+
"en": "The `tree` box holds the motif as EDN text: two bars of 4/4. It is its own score, drawn bar by bar, and it sends its tree whenever it changes (the bang only sends it again) — to the `mt` boxes of the next steps, each into a tree box of its own. (The second bar has no `:meter`: it keeps the one before.)\n\nDouble-click the code to edit it (Ctrl+Enter applies), or write a new one from the REPL with `(tree! :b2 [:voice [:measure {:meter [3 4]} \"g4/1 a4 b4\"]])`.",
|
|
279
|
+
"es": "La caja `tree` contiene el motivo como texto EDN: dos compases de 4/4. Es su propia partitura, dibujada compás a compás, y envía su árbol cada vez que cambia (el bang solo lo vuelve a enviar) — a las cajas `mt` de los pasos siguientes, cada una hacia una caja tree propia. (El segundo compás no lleva `:meter`: conserva el anterior.)\n\nHaz doble clic en el código para editarlo (Ctrl+Intro aplica), o escribe uno nuevo desde la REPL con `(tree! :b2 [:voice [:measure {:meter [3 4]} \"g4/1 a4 b4\"]])`."
|
|
280
|
+
},
|
|
281
|
+
"try": {
|
|
282
|
+
"en": "Change a note in the code and apply it: the score follows.",
|
|
283
|
+
"es": "Cambia una nota en el código y aplícalo: la partitura lo sigue."
|
|
284
|
+
},
|
|
285
|
+
"code": [
|
|
286
|
+
"(box :b1 \"bang\" 40 20)",
|
|
287
|
+
"(box :b2 \"tree\" 40 60)",
|
|
288
|
+
"(tree! :b2 [:voice {:name \"motif\"} [:measure {:meter [4 4]} \"c4/1 d4/.5 e4 g4/1 e4\"] [:measure \"f4/.5 e4 d4 c4 d4/2\"]])",
|
|
289
|
+
"(connect :b1 0 :b2 0)"
|
|
290
|
+
]
|
|
291
|
+
},
|
|
292
|
+
{
|
|
293
|
+
"title": {
|
|
294
|
+
"en": "Transposition",
|
|
295
|
+
"es": "Transposición"
|
|
296
|
+
},
|
|
297
|
+
"note": {
|
|
298
|
+
"en": "`mt transpose 7` moves every pitch seven semitones up: a perfect fifth. The shape of the motif — its intervals and its rhythm — does not change; only its register.\n\nThe number is in semitones; negative goes down, and decimals give microtones (`mt transpose 0.5` is a quarter tone).",
|
|
299
|
+
"es": "`mt transpose 7` sube todas las alturas siete semitonos: una quinta justa. La forma del motivo —sus intervalos y su ritmo— no cambia; solo su registro.\n\nEl número está en semitonos; negativo baja, y los decimales dan microtonos (`mt transpose 0.5` es un cuarto de tono)."
|
|
300
|
+
},
|
|
301
|
+
"try": {
|
|
302
|
+
"en": "⌘/Ctrl+click the `mt` box and change 7 for -12 in the inspector: the second score follows.",
|
|
303
|
+
"es": "Haz ⌘/Ctrl+clic en la caja `mt` y cambia 7 por -12 en el inspector: la segunda partitura lo sigue."
|
|
304
|
+
},
|
|
305
|
+
"code": [
|
|
306
|
+
"(box :b4 \"mt transpose 7\" 480 150)",
|
|
307
|
+
"(box :b5 \"tree\" 480 190)",
|
|
308
|
+
"(connect :b2 0 :b4 0)",
|
|
309
|
+
"(connect :b4 0 :b5 0)"
|
|
310
|
+
]
|
|
311
|
+
},
|
|
312
|
+
{
|
|
313
|
+
"title": {
|
|
314
|
+
"en": "Inversion",
|
|
315
|
+
"es": "Inversión"
|
|
316
|
+
},
|
|
317
|
+
"note": {
|
|
318
|
+
"en": "`mt invert c4` mirrors every pitch around c4: what went up a step now goes down a step. The size of every interval is kept, its direction is reversed. Without a pivot, the first note is the axis.\n\nThis step only changes the text of the `mt` box: the patch is the same, its meaning is different.",
|
|
319
|
+
"es": "`mt invert c4` refleja cada altura alrededor de c4: lo que subía un grado ahora baja un grado. Se conserva el tamaño de cada intervalo y se invierte su dirección. Sin eje, la primera nota es el eje.\n\nEste paso solo cambia el texto de la caja `mt`: el patch es el mismo, su sentido es otro."
|
|
320
|
+
},
|
|
321
|
+
"try": {
|
|
322
|
+
"en": "Compare both scores: the contours are mirror images.",
|
|
323
|
+
"es": "Compara las dos partituras: los contornos son imágenes especulares."
|
|
324
|
+
},
|
|
325
|
+
"code": [
|
|
326
|
+
"(text! :b4 \"mt invert c4\")"
|
|
327
|
+
]
|
|
328
|
+
},
|
|
329
|
+
{
|
|
330
|
+
"title": {
|
|
331
|
+
"en": "Retrograde",
|
|
332
|
+
"es": "Retrogradación"
|
|
333
|
+
},
|
|
334
|
+
"note": {
|
|
335
|
+
"en": "`mt retrograde` reads the motif backwards: the last note first. The bars are reversed too, and so is what is inside them, so the rhythm is also read backwards.\n\nInversion and retrograde together (first one box, then another) give the **retrograde inversion**: the four forms of a row in serial music.",
|
|
336
|
+
"es": "`mt retrograde` lee el motivo al revés: la última nota primero. También se invierten los compases y su contenido, así que el ritmo se lee hacia atrás.\n\nInversión y retrogradación juntas (una caja detrás de otra) dan la **retrogradación de la inversión**: las cuatro formas de una serie en la música serial."
|
|
337
|
+
},
|
|
338
|
+
"try": {
|
|
339
|
+
"en": "Make the retrograde inversion: put a box `mt invert c4` between the `mt retrograde` and the score.",
|
|
340
|
+
"es": "Haz la retrogradación de la inversión: pon una caja `mt invert c4` entre la `mt retrograde` y la partitura."
|
|
341
|
+
},
|
|
342
|
+
"code": [
|
|
343
|
+
"(text! :b4 \"mt retrograde\")"
|
|
344
|
+
]
|
|
345
|
+
},
|
|
346
|
+
{
|
|
347
|
+
"title": {
|
|
348
|
+
"en": "Augmentation",
|
|
349
|
+
"es": "Aumentación"
|
|
350
|
+
},
|
|
351
|
+
"note": {
|
|
352
|
+
"en": "`mt augment 2` doubles every duration. The bars double too: 4/4 becomes 8/4, so the music still fits them. `mt augment 0.5` is a diminution: twice as fast, in 2/4.",
|
|
353
|
+
"es": "`mt augment 2` duplica todas las duraciones. Los compases también: 4/4 pasa a 8/4, así que la música sigue cabiendo en ellos. `mt augment 0.5` es una disminución: el doble de rápido, en 2/4."
|
|
354
|
+
},
|
|
355
|
+
"try": {
|
|
356
|
+
"en": "",
|
|
357
|
+
"es": ""
|
|
358
|
+
},
|
|
359
|
+
"code": [
|
|
360
|
+
"(text! :b4 \"mt augment 2\")"
|
|
361
|
+
]
|
|
362
|
+
},
|
|
363
|
+
{
|
|
364
|
+
"title": {
|
|
365
|
+
"en": "Canon",
|
|
366
|
+
"es": "Canon"
|
|
367
|
+
},
|
|
368
|
+
"note": {
|
|
369
|
+
"en": "`mt canon 4 7` plays the motif against itself: a second voice (the *comes*) enters four beats — one bar — later, a fifth higher. When the delay is a whole number of bars, the second voice starts with rest bars, and the score shows two staves.\n\nListen to it in the next step.",
|
|
370
|
+
"es": "`mt canon 4 7` toca el motivo contra sí mismo: una segunda voz (el *comes*) entra cuatro pulsos —un compás— más tarde, una quinta más arriba. Cuando el retardo es un número entero de compases, la segunda voz empieza con compases de silencio, y la partitura muestra dos pentagramas.\n\nEscúchalo en el paso siguiente."
|
|
371
|
+
},
|
|
372
|
+
"try": {
|
|
373
|
+
"en": "Try `mt canon 4 12` (at the octave) or `mt canon 2 7`: with a delay of half a bar there are no rest bars, so the score shows the two voices without the right offset — listen to them instead.",
|
|
374
|
+
"es": "Prueba `mt canon 4 12` (a la octava) o `mt canon 2 7`: con un retardo de medio compás no hay compases de silencio, así que la partitura no muestra bien el desfase entre voces; mejor escúchalas."
|
|
375
|
+
},
|
|
376
|
+
"code": [
|
|
377
|
+
"(text! :b4 \"mt canon 4 7\")"
|
|
378
|
+
]
|
|
379
|
+
},
|
|
380
|
+
{
|
|
381
|
+
"title": {
|
|
382
|
+
"en": "Listening",
|
|
383
|
+
"es": "Escucharlo"
|
|
384
|
+
},
|
|
385
|
+
"note": {
|
|
386
|
+
"en": "`mt play` keeps the last tree it receives and plays it when it gets a bang: on its left outlet the frequencies of the notes sounding, on the second their voice ids — exactly what `synth~` needs, one voice per note.\n\nStart the engine with ▶ (sound and time need it) and click the bang next to `mt play`. `mt play loop` plays it again and again.",
|
|
387
|
+
"es": "`mt play` guarda el último árbol que recibe y lo toca cuando le llega un bang: por su salida izquierda, las frecuencias de las notas que suenan; por la segunda, sus ids de voz —justo lo que necesita `synth~`, una voz por nota.\n\nPon en marcha el motor con ▶ (el sonido y el tiempo lo necesitan) y pulsa el bang junto a `mt play`. `mt play loop` lo repite una y otra vez."
|
|
388
|
+
},
|
|
389
|
+
"try": {
|
|
390
|
+
"en": "Go back in the lesson to the inversion or the retrograde, click the bang of `mt play`, and listen to each transformation.",
|
|
391
|
+
"es": "Vuelve en la lección a la inversión o a la retrogradación, pulsa el bang de `mt play` y escucha cada transformación."
|
|
392
|
+
},
|
|
393
|
+
"code": [
|
|
394
|
+
"(box :b6 \"bang\" 480 420)",
|
|
395
|
+
"(box :b7 \"mt play\" 540 420)",
|
|
396
|
+
"(box :b8 \"synth~\" 540 470)",
|
|
397
|
+
"(box :b9 \"dac~\" 540 520)",
|
|
398
|
+
"(connect :b4 0 :b7 0)",
|
|
399
|
+
"(connect :b6 0 :b7 0)",
|
|
400
|
+
"(connect :b7 1 :b8 1)",
|
|
401
|
+
"(connect :b7 0 :b8 0)",
|
|
402
|
+
"(connect :b8 0 :b9 0)",
|
|
403
|
+
"(connect :b8 0 :b9 1)"
|
|
404
|
+
]
|
|
405
|
+
},
|
|
406
|
+
{
|
|
407
|
+
"title": {
|
|
408
|
+
"en": "Your own variations",
|
|
409
|
+
"es": "Tus propias variaciones"
|
|
410
|
+
},
|
|
411
|
+
"note": {
|
|
412
|
+
"en": "Every step of this lesson is a point in the history: go back to any of them and change the motif or the operation, and a branch of your own grows from there.\n\nA tree can also reuse fragments: `[:voice {:defs {:a \"c4/1 d4 e4\"}} [:use {:ref :a}] [:use {:ref :a :transpose 5 :retrograde true}]]` defines a motif once and writes two variations of it. Try it with `tree!`, and read the format in the guide *Musical trees* (`docs/mt.md`).",
|
|
413
|
+
"es": "Cada paso de esta lección es un punto de la historia: vuelve a cualquiera, cambia el motivo o la operación, y desde ahí crece una rama tuya.\n\nUn árbol también puede reutilizar fragmentos: `[:voice {:defs {:a \"c4/1 d4 e4\"}} [:use {:ref :a}] [:use {:ref :a :transpose 5 :retrograde true}]]` define un motivo una vez y escribe dos variaciones. Pruébalo con `tree!`, y lee el formato en la guía *Árboles musicales* (`docs/mt.es.md`)."
|
|
414
|
+
},
|
|
415
|
+
"try": {
|
|
416
|
+
"en": "",
|
|
417
|
+
"es": ""
|
|
418
|
+
},
|
|
419
|
+
"code": []
|
|
420
|
+
}
|
|
421
|
+
]
|
|
422
|
+
},
|
|
423
|
+
{
|
|
424
|
+
"id": "harmony-geometry",
|
|
425
|
+
"track": "theory",
|
|
426
|
+
"order": 2,
|
|
427
|
+
"title": {
|
|
428
|
+
"en": "Harmony as geometry",
|
|
429
|
+
"es": "La armonía como geometría"
|
|
430
|
+
},
|
|
431
|
+
"steps": [
|
|
432
|
+
{
|
|
433
|
+
"title": {
|
|
434
|
+
"en": "Three pictures of a chord",
|
|
435
|
+
"es": "Tres imágenes de un acorde"
|
|
436
|
+
},
|
|
437
|
+
"note": {
|
|
438
|
+
"en": "Music theory has long drawn harmony as shapes: a set of pitch classes as a polygon on a clock, a scale by how evenly it divides the octave, triads as triangles of a lattice. The package `@kairotic/theory` draws them from what arrives as messages: lists of MIDI pitches, single notes, or a chroma (twelve weights, from `chroma~`).\n\nWriting one of its classes in a box brings the package into the work, as a `component` box beside the patch: that is the box that appeared on its own.\n\nThis lesson uses only messages: click them, nothing needs ▶.",
|
|
439
|
+
"es": "La teoría musical lleva mucho tiempo dibujando la armonía como formas: un conjunto de clases de altura como un polígono sobre un reloj, una escala por lo regular que divide la octava, las tríadas como triángulos de una red. El paquete `@kairotic/theory` las dibuja a partir de lo que le llega como mensajes: listas de alturas MIDI, notas sueltas o un croma (doce pesos, de `chroma~`).\n\nEscribir una de sus clases en una caja trae el paquete a la obra, como una caja `component` junto al patch: es la caja que ha aparecido sola.\n\nEsta lección solo usa mensajes: haz clic en ellos, no hace falta ▶."
|
|
440
|
+
},
|
|
441
|
+
"try": {
|
|
442
|
+
"en": "",
|
|
443
|
+
"es": ""
|
|
444
|
+
},
|
|
445
|
+
"code": []
|
|
446
|
+
},
|
|
447
|
+
{
|
|
448
|
+
"title": {
|
|
449
|
+
"en": "The clock",
|
|
450
|
+
"es": "El reloj"
|
|
451
|
+
},
|
|
452
|
+
"note": {
|
|
453
|
+
"en": "`pcclock` places each pitch class on a clock face (C at the top, a semitone per hour) and joins the ones that sound into a polygon. Its outlets give the **prime form** of the set (its normal shape, transposed to 0) and its **interval vector** (how many of each interval it contains); the dashed lines are its axes of symmetry.\n\nThe major triad has none: it is not the same read upwards and downwards. The diminished seventh has four, and the same polygon after any transposition by a minor third.\n\nThe messages here are MIDI notes (60 is C4), so the box is written `pcclock midi`; without it, it takes Hz, as a keyboard or `midiin` sends them.",
|
|
454
|
+
"es": "`pcclock` coloca cada clase de altura en la esfera de un reloj (Do arriba, un semitono por hora) y une las que suenan en un polígono. Sus salidas dan la **forma prima** del conjunto (su forma normal, transportada a 0) y su **vector interválico** (cuántos intervalos de cada clase contiene); las líneas discontinuas son sus ejes de simetría.\n\nLa tríada mayor no tiene ninguno: no es la misma leída hacia arriba y hacia abajo. La séptima disminuida tiene cuatro, y es el mismo polígono tras cualquier transposición de tercera menor.\n\nAquí los mensajes son notas MIDI (60 es Do4), por eso la caja se escribe `pcclock midi`; sin esa palabra toma Hz, como los envía un `keyboard` o `midiin`."
|
|
455
|
+
},
|
|
456
|
+
"try": {
|
|
457
|
+
"en": "Click the two messages and read print in the REPL. Press a pitch class on the clock: its number comes out of the right outlet.",
|
|
458
|
+
"es": "Haz clic en los dos mensajes y lee print en la REPL. Pulsa una clase de altura en el reloj: su número sale por la salida derecha."
|
|
459
|
+
},
|
|
460
|
+
"code": [
|
|
461
|
+
"(box :b1 \"msg 60 64 67\" 40 30)",
|
|
462
|
+
"(box :b2 \"msg 60 63 66 69\" 150 30)",
|
|
463
|
+
"(box :b3 \"pcclock midi\" 40 90)",
|
|
464
|
+
"(box :b4 \"print\" 40 360)",
|
|
465
|
+
"(connect :b1 0 :b3 0)",
|
|
466
|
+
"(connect :b2 0 :b3 0)",
|
|
467
|
+
"(connect :b3 0 :b4 0)"
|
|
468
|
+
]
|
|
469
|
+
},
|
|
470
|
+
{
|
|
471
|
+
"title": {
|
|
472
|
+
"en": "The six coefficients",
|
|
473
|
+
"es": "Los seis coeficientes"
|
|
474
|
+
},
|
|
475
|
+
"note": {
|
|
476
|
+
"en": "`fourier` measures a set by the discrete Fourier transform of its twelve classes. Each of its six circles asks one question — how chromatic, how dyadic (tritones), how triadic (augmented), how octatonic, how **diatonic**, how whole-tone — and the point's distance from the centre is the answer (0…1). Its angle tells which transposition.\n\nThe diatonic scale is almost all f5; the augmented triad is all f3 and f6. The trail shows where the last sets were.",
|
|
477
|
+
"es": "`fourier` mide un conjunto con la transformada de Fourier discreta de sus doce clases. Cada uno de sus seis círculos hace una pregunta —cuán cromático, cuán diádico (tritonos), cuán triádico (aumentado), cuán octatónico, cuán **diatónico**, cuán de tonos enteros— y la distancia del punto al centro es la respuesta (0…1). Su ángulo dice qué transposición.\n\nLa escala diatónica es casi toda f5; la tríada aumentada es toda f3 y f6. El rastro muestra dónde estaban los últimos conjuntos."
|
|
478
|
+
},
|
|
479
|
+
"try": {
|
|
480
|
+
"en": "Click the scale, then the augmented triad, then the chords above: watch which circle each one fills.",
|
|
481
|
+
"es": "Haz clic en la escala, luego en la tríada aumentada, luego en los acordes de arriba: mira qué círculo llena cada uno."
|
|
482
|
+
},
|
|
483
|
+
"code": [
|
|
484
|
+
"(box :b5 \"msg 60 62 64 65 67 69 71\" 330 30)",
|
|
485
|
+
"(box :b6 \"msg 60 64 68\" 540 30)",
|
|
486
|
+
"(box :b7 \"fourier midi\" 330 90)",
|
|
487
|
+
"(connect :b5 0 :b7 0)",
|
|
488
|
+
"(connect :b6 0 :b7 0)",
|
|
489
|
+
"(connect :b1 0 :b7 0)",
|
|
490
|
+
"(connect :b2 0 :b7 0)",
|
|
491
|
+
"(connect :b5 0 :b3 0)",
|
|
492
|
+
"(connect :b6 0 :b3 0)"
|
|
493
|
+
]
|
|
494
|
+
},
|
|
495
|
+
{
|
|
496
|
+
"title": {
|
|
497
|
+
"en": "The path on the Tonnetz",
|
|
498
|
+
"es": "El camino en el Tonnetz"
|
|
499
|
+
},
|
|
500
|
+
"note": {
|
|
501
|
+
"en": "On the **Tonnetz** fifths run across and thirds run up, so every triad is a triangle and two triads that share two notes share an edge. The neo-Riemannian moves are those edges: **P** (parallel: C ↔ c), **L** (leading-tone exchange: C ↔ e) and **R** (relative: C ↔ a).\n\n`tonnetz` lights the triad it receives and joins it to the ones before, on the nearest copy of the lattice: a progression becomes a path. C – c – A♭ – g♯ is P, L, P: three single steps.",
|
|
502
|
+
"es": "En el **Tonnetz** las quintas van en horizontal y las terceras hacia arriba, así que cada tríada es un triángulo y dos tríadas que comparten dos notas comparten un lado. Los movimientos neorriemannianos son esos lados: **P** (paralelo: Do ↔ do), **L** (intercambio de sensible: Do ↔ mi) y **R** (relativo: Do ↔ la).\n\n`tonnetz` ilumina la tríada que recibe y la une a las anteriores, sobre la copia más cercana de la red: una progresión se vuelve un camino. Do – do – La♭ – sol♯ es P, L, P: tres pasos sencillos."
|
|
503
|
+
},
|
|
504
|
+
"try": {
|
|
505
|
+
"en": "Click the four messages from left to right: print writes the name of each triad. Then click C and the major triad of F♯ (write it in a msg: 66 70 73): a long way across the lattice.",
|
|
506
|
+
"es": "Haz clic en los cuatro mensajes de izquierda a derecha: print escribe el nombre de cada tríada. Después Do y la tríada de Fa♯ (escríbela en un msg: 66 70 73): un camino largo por la red."
|
|
507
|
+
},
|
|
508
|
+
"code": [
|
|
509
|
+
"(box :b8 \"msg 60 63 67\" 120 430)",
|
|
510
|
+
"(box :b9 \"msg 60 63 68\" 230 430)",
|
|
511
|
+
"(box :b10 \"msg 59 63 68\" 340 430)",
|
|
512
|
+
"(box :b11 \"tonnetz midi\" 40 480)",
|
|
513
|
+
"(box :b12 \"print\" 40 760)",
|
|
514
|
+
"(connect :b1 0 :b11 0)",
|
|
515
|
+
"(connect :b8 0 :b11 0)",
|
|
516
|
+
"(connect :b9 0 :b11 0)",
|
|
517
|
+
"(connect :b10 0 :b11 0)",
|
|
518
|
+
"(connect :b11 0 :b12 0)"
|
|
519
|
+
]
|
|
520
|
+
},
|
|
521
|
+
{
|
|
522
|
+
"title": {
|
|
523
|
+
"en": "What you play",
|
|
524
|
+
"es": "Lo que tocas"
|
|
525
|
+
},
|
|
526
|
+
"note": {
|
|
527
|
+
"en": "The three boxes also take a **chroma**: twelve weights, one per pitch class, as `chroma~` hears them in a signal. `adc~ 1` → `chroma~` → `pcclock`, `fourier` or `tonnetz` draws, as you sing or play, what the harmony is doing.\n\nA box can also be drawn again large on a layer, behind the presentation: `(project :b11 :viz [40 40 800 600])` (see the guide, *Annotations and layers*).",
|
|
528
|
+
"es": "Las tres cajas también aceptan un **croma**: doce pesos, uno por clase de altura, como los oye `chroma~` en una señal. `adc~ 1` → `chroma~` → `pcclock`, `fourier` o `tonnetz` dibuja, mientras cantas o tocas, lo que está haciendo la armonía.\n\nUna caja también se puede dibujar otra vez en grande sobre una capa, detrás de la presentación: `(project :b11 :viz [40 40 800 600])` (ver la guía, *Anotaciones y capas*)."
|
|
529
|
+
},
|
|
530
|
+
"try": {
|
|
531
|
+
"en": "Press ▶, allow the microphone and play a chord near it (an instrument, or a recording): the chroma lights the classes that sound.",
|
|
532
|
+
"es": "Pulsa ▶, permite el micrófono y toca un acorde cerca (un instrumento o una grabación): el croma ilumina las clases que suenan."
|
|
533
|
+
},
|
|
534
|
+
"code": [
|
|
535
|
+
"(box :b13 \"adc~ 1\" 640 430)",
|
|
536
|
+
"(box :b14 \"chroma~\" 640 480)",
|
|
537
|
+
"(connect :b13 0 :b14 0)",
|
|
538
|
+
"(connect :b14 0 :b7 0)"
|
|
539
|
+
]
|
|
540
|
+
}
|
|
541
|
+
]
|
|
542
|
+
},
|
|
543
|
+
{
|
|
544
|
+
"id": "one-two-tree",
|
|
545
|
+
"track": "theory",
|
|
546
|
+
"order": 3,
|
|
547
|
+
"title": {
|
|
548
|
+
"en": "One, two, tree",
|
|
549
|
+
"es": "Uno, dos, tree"
|
|
550
|
+
},
|
|
551
|
+
"steps": [
|
|
552
|
+
{
|
|
553
|
+
"title": {
|
|
554
|
+
"en": "One box",
|
|
555
|
+
"es": "Una caja"
|
|
556
|
+
},
|
|
557
|
+
"note": {
|
|
558
|
+
"en": "In Kairotic, music in time lives in **one box**, `tree`. Its data is a tree written as EDN, `[:tag {attributes} children…]`. A `:voice` holds `:measure`s. A measure holds notes, rests, chords and tuplets. A string like `\"c4/1 d4/.5\"` is shorthand for notes: pitch / duration in beats, where a quarter note = 1.\n\nThat one tree is seen in **two views**: a **score** and a **roll** (⇄ in the box's header switches between them). Its text opens in the code window from **{ }** in the header. Whatever you change, in either view or in the text, is an edit of the same tree, one event of the history. Hence the title: one box, two views, tree.\n\nA tree box is a score from the start: Verovio draws it from the tree, bar by bar. Beams follow the beat, and the second bar keeps the meter of the first.",
|
|
559
|
+
"es": "En Kairotic, la música en el tiempo vive en **una caja**, `tree`. Su dato es un árbol escrito en EDN, `[:etiqueta {atributos} hijos…]`. Una `:voice` contiene `:measure` (compases). Un compás contiene notas, silencios, acordes y grupos irregulares. Un texto como `\"c4/1 d4/.5\"` es una abreviatura de notas: altura / duración en pulsos, donde la negra = 1.\n\nEse único árbol se ve en **dos vistas**: una **partitura** y un **roll** (⇄ en la cabecera de la caja pasa de una a otra). Su texto se abre en la ventana de código desde **{ }** en la cabecera. Lo que cambias, en cualquiera de las vistas o en el texto, es una edición del mismo árbol, un evento de la historia. De ahí el título: una caja, dos vistas, tree.\n\nUna caja tree es una partitura desde el principio: Verovio la dibuja a partir del árbol, compás a compás. Las barras de corchea siguen el pulso, y el segundo compás conserva la métrica del primero."
|
|
560
|
+
},
|
|
561
|
+
"try": {
|
|
562
|
+
"en": "Press { } in the header, change a note in the text and apply it with Ctrl+Enter: the score follows. Only the nodes that change go into the history.",
|
|
563
|
+
"es": "Pulsa { } en la cabecera, cambia una nota en el texto y aplícalo con Ctrl+Intro: la partitura lo sigue. Solo los nodos que cambian entran en la historia."
|
|
564
|
+
},
|
|
565
|
+
"code": [
|
|
566
|
+
"(box :b1 \"tree\" 40 30)",
|
|
567
|
+
"(tree! :b1 [:voice {:name \"motif\"} [:measure {:meter [4 4]} \"c4/1 d4/.5 e4 g4/1 e4\"] [:measure \"f4/.5 e4 d4 c4 d4/2\"]])"
|
|
568
|
+
]
|
|
569
|
+
},
|
|
570
|
+
{
|
|
571
|
+
"title": {
|
|
572
|
+
"en": "Two: editing the score",
|
|
573
|
+
"es": "Dos: editar la partitura"
|
|
574
|
+
},
|
|
575
|
+
"note": {
|
|
576
|
+
"en": "The score is also a place to edit. Click a note and press ↑ ↓ to change its pitch (⇧ moves an octave), a…g for the nearest note of that name, + − for its duration, and ← → to go to the next note. Delete turns it into a rest, and Enter on a rest turns it back into a note. Each key press is one edit of the tree.",
|
|
577
|
+
"es": "La partitura también es un lugar para editar. Haz clic en una nota y pulsa ↑ ↓ para cambiar su altura (⇧ mueve una octava), a…g para la nota más cercana de ese nombre, + − para su duración, y ← → para pasar a la nota siguiente. Supr la convierte en silencio, e Intro sobre un silencio la vuelve a hacer nota. Cada tecla es una edición del árbol."
|
|
578
|
+
},
|
|
579
|
+
"try": {
|
|
580
|
+
"en": "Click the first note and press ↑ twice, then open { }: the melody string has changed.",
|
|
581
|
+
"es": "Haz clic en la primera nota y pulsa ↑ dos veces; luego abre { }: el texto de la melodía ha cambiado."
|
|
582
|
+
},
|
|
583
|
+
"code": []
|
|
584
|
+
},
|
|
585
|
+
{
|
|
586
|
+
"title": {
|
|
587
|
+
"en": "Tree: the roll",
|
|
588
|
+
"es": "Tree: el roll"
|
|
589
|
+
},
|
|
590
|
+
"note": {
|
|
591
|
+
"en": "The second view is a **piano roll**: the notes as **strokes of frequency over time**, as a `freqt` draws them, one line per note, at its height in Hz, as long as it lasts (⇄ in the header, or `(view :b1 :roll)`).\n\nDrawing there writes into the tree. Dragging a note up or down changes only its pitch, inside its melody string. Moving or stretching it in time **re-quantizes the bar it touches**, in that bar's meter. A note drawn in a measured tree goes into its bar. With **⌥** (dragging, or drawing freehand), a note leaves the measures for a **free voice** of the tree, which the score writes on a staff of its own.",
|
|
592
|
+
"es": "La segunda vista es un **piano roll**: las notas como **trazos de frecuencia en el tiempo**, como los dibuja un `freqt`, una línea por nota, a su altura en Hz, tan larga como dura (⇄ en la cabecera, o `(view :b1 :roll)`).\n\nDibujar ahí escribe en el árbol. Arrastrar una nota arriba o abajo cambia solo su altura, dentro de su texto de melodía. Moverla o estirarla en el tiempo **vuelve a cuantizar el compás que toca**, en la métrica de ese compás. Una nota dibujada en un árbol con compases entra en su compás. Con **⌥** (al arrastrar o al dibujar a mano alzada), una nota sale de los compases hacia una **voz libre** del árbol, que la partitura escribe en un pentagrama propio."
|
|
593
|
+
},
|
|
594
|
+
"try": {
|
|
595
|
+
"en": "Drag the last note half a beat to the right, then ⇄ to see the score. Then hold ⌥ and draw a long note above: it appears on a second staff.",
|
|
596
|
+
"es": "Arrastra la última nota medio pulso a la derecha y pasa con ⇄ a la partitura. Después mantén ⌥ y dibuja una nota larga por encima: aparece en un segundo pentagrama."
|
|
597
|
+
},
|
|
598
|
+
"code": [
|
|
599
|
+
"(view :b1 :roll)"
|
|
600
|
+
]
|
|
601
|
+
},
|
|
602
|
+
{
|
|
603
|
+
"title": {
|
|
604
|
+
"en": "Meters, groups, tuplets, ties",
|
|
605
|
+
"es": "Métricas, agrupaciones, grupos irregulares, ligaduras"
|
|
606
|
+
},
|
|
607
|
+
"note": {
|
|
608
|
+
"en": "Measured time is written with a few tags. `{:meter \"7/8[2+2+3]\"}` is a meter with its groups: the score writes it as 2+2+3 over 8 and beams by group. `[:tuplet {:ratio [3 2]} …]` puts 3 notes in the time of 2.\n\n`:tie true` carries a note into the next one of the same pitch, here across the barline. `:grace true` makes a grace note, which takes no time. In a melody string, `+` makes a chord and `r` a rest.",
|
|
609
|
+
"es": "El tiempo medido se escribe con unas pocas etiquetas. `{:meter \"7/8[2+2+3]\"}` es una métrica con sus agrupaciones: la partitura la escribe como 2+2+3 sobre 8 y agrupa las barras por grupo. `[:tuplet {:ratio [3 2]} …]` pone 3 notas en el tiempo de 2.\n\n`:tie true` prolonga una nota en la siguiente de la misma altura, aquí a través de la barra de compás. `:grace true` hace una apoyatura, que no ocupa tiempo. En un texto de melodía, `+` hace un acorde y `r` un silencio."
|
|
610
|
+
},
|
|
611
|
+
"try": {
|
|
612
|
+
"en": "Change the meter to `\"7/8[3+2+2]\"` in its text ({ }): the beams regroup.",
|
|
613
|
+
"es": "Cambia la métrica a `\"7/8[3+2+2]\"` en su texto ({ }): las barras se reagrupan."
|
|
614
|
+
},
|
|
615
|
+
"code": [
|
|
616
|
+
"(box :b2 \"tree\" 40 300)",
|
|
617
|
+
"(tree! :b2 [:voice [:measure {:meter \"7/8[2+2+3]\"} \"d4/.5 e4 f4 g4 a4/1.5\"] [:measure {:meter [3 4]} [:tuplet {:ratio [3 2]} \"b4/.5 c5 d5\"] [:note {:pitch \"g4\" :dur 0.25 :grace true}] [:note {:pitch \"e5\" :dur 1 :tie true}]] [:measure \"e5/1 r/.5 c4+e4+g4/1.5\"]])"
|
|
618
|
+
]
|
|
619
|
+
},
|
|
620
|
+
{
|
|
621
|
+
"title": {
|
|
622
|
+
"en": "Proportional rhythm",
|
|
623
|
+
"es": "Ritmo proporcional"
|
|
624
|
+
},
|
|
625
|
+
"note": {
|
|
626
|
+
"en": "A rhythm can also be written as **shares** instead of durations, as in the rhythm trees of OpenMusic: `[:rtm {:shares […]}]`. A number is a share and a negative number is a silence. `[weight [shares…]]` divides a share further.\n\nThe note values and tuplets are not written: they **follow from the shares and the meter**. The `:pitches` cycle when they run out, so rhythm and pitches can have different lengths (talea and color).\n\nHere, five shares fill each bar of 4/4, giving a quintuplet of quarters, and the second share holds a triplet.",
|
|
627
|
+
"es": "Un ritmo también puede escribirse como **proporciones** en lugar de duraciones, como en los árboles rítmicos de OpenMusic: `[:rtm {:shares […]}]`. Un número es una proporción y un número negativo es un silencio. `[peso [proporciones…]]` divide una proporción más.\n\nLas figuras y los grupos irregulares no se escriben: **se deducen de las proporciones y la métrica**. Las `:pitches` vuelven a empezar cuando se acaban, así que ritmo y alturas pueden tener longitudes distintas (talea y color).\n\nAquí, cinco proporciones llenan cada compás de 4/4, lo que da un quintillo de negras, y la segunda proporción contiene un tresillo."
|
|
628
|
+
},
|
|
629
|
+
"try": {
|
|
630
|
+
"en": "In its text, change `:shares` to `[1 1 1]`: a 3:2 of halves. Or put the measure in `[3 4]`: three quarters, no tuplet at all.",
|
|
631
|
+
"es": "En su texto, cambia `:shares` por `[1 1 1]`: un 3:2 de blancas. O pon el compás en `[3 4]`: tres negras, sin grupo irregular."
|
|
632
|
+
},
|
|
633
|
+
"code": [
|
|
634
|
+
"(box :b3 \"tree\" 480 30)",
|
|
635
|
+
"(tree! :b3 [:voice [:measure {:meter [4 4]} [:rtm {:shares [1 [1 [1 1 1]] -1 2] :pitches \"c4 d4 e4 f4 g4 a4 b4\"}]] [:measure [:rtm {:shares [2 1 1 -1 1] :pitches \"c5 a4 f4\"}]]])"
|
|
636
|
+
]
|
|
637
|
+
},
|
|
638
|
+
{
|
|
639
|
+
"title": {
|
|
640
|
+
"en": "Free time",
|
|
641
|
+
"es": "Tiempo libre"
|
|
642
|
+
},
|
|
643
|
+
"note": {
|
|
644
|
+
"en": "A tree **without measures** is in free time. Each note says when it starts with `:at` and how long it lasts with `:dur`, inside a `[:par …]`. Nothing has been decided yet about meter or note values. These notes were played, not written: a little early, a little late.\n\nAs a roll, drawing adds a note, dragging moves it, stretching from its end lengthens it, and Delete erases it. From code, `(stroke :b4 [[t hz] [t2 hz]])` draws one. The tree also keeps its **grid and tuning** on its root: `(grid-x :b4 0.25 [3])` snaps drawing to sixteenths in bars of 3/4. A tree is drawn in semitones (12-tet) unless it says otherwise, for example with `(tuning :b4 \"19-tet\")`.",
|
|
645
|
+
"es": "Un árbol **sin compases** está en tiempo libre. Cada nota dice cuándo empieza con `:at` y cuánto dura con `:dur`, dentro de un `[:par …]`. Todavía no se ha decidido nada sobre la métrica ni sobre las figuras. Estas notas se tocaron, no se escribieron: un poco antes, un poco después.\n\nComo roll, dibujar añade una nota, arrastrar la mueve, estirarla desde su final la alarga, y Supr la borra. Desde código, `(stroke :b4 [[t hz] [t2 hz]])` dibuja una. El árbol también guarda su **rejilla y su afinación** en su raíz: `(grid-x :b4 0.25 [3])` ajusta el dibujo a semicorcheas en compases de 3/4. Un árbol se dibuja en semitonos (12-tet) salvo que diga otra cosa, por ejemplo con `(tuning :b4 \"19-tet\")`."
|
|
646
|
+
},
|
|
647
|
+
"try": {
|
|
648
|
+
"en": "Draw a few notes of your own after the last one: they snap to the grid and to the semitones.",
|
|
649
|
+
"es": "Dibuja unas notas tuyas después de la última: se ajustan a la rejilla y a los semitonos."
|
|
650
|
+
},
|
|
651
|
+
"code": [
|
|
652
|
+
"(box :b4 \"tree\" 480 300)",
|
|
653
|
+
"(tree! :b4 [:voice [:par [:note {:at 0 :dur 0.95 :pitch \"e4\"}] [:note {:at 1.02 :dur 0.3 :pitch \"f#4\"}] [:note {:at 1.36 :dur 0.3 :pitch \"g4\"}] [:note {:at 1.68 :dur 0.3 :pitch \"a4\"}] [:note {:at 2.03 :dur 0.95 :pitch \"b4\"}] [:note {:at 3 :dur 0.48 :pitch \"d5\"}] [:note {:at 3.52 :dur 0.45 :pitch \"c5\"}] [:note {:at 4 :dur 2 :pitch \"b4\"}]]])",
|
|
654
|
+
"(grid-x :b4 0.25 [3])",
|
|
655
|
+
"(view :b4 :roll)"
|
|
656
|
+
]
|
|
657
|
+
},
|
|
658
|
+
{
|
|
659
|
+
"title": {
|
|
660
|
+
"en": "Quantized: a guess",
|
|
661
|
+
"es": "Cuantizado: una conjetura"
|
|
662
|
+
},
|
|
663
|
+
"note": {
|
|
664
|
+
"en": "Shown as a score, free time is **quantized**: the notes are written in measures, in the meter of the grid (3/4 here). Each beat takes the division that costs least. The cost counts how far the notes are from its points, how deep those points are, whether it is a tuplet, and how many notes are lost. The three quick notes become a triplet, and the notes played a little early or late fall on the beat.\n\nThe quantizer only guesses. When it guesses wrong, **alt-click a note**: its beat takes the next way to divide it (another division, the beat in halves, or the beat merged with the next one). The choice is kept in the tree's `:quant`, as one event of the history.\n\nFrom the REPL, `(divisions :b4 1)` lists the ways for the beat at 1, the current one first, and `(division! :b4 1 4)` divides it in four. `(quant :b4 {:meter \"6/8\"})` quantizes the score in another meter, and `(quant :b4 nil)` goes back to the defaults.\n\nNothing in the notes has changed: the score is a reading of them.",
|
|
665
|
+
"es": "Mostrado como partitura, el tiempo libre se **cuantiza**: las notas se escriben en compases, en la métrica de la rejilla (aquí 3/4). Cada pulso toma la división que menos cuesta. El coste cuenta lo lejos que quedan las notas de sus puntos, lo profundos que son esos puntos, si es un grupo irregular y cuántas notas se pierden. Las tres notas rápidas se vuelven un tresillo, y las que se tocaron un poco antes o después caen en el pulso.\n\nEl cuantizador solo conjetura. Cuando se equivoca, **haz alt-clic en una nota**: su pulso toma la siguiente manera de dividirse (otra división, el pulso en mitades, o el pulso unido al siguiente). La elección se guarda en el `:quant` del árbol, como un evento de la historia.\n\nDesde la REPL, `(divisions :b4 1)` da las maneras para el pulso en 1, la actual primero, y `(division! :b4 1 4)` lo divide en cuatro. `(quant :b4 {:meter \"6/8\"})` cuantiza la partitura en otra métrica, y `(quant :b4 nil)` vuelve a los valores por defecto.\n\nNada ha cambiado en las notas: la partitura es una lectura de ellas."
|
|
666
|
+
},
|
|
667
|
+
"try": {
|
|
668
|
+
"en": "Alt-click one of the triplet notes a few times and watch the beat change: four sixteenths, then other divisions, then the triplet again.",
|
|
669
|
+
"es": "Haz alt-clic varias veces en una nota del tresillo y mira cómo cambia el pulso: cuatro semicorcheas, luego otras divisiones, y otra vez el tresillo."
|
|
670
|
+
},
|
|
671
|
+
"code": [
|
|
672
|
+
"(view :b4 :score)"
|
|
673
|
+
]
|
|
674
|
+
},
|
|
675
|
+
{
|
|
676
|
+
"title": {
|
|
677
|
+
"en": "Written in measures",
|
|
678
|
+
"es": "Escrito en compases"
|
|
679
|
+
},
|
|
680
|
+
"note": {
|
|
681
|
+
"en": "When the reading is the right one, `(quantize! :b4)` **writes it into the tree**. The free notes become measures, tuplets and ties, as the score showed them. It is one event of the history, so undo goes back. From now on the tree is measured: edits in the canvas re-quantize only the bars they touch.\n\n`(unquantize! :b4)` does the opposite: the notes go back to free time, each one with its `:at`.",
|
|
682
|
+
"es": "Cuando la lectura es la buena, `(quantize! :b4)` **la escribe en el árbol**. Las notas libres se vuelven compases, grupos irregulares y ligaduras, tal como los mostraba la partitura. Es un evento de la historia, así que deshacer vuelve atrás. A partir de ahí el árbol tiene compases: las ediciones en el lienzo solo vuelven a cuantizar los compases que tocan.\n\n`(unquantize! :b4)` hace lo contrario: las notas vuelven al tiempo libre, cada una con su `:at`."
|
|
683
|
+
},
|
|
684
|
+
"try": {
|
|
685
|
+
"en": "Open { } to see what was written. Then try `(unquantize! :b4)` and look at the text again.",
|
|
686
|
+
"es": "Abre { } para ver lo que se ha escrito. Después prueba `(unquantize! :b4)` y vuelve a mirar el texto."
|
|
687
|
+
},
|
|
688
|
+
"code": [
|
|
689
|
+
"(quantize! :b4)"
|
|
690
|
+
]
|
|
691
|
+
},
|
|
692
|
+
{
|
|
693
|
+
"title": {
|
|
694
|
+
"en": "A raw buffer: freqt",
|
|
695
|
+
"es": "Un búfer crudo: freqt"
|
|
696
|
+
},
|
|
697
|
+
"note": {
|
|
698
|
+
"en": "A `freqt` is something else: a **raw buffer of frequency over time**, with no tree behind it. It is what `transcribe` writes from a voice, or a drawing in continuous Hz. Here it holds a chromatic line that goes up and comes back down, written in Hz, so the notes have no names.\n\nIts score is quantized in the same way, and **named** in the same way. Pitches without a name are spelled near the key and moving well in each voice. A chromatic line rises in sharps and falls in flats.\n\nIts score is a preview. When a drawing is to become a score of its own, a `quantize` box writes it in measures as a tree, with the options you give it (the freqt's second outlet on its right inlet, and a bang: see its help); or `(to-tree! :b5)` makes a new tree box beside it with its strokes as free notes. The tree, unlike the freqt, can then be edited note by note.",
|
|
699
|
+
"es": "Un `freqt` es otra cosa: un **búfer crudo de frecuencia en el tiempo**, sin un árbol detrás. Es lo que `transcribe` escribe a partir de una voz, o un dibujo en Hz continuos. Aquí contiene una línea cromática que sube y vuelve a bajar, escrita en Hz, así que las notas no tienen nombre.\n\nSu partitura se cuantiza de la misma manera, y se **nombra** de la misma manera. Las alturas sin nombre se escriben cerca de la tonalidad y moviéndose bien en cada voz. Una línea cromática sube con sostenidos y baja con bemoles.\n\nSu partitura es una vista previa. Cuando un dibujo tiene que llegar a ser una partitura propia, una caja `quantize` lo escribe en compases como árbol, con las opciones que le des (la segunda salida del freqt en su entrada derecha, y un bang: mira su ayuda); o `(to-tree! :b5)` crea una caja tree a su lado con sus trazos como notas libres. El árbol, a diferencia del freqt, se puede editar nota a nota."
|
|
700
|
+
},
|
|
701
|
+
"try": {
|
|
702
|
+
"en": "Shift-alt-click a note to give it another name (c#4 → db4). `(quant :b5 {:key \"d\"})` puts the score in D major.",
|
|
703
|
+
"es": "Haz shift-alt-clic en una nota para darle otro nombre (c#4 → db4). `(quant :b5 {:key \"d\"})` pone la partitura en re mayor."
|
|
704
|
+
},
|
|
705
|
+
"code": [
|
|
706
|
+
"(box :b5 \"freqt\" 40 570)",
|
|
707
|
+
"(grid-x :b5 0.5 [4])",
|
|
708
|
+
"(melody :b5 \"c4/.5 c#4/.5 d4/.5 d#4/.5 e4/.5 f4/.5 e4/.5 eb4/.5 d4/.5 db4/.5 c4/1\" 0)",
|
|
709
|
+
"(view :b5 :score)"
|
|
710
|
+
]
|
|
711
|
+
},
|
|
712
|
+
{
|
|
713
|
+
"title": {
|
|
714
|
+
"en": "Names and keys",
|
|
715
|
+
"es": "Nombres y tonalidades"
|
|
716
|
+
},
|
|
717
|
+
"note": {
|
|
718
|
+
"en": "A tree keeps the names it was given: G♯ and A♭ sound alike and are written apart. `{:key \"eb\"}` on the tree, a voice or a measure gives the score its signature. An accidental lasts to the end of its bar, and `:key :none` writes every accidental, for atonal music.\n\nTransposing keeps the spelling too. `mt transpose M3` moves the melody up a major third, and E♭ becomes G, not F𝄪. A number of semitones moves by the interval that is usually written for it.",
|
|
719
|
+
"es": "Un árbol guarda los nombres que se le dieron: sol♯ y la♭ suenan igual y se escriben distinto. `{:key \"eb\"}` en el árbol, una voz o un compás da a la partitura su armadura. Una alteración dura hasta el final de su compás, y `:key :none` escribe todas las alteraciones, para la música atonal.\n\nLa transposición también conserva la grafía. `mt transpose M3` sube la melodía una tercera mayor, y mi♭ se vuelve sol, no fa𝄪. Un número de semitonos mueve por el intervalo con que se suele escribir."
|
|
720
|
+
},
|
|
721
|
+
"try": {
|
|
722
|
+
"en": "Click a note of the upper score and press `#`: it cycles through its names (ab4 → g#4 → …). Change the key of the tree to `\"c#m\"`.",
|
|
723
|
+
"es": "Haz clic en una nota de la partitura de arriba y pulsa `#`: pasa por sus nombres (ab4 → g#4 → …). Cambia la tonalidad del árbol a `\"c#m\"`."
|
|
724
|
+
},
|
|
725
|
+
"code": [
|
|
726
|
+
"(box :b6 \"tree\" 480 570)",
|
|
727
|
+
"(tree! :b6 [:voice {:key \"eb\"} [:measure {:meter [4 4]} \"eb4/1 f4/.5 g4 ab4/1 a4/.5 bb4\"] [:measure \"c5/1 b4/.5 bb4 eb4/2\"]])",
|
|
728
|
+
"(box :b7 \"mt transpose M3\" 480 720)",
|
|
729
|
+
"(box :b8 \"tree\" 480 760)",
|
|
730
|
+
"(connect :b6 0 :b7 0)",
|
|
731
|
+
"(connect :b7 0 :b8 0)"
|
|
732
|
+
]
|
|
733
|
+
},
|
|
734
|
+
{
|
|
735
|
+
"title": {
|
|
736
|
+
"en": "Between semitones",
|
|
737
|
+
"es": "Entre semitonos"
|
|
738
|
+
},
|
|
739
|
+
"note": {
|
|
740
|
+
"en": "Time can be free, and so can pitch. A name can carry `:cents`: `{:pitch \"c4\" :cents 50}` is a quarter tone above C, and the score writes it with a quarter-tone accidental. A MIDI number with decimals works too: 64.5 is E a quarter tone up. Other deviations are written as cents above the note.\n\n`:gliss [[0 0] [1 -150]]` bends a note over its duration, here down 150 cents. The score writes the glissando as a text.",
|
|
741
|
+
"es": "El tiempo puede ser libre, y la altura también. Un nombre puede llevar `:cents`: `{:pitch \"c4\" :cents 50}` es un cuarto de tono por encima de do, y la partitura lo escribe con una alteración de cuarto de tono. También sirve un número MIDI con decimales: 64.5 es mi un cuarto de tono arriba. Las demás desviaciones se escriben como cents encima de la nota.\n\n`:gliss [[0 0] [1 -150]]` curva una nota a lo largo de su duración, aquí 150 cents hacia abajo. La partitura escribe el glissando como un texto."
|
|
742
|
+
},
|
|
743
|
+
"try": {
|
|
744
|
+
"en": "⇄ to the roll: the quarter tones sit between the lines of the semitones, and the glissando is a curve.",
|
|
745
|
+
"es": "Pasa con ⇄ al roll: los cuartos de tono quedan entre las líneas de los semitonos, y el glissando es una curva."
|
|
746
|
+
},
|
|
747
|
+
"code": [
|
|
748
|
+
"(box :b9 \"tree\" 40 840)",
|
|
749
|
+
"(tree! :b9 [:voice [:measure {:meter [4 4]} [:note {:pitch \"c4\" :dur 1}] [:note {:pitch \"c4\" :cents 50 :dur 1}] [:note {:pitch 64.5 :dur 1}] [:note {:pitch \"g4\" :cents 14 :dur 1}]] [:measure [:note {:pitch \"a4\" :dur 4 :gliss [[0 0] [1 -150]]}]]])"
|
|
750
|
+
]
|
|
751
|
+
},
|
|
752
|
+
{
|
|
753
|
+
"title": {
|
|
754
|
+
"en": "Listening",
|
|
755
|
+
"es": "Escucharlo"
|
|
756
|
+
},
|
|
757
|
+
"note": {
|
|
758
|
+
"en": "Every view is the same tree, so they all sound the same. `mt play` keeps the last tree it receives and plays it on a bang. Its left outlet gives the frequencies of the notes sounding and its second outlet their voice ids: what `synth~` needs.\n\nA tree box has a second outlet as well: its notes as a **buffer** of strokes, for the right inlet of a `reader~`. Free time and measured time are both, in the end, frequency over time.",
|
|
759
|
+
"es": "Todas las vistas son el mismo árbol, así que todas suenan igual. `mt play` guarda el último árbol que recibe y lo toca con un bang. Su salida izquierda da las frecuencias de las notas que suenan y la segunda sus ids de voz: lo que necesita `synth~`.\n\nUna caja tree también tiene una segunda salida: sus notas como **búfer** de trazos, para la entrada derecha de un `reader~`. El tiempo libre y el tiempo medido son, al final, frecuencia en el tiempo."
|
|
760
|
+
},
|
|
761
|
+
"try": {
|
|
762
|
+
"en": "Start the engine with ▶ and click the bang. Then connect `:b4` or `:b9` to `mt play` instead of `:b1`, and listen.",
|
|
763
|
+
"es": "Pon en marcha el motor con ▶ y pulsa el bang. Después conecta `:b4` o `:b9` a `mt play` en lugar de `:b1`, y escucha."
|
|
764
|
+
},
|
|
765
|
+
"code": [
|
|
766
|
+
"(box :b10 \"bang\" 480 880)",
|
|
767
|
+
"(box :b11 \"mt play\" 540 880)",
|
|
768
|
+
"(box :b12 \"synth~\" 540 930)",
|
|
769
|
+
"(box :b13 \"dac~\" 540 980)",
|
|
770
|
+
"(connect :b1 0 :b11 0)",
|
|
771
|
+
"(connect :b10 0 :b11 0)",
|
|
772
|
+
"(connect :b11 0 :b12 0)",
|
|
773
|
+
"(connect :b11 1 :b12 1)",
|
|
774
|
+
"(connect :b12 0 :b13 0)",
|
|
775
|
+
"(connect :b12 0 :b13 1)"
|
|
776
|
+
]
|
|
777
|
+
},
|
|
778
|
+
{
|
|
779
|
+
"title": {
|
|
780
|
+
"en": "One, two, tree",
|
|
781
|
+
"es": "Uno, dos, tree"
|
|
782
|
+
},
|
|
783
|
+
"note": {
|
|
784
|
+
"en": "**One box**: `tree`, whose text opens from { }.\n\n**Two views**: a score and a roll of one tree, and every edit, in either of them or in the text, is one event of the history.\n\n**Tree**: and in it, two times. Measured (`:measure`, `:meter`, `:tuplet`, `:rtm`) and free (`[:par [:note {:at …}]]`). The score of free time is a quantized reading of it (alt-click, `division!`, `quant`). `quantize!` writes that reading into the tree, and `unquantize!` takes it back.\n\nAround it: `freqt`, the raw buffer of frequency over time, which `quantize` (a box, by a bang) or `to-tree!` turn into a tree. Names that stay as they were written, keys, `mt transpose M3`, `#` and shift-alt-click. And everything between the semitones: `:cents`, quarter tones, `:gliss`, tunings.\n\nThe full reference is in the Help tab, under **Musical trees**. The design behind it is discussed in issues #86 (quantization) and #88 (pitch spelling), and in discussion #92 (one box), on the GitHub of Kairotic.",
|
|
785
|
+
"es": "**Una caja**: `tree`, cuyo texto se abre desde { }.\n\n**Dos vistas**: una partitura y un roll de un mismo árbol, y cada edición, en cualquiera de ellas o en el texto, es un evento de la historia.\n\n**Tree**: y en él, dos tiempos. Medido (`:measure`, `:meter`, `:tuplet`, `:rtm`) y libre (`[:par [:note {:at …}]]`). La partitura del tiempo libre es una lectura cuantizada de él (alt-clic, `division!`, `quant`). `quantize!` escribe esa lectura en el árbol, y `unquantize!` la deshace.\n\nA su alrededor: `freqt`, el búfer crudo de frecuencia en el tiempo, que `quantize` (una caja, con un bang) o `to-tree!` vuelven árbol. Los nombres que se quedan como se escribieron, las tonalidades, `mt transpose M3`, `#` y shift-alt-clic. Y todo lo que hay entre los semitonos: `:cents`, cuartos de tono, `:gliss`, afinaciones.\n\nLa referencia completa está en la pestaña Ayuda, en **Árboles musicales**. El diseño que hay detrás se discute en los issues #86 (cuantización) y #88 (grafía de alturas), y en la discusión #92 (una caja), en el GitHub de Kairotic."
|
|
786
|
+
},
|
|
787
|
+
"try": {
|
|
788
|
+
"en": "",
|
|
789
|
+
"es": ""
|
|
790
|
+
},
|
|
791
|
+
"code": []
|
|
792
|
+
}
|
|
793
|
+
]
|
|
794
|
+
},
|
|
795
|
+
{
|
|
796
|
+
"id": "work-tree",
|
|
797
|
+
"track": "composition",
|
|
798
|
+
"order": 1,
|
|
799
|
+
"title": {
|
|
800
|
+
"en": "The work as a tree",
|
|
801
|
+
"es": "La obra como árbol"
|
|
802
|
+
},
|
|
803
|
+
"steps": [
|
|
804
|
+
{
|
|
805
|
+
"title": {
|
|
806
|
+
"en": "A work, written as data",
|
|
807
|
+
"es": "Una obra escrita como datos"
|
|
808
|
+
},
|
|
809
|
+
"note": {
|
|
810
|
+
"en": "A whole work can be one tree: a `:piece` holds `:section`s that follow one another, each section holds the `:voice`s that sound together, and a voice holds its measures. The score keeps one staff per voice, by name, from section to section.\n\nThe history of a tree box is made of **edits of nodes**: change one measure and only that measure changes in the history. That is what lets two people (or two of your own branches) work on different parts of the work and then bring them together.\n\nThe tree sends itself whenever it changes: the score follows it without ▶ and without a bang.",
|
|
811
|
+
"es": "Una obra entera puede ser un solo árbol: una `:piece` contiene `:section`s que se suceden, cada sección contiene las `:voice`s que suenan a la vez, y una voz contiene sus compases. La partitura mantiene un pentagrama por voz, por su nombre, de una sección a otra.\n\nLa historia de una caja tree está hecha de **ediciones de nodos**: cambia un compás y en la historia solo cambia ese compás. Eso permite que dos personas (o dos ramas tuyas) trabajen en partes distintas de la obra y luego las junten.\n\nEl árbol se envía solo cada vez que cambia: la partitura lo sigue sin ▶ y sin bang."
|
|
812
|
+
},
|
|
813
|
+
"try": {
|
|
814
|
+
"en": "",
|
|
815
|
+
"es": ""
|
|
816
|
+
},
|
|
817
|
+
"code": []
|
|
818
|
+
},
|
|
819
|
+
{
|
|
820
|
+
"title": {
|
|
821
|
+
"en": "Two sections, two voices",
|
|
822
|
+
"es": "Dos secciones, dos voces"
|
|
823
|
+
},
|
|
824
|
+
"note": {
|
|
825
|
+
"en": "Section A and section B, each with a flute and a cello. The score shows the whole work, with the name of each section over its first bar and a double bar between them.\n\nLook at the Code tab: the tree box is one call, `(tree! :b2 …)`, with the tree laid out one container per line.\n\nThe tree box is its own score: what you change on it are **edits** of the tree, one event of the history each.",
|
|
826
|
+
"es": "La sección A y la sección B, cada una con flauta y violonchelo. La partitura muestra toda la obra, con el nombre de cada sección sobre su primer compás y una doble barra entre ellas.\n\nMira la pestaña Code: la caja tree es una sola llamada, `(tree! :b2 …)`, con el árbol escrito un contenedor por línea.\n\nLa caja tree es su propia partitura: lo que cambias en ella son **ediciones** del árbol, un evento de la historia cada una."
|
|
827
|
+
},
|
|
828
|
+
"try": {
|
|
829
|
+
"en": "",
|
|
830
|
+
"es": ""
|
|
831
|
+
},
|
|
832
|
+
"code": [
|
|
833
|
+
"(box :b1 \"bang\" 40 20)",
|
|
834
|
+
"(box :b2 \"tree\" 40 60)",
|
|
835
|
+
"(tree! :b2 [:piece {:tempo 80} [:section {:name \"A\"} [:voice {:name \"fl\"} [:measure {:meter [3 4]} \"e5/1 d5 c5\"] [:measure \"d5/2 g4/1\"]] [:voice {:name \"vc\"} [:measure \"c3/3\"] [:measure \"g2/3\"]]] [:section {:name \"B\"} [:voice {:name \"fl\"} [:measure \"e5/.5 f5 g5/2\"] [:measure \"c5/3\"]] [:voice {:name \"vc\"} [:measure \"a2/3\"] [:measure \"c3/3\"]]]])",
|
|
836
|
+
"(resize :b2 560 260)",
|
|
837
|
+
"(connect :b1 0 :b2 0)"
|
|
838
|
+
]
|
|
839
|
+
},
|
|
840
|
+
{
|
|
841
|
+
"title": {
|
|
842
|
+
"en": "Editing one node",
|
|
843
|
+
"es": "Editar un nodo"
|
|
844
|
+
},
|
|
845
|
+
"note": {
|
|
846
|
+
"en": "A **path** says where a node is: the list of child indices from the root. `[1 0 0 0]` is: section B (1), its flute (0), its first measure (0), and the melody inside it (0).\n\n`(tree-edit! :b2 [:set [1 0 0 0] \"e5/.5 f5 g5 a5 b5/1\"])` replaces just that melody. In the history it is one event, and the REPL shows it as you see it here. The other operations are `[:attrs path {…}]`, `[:insert path node]` and `[:remove path]`.",
|
|
847
|
+
"es": "Un **camino** dice dónde está un nodo: la lista de índices de hijos desde la raíz. `[1 0 0 0]` es: la sección B (1), su flauta (0), su primer compás (0) y la melodía que contiene (0).\n\n`(tree-edit! :b2 [:set [1 0 0 0] \"e5/.5 f5 g5 a5 b5/1\"])` sustituye solo esa melodía. En la historia es un evento, y la REPL lo muestra tal como lo ves aquí. Las otras operaciones son `[:attrs camino {…}]`, `[:insert camino nodo]` y `[:remove camino]`."
|
|
848
|
+
},
|
|
849
|
+
"try": {
|
|
850
|
+
"en": "The score already shows the change. Double-click the tree box, change a note in its text and apply with Ctrl+Enter: the REPL shows that it became a `tree!`, and the history only keeps the node that changed.",
|
|
851
|
+
"es": "La partitura ya muestra el cambio. Haz doble clic en la caja tree, cambia una nota en su texto y aplica con Ctrl+Intro: la REPL muestra que se convirtió en un `tree!`, y la historia solo guarda el nodo que cambió."
|
|
852
|
+
},
|
|
853
|
+
"code": [
|
|
854
|
+
"(tree-edit! :b2 [:set [1 0 0 0] \"e5/.5 f5 g5 a5 b5/1\"])"
|
|
855
|
+
]
|
|
856
|
+
},
|
|
857
|
+
{
|
|
858
|
+
"title": {
|
|
859
|
+
"en": "Editing from the score",
|
|
860
|
+
"es": "Editar desde la partitura"
|
|
861
|
+
},
|
|
862
|
+
"note": {
|
|
863
|
+
"en": "In a score that shows a tree, **click a note**: it is selected. Then:\n\n↑ ↓ change its pitch (⇧ an octave) · **+** **−** double or halve its duration · ← → select the previous or next note · a…g the nearest note of that name · **Delete** turns it into a rest · Esc deselects. A rest can be selected too: **Enter** makes it a note again (the pitch of the note before it), ↑ ↓ a step above or below.\n\nEach change is an edit of the tree's nodes, a `(tree-edit! …)`: you can see it in the REPL and in the history, and the score shows the tree changed. A note written inside a melody string is first written out as notes, in the same event.",
|
|
864
|
+
"es": "En una partitura que muestra un árbol, **haz clic en una nota**: queda seleccionada. Después:\n\n↑ ↓ cambian su altura (⇧ una octava) · **+** **−** duplican o dividen su duración · ← → seleccionan la nota anterior o la siguiente · a…g la nota más cercana con ese nombre · **Supr** la convierte en silencio · Esc quita la selección. También se puede seleccionar un silencio: **Intro** lo vuelve nota (la altura de la nota anterior), ↑ ↓ un paso por encima o por debajo.\n\nCada cambio es una edición de los nodos del árbol, un `(tree-edit! …)`: lo ves en la REPL y en la historia, y la partitura muestra el árbol cambiado. Una nota escrita dentro de un texto de melodía se escribe primero como notas, en el mismo evento."
|
|
865
|
+
},
|
|
866
|
+
"try": {
|
|
867
|
+
"en": "Change the cello's last note of section A with ↑ ↓, and halve a flute note with −: the score warns (⚠ in the REPL) that its measure no longer adds up, until you fix it.",
|
|
868
|
+
"es": "Cambia con ↑ ↓ la última nota del violonchelo en la sección A, y divide una nota de la flauta con −: la partitura avisa (⚠ en la REPL) de que su compás ya no cuadra, hasta que lo arregles."
|
|
869
|
+
},
|
|
870
|
+
"code": []
|
|
871
|
+
},
|
|
872
|
+
{
|
|
873
|
+
"title": {
|
|
874
|
+
"en": "Branches that merge",
|
|
875
|
+
"es": "Ramas que se funden"
|
|
876
|
+
},
|
|
877
|
+
"note": {
|
|
878
|
+
"en": "Because the history keeps edits of nodes, branches that change **different nodes** can be merged.\n\nTry it: go back one step in the history (◀ in the History pane), change the cello of section B from the score, and a branch of your own grows. Then press **Merge…** and click the tip of the other branch: both changes end up in one tree. If both branches changed the same measure (or one changed a measure and the other something inside it), the merge says which node they both touched.",
|
|
879
|
+
"es": "Como la historia guarda ediciones de nodos, las ramas que cambian **nodos distintos** se pueden fundir.\n\nPruébalo: retrocede un paso en la historia (◀ en el panel History), cambia desde la partitura el violonchelo de la sección B, y crece una rama tuya. Después pulsa **Merge…** y haz clic en el extremo de la otra rama: los dos cambios quedan en un solo árbol. Si las dos ramas cambiaron el mismo compás (o una un compás y la otra algo dentro de él), la fusión dice qué nodo tocaron ambas."
|
|
880
|
+
},
|
|
881
|
+
"try": {
|
|
882
|
+
"en": "",
|
|
883
|
+
"es": ""
|
|
884
|
+
},
|
|
885
|
+
"code": []
|
|
886
|
+
},
|
|
887
|
+
{
|
|
888
|
+
"title": {
|
|
889
|
+
"en": "A fragment, reused",
|
|
890
|
+
"es": "Un fragmento reutilizado"
|
|
891
|
+
},
|
|
892
|
+
"note": {
|
|
893
|
+
"en": "This step adds two things in one event: a fragment `:cell` in the `:defs` of the piece, and a section C that uses it twice, the second time a fourth lower: `[:use {:ref :cell :transpose -5}]`.\n\nNotes that come from a fragment are not edited from the score (they are the fragment's): change the definition and every use changes with it.",
|
|
894
|
+
"es": "Este paso añade dos cosas en un evento: un fragmento `:cell` en los `:defs` de la pieza, y una sección C que lo usa dos veces, la segunda una cuarta más abajo: `[:use {:ref :cell :transpose -5}]`.\n\nLas notas que vienen de un fragmento no se editan desde la partitura (son del fragmento): cambia la definición y cambian todos sus usos."
|
|
895
|
+
},
|
|
896
|
+
"try": {
|
|
897
|
+
"en": "Click `(tree-edit! :b2 [:attrs [] {:tempo 80 :defs {:cell \"g5/.5 f5 e5/2\"}}])`, and press Enter in the REPL: section C changes at once.",
|
|
898
|
+
"es": "Haz clic en `(tree-edit! :b2 [:attrs [] {:tempo 80 :defs {:cell \"g5/.5 f5 e5/2\"}}])` y pulsa Intro en la REPL: la sección C cambia al momento."
|
|
899
|
+
},
|
|
900
|
+
"code": [
|
|
901
|
+
"(tree-edit! :b2 [:attrs [] {:tempo 80 :defs {:cell \"e5/.5 d5 c5/2\"}}] [:insert [2] [:section {:name \"C\"} [:voice {:name \"fl\"} [:measure [:use {:ref :cell}]] [:measure [:use {:ref :cell :transpose -5}]]] [:voice {:name \"vc\"} [:measure \"c3/3\"] [:measure \"c3/3\"]]]])"
|
|
902
|
+
]
|
|
903
|
+
},
|
|
904
|
+
{
|
|
905
|
+
"title": {
|
|
906
|
+
"en": "What next",
|
|
907
|
+
"es": "Y ahora"
|
|
908
|
+
},
|
|
909
|
+
"note": {
|
|
910
|
+
"en": "A work is now a tree you can write as text, edit node by node from the REPL or the score, transform with the `mt` boxes, play with `mt play`, and share in a room where each person's edits are nodes of the same history.\n\nThe format is described in the guide *Musical trees* (`docs/mt.md`); the tutorial *A motif and its transformations* shows the `mt` boxes.",
|
|
911
|
+
"es": "Una obra es ahora un árbol que puedes escribir como texto, editar nodo a nodo desde la REPL o la partitura, transformar con las cajas `mt`, tocar con `mt play` y compartir en una sala donde las ediciones de cada persona son nodos de la misma historia.\n\nEl formato está descrito en la guía *Árboles musicales* (`docs/mt.es.md`); el tutorial *Un motivo y sus transformaciones* muestra las cajas `mt`."
|
|
912
|
+
},
|
|
913
|
+
"try": {
|
|
914
|
+
"en": "",
|
|
915
|
+
"es": ""
|
|
916
|
+
},
|
|
917
|
+
"code": []
|
|
918
|
+
}
|
|
919
|
+
]
|
|
920
|
+
},
|
|
921
|
+
{
|
|
922
|
+
"id": "presets",
|
|
923
|
+
"track": "composition",
|
|
924
|
+
"order": 2,
|
|
925
|
+
"title": {
|
|
926
|
+
"en": "Presets: recall, morph, generate",
|
|
927
|
+
"es": "Presets: recuperar, transformar, generar"
|
|
928
|
+
},
|
|
929
|
+
"steps": [
|
|
930
|
+
{
|
|
931
|
+
"title": {
|
|
932
|
+
"en": "An instrument to play",
|
|
933
|
+
"es": "Un instrumento para tocar"
|
|
934
|
+
},
|
|
935
|
+
"note": {
|
|
936
|
+
"en": "A small FM synthesizer in Faust with a pulse that cuts it rhythmically. Three knobs drive it by name: **strobe** (how fast the pulse beats, on a log scale), **index** (how bright the FM is) and **duty** (how long each pulse stays open). Each knob sends `[:name value]` to the left inlet of `faust~`; the keyboard sends the notes.\n\nA knob keeps its value **in its text**: `knob 0.5 50 2 log strobe` is at 2. That is what makes it part of a preset.",
|
|
937
|
+
"es": "Un pequeño sintetizador FM en Faust con un pulso que lo corta rítmicamente. Tres knobs lo controlan por nombre: **strobe** (lo rápido que late el pulso, en escala logarítmica), **index** (el brillo de la FM) y **duty** (cuánto queda abierto cada pulso). Cada knob envía `[:nombre valor]` a la entrada izquierda de `faust~`; el teclado envía las notas.\n\nUn knob guarda su valor **en su texto**: `knob 0.5 50 2 log strobe` está en 2. Eso es lo que lo hace parte de un preset."
|
|
938
|
+
},
|
|
939
|
+
"try": {
|
|
940
|
+
"en": "Press ▶ and play the keyboard; turn the knobs.",
|
|
941
|
+
"es": "Pulsa ▶ y toca el teclado; gira los knobs."
|
|
942
|
+
},
|
|
943
|
+
"code": [
|
|
944
|
+
"(box :b9 \"faust~\" 146 265)",
|
|
945
|
+
"(code :b9 \"import(\\\"stdfaust.lib\\\");\\nfreq = hslider(\\\"freq\\\", 220, 20, 2000, 0.01) : si.smoo;\\ngate = hslider(\\\"gate\\\", 0, 0, 127, 1) > 0;\\nratio = hslider(\\\"ratio\\\", 2, 0.5, 8, 0.01) : si.smoo;\\nindex = hslider(\\\"index\\\", 3, 0, 12, 0.01) : si.smoo;\\nstrobe = hslider(\\\"strobe\\\", 8, 0.5, 40, 0.01) : si.smoo;\\nduty = hslider(\\\"duty\\\", 0.4, 0.05, 0.95, 0.01) : si.smoo;\\natk = hslider(\\\"attack\\\", 0.01, 0.001, 1, 0.001);\\nrel = hslider(\\\"release\\\", 0.3, 0.01, 3, 0.001);\\nenv = gate : en.adsr(atk, 0.1, 0.8, rel);\\npulse = (os.lf_saw(strobe) < duty) : si.smooth(0.995);\\nmod = os.osc(freq*ratio) * freq * ratio * index * (0.3 + pulse);\\ncar = os.osc(freq + mod);\\nprocess = car * env * pulse * 0.5 <: _,_;\")",
|
|
946
|
+
"(box :b10 \"gain~ 0.2\" 226 532)",
|
|
947
|
+
"(box :b11 \"dac~ 1 2\" 226 592)",
|
|
948
|
+
"(box :b15 \"knob 0.05 0.95 0.8 duty\" 96 136)",
|
|
949
|
+
"(box :b14 \"knob 0 12 1 index\" 179 137)",
|
|
950
|
+
"(box :b13 \"knob 0.5 50 2 log strobe\" 262 136)",
|
|
951
|
+
"(box :b20 \"keyboard\" 461 100)",
|
|
952
|
+
"(connect :b9 0 :b10 0)",
|
|
953
|
+
"(connect :b9 1 :b10 0)",
|
|
954
|
+
"(connect :b10 0 :b11 0)",
|
|
955
|
+
"(connect :b10 0 :b11 1)",
|
|
956
|
+
"(connect :b13 0 :b9 0)",
|
|
957
|
+
"(connect :b14 0 :b9 0)",
|
|
958
|
+
"(connect :b15 0 :b9 0)",
|
|
959
|
+
"(connect :b20 0 :b9 0)"
|
|
960
|
+
]
|
|
961
|
+
},
|
|
962
|
+
{
|
|
963
|
+
"title": {
|
|
964
|
+
"en": "Three keyframes",
|
|
965
|
+
"es": "Tres fotogramas clave"
|
|
966
|
+
},
|
|
967
|
+
"note": {
|
|
968
|
+
"en": "**◆ Snapshot** keeps the work as it is now: a keyframe, a square in the history. Here are three, made one after the other: `calm` (slow pulse, soft FM), `pulse` and `storm` (fast pulse, bright FM). Between them only the knobs changed.\n\nEvery keyframe is also a **preset**: the text of every box at that moment. They are numbered in order: calm is 1, pulse 2, storm 3. `(keyframes)` in the REPL lists them.",
|
|
969
|
+
"es": "**◆ Snapshot** guarda la obra tal como está ahora: un fotograma clave, un cuadrado en la historia. Aquí hay tres, hechos uno tras otro: `calm` (pulso lento, FM suave), `pulse` y `storm` (pulso rápido, FM brillante). Entre ellos solo cambiaron los knobs.\n\nCada fotograma es también un **preset**: el texto de cada caja en ese momento. Se numeran por orden: calm es 1, pulse 2, storm 3. `(keyframes)` en la REPL los lista."
|
|
970
|
+
},
|
|
971
|
+
"try": {
|
|
972
|
+
"en": "",
|
|
973
|
+
"es": ""
|
|
974
|
+
},
|
|
975
|
+
"code": [
|
|
976
|
+
"(snapshot \"calm\")",
|
|
977
|
+
"(text! :b13 \"knob 0.5 50 8 log strobe\")",
|
|
978
|
+
"(text! :b14 \"knob 0 12 5 index\")",
|
|
979
|
+
"(text! :b15 \"knob 0.05 0.95 0.5 duty\")",
|
|
980
|
+
"(snapshot \"pulse\")",
|
|
981
|
+
"(text! :b13 \"knob 0.5 50 32 log strobe\")",
|
|
982
|
+
"(text! :b14 \"knob 0 12 11 index\")",
|
|
983
|
+
"(text! :b15 \"knob 0.05 0.95 0.15 duty\")",
|
|
984
|
+
"(snapshot \"storm\")"
|
|
985
|
+
]
|
|
986
|
+
},
|
|
987
|
+
{
|
|
988
|
+
"title": {
|
|
989
|
+
"en": "Recall",
|
|
990
|
+
"es": "Recuperar"
|
|
991
|
+
},
|
|
992
|
+
"note": {
|
|
993
|
+
"en": "A `presets` box plays the keyframes. A number on its left inlet **recalls** one: every box takes its text of then, and the knobs send their values to the synth. It is one event of the history, so one Ctrl+Z undoes it. A label works too: a `msg :calm`.\n\nBoxes added since a keyframe (this presets box, these messages) stay as they are: a preset never rebuilds the patch.",
|
|
994
|
+
"es": "Una caja `presets` toca los fotogramas. Un número en su entrada izquierda **recupera** uno: cada caja toma su texto de entonces, y los knobs envían sus valores al sintetizador. Es un solo evento de la historia, así que un Ctrl+Z lo deshace. También sirve una etiqueta: un `msg :calm`.\n\nLas cajas añadidas después de un fotograma (esta caja presets, estos mensajes) quedan como están: un preset nunca reconstruye el patch."
|
|
995
|
+
},
|
|
996
|
+
"try": {
|
|
997
|
+
"en": "With ▶ on and a key held (⇧-click keeps it), click 1, 2 and 3.",
|
|
998
|
+
"es": "Con ▶ y una nota sostenida (⇧-clic la mantiene), haz clic en 1, 2 y 3."
|
|
999
|
+
},
|
|
1000
|
+
"code": [
|
|
1001
|
+
"(box :b18 \"presets\" 538 408)",
|
|
1002
|
+
"(box :b23 \"msg 1\" 542 304)",
|
|
1003
|
+
"(box :b24 \"msg 2\" 586 303)",
|
|
1004
|
+
"(box :b25 \"msg 3\" 631 303)",
|
|
1005
|
+
"(connect :b23 0 :b18 0)",
|
|
1006
|
+
"(connect :b24 0 :b18 0)",
|
|
1007
|
+
"(connect :b25 0 :b18 0)"
|
|
1008
|
+
]
|
|
1009
|
+
},
|
|
1010
|
+
{
|
|
1011
|
+
"title": {
|
|
1012
|
+
"en": "Morph",
|
|
1013
|
+
"es": "Transformar"
|
|
1014
|
+
},
|
|
1015
|
+
"note": {
|
|
1016
|
+
"en": "A position on the **right** inlet morphs between keyframes: 1.5 is halfway from calm to pulse, 2.5 halfway from pulse to storm. The knobs move as messages, as when you drag them (strobe geometrically, since its knob is `log`); the knob that drives the morph is left alone.\n\nNothing is written while you morph: `:keep` writes the knobs where they are, as one event.",
|
|
1017
|
+
"es": "Una posición en la entrada **derecha** transforma entre fotogramas: 1.5 es la mitad entre calm y pulse, 2.5 la mitad entre pulse y storm. Los knobs se mueven como mensajes, igual que al arrastrarlos (strobe de forma geométrica, porque su knob es `log`); el knob que conduce la transformación no se mueve.\n\nMientras transformas no se escribe nada: `:keep` escribe los knobs donde están, como un evento."
|
|
1018
|
+
},
|
|
1019
|
+
"try": {
|
|
1020
|
+
"en": "Drag the knob on the right slowly from 1 to 3 while a note sounds. Stop somewhere you like and click keep.",
|
|
1021
|
+
"es": "Arrastra despacio el knob de la derecha de 1 a 3 mientras suena una nota. Para donde te guste y haz clic en keep."
|
|
1022
|
+
},
|
|
1023
|
+
"code": [
|
|
1024
|
+
"(box :b21 \"knob 1 3 1\" 705 308)",
|
|
1025
|
+
"(box :b27 \"msg :keep\" 640 250)",
|
|
1026
|
+
"(connect :b21 0 :b18 1)",
|
|
1027
|
+
"(connect :b27 0 :b18 0)"
|
|
1028
|
+
]
|
|
1029
|
+
},
|
|
1030
|
+
{
|
|
1031
|
+
"title": {
|
|
1032
|
+
"en": "A new preset",
|
|
1033
|
+
"es": "Un preset nuevo"
|
|
1034
|
+
},
|
|
1035
|
+
"note": {
|
|
1036
|
+
"en": "A **bang** generates a preset from what changes and what remains: what is the same in every keyframe stays (the synth, the gain, the range of each knob), and each value that changes takes a new one within the range the keyframes span. `[:generate 42]` gives the same one every time.\n\nIf you like what you hear, ◆ Snapshot keeps it: it becomes keyframe 4.",
|
|
1037
|
+
"es": "Un **bang** genera un preset a partir de lo que cambia y lo que permanece: lo que es igual en todos los fotogramas se queda (el sintetizador, la ganancia, el rango de cada knob), y cada valor que cambia toma uno nuevo dentro del rango que abarcan los fotogramas. `[:generate 42]` da siempre el mismo.\n\nSi te gusta lo que oyes, ◆ Snapshot lo guarda: se convierte en el fotograma 4."
|
|
1038
|
+
},
|
|
1039
|
+
"try": {
|
|
1040
|
+
"en": "Click the bang a few times while a note sounds.",
|
|
1041
|
+
"es": "Haz clic en el bang varias veces mientras suena una nota."
|
|
1042
|
+
},
|
|
1043
|
+
"code": [
|
|
1044
|
+
"(box :b26 \"bang\" 542 250)",
|
|
1045
|
+
"(connect :b26 0 :b18 0)"
|
|
1046
|
+
]
|
|
1047
|
+
},
|
|
1048
|
+
{
|
|
1049
|
+
"title": {
|
|
1050
|
+
"en": "A panel to perform",
|
|
1051
|
+
"es": "Un panel para tocar"
|
|
1052
|
+
},
|
|
1053
|
+
"note": {
|
|
1054
|
+
"en": "For a performer, only the controls matter. Select the boxes you want (a frame drawn around them, or ⇧+click) and press **Present**: it asks whether to present the selection, and puts each box where it is in the patch. Here it is already done, with `(present-in-place …)`.\n\nPressing **Edit** brings the whole patch back. You can also play the panel in **Perform**: what the presets change there goes to the take, not to the history.",
|
|
1055
|
+
"es": "Para quien toca, solo importan los controles. Selecciona las cajas que quieras (un marco a su alrededor, o ⇧+clic) y pulsa **Present**: pregunta si presentar la selección, y pone cada caja donde está en el patch. Aquí ya está hecho, con `(present-in-place …)`.\n\n**Edit** devuelve el patch entero. También puedes tocar el panel en **Perform**: lo que cambian los presets allí va a la toma, no a la historia."
|
|
1056
|
+
},
|
|
1057
|
+
"try": {
|
|
1058
|
+
"en": "Press Present and play the panel: keyboard, knobs, 1 2 3, the morph knob and the bang.",
|
|
1059
|
+
"es": "Pulsa Present y toca el panel: teclado, knobs, 1 2 3, el knob de transformación y el bang."
|
|
1060
|
+
},
|
|
1061
|
+
"code": [
|
|
1062
|
+
"(present-in-place :b13 :b14 :b15 :b20 :b21 :b23 :b24 :b25 :b26 :b27)"
|
|
1063
|
+
]
|
|
1064
|
+
}
|
|
1065
|
+
]
|
|
1066
|
+
},
|
|
1067
|
+
{
|
|
1068
|
+
"id": "patterns",
|
|
1069
|
+
"track": "composition",
|
|
1070
|
+
"order": 3,
|
|
1071
|
+
"title": {
|
|
1072
|
+
"en": "Patterns: play them, draw them",
|
|
1073
|
+
"es": "Patterns: tocarlos, dibujarlos"
|
|
1074
|
+
},
|
|
1075
|
+
"steps": [
|
|
1076
|
+
{
|
|
1077
|
+
"title": {
|
|
1078
|
+
"en": "A pattern and a player",
|
|
1079
|
+
"es": "Un pattern y un player"
|
|
1080
|
+
},
|
|
1081
|
+
"note": {
|
|
1082
|
+
"en": "A **pattern** is a sequence of events, each a map of keys: `{:degree 2 :dur 0.5}`. A `pbind` writes one as data: every key holds a constant, a vector (a sequence) or a generator. Here `:degree` goes through four steps of the major scale, each lasting half a beat.\n\nThe `pbind` sends its pattern to the **right** inlet of a `player`. The **left** inlet says how time moves: `:start` and `:stop` use its own clock (`player 110`: 110 beats per minute). It sends the Hz of the notes and their voice ids to `synth~`, which plays them.\n\nWhat travels is the **source** and a **seed**, not the notes: every tab makes the same events from them.",
|
|
1083
|
+
"es": "Un **pattern** es una secuencia de eventos, cada uno un mapa de claves: `{:degree 2 :dur 0.5}`. Un `pbind` lo escribe como datos: cada clave tiene una constante, un vector (una secuencia) o un generador. Aquí `:degree` recorre cuatro grados de la escala mayor, de medio beat cada uno.\n\nEl `pbind` envía su pattern a la entrada **derecha** de un `player`. La **izquierda** dice cómo se mueve el tiempo: `:start` y `:stop` usan su propio reloj (`player 110`: 110 pulsos por minuto). Envía los Hz de las notas y sus ids de voz a `synth~`, que las toca.\n\nLo que viaja es la **fuente** y una **semilla**, no las notas: cada pestaña hace los mismos eventos a partir de ellas."
|
|
1084
|
+
},
|
|
1085
|
+
"try": {
|
|
1086
|
+
"en": "Press ▶, then click `:start`. Double-click the pbind, change a degree, and apply (Ctrl+Enter): the player goes on with it from the same beat.",
|
|
1087
|
+
"es": "Pulsa ▶ y luego haz clic en `:start`. Haz doble clic en el pbind, cambia un grado y aplica (Ctrl+Enter): el player sigue con él desde el mismo beat."
|
|
1088
|
+
},
|
|
1089
|
+
"code": [
|
|
1090
|
+
"(box :b1 \"pbind 1 loop\" 40 40)",
|
|
1091
|
+
"(code :b1 \"{:degree [0 2 4 7]\\n :dur 0.5}\")",
|
|
1092
|
+
"(box :b2 \"msg :start\" 40 170)",
|
|
1093
|
+
"(box :b3 \"msg :stop\" 120 170)",
|
|
1094
|
+
"(box :b4 \"player 110\" 40 220)",
|
|
1095
|
+
"(box :b5 \"synth~\" 40 290)",
|
|
1096
|
+
"(box :b6 \"dac~\" 40 350)",
|
|
1097
|
+
"(connect :b2 0 :b4 0)",
|
|
1098
|
+
"(connect :b3 0 :b4 0)",
|
|
1099
|
+
"(connect :b1 0 :b4 1)",
|
|
1100
|
+
"(connect :b4 0 :b5 0)",
|
|
1101
|
+
"(connect :b4 1 :b5 1)",
|
|
1102
|
+
"(connect :b5 0 :b6 0)",
|
|
1103
|
+
"(connect :b5 0 :b6 1)"
|
|
1104
|
+
]
|
|
1105
|
+
},
|
|
1106
|
+
{
|
|
1107
|
+
"title": {
|
|
1108
|
+
"en": "Sequences of different lengths",
|
|
1109
|
+
"es": "Secuencias de distinta longitud"
|
|
1110
|
+
},
|
|
1111
|
+
"note": {
|
|
1112
|
+
"en": "When keys hold sequences of different lengths, the shorter ones **start again** until the longest ends: four degrees against three durations make a figure that shifts against itself, a small polymeter. `:rest` (or `nil`) is a silence.\n\n`:amp` (0…1) is the loudness of each note: the player sends it to `synth~` just before the note.",
|
|
1113
|
+
"es": "Cuando las claves tienen secuencias de distinta longitud, las más cortas **vuelven a empezar** hasta que acaba la más larga: cuatro grados contra tres duraciones dan una figura que se desplaza sobre sí misma, una pequeña polimetría. `:rest` (o `nil`) es un silencio.\n\n`:amp` (0…1) es la intensidad de cada nota: el player se la envía a `synth~` justo antes de la nota."
|
|
1114
|
+
},
|
|
1115
|
+
"try": {
|
|
1116
|
+
"en": "Listen for where the figure meets itself again. Put another `:rest` in `:degree`.",
|
|
1117
|
+
"es": "Escucha dónde vuelve a coincidir la figura. Pon otro `:rest` en `:degree`."
|
|
1118
|
+
},
|
|
1119
|
+
"code": [
|
|
1120
|
+
"(code :b1 \"{:degree [0 2 4 :rest 7]\\n :dur [0.5 0.25 0.25]\\n :amp [0.8 0.3 0.5]}\")"
|
|
1121
|
+
]
|
|
1122
|
+
},
|
|
1123
|
+
{
|
|
1124
|
+
"title": {
|
|
1125
|
+
"en": "Chance, the same for everyone",
|
|
1126
|
+
"es": "Azar, el mismo para todos"
|
|
1127
|
+
},
|
|
1128
|
+
"note": {
|
|
1129
|
+
"en": "A **generator** is written `#pat/…`. `#pat/shuffle` plays its values in a new order every pass; `#pat/white [lo hi]` picks a number between two. Their randomness comes from the **seed**, the number after `pbind`, and every key has a seed of its own, so changing `:dur` leaves the chance of `:amp` as it was.\n\nSame seed, same music: for everyone in a room, and again whenever you go back in the history.",
|
|
1130
|
+
"es": "Un **generador** se escribe `#pat/…`. `#pat/shuffle` toca sus valores en un orden nuevo en cada vuelta; `#pat/white [lo hi]` elige un número entre dos. Su azar viene de la **semilla**, el número que sigue a `pbind`, y cada clave tiene su propia semilla, así que cambiar `:dur` deja como estaba el azar de `:amp`.\n\nMisma semilla, misma música: para todos en una sala, y otra vez cada vez que vuelves atrás en la historia."
|
|
1131
|
+
},
|
|
1132
|
+
"try": {
|
|
1133
|
+
"en": "Change the seed (`pbind 2 loop`): other orders. Change it back to 1: the same as before.",
|
|
1134
|
+
"es": "Cambia la semilla (`pbind 2 loop`): otros órdenes. Vuelve a 1: lo mismo que antes."
|
|
1135
|
+
},
|
|
1136
|
+
"code": [
|
|
1137
|
+
"(code :b1 \"{:degree #pat/shuffle [0 2 4 7 9]\\n :dur [0.5 0.25 0.25]\\n :amp #pat/white [0.2 0.9]}\")"
|
|
1138
|
+
]
|
|
1139
|
+
},
|
|
1140
|
+
{
|
|
1141
|
+
"title": {
|
|
1142
|
+
"en": "Harmony that follows time",
|
|
1143
|
+
"es": "Armonía que sigue al tiempo"
|
|
1144
|
+
},
|
|
1145
|
+
"note": {
|
|
1146
|
+
"en": "`#pat/hold [4 [:c :f :g :c]]` gives one value **every 4 beats**, whatever the rhythm: here the root of the scale changes every bar while the figure keeps shuffling over it. `:scale` can be a name (`:dorian`, `:minor-pentatonic`…) or a vector of semitones, fractional for microtones.",
|
|
1147
|
+
"es": "`#pat/hold [4 [:c :f :g :c]]` da un valor **cada 4 beats**, sea cual sea el ritmo: aquí la tónica de la escala cambia cada compás mientras la figura se sigue barajando encima. `:scale` puede ser un nombre (`:dorian`, `:minor-pentatonic`…) o un vector de semitonos, con decimales para microtonos."
|
|
1148
|
+
},
|
|
1149
|
+
"try": {
|
|
1150
|
+
"en": "Try `:scale :dorian`, then `:scale [0 2.5 5 7 9.5]`.",
|
|
1151
|
+
"es": "Prueba `:scale :dorian` y luego `:scale [0 2.5 5 7 9.5]`."
|
|
1152
|
+
},
|
|
1153
|
+
"code": [
|
|
1154
|
+
"(code :b1 \"{:degree #pat/shuffle [0 2 4 7 9]\\n :dur [0.5 0.25 0.25]\\n :amp #pat/white [0.2 0.9]\\n :root #pat/hold [4 [:c :f :g :c]]\\n :scale :major}\")"
|
|
1155
|
+
]
|
|
1156
|
+
},
|
|
1157
|
+
{
|
|
1158
|
+
"title": {
|
|
1159
|
+
"en": "Step by step",
|
|
1160
|
+
"es": "Paso a paso"
|
|
1161
|
+
},
|
|
1162
|
+
"note": {
|
|
1163
|
+
"en": "A **bang** on the left of the player plays the next event **now**, whatever its `:dur`. The pattern follows whatever moves it: a `metro`, an `onset~` of what someone plays, a key. The rhythm is no longer in the pattern but in the hand.",
|
|
1164
|
+
"es": "Un **bang** a la izquierda del player toca el siguiente evento **ahora**, sea cual sea su `:dur`. El pattern sigue a lo que lo mueva: un `metro`, un `onset~` de lo que alguien toca, una tecla. El ritmo ya no está en el pattern sino en la mano."
|
|
1165
|
+
},
|
|
1166
|
+
"try": {
|
|
1167
|
+
"en": "Click `:stop`, then `1` to start the metro: one note every 300 ms. Click `0`, then the bang yourself.",
|
|
1168
|
+
"es": "Haz clic en `:stop` y luego en `1` para arrancar el metro: una nota cada 300 ms. Haz clic en `0` y luego en el bang tú."
|
|
1169
|
+
},
|
|
1170
|
+
"code": [
|
|
1171
|
+
"(box :b7 \"msg 1\" 220 120)",
|
|
1172
|
+
"(box :b8 \"msg 0\" 270 120)",
|
|
1173
|
+
"(box :b9 \"metro 300\" 220 170)",
|
|
1174
|
+
"(box :b10 \"bang\" 330 170)",
|
|
1175
|
+
"(connect :b7 0 :b9 0)",
|
|
1176
|
+
"(connect :b8 0 :b9 0)",
|
|
1177
|
+
"(connect :b9 0 :b4 0)",
|
|
1178
|
+
"(connect :b10 0 :b4 0)"
|
|
1179
|
+
]
|
|
1180
|
+
},
|
|
1181
|
+
{
|
|
1182
|
+
"title": {
|
|
1183
|
+
"en": "At a position, either way",
|
|
1184
|
+
"es": "En una posición, en ambos sentidos"
|
|
1185
|
+
},
|
|
1186
|
+
"note": {
|
|
1187
|
+
"en": "A **number** on the left of the player is a position in beats, as a `reader` reads a buffer. Every event is a **span**, from its onset to its end, and sounds while the position is inside it. A `ramp` moves through it: going up, each note starts at its onset; **going down, each note starts from its end**, and the phrase comes out backwards.\n\nThe wrap of a looping ramp, a step far larger than the ones before, is a **jump**: the player goes there at once, without sounding what is in between.",
|
|
1188
|
+
"es": "Un **número** a la izquierda del player es una posición en beats, como un `reader` lee un buffer. Cada evento es un **tramo**, de su inicio a su final, y suena mientras la posición está dentro. Un `ramp` se mueve por ella: al subir, cada nota empieza en su inicio; **al bajar, cada nota empieza por su final**, y la frase sale al revés.\n\nLa vuelta de un ramp en bucle, un paso mucho mayor que los anteriores, es un **salto**: el player va allí de golpe, sin hacer sonar lo que hay en medio."
|
|
1189
|
+
},
|
|
1190
|
+
"try": {
|
|
1191
|
+
"en": "Stop the metro (`0`) and click the bang above the ramp: eight beats in four seconds. Then write `ramp 8 0 4 loop` in the ramp: backwards.",
|
|
1192
|
+
"es": "Para el metro (`0`) y haz clic en el bang sobre el ramp: ocho beats en cuatro segundos. Luego escribe `ramp 8 0 4 loop` en el ramp: al revés."
|
|
1193
|
+
},
|
|
1194
|
+
"code": [
|
|
1195
|
+
"(box :b11 \"bang\" 420 120)",
|
|
1196
|
+
"(box :b12 \"ramp 0 8 4 loop\" 420 170)",
|
|
1197
|
+
"(connect :b11 0 :b12 0)",
|
|
1198
|
+
"(connect :b12 0 :b4 0)"
|
|
1199
|
+
]
|
|
1200
|
+
},
|
|
1201
|
+
{
|
|
1202
|
+
"title": {
|
|
1203
|
+
"en": "Drawing it",
|
|
1204
|
+
"es": "Dibujarlo"
|
|
1205
|
+
},
|
|
1206
|
+
"note": {
|
|
1207
|
+
"en": "`render 0 8` works out at once what a player would play from beat 0 to beat 8, and sends it to a `freqt` as a musical tree: you **see** the pattern. Each note is as thick as its `:amp`; a `:pan` would shade it from one edge to the other.\n\nThe drawing follows the pbind while you edit it. To keep it, write `(keep! :b14)` in the REPL: it is written into the freqt as one event of the history, with its **recipe** beside it (the pbind, the seed, the render), so `(remake! :b14)` can make it again after you edit it by hand.",
|
|
1208
|
+
"es": "`render 0 8` calcula de una vez lo que un player tocaría del beat 0 al 8, y lo envía a un `freqt` como árbol musical: **ves** el pattern. Cada nota es tan gruesa como su `:amp`; un `:pan` la sombrearía de un borde al otro.\n\nEl dibujo sigue al pbind mientras lo editas. Para guardarlo, escribe `(keep! :b14)` en la REPL: se escribe en el freqt como un evento de la historia, con su **receta** al lado (el pbind, la semilla, el render), así que `(remake! :b14)` puede rehacerlo después de que lo edites a mano."
|
|
1209
|
+
},
|
|
1210
|
+
"try": {
|
|
1211
|
+
"en": "Change the seed of the pbind: the drawing changes with it. Then `(keep! :b14)`.",
|
|
1212
|
+
"es": "Cambia la semilla del pbind: el dibujo cambia con ella. Luego `(keep! :b14)`."
|
|
1213
|
+
},
|
|
1214
|
+
"code": [
|
|
1215
|
+
"(box :b13 \"render 0 8\" 560 40)",
|
|
1216
|
+
"(box :b14 \"freqt\" 560 100)",
|
|
1217
|
+
"(connect :b1 0 :b13 0)",
|
|
1218
|
+
"(connect :b13 0 :b14 0)"
|
|
1219
|
+
]
|
|
1220
|
+
},
|
|
1221
|
+
{
|
|
1222
|
+
"title": {
|
|
1223
|
+
"en": "Time maps",
|
|
1224
|
+
"es": "Mapas temporales"
|
|
1225
|
+
},
|
|
1226
|
+
"note": {
|
|
1227
|
+
"en": "A `canvas` on the right inlet of `render` is a **time map**: each stroke says which beat of the pattern (up, y) is at each beat of the drawing (across, x). The diagonal is the pattern as it is. Here, the first stroke goes up for 8 beats (the pattern), comes down for 4 (**backwards**, each note from its end) and stays flat (the note it is in, **held**). The second stroke starts later and climbs more slowly: a **canon by augmentation**, in the same freqt.\n\nA steeper line is faster, a curve is an accelerando, a vertical step is a cut.",
|
|
1228
|
+
"es": "Un `canvas` en la entrada derecha de `render` es un **mapa temporal**: cada trazo dice qué beat del pattern (arriba, y) está en cada beat del dibujo (a lo ancho, x). La diagonal es el pattern tal cual. Aquí el primer trazo sube 8 beats (el pattern), baja 4 (**al revés**, cada nota desde su final) y se queda plano (la nota en la que está, **sostenida**). El segundo empieza más tarde y sube más despacio: un **canon por aumentación**, en el mismo freqt.\n\nUna línea más inclinada es más rápida, una curva es un accelerando, un escalón vertical es un corte."
|
|
1229
|
+
},
|
|
1230
|
+
"try": {
|
|
1231
|
+
"en": "Click the bang next to the render to draw it again. Redraw the canvas (drag a stroke, or draw a new one), and bang again.",
|
|
1232
|
+
"es": "Haz clic en el bang junto al render para dibujarlo otra vez. Redibuja el canvas (arrastra un trazo o dibuja uno nuevo) y vuelve a hacer bang."
|
|
1233
|
+
},
|
|
1234
|
+
"code": [
|
|
1235
|
+
"(box :b15 \"canvas\" 860 100)",
|
|
1236
|
+
"(axis :b15 :x 0 16)",
|
|
1237
|
+
"(axis :b15 :y 0 8)",
|
|
1238
|
+
"(stroke :b15 [[0 0] [8 8] [12 4] [16 4]])",
|
|
1239
|
+
"(stroke :b15 [[2 0] [16 7]])",
|
|
1240
|
+
"(box :b16 \"bang\" 680 40)",
|
|
1241
|
+
"(connect :b15 1 :b13 1)",
|
|
1242
|
+
"(connect :b16 0 :b13 0)"
|
|
1243
|
+
]
|
|
1244
|
+
},
|
|
1245
|
+
{
|
|
1246
|
+
"title": {
|
|
1247
|
+
"en": "As a score",
|
|
1248
|
+
"es": "Como partitura"
|
|
1249
|
+
},
|
|
1250
|
+
"note": {
|
|
1251
|
+
"en": "A freqt can also be **read as a score**: ⇄ in its header, or `(view :b14 :score)`. The notes are quantized into real measures, with voices where the layers overlap, so a pattern and its time map become notation that someone can play.",
|
|
1252
|
+
"es": "Un freqt también se puede **leer como partitura**: ⇄ en su cabecera, o `(view :b14 :score)`. Las notas se cuantizan en compases reales, con voces donde las capas se superponen, así que un pattern y su mapa temporal se vuelven notación que alguien puede tocar."
|
|
1253
|
+
},
|
|
1254
|
+
"try": {
|
|
1255
|
+
"en": "Switch back to the drawing (⇄) and change the time map: the score follows.",
|
|
1256
|
+
"es": "Vuelve al dibujo (⇄) y cambia el mapa temporal: la partitura le sigue."
|
|
1257
|
+
},
|
|
1258
|
+
"code": [
|
|
1259
|
+
"(view :b14 :score)"
|
|
1260
|
+
]
|
|
1261
|
+
},
|
|
1262
|
+
{
|
|
1263
|
+
"title": {
|
|
1264
|
+
"en": "Patterns as code",
|
|
1265
|
+
"es": "Patterns como código"
|
|
1266
|
+
},
|
|
1267
|
+
"note": {
|
|
1268
|
+
"en": "A `pattern` box says the same in Clojure: any expression that gives events. `pbind`, `pwhite`, `pchoose` and the others give **lazy sequences**, which can be endless, as in Overtone; `rand` and its friends are seeded by the box. In a shared room it runs only once you allow it, `(trust-scripts true)`, because it is code: a `pbind` needs no trust.",
|
|
1269
|
+
"es": "Una caja `pattern` dice lo mismo en Clojure: cualquier expresión que dé eventos. `pbind`, `pwhite`, `pchoose` y los demás dan **secuencias perezosas**, que pueden ser infinitas, como en Overtone; `rand` y los suyos llevan la semilla de la caja. En una sala compartida solo se ejecuta cuando lo permites, `(trust-scripts true)`, porque es código: un `pbind` no necesita confianza."
|
|
1270
|
+
},
|
|
1271
|
+
"try": {
|
|
1272
|
+
"en": "Connect it to the player or to the render instead of the pbind.",
|
|
1273
|
+
"es": "Conéctalo al player o al render en lugar del pbind."
|
|
1274
|
+
},
|
|
1275
|
+
"code": [
|
|
1276
|
+
"(box :b17 \"pattern 3\" 220 40)",
|
|
1277
|
+
"(code :b17 \"(pbind {:degree (pwhite 0 9)\\n :dur (pchoose [0.25 0.25 0.5])\\n :octave [5 5 6]}\\n :inf)\")"
|
|
1278
|
+
]
|
|
1279
|
+
}
|
|
1280
|
+
]
|
|
1281
|
+
}
|
|
1282
|
+
]
|
|
1283
|
+
};
|