KOMPLETNÍ PŘÍSTUPNOST CAPELLY 10
Verze balíku 6.29
Doplněk NVDA 6.27
Kde jsem 4.13
Kde jsem - nastavení 4.13
Prepare Partiture for Print 5.0 Safe

1. OBSAH BALÍKU

Složka NVDA_addon:
- capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon

Složka Capella_scripts:
- whereami_printscore_capella10_v4_13_complete.py
- whereami_printscore_settings_v4_13_complete.py
- PreparePartitureForPrint.py

Složka Documentation obsahuje český a anglický návod.
Podrobná dokumentace skriptu pro tisk je v podsložce
Prepare_Partiture_For_Print.

2. INSTALACE DOPLŇKU NVDA

1. Zavřete Capellu.
2. Otevřete soubor:
   capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon
3. Potvrďte instalaci doplňku.
4. Restartujte NVDA.
5. Teprve potom spusťte Capellu.

Verzi 6.27 lze nainstalovat přes předchozí verzi doplňku.

3. INSTALACE SKRIPTŮ CAPELLY

Skripty se neinstalují načítáním souborů přes Ctrl+F3.

Zkopírujte všechny tři soubory ze složky Capella_scripts do své uživatelské
složky skriptů Capelly:

Dokumenty\capella\scripts\

Mohou být také v některé její podsložce, kterou pro své skripty používáte.

Po zkopírování skriptů Capellu restartujte.

Ctrl+F3 otevře seznam skriptů v Capelle. Nejde o instalační dialog a
skriptům v něm nelze přiřazovat vlastní klávesové zkratky.

4. DŮLEŽITÉ VYSVĚTLENÍ CTRL+R

Ctrl+R není přiřazená zkratka Kde jsem ani jiného konkrétního skriptu.

Je to pevná funkce Capelly:

opakovat naposledy ručně spuštěný skript.

Proto se výsledek Ctrl+R mění podle toho, který skript jste naposledy
ručně spustili ze seznamu skriptů.

Příklad:

- ručně spustíte Kde jsem - nastavení;
- Ctrl+R potom zopakuje Kde jsem - nastavení;
- ručně spustíte Prepare Partiture for Print;
- Ctrl+R potom zopakuje Prepare Partiture for Print.

Ctrl+R proto nepoužívejte jako název ani údajnou přiřazenou zkratku
pro Kde jsem.

5. NUTNÉ NASTAVENÍ AUTOMATICKÉHO SLEDOVÁNÍ KDE JSEM

Aby Kde jsem fungovalo jako automatické sledování notového kurzoru,
musí být v Capelle vybráno jako skript pro zobrazení pozice.

V anglickém rozhraní Capelly:

1. Otevřete Extras.
2. Otevřete Preferences.
3. Vyberte General.
4. Najděte Position display by script.
5. Vyberte skript Where am I - Print Score.
6. Zapněte příslušnou volbu.
7. Nastavení potvrďte.

Automatické sledování se potom zapíná nebo vypíná položkou:

Extras → Position display by script

Když je sledování zapnuté, Capella volá Kde jsem automaticky po skutečném
pohybu notového kurzoru. Není k tomu potřeba a ani nelze přiřadit vlastní
klávesovou zkratku.

6. JEDINÉ NASTAVENÍ JAZYKA

Jazyk se nastavuje pouze zde:

Nastavení NVDA → Přístupnost Capelly

Vyberte češtinu nebo angličtinu a potvrďte tlačítkem OK.

Tato jediná volba řídí:

- hlášení doplňku NVDA;
- výběr předznamenání;
- výběr taktových čar;
- hlavní skript Kde jsem;
- dialog Kde jsem - nastavení.

Skript Kde jsem - nastavení již neobsahuje druhou volbu jazyka.

Texty, které poskytuje přímo anglické rozhraní Capelly, zůstávají
v angličtině.

7. POTLAČENÍ KDE JSEM PŘI ZADÁVÁNÍ NOT

V kategorii Přístupnost Capelly je volba:

Neotvírat Kde jsem automaticky po zadání nebo změně noty

Když je zaškrtnutá:

- Kde jsem se neotevře po první zadané notě;
- Kde jsem se neotevře ani po dalších zadaných notách;
- Kde jsem se neotevře po změně notového obsahu;
- při skutečném pohybu kurzoru se Kde jsem otevře normálně.

Správný kontrolní test:

1. Vytvořte novou prázdnou partituru.
2. Zadejte C, D a E.
3. Po žádné z těchto not se dialog Kde jsem nemá otevřít.
4. Pohněte notovým kurzorem šipkou.
5. Po pohybu kurzoru se má Kde jsem otevřít.

V dokumentaci se nemá počítat s žádným zvláštním spuštěním po první notě.

8. POUŽÍVÁNÍ KDE JSEM

Kde jsem se při zapnutém Position display by script spouští automaticky
po pohybu notového kurzoru.

Dialog obsahuje jedno pole s popisem aktuálního objektu. Textový kurzor
je na začátku pole.

Přímo v dialogu:

- šipka vlevo: předchozí objekt;
- šipka vpravo: následující objekt;
- Ctrl+šipka vlevo: předchozí takt;
- Ctrl+šipka vpravo: následující takt;
- šipka nahoru: předchozí hlas nebo osnova;
- šipka dolů: následující hlas nebo osnova.

Dialog se zavře, pohyb se provede v Capelle a Kde jsem se otevře na nové
pozici.

Kde jsem lze také jednou ručně spustit ze seznamu skriptů. Ctrl+R jej
potom zopakuje pouze tehdy, pokud je stále posledním ručně spuštěným
skriptem.

9. SCHRÁNKA

Každý nový obsah pole Kde jsem se automaticky a tiše uloží do schránky.

Platí to také pro obsah vytvořený při potlačeném automatickém dialogu
po změně notového zápisu.

Obsah lze vložit například do textového editoru pomocí Ctrl+V.

Kopírování se samo neohlásí a nepřidává žádný další text.

10. KDE JSEM - NASTAVENÍ

Skript:

whereami_printscore_settings_v4_13_complete.py

se spouští ručně ze seznamu skriptů Capelly.

Nelze mu přiřadit vlastní klávesovou zkratku. Po ručním spuštění jej může
Ctrl+R zopakovat, dokud ručně nespustíte jiný skript.

Nastavení obsahuje:

Kontext:
- takt a pozice v taktu;
- číslo objektu;
- číslo hlasu;
- číslo osnovy a nástroj;
- předznamenání;
- číslo systému.

Notační a grafické informace:
- připojené grafické objekty;
- artikulace;
- ligatury;
- obsah textových objektů;
- podrobnosti grafických objektů;
- potlačení posuvek, které již vyplývají z předznamenání.

MIDI:
- vypnuto;
- přehrát po stisku Enter;
- přehrát automaticky;
- délka;
- hlasitost.

Jazyk se v tomto dialogu nenastavuje.

11. PREFERENCES V CAPELLE

V dialogu Preferences doplněk zpřístupňuje pohyb kategoriemi:

- šipka nahoru: předchozí kategorie;
- šipka dolů: následující kategorie;
- NVDA+Alt+P: zopakovat aktuální položku, její roli, stav a hodnotu.

Toto chování platí pouze uvnitř dialogu Preferences.

12. PŘEDZNAMENÁNÍ

1. Otevřete v Capelle nativní dialog Insert Key Change.
2. Stiskněte NVDA+Alt+K.
3. Vyberte jednu z 15 standardních tónin.
4. Výběr potvrďte.
5. Původní dialog Capelly dokončete tlačítkem OK.

NVDA+Alt+K je zkratka doplňku NVDA, nikoli přiřazená zkratka skriptu
Capelly.

13. TAKTOVÉ ČÁRY

1. Otevřete v Capelle nativní dialog Insert Fixed Barline.
2. Stiskněte NVDA+Alt+B.
3. Vyberte jednu ze sedmi možností.
4. Výběr potvrďte.
5. Původní dialog Capelly dokončete tlačítkem OK.

NVDA+Alt+B je zkratka doplňku NVDA, nikoli přiřazená zkratka skriptu
Capelly.

14. PREPARE PARTITURE FOR PRINT

Skript:

PreparePartitureForPrint.py

se spouští ručně ze seznamu skriptů Capelly. Nelze mu přiřadit vlastní
klávesovou zkratku.

Po ručním spuštění tohoto skriptu bude Ctrl+R opakovat právě
Prepare Partiture for Print, dokud ručně nespustíte jiný skript.

Použití:

1. Doporučuje se nejprve partituru uložit.
2. Otevřete seznam skriptů Capelly pomocí Ctrl+F3.
3. Najděte Prepare Partiture for Print.
4. Skript ručně spusťte.
5. Vyberte Maximum measures per system v rozsahu 1 až 16.
6. Potvrďte dialog.
7. Přečtěte výsledkovou zprávu.
8. Jedním Ctrl+Z ověřte návrat původního rozložení.

Zvolené číslo je maximum. Skript může podle hustoty zápisu použít méně
taktů na systém.

Podrobný český návod:

Documentation\Prepare_Partiture_For_Print\NAVOD_CZ.txt

15. BEZPEČNOST SKRIPTU PRO TISK

Skript připraví a zkontroluje nový CAPX mimo otevřenou partituru.

Před načtením porovná přesnou XML posloupnost všech noteObjects.
Otevřenou partituru změní až po úspěšné kontrole.

Má zaregistrovat jedinou operaci Undo:

Prepare partiture for print

Jedno Ctrl+Z má vrátit původní stav.

Skript nepoužívá vlákna, ctypes, ovládání dialogů Windows ani automatické
odesílání Ctrl+R.

16. POTLAČENÁ RUŠIVÁ HLÁŠENÍ

Doplněk potlačuje přesně ověřené rušivé výstupy:

- samostatné hlášení 100 procent;
- Entire score;
- přechodný název dokumentu při návratu z Kde jsem;
- rušivé hlášení seskupení v tomto přechodném kontextu.

17. KONTROLA PO INSTALACI

1. Ověřte, že jsou všechny tři soubory v Dokumenty\capella\scripts\.
2. Restartujte NVDA a Capellu.
3. V Extras → Preferences → General nastavte
   Position display by script na Where am I - Print Score.
4. Zapněte Extras → Position display by script.
5. Vytvořte novou prázdnou partituru.
6. Zadejte C, D a E. Kde jsem se nesmí po žádné notě otevřít.
7. Pohněte kurzorem šipkou. Kde jsem se má otevřít.
8. Ověřte pohyb šipkami přímo v dialogu Kde jsem.
9. Pomocí Ctrl+V ověřte obsah schránky.
10. Ručně spusťte Kde jsem - nastavení ze seznamu skriptů.
11. Ověřte Preferences, NVDA+Alt+K a NVDA+Alt+B.
12. Na testovací partituře ručně spusťte Prepare Partiture for Print
    a ověřte výsledek i jedno Ctrl+Z.

18. DIAGNOSTICKÉ SOUBORY

Při problému mohou být užitečné:

- %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

Před novým testem lze příslušný log smazat, aby obsahoval pouze nový pokus.
