(This documentation reflects version 1.02 of the plug-in.)

The JW Accidentals plug-in is a tool to find cautionary accidentals in your documents.

The user interface contains 2 different parts: the main window and the Profile Editor Window.

Main Window

User Interface Element Explanation
Profile Settings popup The list of the available settings profiles.
Profile… button Opens the Profile Editor, where custom settings can be stored in tailor-made profiles.
Scan button Pressing this will scan the selected area, using the selected Profile.
Scan+Change button Pressing the button will scan and change the region directly. The results from the scan will not be listed in the report list, so use it with care.
Close button Closes the main window.
Location details When a proposed cautionary accidental is highlighted in the report list, the location text above the report list contains the detailed information about where the accidental and its reference can be found.
Report list Contains the suggested accidentals found during the scan. Mark the accidentals that should be changed with a check mark to the left. Highlight a suggested to enable the buttons to the bottom left. Double-click on the list to toggle the check marks between “all ON” and “all OFF”.
( ) Toggle button Toggles the parenthesis state for the highlighted accidental in the report list.
View button Pressing this will make sure the measure for the highlighted accidental line is visible on screen. The selected region will not change.
[ ] button This button toggles between 2 or 3 different selections in the document for the highlighted accidental line ⇒ The scanned region
The area around the note with the proposed accidental
The area around the note with the reference note (if available)
Change Checked button Processes the checked proposed accidentals in the report list.
Respace if necessary checkbox Check this if the music should be automatically spaced in the spots where the accidentals were added. Both score and parts are respaced, but only in the changed measures/parts.

Profile Editor Window

Options Description
Cross-Stave Checks Controls if note material on other staves should be compared with the staff.
Layers as Independent Instruments Controls if multiple layers on a staff should be treated as independent voices, where each layer would require its own set of accidentals. Example: 2 woodwind parts in layers on the same staff.
Chord Lines as Independent Instruments Controls if chord lines should be treated as independent voices, where each line would require its own set of accidentals. Example: chordal string divisi parts on one staff.
Grand Staff as 1 Instrument Controls if a grand staff should be treated as one instrument rather than as 2 (or 3) staves. On Finale 2012, grand staves are controlled by the Score Manager. On earlier Finale versions, the plug-in is guessing that a grand staff is a group with 2 staves with piano braces and a group name.
Independent Octaves on Same Instrument If set, each octave require its own set of accidentals on an instrument.
Independent Octaves on Cross-Instrument If set, each octave across the different instruments require its own set of accidentals.
Restate Differences After Key Sig Change Controls if notes that differ compare to the previous key signature should be restated, even if it's in the new key signature. Example: if a 'F natural' appears in C major after a passage in A Major, that's a note that might need a cautionary accidental (since F Sharp is used in A Major).
No Courtesy after 1 Measure Rest If set, if the scan encounters a hole in the music material of one measure or more, all courtesy accidentals are reset after the rest.
Restate After Grace Note Accidental Controls if the main note should get an accidental if the previous accidental was set on a grace note. This option only works within one measure.
Courtesy Freeze If set, freezes the accidental state for the added accidentals.
Cautionary Parentheses Options Description
On Same Beat Controls cautionary accidental parentheses where conflicts appear on the very same beat.
In Same Measure Controls cautionary accidental parentheses where the proposed accidental would be added in the same measure as the reference note.
In Next Measure Controls cautionary accidental parentheses where the proposed accidental would be added to the measure after the reference note.
In 2nd Measure and Forward Controls cautionary accidental parentheses where the proposed accidental would be added to the 2nd (or longer) measure after the reference note.
After Key Sig Change Control cautionary accidental parentheses after a key signature change.
After Grace Note Controls cautionary accidental parentheses on a main note after a grace note accidental.