Balabolka (aplicativo de console), verso 1.19
Copyright (c) 2013-2014 Ilya Morozov
All Rights Reserved

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

Licena: Freeware
Sistema operacional: Microsoft Windows XP/Vista/7/8
Speech API: 4.0/5.0
Microsoft Speech Platform



*** Linha de comando ***

balabolka_console.exe [opes ...]


*** Opes de comando ***

-l
   Mostrar a lista das vozes instaladas no seu computador.

-g
   Mostrar a lista dos dispositivos de udio disponveis.

-f <nome_do_arquivo>
   Abrir o arquivo de texto.

-w <nome_do_arquivo>
   Gravar um arquivo de udio em formato WAV. Especificando a opo, ser criado o arquivo de udio. Se a opo no  especificada, o texto ser lido em voz alta.

-n <nome_da_voz>
   Nome de voz (basta digitar uma parte do nome). No caso de no ser especificada, ser usada a voz selecionada no painel de controlo do Windows.

-id <nmero>
   Selecione a voz artificial usando o identificador de lngua (Locale ID). Esses identificadores esto atribudos a todas as lnguas pelos desenvolvedores da Microsoft (por exemplo, "1033" para ingls, "1046" para o portugus brasileiro).
   O programa vai selecionar a partir de uma lista a primeira voz, cujo identificador de lngua corresponde a um valor especificado.
   Se a opo no for especificada, ser usada a voz indicada pelo parmetro [-n], ou a voz selecionada no Painel de Controlo do Windows.
   Lista de identificadores: http://msdn.microsoft.com/en-us/goglobal/bb964664.aspx

-m
   Mostrar parmetros para a voz selecionada.

-b <nmero>
   Escolher o dispositivo de udio segundo o nmero na lista de dispositivos disponveis para reproduo de udio. O nmero padro do dispositivo  0.

-c
   Usar o texto a partir da rea de transferncia.

-t <linha_de_texto>
   Usar o texto a partir da linha de comando.

-i
   Usar o texto a partir do fluxo de entrada padro (STDIN).

-o
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: gravar dados de udio para o fluxo de sada padro (STDOUT); em caso de ser especificado, a opo [-w]  ignorada.

-s <nmero>
   SAPI 4: configurar a velocidade de fala na faixa de 0 a 100 (sem padro).
   SAPI 5 e Microsoft Speech Platform: configurar velocidade de fala na faixa de -10 a 10 (o padro  0).

-p <nmero>
   SAPI 4: ajustar o tom da voz, na faixa de 0 a 100 (sem padro).
   SAPI 5 e Microsoft Speech Platform: definir o tom de voz na faixa de -10 a 10 (o padro  0).

-v <nmero>
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: definir o volume na faixa de 0 a 100 (o padro  100).

-e <nmero>
   Ajustar o comprimento das pausas entre as frases (em milissegundos). O padro  0.

-a <nmero>
   Ajustar o comprimento das pausas entre os pargrafos (em milissegundos). O padro  0.

-d <nome_do_arquivo>
   Use o dicionrio para a pronncia correcta (arquivo com nextenso *.REX ou *.DIC). A linha de comando pode conter vrias opes [-d].

-k
   Parar o funcionamento de outras cpias do aplicativo de console em execuo no computador.

-ka
   Parar o funcionamento de um aplicativo de console que est activo no momento.

-q
   Adicionar o aplicativo para a fila. O aplicativo de console vai esperar at que as outras cpias do programa terminem de funcionar.

-lrc
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: criar um ficheiro do formato LRC, estando especificados os parmetros [-w] ou [-o].

-sub
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: o texto representa subttulos e deve ser convertido em um ficheiro udio com os intervalos de tempo especificados.

-tray
   Mostrar o cone do programa na rea de notificao do sistema operacional.
   Isso permite que o usurio monitore o progresso da operao, bem como interromper o processo no menu de contexto, clicando em "Stop".

-? ou -h
   Mostrar a descrio das opes da linha de comando.

--encoding <codificao> ou -enc <codificao>
   Codificao de texto a partir da entrada padro ("ansi", "utf8" ou "unicode"). O valor padro  "ansi".

--silence-begin <nmero> ou -sb <nmero>
   Especificar a durao da pausa no incio do ficheiro udio (em milissegundos). O padro  0.

--silence-end <nmero> ou -se <nmero>
   Especificar a durao da pausa no final de um ficheiro udio (em milissegundos). O padro  0.

--lrc-length <nmero>
   Especificar o comprimento mximo de cordas para ficheiro de formato LRC (em caracteres).

--lrc-filename <nome_do_arquivo>
   Nome  de ficheiro  do formato  LRC. A opo pode ser til em casos em que a linha de comando estiver definido o parmetro [-o].

--lrc-encoding <codificao>
   Codificao de ficheiro do formato LRC ("ansi", "utf8" ou "unicode"). O valor padro  "ansi".

--lrc-offset <nmero>
   Especificar a mudana da hora no ficheiro do formato LRC (em milissegundos).

--lrc-artist <texto>
   Etiqueta para ficheiro do formato LRC: intrprete da obra.

--lrc-album <texto>
   Etiqueta para ficheiro do formato LRC: lbum.

--lrc-title <texto>
   Etiqueta para ficheiro do formato LRC: ttulo da obra.

--lrc-author <texto>
   Etiqueta para ficheiro do formato LRC: autor.

--lrc-creator <texto>
   Etiqueta para ficheiro do formato LRC: criador do ficheiro.

--raw
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: gravar udio no formato PCM RAW;  os dados no contm ttulo do formato WAV.
   Esta opo  utilizada em conjunto com [-o].

--ignorelength
   SAPI 4: a opo no  usada.
   SAPI 5 e Microsoft Speech Platform: no inscrever o tamanho dos dados de udio no ttulo do formato WAV.
   Esta opo  utilizada em conjunto com [-o].

--sub-format <texto>
   Formato  dos subttulos ("srt", "ssa", "ass" ou "smi"). Se no for especificado, o formato ser determinado pela extenso do nome do ficheiro de subttulos.

--sub-fit ou -sf
   Aumentar automaticamente a velocidade da fala, a fim de conseguir cumprir os intervalos definidos nos subttulos.

--sub-max <nmero> ou -sm <nmero>
   Especificar a velocidade mxima de fala na faixa de -10 a 10 (para converter subttulos em ficheiros de udio).

--deletefile ou -df
   Eliminar um ficheiro de texto depois de ler em voz alta ou salvar o ficheiro de udio.


*** Exemplos ***

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 "Ricardo" -t "O texto vai ser lido devagar." -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


Exemplo de uso do aplicativo em conjunto com o programa utilitrio LAME.EXE:

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


Exemplo de uso do aplicativo em conjunto com o programa utilitrio OGGENC2.EXE:

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


Exemplo de uso do aplicativo em conjunto com o programa utilitrio WMAENCODE.EXE:

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


*** Arquivo de configurao ***

 possvel salvar o arquivo de configurao "balabolka_console.cfg" na mesma pasta que o aplicativo de console.

Um exemplo do contedo do arquivo:
===============
-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
===============

O programa pode combinar opes do arquivo de configurao e da linha de comando.


*** 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.


*** Licena ***

Direito ao uso no comercial do programa: 
- para pessoas singulares: sem restries; 
- para pessoas jurdicas: sujeito s restries contidas no "Contrato de licena" do software Balabolka. 

O uso comercial do programa s  permitido com a autorizao prvia do detentor dos direitos autorais.

###