Add new screenshots to the manual

README.md

@@ -1,5 +1,5 @@
 
-[//]: # (Generated 2021-12-19T20:29:30.222190. Changes belong into template/documentation/readme.template)
+[//]: # (Generated 2021-12-24T13:53:40.666499. Changes belong into template/documentation/readme.template)
 
 #Patroneo
 Program version 2.3.0
@@ -49,7 +49,7 @@ It is possible to clone a git repository.
 * Python 3.6 (maybe earlier)
 * PyQt5 for Python 3
 * DejaVu Sans Sarif TTF (Font) (recommended, but not technically necessary)
-
+* 
 
 #### Build Dependencies
 * Bash

documentation/english.adoc

@@ -56,6 +56,8 @@ https://youtube.com/playlist?list=PLSQAc8dt9jR37eKDhr86VxLkFYQN9HNiO[Video Tutor
 
 === Basic Principles
 
+image::en_overview.png[link="en_overview.png"]
+
 Patroneo organizes its music in tracks that contain measures. All measures of a track play the same
 "pattern" that creates music through a sequence of "steps".
 
@@ -95,6 +97,8 @@ move it up or down to give more space to one or the other area.
 
 === Toolbar
 
+image:en_toolbar.png[link="en_toolbar.png"]
+
 The *Toolbar* combines various commands with properties of the entire piece.
 
 *Clone Selected Track* adds a new track based on the currently selected one. This is an
@@ -131,11 +135,6 @@ off. The drop down list selects how long each of these steps is.
 * Loop on and off. The currently played measure (in all tracks) is continuously repeated. This function is suitable for working in a certain place by getting to hear your changes quickly. The loop is broken up by pressing the button again or jumping around in the timeline.
 * To the start: Jumps back to the beginning, whether the music is playing or not.
 
-Die Dauer der Schleife in Takten kann neben dem Schleifen-Knopf eingestellt werden.
-Zur Erinnerung: Die Schleife ist eine Funktion um Ideen auszuprobieren, während man komponiert.
-Sie ist sowohl technisch, als auch von der Benutzerführung her, nicht dafür geeignet während eines Liveauftritts
-oder während einer Aufnahme spontan verändert zu werden.
-
 The duration of the loop in measures can be set next to the loop button. As a reminder, the loop is
 a function to try out ideas while composing. It is not suitable, both technically and in terms of
 user interface, to be changed spontaneously during a live performance or recording, or during a
@@ -143,6 +142,8 @@ recording session.
 
 ==== Swing
 
+image:en_swing.png[link="en_swing.png"]
+
 *Swing* (also called shuffle) can be adjusted by a slider in percent. The slider
 is located on the far right of the toolbar. The slider is only visible when the group
 (see above) is set to either 2 or 4. Swing is also only applied in these groupings.
@@ -158,6 +159,8 @@ With a grouping of 4 (same BPM/tempo) already 15% are clearly audible.
 
 === Form Editor
 
+image:en_form_editor.png[link="en_form_editor.png"]
+
 In the *Form Editor* you create the structure of a piece. To do this, the measures in each
 track can be switched on and off as desired. One can imagine, for example, a drum set that plays
 three bars in a row and makes a "break" every fourth bar. For this common drum technique you need
@@ -206,6 +209,8 @@ immediately afterwards.
 
 ==== Measure Modifications: Transposition and Rhythm
 
+image:en_modifications.png[link="en_modifications.png"]
+
 The following functions can be looked up in the Edit menu at any time, but cannot be invoked
 directly from there, but require the use of keyboard and mouse at the same time. Use the keys while
 hovering the mouse pointer over a measure in the track editor (upper half of the screen).
@@ -277,9 +282,11 @@ The step delay is calculated first and then the augmentation factor.
 
 ==== Track Groups
 
+image:en_trackgroups.png[link="en_trackgroups.png"]
+
 Tracks can be grouped together. This is not to be confused with the rhythm groups of patters.
 
-Groups have two properties: they improve the clarity of layout and group JACK midiports together.
+Groups have two functions: they improve the clarity of layout and group JACK midiports together.
 (All tracks in a group send via the same port).
 
 Typically, groups are used to combine individual tracks into "logical instruments". It is highly
@@ -306,6 +313,8 @@ mouse click):
 
 ==== Extending Measure Lengths of Individual Tracks
 
+image:en_pattern_multiplier.png[link="en_pattern_multiplier.png"]
+
 At first, all measures of all tracks are of the same length in Patroneo, namely as you have set the
 steps per pattern (start value: 8).
 
@@ -330,6 +339,8 @@ scenarios, external JACK programs must be used.
 
 === Pattern Editor
 
+image:en_pattern_editor.png[link="en_pattern_editor.png"]
+
 The *Pattern Editor* is used for composing. The tones, also called "steps", are used to form a
 measure. The pattern is exactly as long as a measure and is played from left to right. There are
 several possibilities for tonal arrangement, which are now explained.
@@ -372,6 +383,8 @@ now be a recurring pattern of "X o o o X o o o...".
 
 ==== Duration and Volume
 
+image:en_velocities.png[link="en_velocities.png"]
+
 A *Step* is a grey or coloured box. Grey means pause, coloured means *Sounding Tone*. A
 click with the left mouse button switches the steps on and off. A right click opens the context
 menu. Here you can switch all (currently visible) steps on, off or invert all: Off On becomes Off
@@ -404,6 +417,8 @@ on a step of that row.
 
 ==== Pitches and Scales
 
+image:en_pitches.png[link="en_pitches.png"]
+
 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.
@@ -429,6 +444,8 @@ musically meaningful intervals, nor do they have to be sorted in ascending or de
 
 ==== Changing the number of available pitches
 
+image:en_pattern_height.png[link="en_pattern_height.png"]
+
 In the toolbar in the center, next to the transposition and scale options, there is a
 a setting option to change the number of available pitches.
 The starting value is "8 notes". Possible values are 1 to 127, but these are extreme values.
@@ -443,6 +460,8 @@ will remain, even if they become "invisible", because there is no more space for
 
 ==== Shadows
 
+image:en_shadows.png[link="en_shadows.png"]
+
 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 *Shadows*.
 Just click with the middle mouse button on the track you want to see. This is only possible in the
@@ -457,6 +476,8 @@ in principle. They just show which steps are marked, nothing more.
 
 === Grouping in the Pattern
 
+image:en_timesig.png[link="en_timesig.png"]
+
 Grouping is part of the time signature.
 
 As mentioned above *steps per pattern*, sets the length of the pattern. Patroneo starts with 8
@@ -482,7 +503,9 @@ happens every now and then that you need smaller rhythm values than you thought
 If you simply increase the value of the grouping, you get more subdivisions, but the number of
 steps remains the same. Likewise, the notes remain exactly in the "column" in which they were
 previously placed. In other words, the music will sound different. Overall, the measure is also
-getting shorter, since the same number of steps is now used for shorter steps.
+getting shorter, as the same number of steps is now assigned shorter note values.
+
+image:en_convert_grouping.png[link="en_convert_grouping.png"]
 
 Patroneo therefore offers the function *Convert Grouping* (in the Edit menu) to change the existing
 measure structure and to resize steps already set so that the music sounds the same.
@@ -525,6 +548,8 @@ itself when you use the menu command.
 
 ==== Hardware: AKAI APCmini
 
+image:akai_apc_mini.png[link="akai_apc_mini.png"]
+
 The AKAI APCmini can be used as an input device.  Patroneo has a JACK-Midi input and output port
 for this purpose: once for the actual input and then back to the unit to control its LEDs.
 

documentation/english.part.adoc

@@ -11,6 +11,8 @@ https://youtube.com/playlist?list=PLSQAc8dt9jR37eKDhr86VxLkFYQN9HNiO[Video Tutor
 
 === Basic Principles
 
+image::en_overview.png[link="en_overview.png"]
+
 Patroneo organizes its music in tracks that contain measures. All measures of a track play the same
 "pattern" that creates music through a sequence of "steps".
 
@@ -50,6 +52,8 @@ move it up or down to give more space to one or the other area.
 
 === Toolbar
 
+image:en_toolbar.png[link="en_toolbar.png"]
+
 The *Toolbar* combines various commands with properties of the entire piece.
 
 *Clone Selected Track* adds a new track based on the currently selected one. This is an
@@ -86,11 +90,6 @@ off. The drop down list selects how long each of these steps is.
 * Loop on and off. The currently played measure (in all tracks) is continuously repeated. This function is suitable for working in a certain place by getting to hear your changes quickly. The loop is broken up by pressing the button again or jumping around in the timeline.
 * To the start: Jumps back to the beginning, whether the music is playing or not.
 
-Die Dauer der Schleife in Takten kann neben dem Schleifen-Knopf eingestellt werden.
-Zur Erinnerung: Die Schleife ist eine Funktion um Ideen auszuprobieren, während man komponiert.
-Sie ist sowohl technisch, als auch von der Benutzerführung her, nicht dafür geeignet während eines Liveauftritts
-oder während einer Aufnahme spontan verändert zu werden.
-
 The duration of the loop in measures can be set next to the loop button. As a reminder, the loop is
 a function to try out ideas while composing. It is not suitable, both technically and in terms of
 user interface, to be changed spontaneously during a live performance or recording, or during a
@@ -98,6 +97,8 @@ recording session.
 
 ==== Swing
 
+image:en_swing.png[link="en_swing.png"]
+
 *Swing* (also called shuffle) can be adjusted by a slider in percent. The slider
 is located on the far right of the toolbar. The slider is only visible when the group
 (see above) is set to either 2 or 4. Swing is also only applied in these groupings.
@@ -113,6 +114,8 @@ With a grouping of 4 (same BPM/tempo) already 15% are clearly audible.
 
 === Form Editor
 
+image:en_form_editor.png[link="en_form_editor.png"]
+
 In the *Form Editor* you create the structure of a piece. To do this, the measures in each
 track can be switched on and off as desired. One can imagine, for example, a drum set that plays
 three bars in a row and makes a "break" every fourth bar. For this common drum technique you need
@@ -161,6 +164,8 @@ immediately afterwards.
 
 ==== Measure Modifications: Transposition and Rhythm
 
+image:en_modifications.png[link="en_modifications.png"]
+
 The following functions can be looked up in the Edit menu at any time, but cannot be invoked
 directly from there, but require the use of keyboard and mouse at the same time. Use the keys while
 hovering the mouse pointer over a measure in the track editor (upper half of the screen).
@@ -232,9 +237,11 @@ The step delay is calculated first and then the augmentation factor.
 
 ==== Track Groups
 
+image:en_trackgroups.png[link="en_trackgroups.png"]
+
 Tracks can be grouped together. This is not to be confused with the rhythm groups of patters.
 
-Groups have two properties: they improve the clarity of layout and group JACK midiports together.
+Groups have two functions: they improve the clarity of layout and group JACK midiports together.
 (All tracks in a group send via the same port).
 
 Typically, groups are used to combine individual tracks into "logical instruments". It is highly
@@ -261,6 +268,8 @@ mouse click):
 
 ==== Extending Measure Lengths of Individual Tracks
 
+image:en_pattern_multiplier.png[link="en_pattern_multiplier.png"]
+
 At first, all measures of all tracks are of the same length in Patroneo, namely as you have set the
 steps per pattern (start value: 8).
 
@@ -285,6 +294,8 @@ scenarios, external JACK programs must be used.
 
 === Pattern Editor
 
+image:en_pattern_editor.png[link="en_pattern_editor.png"]
+
 The *Pattern Editor* is used for composing. The tones, also called "steps", are used to form a
 measure. The pattern is exactly as long as a measure and is played from left to right. There are
 several possibilities for tonal arrangement, which are now explained.
@@ -327,6 +338,8 @@ now be a recurring pattern of "X o o o X o o o...".
 
 ==== Duration and Volume
 
+image:en_velocities.png[link="en_velocities.png"]
+
 A *Step* is a grey or coloured box. Grey means pause, coloured means *Sounding Tone*. A
 click with the left mouse button switches the steps on and off. A right click opens the context
 menu. Here you can switch all (currently visible) steps on, off or invert all: Off On becomes Off
@@ -359,6 +372,8 @@ on a step of that row.
 
 ==== Pitches and Scales
 
+image:en_pitches.png[link="en_pitches.png"]
+
 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.
@@ -384,6 +399,8 @@ musically meaningful intervals, nor do they have to be sorted in ascending or de
 
 ==== Changing the number of available pitches
 
+image:en_pattern_height.png[link="en_pattern_height.png"]
+
 In the toolbar in the center, next to the transposition and scale options, there is a
 a setting option to change the number of available pitches.
 The starting value is "8 notes". Possible values are 1 to 127, but these are extreme values.
@@ -398,6 +415,8 @@ will remain, even if they become "invisible", because there is no more space for
 
 ==== Shadows
 
+image:en_shadows.png[link="en_shadows.png"]
+
 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 *Shadows*.
 Just click with the middle mouse button on the track you want to see. This is only possible in the
@@ -412,6 +431,8 @@ in principle. They just show which steps are marked, nothing more.
 
 === Grouping in the Pattern
 
+image:en_timesig.png[link="en_timesig.png"]
+
 Grouping is part of the time signature.
 
 As mentioned above *steps per pattern*, sets the length of the pattern. Patroneo starts with 8
@@ -437,7 +458,9 @@ happens every now and then that you need smaller rhythm values than you thought
 If you simply increase the value of the grouping, you get more subdivisions, but the number of
 steps remains the same. Likewise, the notes remain exactly in the "column" in which they were
 previously placed. In other words, the music will sound different. Overall, the measure is also
-getting shorter, since the same number of steps is now used for shorter steps.
+getting shorter, as the same number of steps is now assigned shorter note values.
+
+image:en_convert_grouping.png[link="en_convert_grouping.png"]
 
 Patroneo therefore offers the function *Convert Grouping* (in the Edit menu) to change the existing
 measure structure and to resize steps already set so that the music sounds the same.
@@ -480,6 +503,8 @@ itself when you use the menu command.
 
 ==== Hardware: AKAI APCmini
 
+image:akai_apc_mini.png[link="akai_apc_mini.png"]
+
 The AKAI APCmini can be used as an input device.  Patroneo has a JACK-Midi input and output port
 for this purpose: once for the actual input and then back to the unit to control its LEDs.
 

documentation/german.adoc

@@ -39,6 +39,8 @@ wiederholen - oder auslassen - kann.
 
 == Bedienung
 
+image::de_overview.png[link="de_overview.png"]
+
 Im folgenden wird erklärt, wie Patroneo bedient wird.
 
 Das Programm wird fast ausschließlich mit der Maus bedient. Sie benötigen zwingend drei Maustasten
@@ -100,6 +102,8 @@ oder anderen Bereich mehr Platz zu geben.
 
 === Werkzeugleiste
 
+image:de_toolbar.png[link="de_toolbar.png"]
+
 Die *Werkzeugleiste* kombiniert verschiedene Befehle mit Eigenschaften des gesamten Stückes.
 
 *Klon* der ausgewählten Spur fügt eine neue Spur auf Grundlage der momentan ausgewählten hinzu.
@@ -148,6 +152,9 @@ oder während einer Aufnahme spontan verändert zu werden.
 
 ==== Swing
 
+image:de_swing.png[link="de_swing.png"]
+
+
 *Swing* (auch Shuffle genannt) kann durch einen Schieberegler in Prozent eingestellt werden. Dieser
 befindet sich ganz rechts in der Werkzeugleiste. Der Regler wird erst sichtbar wenn die Gruppe
 (s.o.) auf entweder 2 oder 4 gesetzt wurde. Swing ist auch nur in diesen Gruppierungen
@@ -163,6 +170,8 @@ erlebt, während bei der 4er Gruppierung (bei gleichem BPM/Tempo) bereits 15% de
 
 === Form-Editor
 
+image:de_form_editor.png[link="de_form_editor.png"]
+
 Im *Form-Editor* erstellt man die Stuktur eines Stückes. Dazu schaltet man die Takte in jeder
 Spur beliebig ein und aus. Man kann sich z.B. ein Schlagzeug vorstellen, dass drei Takte gleich
 spielt und jeden vierten Takt einen "Break" macht. In Patroneo braucht man dazu zwei Spuren. Dieses
@@ -212,6 +221,8 @@ anschließend direkt wieder zurückzusetzen.
 
 ==== Taktmodifikation: Transposition und Rhythmusveränderung
 
+image:de_modifications.png[link="de_modifications.png"]
+
 Die folgenden Funktionen können jederzeit im Bearbeiten-Menü nachgeschlagen werden, können aber nicht
 direkt von dort aufgerufen werden, sondern erfordern den Einsatz von Tastatur und Maus gleichzeitig
 während man mit dem Mauszeiger auf einen Takt im Formeditor (obere Hälfte des Bildschirms) zeigt.
@@ -283,10 +294,13 @@ Es wird zuerst die Schrittverzögerung und anschließend der Augmentierungs-Fakt
 
 ==== Spurgruppen
 
+
+image:de_trackgroups.png[link="de_trackgroups.png"]
+
 Spuren können in Gruppen zusammengefasst werden. Das ist nicht zu verwechseln mit den
 Rhythmusgruppen des Notenmusters.
 
-Gruppen haben zwei Eigenschaften: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
+Gruppen haben zwei Funktionen: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
 (Alle Spuren in einer Gruppen senden über den gleichen Port)
 
 Üblicherweise werden Gruppen benutzt um einzelne Spuren zu logischen "Instrumenten" zusammenzufassen.
@@ -315,6 +329,8 @@ aufgerufen werden:
 
 ==== Taktlängen einzelner Spuren verlängern
 
+image:de_pattern_multiplier.png[link="de_pattern_multiplier.png"]
+
 Zunächst sind in Patroneo alle Takte aller Spuren gleich lang, nämlich so wie man die Schritte pro
 Muster eingestellt hat (Startwert: 8).
 
@@ -338,6 +354,8 @@ gleichzeitig. Für anspruchsvollere Szenarios müssen externe JACK-Programme ben
 
 === Muster-Editor
 
+image:de_pattern_editor.png[link="de_pattern_editor.png"]
+
 Der *Muster-Editor* ermöglicht das eigentliche Komponieren. Dazu setzt man die Töne, auch
 "Schritte" genannt, um einen Takt zu bilden. Das Muster ist genau so lang wie ein Takt und wird von
 links nach rechts abgespielt. Man hat dabei einige Möglichkeiten zur klanglichen Gestaltung, die
@@ -383,6 +401,8 @@ aus. Die gesamte Reihe wird nun ein wiederkehrendes Muster von "X o o o X o o o.
 
 ==== Länge und Lautstärke
 
+image:de_velocities.png[link="de_velocities.png"]
+
 Ein *Schritt* ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet
 *Klingender Ton*. Ein klick mit der linken Maustaste schaltet die Schritte an und aus.
 
@@ -411,8 +431,11 @@ 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
 
+image:de_pitches.png[link="de_pitches.png"]
+
 Klicken Sie mit der mittleren Maustaste auf einen Schritt um den Ton zu hören, den dieser abspielt.
 Hiermit können Sie schonmal "vorhören", bevor Sie sich entscheidest einen Ton zu setzen. Tipp: Halten
 Sie die mittlere Maustaste gedrückt und fahren mit der Maus über die Schritte auf und ab.
@@ -442,6 +465,8 @@ sein.
 
 ==== Anzahl der möglichen Tonhöhen verändern
 
+image:de_pattern_height.png[link="de_pattern_height.png"]
+
 In der Werkzeugleiste in der Mitte, bei den Transpositions- und Tonleiteroptionen befindet sich
 eine Einstellmöglichkeiten um die Anzahl der möglichen Tonhöhen zu verändern.
 Der Startwert ist "8 Noten". Mögliche Werte sind 1 bis 127, dabei handelt es sich um Extremwerte.
@@ -457,6 +482,8 @@ Platz mehr für sie gibt.
 
 ==== Schatten
 
+image:de_shadows.png[link="de_shadows.png"]
+
 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
 *Schatten* anzeigen zu lassen. Dazu einfach mit der mittleren Maustaste auf die Spur klicken,
@@ -473,6 +500,8 @@ Tonhöhen sondern nur die markierten Kästchen an, egal was diese als Töne bede
 
 === Gruppierung im Muster
 
+image:de_timesig.png[link="de_timesig.png"]
+
 Die Gruppierung gehört zur Taktart.
 
 Wie bereits oben beschrieben stellt *Schritte pro Takt* die Länge des Musters ein. Patroneo startet
@@ -500,7 +529,9 @@ kommt jedoch immer mal wieder vor, dass man kleinere Rhythmuswerte braucht, als
 Wenn man einfach den Wert der Gruppierung erhöht erhält man zwar mehr Unterteilungen, die Anzahl
 der Schritte bleibt jedoch gleich. Ebenso bleiben die Noten genau in der "Spalte" stehen, in der
 sie vorher standen. In anderen Worten: die Musik wird anders klingen. Insgesamt wird auch der Takt
-kürzer, da die gleiche Anzahl von Schritten nun auf kürzere Schritte verteilt wird.
+kürzer, da die gleiche Anzahl an Schritten nun mit kürzeren Notenwerten belegt wird.
+
+image:de_convert_grouping.png[link="de_convert_grouping.png"]
 
 Patroneo bietet deswegen die Funktion *Gruppierung Umwandeln* (im Bearbeiten Menü), um die
 bestehende Taktstruktur zu verändern und bereits gesetzte Schritte so zu skalieren, dass die Musik
@@ -548,11 +579,13 @@ Programm selbst dokumentiert, sobald man den Menübefehl aufruft.
 
 ==== Hardware: AKAI APCmini
 
+image:akai_apc_mini.png[link="akai_apc_mini.png"]
+
 Das AKAI APCmini kann als Eingabehilfe benutzt werden.  Patroneo hat dafür je einen JACK-Midi
 Eingangs- und Ausgangsport: Einmal für die eigentliche Eingabe und dann zurück zum Gerät, um dessen
 LEDs zu steuern.
 
-Eine Bedienungsanleitung existiert nur in Videoform und auf Englisch und befindet sich in der
+Eine Bedienungsanleitung existiert nur in Videoform, und auf Englisch, und befindet sich in der
 Videotutorialseries (siehe Einleitung, unter "Schnellstart").
 
 Es mag ihnen vielleicht seltsam vorkommen, dass das nur für ein spezifisches Gerät angeboten wird.

documentation/german.part.adoc

@@ -10,6 +10,8 @@ wiederholen - oder auslassen - kann.
 
 == Bedienung
 
+image::de_overview.png[link="de_overview.png"]
+
 Im folgenden wird erklärt, wie Patroneo bedient wird.
 
 Das Programm wird fast ausschließlich mit der Maus bedient. Sie benötigen zwingend drei Maustasten
@@ -71,6 +73,8 @@ oder anderen Bereich mehr Platz zu geben.
 
 === Werkzeugleiste
 
+image:de_toolbar.png[link="de_toolbar.png"]
+
 Die *Werkzeugleiste* kombiniert verschiedene Befehle mit Eigenschaften des gesamten Stückes.
 
 *Klon* der ausgewählten Spur fügt eine neue Spur auf Grundlage der momentan ausgewählten hinzu.
@@ -119,6 +123,9 @@ oder während einer Aufnahme spontan verändert zu werden.
 
 ==== Swing
 
+image:de_swing.png[link="de_swing.png"]
+
+
 *Swing* (auch Shuffle genannt) kann durch einen Schieberegler in Prozent eingestellt werden. Dieser
 befindet sich ganz rechts in der Werkzeugleiste. Der Regler wird erst sichtbar wenn die Gruppe
 (s.o.) auf entweder 2 oder 4 gesetzt wurde. Swing ist auch nur in diesen Gruppierungen
@@ -134,6 +141,8 @@ erlebt, während bei der 4er Gruppierung (bei gleichem BPM/Tempo) bereits 15% de
 
 === Form-Editor
 
+image:de_form_editor.png[link="de_form_editor.png"]
+
 Im *Form-Editor* erstellt man die Stuktur eines Stückes. Dazu schaltet man die Takte in jeder
 Spur beliebig ein und aus. Man kann sich z.B. ein Schlagzeug vorstellen, dass drei Takte gleich
 spielt und jeden vierten Takt einen "Break" macht. In Patroneo braucht man dazu zwei Spuren. Dieses
@@ -183,6 +192,8 @@ anschließend direkt wieder zurückzusetzen.
 
 ==== Taktmodifikation: Transposition und Rhythmusveränderung
 
+image:de_modifications.png[link="de_modifications.png"]
+
 Die folgenden Funktionen können jederzeit im Bearbeiten-Menü nachgeschlagen werden, können aber nicht
 direkt von dort aufgerufen werden, sondern erfordern den Einsatz von Tastatur und Maus gleichzeitig
 während man mit dem Mauszeiger auf einen Takt im Formeditor (obere Hälfte des Bildschirms) zeigt.
@@ -254,10 +265,13 @@ Es wird zuerst die Schrittverzögerung und anschließend der Augmentierungs-Fakt
 
 ==== Spurgruppen
 
+
+image:de_trackgroups.png[link="de_trackgroups.png"]
+
 Spuren können in Gruppen zusammengefasst werden. Das ist nicht zu verwechseln mit den
 Rhythmusgruppen des Notenmusters.
 
-Gruppen haben zwei Eigenschaften: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
+Gruppen haben zwei Funktionen: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
 (Alle Spuren in einer Gruppen senden über den gleichen Port)
 
 Üblicherweise werden Gruppen benutzt um einzelne Spuren zu logischen "Instrumenten" zusammenzufassen.
@@ -286,6 +300,8 @@ aufgerufen werden:
 
 ==== Taktlängen einzelner Spuren verlängern
 
+image:de_pattern_multiplier.png[link="de_pattern_multiplier.png"]
+
 Zunächst sind in Patroneo alle Takte aller Spuren gleich lang, nämlich so wie man die Schritte pro
 Muster eingestellt hat (Startwert: 8).
 
@@ -309,6 +325,8 @@ gleichzeitig. Für anspruchsvollere Szenarios müssen externe JACK-Programme ben
 
 === Muster-Editor
 
+image:de_pattern_editor.png[link="de_pattern_editor.png"]
+
 Der *Muster-Editor* ermöglicht das eigentliche Komponieren. Dazu setzt man die Töne, auch
 "Schritte" genannt, um einen Takt zu bilden. Das Muster ist genau so lang wie ein Takt und wird von
 links nach rechts abgespielt. Man hat dabei einige Möglichkeiten zur klanglichen Gestaltung, die
@@ -354,6 +372,8 @@ aus. Die gesamte Reihe wird nun ein wiederkehrendes Muster von "X o o o X o o o.
 
 ==== Länge und Lautstärke
 
+image:de_velocities.png[link="de_velocities.png"]
+
 Ein *Schritt* ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet
 *Klingender Ton*. Ein klick mit der linken Maustaste schaltet die Schritte an und aus.
 
@@ -382,8 +402,11 @@ 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
 
+image:de_pitches.png[link="de_pitches.png"]
+
 Klicken Sie mit der mittleren Maustaste auf einen Schritt um den Ton zu hören, den dieser abspielt.
 Hiermit können Sie schonmal "vorhören", bevor Sie sich entscheidest einen Ton zu setzen. Tipp: Halten
 Sie die mittlere Maustaste gedrückt und fahren mit der Maus über die Schritte auf und ab.
@@ -413,6 +436,8 @@ sein.
 
 ==== Anzahl der möglichen Tonhöhen verändern
 
+image:de_pattern_height.png[link="de_pattern_height.png"]
+
 In der Werkzeugleiste in der Mitte, bei den Transpositions- und Tonleiteroptionen befindet sich
 eine Einstellmöglichkeiten um die Anzahl der möglichen Tonhöhen zu verändern.
 Der Startwert ist "8 Noten". Mögliche Werte sind 1 bis 127, dabei handelt es sich um Extremwerte.
@@ -428,6 +453,8 @@ Platz mehr für sie gibt.
 
 ==== Schatten
 
+image:de_shadows.png[link="de_shadows.png"]
+
 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
 *Schatten* anzeigen zu lassen. Dazu einfach mit der mittleren Maustaste auf die Spur klicken,
@@ -444,6 +471,8 @@ Tonhöhen sondern nur die markierten Kästchen an, egal was diese als Töne bede
 
 === Gruppierung im Muster
 
+image:de_timesig.png[link="de_timesig.png"]
+
 Die Gruppierung gehört zur Taktart.
 
 Wie bereits oben beschrieben stellt *Schritte pro Takt* die Länge des Musters ein. Patroneo startet
@@ -471,7 +500,9 @@ kommt jedoch immer mal wieder vor, dass man kleinere Rhythmuswerte braucht, als
 Wenn man einfach den Wert der Gruppierung erhöht erhält man zwar mehr Unterteilungen, die Anzahl
 der Schritte bleibt jedoch gleich. Ebenso bleiben die Noten genau in der "Spalte" stehen, in der
 sie vorher standen. In anderen Worten: die Musik wird anders klingen. Insgesamt wird auch der Takt
-kürzer, da die gleiche Anzahl von Schritten nun auf kürzere Schritte verteilt wird.
+kürzer, da die gleiche Anzahl an Schritten nun mit kürzeren Notenwerten belegt wird.
+
+image:de_convert_grouping.png[link="de_convert_grouping.png"]
 
 Patroneo bietet deswegen die Funktion *Gruppierung Umwandeln* (im Bearbeiten Menü), um die
 bestehende Taktstruktur zu verändern und bereits gesetzte Schritte so zu skalieren, dass die Musik
@@ -519,11 +550,13 @@ Programm selbst dokumentiert, sobald man den Menübefehl aufruft.
 
 ==== Hardware: AKAI APCmini
 
+image:akai_apc_mini.png[link="akai_apc_mini.png"]
+
 Das AKAI APCmini kann als Eingabehilfe benutzt werden.  Patroneo hat dafür je einen JACK-Midi
 Eingangs- und Ausgangsport: Einmal für die eigentliche Eingabe und dann zurück zum Gerät, um dessen
 LEDs zu steuern.
 
-Eine Bedienungsanleitung existiert nur in Videoform und auf Englisch und befindet sich in der
+Eine Bedienungsanleitung existiert nur in Videoform, und auf Englisch, und befindet sich in der
 Videotutorialseries (siehe Einleitung, unter "Schnellstart").
 
 Es mag ihnen vielleicht seltsam vorkommen, dass das nur für ein spezifisches Gerät angeboten wird.

documentation/out/english.html

@@ -540,6 +540,11 @@ Connect external synthesizers and samplers to create sounds.</p>
 </div>
 <div class="sect2">
 <h3 id="_basic_principles">1.2. Basic Principles</h3>
+<div class="imageblock">
+<div class="content">
+<a class="image" href="en_overview.png"><img src="en_overview.png" alt="en overview"></a>
+</div>
+</div>
 <div class="paragraph">
 <p>Patroneo organizes its music in tracks that contain measures. All measures of a track play the same
 "pattern" that creates music through a sequence of "steps".</p>
@@ -601,6 +606,9 @@ move it up or down to give more space to one or the other area.</p>
 <div class="sect2">
 <h3 id="_toolbar">2.1. Toolbar</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_toolbar.png"><img src="en_toolbar.png" alt="en toolbar"></a></span></p>
+</div>
+<div class="paragraph">
 <p>The <strong>Toolbar</strong> combines various commands with properties of the entire piece.</p>
 </div>
 <div class="paragraph">
@@ -653,12 +661,6 @@ off. The drop down list selects how long each of these steps is.</p>
 </ul>
 </div>
 <div class="paragraph">
-<p>Die Dauer der Schleife in Takten kann neben dem Schleifen-Knopf eingestellt werden.
-Zur Erinnerung: Die Schleife ist eine Funktion um Ideen auszuprobieren, während man komponiert.
-Sie ist sowohl technisch, als auch von der Benutzerführung her, nicht dafür geeignet während eines Liveauftritts
-oder während einer Aufnahme spontan verändert zu werden.</p>
-</div>
-<div class="paragraph">
 <p>The duration of the loop in measures can be set next to the loop button. As a reminder, the loop is
 a function to try out ideas while composing. It is not suitable, both technically and in terms of
 user interface, to be changed spontaneously during a live performance or recording, or during a
@@ -667,6 +669,9 @@ recording session.</p>
 <div class="sect3">
 <h4 id="_swing">2.1.1. Swing</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_swing.png"><img src="en_swing.png" alt="en swing"></a></span></p>
+</div>
+<div class="paragraph">
 <p><strong>Swing</strong> (also called shuffle) can be adjusted by a slider in percent. The slider
 is located on the far right of the toolbar. The slider is only visible when the group
 (see above) is set to either 2 or 4. Swing is also only applied in these groupings.</p>
@@ -686,6 +691,9 @@ With a grouping of 4 (same BPM/tempo) already 15% are clearly audible.</p>
 <div class="sect2">
 <h3 id="_form_editor">2.2. Form Editor</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_form_editor.png"><img src="en_form_editor.png" alt="en form editor"></a></span></p>
+</div>
+<div class="paragraph">
 <p>In the <strong>Form Editor</strong> you create the structure of a piece. To do this, the measures in each
 track can be switched on and off as desired. One can imagine, for example, a drum set that plays
 three bars in a row and makes a "break" every fourth bar. For this common drum technique you need
@@ -769,6 +777,9 @@ immediately afterwards.</p>
 <div class="sect3">
 <h4 id="_measure_modifications_transposition_and_rhythm">2.2.1. Measure Modifications: Transposition and Rhythm</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_modifications.png"><img src="en_modifications.png" alt="en modifications"></a></span></p>
+</div>
+<div class="paragraph">
 <p>The following functions can be looked up in the Edit menu at any time, but cannot be invoked
 directly from there, but require the use of keyboard and mouse at the same time. Use the keys while
 hovering the mouse pointer over a measure in the track editor (upper half of the screen).</p>
@@ -855,10 +866,13 @@ in quick succession and so on. This setting has no effect on augmented bars.</p>
 <div class="sect3">
 <h4 id="_track_groups">2.2.2. Track Groups</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_trackgroups.png"><img src="en_trackgroups.png" alt="en trackgroups"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Tracks can be grouped together. This is not to be confused with the rhythm groups of patters.</p>
 </div>
 <div class="paragraph">
-<p>Groups have two properties: they improve the clarity of layout and group JACK midiports together.
+<p>Groups have two functions: they improve the clarity of layout and group JACK midiports together.
 (All tracks in a group send via the same port).</p>
 </div>
 <div class="paragraph">
@@ -907,6 +921,9 @@ mouse click):</p>
 <div class="sect3">
 <h4 id="_extending_measure_lengths_of_individual_tracks">2.2.3. Extending Measure Lengths of Individual Tracks</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_pattern_multiplier.png"><img src="en_pattern_multiplier.png" alt="en pattern multiplier"></a></span></p>
+</div>
+<div class="paragraph">
 <p>At first, all measures of all tracks are of the same length in Patroneo, namely as you have set the
 steps per pattern (start value: 8).</p>
 </div>
@@ -939,6 +956,9 @@ scenarios, external JACK programs must be used.</p>
 <div class="sect2">
 <h3 id="_pattern_editor">2.3. Pattern Editor</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_pattern_editor.png"><img src="en_pattern_editor.png" alt="en pattern editor"></a></span></p>
+</div>
+<div class="paragraph">
 <p>The <strong>Pattern Editor</strong> is used for composing. The tones, also called "steps", are used to form a
 measure. The pattern is exactly as long as a measure and is played from left to right. There are
 several possibilities for tonal arrangement, which are now explained.</p>
@@ -1005,6 +1025,9 @@ now be a recurring pattern of "X o o o X o o o&#8230;&#8203;".</p>
 <div class="sect3">
 <h4 id="_duration_and_volume">2.3.2. Duration and Volume</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_velocities.png"><img src="en_velocities.png" alt="en velocities"></a></span></p>
+</div>
+<div class="paragraph">
 <p>A <strong>Step</strong> is a grey or coloured box. Grey means pause, coloured means <strong>Sounding Tone</strong>. A
 click with the left mouse button switches the steps on and off. A right click opens the context
 menu. Here you can switch all (currently visible) steps on, off or invert all: Off On becomes Off
@@ -1045,6 +1068,9 @@ on a step of that row.</p>
 <div class="sect3">
 <h4 id="_pitches_and_scales">2.3.3. Pitches and Scales</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_pitches.png"><img src="en_pitches.png" alt="en pitches"></a></span></p>
+</div>
+<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>
@@ -1084,6 +1110,9 @@ musically meaningful intervals, nor do they have to be sorted in ascending or de
 <div class="sect3">
 <h4 id="_changing_the_number_of_available_pitches">2.3.4. Changing the number of available pitches</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_pattern_height.png"><img src="en_pattern_height.png" alt="en pattern height"></a></span></p>
+</div>
+<div class="paragraph">
 <p>In the toolbar in the center, next to the transposition and scale options, there is a
 a setting option to change the number of available pitches.
 The starting value is "8 notes". Possible values are 1 to 127, but these are extreme values.
@@ -1101,6 +1130,9 @@ will remain, even if they become "invisible", because there is no more space for
 <div class="sect3">
 <h4 id="_shadows">2.3.5. Shadows</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_shadows.png"><img src="en_shadows.png" alt="en shadows"></a></span></p>
+</div>
+<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>Shadows</strong>.
 Just click with the middle mouse button on the track you want to see. This is only possible in the
@@ -1120,6 +1152,9 @@ in principle. They just show which steps are marked, nothing more.</p>
 <div class="sect2">
 <h3 id="_grouping_in_the_pattern">2.4. Grouping in the Pattern</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="en_timesig.png"><img src="en_timesig.png" alt="en timesig"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Grouping is part of the time signature.</p>
 </div>
 <div class="paragraph">
@@ -1183,7 +1218,10 @@ happens every now and then that you need smaller rhythm values than you thought
 If you simply increase the value of the grouping, you get more subdivisions, but the number of
 steps remains the same. Likewise, the notes remain exactly in the "column" in which they were
 previously placed. In other words, the music will sound different. Overall, the measure is also
-getting shorter, since the same number of steps is now used for shorter steps.</p>
+getting shorter, as the same number of steps is now assigned shorter note values.</p>
+</div>
+<div class="paragraph">
+<p><span class="image"><a class="image" href="en_convert_grouping.png"><img src="en_convert_grouping.png" alt="en convert grouping"></a></span></p>
 </div>
 <div class="paragraph">
 <p>Patroneo therefore offers the function <strong>Convert Grouping</strong> (in the Edit menu) to change the existing
@@ -1271,6 +1309,9 @@ itself when you use the menu command.</p>
 <div class="sect3">
 <h4 id="_hardware_akai_apcmini">2.5.2. Hardware: AKAI APCmini</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="akai_apc_mini.png"><img src="akai_apc_mini.png" alt="akai apc mini"></a></span></p>
+</div>
+<div class="paragraph">
 <p>The AKAI APCmini can be used as an input device.  Patroneo has a JACK-Midi input and output port
 for this purpose: once for the actual input and then back to the unit to control its LEDs.</p>
 </div>
@@ -1520,7 +1561,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 2021-12-19 20:29:30 +0100
+Last updated 2021-12-24 13:53:40 +0100
 </div>
 </div>
 </body>

documentation/out/german.html

@@ -527,6 +527,11 @@ wiederholen - oder auslassen - kann.</p>
 <div class="sect1">
 <h2 id="_bedienung">2. Bedienung</h2>
 <div class="sectionbody">
+<div class="imageblock">
+<div class="content">
+<a class="image" href="de_overview.png"><img src="de_overview.png" alt="de overview"></a>
+</div>
+</div>
 <div class="paragraph">
 <p>Im folgenden wird erklärt, wie Patroneo bedient wird.</p>
 </div>
@@ -618,6 +623,9 @@ oder anderen Bereich mehr Platz zu geben.</p>
 <div class="sect2">
 <h3 id="_werkzeugleiste">3.1. Werkzeugleiste</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_toolbar.png"><img src="de_toolbar.png" alt="de toolbar"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Die <strong>Werkzeugleiste</strong> kombiniert verschiedene Befehle mit Eigenschaften des gesamten Stückes.</p>
 </div>
 <div class="paragraph">
@@ -683,6 +691,9 @@ oder während einer Aufnahme spontan verändert zu werden.</p>
 <div class="sect3">
 <h4 id="_swing">3.1.1. Swing</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_swing.png"><img src="de_swing.png" alt="de swing"></a></span></p>
+</div>
+<div class="paragraph">
 <p><strong>Swing</strong> (auch Shuffle genannt) kann durch einen Schieberegler in Prozent eingestellt werden. Dieser
 befindet sich ganz rechts in der Werkzeugleiste. Der Regler wird erst sichtbar wenn die Gruppe
 (s.o.) auf entweder 2 oder 4 gesetzt wurde. Swing ist auch nur in diesen Gruppierungen
@@ -701,6 +712,9 @@ erlebt, während bei der 4er Gruppierung (bei gleichem BPM/Tempo) bereits 15% de
 <div class="sect2">
 <h3 id="_form_editor">3.2. Form-Editor</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_form_editor.png"><img src="de_form_editor.png" alt="de form editor"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Im <strong>Form-Editor</strong> erstellt man die Stuktur eines Stückes. Dazu schaltet man die Takte in jeder
 Spur beliebig ein und aus. Man kann sich z.B. ein Schlagzeug vorstellen, dass drei Takte gleich
 spielt und jeden vierten Takt einen "Break" macht. In Patroneo braucht man dazu zwei Spuren. Dieses
@@ -785,6 +799,9 @@ anschließend direkt wieder zurückzusetzen.</p>
 <div class="sect3">
 <h4 id="_taktmodifikation_transposition_und_rhythmusveränderung">3.2.1. Taktmodifikation: Transposition und Rhythmusveränderung</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_modifications.png"><img src="de_modifications.png" alt="de modifications"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Die folgenden Funktionen können jederzeit im Bearbeiten-Menü nachgeschlagen werden, können aber nicht
 direkt von dort aufgerufen werden, sondern erfordern den Einsatz von Tastatur und Maus gleichzeitig
 während man mit dem Mauszeiger auf einen Takt im Formeditor (obere Hälfte des Bildschirms) zeigt.</p>
@@ -877,11 +894,14 @@ Takte hat diese Einstellung keine Auswirkung.</p>
 <div class="sect3">
 <h4 id="_spurgruppen">3.2.2. Spurgruppen</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_trackgroups.png"><img src="de_trackgroups.png" alt="de trackgroups"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Spuren können in Gruppen zusammengefasst werden. Das ist nicht zu verwechseln mit den
 Rhythmusgruppen des Notenmusters.</p>
 </div>
 <div class="paragraph">
-<p>Gruppen haben zwei Eigenschaften: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
+<p>Gruppen haben zwei Funktionen: Sie erhöhen die Übersicht und fassen JACK-Midiports zusammen
 (Alle Spuren in einer Gruppen senden über den gleichen Port)</p>
 </div>
 <div class="paragraph">
@@ -931,6 +951,9 @@ aufgerufen werden:</p>
 <div class="sect3">
 <h4 id="_taktlängen_einzelner_spuren_verlängern">3.2.3. Taktlängen einzelner Spuren verlängern</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_pattern_multiplier.png"><img src="de_pattern_multiplier.png" alt="de pattern multiplier"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Zunächst sind in Patroneo alle Takte aller Spuren gleich lang, nämlich so wie man die Schritte pro
 Muster eingestellt hat (Startwert: 8).</p>
 </div>
@@ -963,6 +986,9 @@ gleichzeitig. Für anspruchsvollere Szenarios müssen externe JACK-Programme ben
 <div class="sect2">
 <h3 id="_muster_editor">3.3. Muster-Editor</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_pattern_editor.png"><img src="de_pattern_editor.png" alt="de pattern editor"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Der <strong>Muster-Editor</strong> ermöglicht das eigentliche Komponieren. Dazu setzt man die Töne, auch
 "Schritte" genannt, um einen Takt zu bilden. Das Muster ist genau so lang wie ein Takt und wird von
 links nach rechts abgespielt. Man hat dabei einige Möglichkeiten zur klanglichen Gestaltung, die
@@ -1032,6 +1058,9 @@ aus. Die gesamte Reihe wird nun ein wiederkehrendes Muster von "X o o o X o o o&
 <div class="sect3">
 <h4 id="_länge_und_lautstärke">3.3.2. Länge und Lautstärke</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_velocities.png"><img src="de_velocities.png" alt="de velocities"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Ein <strong>Schritt</strong> ist ein graues bzw. farbiges Kästchen. Grau bedeutet Pause, farbig bedeutet
 <strong>Klingender Ton</strong>. Ein klick mit der linken Maustaste schaltet die Schritte an und aus.</p>
 </div>
@@ -1069,6 +1098,9 @@ gedrückt und benutzt das Mausrad auf der jeweiligen Reihe.</p>
 <div class="sect3">
 <h4 id="_tonhöhen_skala_und_tonleiter">3.3.3. Tonhöhen, Skala und Tonleiter</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_pitches.png"><img src="de_pitches.png" alt="de pitches"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Klicken Sie mit der mittleren Maustaste auf einen Schritt um den Ton zu hören, den dieser abspielt.
 Hiermit können Sie schonmal "vorhören", bevor Sie sich entscheidest einen Ton zu setzen. Tipp: Halten
 Sie die mittlere Maustaste gedrückt und fahren mit der Maus über die Schritte auf und ab.</p>
@@ -1112,6 +1144,9 @@ sein.</p>
 <div class="sect3">
 <h4 id="_anzahl_der_möglichen_tonhöhen_verändern">3.3.4. Anzahl der möglichen Tonhöhen verändern</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_pattern_height.png"><img src="de_pattern_height.png" alt="de pattern height"></a></span></p>
+</div>
+<div class="paragraph">
 <p>In der Werkzeugleiste in der Mitte, bei den Transpositions- und Tonleiteroptionen befindet sich
 eine Einstellmöglichkeiten um die Anzahl der möglichen Tonhöhen zu verändern.
 Der Startwert ist "8 Noten". Mögliche Werte sind 1 bis 127, dabei handelt es sich um Extremwerte.
@@ -1130,6 +1165,9 @@ Platz mehr für sie gibt.</p>
 <div class="sect3">
 <h4 id="_schatten">3.3.5. Schatten</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_shadows.png"><img src="de_shadows.png" alt="de shadows"></a></span></p>
+</div>
+<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>Schatten</strong> anzeigen zu lassen. Dazu einfach mit der mittleren Maustaste auf die Spur klicken,
@@ -1151,6 +1189,9 @@ Tonhöhen sondern nur die markierten Kästchen an, egal was diese als Töne bede
 <div class="sect2">
 <h3 id="_gruppierung_im_muster">3.4. Gruppierung im Muster</h3>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="de_timesig.png"><img src="de_timesig.png" alt="de timesig"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Die Gruppierung gehört zur Taktart.</p>
 </div>
 <div class="paragraph">
@@ -1215,7 +1256,10 @@ kommt jedoch immer mal wieder vor, dass man kleinere Rhythmuswerte braucht, als
 Wenn man einfach den Wert der Gruppierung erhöht erhält man zwar mehr Unterteilungen, die Anzahl
 der Schritte bleibt jedoch gleich. Ebenso bleiben die Noten genau in der "Spalte" stehen, in der
 sie vorher standen. In anderen Worten: die Musik wird anders klingen. Insgesamt wird auch der Takt
-kürzer, da die gleiche Anzahl von Schritten nun auf kürzere Schritte verteilt wird.</p>
+kürzer, da die gleiche Anzahl an Schritten nun mit kürzeren Notenwerten belegt wird.</p>
+</div>
+<div class="paragraph">
+<p><span class="image"><a class="image" href="de_convert_grouping.png"><img src="de_convert_grouping.png" alt="de convert grouping"></a></span></p>
 </div>
 <div class="paragraph">
 <p>Patroneo bietet deswegen die Funktion <strong>Gruppierung Umwandeln</strong> (im Bearbeiten Menü), um die
@@ -1306,12 +1350,15 @@ Programm selbst dokumentiert, sobald man den Menübefehl aufruft.</p>
 <div class="sect3">
 <h4 id="_hardware_akai_apcmini">3.5.2. Hardware: AKAI APCmini</h4>
 <div class="paragraph">
+<p><span class="image"><a class="image" href="akai_apc_mini.png"><img src="akai_apc_mini.png" alt="akai apc mini"></a></span></p>
+</div>
+<div class="paragraph">
 <p>Das AKAI APCmini kann als Eingabehilfe benutzt werden.  Patroneo hat dafür je einen JACK-Midi
 Eingangs- und Ausgangsport: Einmal für die eigentliche Eingabe und dann zurück zum Gerät, um dessen
 LEDs zu steuern.</p>
 </div>
 <div class="paragraph">
-<p>Eine Bedienungsanleitung existiert nur in Videoform und auf Englisch und befindet sich in der
+<p>Eine Bedienungsanleitung existiert nur in Videoform, und auf Englisch, und befindet sich in der
 Videotutorialseries (siehe Einleitung, unter "Schnellstart").</p>
 </div>
 <div class="paragraph">
@@ -1566,7 +1613,7 @@ Ansonsten starten Sie patroneo mit diesem Befehl, Sprachcode ändern, vom Termin
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2021-12-19 20:29:30 +0100
+Last updated 2021-12-24 13:53:40 +0100
 </div>
 </div>
 </body>

documentation/patroneo.1

@@ -7,7 +7,7 @@ usage: patroneo [\-h] [\-v] [\-s DIRECTORY] [\-p] [\-m] [\-V]
 .PP
 Patroneo \- Version 2.3.0 \- Copyright 2022 by Laborejo Software Suite \-
 https://www.laborejo.org/patroneo
-.SS "optional arguments:"
+.SS "options:"
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 show this help message and exit

qtgui/resources.py

@@ -9,179 +9,6 @@
 from PyQt5 import QtCore
 
 qt_resource_data = b"\
-\x00\x00\x04\xfc\
-\x89\
-\x50\x4e\x47\x0d\x0a\x1a\x0a\x00\x00\x00\x0d\x49\x48\x44\x52\x00\
-\x00\x00\x26\x00\x00\x00\x1e\x08\x06\x00\x00\x00\x40\x14\x6c\x6e\
-\x00\x00\x00\x04\x73\x42\x49\x54\x08\x08\x08\x08\x7c\x08\x64\x88\
-\x00\x00\x00\x09\x70\x48\x59\x73\x00\x00\x03\xb4\x00\x00\x03\xb4\
-\x01\xd8\x39\x88\xbf\x00\x00\x00\x19\x74\x45\x58\x74\x53\x6f\x66\
-\x74\x77\x61\x72\x65\x00\x77\x77\x77\x2e\x69\x6e\x6b\x73\x63\x61\
-\x70\x65\x2e\x6f\x72\x67\x9b\xee\x3c\x1a\x00\x00\x00\x0b\x74\x45\
-\x58\x74\x54\x69\x74\x6c\x65\x00\x53\x68\x61\x70\x65\x26\xef\x99\
-\x91\x00\x00\x04\x62\x49\x44\x41\x54\x58\x85\xb5\x97\x5d\x4c\x5b\
-\x75\x18\xc6\x9f\xf7\x9c\xf2\x3d\xd6\x76\xa0\x63\xe8\xc2\x5a\xac\
-\x71\x94\x42\x34\xc4\xcc\x69\x08\xc4\x68\x62\x62\x30\x8e\x48\x30\
-\x3a\xe3\xe2\x85\xde\xb8\x68\x8c\xba\xb9\x0b\x13\xbd\xf1\x13\x33\
-\x2e\x4c\x8c\x66\x1a\x3f\x92\x05\x75\xd9\x84\xed\x82\xcc\x91\x90\
-\xb9\xc4\x8c\x7d\x40\x01\x49\x18\x2d\x6c\x8e\x39\x07\x96\x02\x2b\
-\x50\x7a\xce\xe3\x85\x80\xdd\xe9\x29\x3d\x94\xee\xb9\xeb\xfb\x7f\
-\xde\xf7\xfd\x35\xff\xaf\xf3\x17\x64\x40\xfe\xc0\xec\x66\x4d\x5b\
-\x28\x86\x6a\x2b\x50\x35\x4e\xce\xe4\xce\x8c\xef\xdc\xba\x75\x6e\
-\x3d\x35\x25\x9d\xa4\xae\x2e\xda\x8a\xcb\xc2\xbb\x40\x3c\x4d\x41\
-\x1d\x80\x12\x13\xdb\x65\x01\x3a\x00\x1c\xfd\xc3\x65\x3f\xd5\x24\
-\xa2\xdd\x36\x30\x92\x4a\x5f\x20\xfc\xb2\x08\xde\x01\x70\xf7\x1a\
-\x52\xfb\x85\xb2\xcf\x57\x6e\x3f\x9e\x71\xb0\xde\xd1\x29\x17\x74\
-\x7e\x27\x90\x87\xd7\x00\x64\x6c\xf7\x4b\x9e\x16\xdb\xed\xf1\x14\
-\x4d\x67\x04\xcc\x3f\x32\x55\x43\x41\x3b\xcc\xa7\x6c\x6d\x22\x07\
-\x45\x97\x06\x9f\xc7\x31\xb2\x9a\x4d\x49\x80\x08\x86\xea\x7a\x7a\
-\x98\xb5\xfc\x7b\x60\x6c\xa6\x82\x82\x5f\x33\x02\x05\x00\x22\x15\
-\x54\x71\xf2\xfc\xf0\xcc\x1d\xab\xda\x8c\x81\xbe\xe0\xd4\x21\x10\
-\x3e\x2a\x68\x12\xc1\x14\x74\x9c\x05\x51\x9e\x24\xff\x6f\x02\xdf\
-\xaa\x0a\x4f\x50\xcf\x1a\xcc\xd5\x16\xe6\x22\x59\x6a\x91\xa2\x49\
-\x05\x85\x0d\x00\x9e\x03\x50\x90\x24\xb7\x5b\x9d\xb3\x3f\xe6\xf5\
-\x4a\xd4\x6c\xd0\x96\x24\xa9\x46\x74\x5c\x00\xf1\x3b\xc4\x14\x4a\
-\x17\xe0\x53\x65\x2e\xfa\x5e\x2c\x27\x2f\x1f\x88\x6d\xf1\xb9\x37\
-\x5c\x5f\x1a\x9b\x06\x10\x04\x70\x7c\x20\x38\xfb\xae\xc6\xc5\x8f\
-\x01\x79\xde\xa4\x46\xad\x96\x1f\x7e\x0d\xc0\x47\x66\x00\x09\x53\
-\x19\x27\x3b\x04\x8f\x9b\xc4\xa3\x24\x9a\x7c\x6e\xc7\x5b\x5e\xef\
-\x9d\xb3\x36\xe8\x1b\x75\xc8\x6f\xfe\x91\xd0\x2e\xa3\xd1\xeb\xda\
-\xf0\x57\x95\xdb\xb9\x5b\x80\x37\x4d\x3b\x10\xfb\x07\xae\x84\x37\
-\xad\x15\xcc\x5c\x82\xbd\xd5\xe5\x8e\x9f\x0d\xd1\x02\x8a\xfc\xd4\
-\x37\x32\xf5\x01\xc9\x84\x9a\x3e\xb7\xe3\x13\x40\x5a\x4c\xaa\x39\
-\xb4\x45\xfd\xf5\xf5\x81\x11\x31\x08\x4e\x55\xb9\x1c\x5f\x24\x45\
-\x16\xbc\xed\x0f\x86\x0f\xf7\x8c\x8f\xe7\x1b\x07\xd5\xb9\x8d\xfb\
-\x01\x5c\x32\x49\x6b\x5c\x1f\x98\xc0\x06\xa2\xbe\x37\x10\x3a\x18\
-\xbf\x6b\x4d\xf4\x4c\xf6\x7c\xfe\x99\xc1\x40\xa8\x2c\x3e\xe8\xf5\
-\x4a\x94\xe0\xfb\x26\xfe\xed\x17\x47\xa6\xef\x4d\x1f\x6c\x09\x4f\
-\x20\x7b\x73\x36\x85\x4f\x5f\x08\x86\xb6\xad\xe2\xab\xd6\x20\x3d\
-\x7d\x81\x50\x6d\x7c\x30\x5f\xd3\x8f\x02\x48\xd8\x85\xa2\x68\x0f\
-\x59\x01\x63\x2a\x3a\x02\x0f\xda\x28\x67\xfb\x47\x43\xf5\xab\x78\
-\x8a\x01\xe9\xec\x0b\x86\x5e\x5c\x8e\x2d\x9d\xf8\x7d\x09\x10\xba\
-\x94\x5a\x01\x4b\x75\x1b\x04\x08\xb6\x92\x78\x76\x7e\xc2\x71\x3a\
-\x85\x37\x07\x94\xaf\x7b\x03\xa1\x83\x6d\xa4\xba\x54\x7e\xdc\x68\
-\xa2\x30\x01\x2c\xd9\x39\x16\xaf\x08\x80\x33\x14\x76\x28\x9a\x7e\
-\xc4\x77\x4f\xd1\x95\xf8\xc1\x81\x4b\x61\x0b\x25\xe2\x24\xb4\x25\
-\xcc\x89\x28\x8b\x56\xc1\x02\x00\x4e\x12\x7a\x47\xbe\xe6\xec\xf4\
-\x78\x64\x61\x6d\xdd\x57\xb4\x00\xe1\x2b\xd5\x2e\xe7\x37\x2b\x11\
-\xe2\x2e\xa3\x89\xe4\xb5\x94\x60\xcc\x9b\x7f\xb5\xba\xa4\xe4\x66\
-\x9a\x20\x2b\x12\x60\x82\x60\x63\x95\xcb\xd9\xbd\x1c\xfb\xef\x7e\
-\xd4\x2a\x13\xbc\x94\xab\x29\xc1\x32\x01\x05\xa0\x57\x05\x9f\xaa\
-\x70\x3b\xc7\xe2\x83\x59\xaa\xde\x4c\x40\x35\x78\x49\x3d\xd6\x6d\
-\x88\xa5\x71\xf2\xa7\xd6\x8f\xd1\xdc\xc8\x4e\x23\xd4\xd0\xd0\x8d\
-\x42\x82\x07\x12\xdc\x82\xf3\xd5\x9e\xa2\x3f\x6f\x27\x18\x41\x7c\
-\xe8\x73\xd9\x9b\x6b\x4a\x4b\x23\xb7\x0c\x90\x12\xcd\xce\xfa\x0a\
-\xc0\xe6\x04\x2e\xe2\xb0\x59\x31\x2b\xbb\xf2\x96\x06\xfe\xc0\x74\
-\x0b\x04\xff\x54\xb9\xed\xf1\xa7\xf8\x4d\x21\x5f\xf0\x95\x3b\x8f\
-\x18\x73\xba\xba\x68\xeb\x1f\x0d\xb7\x02\x68\x32\xf9\x2b\x57\x17\
-\xf2\x22\x9f\x9b\xf5\xb2\xfc\x69\xdd\x46\xaa\xf7\x8d\x86\xbf\x04\
-\xb1\x67\x29\xf5\x98\x68\x7c\x43\x17\x75\x46\x55\x62\x5b\x2a\xdd\
-\xce\x5e\x63\xce\xc5\xd1\xd0\xfd\xaa\xae\xb4\x12\x7c\xc4\xb4\x39\
-\xf9\x92\xaf\xdc\x79\x28\x6d\xb0\xe1\x61\xe6\xcc\xab\xe1\x1f\x08\
-\x18\x2f\xdc\x28\xc1\x4e\x11\x69\x57\x84\xc3\x42\x84\x62\xba\x14\
-\x29\x8a\x78\x49\x36\x00\xa8\x47\xf2\xe5\xd2\xe6\x73\xd9\x9b\x45\
-\xc4\xf4\xa6\xb1\x04\xb6\xf4\x55\xbb\xc7\x8a\xd7\x92\x04\xe7\xa2\
-\x39\x91\x5a\xe3\x5a\x8c\x97\xa5\xc5\x6f\x93\xac\x03\x10\x9c\xcb\
-\x10\x56\x77\x2c\xa6\x3e\xb1\x1a\x14\x60\x11\xac\x62\x5b\xc1\x35\
-\x35\x12\xad\x03\xf8\x3d\x2c\x5c\xf2\x49\xa4\x01\xd2\x32\x39\x66\
-\x7f\xf4\x01\x4f\xe1\x8d\x54\xe6\x35\xbf\xc4\x7b\x83\xe1\x1d\x42\
-\x7e\x06\x60\x87\xd5\x1c\x81\xb4\x2b\xaa\xb2\xcf\x5b\x56\x38\x68\
-\x3d\x27\x4d\xf9\x47\x67\xb6\x53\xd7\x1b\x01\x3e\x09\xa0\x12\xff\
-\xbf\x86\x74\x80\xd7\x49\x19\x12\xb0\x43\x74\x39\x96\xea\x0d\x99\
-\x51\xb0\x78\x91\x14\xff\xe5\xb0\x43\x34\x5b\xf6\xc4\x58\xc1\x64\
-\x7d\xbd\xc4\xd6\x5b\xf3\x5f\x2e\x0a\xbd\x45\xc2\xd5\x25\x47\x00\
-\x00\x00\x00\x49\x45\x4e\x44\xae\x42\x60\x82\
-\x00\x00\x03\x3c\
-\x89\
-\x50\x4e\x47\x0d\x0a\x1a\x0a\x00\x00\x00\x0d\x49\x48\x44\x52\x00\
-\x00\x00\x26\x00\x00\x00\x1e\x08\x06\x00\x00\x00\x40\x14\x6c\x6e\
-\x00\x00\x00\x04\x73\x42\x49\x54\x08\x08\x08\x08\x7c\x08\x64\x88\
-\x00\x00\x00\x09\x70\x48\x59\x73\x00\x00\x03\xb5\x00\x00\x03\xb5\
-\x01\x0a\x7e\x6a\x5b\x00\x00\x00\x19\x74\x45\x58\x74\x53\x6f\x66\
-\x74\x77\x61\x72\x65\x00\x77\x77\x77\x2e\x69\x6e\x6b\x73\x63\x61\
-\x70\x65\x2e\x6f\x72\x67\x9b\xee\x3c\x1a\x00\x00\x00\x0b\x74\x45\
-\x58\x74\x54\x69\x74\x6c\x65\x00\x53\x68\x61\x70\x65\x26\xef\x99\
-\x91\x00\x00\x02\xa2\x49\x44\x41\x54\x58\x85\xbd\x97\xcd\x4b\x54\
-\x51\x18\x87\x9f\xf7\x5e\x23\xec\xeb\x8e\x4a\xa1\x60\xda\x28\xd6\
-\xc2\x98\x89\xb2\x02\x8d\x42\x8a\x72\x61\x9b\x48\x6a\x59\x1b\x97\
-\xd5\x4e\xff\x80\x36\x2e\x5a\xb4\x89\xa0\x8d\xb4\x49\x32\x22\xab\
-\x85\x8b\x4a\x6a\xe1\xca\x42\x87\x8c\x4a\xfc\xca\x16\x42\x99\x73\
-\x8b\x9a\x4a\xef\x7d\x5b\xe8\x84\x44\xcc\x39\x3a\x73\xfd\x2d\x67\
-\x9e\xc3\x7d\xce\xef\x3d\x9c\x3b\x23\xa9\x89\xb4\x92\x23\xae\x14\
-\x55\xd4\xc7\xb7\xcc\xe6\x62\x4c\x19\x1e\xff\x72\x44\x1c\xb7\x32\
-\x19\xf7\x7a\x4c\xec\xc0\x80\x16\x95\x56\xa7\xaf\x39\x26\x50\x44\
-\x24\x1f\xa9\xd4\x64\xba\xdd\x11\xe7\x99\x03\x3b\x4c\xec\xe8\x8c\
-\x5f\x5a\x56\xed\xf7\x0b\x72\xa9\x28\x9f\x87\xe6\xca\xc0\x80\x16\
-\x95\x55\xf9\x57\x51\x3a\x6c\xf8\xe1\xf1\xaf\xbb\x83\x85\xf0\x21\