Balabolka (aplikacja konsolowa), wersja 1.19
Copyright (c) 2013-2014 Ilya Morozov
Wszystkie prawa zastrzeone

WWW: http://www.cross-plus-a.com/pl/bconsole.htm
E-mail: crossa@list.ru

Licenzja: Freeware
System operacyjny: Microsoft Windows XP/Vista/7/8
Speech API: 4.0/5.0
Microsoft Speech Platform



*** Wiersz polece ***

balabolka_console.exe [parametry ...]


*** Parametry wiersza polece ***

-l
   Pokaza list gosw zainstalowanych na komputerze.

-g
   Pokaza list dostpnych urzdze audio.

-f <nazwa_pliku>
   Otworzy plik tekstowy.

-w <nazwa_pliku>
   Zapisa plik dwikowy w formacie WAV. Jeli parametr jest ustawiony, plik dwikowy zostanie utworzony. Jeli parametr nie jest ustawiony, tekst zostanie przeczytany na gos.

-n <nazwa_gosu>
   Wybra gos (wystarczy poda cz jego nazwy). Jeli parametr nie jest ustawiony, bdzie uywany gos wybrany w Panelu sterowania systemu Windows.

-id <liczba>
   Wybra gos komputerowy za pomoc identyfikatora jzyka (Locale ID). Takie identyfikatory s przypisane wszystkim jzykom przez programistw Microsoft (np. "1045" - jzyk polski, "1058" - jzyk ukraiski).
   Program wybierze z listy pierwszy gos, identyfikator ktrego odpowiada okrelonej wartoci.
   Jeli ten parametr nie zostanie okrelony, bdzie uywany gos okrelony przez parametr [-n] lub wybrany w Panelu sterowania systemu Windows.
   Lista identyfikatorw: http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx

-m
   Pokaza parametry wybranego gosu.

-b <liczba>
   Wybra urzdzenie audio przez jego numer na licie dostpnych urzdze do odtwarzania dwiku. Numer urzdzenia domylnego dorwna 0.

-c
   Uy tekstu ze schowka.

-t <tekst>
   Uy tekstu z wiersza polece.

-i
   Uy tekstu z standarowego strumienia wejcia (STDIN).

-o
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: zapisa dwik do standarowego strumienia wyjcia (STDOUT); jeli parametr jest ustawiony, parametr [-w] jest ignorowany.

-s <liczba>
   SAPI 4: ustawi prdko mowy w zakresie od 0 do 100 (brak wartoci domylnych).
   SAPI 5 i Microsoft Speech Platform: ustawi prdko mowy w zakresie od -10 do 10 (warto domylna dorwna 0).

-p <liczba>
   SAPI 4: ustawi ton mowy w zakresie od 0 do 100 (brak wartoci domylnych).
   SAPI 5 i Microsoft Speech Platform: ustawi ton mowy w zakresie od -10 do 10 (warto domylna dorwna 0).

-v <liczba>
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: ustawi gosno mowy w zakresie od 0 do 100 (warto domylna dorwna 100).

-e <liczba>
   Ustawi dugo pauzy midzy zdaniami (milisekundy). Warto domylna dorwna 0.

-a <liczba>
   Ustawi dugo pauzy midzy akapitami (milisekundy). Warto domylna dorwna 0.

-d <nazwa_pliku>
   Uy sownika do korekty wymowy (plik z rozszerzeniem *.REX lub *.DIC). Wiersz polece moe zawiera kilka parametrw [-d].

-k
   Zatrzyma prace innych egzemplarzy aplikacji konsolowej uruchomionych na komputerze.

-ka
   Kills the active copy of the console application in the computer's memory.

-q
   Doda aplikacj do kolejki. Aplikacja konsolowa bdzie czeka, a inne egzemplarzy programu skocz prac.

-lrc
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: utworzy plik LRC, jeli ustawione parametry [-w] lub [-o].

-sub
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: tekst wyglda jak napisy do plikw i musi by przeksztacony w plik dwikowy z wrachowaniem okrelonych odstpw czasu.

-tray
   Pokaza ikon programu w obszarze powiadomie systemu operacyjnego.
   To pozwoli uytkownikowi monitorowa postp operacji, oraz przerwa proces klikajc "Stop" w menu kontekstowym.

-? lub -h
   Pokaza opis parametrw wiersza polece.

--encoding <kodowanie> lub -enc <kodowanie>
   Kodowanie tekstu ze standardowego strumiena wejciowego ("ansi", "utf8" lub "unicode"). Warto domylna dorwna "ansi".

--silence-begin <liczba> lub -sb <liczba>
   Ustawi dugo pauzy na pocztku pliku dwikowego (w milisekundach). Warto domylna dorwna 0.

--silence-end <liczba> lub -se <liczba>
   Ustawi dugo pauzy na kocu pliku dwikowego (w milisekundach). Warto domylna dorwna 0.

--lrc-length <liczba>
   Ustawi maksymaln dugo wierszy plika LRC (symboli).

--lrc-filename <nazwa_pliku>
   Nazwa pliku LRC. Parametr moe by przydatny gdy w wierszu polece ustawiony parametr [-o].

--lrc-encoding <kodowanie>
   Kodowanie pliku LRC ("ansi", "utf8" lub "unicode"). Warto domylna dorwna "ansi".

--lrc-offset <liczba>
   Ustawi przesunicie czasu dla pliku LRC (milisekundy).

--lrc-artist <tekst>
   Znacznik dla pliku LRC: wykonawca utworu.

--lrc-album <tekst>
   Znacznik dla pliku LRC: album.

--lrc-title <tekst>
   Znacznik dla pliku LRC: nazwa utworu.

--lrc-author <tekst>
   Znacznik dla pliku LRC: autor.

--lrc-creator <tekst>
   Znacznik dla pliku LRC: twrc pliku.

--raw
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: zapisa dwiek w formacie RAW PCM; dane nie zawieraj tytuu formatu WAV.
   Parametr wykorzystuj si razem z parametrem [-o].

--ignorelength
   SAPI 4: parametr nie jest uywany.
   SAPI 5 i Microsoft Speech Platform: nie zapisywa rozmiar audio do tytuu formatu WAV.
   Parametr wykorzystuj si razem z parametrem [-o].

--sub-format <tekst>
   Format napisw filmowych ("srt", "ssa", "ass" lub "smi"). Jeli parametr nie okrelony format zostanie wybrany przez rozszerzenie nazwy pliku napisw.

--sub-fit lub -sf
   Automatycznie zwiksza prdko mowy aby zmieci si w odstpy czasu okrelone w napisach.

--sub-max <liczba> lub -sm <liczba>
   Ustawi maksymaln prdko mowy w zakresie od -10 do 10 (do konwersji napisw w pliki dwikowe).

--deletefile lub -df
   Usun plik tekstowy po zakoczeniu czytania na gos lub zapisywania pliku dwikowego.


*** Przykady ***

balabolka_console.exe -l

balabolka_console.exe -n "Microsoft Anna" -m

balabolka_console.exe -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balabolka_console.exe -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balabolka_console.exe -n "Ewa" -t "Tekst bdzie czytany wolno." -s -5 -v 70

balabolka_console.exe -k

balabolka_console.exe -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balabolka_console.exe -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2


Przykad wykorzystania aplikacji razem z oprogramowaniem narzdziowym LAME.EXE:

balabolka_console.exe -f d:\book.txt -n Heather -o --raw | lame.exe -r -s 22.05 -m m -h - d:\book.mp3


Przykad wykorzystania aplikacji razem z oprogramowaniem narzdziowym OGGENC2.EXE:

balabolka_console.exe -f d:\book.txt -n Heather -o --ignorelength | oggenc2.exe --ignorelength - -o d:\book.ogg


Przykad wykorzystania aplikacji razem z oprogramowaniem narzdziowym WMAENCODE.EXE:

balabolka_console.exe -f d:\book.txt -n Heather -o --ignorelength | wmaencode.exe - d:\book.wma --ignorelength


*** Plik konfiguracyjny ***

Parametry mona zachowa jak plik konfiguracyjny "balabolka_console.cfg" w tym samym folderze co aplikacja konsolowa.

Przykad zawartoci pliku:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\rex\rules.rex
-d d:\dic\rules.dic
-lrc
--lrc-length 75
--lrc-encoding utf8
--lrc-offset 300
===============

Program moe kombinowa parametry z pliku konfiguracyjnego i wiersza polece.


*** Audio Clips ***

The application allows to insert links to external WAV files (audio clips) into text. Audio clip tag will look like:

{{Audio=C:\Sounds\ring.wav}}

When speaking text aloud, the program will pause when the audio clip tag is reached, play the audio clip and resume speaking.
When converting to audio files, the audio clip will be embedded in the audio file created by the application.


*** Licencja ***

Prawo do uytku niekomercyjnego: 
- dla osb fizycznych - bez ogranicze;
- dla osb prawnych - z zastrzeeniem ogranicze, co okrela "Umowa licencyjna" programu Balabolka.

Uytek komercyjny dozwolony jedynie za wczeniejsz zgod posiadacza praw autorskich.

###