win-balabolka-tts/dist/balcon/readme.fin.txt

使用Balabolka进行文字转换为语音

Balabolka (komentorivisovellus), versio 1.81
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved

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

Lisenssi: Freeware
K�ytt�j�restelm�: Microsoft Windows XP/Vista/7/8/10/11
Microsoft Speech API: v4.0/5.0
Microsoft Speech Platform: v11.0



*** Komentorivi ***

balcon [options ...]


*** Komentoriviparametrit ***

-l
   N�yt� kaikki tietokoneella olevat ��net.

-g
   N�yt� kaikki saatavilla olevat audiolaitteet.

-f <tiedoston_nimi>
   Avaa tekstitiedosto. Komentoon voi sis�lty� muutama [-f] -parametri.

-fl <tiedoston_nimi>
   Sets the name of the text file with the list of input files (one file name per line). Komentoon voi sis�lty� muutama [-fl] -parametri.

-w <tiedoston_nimi>
   Kirjoittaa WAV-��nitiedosto. Jos t�m� parametri on sy�ty, luodaan ��nitiedosto. Jos parametria ei ole, teksti� luetaan ��neen.

-n <��nen_nimi>
   ��nen nimi (nimenosa riitt��). Jos t�t� parametria ei ole, k�ytet��n Windowsin ohjauspaneelilla valittu ��ni.
   If the option is not specified, the voice, defined by the option [-id], or the default voice of Windows will be used.

-id <luku>
   Valita tietokoneen ��ni kielitunnisteen avulla (Language ID).
   Microsoftin kehitt�j�t my�nsiv�t sellaiset tunnisteet kaikille kielille (esimerkiksi, "1033" tai "0x0409" on englannin kielen tunniste ja "1035" tai "0x040B" � suomen kielen tunniste).
   Ohjelma valitsee listalta ensimm�isen ��nen, jonka kielitunniste vastaa tarvittavaan koodiin. Jos parametri ei ole annettu, niin k�ytet��n ��nt�, joka annettiin [�n] -parametrin avulla, tai ��nt�, joka valittiin Windowsin ohjauspaneelista.
   Tunnisteiden lista: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   N�ytt�� valitun ��nen parametrit.

-b <luku>
   Valitse audiolaite sen numeron mukaan saatavilla olevien laitteiden listasta ��nen esitt�miseen. Oletuslaitteen numero on 0.

-r <tekstin_rivi>
   Sets the audio output device by its name.

-c
   K�yt� leikep�yd�ss� oleva teksti.

-t <tekstin_rivi>
   K�yt� komentoriviss� oleva teksti. Komentoon voi sis�lty� muutama [-t] -parametri.

-i
   K�yt� standardisy�tt�virrassa oleva teksti (STDIN).

-o
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: kirjoita ��nitieto standarditulostevirtaan (STDOUT); jos parametri on mainittu, parametri [-w] on v�litt�m�tt�.

-s <luku>
   SAPI 4: asenna ��ninopeudeksi luku 0...100 (oletusnopeutta ei ole).
   SAPI 5 ja Microsoft Speech Platform: asenna ��ninopeudeksi luku -10...10 (oletusnopeus on 0).

-p <luku>
   SAPI 4: asenna ��nens�vyksi luku 0...100 (oletuss�vy� ei ole).
   SAPI 5 ja Microsoft Speech Platform: asenna ��nens�vyksi luku -10...10 (oletuss�vy on 0).

-v <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: asenna ��nenvoimakkuudeksi luku 0...100 (oletusvoimakkuus on 100).

-e <luku>
   Asenna lauseiden v�liseksi taukopituudeksi sy�tetty luku (yksikk�n� on millisekunti). Oletuspituus on 0.

-a <luku>
   Asenna kappaleiden v�liseksi taukopituudeksi sy�tetty luku (yksikk�n� on millisekunti). Oletuspituus on 0.

-d <tiedoston_nimi>
   K�yt� sanakirja ��nt�myksen korjaamiseksi (tiedostolaajennus *.BXD, *.DIC tai *.REX). Komentoon voi sis�lty� muutama [-d] -parametri.

-k
   Lopettaa muiden tietokoneella toimivien konsolisovellusten toimintaa.

-ka
   Lopettaa nykyhetkess� aktiivisena olevan konsolisovelluksen toimintaa.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Lis�t� sovellus jonoon. Konsolisovellus odottaa kunnes muut ohjelmat lopettavat toimintaan.

-lrc
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: luoda LRC-muotoinen tiedosto, jos on annettu [�w] tai [�o] �parametrit.

-srt
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: luoda SRT-muotoinen tiedosto, jos on annettu [�w] tai [�o] �parametrit.

-vs <tiedoston_nimi>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Tekstin muotona on tekstitys, joka pit�� muuttaa ��nitiedostoksi ottaen huomioon annetut v�liajat.

-tray
   N�ytt�� ohjelman kuvake k�ytt�j�rjestelm�n tiedotusten alueella.
   Se antaa k�ytt�j�lle mahdollisuutta seurata operaation suorittamista, sek� lopettaa prosessi pikavalikon "Stop"-kohdan avulla.

-ln <luku>
   Selects a line from the text file by using of a line number. The line numbering starts at "1".
   The interval of numbers can be used for selecting of more than one line (for example, "26-34").
   Komentoon voi sis�lty� muutama [-ln] -parametri.

-fr <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value of the selected voice will be used.

-bt <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio bit depth (8 tai 16).
   If the option is not specified, the default value of the selected voice will be used.

-ch <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio channel mode (1 tai 2).
   If the option is not specified, the default value of the selected voice will be used.

-dp
   Display progress information in a console window.

-h
   N�yt� kaikki mahdolliset parametrit.

--encoding <merkist�> tai �enc <merkist�>
   Tekstin koodaus tavallisesta sy�tt�virrasta ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--silence-begin <luku> tai -sb <luku>
   M��ritt�� ��nitiedoston alussa olevan tauon pituus (millisekunneissa). Oletuspituus on 0.

--silence-end <luku> tai -se <luku>
   M��ritt�� ��nitiedoston lopussa olevan tauon pituus (millisekunneissa). Oletuspituus on 0.

--lrc-length <luku>
   M��ritt�� LRC-muotoisen tiedoston maksimaalinen rivin pituus (symboleissa).

--lrc-fname <tiedoston_nimi>
   LRC-muotoisen tiedoston nimi. T�m� parametri voi olla hy�dyllinen niiss� tapauksissa, kun komentoriviss� on annettu parametri [�o].

--lrc-enc <merkist�>
   LRC-muotoisen tiedoston koodaus ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--lrc-offset <luku>
   Antaa ajansiirto LRC-muotoiselle tiedostolle (millisekunneissa).

--lrc-artist <tekstin_rivi>
   LRC-muotoisen tiedoston tag: teoksen esitt�j�.

--lrc-album <tekstin_rivi>
   LRC-muotoisen tiedoston tag: albumi.

--lrc-title <tekstin_rivi>
   LRC-muotoisen tiedoston tag: teoksen nimi.

--lrc-author <tekstin_rivi>
   LRC-muotoisen tiedoston tag: luoja.

--lrc-creator <tekstin_rivi>
   LRC-muotoisen tiedoston tag: tiedoston luoja.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <luku>
   M��ritt�� SRT-muotoisen tiedoston maksimaalinen rivin pituus (symboleissa).

--srt-fname <tiedoston_nimi>
   SRT-muotoisen tiedoston nimi. T�m� parametri voi olla hy�dyllinen niiss� tapauksissa, kun komentoriviss� on annettu parametri [�o].

--srt-enc <merkist�>
   SRT-muotoisen tiedoston koodaus ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--raw
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: tallentaa ��nitiedostot RAW PCM-muotoon; tiedostot eiv�t sis�ll� WAV-muotoista otsikkoa.
   Parametria k�ytet��n [�o] -parametrin parissa.

--ignore-length tai -il
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: ei kirjoita ��nitiedoston kokoa WAV-muotoiseen otsikkoon.
   Parametria k�ytet��n [�o] -parametrin parissa.

--sub-format <tekstin_rivi>
   Tekstityksen muoto ("srt", "lrc", "ssa", "ass", "smi" tai "vtt"). Jos parametri ei ole annettu, niin parametri m��ritet��n tekstityksen tiedostop��tteen mukaan.

--sub-fit tai -sf
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: lis�t� automaattisesti puheen nopeutta pysy�kseen tekstityksess� annettujen v�liaikojen rajoissa.

--sub-max <luku> tai -sm <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: m��ritt�� maksimaalinen puheen nopeus ��nialueella -10:st� 10:een (muuttaakseen tekstitys ��nitiedostoksi).

--delete-file tai -df
   Poistaa tekstitiedosto ��neen lukemisen tai ��nitiedoston tallentamisen j�lkeen.

--ignore-square-brackets tai -isb
   Ignore text in [square brackets].

--ignore-curly-brackets tai -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets tai -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets tai -irb
   Ignore text in (round brackets).

--ignore-url tai -iu
   Ignore URLs.

--ignore-comments tai -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <��nen_nimi>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <kielen tunnus>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tk, tr, tt, uk, zh.

--voice1-rate <luku>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <luku>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <luku>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <luku>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Esimerkkej� ***

balcon -l

balcon -n "Microsoft Anna" -m

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

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

balcon -n "Sanna" -t "Teksi luetaan hitaasti." -s -5 -v 70

balcon -k

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

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

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


Esimerkki sovelluksen k�ytt�mist� LAME.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Esimerkki sovelluksen k�ytt�mist� OGGENC2.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Esimerkki sovelluksen k�ytt�mist� WMAENCODE.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o -il | wmaencode - d:\book.wma --ignorelength


*** Konfiguraatiotiedosto ***

Parametrit voi tallentaa "balcon.cfg" -nimiseen konfiguraatiotiedostoon, joka sijaitsee sovelluksen kansiossa.

Tiedoston sis�llyksen esimerkki:
===================
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===================

Sovellus voi yhdist�� konfiguraatiotiedostossa olevat ja komentorivin parametrit.


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


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** Lisenssi ***

Sovelluksen kaupallinen k�ytt�oikeus:
- toiminimelle rajoituksetta;
- oikeushenkil�it� koskevat rajoitukset on mainittu Balabolkan lisenssisopimuksessa.

Sovelluksen kaupallinen k�ytt� sallittu ainoastaan oikeudenomistajan luvasta.

###