DSpeech (by Dimio)

~~~~~~~~~~~~~~~~~~

La versione aggiornata si trova al seguente Link:

Home: "http://dimio.altervista.org/"

DESCRIZIONE:
~~~~~~~~~~~~

DSpeech � un programma di TTS (Text To Speech) con funzionalit� di ASR (Automatic

Speech Recognition) integrate. E' cio� in grado di leggere ad alta voce il testo
scritto e di scegliere le frasi da pronunciare a seconda delle risposte vocali
dell'utente. E' progettato specificamente per fornire in maniera rapida e diretta
le funzioni di maggiore utilit� pratica che si richiedono ai programmi di questo
tipo, mantenendo al contempo al minimo l'invasivit� e il consumo di risorse (non si
installa, non si integra nel sistema, � leggerissimo, si avvia in un attimo e non
scrive niente nel registro).

Le principali caratteristiche di DSpeech sono:

- Permette di salvare l'output sotto forma di un file Wav o Mp3.

- Permette di selezionare rapidamente voci diverse e combinarle tra loro per creare
dialoghi fra pi� voci.
- Integra un sistema di RICONOSCIMENTO VOCALE che, oltre a poter essere utilizzato
come tale, tramite un semplice linguaggio di script, consente di creare dialoghi
interattivi con l'utente.
- Permette di configurare le voci in maniera indipendente.
- Tramite appositi TAG, consente di variare dinamicamente le caratteristiche delle
voci durante la riproduzione (velocit�, volume e frequenza), inserire pause,
enfatizzare termini o fare lo spelling.
- Permette di catturare e riprodurre automaticamente il contenuto del ClipBoard.
- Supporta tutti gli engine vocali compatibili con SAPI 4 e 5.
- Consente di registrare dal microfono ed inserire il risultato all'interno del
dialogo in modo tale da creare un mix di voci reali e sintetiche.
- Offre la possibilit� di monitorare un file di testo e di riprodurre ad alta voce
le modifiche via via che vi vengono aggiunte.
- E'accessibile tramite Screen Reader.
- Supporta delle personalit� virtuali (di default c'� solo Selena in italiano) che
consentono al computer di rispondere con delle risposte sensate (pi� o meno) alle
domande dell'utente.
- Pu� essere usato per doppiare i film, � cio� in grado di leggere i sottotitoli di
un film mentre lo si visiona.
- Infine � in grado di monitorare le modifiche ad un file di testo. Ogni volta che
il file viene modificato il programma ne legger� le parti nuove appena aggiunte.

Integra inoltre una serie di caratteristiche secondarie, tra cui:

- Supporta la linea di comando e pu� quindi essere utilizzato, senza interfaccia

grafica, per la creazione di audio-libri.
- Consente di specificare il formato dell'output audio, questo pu� venir utile in
situazioni molto particolari, quando c'� la necessit� di operare con dei file wav
di caratteristiche definite.
- Permette di creare dei montaggi inserendo, tramite un'apposita KeyWord, dei files
wav o mp3. Questo pu� essere utile per introdurre, durante la lettura, degli
effetti particolari, come un colpo di tosse, una risata, o anche degli stacchi
musicali.
- Quando si salvano gli mp3, � possibile specificare la qualit� degli stessi, in
maniera da privilegiare la dimensioni o la qualit� del risultato.
- E' possibile convertire del testo in mp3 o wav suddividendolo in file da 5, 10,
20 o 30 minuti ciascuno.
- Nel file "CustomTAG.TXT", � possibile inserire dei TAG personalizzati che
compariranno poi nel menu contestuale (ad esempio i tag espressivi di Loquendo).
- A scelta, tramite un'apposita opzione, � possibile attivare l'integrazione di
DSpeech con il menu contestuale di Windows.
- Tramite appositi file ".lng" � possibile traslare l'interfaccia in altre lingue.
- Permette di aprire e leggere direttamente da internet un file o una pagina web e
di memorizzare i link preferiti in un elenco.
- Possiede inoltre le principali funzionalit� di un word processor, per cui pu�
essere utilizzato anche a questo scopo.

Sebbene DSpeech supporti nativamente anche le voci SAPI4, esprime il meglio delle
sue potenzialit� con le voci SAPI5 (alcune opzioni avanzate sono disponibili solo
se si utilizzano queste ultime).

SCREEN READER E ACCESSIBILITA'

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DSpeech pu� essere utilizzato con qualsiasi Screen Reader, ma nello specifico �
testato per funzionare con lo Screen Reader NVDA.

CREAZIONE DEI DIALOGHI:

~~~~~~~~~~~~~~~~~~~~~~~

Tramite il menu contestuale (Right Click) � possibile specificare con quale voce
deve essere pronunciata una data frase, questo rende possibile la creazione di
dialoghi tra voci diverse.

UTILIZZO DEI TAG:

~~~~~~~~~~~~~~~~~

- E' possibile inserire appositi TAG che consentono di modificare le

caratteristiche della voce mentre sta parlando (velocit�, volume, frequenza etc).
- Sempre tramite i TAG � possibile ottenere effetti particolari, come
l'enfatizzazione di un termine, lo spelling di una o pi� parole e l'inserimento di
pause.
- In tutti i casi, i TAG hanno validit� unicamente all'interno della stessa linea.

OPZIONI DI RIPRODUZIONE:
~~~~~~~~~~~~~~~~~~~~~~~~

- Dall'interfaccia � possibile scegliere la voce da utilizzare ed � anche

possibile, tramite una voce di menu, specificare una voce secondaria che verr�
utilizzata per leggere il testo contenuto tra virgolette. Di essa si possono
specificare una velocit� ed un pitch diversi rispetto ai valori usati
correntemente.
- E' altres� possibile specificare il formato audio che verr� utilizzato.
Ovviamente se si user� un formato sbagliato, il suono risulter� alterato (il tipico
"Effetto Lattina").
- Chi disponesse di pi� schede audio, dall'apposita casella, pu� scegliere quale
utilizzare.
- Se si spunta la casella "Tracking", man mano che il testo viene pronunciato,
viene anche evidenziato a video.
- E' anche possibile far s� che DSpeech pronunci la linea appena scritta ogni volta
che si preme INVIO.
- Tramite una voce di menu � possibile scegliere di personalizzare la velocit�, il
volume e il pitch di ogni voce in modo separato. In questo modo � possibile
ottenere la massima personalizzazione nella creazione di dialoghi.
- Un'altra opzione � quella che consente di convertire in wav o mp3 a volume sempre
massimo; questa opzione, per ovvie ragioni, � incompatibile con la precedente (se
selezionata, disattiva la precedente e viceversa).

DOPPIAGGIO DEI FILM:

~~~~~~~~~~~~~~~~~~~~

- DSpeech � in grado di leggere i sottotitoli di un Film durante la sua

visualizzazione, � quindi in grado di leggere i file SRT (il formato standard dei
sottotitoli).
Tramite questa funzionalit� � possibile far s� che sia DSpeech a leggere i
sottotitoli mentre si guarda il film senza essere costretti a leggerli sullo
schermo (cosa che spesso impedisce di seguire lo svolgimento).
- Si consiglia di impostare una voce diversa per la lettura del testo tra
virgolette (menu "Options" --> "Customize voices in Quoted text"), ci� migliorer�
notevolmente il risultato finale.
- Per avviare il doppiaggio procedere come segue:

1. Assicurarsi che nella stessa cartella ci siano sia il film che si intende vedere
sia il file coi sottotitoli (.SRT).
2. Assicurarsi che il film e il file dei sottotitoli abbiano lo stesso nome (ad
esempio "Buffy.avi" e "Buffy.srt").
3. Assicurarsi che sia spuntata l'opzione "Allows Manage SRT files" e aprire il
file dei sottotitoli (ad es "Buffy.srt").
4. Posizionare il cursore nel punto dei sottotitoli da cui si vuole che inizi il
film.
5. Premere "Speak".

Penser� DSpeech ad avviare il lettore multimediale, a fargli aprire il film e a

fargli iniziare la riproduzione dal punto desiderato. Penser� sempre lui a regolare
automaticamente la velocit� della riproduzione nel caso la voce rimanga "indietro"
rispetto al video in modo che l'audio sia sempre sincronizzato col video.

OPZIONI AVANZATE:
~~~~~~~~~~~~~~~~~

- Tramite il menu contestuale, � possibile inserire una serie di KeyWord che

consentono di eseguire delle azioni particolari.
In particolare:
1. Avviare un programma esterno o aprire un file.
2. Iniziare la riproduzione di un dato file di testo.
3. Inserire un file wav o mp3 all'interno del dialogo che si sta creando (questo
pu� servire per creare dialoghi con effetti sonori).
4. Fare una pausa di tot secondi.
5. Chiudere DSpeech.
6. Sono anche disponibili delle istruzioni per il controllo di flusso, ma qui si
rimanda alla sezione "SISTEMA DI SCRIPT E RICONOSCIMENTO VOCALE".

- Tramite una voce di menu � possibile impostare la priorit� di DSpeech a "Idle" in

maniera che funzioni in totale background senza occupare la CPU destinata ad altri
processi. Questa opzione � utile soprattutto quando si creano audiolibri visto che
il processo di conversione pu� impegnare il PC anche per diverse ore.

RIPRODUZIONE DEL TESTO:

~~~~~~~~~~~~~~~~~~~~~~~

Tramite gli appositi pulsanti o i tasti di scelta rapida, � possibile iniziare e

sospendere o riprendere la riproduzione esattamente nel punto in cui si vuole.

REGISTRAZIONE DAL MICROFONO:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DSpeech consente di registrare una o pi� frasi al microfono, salvarla sotto forma
di file wav ed inserirla nel testo sotto forma di TAG. Questo consente di creare
dei mix tra voci reali e sintetiche.
La registrazione pu� essere attivata premendo l'apposito pulsante, se lo si preme
una seconda volta la registrazione termina.
E' quindi possibile riascoltare la registrazione stessa e, se ritenuta idonea,
salvarla sotto forma di file ed inserirla automaticamente nel testo sotto forma di
TAG.

OPZIONI DI ACCESSIBILIT�:
~~~~~~~~~~~~~~~~~~~~~~~~~

- Tramite l'opzione "Enable Hotkeys" � possibile pilotare DSpeech tramite HotKeys

da tastiera anche quando questo non si trova in primo piano.
- DAll'omonima voce di menu � possibile scegliere il "Verbose Mode". In queso modo
DSpeech pronuncer� ad alta voce i valori del volume, velocit� e pitch ogni volta
che essi vengono selezionati tramite tastiera.
- Mentre si fanno le prove col sistema di script pu� essere comodo attivare la
funzione del tasto TAB, in modo che, alla sua pressione corrisponda una tabulazione
invece che lo switch del fuoco tra i vari controlli. Ci� pu� essere fatto con una
apposita voce del menu di accessibilit�.
- E' anche possibile integrare DSpeech con il menu contestuale di EXplorer, in modo
tale da poter avviare, ad esempio, la conversione di un file testuale in mp3 senza
dover passare per l'interfaccia di DSpeech.

HOTKEYS:
~~~~~~~~

- Gli HotKeys si suddividono in due categorie, quelli interni al programma (come F5

per avviare la riproduzione o F4 per fare una pausa), che funzionano solo se si sta
lavorando su DSpeech, e quelli globali, simili ai precedenti per funzionalit�, ma
che invece vengono intercettati e continuano a funzionare anche se si sta lavorando
su altri programmi. Per attivare questi ultimi: menu Options --> Accessibility -->
Enable Global HotKeys Validity.
- Esiste una ulteriore opzione (menu Options --> Accessibility --> Allows to F10
HotKey to enable/disable global HotKeys validity) che consente, premendo il tasto
F10 in un qualunque contesto (anche mentre si sta usando Office per esempio), di
attivare o disattivare tutti gli HotKeys globali di DSpeech.
In questo modo � possibile, ad esempio, ricominciare la lettura di un testo
attualmente in fase di riproduzione senza dovere per questo abbandonare la finestra
del programma su cui si stava lavorando.
E' quindi sufficiente premere F10, premere F9 (che ordina a DSpeech di ricominciare
la lettura da capo) e poi premere nuovamente F10 per disattivare tutto il resto
degli HotKeys che magari ci potrebbero disturbare se stiamo facendo altre cose.
Questa opzione pu� anche essere attivata semplicemete cliccando sull'iconcina della
bacchetta.

OPZIONI AUDIO:
~~~~~~~~~~~~~~

- E' possibile specificare la scheda audio in cui reindirizzare l'output e,

soprattutto, il bitrate delle voci che si stanno utilizzando. Bisogna sempre
cercare di utilizzare lo stesso bitrate dalle voci in uso, in caso contrario, si
possono avere perdite di qualit� o l'effetto lattina (come se la voce parlasse in
una lattina).
- In generale, il settaggio utilizzato dalla maggior parte delle voci SAPI5 �: "16
Khz 16 Bit Mono" o "22 Khz 16 Bit Mono", mentre le SAPI4 utilizzano tutte "11 KHz
16 Bit Mono" (default per SAPI4).
- Questi settaggi sono particolarmente importanti quando si effettua una
conversione in file Wav o Mp3.

EDITING DEL TESTO:

~~~~~~~~~~~~~~~~~~

Oltre alle funzioni di editing standard (find, replace, cut etc.) � integrata una
funzione particolare, la "Remove Inappropriate Return Carriages". Essa serve ad
eliminare tutti i ritorni a capo inutili presenti nel testo che potrebbero limitare
la fluidit� della lettura da parte delle voci artificiali.
Infatti, spesso capita che un testo ottenuto tramite scansione di un libro,
contenga una serie di ritorni a capo dovuti all'impaginatura che impattano
negativamente nella qualit� di lettura da parte del TTS dato che tendono a spezzare
le frasi durante la lettura, questa funzione elimina tale problema.

MONITORAGGIO DEL CLIPBOARD:

~~~~~~~~~~~~~~~~~~~~~~~~~~~

Tramite l'apposito pulsante "Monitor clipboard" � possibile attivare il

monitoraggio del clipboard, ci� significa che il programma legger� automaticamente
il testo che via via viene copiato negli appunti.
Per disattivare questa opzione � sufficiente dispremerene il pulsante.

MONITORAGGIO DI UN FILE DI TESTO:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Un'altra opzione interessante � quella del monitoraggio dei file di testo. Premendo
l'apposito pulsante "Monitor file", verr� richiesto di specificare un file di testo
del quale verr� attivato il monitoraggio. Ogni volta che il suddetto file verr�
modificato, il programma ne legger� le parti nuove che non esistevano la volta
precedente.
Tramite questa funzione � possibile, per esempio, far leggere a DSpeech un testo
prodotto da un altro programma e di leggerne le parti che via via vengono aggiunte.
Questa opzione pu� essere attivata anche da linea di comando (es./MONITOR C:\
Folder\File.Txt).

CONVERSIONE DEL TESTO IN FILE WAV O MP3:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

E' possibile utilizzare DSpeech per
Se si sceglie il formato mp3, viene
caratteristiche della compressione;
le dimensioni, la qualit� audio del
cosa bilanciata.
la conversione del testo in un file Wav o Mp3.
data la possibilit� di specificare le
essa pu� essere settata in modo da privilegiare
file prodotto, oppure in modo da ottenere una

CREAZIONE DI AUDIOLIBRI:
~~~~~~~~~~~~~~~~~~~~~~~~

- Volendo, si pu� di suddividere il testo in pi� file di tot minuti ciascuno. E'
anche possibile utilizzare la suddivisione manuale del testo in files. In questo
caso, � necessario inserire la KeyWord >BREAK ogni volta che si vuol cambiare file.
- Spuntando l'opzione "Custom Volume Title", nel caso l'audiolibro sia suddiviso in
pi� parti, ognuna di queste avr� un titolo che le � proprio, il titolo in questione
verr� estrapolato automaticamente dal testo a meno che non venga
specificato di seguito alla KeyWord >BREAK.
- Tramite la voce di menu "Append" � possibile unire pi� files di testo uno dietro
all'altro. Tra l'uno e l'altro verr� inserita automaticamente la KeyWord >BREAK in
modo da consentire la suddivisione del testo in files separati.
- E' possibile inserire un silenzio di 300 msec all'inizio ed alla fine di ogni
file creato, in modo da mantenere la compatibilit� con i lettori CD o mp3 pi�
vecchi.
- Se si suddivide il testo in pi� volumi, all'inizio di ognuno viene inserito il
titolo e il numero del volume. E' possibile scegliere di invertire ci� in modo che
venga pronunciato prima il numero del volume e poi il titolo (ci� rende pi� agevole
il ritrovamento di uno specifico volume tra tanti.
- E' possibile specificare se si vuole che il programma, prima della conversione,
rimuova tutte le andate a capo inappropriate dovute ad un'errata formattazione del
testo. Ci� pu� essere molto utile per aumentare la fluidit� di alcuni testi
formattati male.
- Volendo (opzioni audiolibri) si pu� personalizzare il titolo di ogni file nel
quale viene suddiviso l'audiolibro, dopo la KeyWord >BREAK � possibile inserire del
testo, questo verr� utilizzato come titolo, se non si specifica niente il titolo
verr� estrapolato dal testo.
- E' infine possibile specificare un ritardo (da 100 millisecondi a 5 secondi) da
inserire automaticamente tra le frasi.

CONVERSAZIONE CON L'IA:

~~~~~~~~~~~~~~~~~~~~~~~

Attivando la funzione "Enable IA reply when press Enter" si pu� avere l'illusione
(pi� o meno) di conversare con un altro essere umano. Ogni volta che si preme INVIO
la frase verr� analizzata e D-Speech risponder� con una frase adeguata.
Di default � installata solo una personalit� virtuale in italiano (Selena) che
richiede quindi una voce femminile italiana per essere usata, ma il programma � in
grado di utilizzarne anche delle altre (se mai verranno realizzate).
In verit� non si pu� parlare di una vera e propria intelligenza artificiale dato
che il "core" dell'algoritmo si basa sul "pattern matching", ciononostante, questa
tecnica � attualmente quella che d� i migliori risultati in termini di realismo
delle risposte. Il database con le frasi-modello (che corrisponde al file
SELENA.IA) �, in parte, derivato da un vecchio programma open-source (Babbea) nato
a sua volta per prendere in giro un altro programma di IA (Eloisa) che veniva, a
suo tempo, spacciato per programma pensante.
In ogni caso il file � modificabile a piacimento.

RICONOSCIMENTO VOCALE:
~~~~~~~~~~~~~~~~~~~~~~

Premendo il pulsante "Start ASR" si attiva il riconoscimento vocale. DSpeech

cercher� di riconoscere le frasi che vengono pronunciate al microfono. Se si attiva
la funzione "Enable IA reply when press Enter" si potr� conversare in tempo reale
con la personalit� virtuale.
Tramite un'apposita voce di menu � possibile selezionare e specificare l'engine di
riconoscimento vocale da utilizzare. Purtroppo l'unico engine gratuito, ad oggi, �
il "MS English Recognizer" che � solo in inglese, per cui, se si vuole utilizzare
altri linguaggi, o ci si rivolge a prodotti di terze parti o si aspetta la versione
microsoft (che dicono sia in lavorazione).

FORMATI DI FILE DI TESTO SUPPORTATI:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sono supportati i seguenti tipi di file testuali:

- TXT (File testuali semplici sia in formato ANSI che UNICODE).

- RTF
- HTM, HTML
- PDF (Richiede sia presente "PDFToText.exe").
- DOC (File prodotti con MS Word, per utilizzarli � necessario che Word sia
installato).
- XML (Sperimentale, formato utilizzato per i Feed RSS).

CONFIGURAZIONE MINIMA:
~~~~~~~~~~~~~~~~~~~~~~

- Windows XP non ha bisogno che venga installato nessun pacchetto software

aggiuntivo relativo al TTS visto che include gi� le librerie SAPI5.

- Su Windows NT/2000, invece, bisogna installare il pacchetto MS-SAPI5.1 (6MB)

scaricabile da uno dei seguenti link:

http://aldostools.mysite4now.com/sapi51.msi
http://www.mbsoft.biz/download/sapi51.exe
http://www.arlington.com.au/sapi51.msi

- Su Windows NT/2000/XP/2003, se si vuole utilizzare anche le funzioni di

riconoscimento vocale, bisogna installare almeno un engine ASR. La microsoft ne
mette a disposizione uno gratuito (per ora soltanto in inglese) che pu� essere
installato scaricando, dal sito Microsoft, l'intero pacchetto SAPI 5.1 SDK (60MB)
che lo comprende, oppure (scelta consigliata) scaricando il solo engine (30MB) da
questo link:

http://clans.gameclubcentral.com/shoot/SR.zip

DSpeech richiede una risoluzione di almeno 1024x768.

DSpeech non � testato su sistemi Windows 9x.

LE VOCI:
~~~~~~~~

Le voci si dividono in due categorie:

1. SAPI4 compatibili (queste voci sono pi� primitive ma si trovano facilmente e, in

genere, sono gratuite).
2. SAPI5 compatibili (queste voci invece sono molto pi� elevate qualitativamente,
ma di gratuito c'� poco).

- Windows XP/2003

Windows XP/2003 integra gi� SAPI5 + una voce di qualit� molto bassa (Microsoft
SAM). E' possibile installare anche altre due voci simili (Mary e Mike) scaricabili
gratuitamente da uno dei seguenti link:

http://www.text-speech.com/voices/Sp5TTIntXP.msi
http://download.microsoft.com/download/speechSDK/SDK/5.1/WXP/EN-US/Sp5TTIntXP.exe

Se si vuole utilizzare anche le voci SAPI4 � necessario installare SAPI4 stesso,

scaricabile da qui:

http://activex.microsoft.com/activex/controls/sapi/spchapi.exe

- Windows NT/2000

Windows NT/2000, al contrario, integra solo il supporto SAPI4, per cui, se si vuole
utilizzare le voci SAPI5, � necessario installare SAPI5 (che comprende SAM, Mary e
Mike), scaricabile da uno dei seguenti link.

http://aldostools.mysite4now.com/sapi51.msi
http://www.mbsoft.biz/download/sapi51.exe
http://www.arlington.com.au/sapi51.msi

- Dal mio sito � possibile scaricare delle voci SAPI4 e SAPI5 gratuite nei vari
linguaggi.

Le voci SAPI4 sono sicuramente migliori di SAM, ma la loro qualit� � veramente

scarsa se confrontata con voci SAPI5 di terze parti (la differenza � abissale). Le
migliori purtroppo sono a pagamento e, a volte, non � nemmeno facile procurarsele
in maniera legale. In ogni caso, al top della categoria troviamo le voci dei
segenti produttori:
- Acapela (Qualit� media).
- CereProc (Buon rapporto prezzo/prestazioni, buona qualit�).
- Cepstral (Buon rapporto prezzo/prestazioni, qualit� media).
- Ivona (Tra le migliori sia per la naturalezza che per la prosodia).
- Loquendo (Molte voci di qualit�, costano anche tanto).
- RealSpeak (Buone voci).
- VoiceWare (Buona prosodia, ma solo in inglese).

SISTEMA DI SCRIPT E RICONOSCIMENTO VOCALE:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

DSpeech supporta un sistema di riconoscimento vocale che, unito ad un semplice

sistema di script, lo rende in grado di creare dialoghi interattivi con l'utente
del tipo:
UTENTE: "Computer"
PC: "Computer pronto, chi sei?"
UTENTE: "Dimio"
PC: "Benvenuto allora"
Etc.

Il sistema di script � molto simile al BASIC. La maggior parte delle Keywords sono
progettate per funzionare solo in modalit� diretta e, durante la conversione in
file audio, vengono semplicemente ignorate, ciononostante alcune di esse, ad
esempio la Keyword ">STOP", funzionano anche durante le conversioni.

Sono supportate le seguenti KeyWords (qui raggruppate per tipologia):

>VOICE NomeVoce

>DO
>EXIT DO
>LOOP [n]

>RECOGNIZE Parola1, [Parola2], [OTHER_WORDS]...

>RECOGNIZE_WITH_TIMEOUT Secondi, Parola1, [Parola2], [OTHER_WORDS]...

>IF RECOGNIZED Parola1, [Parola2], [OTHER_WORDS]...

>IF TIMEOUT
>END IF

>CALL NomeSub

>SUB NomeSub
>END SUB

>RANDOM
>CASE
>END RANDOM

>EXECUTE PathFileOProgramma
>OPEN FileToSpeech.txt
>PLAY FileName.wav

>WAIT Secondi
>DELAY MilliSecondi
>REM
>STOP
>BREAK
>CLEAR
>CLOSE
>DEL
>HIDE
>SHOW
>TOP
>WAIT_ANYKEY
>SHUTDOWN
>SELFDESTRUCT
>SELFDESTRUCT_AND_SHUTDOWN

DESCRIZIONE DEI COMANDI:

>REM Commento
Permette di inserire dei commenti nel testo che verranno completamente ignorati da
DSpeech sia durante la riproduzione che nella conversione in file audio.

>VOICE NomeVoce
Cambia la voce narrante.

>DO
...
>EXIT DO
...
>LOOP [n]
Esegue un loop ciclico, quando incontra l'"exit do", ne esce. Se si specifica un
numero [n], verr� eseguito solo il numero di cicli indicato.

>RECOGNIZE Parola1, [Parola2], [OTHER_WORDS]...

Si mette in attesa di un input vocale, appena questo viene fornito ne memorizza il
risultato e prosegue con l'istruzione successiva.

>RECOGNIZE_WITH_TIMEOUT Secondi, Parola1, [Parola2], [OTHER_WORDS]...

Come il precedente ma con un timeout, se entro il tempo specificato l'input vocale
non � stato fornito prosegue con l'istruzione successiva.

>IF RECOGNIZED Parola1, [Parola2], [OTHER_WORDS]...

...
>END IF
Esegue i comandi compresi tra l'IF e l'END IF se, dopo un >RECOGNIZE o un
>RECOGNIZE_WITH_TIMEOUT � stata riconosciuta una delle parole specificate.

>IF TIMEOUT
...
>END IF
Esegue i comandi compresi tra l'IF e l'END IF se, dopo un >RECOGNIZE_WITH_TIMEOUT �
passato il tempo specificato senza che l'utente fornisse un input vocale.

>CALL NomeSub
...
>SUB NomeSub
...
>END SUB
La prima istruzione, >CALL NomeSub, fa s� che l'esecuzione salti alla >SUB NomeSub
mentre >END SUB, determina il ritorno all'istruzione immediatamente successiva alla
>CALL NomeSub (� del tutto analogo al vecchio Gosub e Return del Basic).

>RANDOM
...
>CASE
...
>CASE
...
>CASE
...
>END RANDOM
Permette di eseguire in maniera casuale le istruzioni seguenti ad uno dei case.

>EXECUTE PathFileOProgramma
Apre un file specificato o avvia un programma.

>OPEN FileToSpeech.txt
Apre un file di testo e ne inizia la riproduzione.

>STOP
Termina l'esecuzione dello script e/o della riproduzione vocale o della conversione
in file audio.

>BREAK
Keyword utilizzata per splittare un file in pi� mp3 in punti prestabiliti.

>PLAY FileName.wav
Riproduce un file wav.

>WAIT Secondi
Attende tot secondi (1-60) prima di proseguire.

>DELAY MilliSecondi
Attende il numero specificato di millisecondi (100-900) prima di proseguire.

>CLOSE
Chiude il programma DSpeech senza salvare i settaggi.

>CLEAR
Cancella il contenuto della finestra.

>DEL PathFile
Cancella il file o la cartella indicata.

>HIDE
Rende invisibile la finestra del programma.

>SHOW
Visualizza nuovamente la finestra del programma annullando un precedente comando
>HIDE.

>TOP
Metti in primo piano la finestra principale di DSpeech.

>WAIT_ANYKEY
Si mette in attesa che l'utente prema un tasto qualsiasi e poi prosegue.

>SHUTDOWN
Spegne il computer, se si vuole che DSpeech si chiuda in un modo specifico, ad
esempio senza salvare i settaggi, far seguire al comando di Shutdown l'apposito
comando di chiusura di DSpeech, come >CLOSE o >SELFDESTRUCT.

>SELFDESTRUCT
Chiude DSpeech e cancella il file "DSpeech.exe" (cio� si auto cancella dal disco),
il file "DSpeech.ini" e il file eventualmente aperto.

>SELFDESTRUCT_AND_SHUTDOWN
Cancella "DSpeech.exe", "DSpeech.ini" e l'eventuale file aperto e subito dopo
spegne il computer.

Nel menu contestuale (right-click) � possibile trovare tutte queste KEYWORDS con
relativi ESEMPI.
Un esempio di script per il riconoscimento vocale potrebbe essere il seguente:

>VOICE Luca
Io sono Angelus, il computer di Dimitri. Tu chi sei?
>DO
>RECOGNIZE Dimitri, Gloria, OTHER_WORDS
>IF RECOGNIZED Dimitri
Angelus in attesa di istruzioni.
>EXIT DO
>END IF
>IF RECOGNIZED Gloria
Hai sbagliato computer, il tuo � quello di fianco.
>EXIT DO
>END IF
>IF RECOGNIZED OTHER_WORDS
>RANDOM
>CASE
Puoi ripetere per favore? Non ho capito il tuo nome.
>CASE
Cos'hai detto? Puoi Ripetere?
>CASE
Non ho capito quello che hai detto, forse, semplicemente, il tuo
nome non lo conosco.
>END RANDOM
>END IF
>LOOP

A meno che non si disponga di engine ASR commerciali compatibili con SAPI5 (come
l'ASR della Loquendo), ci si limiter� ad usare l'engine gratuito della Microsoft
(sul mio sito si trova il link) che si basa sulla fonetica inglese, per cui, per
far riconoscere alcune parole, � spesso necessario adattarle alla pronuncia
inglese. Ad esempio, per far riconoscere al computer la parola "Russia" bisogner�
scrivere "Rassya".

SHORTCUTS:
~~~~~~~~~~

Tutte le funzioni dell'interfaccia solo associate a degli shortcut di tastiera,

sono inoltre supportati i seguenti tasti speciali:

F1 = Vai alla casella di editing

F4 = Pause/Resume
 F5 = Speak/Stop
F6 o ALT + UP = Speak Previous Line
F7 o ALT + LEFT = Speak Current Line
F8 o ALT + DOWN = Speak Next Line
F9 o ALT + RIGHT = Speak From Cursor
F11 = Passa alla voce precedente
F12 = Passa alla voce successiva
F11+SHIFT = Passa alla prima voce della lista.
F12+SHIFT = Passa all'ultima voce della lista.

ESC = Stop
ALT+1 = Aumenta il volume
ALT+2 = Diminuisce il volume
ALT+3 = Aumenta la velocit�
ALT+4 = Diminuisce la velocit�
ALT+5 = Aumenta il pitch
ALT+6 = Diminuisce il pitch

LINEA DI COMANDO:
~~~~~~~~~~~~~~~~~

E' possibile specificare un nome di file da aprire e riprodurre automaticamente.

Questo permette, ad esempio, di eseguire in maniera automatica uno script.

SINTASSI:

DSPEECH [/Play] [/Speak] [/Wav] [/Mp3] [/Ogg] [/Aac] [/Wma] [/Monitor]

[/Hidden|/HiddenFix|/Minimize/FullScreen] [/Silent] [/Voice "VoiceName"]
[FileToSpeech.txt] [FileOutput.mp3]

E' possibile indicare come unica opzione un file di testo da aprire, nell'esempio
seguente DSpeech si limiter� ad aprire l'interfaccia e a caricare il file
"FileToSpeech.txt".

DSpeech.exe FileToSpeech.txt

/Voice = Consente di specificare la voce da utilizzare, un esempio potrebbe essere

il seguente:
DSpeech /VOICE "Silvia"
La stringa col nome della voce deve essere tra virgolette, non � necessario che
contenga il nome completo della Voce con la sua descrizione, anche un semplice
/VOICE "Sil" potrebbe essere sufficiente.

/Play = Consente di avviare la riproduzione di un file o di una pagina web. Nei

seguenti esempi vengono caricati i file "FileToSpeech.txt" e "index.html" e ne
viene avviata la riproduzione.

DSpeech.exe /Play FileToSpeech.txt

DSpeech.exe /Play http://dimio.altervista.org/ita/index.html

/Speak = Consente di pronunciare una breve frase. Nel seguente esempio viene
pronunciata la parola "Hello!" senza che venga aperta l'interfaccia di DSpeech.

DSpeech.exe /Speak Hello!

/Mp3 = Consente di convertire un file testuale in un file Mp3. Nel primo dei
seguenti esempi il file "Origine.txt" viene convertito in un file di nome
"origine.mp3". Mentre nel secondo esempio il file "Origine.txt" viene convertito in
un file di nome "Destinazione.mp3". Nel terzo esempio il file web index.html viene
convertito in un file di nome "Destinazione.mp3".

DSpeech.exe /mp3 origine.txt

DSpeech.exe /mp3 origine.txt destinazione.mp3
DSpeech.exe /mp3 http://dimio.altervista.org/ita/index.html destinazione.mp3

/Wav = Consente di convertire un file testuale in un file Wav. (Vedi sopra).

/Ogg = Consente di convertire un file testuale in un file Ogg Vorbis. (Vedi sopra).

/Aac = Consente di convertire un file testuale in formato AAC per dispositivi

Apple.

/Wma = Consente di convertire un file testuale in formato WMA.

/Silent = Disabilita tutti gli effetti sonori.

/Minimize = Minimizza la finestra all'avvio.

/Hidden = Indica al programma di non mostrare l'interfaccia grafica, DSpeech

eseguir� il compito assegnatogli rimanendo in background e, al termine di questo,
automaticamente si chiuder�. Nel seguente esempio il file di testo "origine.txt"
viene convertito in "destinazione.mp3" senza mostrare l'interfaccia grafica.

DSpeech.exe /Hidden /Mp3 origine.txt destinazione.mp3

/Hiddenfix = Come il precedente, da usare a sostituzione di questi nel caso vi

siano problemi (fischi, crepitii) con i tag espressivi delle voci loquendo (i tag
espressivi sono i colpi di tosse, le risate etc.)

/FullScreen = Imposta la modalit� a tutto schermo gi� dall'avvio.

/Monitor = Attiva il monitoraggio del file di testo specificato (es. /Monitor C:\
Folder\File.txt) ogni volta che il file verr� modificato ne verr� letta la parte
nuova.

In generale, la combinazione che consiglio di usare � quella dell'esempio seguente

che indica a DSpeech di convertire, pur rimanendo in background senza mostrare
l'interfaccia, un file testuale in un file mp3 e di chiudersi a procedura
completata. Il parametro [destinazione] � opzionale.

DSpeech.exe /Hidden /Mp3 origine.txt destinazione.mp3

CONVERSIONI MULTIPLE (BATCH):

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Le conversioni multiple possono essere ottenute in due modi:

1. Tramite la voce di menu "Batch Conversion..."

2. Tramite la creazione di un file Batch che contenga i comandi di conversione dei

files che si vogliono convertire.
Ad esempio, l'esecuzione del seguente file batch:
DSpeech.exe /mp3 File1.txt
DSpeech.exe /mp3 File2.txt

Determina la creazione dei file "File1.mp3" e "File2.mp3" risultato della

conversione dei due files di origine.

PROBLEMI NOTI:
~~~~~~~~~~~~~~

I Tag espressivi delle voci Loquendo (ad esempio "\_Laugh_01" o "\_Ahahah") sono
incompatibili con il cambio del parametro PITCH. In dettaglio, se si modifica il
Pitch, anche per una sola volta, i Tag espressivi, nei salvataggi successivi,
verranno accompagnati da un fruscio molto brutto da sentire. L'unico modo per farli
funzionare di nuovo � chiudere DSpeech e riavviarlo un'altra volta.

Note:
~~~~~

- Quando si inserisce un file mp3 nel testo, specie se di grosse dimensioni, pu�
essere avvertita una piccola pausa tra la riproduzione della linea precedente e la
riproduzione del file audio, ci� � normale e non costituisce un difetto, in ogni
caso, quando si va a salvare il risultato sotto forma di file wav o mp3, la pausa
scompare completamente.
- Per la compressione in mp3 viene utilizzato il codec Lame (www.mp3dev.org), esso
corrisponde al file "Lame.exe" incluso nel pacchetto.
- Per la compressione in Ogg Vorbis viene utilizzato l'encoder "oggenc.exe" facente
parte del pacchetto "vorbis-tools-1.0.1-win32".
- Per l'apertura dei file PDF viene utilizzato il file "pdftotext.exe", facente
parte del pacchetto "Xpdf" (http://www.foolabs.com/xpdf/).
- Per la compressione in AAC viene utilizzato il file "neroaacenc.exe" della Nero
AG (sono gli stessi di Nero Burning Rom).

LICENZA:
~~~~~~~~
Il programma viene distribuito con la licenza Freeware (fare riferimento al file
incluso al pacchetto per i dettagli).
Questo, riassunto in due parole, significa: il software � gratuito e potete usarlo
come vi pare, anche integrarlo in un CD, in un programma vostro o in un pacchetto
commerciale da rivendere se volete. L'unica cosa che non � permessa � la
decompilazione e la modifica dei sorgenti.
Per la lettura dei PDF e l'encoding nei vari formati (mp3, ogg, aac) rifarsi alla
licenza relativa dei singoli file exe utilizzati per la specifica funzione
richiesta (pdftotext --> apre i pdf, oggenc --> salva in ogg vorbis, neroaacenc -->
salva in aac, wmaencode --> Salva in wma, lame --> Salva in mp3) si tratta comunque
sempre di freeware, per cui non dovrebbero esserci problemi in ogni caso.

PROGRAMMATORI:
~~~~~~~~~~~~~~

Dimitrios Coutsoumbas (Dimio)

E-MAIL : cyberdimio@gmail.com
HOME : http://dimio.altervista.org/

BETA-TESTERS:
~~~~~~~~~~~~~

Luna
Matas