Browse Source

Update documentation

master
Nils 5 years ago
parent
commit
9a9dd8161b
  1. 21
      documentation/english.adoc
  2. 23
      documentation/german.adoc
  3. 56
      documentation/out/english.html
  4. 60
      documentation/out/german.html

21
documentation/english.adoc

@ -150,6 +150,25 @@ At the top you can see a label for the *[M] Active Track*.
The pattern itself is arranged in rows and columns. The rows symbolise the (adjustable) pitches, the columns show their rhythmic sequence and position in time.
==== Pattern Context Menu
A right click on a step opens a context menu that provides the following exclusive functions.
For all functions that reverse or invert ("On" becomes "Off" and vice versa), please note that all volume information (see below) is lost.
"Row" here refer to all steps of the same pitch. From left to right.
* Invert row (an empty row is completely filled)
* Clear row
* Repeat to here to fill row (see below)
* Invert Steps (the whole pattern)
* All Steps On
* All Steps Off
The function "Repeat to here to fill row" opens up many creative possibilities: All steps from the beginning of the row to the selected one (incl.) are taken as a "sub-pattern" which is used to fill the rest of the row. All existing steps will be deleted with their volumes.
For example, if you want a note every fourth step, activate the first step of the row, leave three empty and click on the fourth step as context menu and select the fill function. The whole row will now be a recurring pattern of "X o o o X o o o...".
==== Duration and Volume
A *[S] Step* is a grey or coloured box. Grey means pause, coloured means *[T] Sounding Tone*. A click with the left mouse button switches the steps on and off. +
@ -163,6 +182,8 @@ Steps can have different *[U] Volumes*. For this Patroneo uses so-called MIDI Ve
You can use the *[M] Velocity* buttons to make all tones of a pattern quieter or louder. If you click on it, the volume changes by 1 each, but if you hold the mouse cursor over a button and rotate your mouse wheel the velocity changes by 10 each. It doesn't matter which velocity button (plus or minus) you hover over.
To make all tones of a row quieter or louder hold the Alt key (not AltGr) and use your mousewheel on a step of that row.
==== Pitches and Scales
Click with the middle mouse button on a step to hear the sound it plays. This allows you to "pre-listen" before you decide to set a note. Tip: Hold down the middle mouse button and move the mouse up and down the steps.

23
documentation/german.adoc

@ -153,10 +153,29 @@ Zu oberst sieht man die momentan *[M] Aktivierte Spur*, bzw. das zur Spur gehör
Das Muster selbst ist in Reihen und Spalten angelegt. Die Reihen symbolisieren die (einstellbaren) Tonhöhen, die Spalten zeigen deren rhythmische Abfolge und Position im Takt.
==== Kontext Menü im Muster
Ein Rechtsklick auf einen Schritt öffnet ein Kontext-Menü, das folgende exklusive Funktionen bereitstellt.
Bei allen Funktionen, die umkehren bzw. invertieren ("An" wird "Aus" und umgekehrt) ist zu beachten, dass alle Lautstärke-Informationen (s.u.) verloren gehen.
"Reihen" bedeutet alle Schritte der gleichen Tonhöhe. Also von links nach rechts gesehen.
* Reihe umkehren (eine leere Reihe wird komplett gefüllt)
* Reihe löschen
* Reihe mit Wiederholung bis hier befüllen (s.u.)
* Alle Schritte umkehren (das gesamte Muster)
* Alle Schritte an
* Alle Schritte aus
Die Funktion "Reihe mit Widerholung bis hier befüllen" eröffnet viele kreative Möglichkeiten: Alle Schritte vom Anfang der Reihe bis zum Ausgewählten (inkl.) werden als "Untermuster" genommen und damit der Rest der Reihe aufgefüllt.
Alle vorhandenen Schritte werden dabei, mit ihren Lautstärken, gelöscht.
Möchte man z.B. jeden vierten Schritt eine Note aktiviert man den ersten Schritt der Reihe, lässt dann drei frei und klickt auf den vierten Schritt als Kontextmenü und wählt die Befüllen-Funktion aus. Die gesamte Reihe wird nun ein wiederkehrendes Muster von "X o o o X o o o..." sein.
==== Länge und Lautstärke
Ein *[S] Schritt* ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet *[T] Klingender Ton*. Ein klick mit der linken Maustaste schaltet die Schritte an und aus. +
Ein Rechtsklick öffnet das Kontextmenü. Hier kann man alle (gerade sichtbaren) Schritte einschalten, ausschalten oder die gesetzen Schritte tauschen; Aus An wird Aus und umgekehrt. Hierbei gehen alle Lautstärke Informationen (s.u.) verloren.
Alle Schritte sind grundsätzlich gleich lang. *[V] Besondere Tonlängen* sind aber auch möglich: Hält man die linke Maustaste gedrückt, nachdem man einen Schritt aktiviert hat kann man mit einer Bewegung nach links oder rechts den Ton verkürzen oder verlängern. Es muss mindestens die Hälfte der Länge sein. Ein Ton ist höchstens so lang wie der Takt selbst.
@ -166,6 +185,8 @@ Schritte können unterschiedliche *[U] Lautstärken* haben. Dazu benutzt Patrone
Um alle Töne eines Musters leiser oder lauter zu machen kann man die *[M] Velocity* Knöpfe benutzen. Klickt man diese an ändert sich die Lautstärke um je 1. Hält man allerdings den Mauszeiger über einen Knopf und dreht das Mausrad ändert sich die Velocity um je 10! Dabei ist es egal über welchem Velocity Knopf (plus oder minus) man schwebt.
Um alle Töne einer Reihe leiser oder lauter zu machen hält man die Alt-Taste (nicht AltGR !) gedrückt und benutzt das Mausrad auf der jeweiligen Reihe.
==== Tonhöhen, Skala und Tonleiter
Klicke mit der mittleren Maustaste auf einen Schritt um den Ton zu hören, den dieser abspielt. Hiermit kannst du schonmal "vorhören", bevor du dich entscheidest einen Ton zu setzen. Tipp: Halte die mittlere Maustaste gedrückt und fahre mit der Maus über die Schritte auf und ab.

56
documentation/out/english.html

@ -459,9 +459,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<li><a href="#_form_editor">3.2. Form Editor</a></li>
<li><a href="#_pattern_editor">3.3. Pattern Editor</a>
<ul class="sectlevel3">
<li><a href="#_duration_and_volume">3.3.1. Duration and Volume</a></li>
<li><a href="#_pitches_and_scales">3.3.2. Pitches and Scales</a></li>
<li><a href="#_shadows">3.3.3. Shadows</a></li>
<li><a href="#_pattern_context_menu">3.3.1. Pattern Context Menu</a></li>
<li><a href="#_duration_and_volume">3.3.2. Duration and Volume</a></li>
<li><a href="#_pitches_and_scales">3.3.3. Pitches and Scales</a></li>
<li><a href="#_shadows">3.3.4. Shadows</a></li>
</ul>
</li>
<li><a href="#_grouping_in_the_pattern">3.4. Grouping in the Pattern</a></li>
@ -719,7 +720,45 @@ However, if the scale is chosen freely, there are non-intuitive outcomes; "up an
<p>The pattern itself is arranged in rows and columns. The rows symbolise the (adjustable) pitches, the columns show their rhythmic sequence and position in time.</p>
</div>
<div class="sect3">
<h4 id="_duration_and_volume">3.3.1. Duration and Volume</h4>
<h4 id="_pattern_context_menu">3.3.1. Pattern Context Menu</h4>
<div class="paragraph">
<p>A right click on a step opens a context menu that provides the following exclusive functions.
For all functions that reverse or invert ("On" becomes "Off" and vice versa), please note that all volume information (see below) is lost.</p>
</div>
<div class="paragraph">
<p>"Row" here refer to all steps of the same pitch. From left to right.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Invert row (an empty row is completely filled)</p>
</li>
<li>
<p>Clear row</p>
</li>
<li>
<p>Repeat to here to fill row (see below)</p>
</li>
<li>
<p>Invert Steps (the whole pattern)</p>
</li>
<li>
<p>All Steps On</p>
</li>
<li>
<p>All Steps Off</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The function "Repeat to here to fill row" opens up many creative possibilities: All steps from the beginning of the row to the selected one (incl.) are taken as a "sub-pattern" which is used to fill the rest of the row. All existing steps will be deleted with their volumes.</p>
</div>
<div class="paragraph">
<p>For example, if you want a note every fourth step, activate the first step of the row, leave three empty and click on the fourth step as context menu and select the fill function. The whole row will now be a recurring pattern of "X o o o X o o o&#8230;&#8203;".</p>
</div>
</div>
<div class="sect3">
<h4 id="_duration_and_volume">3.3.2. Duration and Volume</h4>
<div class="paragraph">
<p>A <strong>[S] Step</strong> is a grey or coloured box. Grey means pause, coloured means <strong>[T] Sounding Tone</strong>. A click with the left mouse button switches the steps on and off.<br>
A right click opens the context menu. Here you can switch all (currently visible) steps on, off or invert all: Off On becomes Off and vice versa. All volume information (see below) will be lost.</p>
@ -736,9 +775,12 @@ A right click opens the context menu. Here you can switch all (currently visible
<div class="paragraph">
<p>You can use the <strong>[M] Velocity</strong> buttons to make all tones of a pattern quieter or louder. If you click on it, the volume changes by 1 each, but if you hold the mouse cursor over a button and rotate your mouse wheel the velocity changes by 10 each. It doesn&#8217;t matter which velocity button (plus or minus) you hover over.</p>
</div>
<div class="paragraph">
<p>To make all tones of a row quieter or louder hold the Alt key (not AltGr) and use your mousewheel on a step of that row.</p>
</div>
</div>
<div class="sect3">
<h4 id="_pitches_and_scales">3.3.2. Pitches and Scales</h4>
<h4 id="_pitches_and_scales">3.3.3. Pitches and Scales</h4>
<div class="paragraph">
<p>Click with the middle mouse button on a step to hear the sound it plays. This allows you to "pre-listen" before you decide to set a note. Tip: Hold down the middle mouse button and move the mouse up and down the steps.</p>
</div>
@ -767,7 +809,7 @@ If you select a scale from the list, it will be built upon the bottom row. As a
</div>
</div>
<div class="sect3">
<h4 id="_shadows">3.3.3. Shadows</h4>
<h4 id="_shadows">3.3.4. Shadows</h4>
<div class="paragraph">
<p>Often you want to add more tones to an existing track in a different pattern. A second voice, question/answer technique etc.
To help you, it is possible to display other tracks as <strong>[2] Shadows</strong>. Just click with the middle mouse button on the track you want to see. This is only possible in the measure area, not on the track name or on the timeline.</p>
@ -1127,7 +1169,7 @@ The program is split in two parts. A shared "template" between the Laborejo Soft
</div>
<div id="footer">
<div id="footer-text">
Last updated 2019-05-05 14:53:49 +0200
Last updated 2019-06-30 12:11:55 +0200
</div>
</div>
</body>

60
documentation/out/german.html

@ -459,9 +459,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
<li><a href="#_form_editor">3.2. Form-Editor</a></li>
<li><a href="#_muster_editor">3.3. Muster-Editor</a>
<ul class="sectlevel3">
<li><a href="#_länge_und_lautstärke">3.3.1. Länge und Lautstärke</a></li>
<li><a href="#_tonhöhen_skala_und_tonleiter">3.3.2. Tonhöhen, Skala und Tonleiter</a></li>
<li><a href="#_schatten">3.3.3. Schatten</a></li>
<li><a href="#_kontext_menü_im_muster">3.3.1. Kontext Menü im Muster</a></li>
<li><a href="#_länge_und_lautstärke">3.3.2. Länge und Lautstärke</a></li>
<li><a href="#_tonhöhen_skala_und_tonleiter">3.3.3. Tonhöhen, Skala und Tonleiter</a></li>
<li><a href="#_schatten">3.3.4. Schatten</a></li>
</ul>
</li>
<li><a href="#_gruppierung_im_muster">3.4. Gruppierung im Muster</a></li>
@ -723,10 +724,48 @@ Wenn die Skala allerdings frei eingestellt wurde ergeben sich unintuitive Mögli
<p>Das Muster selbst ist in Reihen und Spalten angelegt. Die Reihen symbolisieren die (einstellbaren) Tonhöhen, die Spalten zeigen deren rhythmische Abfolge und Position im Takt.</p>
</div>
<div class="sect3">
<h4 id="_länge_und_lautstärke">3.3.1. Länge und Lautstärke</h4>
<h4 id="_kontext_menü_im_muster">3.3.1. Kontext Menü im Muster</h4>
<div class="paragraph">
<p>Ein <strong>[S] Schritt</strong> ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet <strong>[T] Klingender Ton</strong>. Ein klick mit der linken Maustaste schaltet die Schritte an und aus.<br>
Ein Rechtsklick öffnet das Kontextmenü. Hier kann man alle (gerade sichtbaren) Schritte einschalten, ausschalten oder die gesetzen Schritte tauschen; Aus An wird Aus und umgekehrt. Hierbei gehen alle Lautstärke Informationen (s.u.) verloren.</p>
<p>Ein Rechtsklick auf einen Schritt öffnet ein Kontext-Menü, das folgende exklusive Funktionen bereitstellt.
Bei allen Funktionen, die umkehren bzw. invertieren ("An" wird "Aus" und umgekehrt) ist zu beachten, dass alle Lautstärke-Informationen (s.u.) verloren gehen.</p>
</div>
<div class="paragraph">
<p>"Reihen" bedeutet alle Schritte der gleichen Tonhöhe. Also von links nach rechts gesehen.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Reihe umkehren (eine leere Reihe wird komplett gefüllt)</p>
</li>
<li>
<p>Reihe löschen</p>
</li>
<li>
<p>Reihe mit Wiederholung bis hier befüllen (s.u.)</p>
</li>
<li>
<p>Alle Schritte umkehren (das gesamte Muster)</p>
</li>
<li>
<p>Alle Schritte an</p>
</li>
<li>
<p>Alle Schritte aus</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Die Funktion "Reihe mit Widerholung bis hier befüllen" eröffnet viele kreative Möglichkeiten: Alle Schritte vom Anfang der Reihe bis zum Ausgewählten (inkl.) werden als "Untermuster" genommen und damit der Rest der Reihe aufgefüllt.
Alle vorhandenen Schritte werden dabei, mit ihren Lautstärken, gelöscht.</p>
</div>
<div class="paragraph">
<p>Möchte man z.B. jeden vierten Schritt eine Note aktiviert man den ersten Schritt der Reihe, lässt dann drei frei und klickt auf den vierten Schritt als Kontextmenü und wählt die Befüllen-Funktion aus. Die gesamte Reihe wird nun ein wiederkehrendes Muster von "X o o o X o o o&#8230;&#8203;" sein.</p>
</div>
</div>
<div class="sect3">
<h4 id="_länge_und_lautstärke">3.3.2. Länge und Lautstärke</h4>
<div class="paragraph">
<p>Ein <strong>[S] Schritt</strong> ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet <strong>[T] Klingender Ton</strong>. Ein klick mit der linken Maustaste schaltet die Schritte an und aus.<br></p>
</div>
<div class="paragraph">
<p>Alle Schritte sind grundsätzlich gleich lang. <strong>[V] Besondere Tonlängen</strong> sind aber auch möglich: Hält man die linke Maustaste gedrückt, nachdem man einen Schritt aktiviert hat kann man mit einer Bewegung nach links oder rechts den Ton verkürzen oder verlängern. Es muss mindestens die Hälfte der Länge sein. Ein Ton ist höchstens so lang wie der Takt selbst.</p>
@ -740,9 +779,12 @@ Ein Rechtsklick öffnet das Kontextmenü. Hier kann man alle (gerade sichtbaren)
<div class="paragraph">
<p>Um alle Töne eines Musters leiser oder lauter zu machen kann man die <strong>[M] Velocity</strong> Knöpfe benutzen. Klickt man diese an ändert sich die Lautstärke um je 1. Hält man allerdings den Mauszeiger über einen Knopf und dreht das Mausrad ändert sich die Velocity um je 10! Dabei ist es egal über welchem Velocity Knopf (plus oder minus) man schwebt.</p>
</div>
<div class="paragraph">
<p>Um alle Töne einer Reihe leiser oder lauter zu machen hält man die Alt-Taste (nicht AltGR !) gedrückt und benutzt das Mausrad auf der jeweiligen Reihe.</p>
</div>
</div>
<div class="sect3">
<h4 id="_tonhöhen_skala_und_tonleiter">3.3.2. Tonhöhen, Skala und Tonleiter</h4>
<h4 id="_tonhöhen_skala_und_tonleiter">3.3.3. Tonhöhen, Skala und Tonleiter</h4>
<div class="paragraph">
<p>Klicke mit der mittleren Maustaste auf einen Schritt um den Ton zu hören, den dieser abspielt. Hiermit kannst du schonmal "vorhören", bevor du dich entscheidest einen Ton zu setzen. Tipp: Halte die mittlere Maustaste gedrückt und fahre mit der Maus über die Schritte auf und ab.</p>
</div>
@ -771,7 +813,7 @@ Wählt man aus der Liste eine Tonleiter aus so wird diese auf der untersten Reih
</div>
</div>
<div class="sect3">
<h4 id="_schatten">3.3.3. Schatten</h4>
<h4 id="_schatten">3.3.4. Schatten</h4>
<div class="paragraph">
<p>Oft möchte man zu einer existierenden Spur noch weitere Töne in einem anderen Muster setzen. Eine zweite Stimme, Frage/Antwort-Technik etc.
Als Hilfe gibt es die Möglichkeit sich andere Spuren als <strong>[2] Schatten</strong> anzeigen zu lassen. Dazu einfach mit der mittleren Maustaste auf die Spur klicken, die man sehen möchte. Das geht nur im Taktbereich, nicht auf den Spurnamen oder auf der Zeitleiste.</p>
@ -1208,7 +1250,7 @@ Das Programm ist in zwei Teile aufgeteilt: Ein gemeinsames "Template" (für alle
</div>
<div id="footer">
<div id="footer-text">
Last updated 2019-05-05 14:53:49 +0200
Last updated 2019-06-30 12:11:55 +0200
</div>
</div>
</body>

Loading…
Cancel
Save