Browse Source

Add new screenshots to the manual

master
Nils 9 months ago
parent
commit
b1a865a6fa
  1. 4
      README.md
  2. 39
      documentation/english.adoc
  3. 39
      documentation/english.part.adoc
  4. 39
      documentation/german.adoc
  5. 39
      documentation/german.part.adoc
  6. BIN
      documentation/out/akai_apc_mini.png
  7. BIN
      documentation/out/de_convert_grouping.png
  8. BIN
      documentation/out/de_form_editor.png
  9. BIN
      documentation/out/de_modifications.png
  10. BIN
      documentation/out/de_overview.png
  11. BIN
      documentation/out/de_pattern_editor.png
  12. BIN
      documentation/out/de_pattern_height.png
  13. BIN
      documentation/out/de_pattern_multiplier.png
  14. BIN
      documentation/out/de_pitches.png
  15. BIN
      documentation/out/de_shadows.png
  16. BIN
      documentation/out/de_swing.png
  17. BIN
      documentation/out/de_timesig.png
  18. BIN
      documentation/out/de_toolbar.png
  19. BIN
      documentation/out/de_trackgroups.png
  20. BIN
      documentation/out/de_velocities.png
  21. BIN
      documentation/out/en_convert_grouping.png
  22. BIN
      documentation/out/en_form_editor.png
  23. BIN
      documentation/out/en_modifications.png
  24. BIN
      documentation/out/en_overview.png
  25. BIN
      documentation/out/en_pattern_editor.png
  26. BIN
      documentation/out/en_pattern_height.png
  27. BIN
      documentation/out/en_pattern_multiplier.png
  28. BIN
      documentation/out/en_pitches.png
  29. BIN
      documentation/out/en_shadows.png
  30. BIN
      documentation/out/en_swing.png
  31. BIN
      documentation/out/en_timesig.png
  32. BIN
      documentation/out/en_toolbar.png
  33. BIN
      documentation/out/en_trackgroups.png
  34. BIN
      documentation/out/en_velocities.png
  35. 59
      documentation/out/english.html
  36. 55
      documentation/out/german.html
  37. 2
      documentation/patroneo.1
  38. 384
      qtgui/resources.py

4
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

39
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.

39
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.

39
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.

39
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.

BIN
documentation/out/akai_apc_mini.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.9 MiB

BIN
documentation/out/de_convert_grouping.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

BIN
documentation/out/de_form_editor.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

BIN
documentation/out/de_modifications.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

BIN
documentation/out/de_overview.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB

BIN
documentation/out/de_pattern_editor.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 27 KiB

BIN
documentation/out/de_pattern_height.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

BIN
documentation/out/de_pattern_multiplier.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

BIN
documentation/out/de_pitches.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.1 KiB

BIN
documentation/out/de_shadows.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

BIN
documentation/out/de_swing.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

BIN
documentation/out/de_timesig.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.7 KiB

BIN
documentation/out/de_toolbar.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

BIN
documentation/out/de_trackgroups.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

BIN
documentation/out/de_velocities.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

BIN
documentation/out/en_convert_grouping.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

BIN
documentation/out/en_form_editor.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

BIN
documentation/out/en_modifications.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 KiB

BIN
documentation/out/en_overview.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB

BIN
documentation/out/en_pattern_editor.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
documentation/out/en_pattern_height.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 KiB

BIN
documentation/out/en_pattern_multiplier.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

BIN
documentation/out/en_pitches.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.8 KiB

BIN
documentation/out/en_shadows.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

BIN
documentation/out/en_swing.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.0 KiB

BIN
documentation/out/en_timesig.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.6 KiB

BIN
documentation/out/en_toolbar.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

BIN
documentation/out/en_trackgroups.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

BIN
documentation/out/en_velocities.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

59
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>

55
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>

2
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

384
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\