Plugin Espeak

Uvod

Sucastou verzie dostupnej na tejto stranke je zasuvny modul Espeak umoznujuci citanie textovych suborov v kodovani utf-8. Pouziva volne siritelnu syntezu reci ESpeak. Port tejto syntezi reci pre RB urobil v roku 2007 rockbox developer Toni. Jeho praca vsak z licencnych dovodov (viac informacii v diskusnom fore ) nebola akceptovana do hlavnej vyvojovej vetvy RB. Koncom minuleho roka som plugin upravil do stavu pouzitelneho na citanie jednoduchych textovych suborov.

V sucasnosti stale obsahuje verziu ESpeaku z roku 2007 a teda aj neduhy ktore v tom case ESpeak mal.

Ako to funguje

Po kliknuti na subor s priponou .txt bude tento subor nacitany pluginom espeak. Plugin sa na zaciatku prihlasi hlaskou "ready to read" (v sucasnosti je len v anglictine, jazyk syntezy si samozrejme mozno prepnut na slovencinu). Na jeho ovladanie v prehravaci Sansa Clip Plus pouzite nasledovne tlacidla:

• Po odstavcoch suboru (pevne zariadkovania) sa pohybujte tlacidlami play a submenu (horna a dolna sipka).
• Kratke stlacenie tlacidla select aktivuje alebo deaktivuje plinule citanie textu od pozicie kurzora.
• Tlacidla volume pouzite na nastavenie hlasitosti.
• Stlacenim a dlhsim pridrzanim tlacidla select vyvolate kontextovu ponuku.
• Do prezeraca suborov sa vratite (plugin ukoncite) stlacenim tlacidla power.

Nastavenie parametrov reci

V kontextovej ponuke mozete pomocou prikazov "select language", "set rate" a "set pitch" nastavit jazyk, rychlost a vysku syntezy reci. Sipkami vyberte parameter a potvrdte tlacidlom select. Potom tlacidlami play a submenu vyberte hodnotu ktora vam vyhovuje a potvrdte tlacidlom select.

Zalozky

Polozkou "save bookmark" si mozete ulozit aktualnu poziciu kurzora. Pozicia bude ulozena do suboru s priponou bmark ktory bude vytvoreny v priecinku kde sa nachadza prave citany subor.

Polozkou "load bookmark" mozete tuto poziciu nacitat. Po jej aktivovani sa kurzor automaticky presunie na ulozenu poziciu.

Polozkou "goto the begining of the file" mozete kurzor presunut na zaciatok prave otvoreneho textoveho suboru.

Automaticke akcie

V ponuke pluginu mozno nastavit automaticke akcie ktore sa vykonaju po zavedeni suboru, bezprostredne pred ukoncenim pluginu a v pripade ze stav baterie klesne pod 2 percenta. Nasleduje strucny opis.

what to do after start (co vykonat po spusteni):

• Do nothing (neurobit nic)
• start reading (zacat citanie): bezprostredne po zavedeni do pamate sa zacne citat text
• load bookmark (nacitat zalozku): Bezprostredne po zavedeni suboru do pamate sa plugin pokusi nacitat zalozku (ak existuje)
• load bookmark and start reading (nacitat zalozku a zacat citanie): kombinacia dvoch predchadzajucich.

What to do before exit (co vykonat pred ukoncenim):

• Do nothing (nevykonat nic)
• save bookmark (ulozit zalozku): Skor ako bude plugin ukonceny, pokusi sa automaticky ulozit aktualnu poziciu kurzora
• delete the file" (vymazat subor): Skor ako bude plugin ukonceny, pokusi sa vymazat subor ktory prave cita

What to do when battery reaches 2% (co vykonat ak stav baterie dosiahne 2%):

• don't care (nestaraj sa): Testy baterie nebudu vykonavane
• warn me (varuj ma): Plugin automaticky pozastavi plynule citanie a oznamy kriticky stav baterie
• exit the plugin (ukonci plugin): plugin sa pokusi vyvolat standardne ukoncenie pri ktorom bude vykonana aj automaticka akcia pre ukoncenie.

Ukladanie konfiguracie

Aktivovanim polozky "save configuration" mozete ulozit aktualne nastavenia parametrov syntezy reci (rychlost, vyska a jazyk) do suboru. Subor s nazvom espeak.config bude vytvoreny v priecinku v ktorom sa nachadza prave otvoreny textovy subor.

Nacitavanie konfiguracneho suboru je vykonavane automaticky pri spusteni pluginu a funguje nasledovne:

• Najprv sa plugin pokusa najst subor espeak.config v priecinku v ktorom sa nachadza subor ktory prave otvarate (nech je to napriklad subor /txt/slovenske/knihy/kniha.txt). Hlada teda subor /txt/slovenske/knihy/espeak.config. Pokial ho najde, nacita ho a pokracuje v nacitavani txt suboru.
• Pokial subor nenajde, hlada ho v nadradenom priecinku. Hlada teda subor /txt/slovenske/espeak.config. Ak subor najde tu, nacita ho a pokracuje nacitavanim textoveho suboru.
• Pokial subor nenasiel v nadradenom priecinku, pokracuje v hladani o uroven vyssie az kym sa nedostane do korenoveho priecinka prehravaca. Ak nenajde pouzitelny konfiguracny subor ani tam, pouzije predvolene nastavenia pluginu.

Vyssie opisana funkcionalita teda umoznuje vytvorit si specialne nastavenia espeaku pre texty v roznych jazykoch tak, ze si vytvorite vhodnu adresarovu strukturu do ktorej na najvyssie urovne povkladate prislusne konfiguracne subory.

Priklad: Majme priecinok txt ktory obsahuje podpriecinky slovenske, ceske a anglicke. V kazdom z podpriecinkov si vytvorte lubovolnu strukturu (casopisy, knihy, clanky,...). Otvorte si lubovolny txt subor napriklad z priecinka txt/slovenske/knihy. Nastavte parametre syntezy reci na slovencinu a maximalnu rychlost a ulozte konfiguraciu. Potom ukoncite plugin. V priecinku /txt/slovenske/knihy sa nachadza subor espeak.config. Tento subor pomocou polozky v kontextovej ponuke vystrihnite, v strome priecinkov sa presunte do priecinka txt/slovenske a sem konfiguracny subor vlozte. Odteraz bude pri nacitani lubovolneho txt suboru z priecinka txt/slovenske alebo jeho podpriecinkov automaticky nacitany konfiguracny subor ktory ste vytvorili.

Kopirovanie odstavca do poznamok

Pouzite funkciu add to notes.txt. Po jej aktivovani bude odstavec na ktorom je prave kurzor, pridany na koniec do suboru notes.txt.

Subor notes.txt sa najprv hlada rovnakym sposobom ako konfiguracny subor pri nacitavani konfiguracie (vid vyssie). Ak sa najde niekde na ceste smerom ku korenovemu priecinku prehravaca, bude odstavec pridany do neho. V pripade ze na ceste ku korenu subor notes.txt neexistuje, bude automaticky vytvoreny v rovnakom priecinku v ktorom sa nachadza prave otvoreny textovy subor.