# O Manual do &kmouth;

## Introdução

O &kmouth; é uma aplicação que permite às pessoas que não conseguem falar deixar que os seus computadores falem por elas. Inclui um histórico das palavras faladas a partir das quais o utilizador pode seleccionar as frases a serem faladas de novo.

Tenha em atenção que o &kmouth; não inclui um sintetizador de voz. Em vez disso, necessita que tenha um sintetizador de voz instalado no sistema.

Por favor comunique quaisquer problemas e pedidos de funcionalidades ao autor do &kmouth;.

## Utilização do &kmouth;

### O primeiro arranque

Durante o primeiro arranque do &kmouth; é apresentado um assistente no qual você poderá efectuar algumas configurações básicas.

O assistente O assistente

Com a primeira página do assistente (a imagem da esquerda) você indica o comando que deverá ser usado posteriormente para a conversão de texto para voz. Para mais detalhes veja a descrição da janela de configuração.

Com a segunda página você selecciona quais os livros de frases que você necessita. A partir dos livros de frases você poderá seleccionar as frases mais usadas para que não as tenha de escrever de novo. Claro que o &kmouth; também tem uma janela de edição para o caso em que você queira editar os seus livros de frases.

### A janela principal

A janela principal do &kmouth; é relativamente simples. Consiste basicamente num campo de edição onde você pode escrever as suas frases (o campo branco em baixo na imagem) e um histórico das frases faladas (o campo branco superior na imagem).

A janela principal do &kmouth; Imagem

Assumindo que você tenha configurado correctamente o &kmouth;, você poderá usar o campo de edição para escrever as frases que deseja ouvir. Logo que uma frase seja pronunciada, a mesma será adicionada ao histórico. No histórico, você poderá seleccionar as frases a serem faladas de novo.

Nos livros de frases (localizados na linha por baixo da barra de ferramentas), você poderá seleccionar as frases mais usadas.

### A Janela de Configuração

Ao usar o item do menu Configuração Configurar o &kmouth;... você irá abrir a janela de configuração do &kmouth;. Esta janela consiste em duas páginas, a Texto-para-Voz e a Preferências.

A janela de configuração do &kmouth; Imagem

#### A página de Texto-para-Voz

No campo de edição da página Texto-para-Voz você pode indicar o comando para invocar o sintetizador de voz. Com a lista por bbaixo do campo de edição você poderá indicar a codificação de caracteres que é usada para passar o texto para o sintetizador de voz.

O &kmouth; tem duas formas de passar o texto: Se o comando esperar o texto no 'standard input' você deverá seleccionar a opção.

A outra forma é passando o texto como um parâmetro: Antes de invocar o comando, o &kmouth; substituirá todas as ocorrências de %t no comando pelo texto (escreva %% para passar um sinal de percentagem).

Como é óbvio, o comando para gerar as frases é dependente do sintetizador de voz que você usa. Por favor veja a documentação do seu sintetizador de voz para o comando usado para sintetizar os textos.

Ao seleccionar a opção Usar o serviço de fala do 'kttsd' se possível, você indicará ao &kmouth; para tentar em primeiro lugar enviar para o serviço de fala do 'kttsd'. Se isto for bem sucedido, os outros itens de configuração desta página serão ignorados. O serviço de fala do 'kttsd' é um servidor do &kde; que fornece às aplicações do &kde; uma interface normalizada para a síntese de voz e está em desenvolvimento no presente momento no CVS. É mais seguro seleccionar esta opção, mesmo que o 'kttsd' não esteja instalado.

#### A página de Preferências

A página de Preferências contém as opções que alteram o comportamento do &kmouth; em certas situações.

Com a primeira lista, a Selecção de frases no livro de frases, você indica a acção que é despoletada ao escrever o atalho de uma frase ou seleccionando a frase no menu do Livro de Frases ou na barra do livro de frases.

Ao seleccionar a opção Falar imediatamente, a frase seleccionada é imediatamente sintetizada e introduzida no histórico. Se você seleccionar a opção Inserir no Campo de Edição, a frase seleccionada é somente introduzida no campo de edição.

Com a segunda lista, a Fechar a janela de edição do livro de frases, você pode indicar se o livro de frases é gravado se você fechar simplesmente a janela de edição do livro de frases.

Ao optar por Gravar o Livro de Frases, o livro de frases é de facto gravado. Se seleccionar a opção Esquecer as alterações, as modificações são descartadas e o livro de frases não é mais gravado. Se você seleccionar a opção Perguntar para gravar, o &kmouth; perguntar-lhe-á se deverá ou não gravar o livro de frases.

### A Janela de Edição do Livro de Frases

Ao usar o item do menu Livro de Frases Editar... , você irá abrir a janela de edição do livro de frases.

A janela de edição de livro de frases Imagem

A área principal da janela de edição do livro de frases está dividida em duas partes. Na parte superior, os livros de frases são mostrados numa estrutura em árvore.

Na parte inferior você poderá modificar um item seleccionado. Se você tiver seleccionado uma frase, você poderá modificar o conteúdo da frase, assim como o seu atalho. Se você tiver seleccionado um livro de frases só poderá o nome do mesmo.

As acções como a adição de frases e livro de frases novos, assim como a remoção de livros de frases e frases individuais, poderão ser efectuadas através da selecção das mesmas no menu, na barra de ferramentas ou no menu de contexto.

Você pode alterar a ordem dos livros de frases e das frases em si arrastando-os para os seus novos locais ou usando as teclas de cursores enquanto pressiona a tecla &Alt;.

## Referência de Comandos

### Comandos na Janela Principal

#### O Menu Ficheiro

&Ctrl;O Ficheiro Abrir como histórico...

- Abre um ficheiro de texto como um histórico de frases faladas.

&Ctrl;S Ficheiro Gravar o histórico como...

- Grava o histórico num ficheiro de texto.

&Ctrl;P Ficheiro Imprimir o histórico...

- Imprime o histórico.

&Ctrl;Q Ficheiro Sair

- Sai do &kmouth;

#### O Menu Editar

&Ctrl;X Editar Cortar

- Corta a secção seleccionada e coloca-a na área de transferência. Se existir algum texto seleccionado no campo de edição, este é colocado na área de transferência. Caso contrário, as sequências seleccionadas no histórico (se existirem) são colocadas na área de transferência.

&Ctrl;C Editar Copiar

- Copia a secção seleccionada para a área de transferência. Se existir algum texto seleccionado no campo de edição, este é colocado na área de transferência. Caso contrário, as sequências seleccionadas no histórico (se existirem) são colocadas na área de transferência.

&Ctrl;V Edit Colar

- Cola o conteúdo da área de transferência na posição actual do campo de edição.

Editar Falar

- Fala as frases activas de momento. Se existir algum texto no campo de edição, este será falado. Caso contrário, as frases seleccionadas no histórico (se existirem) serão faladas.

#### O Menu Livros de Frases

Livros de Frases Editar...

- Abre a janela de edição dos livros de frases.

#### O Menu Configuração

Configuração Mostrar a Barra de Ferramentas

- Quando estiver seleccionada esta opção, irá mostrar uma barra de ferramentas móve que contém os botões usados para iniciar os comandos usados mais frequentemente. A barra de ferramentas situa-se geralmente no topo do editor, logo por baixo do menu. Se a opção estiver desligada, a barra de ferramentas estará escondida. Se carregar na pega estriada irá esconder ou fazer reaparecer a barra. Se carregar e arrastar esta pega, o utilizador poderá mover a barra em si.

Configuração Mostrar a Barra de Estado

- Quando está assinalada a opção, esta mostra uma pequena barra no fundo da janela principal que contém alguma informação sobre o estado do &kmouth;. Quando está desligada, a barra de estado fica escondida.

Configuração Configurar o KMouth...

- Abre a janela de configuração do sintetizador de voz e de outras opções do &kmouth;.

#### O Menu Ajuda

&help.menu.documentation;

#### O menu de contexto dos itens do histórico

Falar

- As frases seleccionadas são sintetizadas.

Remover

- As frases seleccionadas são removidas do histórico.

Cortar

- As frases seleccionadas são removidas e colocadas na área de transferência.

Copiar

- As frases seleccionadas são copiadas para a área de transferência.

Seleccionar todos os itens

- Todos os itens do histórico são seleccionados.

Deseleccionar todos os itens

- Todos os itens do histórico ficam deseleccionados.

&Ctrl;O Abrir como histórico...

- Abre um ficheiro de texto como um histórico de frases faladas.

&Ctrl;S Gravar o histórico como...

- Grava o histórico num ficheiro de texto.

### Os comandos da janela de edição do livro de frases

#### O Menu Ficheiro

Ficheiro Nova Frase

- Adiciona uma nova frase.

Ficheiro Novo Livro de Frases

- Adiciona um novo livro de frases.

&Ctrl;S Ficheiro Gravar

- Grava o livro de frases.

Ficheiro Importar...

- Importa um ficheiro e adiciona o seu conteúdo ao livro de frases

Ficheiro Importar o Livro de Frases Padrão

- Importa um livro de frases normal e adiciona o seu conteúdo ao livro de frases

Ficheiro Exportar...

- Exporta a frase ou frases ou os livros de frases seleccionados no momento num ficheiro

&Ctrl;P Ficheiro Imprimir...

- Imprime as frases ou livros seleccionados no momento

&Ctrl;W Ficheiro Fechar

- Fecha a janela

#### O Menu Editar

&Ctrl;X Editar Cortar

- Corta os itens seleccionados e coloca-os na área de transferência.

&Ctrl;C Editar Copiar

- Copia os itens seleccionados para a área de transferência.

&Ctrl;V Edit Colar

- Cola o conteúdo da área de transferência no livro de frases.

Editar Apagar

- Apaga os itens seleccionados.

#### O Menu Ajuda

&help.menu.documentation;

#### O Menu de Contexto

Nova Frase

- Adiciona uma nova frase.

Novo Livro de Frases

- Adiciona um novo livro de frases.

Importar...

- Importa um ficheiro e adiciona o seu conteúdo ao livro de frases

Importar o Livro de Frases-Padrão

- Importa um livro de frases normal e adiciona o seu conteúdo ao livro de frases

Exportar...

- Exporta a frase ou frases ou os livros de frases seleccionados no momento num ficheiro

Cortar

- Corta os itens seleccionados e coloca-os na área de transferência.

Copiar

- Copia os itens seleccionados para a área de transferência.

Colar

- Cola o conteúdo da área de transferência nesta posição do livro de frases.

Apagar

- Apaga os itens seleccionados.

## Perguntas e Respostas

&reporting.bugs; &updating.documentation;

Eu não oiço nada.

Muito provavelmente você não configurou correctamente (ou de todo?) o comando de texto-para-fala. Use a opção Configuração Conversão de texto-para-fala e introduza o comando para sintetizar os textos (Veja a secção sobre a janela de configuração do sintetizador de voz para mais detalhes).

## Créditos e Licença

&kappname;

Programa copyright 2002, 2003 Gunnar Schmi Dtgunnar@schmi-dt.de

Documentação copyright 2002, 2003 Gunnar Schmi Dt gunnar@schmi-dt.de

Tradução de Pedro Morais morais@kde.org

&underFDL; &underGPL;

## Instalação

### Como obter o &kmouth;

&install.intro.documentation;

### Requisitos

Para poder usar com sucesso o &kmouth;, você precisa de um sintetizador de voz (e, claro, o &kde; 3.x). O &kmouth; usa à volta de 15 MB de memória ao ser executado (para além da quantidade de memória necessária para o seu sintetizador de voz), mas isto poderá variar de acordo com a sua plataforma e configuração.

### Compilação e Instalação

&install.compile.documentation;