Balabolka (Konsolenanwendung), Version 1.19
Copyright (c) 2013-2014 Ilya Morozov
Alle Rechte vorbehalten

WWW: http://www.cross-plus-a.com/de/bconsole.htm
E-mail: crossa@list.ru (nur russisch oder englisch)

Lizenzart: Freeware
Plattformen: Microsoft Windows XP/Vista/7/8
Speech API: 4.0/5.0 und hher
Microsoft Speech Platform



*** Anwendung ***

balabolka_console.exe [Optionen ...]


*** Befehlszeilen-Optionen ***

-l
   Druckt die Liste der verfgbaren Stimmen.

-g
   Druckt die Liste der verfgbaren Audio-Ausgabegerte.

-f <Dateiname>
   Bestimmt den Namen der Eingabe-Textdatei.

-w <Dateiname>
   Bestimmt den Namen der Ausgabe-Datei im WAV-Format. Wenn diese Option angegeben ist, wird eine Audio-Datei erstellt. Sonst wird der Text laut vorgelesen.

-n <Sprecher>
   Bestimmt den Namen des Sprechers (ein Teil des Namens ist ausreichend). 
   Wenn diese Option nicht festgelegt wurde, wird die Stimme, die durch die Option [-id] bestimmt wurde, oder die Standard-Stimme von Windows verwendet.

-id <Zahl>
   Setzt die "Lokale ID" fr die Stimme. Die Lokale ID ist der von Microsoft zugewiesene Sprachen-Code (z. B. "1031" fr "Deutsch - Deutschland", "1033" fr "Englisch - Amerika").
   Das Programm wird die erste Stimme mit definierter Lokaler ID aus der Liste von Stimmen auswhlen. 
   Wenn diese Option nicht festgelegt wurde, wird die Stimme, die durch die Option [-n] bestimmt wurde, oder die Standard-Stimme von Windows verwendet.
   Liste der Sprachen mit zugewiesenen Codes: http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx

-m
   Druckt die Parameter der Stimme.

-b <Zahl>
   Whlt das Audio-Ausgabegert nach seinem Index. Der Index des Standard-Audio-Ausgabegertes ist 0.

-c
   Verwendet die Texteingabe aus der Zwischenablage.

-t <Textzeile>
   Die Texteingabe kann von der Befehlszeile verwendet werden.

-i
   Verwendet die Texteingabe von STDIN.

-o
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Schreibt Tondaten auf STDOUT. Wenn diese Option gewhlt ist, wird die Option [-w] ignoriert.

-s <Zahl>
   SAPI 4: Bestimmt die Geschwindigkeit in einem Bereich von 0 bis 100 (kein Standardwert).
   SAPI 5 und Microsoft Speech Platform: Bestimmt die Geschwindigkeit in einem Bereich von -10 bis 10 (der Standardwert ist 0).

-p <Zahl>
   SAPI 4: Bestimmt die Tonhhe in einem Bereich von 0 bis 100 (kein Standardwert).
   SAPI 5 und Microsoft Speech Platform: Bestimmt die Tonhhe in einem Bereich von -10 bis 10 (der Standardwert ist 0).

-v <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Bestimmt das Volumen in einem Bereich von 0 bis 100 (der Standardwert ist 100).

-e <Zahl>
   Bestimmt die Lnge der Pausen zwischen den Stzen (in Millisekunden). Der Standardwert ist 0.

-a <Zahl>
   Bestimmt die Lnge der Pausen zwischen den Abstzen (in Millisekunden). Der Standardwert ist 0.

-d <Dateiname>
   Verwendet das Wrterbuch fr die Aussprache-Korrektur (*.REX oder *.DIC). Die Befehlszeile kann ein paar Optionen enthalten [-d].

-k
   Beendet weitere Exemplare der Konsolen-Anwendung im Arbeitsspeicher des Computers.

-ka
   Beendet das aktive Exemplar der Konsolen-Anwendung im Arbeitsspeicher des Computers.

-q
   Setzt die Anwendung in eine Warteschlange. Die Konsolen-Anwendung wartet, bis andere Exemplare des Programms fertig sind.

-lrc
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Erstellt eine LRC-Datei, wenn die Option [-w] oder [-o] angegeben ist.

-sub
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Text wird als Untertitel verarbeitet. Diese Option kann ntzlich sein, wenn die Optionen [-i] oder [-c] festgelegt wurden.

-tray
   Das Programm-Icon im System-Tray anzeigen. Dies ermglicht es, den Fortschritt der Aufgabe zu sehen.
   Mit der Option "Stopp" im Kontext-Men kann man den Prozess stoppen.

-? oder -h
   Druckt die Liste der verfgbaren Befehlszeilen-Optionen.

--encoding <Kodierung> oder -enc <Kodierung>
   Bestimmt die Kodierung fr die Texteingabe ("ansi", "utf8" oder "unicode"). Die Standardeinstellung ist "ansi".

--silence-begin <Zahl> oder -sb <Zahl>
   Legt die Lnge der Stille am Anfang der Audio-Datei fest (in Millisekunden). Der Standardwert ist 0.

--silence-end <Zahl> oder -se <Zahl>
   Legt die Lnge der Stille am Ende der Audio-Datei fest (in Millisekunden). Der Standardwert ist 0.

--lrc-length <Zahl>
   Bestimmt die maximale Lnge der Textzeilen fr die LRC-Datei (in Zeichen).

--lrc-filename <Dateiname>
   Bestimmt den Namen der LRC-Datei. Die Option kann ntzlich sein, wenn die Option [-o] angegeben ist.

--lrc-encoding <Kodierung>
   Bestimmt die Kodierung fr die LRC-Datei ("ansi", "utf8" oder "unicode"). Die Standardeinstellung ist "ansi".

--lrc-offset <Zahl>
   Bestimmt die Zeitverschiebung fr die LRC-Datei (in Millisekunden).

--lrc-artist <Textzeile>
   Bestimmt den ID-Tag fr die LRC-Datei: Knstler.

--lrc-album <Textzeile>
   Bestimmt den ID-Tag fr die LRC-Datei: Album.

--lrc-title <Textzeile>
   Bestimmt den ID-Tag fr die LRC-Datei: Titel.

--lrc-author <Textzeile>
   Bestimmt den ID-Tag fr die LRC-Datei: Autor.

--lrc-creator <Textzeile>
   Bestimmt den ID-Tag fr die LRC-Datei: Ersteller der LRC-Datei.

--raw
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Der Ausgang ist RAW-Format PCM; die Audiodaten enthalten nicht den WAV-Header.
   Diese Option wird zusammen mit der Option [-o] verwendet.

--ignorelength
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Ignoriert die Lnge der Daten im WAV-Header.
   Diese Option wird zusammen mit der Option [-o] verwendet.

--sub-format <Textzeile>
   Legt das Format der Untertitel fest ("srt", "ssa", "ass" oder "smi"). Wenn diese Option nicht angegeben ist, wird das Format anhand der Dateiendung bestimmt.

--sub-fit oder -sf
   Erhht die Geschwindigkeit automatisch, passend zu Zeitintervallen (wenn das Programm Untertitel in eine Audio-Datei konvertiert).

--sub-max <Zahl> oder -sm <Zahl>
   Legt die maximale Sprechgeschwindigkeit in einem Bereich von -10 bis 10 fest (wenn das Programm Untertitel in eine Audio-Datei konvertiert).

--deletefile oder -df
   Entfernt die Textdatei, wenn die Aufgabe erledigt ist. Diese Option wird zusammen mit der Option [-f] verwendet.


*** Beispiele ***

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 "Matthias" -t "Der Text wird langsam vorgelesen." -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


Beispiel fr die Verwendung zusammen mit LAME.EXE:

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


Beispiel fr die Verwendung zusammen mit OGGENC2.EXE:

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


Beispiel fr die Verwendung zusammen mit WMAENCODE.EXE:

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


*** Konfigurationsdatei ***

Die Befehlszeilen-Optionen knnen als Konfigurationsdatei "balabolka_console.cfg" im Ordner der Konsolen-Anwendung gespeichert werden. 

Beispiel fr eine Konfigurationsdatei:
===============
-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
===============

Das Programm kann Optionen von der Konfigurationsdatei und der Kommandozeile kombinieren.


*** Audio-Clips ***

Das Programm ermglicht, Links zu externen WAV-Dateien (Audio-Clips) in Text von Dokumenten einzufgen. Ein Audio-Clip-Tag wird so aussehen:

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

Beim Vorlesen von Text wird Balabolka unterbrochen, wenn das Audio-Clip-Tag erreicht ist, der Audio-Clip wird gespielt und das Vorlesen wird fortgesetzt.
Bei der Umwandlung in Audio-Dateien wird der Audio-Clip in der Audio-Datei, die durch das Programm erstellt wird, eingebettet werden.

###