1. Co balík obsahuje

Doplněk NVDA 6.27.0 Complete

Soubor capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon. Zpřístupňuje Preferences, volbu předznamenání a taktových čar, obsluhuje navigaci z dialogu Kde jsem a filtruje několik přesně určených rušivých hlášení. Metadata doplňku uvádějí minimální NVDA 2023.1 a poslední testovanou verzi NVDA 2026.1.

Kde jsem 4.13 Complete

Soubor whereami_printscore_capella10_v4_13_complete.py. Z dat otevřené partitury sestaví přístupný textový popis aktuálního objektu.

Kde jsem – nastavení 4.13 Complete

Soubor whereami_printscore_settings_v4_13_complete.py. Určuje zobrazovaný kontext, notační podrobnosti a chování MIDI.

Prepare Partiture for Print 5.0 Safe

Soubor PreparePartitureForPrint.py. Adaptivně rozdělí takty do systémů pro tisk, ale změnu načte do otevřené partitury teprve po kontrole hudebního obsahu.

Tři soubory .py jsou přímo spustitelné zdrojové skripty Capelly; doplněk NVDA je dodán jako instalační soubor .nvda-addon. V kořeni archivu jsou také soubory README_FIRST.txt a VERSION.txt.

Složka Documentation obsahuje hlavní český a anglický návod ve formátech TXT a HTML, stručné přehledy oprav dokumentace a podsložku Prepare_Partiture_For_Print. V ní jsou české a anglické návody k tiskovému skriptu, soubor README_CZ_ORIGINAL.txt a dvě jazykové varianty zprávy o stejném offline testu na Mozartově duu: TEST_REPORT_MOZART_ORIGINAL.txt a TEST_REPORT_MOZART_EN.txt.

Archiv neobsahuje soubor SHA256SUMS.txt, soubory s kontrolními součty ani samostatné zprávy o ověření všech součástí balíku.

2. Instalace krok za krokem

Doplněk NVDA

1. Stáhněte a rozbalte kompletní balík.
2. Zavřete Capellu.
3. Otevřete soubor NVDA_addon/capellaDialogAccessibility-6.27.0-COMPLETE.nvda-addon.
4. Potvrďte instalaci a restartujte NVDA.
5. Capellu spusťte až po restartování NVDA.

Při přechodu z balíku 6.26 lze doplněk 6.27 nainstalovat přímo přes starší verzi.

Skripty Capelly

1. Zkopírujte všechny tři soubory ze složky Capella_scripts do uživatelské složky Dokumenty\capella\scripts\. Mohou být i v její podsložce, kterou pro skripty používáte.
2. Po zkopírování nebo výměně souborů Capellu restartujte.
3. Klávesami Ctrl + F3 otevřete seznam již nainstalovaných skriptů a ověřte, že v něm všechny tři najdete.

Ctrl + F3 není instalační dialog. Soubory se přes něj nenačítají a skriptům Capelly nelze přiřazovat vlastní klávesové zkratky.

Co přesně znamená Ctrl + R

Ctrl + R není zkratka Kde jsem ani jiného konkrétního skriptu. Jde o pevnou funkci Capelly: opakovat naposledy ručně spuštěný skript. Výsledek se proto mění podle toho, který skript jste naposledy ručně spustili ze seznamu.

• Ručně spustíte Kde jsem – nastavení: Ctrl + R potom opakuje tento nastavovací skript.
• Ručně spustíte Prepare Partiture for Print: Ctrl + R potom opakuje tiskový skript.
• Ručně spustíte Kde jsem: Ctrl + R jej opakuje jen do chvíle, než ručně spustíte jiný skript.

Společný jazyk

Čeština nebo angličtina se nastavuje jen na jednom místě:

1. Otevřete nabídku NVDA.
2. Zvolte Nastavení > Nastavení NVDA.
3. Vyberte kategorii Přístupnost Capelly.
4. Vyberte češtinu nebo angličtinu a potvrďte tlačítkem OK.

Tato jediná volba řídí hlášení doplňku, seznamy předznamenání a taktových čar, výstup Kde jsem i dialog Kde jsem – nastavení. Texty pocházející přímo z anglického rozhraní Capelly se nepřekládají.

3. Co dělá doplněk NVDA

Doplněk obsahuje aplikační modul pro Capellu a globální panel nastavení. Je záměrně úzce zaměřený na ověřené dialogy a situace. Neprovádí plošné změny celého stromu přístupnosti.

• zpřístupňuje navigaci kategoriemi dialogu Preferences;
• doplňuje čtení názvu, role, stavu a hodnoty aktuálního prvku;
• otevírá přístupný seznam patnácti standardních předznamenání;
• otevírá přístupný seznam sedmi pevných taktových čar;
• zpracovává šipky v dialogu Kde jsem a předává vlastní pohyb Capelle;
• udržuje jedno společné nastavení jazyka pro doplněk i oba skripty Kde jsem;
• volitelně potlačuje automatické otevření Kde jsem po zadání, změně nebo smazání noty;
• potlačuje pouze přesně rozpoznané rušivé hlášení 100 procent, Entire score a přechodný název dokumentu nebo seskupení při návratu z Kde jsem.

Filtry nejsou obecné. Samostatné hlášení se odstraní jen tehdy, když se po spojení všech mluvených částí přesně rovná 100%. Tím se omezuje riziko, že doplněk zamlčí jiné užitečné informace.

4. Jak se zpřístupnil dialog Preferences

Capella používá v levé části Preferences seznam kategorií, se kterým se NVDA bez úpravy neovládá spolehlivě. Doplněk zasahuje pouze v dialogu s přesným názvem Preferences a pouze tehdy, když je fokus na položce levého seznamu kategorií.

Šipka nahoru

Přejde na předchozí kategorii.

Šipka dolů

Přejde na následující kategorii.

NVDA + Alt + P

Zopakuje aktuální položku včetně názvu, role, stavu a dostupné hodnoty.

Doplněk nejprve vyhledá pouze přímé sourozence zaměřené položky v levém panelu. Ověřuje jejich roli, polohu, rozměry a dostatečný počet položek, aby si seznam kategorií nespletl s jiným krátkým seznamem. Vybranou kategorii aktivuje přes UI Automation a kontrolované kliknutí, ověří její stav a oznámí název právě jednou.

Zaškrtávací políčka, tlačítka, editační pole a další běžné prvky dál čte samotné NVDA. U rozbalovacích seznamů doplněk skládá jedno úplné hlášení z názvu, role, hodnoty a stavu, aby nevznikala dvojitá nebo neúplná oznámení. Mimo Preferences se šipky předají Capelle beze změny.

5. Jak se zpřístupnilo předznamenání neboli Key signature

Nativní dialog Insert Key Change zobrazuje tóniny v grafické ploše. Doplněk nad ní vytvoří vlastní přístupný seznam:

1. V Capelle otevřete dialog Insert Key Change.
2. Stiskněte NVDA + Alt + K.
3. Šipkami vyberte jednu z patnácti standardních tónin: od sedmi béček přes C dur a a moll bez předznamenání až po sedm křížků.
4. Výběr potvrďte klávesou Enter.
5. Doplněk oznámí zvolenou tóninu. Změnu nakonec potvrďte tlačítkem OK v původním dialogu Capelly.

Technicky doplněk vyhledá největší nepojmenovanou grafickou skupinu v dialogu a ověří její rozměry a poměr stran proti známému rozložení. Patnáct cílů je uloženo relativně k ploše, takže lze dopočítat jejich skutečné souřadnice. Po výběru se nativní dialog vrátí do popředí a doplněk kontrolovaně klikne na odpovídající místo. Původní poloha ukazatele myši se následně obnoví.

Jestliže rozměry dialogu neodpovídají ověřenému rozložení, doplněk výběr odmítne a oznámí chybu. Tlačítka pro další béčka nebo křížky nejsou součástí přístupného seznamu; záměrně se nabízí jen patnáct standardních tónin.

6. Jak se zpřístupnily Barlines neboli taktové čáry

Podobný problém řeší nativní dialog Insert Fixed Barline. Sedm grafických voleb je nyní dostupných jako obyčejný seznam:

1. V Capelle otevřete dialog Insert Fixed Barline.
2. Stiskněte NVDA + Alt + B.
3. Vyberte jednu z možností:
   • jednoduchá taktová čára,
   • dvojitá taktová čára,
   • závěrečná taktová čára,
   • pravá repetice,
   • levá repetice,
   • levopravá repetice,
   • čárkovaná taktová čára.
4. Potvrďte výběr Enterem.
5. Dokončete původní dialog Capelly tlačítkem OK.

Doplněk v dialogu hledá přesně sedm nepojmenovaných zaškrtávacích prvků v jedné vodorovné řadě. Kontroluje jejich velikost, rozestupy a polohu. Potom si zapamatuje středy jednotlivých prvků, nabídne přístupný seznam a po potvrzení provede kontrolované kliknutí na správný bod. Pokud nenajde právě sedm voleb nebo geometrie nesouhlasí, nic nevybere.

7. Jak přesně pracuje Where Am I neboli Kde jsem

Skript Kde jsem – Čtení partitury nezkouší odečítat obrazovku. Přistupuje přímo k otevřené partituře a k jejím CapXML datům. Z aktuálního výběru zjistí systém, osnovu, hlas a index objektu. Potom rozpozná objekt u notového kurzoru a sestaví mluvitelný text.

Zapnutí automatického sledování

Pro automatické spouštění nestačí jen zkopírovat skript. V anglickém rozhraní Capelly otevřete Extras > Preferences > General, u položky Position display by script vyberte Where am I - Print Score, zapněte příslušnou volbu a nastavení potvrďte. Samotné automatické sledování se potom zapíná nebo vypíná položkou Extras > Position display by script.

Když je sledování zapnuté, Capella zavolá Kde jsem po skutečném pohybu notového kurzoru. Vlastní klávesová zkratka k tomu není potřeba a ani ji nelze přiřadit. Kde jsem lze také jednou ručně spustit ze seznamu otevřeného pomocí Ctrl + F3; Ctrl + R je potom zopakuje pouze tehdy, pokud zůstává posledním ručně spuštěným skriptem.

Co dokáže popsat

• jednotlivou notu, délku, výšku a posuvku;
• vícetónový akord a současně znějící tóny ve více hlasech téže osnovy;
• pomlku;
• taktové označení, klíč, předznamenání a taktovou čáru;
• číslo taktu a přesnou racionální pozici uvnitř taktu;
• číslo objektu, hlasu, osnovy, nástroj a číslo systému;
• artikulace a ligatury;
• připojené textové a grafické objekty, například dynamiku, oblouček, trylek, voltu, crescendo, kytarový diagram, oktávovou linku, obrázek nebo skupinu objektů.

U akordu skript projde všechny hlasy aktuální osnovy a podle přesného rytmického času shromáždí právě znějící notové hlavy. Výstup i MIDI tak mohou zahrnout vícehlasý souzvuk, nikoli pouze objekt v právě aktivním hlasu.

Jak vypadá výstup

Skript otevře dialog s jedním zaměřitelným rozbalovacím seznamem, který obsahuje jedinou položku s celým popisem. Toto řešení je záměrné: komentář ve zdrojovém kódu uvádí, že opakované editační dialogy v Capelle 10 způsobovaly úniky nebo poškození a časem mohly vést k pádu programu. Jednopoložkový ComboBox zůstává pro NVDA čitelný a při opakovaném používání stabilní.

Každý nově sestavený popis se zároveň tiše zkopíruje do schránky Windows. V textovém editoru jej proto můžete vložit pomocí Ctrl + V. Kopírování se samo neohlásí a proběhne i tehdy, když bylo zobrazení dialogu po úpravě noty potlačeno.

Pohyb přímo z 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.

Při stisku navigační klávesy doplněk nejprve zastaví řeč a u kombinace s Ctrl čeká, až uživatel modifikátor skutečně pustí. Teprve potom pošle Escape, počká na zavření dialogu a návrat fokusu do procesu Capelly a odešle Capelle požadovanou šipku. Během přechodu potlačí dočasný název dokumentu a rušivé hlášení seskupení. Kde jsem se na nové pozici znovu otevře a přečte nový objekt.

Potlačení po úpravě partitury

V Nastavení NVDA > Přístupnost Capelly lze zaškrtnout Neotvírat Kde jsem automaticky po zadání nebo změně noty. Když je volba zapnutá, dialog se neotevře po první ani po žádné další zadané notě a neotevře se ani po změně obsahu partitury. Nový popis se přesto uloží do schránky. Kde jsem se znovu otevře až po skutečném pohybu notového kurzoru.

Správný test je jednoduchý: vytvořte novou prázdnou partituru a zadejte C, D a E. Dialog se nesmí otevřít po žádné z těchto not. Potom pohněte kurzorem šipkou; teprve nyní se má Kde jsem otevřít. Žádné zvláštní otevření po první notě se neočekává.

8. Jak se Kde jsem nastavuje

Jazyk a potlačení automatického dialogu patří do Nastavení NVDA > Přístupnost Capelly. Samostatný skript Kde jsem – nastavení řídí obsah popisu a MIDI. V jeho dialogu se pohybujte klávesami Tab a Shift + Tab, zaškrtnutí měňte mezerníkem a hodnoty v seznamech vybírejte šipkami.

Nastavovací skript spusťte ručně ze seznamu skriptů Capelly, který otevřete pomocí Ctrl + F3. Vlastní klávesovou zkratku mu přiřadit nelze. Po ručním spuštění jej může Ctrl + R opakovat, dokud ručně nespustíte jiný skript.

Kontext za aktuálním objektem

• takt a pozice v taktu – výchozí zapnuto;
• číslo objektu – výchozí vypnuto;
• číslo hlasu – výchozí zapnuto;
• číslo osnovy a nástroj – výchozí zapnuto;
• předznamenání – výchozí zapnuto;
• číslo systému – výchozí zapnuto.

Notační a grafické podrobnosti

• připojené grafické objekty;
• artikulace;
• ligatury;
• obsah textových objektů;
• podrobné informace o grafických objektech;
• potlačení posuvek, které už vyplývají z předznamenání.

Všechny tyto volby jsou ve výchozím nastavení zapnuté. Pokud je popis příliš dlouhý, lze nejprve vypnout podrobnosti grafických objektů a obsah textů, případně čísla systému a osnovy.

MIDI

• MIDI vypnuto – výchozí stav;
• přehrát notu nebo akord po potvrzení Enterem;
• přehrát notu nebo akord automaticky při otevření dialogu.

Délku lze nastavit na 250, 400, 600 nebo 1000 milisekund. Hlasitost má hodnoty 64, 96, 110 a 127. Výchozí délka je 400 milisekund a hlasitost 110. Nastavení se ukládá do uživatelských dat Capelly a oba skripty Kde jsem používají stejný soubor voleb.

9. Jak pracuje Prepare Partiture for Print

PreparePartitureForPrint.py ve verzi 5.0 Safe automaticky přeuspořádá takty do systémů pro tisk. Neprovádí běžnou mechanickou volbu stejného počtu taktů na každém řádku. Zvolené číslo představuje pouze maximum; hustý zápis může dostat taktů méně.

Použití

1. Nejprve partituru uložte.
2. Klávesami Ctrl + F3 otevřete seznam skriptů Capelly.
3. Najděte Prepare Partiture for Print a ručně jej spusťte.
4. V jediném rozbalovacím seznamu vyberte Maximum measures per system od 1 do 16. Výchozí hodnota je 8.
5. Potvrďte dialog.
6. Po dokončení si přečtěte přístupnou výsledkovou zprávu.
7. Na testovací kopii ověřte, že jedno Ctrl + Z vrátí původní stav.

Skriptu nelze přiřadit vlastní klávesovou zkratku. Pokud byl posledním ručně spuštěným skriptem, Ctrl + R jej zopakuje až do chvíle, kdy ručně spustíte jiný skript. Poslední potvrzené maximum se uloží do uživatelských dat Capelly a nabídne se při příštím spuštění. Dialogy skriptu jsou ve verzi 5.0 v angličtině.

Co se děje uvnitř

1. Otevřená partitura se uloží do dočasného souboru CAPX.
2. Skript načte CapXML mimo otevřenou partituru a ověří strukturu systémů, osnov a hlasů.
3. Hudební objekty rozdělí podle přesného rytmického času do taktů.
4. Pro každý takt odhadne minimální vodorovnou šířku.
5. Dynamickým programováním vybere skupiny taktů pro jednotlivé systémy.
6. Mimo otevřenou partituru vytvoří nové systémy a nastaví bezpečné svislé odstupy.
7. Porovná přesnou XML posloupnost všech noteObjects před změnou a po ní.
8. Ověří počet taktů, zvolené maximum a objekty s rozsahem noteRange.
9. Teprve po úspěšné validaci zaregistruje jednu operaci Undo a jedním načtením vloží hotový výsledek do Capelly.
10. Dočasné soubory odstraní.

Adaptivní zalomení

Odhad šířky bere v úvahu počet notových sloupců, nejkratší hodnotu, počet hlav v akordu, posuvky, tečky, text písně, textové a grafické objekty, rezervu pro začátek systému a dostupnou šířku formátu stránky. Algoritmus hledá rozdělení, které nepřekročí zvolené maximum, nepotřebuje nebezpečnou kompresi, nevytváří bezdůvodně prázdné systémy a pokud možno nerozdělí objekt s noteRange uprostřed.

Svislé odstupy

Pro každou osnovu se konzervativně odhaduje přesah nejvyšších a nejnižších not, nožiček, textu písně a připojených grafických objektů. Rezerva se zapíše do extraDistance top a bottom. Minimální vzdálenost mezi systémy se zvýší alespoň na bezpečnou hodnotu a vodorovná komprese rozestupů se vypne.

Bezpečnost a Undo

Otevřená partitura se nemění po částech. Celý výsledek vznikne a projde kontrolami mimo ni. V nabídce Undo má po úspěchu být jediná akce Prepare partiture for print a jedno Ctrl + Z má obnovit stav před spuštěním. Skript nepoužívá vlákna, ctypes, ovládání dialogů Windows, automatické Ctrl+R ani opakované spouštění pluginu.

Kdy skript změnu odmítne

• mezi systémy se mění počet osnov nebo hlasů;
• uvnitř systémů jsou grafické stránky nebo samostatné systémové objekty mimo osnovy;
• nota či pomlka překračuje taktovou hranici bez správného rozdělení;
• změna taktu nastává uvnitř rozpracovaného taktu;
• jediný takt je příliš hustý pro dostupnou šířku;
• objekt s noteRange nelze zachovat bez překročení maxima;
• partitura nemá měřitelný hudební obsah nebo bezpečné řešení zalomení neexistuje.

V těchto případech se zobrazí chybová zpráva a otevřená partitura má zůstat beze změny.

10. Testy, omezení a diagnostika

Offline test tiskového skriptu

Soubory TEST_REPORT_MOZART_ORIGINAL.txt a TEST_REPORT_MOZART_EN.txt popisují tentýž test na Mozartově Duo No. 1 K487, první v původní české podobě bez diakritiky a druhý anglicky. Podle těchto zpráv bylo 56 taktů při maximu 8 rozděleno do 18 systémů. Před transformací i po ní zůstalo 599 akordů, 16 pomlk, 599 notových hlav, 27 ligatur, 10 posuvek a 2 taktové čáry. Zprávy uvádějí bezchybný ZIP test a načtení XML i shodnou přesnou posloupnost všech noteObjects v obou hlasech.

Tento test byl proveden offline. Nebyla při něm spuštěna ani ovládána Capella. Konečný vzhled sazby a skutečné chování Undo je proto nutné ověřit přímo v Capelle 10 na uložené kopii partitury. Obě přiložené zprávy se týkají pouze skriptu Prepare Partiture for Print; obdobné testovací zprávy pro doplněk NVDA ani skripty Kde jsem v archivu nejsou.

Diagnostické soubory

Při problémech lze v systémové složce %TEMP% hledat zejména:

• capella_preferences_speech.log,
• capella_key_signature_chooser.log,
• capella_fixed_barline_chooser.log,
• capella_whereami_edit_diagnostic.log,
• capella_whereami_edit_diagnostic_state.txt,
• capella_whereami_navigation.log,
• capella_entire_score_filter.log,
• capella_whereami_settings_export.log.

Před opakováním konkrétního testu lze příslušný log smazat, aby obsahoval jen nový pokus. Do hlášení chyby vždy připojte verzi Capelly, NVDA, kompletního balíku a přesný postup, kterým se problém vyvolal.

Rychlá kontrola po instalaci

1. Ověřte, že jsou všechny tři skripty ve složce Dokumenty\capella\scripts\, a restartujte NVDA i Capellu.
2. V Extras > Preferences > General nastavte Position display by script na Where am I - Print Score.
3. Zapněte Extras > Position display by script.
4. V nové prázdné partituře zadejte C, D a E. Při zapnutém potlačení se Kde jsem nesmí po žádné notě otevřít.
5. Pohněte kurzorem šipkou. Kde jsem se má otevřít; potom vyzkoušejte navigační šipky přímo v jeho dialogu.
6. Vložte popis ze schránky pomocí Ctrl + V.
7. Ručně spusťte Kde jsem – nastavení ze seznamu skriptů.
8. Otevřete Preferences a projděte kategorie šipkami nahoru a dolů.
9. V příslušných nativních dialozích otestujte NVDA + Alt + K a NVDA + Alt + B.
10. Na uložené kopii ručně spusťte Prepare Partiture for Print s malým maximem, zkontrolujte zprávu a vyzkoušejte jedno Ctrl + Z.

Balík 6.27 řeší konkrétní překážky velmi promyšleně: grafické volby převádí do ovladatelných seznamů, notový kurzor popisuje přímo z dat partitury a tiskovou transformaci nejprve kompletně vytvoří a zkontroluje mimo otevřený dokument. Přesto doporučuji první pokusy provádět na kopiích a výslednou sazbu před tiskem zkontrolovat.

Článek byl přepracován podle zdrojových kódů a dokumentace obsažené v balíku Capella Accessibility 6.27. Článek spoluvytvořil ChatGPT.