fishHymns - Add Hymn


Version: 1.1.1

There is no single "Add" screen.

The process consists of the following steps:

  1. Establish a name for the new midi file.
  2. If possible, get "Meter" and "Verses" from stored hymn books.
  3. Open the "Edit" dialog, defaulting to found information, if any.

Simple case

The "Use collections" option has not been set.

A simple dialog opens in which the name of the new midi file is entered.
If this name contains a reference to a stored hymn book, e.g. "(AHB 123)", then data will be retrieved from the stored hymn book.
An "Edit" dialog will be opened. It will show "Meter" and "Verses" values if they could be retrieved, else it will be empty.
On sucessfull completion of the dialog, the new midi file is generated.

Hymn Book case

The "Use collections" option has been set.
And the collection name matches a stored hymn book. e.g "AHB", (The Australian Hymn Book).

A standard file selection dialog opens, listing all the hymns in the hymn book.
Selecting one of these, sets the name of the new midi file to be the same as the list entry, minus the extension.
An "Edit" dialog will be opened with the "Meter" and "Verses" values set to those in the stored hymn book.
On sucessfull completion of the dialog, the new midi file is generated.

Other collections case

The "Use collections" option has been set.
And a corresponding collection exists for the selected midi folder.

A standard file selection dialog opens, allowing the selection of a folder represeting a corresponding collection.
Selecting one of these files, sets the name of the new midi file to be the same as the list entry, minus the extension.
If this name contains a reference to a stored hymn book, e.g. "(AHB 123)", then data will be retrieved from the stored hymn book.
An "Edit" dialog will be opened. It will show "Meter" and "Verses" values if they could be retrieved, else it will be empty.
On sucessfull completion of the dialog, the new midi file is generated.