Programa TNETVOX - Manual de operao

1. Descrio geral

    O Tnetvox  um programa de comunicaes sonoro que emula terminais VT-100
atravs de comunicao em rede.  As informaes que aparecem na tela so transformadas
em fala sinttica, tornando assim possvel que um deficiente visual possa usar
micros conectados, por exemplo, a mquinas executando UNIX ou MUMPS.

O programa oferece ainda diversas opes que tornam simples o uso em diversas
situaes, como o uso de browsers alfanumricos como lynx, programas de correio
eletrnico 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 parmetros so opcionais.  A porta padro usada  a porta
telnet convencional (23).

Caso o nome do computador no seja especificado o programa o perguntar
ao usurio.

O programa perguntar "configurao padro ?".  Em geral, deve-se
responder sim (s), a menos que se deseje conexo a computadores ou servidores
no convencionais.

Nota:   comum usar o tnetvox de forma no convencional, por exemplo,
para ter acesso a outras portas tcp-ip, no caso de acesso a servidores
de tipo "no telnet", ou para emulao de telas de computadores cujo
procedimento operacional exija tratamento diferente do comum.  Porm
esse procedimento s deve ser usado por pessoas que conheam o
completamente as caractersticas tcnicas da emulao desejada.

2. Modos de sonorizao 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 verificao de onde
   o cursor est, e caso haja uma modificao na posio, um trecho escolhido
   segundo critrios "inteligentes"  lido.

b) modo verborrgico:  todas as palavras e smbolos enviadas para o terminal
   so falados.

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

d) modo calado:  neste modo a sntese de fala  inibida, porm certos indicadores,
   como fim de linha e outros, so sonorizados com pequenos cliques.  Desta forma
   um deficiente visual, com muita prtica pode usar o terminal sem som, o que
   promove um uso mais veloz, e apenas ler a tela em momentos especficos, usando
   um dos comandos especiais do programa.

e) modo mudo:  semelhante ao modo calado, apenas que nenhum rudo  emitido.

3. Principais comandos locais

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

. comandos bsicos de operao
    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 rpida 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 configurao geral
    CTL ALT F5 - configura modo de operacao

. comandos de manipulao da rea de tranferncia
    CTL INS    - copia tela para area de transferencia
    SHIFT INS  - envia para o servidor a area de transferencia

. Transmisso e recepo de arquivos

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

. Auto busca

    ALT F11      - realiza a funo 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 conexo.  Em geral,
entretanto, esta no  uma boa opo 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 conexo, o que
no Unix, normalmente  feito com o comando "exit" ou "control-d".  Outros
sistemas, como MUMPS, possuem outras formas de terminao normal.

5. Modo lynx de operao (ALT F5 ou control ALT F5)

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

Esta opo, entretanto,  medida que o programa tnetvox foi evoluindo,
perdeu um pouco de vantagem, pois o modo inteligente de leitura (modo
normal), d  operao com lynx uma dinmica muito melhor.

6. comandos de manipulao da rea de tranferncia

A rea de transferncia  uma poro da memria do computador usada para
transferir informaes entre programas.  O tnetvox permite as seguintes
operaes:

CTL INS - copia tela para area de transferncia

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 tranferncia algum conjunto
de informaes.  Ao apertar SHIFT INS, estas informaes so transferidas para
o programa que est sendo executado no servidor.

7. Leitor de telas (ALT F9)

O leitor de telas  uma funo do DOSVOX, presente em diversos utilitrios.
Ao ativar-se o leitor de telas, a linha em que est o cursor  lida.
O leitor pode ser cancelado apertando-se ESC.

So as seguintes as funes do leitor de telas:

    espao:        le a linha atual
    SETAS :        movem o cursor normalmente

    CTL L :        informa a linha e coluna atual
    ENTER :        move o cursor para o incio da prxima linha
    TAB   :        move o cursor para o prximo 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 no branca da tela
    CTL PAGEDOWN:  posiciona e l a ltima linha no branca da tela

    CTL ESQ:       posiciona cursor na palavra anterior
    CTL DIR:       posiciona cursor na prxima palavra

    HOME:          posiciona cursor no incio da linha corrente
    END:           posiciona cursor na ltima coluna escrita desta linha

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

    F1:            fala prxima palavra

    CTL F1:        fala prximo trecho da tela

8. Programao de teclas especiais (ALT F10)

Quanto o TNETVOX  usado em conjunto com sistema comerciais,  freqente
a necessidade de leitura gil de partes especficas 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 programao pode ser condicionada por alguma informao na tela.
Por exemplo, suponhamos um sistema comercial com duas telas, uma
em que o telefone do cliente esteja numa certa posio e na segunda
o telefone em outra posio.  Desejariamos que ao apertar ALT-T fosse
lido o telefone, independentemente da tela.  Ento faremos duas programaes
da letra T, condicionadas a alguma outra informao 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 diferenciao (opcional)
pergundando 'Usa algum campo para ativar esta tecla ?' (responder s ou n)
Caso se escolha "s", deve-se posicionar o cursor no incio do trecho da
tela que contm a informao usada como seletor e teclar Enter.
Depois posicionar o cursor no fim da chave e teclar enter.

Caso esta programao 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 incio da rea, teclar enter, e depois no fim
da rea e teclar enter.  A rea selecionada pode ser um retngulo,
ou seja, conter vrios 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 opo g  fixo e registrado no arquivo
geral de configurao do DOSVOX (\WINDOWS\DOSVOX.INI).  Veja o item
de configurao global do sistema.  Em geral este arquivo recebe
o nome de telas.$$$

A programao  normalmente registrada no c:\winvox\tnetvox.amb,
embora seja possvel tambm alterar este nome em \WINDOWS\DOSVOX.INI.

9. Auto-busca (ALT F11)

Essa funo pergunta um texto a buscar e realiza uma sequncia 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 funo, acionada em conjunto com a tecla
control, repete a execuo da busca com o ltimo texto procurado.

10. Configurao local do programa  (CTL ALT F5)

So as seguintes as perguntas realizadas no procedimento de configurao:

    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 so s/n ou um nmero.  Caso se aperte ENTER, o sistema
continua com a mesma opo anteriormente configurada.

A opo "letras com acentos" deve ser usada apenas quando se est
emulando operaes semi-grficas da tela, caso comum em sistemas
comerciais utilizando MUMPS.  Entretanto, neste caso,  melhor
realizar-se uma configurao global, pois desta forma, o formato
das letras semi-grficas da tela fica mais prximo, dando uma
aparncia melhor ao resultado visual (opo USAACENTOS=NAO).

11. Configurao global do programa

O arquivo \WINDOWS\DOSVOX.INI contm a configurao geral do DOSVOX, e em
particular o trecho [TNETVOX] possui diversas configuraes que so usadas
pelo programa tnetvox.   A configurao 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 diretrio de mensagens do TNETVOX
ARQALTS        Nome do arquivo que contm as programaes especiais
ARQTELAS       Nome do arquivo que conter as telas usadas com a
               programao de tipo "g" (gravar trecho de tela)
ARQLYNX        Nome padro do arquivo usado para receber a cpia 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 emulao ANSI.
               Quando se trabalha com MUMPS, opcionalmente pode-se usar
               NO, caso em que ser utilizado na emulao o gerador de
               caracteres semigrfico (OEM font), sem acentos.
TERMINAL       Tipo de terminal emulado.  Atualmente s pode receber
               os valores vt100 ou TI200 (embora a emulao deste segundo
               tipo seja muito precria).
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 funo auto-busca
               (ALT F11).
NOMECOMPUT      o nome do computador a conectar.  Normalmente deixa-se
               este campo em branco, a menos em situaes em que sempre
               se conecte o mesmo computador.
PADRAO         Normalmente aps pedir o nome do computador o programa
               pergunta "configurao padro ?".  Ao informar PADRAO=SIM
               O programa no far esta pergunta.
TXT1           O programa pode enviar automaticamente apos a conexo,
               uma srie de linhas (terminadas por ENTER).  Estas linhas
               so informadas em TXT1, TXT2, TXT3, etc.

Apndice:  Caracteres enviados pelo teclado

So 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 representao hexadecimal de xx
      ESC corresponde a hex(1b)
