From 0b07fdddabeab199c11c331e28585644b816dfac Mon Sep 17 00:00:00 2001 From: per-d Date: Tue, 22 Oct 2019 01:06:51 +0200 Subject: [PATCH] Documents adjusted for issue #2 And a review --- README.html | 96 ++++++++++++++++++++++++------------- README.md | 92 ++++++++++++++++++++++++----------- README.pdf | Bin 0 -> 779884 bytes test/Test_Chords_save.mscz | Bin 7138 -> 7102 bytes test/test_chords_after.PNG | Bin 74899 -> 76260 bytes 5 files changed, 126 insertions(+), 62 deletions(-) create mode 100644 README.pdf 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:
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.
Example after

-

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

    - -

    Alterations

    - -

    Alternative syntax and short ways

    - -

    Specials

    - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ExtensionSynonyms
    m− (Unicode hx2212), -, min, minor
    maj^, t, Δ, ∆, M, j, ma, major (t only as "alone")
    aug+
    dim° ("degree"), o (low case character)
    0 (zero)Ø, ø
    sus44, sus
    sus22
    AlterationSynonyms
    b♭ (Unicode), -, dim
    #♯ (Unicode), +, aug
    adddom, maj (maj is not the same as # according to used Chord rules)
    omitno, drop
    Alternative syntax and short ways
    ending 0same as 07
    alone ^ or tsame as maj7 (but not alone maj; Cmaj = C, C^ = Cmaj7)
    only [tone]+/augsame 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