Balabolka (application console), version 1.19
Copyright (c) 2013-2014 Ilya Morozov
All Rights Reserved

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

Licence : Freeware
Systme d'exploitation : Microsoft Windows XP/Vista/7/8
Speech API : 4.0/5.0
Microsoft Speech Platform



*** Ligne de commande ***

balabolka_console.exe [options ...]


*** Paramtres de ligne de commande ***

-l
   Affiche la liste des voix disponibles.

-g
   Affiche la liste des priphriques de sortie audio disponibles.

-f <nom_de_fichier>
   Spcifie le nom du fichier texte d'entre.

-w <nom_de_fichier>
   Spcifie le nom du fichier de sortie au format WAV. Si l'option est spcifie, un fichier audio sera cr. Dans le cas contraire, le texte sera lu  haute voix.

-n <nom_de_voix>
   Spcifie le nom de la voix (la partie du nom est suffisant). 
   Si le paramtre n'est pas spcifi, la voix dfinie par le paramtre [-id] ou la voix par dfaut de Windows sera utilise.

-id <nombre_intgral>
   Spcifier le code de langue pour la voix (Locale ID). Locale ID est le code de langue attribu par Microsoft (par exemple "1033" pour Anglais - tats-Unis", "1036" pour "Franais - France").
   Le logiciel choisit dans la liste de voix la premire voix avec l'ID spcifi.
   Si le paramtre n'est pas spcifi, la voix dfinie par le paramtre [-n] ou la voix par dfaut de Windows sera utilise.
   La liste de pays avec leurs Locale ID : http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx

-m
   Affiche les paramtres de la voix.

-b <nombre_intgral>
   Spcifie le priphrique audio par son index. L'index de l'appareil audio utilis par dfaut est 0.

-c
   Utilise le texte du presse-papiers.

-t <ligne_de_texte>
   Utilise le texte de la ligne de commande.

-i
   Utilise le texte de flux d'entre standard (STDIN).

-o
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : enregistre les donnes audio dans le flux de sortie standard (STDOUT) ; si l'option est spcifie, l'option [-w] est ignore.

-s <nombre_intgral>
   SAPI 4 : spcifie le dbit de la parole compris entre 0 et 100 (pas de valeur par dfaut).
   SAPI 5 et Microsoft Speech Platform : spcifie le dbit de la parole compris entre -10 et 10 (la valeur par dfaut est 0).

-p <nombre_intgral>
   SAPI 4 : spcifie le timbre de la voix compris entre 0 et 100 (pas de valeur par dfaut).
   SAPI 5 et Microsoft Speech Platform : spcifie le timbre de la voix compris entre -10 et 10 (la valeur par dfaut est 0).

-v <nombre_intgral>
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : spcifie le volume compris entre 0 et 100 (la valeur par dfaut est 100).

-e <nombre_intgral>
   Spcifie la longueur des pauses entre les phrases (en millisecondes). La valeur par dfaut est 0.

-a <nombre_intgral>
   Spcifie la longueur des pauses entre les paragraphes (en millisecondes). La valeur par dfaut est 0.

-d <nom_de_fichier>
   Utilise un dictionnaire pour la correction de la prononciation (fichier *.REX ou *.DIC). La ligne de commande peut contenir quelques options [-d].

-k
   Dsactive les autres copies de l'application console dans la mmoire de l'ordinateur.

-ka
   Dsactiver la copie de l'application console en cours d'excution.

-q
   Met l'application dans une file d'attente. L'application console va attendre que les autres copies du programme terminent leur opration.

-lrc
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : cre un fichier LRC, si l'option [-w] ou [-o] est spcifie.

-sub
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : le texte constitue des sous-titres et doit tre converti en fichier audio, compte tenu des pauses spcifies.
   Le paramtre peut tre utile lorsque les options [-i] ou [-c] sont spcifies en ligne de commande.

-tray
   Afficher l'icne du logiciel dans la zone de notification du systme d'exploitation.
   Cela permet  l'utilisateur de suivre l'excution d'une opration et de l'arrter  l'aide de l'lment Arrt dans le menu contextuel.

-? ou -h
   Affiche la liste des options de ligne de commande.

--encoding <encodage> ou -enc <encodage>
   L'encodage du texte de flux d'entre standard ("ansi", "utf8" ou "unicode"). La valeur par dfaut est "ansi".

--silence-begin <nombre_intgral> ou -sb <nombre_intgral>
   Spcifier la longueur de la pause en dbut du fichier audio (en millisecondes). La valeur par dfaut est 0.

--silence-end <nombre_intgral> ou -se <nombre_intgral>
   Spcifier la longueur de la pause en fin du fichier audio (en millisecondes). La valeur par dfaut est 0.

--lrc-length <nombre_intgral>
   Spcifie la longueur maximale des lignes de texte pour le fichier LRC (en caractres).

--lrc-filename <nom_de_fichier>
   Spcifie le nom du fichier LRC. L'option peut tre utile lorsque l'option [-o] est spcifie en ligne de commande.

--lrc-encoding <encodage>
   Spcifie l'encodage pour le fichier LRC ("ansi", "utf8" ou "unicode"). La valeur par dfaut est "ansi".

--lrc-offset <nombre_intgral>
   Spcifie le dcalage temporel pour le fichier LRC (en millisecondes).

--lrc-artist <texte>
   Spcifie une balise ID pour le fichier LRC : artiste.

--lrc-album <texte>
   Spcifie une balise ID pour le fichier LRC : album.

--lrc-title <texte>
   Spcifie une balise ID pour le fichier LRC : titre.

--lrc-author <texte>
   Spcifie une balise ID pour le fichier LRC : auteur.

--lrc-creator <texte>
   Spcifie une balise ID pour le fichier LRC : crateur du fichier LRC.

--raw
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : sortie des donnes audio comme fichiers PCM brut ; les donnes audio sont sans l'en-tte WAV.
   L'option est utilise avec l'option [-o].

--ignorelength
   SAPI 4 : loption nest pas utilise.
   SAPI 5 et Microsoft Speech Platform : omet la longueur des donnes audio dans l'en-tte WAV.
   L'option est utilise avec l'option [-o].

--sub-format <texte>
   Le format des sous-titres ("srt", "ssa", "ass" ou "smi"). Si le paramtre n'est pas spcifi, le format est dtermin d'aprs l'extension du fichier des sous-titres.

--sub-fit ou -sf
   Augmenter automatiquement le dbit de la parole pour s'adapter aux intervalles spcifis dans les sous-titres.

--sub-max <nombre_intgral> ou -sm <nombre_intgral>
   Spcifier le dbit maximal de la parole dans une gamme de -10  10 (pour convertir des sous-titres en fichier audio).

--deletefile ou -df
   Supprimer le fichier texte aprs la lecture  haute voix ou enregistrer le fichier audio.


*** Exemples ***

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 "Mathieu" -t "Le texte sera lu lentement." -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


Un exemple de l'utilisation de l'application avec l'utilitaire LAME.EXE :

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


Un exemple de l'utilisation de l'application avec l'utilitaire OGGENC2.EXE :

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


Un exemple de l'utilisation de l'application avec l'utilitaire WMAENCODE.EXE :

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


*** Fichier de configuration ***

Les options de ligne de commande peuvent tre enregistres en tant que fichier de configuration  balabolka_console.cfg  dans le mme dossier que l'application console.

Exemple de fichier de configuration :
===============
-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
===============

Le programme peut combiner les options du fichier de configuration et celles de la ligne de commande.


*** Clips audio ***

Le logiciel permet d'insrer des liens vers des fichiers audio externes au format WAV (clips audio) dans le texte. La balise de clip audio ressemblera  ceci :

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

Si un lien vers un clip audio survient lors de la lecture dun texte  haute voix, le logiciel se met en pause, lit le clip audio et ensuite reprend la parole.
Lors de la conversion de la parole en fichier audio, le clip audio externe sera intgr dans le fichier audio cr par le logiciel.


*** Licence ***

Droits d'utilisation non commerciale de lapplication :
- personnes physiques  sans restriction,
- personnes morales  avec les restrictions stipules dans l'Accord de Licence du logiciel Balabolka.

Lutilisation commerciale du logiciel demande l'autorisation du dtenteur du copyright.

###