diff --git a/README.html b/README.html
index 1cec1fe..f2145c3 100644
--- a/README.html
+++ b/README.html
@@ -395,13 +395,15 @@
MuseScore 2.x plugin - Not
This plugin for MuseScore 2.x reads chord (Harmony) texts and creates Chord notes in one added staff, and bass note in another added one if chosen. The created notes have correct durations according to the duration of the written chord, and are playable by MuseScore.
The plugin uses rules in wiki: Chord names and symbols (popular music) (as I understand them). All possible combinations of chords according to rules in that page are recognized and will generate notes.
The created notes are more of a suggestion, to get it to sound nice it's perhaps a good idea to move some notes one octave up or down, or just remove them.
-Example, before:
+
Example, before:
-After:
+
After:
Ran with default settings, and chose to manually add "pipe organ" with only 2 clefs (see Staves for Chord and bass notes).
The 7th in the last chord is manually moved down 1 octave after the plugin.
-Click to see another example that uses both options Write parsed Harmony texts and Write Chord letters with "Yes
". This example also shows some alternative ways of writing chords, and have some comments added.
+Click to see another example that uses default options except these:
+Octave for bass note: "Don't use
", Reduce chords: "None
", option Write parsed Harmony texts and Write Chord letters: "Yes
".
+This example also shows some alternative ways of writing chords, and have some comments added.
Idea from
This plugin was inspired from MuseScore 2.x plugin Generate Notes from Chords annotations.
How-To
@@ -410,7 +412,7 @@ How-To
Only the qml file is needed, but it can be a good idea to copy the folder into the plugin folder, partly to use test scores in sub folder test, and in the future perhaps translation files will be added.
Enable the plugin "notesFromChordTexts", and restart MuseScore.
Open a score with chord texts.
-Run the plugin via plugin > Chords > Notes from Chord texts
+Run the plugin via Plugins > Chords > Notes from Chord texts
The plugin adds two staves*, one for chord notes (called root chord) and one for bass notes*.
*The plugin starts with an option box, there you can set the options you want, see Options below. E.g. don't add bass notes.
The plugin will try to close the score when finished, then asking for <Save>
, <Discard>
or <Cancel>
. The reason is that the score will be in a bad state after the plugin have finished, and the added notes are not playable yet. So, do save/close.
@@ -420,35 +422,63 @@ How-To
Rules
Chords can be written in different ways, this plugin allows all alternatives described in used Chord rules, and some more. "Chord containing quarter tones" and "Polychords" are not implemented though.
Allowed synonyms for:
-Extensions
-
-m:
− (Unicode hx2212), -, min, minor
-maj:
^, Δ, ∆, M, j, ma, major
-aug:
+
-dim:
° ("degree"), o (low case)
-0 (zero):
Ø, ø
-sus4:
4, sus
-sus2:
2
-
-Alterations
-
-b:
♭ (Unicode), -, dim
-#:
♯ (Unicode), +, aug
-add:
dom, maj (maj
is not the same as #
according to used Chord rules)
-omit:
no, drop
-
-Alternative syntax and short ways
-
-- ending
0
same as 07
-- alone
^
same as maj7
(but not alone maj
; Cmaj
= C
, C^
= Cmaj7
)
-- only
[tone]+/aug
same as aug[tone]
, e.g. C7+
= C+7
-N.C.
(no chord) also allows N.C
, n.c.
and n.c
-
-Specials
-
-- Chord texts that starts with "
(
", or if it ends with ")
" without any "(
" before, will be totally ignored.
-alt
, lyd
and any only text in parentheses, e.g. (blues)
is just ignored. E.g. Calt
will generate a normal C
; C-E-G
, but the ignored part is shown as "Staff text" above staff #2.
-
+
+
+ | |
+
+ Extension |
+ Synonyms |
+
+ m | − (Unicode hx2212), -, min, minor |
+
+ maj | ^, t, Δ, ∆, M, j, ma, major (t only as "alone") |
+
+ aug | + |
+
+ dim | ° ("degree"), o (low case character) |
+
+ 0 (zero) | Ø, ø |
+
+ sus4 | 4, sus |
+
+ sus2 | 2 |
+
+ | |
+
+ Alteration |
+ Synonyms |
+
+ b | ♭ (Unicode), -, dim |
+
+ # | ♯ (Unicode), +, aug |
+
+ add | dom, maj (maj is not the same as # according to used Chord rules) |
+
+ omit | no, drop |
+
+ | |
+
+ Alternative syntax and short ways |
+
+ ending 0 | same as 07 |
+
+ alone ^ or t | same as maj7 (but not alone maj ; Cmaj = C , C^ = Cmaj7 ) |
+
+ only [tone]+/aug | same as aug[tone] , e.g. C7+ = C+7 |
+
+ N.C. (no chord) | also allows N.C , n.c. and n.c |
+
+ | |
+
+ Specials |
+
+ Chord texts that starts with "( ", or if it ends with ") " without any "( " before, will be totally ignored. |
+
+ alt , lyd and for only text in parentheses, e.g. (blues) is just ignored. E.g. Calt will generate a normal C ; C-E-G , but the ignored part is shown as "Staff text" above staff #2. |
+
+ | |
+
+
Notes
-
diff --git a/README.md b/README.md
index b4a2f16..384cf7a 100644
--- a/README.md
+++ b/README.md
@@ -12,15 +12,17 @@ The plugin uses rules in [wiki: Chord names and symbols (popular music)][1] (as
The created notes are more of a suggestion, to get it to sound nice it's perhaps a good idea to move some notes one octave up or down, or just remove them.
-Example, _before_:
+**Example, _before_:**
![Example before](https://github.com/per-d/notesFromChordTexts/raw/master/test/silent_night_test_before.PNG)
-_After_:
+**_After_**:
Ran with default settings, and chose to manually add "pipe organ" with only 2 clefs (see [__Staves for Chord and bass notes__](#staves-for-chord-and-bass-notes)).
The 7th in the last chord is manually moved down 1 octave after the plugin.
![Example after](https://github.com/per-d/notesFromChordTexts/raw/master/test/silent_night_test_after.PNG)
-[Click to see another example](https://github.com/per-d/notesFromChordTexts/raw/master/test/test_chords_after.PNG) that uses both options __Write parsed Harmony texts__ and __Write Chord letters__ with "`Yes`". This example also shows some alternative ways of writing chords, and have some comments added.
+[Click to see another example](https://github.com/per-d/notesFromChordTexts/raw/master/test/test_chords_after.PNG) that uses default options except these:
+__Octave for bass note:__ "`Don't use`", __Reduce chords:__ "`None`", option __Write parsed Harmony texts__ and __Write Chord letters:__ "`Yes`".
+This example also shows some alternative ways of writing chords, and have some comments added.
## Idea from
@@ -32,7 +34,7 @@ This plugin was inspired from MuseScore 2.x plugin [Generate Notes from Chords a
- Only the [qml file](https://github.com/per-d/notesFromChordTexts/raw/master/notesFromChordTexts.qml) is needed, but it can be a good idea to copy the folder into the plugin folder, partly to use test scores in sub folder [test](https://github.com/per-d/notesFromChordTexts/tree/master/test), and in the future perhaps translation files will be added.
- [Enable](https://musescore.org/en/handbook/plugins#enable-disable-plugins) the plugin "notesFromChordTexts", and restart MuseScore.
- Open a score with chord texts.
-- Run the plugin via ``plugin > Chords > Notes from Chord texts``
+- Run the plugin via ``Plugins > Chords > Notes from Chord texts``
- The plugin adds two staves*, one for chord notes (called root chord) and one for bass notes*.
- *The plugin starts with an option box, there you can set the options you want, see [__Options__](#options) below. E.g. don't add bass notes.
- The plugin will try to close the score when finished, then asking for ``, `` or ``. The reason is that the score will be in a bad state after the plugin have finished, and the added notes are not playable yet. So, do save/close.
@@ -44,31 +46,63 @@ Chords can be written in different ways, this plugin allows all alternatives des
__Allowed synonyms for:__
-_Extensions_
-- `m:` − (Unicode hx2212), -, min, minor
-- `maj:` ^, Δ, ∆, M, j, ma, major
-- `aug:` +
-- `dim:` ° ("degree"), o (low case)
-- `0 (zero):` Ø, ø
-- `sus4:` 4, sus
-- `sus2:` 2
-
-
-_Alterations_
-- `b:` ♭ (Unicode), -, dim
-- `#:` ♯ (Unicode), +, aug
-- `add:` dom, maj (`maj` is not the same as `#` according to [used Chord rules][1])
-- `omit:` no, drop
-
-_Alternative syntax and short ways_
-- ending `0` same as `07`
-- alone `^` same as `maj7` (but not alone `maj`; `Cmaj` = `C`, `C^` = `Cmaj7`)
-- only `[tone]+/aug` same as `aug[tone]`, e.g. `C7+` = `C+7`
-- `N.C.` (no chord) also allows `N.C`, `n.c.` and `n.c`
-
-_Specials_
-- Chord texts that starts with "`(`", or if it ends with "`)`" without any "`(`" before, will be totally ignored.
-- `alt`, `lyd` and any only text in parentheses, e.g. `(blues)` is just ignored. E.g. `Calt` will generate a normal `C`; `C-E-G`, but the ignored part is shown as "Staff text" above staff #2.
+
+
+ | |
+
+ Extension |
+ Synonyms |
+
+ m | − (Unicode hx2212), -, min, minor |
+
+ maj | ^, t, Δ, ∆, M, j, ma, major (t only as "alone") |
+
+ aug | + |
+
+ dim | ° ("degree"), o (low case character) |
+
+ 0 (zero) | Ø, ø |
+
+ sus4 | 4, sus |
+
+ sus2 | 2 |
+
+ | |
+
+ Alteration |
+ Synonyms |
+
+ b | ♭ (Unicode), -, dim |
+
+ # | ♯ (Unicode), +, aug |
+
+ add | dom, maj (maj is not the same as # according to used Chord rules) |
+
+ omit | no, drop |
+
+ | |
+
+ Alternative syntax and short ways |
+
+ ending 0 | same as 07 |
+
+ alone ^ or t | same as maj7 (but not alone maj ; Cmaj = C , C^ = Cmaj7 ) |
+
+ only [tone]+/aug | same as aug[tone] , e.g. C7+ = C+7 |
+
+ N.C. (no chord) | also allows N.C , n.c. and n.c |
+
+ | |
+
+ Specials |
+
+ Chord texts that starts with "( ", or if it ends with ") " without any "( " before, will be totally ignored. |
+
+ alt , lyd and for only text in parentheses, e.g. (blues) is just ignored. E.g. Calt will generate a normal C ; C-E-G , but the ignored part is shown as "Staff text" above staff #2. |
+
+ | |
+
+
## Notes
diff --git a/README.pdf b/README.pdf
new file mode 100644
index 0000000..71d9239
Binary files /dev/null and b/README.pdf differ
diff --git a/test/Test_Chords_save.mscz b/test/Test_Chords_save.mscz
index d71b2f1..24309f4 100644
Binary files a/test/Test_Chords_save.mscz and b/test/Test_Chords_save.mscz differ
diff --git a/test/test_chords_after.PNG b/test/test_chords_after.PNG
index 3654031..0d633ea 100644
Binary files a/test/test_chords_after.PNG and b/test/test_chords_after.PNG differ