PREPARE PARTITURE FOR PRINT

Capella 10 Version 5.0 Safe Corrected package 6.29 documentation

1. INSTALLATION

Copy:

PreparePartitureForPrint.py

to:

Documents\capella\scripts\

or to a subfolder that you use inside that directory.

Restart Capella after copying the file.

Ctrl+F3 does not install or load the file. It opens the script list, where the already installed script can be found and started manually.

Custom keyboard shortcuts cannot be assigned to Capella scripts.

2. RUNNING THE SCRIPT

1. Open a score.
2. Saving it first is recommended.
3. Press Ctrl+F3 to open the script list.
4. Find Prepare Partiture for Print.
5. Start it manually.
6. Select a maximum of 1 to 16 measures per system.
7. Confirm the dialog.

Ctrl+R is not this script's shortcut. After the script is run manually, Capella's built-in Ctrl+R command repeats that last manually run script until another script is started manually.

3. PURPOSE

The script automatically rearranges measures into systems for printing.

The selected number is only an upper limit. Dense measures may lead to fewer measures on a system.

The script also sets conservative vertical clearance and disables unsafe horizontal compression.

4. SAFE PROCESS

1. Write the open score to a temporary CAPX.
2. Build the result outside the open score.
3. Validate staff and voice structure.
4. Divide content into measures.
5. Estimate required measure width.
6. Choose safe line breaks.
7. Build new systems.
8. Set vertical clearance.
9. Compare the exact XML sequence of every noteObject.
10. Validate measure count and the selected maximum.
11. Register one Undo operation.
12. Load the result with one score.read() operation.

5. UNDO

The Undo menu should contain one action:

Prepare partiture for print

One Ctrl+Z should restore the state from before the script was run.

6. ADAPTIVE LINE BREAKING

The calculation considers:

• note-column count;
• shortest note value;
• chord-head count;
• accidentals;
• dots;
• lyrics;
• text and graphic objects;
• available page width.

The selected maximum must not be exceeded and unsafe compression should not be required.

7. MUSICAL-CONTENT VALIDATION

Before loading the result into Capella, the exact XML sequence of all note objects in every staff and voice is compared.

On any difference the script stops with an error and the open score is intended to remain unchanged.

8. LIMITATIONS

The script intentionally refuses a score, for example, when:

• staff or voice counts change between systems;
• non-musical objects occur inside systems;
• a note or rest incorrectly crosses a measure boundary;
• one measure is too dense;
• a noteRange object cannot be preserved safely;
• no safe line-breaking solution exists.

9. MOZART DUO NO. 1 K487 TEST

The original offline test used 56 measures and a maximum of 8.

The result had 18 systems.

Before and after there were:

• 599 chords;
• 16 rests;
• 599 note heads;
• 27 ties;
• 10 accidentals;
• 2 barlines.

The exact noteObjects sequence matched.

Final rendering and actual Undo must still be verified directly in Capella 10.

10. IMPORTANT CTRL+R NOTE

The script itself does not send Ctrl+R automatically.

Ctrl+R is Capella's general built-in command for repeating the last manually run script. It is not an assigned Prepare Partiture for Print keyboard shortcut.