COMPLETE CAPELLA 10 ACCESSIBILITY
Package version 6.29
NVDA add-on 6.27
Where Am I 4.13
Where Am I - Settings 4.13
Prepare Partiture for Print 5.0 Safe

1. PACKAGE CONTENTS

NVDA_addon:
- capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon

Capella_scripts:
- whereami_printscore_capella10_v4_13_complete.py
- whereami_printscore_settings_v4_13_complete.py
- PreparePartitureForPrint.py

Documentation contains complete Czech and English instructions.
Detailed print-script documentation is in Prepare_Partiture_For_Print.

2. INSTALLING THE NVDA ADD-ON

1. Close Capella.
2. Open:
   capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon
3. Confirm installation.
4. Restart NVDA.
5. Start Capella only after NVDA has restarted.

Add-on version 6.27 can be installed over an earlier version.

3. INSTALLING THE CAPELLA SCRIPTS

The scripts are not installed by loading files through Ctrl+F3.

Copy all three files from Capella_scripts to the Capella user-script
directory:

Documents\capella\scripts\

They may also be placed in a subfolder that you use for your scripts.

Restart Capella after copying the files.

Ctrl+F3 opens Capella's script list. It is not an installation dialog,
and custom keyboard shortcuts cannot be assigned to Capella scripts there.

4. IMPORTANT: WHAT CTRL+R DOES

Ctrl+R is not an assigned shortcut for Where Am I or for another specific
script.

It is Capella's built-in command to:

repeat the last script that was run manually.

Its result therefore depends on which script was most recently started
manually from Capella's script list.

Example:

- manually run Where Am I - Settings;
- Ctrl+R now repeats Where Am I - Settings;
- manually run Prepare Partiture for Print;
- Ctrl+R now repeats Prepare Partiture for Print.

Do not document Ctrl+R as a dedicated or assigned Where Am I shortcut.

5. REQUIRED AUTOMATIC WHERE AM I CONFIGURATION

For Where Am I to track the score cursor automatically, it must be selected
as Capella's position-display script.

In the English Capella interface:

1. Open Extras.
2. Open Preferences.
3. Select General.
4. Find Position display by script.
5. Select Where am I - Print Score.
6. Enable the corresponding option.
7. Confirm the settings.

Automatic tracking is then turned on or off with:

Extras → Position display by script

When tracking is enabled, Capella calls Where Am I automatically after a
real score-cursor movement. No custom script shortcut is needed or available.

6. THE SINGLE LANGUAGE SETTING

Language is configured only in:

NVDA Settings → Capella accessibility

Choose Czech or English and confirm with OK.

This single choice controls:

- messages generated by the NVDA add-on;
- the key-signature chooser;
- the barline chooser;
- the main Where Am I script;
- the Where Am I - Settings dialog.

Where Am I - Settings no longer contains a second language selector.

Text supplied directly by Capella's English user interface remains English.

7. SUPPRESSING WHERE AM I DURING NOTE ENTRY

The Capella accessibility category contains:

Do not open Where Am I automatically after note entry or a score edit

When checked:

- Where Am I does not open after the first entered note;
- it does not open after later entered notes;
- it does not open after score-content edits;
- it still opens normally after a real cursor movement.

Correct test:

1. Create a new blank score.
2. Enter C, D and E.
3. Where Am I must not open after any of these notes.
4. Move the score cursor with an arrow key.
5. Where Am I should open after that cursor movement.

The documentation must not expect any special invocation after the first note.

8. USING WHERE AM I

With Position display by script enabled, Where Am I starts automatically
after score-cursor movement.

The dialog contains one field describing the current object. The text cursor
starts at the beginning of the field.

Inside the dialog:

- Left Arrow: previous object;
- Right Arrow: next object;
- Ctrl+Left Arrow: previous measure;
- Ctrl+Right Arrow: next measure;
- Up Arrow: previous voice or staff;
- Down Arrow: next voice or staff.

The dialog closes, Capella performs the movement and Where Am I opens at
the new position.

Where Am I can also be started once manually from Capella's script list.
Ctrl+R repeats it only while it remains the last manually started script.

9. CLIPBOARD

Every new Where Am I field is copied to the clipboard silently.

This also applies to content generated while the automatic dialog is
suppressed after a score edit.

Paste it into a text editor with Ctrl+V.

Copying is not announced and no extra text is added.

10. WHERE AM I - SETTINGS

Script:

whereami_printscore_settings_v4_13_complete.py

is started manually from Capella's script list.

A custom keyboard shortcut cannot be assigned to it. After it has been run
manually, Ctrl+R repeats it until another script is run manually.

It configures:

Context:
- measure and position;
- object number;
- voice number;
- staff number and instrument;
- key signature;
- system number.

Notation and graphic information:
- attached graphic objects;
- articulations;
- ties;
- text-object content;
- detailed graphic information;
- suppression of accidentals already implied by the key signature.

MIDI:
- off;
- play after pressing Enter;
- play automatically;
- duration;
- volume.

Language is not configured in this dialog.

11. CAPELLA PREFERENCES

Inside Preferences the add-on provides:

- Up Arrow: previous category;
- Down Arrow: next category;
- NVDA+Alt+P: repeat the current item, role, state and value.

This behavior applies only inside Preferences.

12. KEY SIGNATURES

1. Open Capella's native Insert Key Change dialog.
2. Press NVDA+Alt+K.
3. Select one of the 15 standard keys.
4. Confirm the selection.
5. Complete Capella's original dialog with OK.

NVDA+Alt+K is an NVDA add-on gesture, not an assigned Capella-script
shortcut.

13. BARLINES

1. Open Capella's native Insert Fixed Barline dialog.
2. Press NVDA+Alt+B.
3. Select one of the seven choices.
4. Confirm the selection.
5. Complete Capella's original dialog with OK.

NVDA+Alt+B is an NVDA add-on gesture, not an assigned Capella-script
shortcut.

14. PREPARE PARTITURE FOR PRINT

Script:

PreparePartitureForPrint.py

is started manually from Capella's script list. A custom keyboard shortcut
cannot be assigned to it.

After this script is started manually, Ctrl+R repeats Prepare Partiture for
Print until another script is started manually.

Use:

1. Saving the score first is recommended.
2. Open Capella's script list with Ctrl+F3.
3. Find Prepare Partiture for Print.
4. Start it manually.
5. Select Maximum measures per system from 1 to 16.
6. Confirm the dialog.
7. Read the completion report.
8. Verify restoration of the original layout with one Ctrl+Z.

The selected number is an upper limit. The script may use fewer measures
per system when notation is dense.

Detailed English instructions:

Documentation\Prepare_Partiture_For_Print\INSTRUCTIONS_EN.txt

15. PRINT-SCRIPT SAFETY

The script builds and validates a new CAPX outside the open score.

Before loading it, the script compares the exact XML sequence of every
noteObject. The open score changes only after successful validation.

It should register one Undo action:

Prepare partiture for print

One Ctrl+Z should restore the original state.

The script uses no threads, ctypes, Windows dialog automation or automatic
sending of Ctrl+R.

16. SUPPRESSED NUISANCE ANNOUNCEMENTS

The add-on suppresses specifically verified nuisance output:

- a standalone 100 percent announcement;
- Entire score;
- the transient document title while returning from Where Am I;
- the grouping announcement in that transient context.

17. POST-INSTALLATION TEST

1. Confirm that all three files are in Documents\capella\scripts\.
2. Restart NVDA and Capella.
3. In Extras → Preferences → General set
   Position display by script to Where am I - Print Score.
4. Enable Extras → Position display by script.
5. Create a new blank score.
6. Enter C, D and E. Where Am I must not open after any note.
7. Move the cursor with an arrow key. Where Am I should open.
8. Test arrow navigation inside the Where Am I dialog.
9. Paste the clipboard contents with Ctrl+V.
10. Start Where Am I - Settings manually from the script list.
11. Test Preferences, NVDA+Alt+K and NVDA+Alt+B.
12. On a test score, start Prepare Partiture for Print manually and verify
    the result and one Ctrl+Z.

18. DIAGNOSTIC FILES

Useful diagnostic files:

- %TEMP%\capella_whereami_edit_diagnostic.log
- %TEMP%\capella_whereami_edit_diagnostic_state.txt
- %TEMP%\capella_whereami_navigation.log
- %TEMP%\capella_entire_score_filter.log
- %TEMP%\capella_whereami_settings_export.log

A relevant log can be deleted before a new test so that it contains only
the new attempt.
