(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 ======

{{:wiki:jwaccidentals:mainwindow.png?500|}}


^ 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 ======


{{:wiki:jwaccidentals:profileeditor.png?500|}}

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