Programa TNETVOX - Manual de operação

1. Descrição geral

    O Tnetvox é um programa de comunicações sonoro que emula terminais VT-100
através de comunicação em rede.  As informações que aparecem na tela são transformadas
em fala sintética, tornando assim possível que um deficiente visual possa usar
micros conectados, por exemplo, a máquinas executando UNIX ou MUMPS.

O programa oferece ainda diversas opções que tornam simples o uso em diversas
situações, como o uso de browsers alfanuméricos como lynx, programas de correio
eletrônico como pine ou elm, e sistemas de entrada de dados criados em MUMPS.

O programa pode ser ativado com o comando

           tnetvox [nome do computador] [porta tcp-ip]

Os dois últimos parâmetros são opcionais.  A porta padrão usada é a porta
telnet convencional (23).

Caso o nome do computador não seja especificado o programa o perguntará
ao usuário.

O programa perguntará "configuração padrão ?".  Em geral, deve-se
responder sim (s), a menos que se deseje conexão a computadores ou servidores
não convencionais.

Nota:  É comum usar o tnetvox de forma não convencional, por exemplo,
para ter acesso a outras portas tcp-ip, no caso de acesso a servidores
de tipo "não telnet", ou para emulação de telas de computadores cujo
procedimento operacional exija tratamento diferente do comum.  Porém
esse procedimento só deve ser usado por pessoas que conheçam o
completamente as características técnicas da emulação desejada.

2. Modos de sonorização da leitura de tela

O programa executa a leitura da tela segundo os seguintes modos:

a) modo normal:  o sistema a cada 0.5 segundos realiza uma verificação de onde
   o cursor está, e caso haja uma modificação na posição, um trecho escolhido
   segundo critérios "inteligentes" é lido.

b) modo verborrágico:  todas as palavras e símbolos enviadas para o terminal
   são falados.

c) modo lynx:  neste modo são falados apenas os caracteres em "highlight" enviados
   para o terminal.

d) modo calado:  neste modo a síntese de fala é inibida, porém certos indicadores,
   como fim de linha e outros, são sonorizados com pequenos cliques.  Desta forma
   um deficiente visual, com muita prática pode usar o terminal sem som, o que
   promove um uso mais veloz, e apenas ler a tela em momentos específicos, usando
   um dos comandos especiais do programa.

e) modo mudo:  semelhante ao modo calado, apenas que nenhum ruído é emitido.

3. Principais comandos locais

A maior parte dos comandos locais é acionada através do uso da tecla ALT.
Pressionando-se as teclas ALT F1 aparece na tela a seguinte lista de
comandos:

. comandos básicos de operação
    ALT F1 - ajuda
    ALT F2 - transmite um arquivo
    ALT F3 - ativa auto-arquivamento
    ALT F4 - desligamento
    ALT F5 - modo lynx
    ALT F6 - nada
    ALT F7 - limpa tela
    ALT F8 - fala hora
    ALT F9 - ativa leitor de tela
    ALT F10 - programa teclas

. comandos de leitura rápida de tela
    ALT CIMA   - le linha superior ao cursor
    ALT BAIXO  - le toda tela
    ALT ESQ    - le trecho a esquerda do cursor
    ALT DIR    - le trecho a direita do cursor
    ALT HOME   - le a linha invertida da tela
    ALT END    - le linha 22 (status do lynx)
    ALT PGUP   - le linha 1
    ALT PGDN   - le linha 24

. comando de configuração geral
    CTL ALT F5 - configura modo de operacao

. comandos de manipulação da área de tranferência
    CTL INS    - copia tela para area de transferencia
    SHIFT INS  - envia para o servidor a area de transferencia

. Transmissão e recepção de arquivos

    ALT F2 - transmite um arquivo
    ALT F3 - ativa auto-arquivamento

. Auto busca

    ALT F11      - realiza a função de auto-busca de texto
    CTL ALT F11  - repete a última busca, sem pedir o texto a buscar

4. Desligamento (ALT F4)

Apertando-se ALT F4 o programa permite o cancelamento da conexão.  Em geral,
entretanto, esta não é uma boa opção de desligamento, pois o computador
servidor fica com a tarefa que estava sendo executada aberta.  O mais
conveniente é pedir ao computador central que encerre a conexão, o que
no Unix, normalmente é feito com o comando "exit" ou "control-d".  Outros
sistemas, como MUMPS, possuem outras formas de terminação normal.

5. Modo lynx de operação (ALT F5 ou control ALT F5)

O modo lynx de operação foi criado originalmente para permitir usar o
programa lynx com relativo conforto. No modo lynx são faladas apenas
as mensagens em "highlight" na tela, que correspondem no lynx aos
hiperlinks da homepage.

Esta opção, entretanto, à medida que o programa tnetvox foi evoluindo,
perdeu um pouco de vantagem, pois o modo inteligente de leitura (modo
normal), dá à operação com lynx uma dinâmica muito melhor.

6. comandos de manipulação da área de tranferência

A área de transferência é uma porção da memória do computador usada para
transferir informações entre programas.  O tnetvox permite as seguintes
operações:

CTL INS - copia tela para area de transferência

Desta forma, a imagem da tela (linhas 1 a 24) pode ser usada como
entrada para um processador de textos, por exemplo.

SHIFT INS  - envia para o servidor a area de transferencia

Um programa externo pode ter colocado na área de tranferência algum conjunto
de informações.  Ao apertar SHIFT INS, estas informações são transferidas para
o programa que está sendo executado no servidor.

7. Leitor de telas (ALT F9)

O leitor de telas é uma função do DOSVOX, presente em diversos utilitários.
Ao ativar-se o leitor de telas, a linha em que está o cursor é lida.
O leitor pode ser cancelado apertando-se ESC.

São as seguintes as funções do leitor de telas:

    espaço:        le a linha atual
    SETAS :        movem o cursor normalmente

    CTL L :        informa a linha e coluna atual
    ENTER :        move o cursor para o início da próxima linha
    TAB   :        move o cursor para o próximo campo da tela
    Shift TAB :    move o cursor para o campo anterior da tela

    PAGEUP:        posiciona cursor em (1,1) e lê esta linha
    PAGEDOWNN:     posiciona cursor em (1,25) e lê esta linha

    CTL PAGEUP:    posiciona e lê a primeira linha não branca da tela
    CTL PAGEDOWN:  posiciona e lê a última linha não branca da tela

    CTL ESQ:       posiciona cursor na palavra anterior
    CTL DIR:       posiciona cursor na próxima palavra

    HOME:          posiciona cursor no início da linha corrente
    END:           posiciona cursor na última coluna escrita desta linha

    F5:            busca um texto na página
    CTL F5:        rebusca o mesmo texto pedido anteriormente
    F6:            pede linha e coluna para reposionar cursor

    F1:            fala próxima palavra

    CTL F1:        fala próximo trecho da tela

8. Programação de teclas especiais (ALT F10)

Quanto o TNETVOX é usado em conjunto com sistema comerciais, é freqüente
a necessidade de leitura ágil de partes específicas da tela.  Para isso
pode-se programar as teclas A a Z para realizar estas tarefas, quando
acionadas em conjunto com a tecla ALT.

A programação pode ser condicionada por alguma informação na tela.
Por exemplo, suponhamos um sistema comercial com duas telas, uma
em que o telefone do cliente esteja numa certa posição e na segunda
o telefone em outra posição.  Desejariamos que ao apertar ALT-T fosse
lido o telefone, independentemente da tela.  Então faremos duas programações
da letra T, condicionadas a alguma outra informação presente na tela
que permita escolher entre elas.

Apertando-se ALT F10, o programa pede: 'Pressione a letra a programar'
Deve-se apertar uma tecla de A a Z.

O programa a seguir pede para informar algum campo de diferenciação (opcional)
pergundando 'Usa algum campo para ativar esta tecla ?' (responder s ou n)
Caso se escolha "s", deve-se posicionar o cursor no início do trecho da
tela que contém a informação usada como seletor e teclar Enter.
Depois posicionar o cursor no fim da chave e teclar enter.

Caso esta programação exista anteriormente, o programa pergunta se
ela será reprogramada ou apagada.  Tecle R para reprogramar, A para
apagar ou ESC para cancelar.

Em seguida deve-se informar a área que efetivamente vai ser lida:
posicionar o cursor no início da área, teclar enter, e depois no fim
da área e teclar enter.  A área selecionada pode ser um retângulo,
ou seja, conter vários trechos de linhas.

Por último o programa pergunta se a área selecionada deve ser lida,
soletrada ou gravada em disco.  Escolhe-se l, s, ou g.

O nome do arquivo gravado na opção g é fixo e registrado no arquivo
geral de configuração do DOSVOX (\WINDOWS\DOSVOX.INI).  Veja o item
de configuração global do sistema.  Em geral este arquivo recebe
o nome de telas.$$$

A programação é normalmente registrada no c:\winvox\tnetvox.amb,
embora seja possível também alterar este nome em \WINDOWS\DOSVOX.INI.

9. Auto-busca (ALT F11)

Essa função pergunta um texto a buscar e realiza uma sequência de
envios do caractere "seta para baixo" para o servidor, lendo em
seguida o que foi escrito na linha do cursor.  O processo se repete
até que o que está escrito coincida com o texto teclado, ou que
seja teclado algo.  Essa função, acionada em conjunto com a tecla
control, repete a execução da busca com o último texto procurado.

10. Configuração local do programa  (CTL ALT F5)

São as seguintes as perguntas realizadas no procedimento de configuração:

    Modo de fala: normal, lynx, verborragico, calado ou mudo ?
    Soletra digitacao ?
    Envia apenas ao teclar enter ?
    Enter gera CRLF ?
    Usa letras com acentos ?
    Qual a velocidade de fala de 1 a 4 ?

As respostas são s/n ou um número.  Caso se aperte ENTER, o sistema
continua com a mesma opção anteriormente configurada.

A opção "letras com acentos" deve ser usada apenas quando se está
emulando operações semi-gráficas da tela, caso comum em sistemas
comerciais utilizando MUMPS.  Entretanto, neste caso, é melhor
realizar-se uma configuração global, pois desta forma, o formato
das letras semi-gráficas da tela fica mais próximo, dando uma
aparência melhor ao resultado visual (opção USAACENTOS=NAO).

11. Configuração global do programa

O arquivo \WINDOWS\DOSVOX.INI contém a configuração geral do DOSVOX, e em
particular o trecho [TNETVOX] possui diversas configurações que são usadas
pelo programa tnetvox.   A configuração deste trecho tem uma forma semelhante
ao seguinte:

[TNETVOX]
DIRTNETVOX=c:\winvox\som\tnetvox
ARQALTS=c:\winvox\tnetvox.amb
ARQTELAS=telas.$$$
ARQLYNX=lynx.$$$
NUMLINHAS=24
USAACENTOS=SIM
TERMINAL=vt100
PGUPCOMCTL=NAO
DELAYBUSCA=200
NOMECOMPUT=
PADRAO=NAO
TXT1=

Explicaremos a seguir o significado de cada um destes

DIRTNETVOX     Nome do diretório de mensagens do TNETVOX
ARQALTS        Nome do arquivo que contém as programações especiais
ARQTELAS       Nome do arquivo que conterá as telas usadas com a
               programação de tipo "g" (gravar trecho de tela)
ARQLYNX        Nome padrão do arquivo usado para receber a cópia de
               homepages em modo lynx.
NUMLINHAS      Permite configurar o programa para um valor diferente de
               24, que é o valor normal.
USAACENTOS     Normalmente deve-se usar SIM, para emulação ANSI.
               Quando se trabalha com MUMPS, opcionalmente pode-se usar
               NÃO, caso em que será utilizado na emulação o gerador de
               caracteres semigráfico (OEM font), sem acentos.
TERMINAL       Tipo de terminal emulado.  Atualmente só pode receber
               os valores vt100 ou TI200 (embora a emulação deste segundo
               tipo seja muito precária).
PGUPCOMCTL     Inverte o significado das teclas PGUP com CTL-PGUP e
               PGDN com CTL-PGDOWN
DELAYBUSCA     Especifica o intervalo em milissegundos entre o envio
               das "setas para baixo" quando se realiza a função auto-busca
               (ALT F11).
NOMECOMPUT     É o nome do computador a conectar.  Normalmente deixa-se
               este campo em branco, a menos em situações em que sempre
               se conecte o mesmo computador.
PADRAO         Normalmente após pedir o nome do computador o programa
               pergunta "configuração padrão ?".  Ao informar PADRAO=SIM
               O programa não fará esta pergunta.
TXT1           O programa pode enviar automaticamente apos a conexão,
               uma série de linhas (terminadas por ENTER).  Estas linhas
               são informadas em TXT1, TXT2, TXT3, etc.

Apêndice:  Caracteres enviados pelo teclado

São os seguintes os caracteres enviados pelas teclas especiais do teclado:

         INS:    ESC [L
         BS:     hex(08)
         ENTER:  hex(0d)
         DEL :   hex(7f)
         HOME:   ESC [H
         TEND:   ESC [K
         PGUP:   ESC [I
         PGDN:   ESC [G
         CIMA:   ESC [A
         BAIX:   ESC [B
         ESQ :   ESC [D
         DIR :   ESC [C

         F1:     ESC [M
         F2:     ESC [N
         F3:     ESC [O
         F4:     ESC [P
         F5:     ESC [Q
         F6:     ESC [R
         F7:     ESC [S
         F8:     ESC [T
         F9:     ESC [U
         F10:    ESC [V
         F11:    ESC [W
         F12:    ESC [X

         CTLF1:  ESC [j
         CTLF2:  ESC [k
         CTLF3:  ESC [l
         CTLF4:  ESC [m
         CTLF5:  ESC [n
         CTLF6:  ESC [o
         CTLF7:  ESC [p
         CTLF8:  ESC [q
         CTLF9:  ESC [r
         CTLF10: ESC [s
         CTLF11: ESC [t
         CTLF12: ESC [u

Nota: hex(xx) indica a representação hexadecimal de xx
      ESC corresponde a hex(1b)
