blob: 08722bf2dd2baf989dfcbdf621e3be2d971537d4 [file] [log] [blame]
Manual de Referência do BRLTTY
Controle de Acesso da Tela para pessoas cegas que usam Display Braille
Nikhil Nair <nn201@cus.cam.ac.uk>
Nicolas Pitre <nico@fluxnic.net>
Stéphane Doyon <s.doyon@videotron.ca>
Dave Mielke <dave@mielke.cc>
Tradução para a lingua Portuguesa
Regiane Mendonça Villela <regianevillela@gmail.com>
Filipe Oliveira Bernardes <filipeobernardes@gmail.com>
Version 4.3, oct 2011
Copyright © 1995-2011 by Desenvolvedores do BRLTTY. BRLTTY é um software
livre, e vem com ABSOLUTAMENTE SEM NENHUMA GARANTIA. Ele é postado sob os
termos da versão 2 ou posterior da GNU e publicada pela Fundação de Software
Livre.
______________________________________________________________________
Tabela de Conteúdo
1. Formalidades
1.1 Licença
1.2 Renúncia
1.3 Contato
2. Introdução
2.1 Sumário
2.2 Requisitos do Sistema
3. Processo de compilação
3.1 Instalação da herança de arquivos
3.2 Instalação a partir do Tar Ball
3.2.1 Opções de compilação
3.2.1.1 Padrões do Sistema
3.2.1.2 Especificações de Diretório
3.2.1.3 Caracteristicas de Compilação
3.2.1.4 Opções diversas
3.2.2 Atingir metas de arquivos
3.3 Testando o BRLTTY
3.4 Iniciando o BRLTTY
3.5 Considerações de Segurança
3.6 Restrições de Compilação e Tempo de Execução
3.7 Instalação a partir de um arquivo RPM
3.8 Outras Utilidades
3.8.1 brltty-config
3.8.2 brltty-install
3.8.3 brltest
3.8.4 spktest
3.8.5 scrtest
3.8.6 ttbtest
3.8.7 ctbtest
3.8.8 tunetest
4. Usando BRLTTY
4.1 Comandos
4.1.1 Deslocamento Vertical
4.1.2 Deslocamento Horizontal
4.1.3 Deslocamento Implicito
4.1.4 Caracteristica de Ativação
4.1.5 Modo de Seleção
4.1.6 Preferências de Manutenção
4.1.7 Menu de Navegação
4.1.8 Controles de Fala
4.1.9 Comutação do Terminal Virtual
4.1.10 Outros Comandos
4.1.11 Caracteres de Comandos
4.1.12 Base Commandos
4.2 Arquivos de configuração
4.3 Opções de linha de Comando
5. Descrições de caracteristicas
5.1 Roteamento de Cursor
5.2 Copiar e Colar
5.3 Suporte de Ponteiro (Mouse) via GPM
5.4 Alerta de Tunes
5.5 Configurações de Preferências
5.5.1 Menu de Preferências
5.5.1.1 Menu de Navegação
5.5.1.2 Itens de Menu
5.6 Status do Display
5.6.1 Displays com 21 Células ou Mais
5.6.2 Displays com 20 Células ou Menos
5.7 Comando de Modo de Aprendizagem
6. Tabelas
6.1 Tabelas de Texto
6.1.1 Tabela de Formato de Texto
6.1.2 Tabela de Diretivas de Texto
6.2 Tabela de Atributos
6.2.1 Tabela de Formatos dos Atributos
6.2.2 Tabela de Diretórios dos Atributos
6.3 Tabela de Contração
6.3.1 Tabela de Formato de Contração
6.3.2 Tabela de Operandos de Contração
6.3.3 Opcodes
6.3.3.1 Administração de Tabela
6.3.3.2 Definição de Símbolo Especial
6.3.3.3 Tradução de Caracter
6.3.3.4 Classes de Caracter
6.4 Tabelas de Teclas
6.4.1 Tabela de Diretivas de Teclas
6.4.1.1 Diretiva de atribuição
6.4.1.2 Diretiva de vínculo
6.4.1.3 Diretiva de contexto
6.4.1.4 Diretiva de ocultar
6.4.1.5 Diretiva de Hotkey
6.4.1.6 Diretiva de IfKey
6.4.1.7 Diretiva de inclusão
6.4.1.8 Diretiva de mapa
6.4.1.9 Diretiva de observação
6.4.1.10 Diretiva de sobreposição
6.4.1.11 Diretiva de título
6.4.2 Propriedades do Teclado
7. Tópicos Avançados
7.1 Instalação de Multiplas Versões
7.2 Instalação/Ajuda dos Discos de root para Linux
7.3 Herança Futura
7.4 Bugs Conhecidos
A. Display de Braille Suportados
B. Sintetizadores de Fala Suportados
C. Identificação dos Códigos do Driver
D. Drivers de Tela Suportados
E. Sintaxe de Operação
E.1 Especificação do Driver
E.2 Especificação do Dispositivo Braille
E.3 Especificação do Dispositivo PCM
E.4 Especificação do Dispositivo MIDI
F. Convenção do Padrão Braille para numeração
G. Código Norte-Americano do Padrão Braille
H. Tabela de Instrumento MIDI
______________________________________________________________________
1. Formalidades
1.1 Licença
Este programa é um software livre. Você poderá redistribuir e/ou modificar
sobre os termos do GNU General Public Lincense como publicado pela Fundação do
Software Livre. Versão 2 (ou outra versão posterior) da licença poderá ser
usada.
Você deverá receber uma cópia da licença junto com este programa. Deve-se ter
no arquivo de licença-GPL no diretório raiz. Se não estiver, escreva para a
Free Software Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, EUA.
1.2 Renúncia
Este programa é distribuído na esperança de ser usual, mais vem com
ABSOLUTAMENTE SEM NENHUMA GARANTIA - nem mesmo a garantia implícita de
COMERCIALIZAÇÃO ou ADEQUAÇÃO PARA UM PROPÓSITO PARTICULAR. Ver na licença GNU
para mais detalhes.
1.3 Contato
BRLTTY é representado por uma equipe de trabalho. Para atualizar a informação
dia a dia, no web site BRLTTY [http://mielke.cc/brltty]. Composto por:
· Dave Mielke (mantenedor, ativo)
Web
http://mielke.cc/
Email
<dave@mielke.cc>
· Samuel Thibault (ativo)
Web
http://dept-info.labri.fr/~thibault/
Email
<samuel.thibault@ens-lyon.org>
· Mario Lang (ativo)
Web
http://delysid.org/
Email
<mlang@delysid.org>
· Nicolas Pitre
Web
http://www.fluxnic.net/
Email
<nico@fluxnic.net>
· Stéphane Doyon
Web
http://pages.infinit.net/sdoyon/
Email
<s.doyon@videotron.ca>
· Nikhil Nair (autor)
Email
<nn201@cus.cam.ac.uk>
Perguntas, comentários, sugestões, criticas, e contribuições são todas bem-
vindas. Usando os endereços de email listados acima, e a melhor maneira de
entrar em contato com a lista do BRLTTY. Você pode postar na lista enviando um
email para brltty@mielke.cc. Se você não inscrever na lista então seus posts
serão mantidos para a aprovação do moderador. Para inscrever, remover
assinatura, configurações de mudanças, arquivos para visualização, etc, vá na
página http://mielke.cc/mailman/listinfo/brltty.
2. Introdução
BRLTTY dá ao usuário braille acesso para o terminal de texto de um sistema
Unix/Linux. Ele é executado como um processo em segundo plano (daemon) que
opera um display Braille atualizável, e pode ser iniciado antes da seqüência
do sistema de boot. Ele permite que um usuário braille trabalhe de forma
independente com a administração do sistema, tais como modo de entrada única
de usuário, recuperação do sistema de arquivos e análise de problemas de
inicialização. Ele ainda facilita muito as tarefas de rotina como ‘logging
in’.
BRLTTY reproduz uma parte retangular da tela (que se refere neste documento
como ‘a janela’) como texto braille na tela. Controles na tela pode ser usados
para mover a janela em torno da tela, para ativar e desativar várias opções de
visualização, e para realizar funções especiais.
2.1 Sumário
BRLTTY oferece os seguintes recursos:
· Completa implementacão das facilidades normais de revisão de tela.
· Escolha entre block, underline, ou no cursor.
· Sublinhado Opcional para indicar destaque de texto especial.
· Uso opcional de alerta (velocidade ajustáveis individualmente) para cursor,
destaque sublinhado especial, e/ou letras maiúsculas.
· Congelamento de tela para revisão.
· Cursor inteligente de roteamento, permitindo que seja fácil buscar do cursor
dentro de editores de texto, navegadores web, etc, sem mover as mãos da linha
Braille.
· A função de copia-e-cola que é particularmente útil para copiar nomes de
arquivos, copiar o texto entre os terminais virtuais, entrada de comandos
complicados, etc.
· Tabela de contração Braille (Inglês e Francês).
· Suporte para vários códigos em braille.
· Capacidade para identificar um caracter desconhecido.
· Capacidade para verificar um caracter sublinhado.
· Ajuda on-line para comandos da linha Braille.
· Menu de preferências.
· Suporte básico de fala.
· Projeto modular que permite a adição relativamente fácil de drivers para
outros display braille e sintetizadores de voz.
· Uma Interface de Programação de Aplicativos.
2.2 Requisitos do Sistema
Até essa data, BRLTTY roda no Linux, Solaris, OpenBSD, FreeBSD,
NetBSD, e Windows. Enquanto que outros sistemas operacionais não estão
atualmente planejados, alguma sugestão de outros projetos será bem
vinda.
Linux
Este software tem sido testado por diversos sistemas:
· Desktops, laptops, e alguns PDAs.
· Processadores de 386SX20 até Pentium.
· Diversas séries de tamanhos de mémoria.
· Diversos distribuidores incluindo Debian, Red Hat, Slackware, e SuSE.
· Vários kernels, incluindo 1.2.13, 2.0, 2.2, and 2.4.
Solaris
Este software tem sido testado nos sistemas abaixo:
· Arquitetura Sparc (versões 7, 8, e 9).
· Arquitetura Intel (versão 9).
OpenBSD
Este software tem sido testado no sistema OpenBSD abaixo:
· Arquitetura Intel (versão 3.4).
FreeBSD
Este software tem sido testado no sistema FreeBSD abaixo:
· Arquitetura Intel (versão 5.1).
NetBSD
Este software tem sido testado no sistema NetBSD abaixo:
· Arquitetura Intel (versão 1.6).
Windows
Este software tem sido testado no Windows 95, 98 e XP.
No Linux, BRLTTY pode inspecionar o conteúdo da tela de forma
completamente independente de qualquer usuário conectado. Ele faz isso
usando um dispositivo especial que fornece fácil acesso ao conteúdo do
atual console. Este dispositivo foi introduzido na versão 1.1.92 do
kernel do Linux, e é normalmente chamado também de /dev/vcsa ou
/dev/vcsa0 (em sistemas com devfs é chamado /dev/vcc/a). Por esta
razão, o kernel do Linux 1.1.92 ou superior é necessário se o BRLTTY
for utilizado desta forma. Com a capacidade de:
· Permite BRLTTY a ser iniciado muito antes da seqüência de
inicialização do sistema.
· Permite a visualização em Braille para estar totalmente operacional
durante o login do prompt.
· Faz muito mais fácil para um usuário em Braille para realizar a
inicialização de tarefas de administração do sistema.
Um patch para o programa de tela é fornecido (ver os subdiretórios dos
Patches). Ele permite que BRLTTY acesse imagem da tela da tela via
memória compartilhada, e, portanto, permite BRLTTY a ser utilizados com
bastante efetivamente em plataformas que não têm a sua própria tela de
conteúdo instalações de inspecção. A principal fraqueza da abordagem de tela é
que BRLTTY não pode ser iniciado até que o usuário esteja logado.
BRLTTY apenas trabalha com consoles e aplicações. Pode ser usados em
aplicações shell, mais não com aplicações que usam caracteristicas VGA ou que
requer console gráfico (como o sistema X Window).
Você deverá também, claro, possuir um display Braille(ver seção “Display de
Braille Suportado” para completer a lista). Nós esperamos que outros displays
sejam suportados no futuro, então, se você tem alguma informação técnica de um
dispositivo que você gostaria de ser visto com suportado, por favor entre em
contato (ver seção “Informação de contato”).
Finalmente, você precisa de ferramentas para construir o executável a
partir de sua fonte: make, compiladores C e C + +, yacc, awk, etc. As
ferramentas de desenvolvimento fornecidas com a distribuição padrão do
Unix deveria ser suficiente.
3 - Processo de compilação
BRLTTY pode ser baixado a partir do seu site (consulte a secção
Informações de contato para a sua localização). Todas as releases são
fornecidas compactadas “tar balls”. Releases mais recentes também são
fornecidas como arquivos RPM (RedHat Package Manager).
Essa informação, provavelmente atingiu a sua curiosidade, e agora você
não pode esperar para começar. É uma boa idéia, porém, que primeiro se
familiarizar com os arquivos que serão finalmente instalados.
3.1 - Instalação da herança de arquivos
Processo de compilação deve resultar na instalação dos seguintes
arquivos:
/bin/
brltty: O programa BRLTTY.
brltty-install: Um utilitário para copiar BRLTTY hierarquia de
arquivos instalado a partir de um local para outro.
brltty-config: Um utilitário que define um número de variáveis de
ambiente para valores que refletem a instalação atual do BRLTTY.
/lib/
libbrlapi.a: arquivo estático da Interface de Programação de
Aplicativos.
libbrlapi.so: objeto dinâmico carregável para o Interface de
Programação de Aplicativos.
/lib/brltty/
A instalação do BRLTTY não pode ter todos os seguintes tipos de
arquivos. Eles são criados apenas quando necessário com base nas
opções de compilação que você selecionar (ver seção Opções de
Compilação).
brltty-brl.lst: Uma lista dos drivers do display braille, que foram
construídas como objetos compartilhados dinamicamente carregáveis, e,
portanto, que pode ser selecionada em tempo de execução. Cada linha
consiste do código de duas identificações no codigo do driver, um
caracter de tabulação.
libbrlttybdriver.so.1: O driver é carregável e dinamico para uma
linha Braille, onde o driver é duas letras do código de identificação
do driver.
brltty-spk.lst: A lista de drivers de sintetizador de voz que foram
construídos como objetos compartilhados dinamicamente carregáveis, e,
portanto, que pode ser selecionada em tempo de execução. Cada linha
consiste do código de identificação de duas letras para um driver, um
caracter de tabulação, e uma descrição do sintetizador de voz que esse
driver.
libbrlttysdriver.so.1: O driver carregável dinamicamente por um
sintetizador de voz, onde o driver é o de duas letras do código de
identificação do driver.
/lib/brltty/rw/
Os arquivos criados em tempo de execução, por exemplo, é necessário,
mas falta recursos do sistema.
/etc/
brltty.conf: padrões do sistema para BRLTTY.
brlapi.key: A chave de acesso para BrlAPI.
/etc/brltty/
A instalação do BRLTTY não pode ter todos os seguintes tipos de
arquivos. Eles são criados apenas quando necessário com base nas
opções de compilação que você selecionar (ver seção “Opções de
Compilação”).
*.conf: Driver específico para configuração de dados. Seus nomes
são mais ou menos como brltty-driver.conf, onde driver é o de duas
letras do código de identificação no driver.
*.atb: tabelas de atributos.(ver seção “Tabelas de Atributos”) Seus
nomes parecem name.atb.
*.ati: Incluir arquivos de tabelas de atributos.
*.ctb: Contração tabelas. (Ver seção “Tabela de Contração”). Seus
nomes parecem idioma language-country-level.ctb.
*.cti: Incluir arquivos para tabelas contração.
*.ktb: Tabelas de Teclas.(Ver seção “Tabelas de Teclas”). Seus
nomes parecem name.ktb.
*.kti: Incluir arquivos para tabelas de teclas.
*.ttb: tabelas de texto. (Ver seção Tabelas de Texto). Seus nomes
parecem language.ttb.
*.tti: Incluir arquivos de texto para tabelas.
*.hlp: Driver específico páginas de ajuda. Seus nomes mais ou menos
como brttty-driver.hlp, onde driver é o de duas letras do código de
identificação do driver.
/var/lib/BrlAPI/
São usados soquetes locais para conexão com a Interface de Programação
de Aplicativos.
/include/
Arquivos de cabeçalho C para a Interface de Programação de
Aplicativos. Seus nomes parecem brlapi-function.h. O cabeçalho
principal é brlapi.h.
/include/brltty/
Arquivos de cabeçalho C para acessar hardware braille. Seus nomes são
brldefs-driver.h (onde driver é o de duas letras do código de
identificação do driver). O cabeçalho brldefs.h e api.h são fornecidos
para compatibilidade com versões anteriores e não deve ser usado.
/man/
Páginas man.
man1/name.1: páginas man para comandos do usuário BRLTTY-relacionados.
man3/name.3: páginas man para rotinas da biblioteca de Interface de
Programação de Aplicativos.
Alguns arquivos opcionais que você deve estar ciente de, apesar de não
serem parte da hierarquia de arquivos instalados, são:
/etc/brltty.conf
O sistema de arquivo de configuração padrão. É criado pelo
administrador do sistema. Ver seção “Arquivo de Configuração”.
/etc/brltty-driver.prefs
O arquivo de configurações foram salvos as preferências (driver é um
código de duas letras de identificação do driver). É criado pelo
comando PREFSAVE. Ver seção “Preferência de Configuração”.
3.2 - Instalação a partir do Tar Ball
Este passo é apenas quando se quer instalar apenas o BRLTTY
rapidamente, é acreditar que os padrões estejam corretos.
1. Baixe o código. Um arquivo chamado brltty-release.tar.gz, por
exemplo, brltty-3.0.tar.gz.
2. Descompacte o código fonte em sua estrutura hierárquica nativa.
Ex.: tar-zxvf brltty-release.tar.gz.
Isso deve criar o diretório brltty-release.
3. Mude para o diretório fonte, configure, compile e instale BRLTTY.
cd brltty-release
./configure
make install
Isto deve ser feito como root.
Para desinstalar BRLTTY, faça:
cd brltty-release
make uninstall
3.2.1 Opções de Compilação
O primeiro passo na construção BRLTTY é configurá-lo para o seu
sistema e/ou para suas necessidades pessoais. Isto é feito através da
execução do script no diretório BRLTTY de nível superior. Nós tentamos
fazer o ajuste padrão o caso mais comum, então, supondo que você não
está tentando fazer alguma coisa fora do comum, você pode não precisar
fazer nada mais complicado do que invocar o script sem especificar
todas opções.
./configure
Se, no entanto, você tem algumas necessidades especiais, ou mesmo se
você está apenas se aventurando, você deve descobrir quais são suas
escolhas.
./configure --help
Você também deve verificar se o arquivo README no subdiretório que
contém o driver para o seu display Braille para algumas instruções
adicionais de exibição específico.
3.2.1.1 Padrões do Sistema
--with-driver-braille = driver
Especificar os drivers do display braille, que devem estar ligados ao
binário BRLTTY. Os drivers que não estão listados por esta opção são
construídas como objetos compartilhados dinamicamente carregáveis e
ainda pode ser selecionada em tempo de execução. Cada driver deve ser
identificado pelo seu código de duas letras de identificação do driver
ou pelo seu nome próprio (completo ou abreviado). Os identificadores
do driver deve ser separada da outra por uma única vírgula. Se um
identificador do driver é precedido por um sinal de menos (-), então
esse driver é excluído da compilação. Qualquer uma das seguintes
palavras também pode ser usado como o operando esta opção:
all
Link de todos os drivers para o binário. Não construa qualquer um
deles como objetos compartilhados dinamicamente carregáveis. Esta
palavra também pode ser especificado como o último elemento de uma
lista de driver. Isto é como especificar o driver default quando todos
os drivers devem ser ligados dentro.
-all: Apenas construir os condutores que tenham sido incluídos
explicitamente através desta opção.
no: Não construa qualquer driver em tudo. Isso é equivalente a
especificar --without-braille-driver.
yes: Construir todos os drivers como objetos compartilhados
dinamicamente carregáveis. Não ligar qualquer um deles dentro do
binário. Isso é equivalente a especificar --with-braille-driver.
Ver arquivo configuração e a linha de opção de commando –b para a seleção de
tempo de execução.
--with-braille-parameters= [driver:]name = value, ...
Especifique as configurações padrão de parâmetro para os drivers do
display braille. Se o mesmo parâmetro é especificado mais de uma vez,
a sua atribuição é usada. Se um nome de parâmetro é qualificada por um
driver, (ver seção “Códigos de Identificação de Drivers”) então essa
configuração só se aplica ao driver, senão é, então, que se aplica a
todos os drivers. Para essa descrição dos parâmetros aceitos por a
especificação de driver, por favor ver na documentação do driver. Ver
configuração de arquivo “braille-parameters” ou linha de comando –b.
--with-braille-device = device, ...
Especifica o dispositivo padrão para o qual o display braille está
ligado. (Ver seção Especificação de Dispositivo Braille). Se essa
opção não for especificada, então usb: é assumido se o suporte USB
está disponível, e um sistema operacional tem um caminho apropriado
para a porta primária serial (dispositivo) é assumido se não.
--with-libbraille = directory
Especifique o local da instalação do pacote Libbraille, e compilar o
driver display braille Libbraille (Ver seção “Restrições de
Compilação”). Qualquer uma das seguintes palavras também pode ser
usado como o operado por essa opção:
no
Não compilar o driver. Isso é equivalente a especificar
--without-libbraille.
Yes
Compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/Libbraille, /usr/local/libbraille, /opt/Libbraille, ou
/opt/libbraille. Isso é equivalente a especificar --with-libbraille.
--with-text-table=file
Especifique tabela texto build-in (retorno)(Ver seção “Tabelas de
Texto”). A tabela especificada é ligada ao binário BRLTTY, e é usado
tanto em falhas de autoseleção quanto na solicitação de tabela que não
pode ser carregado. O caminho absoluto para uma tabela fora do código
fonte pode ser especificado. A extensão “.ttb” é opcional. Esta
configuração pode ser alterada com a preferência Tabela de texto. Se
esta opção não for especificada, então en-nabcc, normalmente(América
do Norte) usa 8 pontos ver “Código Braille Norte-Americano”. Ver
configuração de “Tabela de Texto” ou comando –t. Esta configuração
pode ser mudada com a preferência “Tabela de Texto”.
--with-attributes-table=file
Especifique a tabela texto de atributos built-in (retorno)(Ver seção
“Atributos de Tradução”). A tabela especificada é ligada ao binário
BRLTTY, e é usado quando a tabela solicitada não pode ser carregada.
caminho absoluto para uma tabela fora do código fonte pode ser
especificado. A extensão do “.atb” é opcional. Se essa opção não for
especificada, então os atributos são assumidos. Mude o atributo se
você gostaria que ele fosse feito à moda antiga. Veja a tabela
atributos de arquivo de configuração e uma opção de linha de comando
para seleção de tempo de execução -a. Esta configuração pode ser
alterada com a preferência atributos da tabela.
--with-speech-driver = driver
Especificar os drivers de sintetizador de voz que são ligados ao
binário BRLTTY. Esses drivers não estão listados nesta opção são
construídas como objetos compartilhados dinamicamente carregáveis e
ainda pode ser selecionado em tempo de execução. Cada driver deve ser
identificado pelo seu código de duas letras de identificação do driver
ou pelo seu nome próprio (completo ou abreviado). Os identificadores
do driver deve ser separados por uma única vírgula. Se identificador
do driver é precedido por um sinal de menos (-), então esse driver é
excluído da compilação. Qualquer uma das seguintes palavras também
pode ser usadas como operadores esta opção:
all
link de todos os drivers para o binário. Não compila qualquer um
deles como objetos compartilhados dinamicamente carregáveis. Esta
palavra também pode ser especificada como o último elemento de uma
lista de driver. Isto é como especificar o driver default quando todos
os drivers devem ser ligados.
-all
apenas construir os drivers que tenham sido incluídos explicitamente
através desta opção.
no
não construa qualquer driver. Isso é equivalente a especificar
without-speech-driver.
yes
compilar todos os drivers como objetos compartilhados dinamicamente
carregáveis. Não ligar qualquer um deles dentro do binário. Isso é
equivalente a especificar --with-speech-driver.
Veja a configuração do arquivo “speech-driver” e a opção -s de linha
de comando para seleção de tempo de execução.
--with-speech-parameters = [driver:]name = value, ...
Especifique os parâmetros das configurações padrão para os drivers de
sintetizador de voz. Se o mesmo parâmetro é especificado mais de uma
vez. Se um nome de parâmetro é qualificado por um driver (Ver Código
de Identificação de Drivers), então essa configuração só se aplica
nesse driver. Para obter uma descrição dos parâmetros aceitos por um
driver específico, consulte a documentação do driver. Ver configuração
“speech-parameters” ou comando “-s”.
--with-flite=directory
Especifique o local instalação do FestivalLite no pacote text-to
speech e compila o driver sintetizador de voz FestivalLite (Ver
“Restrições de Compilação”). Qualquer uma das seguintes palavras
também pode ser usado como o operadores esta opção:
no
não compilar o driver. Isso é equivalente a especificar –without
flite.
yes
compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/FestivalLite, /usr/local/flite, /opt/FestivalLite, ou
/opt/flite. Isso é equivalente a especificar --with-flite.
--with-flite-language=language
Especifique o idioma usado que o text-to-speech do FestivalLite. O
idioma padrão é USENGLISH.
--with-flite-lexicon=lexicon
Especifique o léxico que o text-to-speech FestivalLite usa. O léxico
padrão é cmulex.
--with-flite-voice=voice
Especifique a voz que o text-to-speech FestivalLite usa. A voz padrão
é cmu_us_kal16.
-- with-mikropuhe=directory
Especifique o local instalação do pacote text-to-speech da Mikropuhe,
e compilar o driver sintetizador de voz Mikropuhe (Ver Restrições de
Compilação). Qualquer uma das seguintes palavras também pode ser usado
como o operando esta opção:
no
não compilar o driver. Isso é equivalente a especificar –without
mikropuhe.
yes
compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/Mikropuhe, /usr/local/mikropuhe, /opt/Mikropuhe, ou
/opt/mikropuhe. Isso é equivalente a especificar --with-mikropuhe.
--with-speechd=directory
Especifique o local da instalação do pacote text-to-speech do speech
dispatcher, e compilar o driver sintetizador de voz do speech
dispatcher. Qualquer uma das seguintes palavras também pode ser usado
como o operando esta opção:
no
não compilar o driver. Isso é equivalente a especificar –without
speechd.
yes
compilar o driver se o pacote pode ser encontrado em /usr,
/usr/local, /usr/local/speech-dispatcher, /usr/local/speechd,
/opt/speech-dispatcher, ou /opt/speechd. Isso é equivalente a
especificar --with-speechd.
--with-swift = directory
Especifique o local da instalação do pacote de text-to-speech Swift, e
compilar o driver sintetizador de voz Swift. Qualquer uma das
seguintes palavras também pode ser usado como o operando esta opção:
no
não compilar o driver. Isso é equivalente a especificar -–without
swift.
yes
compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/Swift, /usr/local/swift, /opt/Swift, ou /opt/swift. Isso é
equivalente a especificar --with-swift.
--with-theta = directory
Especifique o local da instalação do pacote text-to-speech do Theta, e
compilar o driver sintetizador de voz Theta (Ver “Restrições de
Compilação”). Qualquer uma das seguintes palavras também pode ser
usado como o operando esta opção:
no
não compilar o driver. Isso é equivalente a especificar -–without
theta.
Yes
compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/Theta, /usr/theta/local, /opt/Theta, ou /opt/theta. Isso é
equivalente a especificar --with-theta.
--with-viavoice=directory:
Especifique o local da instalação do pacote text-to-speech do
ViaVoice, e compilar o driver sintetizador de voz do ViaVoice (Ver
Restrições de Compilação). Qualquer uma das seguintes palavras também
pode ser usado como o operando esta opção:
no
não compilar o driver. Isso é equivalente a especificar –-without
viavoice.
Yes
compilar o driver se o pacote pode ser encontrado em /usr, /usr/local,
/usr/local/ViaVoice, /usr/local/ViaVoice, /opt/ViaVoice, ou
/opt/ViaVoice. Isso é equivalente a especificar --with-viavoice.
--with-screen-driver=driver:
Especificar os drivers da tela que devem ser ligados ao binário
BRLTTY. Os drivers que não estão listados por esta opção são
construídas como objetos compartilhados dinamicamente carregáveis e
ainda pode ser selecionada em tempo de execução. Cada driver deve ser
identificado pelo seu código de duas letras de identificação do driver
(Ver seção Drivers de Tela Suportados) ou pelo seu nome próprio
(completo ou abreviado). Os identificadores de driver devem ser
separados da outra por uma única vírgula. Se um identificador de
driver é precedido por um sinal de menos (-), então esse driver é
excluído da compilação. Qualquer uma das seguintes palavras também
pode ser usado como o operando esta opção:
all
liga todos os drivers dentro do binário. Não construa qualquer um
deles como objetos compartilhados dinamicamente carregáveis. Esta
palavra também pode ser especificado como o último elemento de uma
lista de driver. Isto é como especificar o driver default quando todos
os drivers devem ser ligados.
-all
apenas compila os drivers que tenham sido incluídos explicitamente
através desta opção.
no
não construa qualquer driver. Isso é equivalente a especificar
without-screen-driver.
Yes
compilar todos os drivers como objetos compartilhados dinamicamente
carregáveis. Não ligar qualquer um deles dentro do binário. Isso é
equivalente a especificar --with-screen-driver.
O primeiro driver não-excluído começa sendo driver padrão. Se essa
opção não for especificada, ou se não especificado o driver, então um
padrão do sistema operacional apropriado é selecionado. Se um driver
nativo para o sistema operacional atual está disponível, então esse
driver é selecionado, senão, o sc é selecionado. Veja o arquivo
screen-driver de configuração e a opção de linha de comando para
seleção -x tempo de execução.
--with-screen-parameters=[driver:]name=value,...:
Especifique as configurações padrão de parâmetro para os screen
drivers. Se um nome de parâmetro é qualificada por um driver (consulte
a seção Supported Screen Drivers), em seguida, a configuração só
aplica ao driver, senão é, aceitável por drivers específicos. Para
obter uma descrição dos parâmetros aceitos por um driver específico,
consulte a documentação do driver. Veja no arquivo de configuração de
parâmetros e o comando –X no tempo de execução.
--with-usb-package = package, ...:
Especificar o pacote que está sendo utilizado pela I/O da USB. O nome
dos pacotes devem ser separados um do outro por uma única vírgula, e
são processados da esquerda para a direita. O primeiro, que é
instalado no sistema é selecionada. Os pacotes a seguir são
suportados:
1. libusb
2. libusb-1.0
Qualquer uma das seguintes palavras também pode ser usado como o
operadores esta opção:
no
não suporta I/O da USB. Isso é equivalente a especificar -–without
usb-package.
yes
use o suporte nativo para I/O da USB. Se o suporte nativo não está
disponível para a plataforma atual, em seguida, usar o pacote
disponível de suporte (como por ordem especificada acima). Isso é
equivalente a especificar --with-usb-package.
--with-bluetooth-package = package, ...
Especificar o pacote que está sendo utilizado para I/O de Bluetooth.
Os nomes dos pacotes devem ser separados um do outro por uma única
vírgula, e são processados da esquerda para a direita. O primeiro, que
é instalado no sistema é selecionada. Os pacotes a seguir são
suportados:
1. (Sem os pacotes são suportados).
Qualquer uma das seguintes palavras também pode ser usado como o
operador esta opção:
no
não suporte da I/O do Bluetooth. Isso é equivalente a
especificar --with-bluetooth-package.
Yes
use o suporte nativo para I/O do Bluetooth. Se o suporte nativo
não está disponível para a plataforma atual, em seguida, usar o
primeiro pacote disponível suporte (como por ordem especificada
acima). Isso é equivalente a especificar --with-bluetooth-package.
3.2.1.2 Especificações de Diretório
--with-execute-root=directory
Especifique o diretório em que a hierarquia de arquivos foram
instalados no tempo de execução. O caminho absoluto deve ser
fornecido. Se essa opção não for especificada, então diretório raiz do
sistema é assumido. Você precisa usar essa característica, por
exemplo, se você tiver mais de uma versão instalada do BRLTTY precisar
instalar arquivos BRLTTY no mesmo tempo.
--with-install-root=directory
Especifique o diretório sob o qual a hierarquia de arquivos instalados
foi instalado. O caminho absoluto deve ser fornecido. Se esta opção
não for especificada, então o pacote root no tempo de execução (veja a
opção --with-execute-root build option) é assumida. Este diretório é
apenas usado pelo make install e make uninstall. Use esta opção se
você precisa instalar BRLTTY em um local diferente daquele a partir do
qual foi finalmente foi executado. Você precisa usar este recurso, por
exemplo, se você está construindo BRLTTY em um sistema para uso em
outro.
--prefix = directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde os diretórios padrão para os arquivos independentes de
arquitetura são enraizadas. Esses diretórios são:
· Diretório de Programa
· Diretório de Biblioteca
· Diretório de API
· Diretório de Escrita
· Diretório de Dados
· Diretório de Configuração
· Diretório de Manpage
· Diretório de Inclusão
O caminho absoluto deve ser fornecido. Se essa opção não for
especificada, então diretório raiz do sistema é assumido. Este
diretório é enraizada no diretório especificado pela opção de
compilação --with-execute-root.
--exec-prefix = directory
Especifique o diretório dentro da “hierarquia de arquivos instalados”
onde os diretórios padrões para os arquivos dependentes de arquitetura
devem ser enraizados. Esses diretórios são:
· Diretório de Programa
· Diretório de Biblioteca
· Diretório de API
O caminho absoluto deve ser fornecido. Se essa opção não for
especificada, então o diretório especificado através da opção de
compilação --prefix é assumida. Este diretório é enraizado no
diretório especificado pelo --with-execute-root.
--libdir=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde o arquivo estático e o objeto carregado dinamicamente para a
API ser instalada. O caminho absoluto deve ser fornecido. Se essa
opção não for especificada, então o diretório especificado através da
opção de configuração padrão –-libdir (cujo padrão é /lib enraizado no
diretório especificado pelo –-exec-prefix) é assumida. O diretório é
criado senão existe.
--sysconfdir=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde os arquivos de configuração do sistema serão instalados. O
caminho absoluto deve ser fornecido. Se essa opção não for
especificada, então o diretório especificado através da opção de
configuração padrão --sysconfdir (cujo padrão é /etc enraizado no
diretório especificado por --prefix) é assumida. O diretório é criado
se ele não existe.
--with-program-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde os programas executáveis (binários, executáveis) são instalados.
O caminho absoluto deve ser fornecido. Se essa opção não for
especificada, então o diretório especificado através da opção de
configuração padrão --bindir (cujo padrão /bin enraizada no diretório
especificado pelo --exec-prefix) é assumida. O diretório é criado se
ele não existe.
--with-library-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde os drivers e outros arquivos dependentes de arquitetura são
instalados. O caminho absoluto deve ser fornecido. Se essa opção não
for especificada, então o brltty subdiretório do diretório
especificado através da opção de configuração padrão --libdir (cujo
padrão é /lib enraizada no diretório especificado pelo --exec-prefix)
é assumida. O diretório é criado se ele não existe.
--with-writable-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
que podem ser gravados. O caminho absoluto deve ser fornecido.
Qualquer uma das seguintes palavras também pode ser usado como o
operando esta opção:
no
não defina um diretório gravável. Isso é equivalente a especificar
without-writable-directory.
Yes
Use o local padrão. Isso é equivalente a especificar --with-writable
directory.
Se essa opção não for especificada, então o subdiretório do diretório
rw especificado com --with-library-directory é assumido. O diretório é
criado se ele não existe.
--with-data-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde as paginas das tabelas de ajuda, e outros arquivos de
arquiteturas independentes foram instaladas. O caminho absoluto deve
ser fornecido. Se essa opção não for especificada, então o
subdiretório do diretório do brltty especificado através da opção de
configuração padrão --sysconfdir (cujo padrão é /etc enraizado no
diretório especificado pela opção --prefix) é assumido. O diretório é
criado se ele não existe.
--with-manpage-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados,
onde as páginas do man serão instalados. O caminho absoluto deve ser
fornecido. Se essa opção não for especificada, então o diretório
especificado através da opção de configuração padrão --mandir (cujo
padrão é /man enraizado no diretório especificado por --prefix) é
assumida. O diretório é criado se ele não existe.
--with-include-directory=directory
Especifique o diretório dentro da hierarquia de arquivos instalados
onde os arquivos de cabeçalho C para o Application Programming
Interface serão instalados. O caminho absoluto deve ser fornecido. Se
essa opção não for especificada, então o subdiretório do diretório
brltty é especificado através da opção de configuração padrão
includedir (cujo padrão é /include enraizado no diretório especificado
por --prefix) é assumida. O diretório é criado se ele não existe.
3.2.1.3 Caracteristicas de Compilação
Estas opções são úteis principalmente quando a construção do BRLTTY
for usado em um disco de inicialização.
--enable-standalone-programs
Criar links estaticamente, em vez de links dinamicos. Esta opção
remove todas as dependências de objetos compartilhados no tempo de
execução. Apenas os drivers padrão (veja a opção --with-braille
driver, --with-speech-driver, e --with-screen-driver) são compilados.
--enable-relocatable-install
Se este recurso estiver ativado, todos os caminhos internos são
recalculados a ser relativo ao diretório do programa. Se desativado,
então todos os caminhos internos são absolutos. Este recurso permite
que toda a hierarquia de arquivos instalados ser copiados ou movidos,
de um lugar para outro, e é destinado principalmente para uso em
plataformas Windows.
--disable-strippingl
Não remova as tabelas de símbolos a partir de arquivos executáveis e
objetos compartilhados quando instalá-los.
--disable-learn-mode
Reduzir o tamanho do programa, excluindo o modo de comando (Ver seção
de Modo de Comando de Aprendizagem).
--disable-contracted-braille
Reduzir o tamanho do programa, excluindo o suporte para braille
contratados (Ver seção Tabela de Contração).
--disable-speech-support
Reduzir o tamanho do programa, excluindo o suporte dos sintetizadores
de voz.
--disable-iconv
Reduzir o tamanho do programa, com exclusão do suporte para a
conversão de conjunto de caracteres.
--disable-icu
Reduzir o tamanho do programa, excluindo o suporte de
internacionalização Unicode-based.
--disable-x
Reduzir o tamanho do programa, excluindo o suporte para X11.
--disable-beeper-support
Reduzir o tamanho do programa, com exclusão do suporte para o console
tone generator.
--disable-pcm-support
Reduzir o tamanho do programa, excluindo o suporte para a interface
digital de áudio na placa de som.
--enable-pcm-support = interface
Se a plataforma oferece mais de uma interface digital de áudio para
ser usado pode ser especificado.
--disable-midi-support
Reduzir o tamanho do programa, com exclusão do suporte para o Musical
Instrument Digital Interface da placa de som.
--enable-midi-support = interface
Se uma plataforma fornece mais de uma Interface Musical Instrument
Digital então o que está a ser utilizado pode ser especificado.
Platform Interface Description
_______________________________________________________________
Linux oss Open Sound System
alsa Advanced Linux Sound Architecture
--disable-fm-support
Reduzir o tamanho do programa, excluindo o apoio do sintetizador de FM
em um cartão de AdLib, OPL3, Sound Blaster, ou o equivalente de som.
--disable-pm-configfile
Reduzir o tamanho do programa, excluindo o suporte para o arquivo de
configuração do driver Papenmeier.
--disable-gpm
Reduzir o tamanho do programa, excluindo a interface da aplicação gpm
que permite interagir BRLTTY com o dispositivo pointer (mouse)(ver
seção Ponteiro (Mouse) Support via GPM).
--disable-api
Reduzir o tamanho do programa, excluindo a Application Programming
Interface.
--with-api-parameters=name = value, ...
Especifique as configurações padrão do parâmetro para o Application
Programming Interface. Se o mesmo parâmetro é especificado mais de uma
vez, a sua atribuição é usada. Para obter uma descrição dos parâmetros
aceitos pela interface, consulte o manual de referência BrlAPI. Veja
os arquivos de configuração api-parameters e o comando –a.
--disable-caml-bindings
Não construir bindings caml para o Application Programming Interface.
--disable-java-bindings
Não construir as bindings para a Interface Java Application
Programming.
--disable-lisp-bindings
Não construir as bindings de Lisp para o Application Programming
Interface.
--disable-python-bindings
Não construir bindings Python para o Application Programming
Interface.
--disable-tcl-bindings
Não construir bindings Tcl para a Application Programming Interface.
--with-tcl-config=path
Especifique o local do script de configuração Tcl (tclConfig.sh). Ou o
caminho para o script em si ou o diretório que contém pode ser
fornecido. Qualquer uma das seguintes palavras também pode ser usado
como o operando esta opção:
no
utilizar outros meios de adivinhar se Tcl está disponível, se sim,
onde ele foi instalado. Isso é equivalente a especificar –without
tcl-config.
yes
procure o script em alguns diretórios frequentemente utilizados. Isso
é equivalente a especificar --with-tcl-config.
3.2.1.4 Opções Diversas
--with-compiler-prefix = prefix
Especifique o prefixo (caminho e início do nome do programa) para o
conjunto de ferramentas de compilar e ligar possam ser utilizadas.
Pode ser necessário usar esta opção se, por exemplo, você está a
compilando cruzado para uma arquitetura diferente.
--with-init-path = path
Especifique o caminho para o programa real de init do sistema. O
caminho absoluto deve ser fornecido. Se esta opção for especificada,
então:
1. O programa de init deve ser movido para um novo local.
2. O brltty deve ser transferido para local original do programa de
init.
3. Quando o sistema de init é executado no inicio, brltty é
realmente executado. Ele se coloca em segundo plano, e executa a
inicialização real no primeiro plano. Este é uma maneira de ter
braille desde o início. É especialmente útil para alguns discos
de instalação/recuperação.
Se essa opção não for especificada, então este recurso não está
ativado. Esta opção é destinada principalmente para a construção de
uma imagem do instalador braillificada.
--with-stderr-path = path
Especifique o caminho para o arquivo ou dispositivo onde o padrão
error é escrito. O caminho absoluto deve ser fornecido. Se essa opção
não for especificada, então este recurso não está ativado. Esta opção
é destinada principalmente para a construção de uma imagem do
instalador braillified.
3.2.2 Atingir metas de arquivos
Depois BRLTTY ter sido configurado, o próximo passo é compilar e
instalá-lo. Isto é feito através da aplicação de comando make que o
sistema de arquivo principal BRLTTY fazer (Makefile no diretório de
nível superior). O arquivo BRLTTY é compatível com a maioria dos
objetivos comuns de manutenção da aplicação. Eles incluem:
make
um atalho para make all.
make all
compilar e vincular o executável do BRLTTY, seus drivers e suas
páginas de ajuda, seus programas de teste, e alguns outros pequenos
utilitários.
make install
complete a fase de compilação e ligação (ver “make all”), e depois
instalar os executáveis do BRLTTY, arquivos de dados, drivers e
páginas de ajuda, nos lugares corretos e com as permissões corretas.
make uninstall
remova o executável BRLTTY, seus arquivos de dados, drivers e páginas
de ajuda, a partir do sistema.
make clean
certifique-se que a próxima compilação e ligação (ver make all) será
feito a partir do zero, removendo os resultados da compilação, ligação
e testes da estrutura de diretório de origem. Isso inclui a remoção de
arquivos de objeto, executáveis, objetos compartilhados dinamicamente
carregáveis, listas de drivers, páginas de ajuda, arquivos de
cabeçalho temporária, e arquivos principais.
make distclean
além de remover os resultados da compilação e vinculação (ver make
clean):
? Remova os resultados da configuração BRLTTY (ver Build Options).
Isso inclui a remoção de config.mk, config.h, config.cache,
config.status, config.log.
? Remover os outros arquivos da estrutura de diretório de origem
que se acumulam ao longo do tempo, mas que não pertencem ali.
Isso inclui a remoção de arquivos de editor de backup, os
resultados do caso de teste, rejeitou blocos de patch, e as
cópias dos arquivos originais.
3.3 Testando o BRLTTY:
Após a compilação, ligação e instalação BRLTTY, é uma boa idéia para
fazer um teste rápido antes de ativá-lo permanentemente. Para fazer
isso, chame com o comando:
brltty -bdriver -ddevice
Para driver, especificar o código de identificação do driver de duas
letras correspondente ao seu display Braille. Para o dispositivo,
especifique o caminho completo do dispositivo que o seu display está
conectado.
Se você não quiser explicitamente identificar o driver e um
dispositivo de cada vez que você começar o BRLTTY, então você pode ter
duas abordagens. Você pode estabelecer padrões do sistema através do
braille-driver e do dispositivo braille-device do arquivo de
configuração, e/ou compilar as suas necessidades para a direita em
BRLTTY atraves --with-braille-driver e --with-braille-device.
A mensagem BRLTTY de identificação de versão deve aparecer no display
braille por alguns segundos (veja na linha de comando -m). Depois ele
vai embora (que você pode acelerar premindo qualquer tecla do
display), a área da tela onde está o cursor deve aparecer. Isso
significa que você deve esperar para ver o seu comando shell prompt.
Então, quando você entra em seu próximo comando, cada carácter deve
aparecer no visor, como é digitado no teclado.
Se sua experiência, é deixar o executar o BRLTTY então divirta-se, :). Se você
não tem experiência, precisará testar cada driver separadamente na ordem
isolada do problema. O driver de tela pode ser testado com “scrtest”, e o
driver do display braille pode ser testado com “brltest”.
Se você tiver um problema que exige uma grande quantidade de garimpo,
então você pode querer usar a seguinte linha de comando brltty:
· -ldebug para registrar muitas mensagens de diagnóstico.
· -n para manter BRLTTY em primeiro plano.
· -e para direcionar as mensagens de diagnóstico de erro padrão em vez
de log do sistema.
3.4 Iniciando o BRLTTY
BRLTTY, quando devidamente instalado, é invocada com o único comando
brltty. Um arquivo de configuração (ver Arquivos de Configuração) pode
ser criado a fim de estabelecer padrões do sistema como a localização
do arquivo de preferências, o driver display braille a ser utilizada, o
dispositivo para o qual o display braille estiver ligado, e a tabela de
texto para ser usado. Muitas opções (ver Opções de Linha de Comando)
permitem a especificação de tempo de execução explícita como a
localização do arquivo de configuração, os padrões estabelecidos no
arquivo de configuração, e algumas características que têm padrões
razoáveis. A opção –h exibe um resumo de todas as opções. A opção -v
mostra a versão atual do programa, a API, e os drivers selecionados. A
opção-v exibe os valores das opções depois de todas as fontes têm sido
considerados.
É provavelmente o melhor para que o sistema iniciar automaticamente
BRLTTY como parte da seqüência de inicialização para que o display
braille já está instalado e funcionando, quando o login do prompt
aparecer. A maioria (provavelmente todas) das distribuições fornecem um
script de aplicações onde fornecida pelo usuário pode ser seguramente
começou perto do final da seqüência de inicialização. O nome do script
a distribuição é dependente. Aqui estão os que conhecem até agora:
Red Hat
/etc/rc.d/rc.local
Começando BRLTTY desse script é uma boa aproximação (especialmente
para novos usuários). Basta adicionar um conjunto de linhas como
estas:
if [-x /bin/brltty-a-f /etc/brltty.conf]
then
/bin/brltty
fi
Isso geralmente pode ser abreviado para a forma um pouco menos legível:
[-x /bin/brltty –a -f /etc/brltty.conf] && /bin/brltty
Não adicione estas linhas antes da primeira linha (que geralmente
parece com #!/bin/sh).
Se o display Braille está sendo utilizado pelo administrador do
sistema, então provavelmente deve ser iniciado o mais cedo possível
durante a seqüência de boot (como antes os sistemas de arquivos são
verificados), de modo que o display utilizado no caso de algo der
errado durante estas verificações e o sistema cai no modo de usuário
único. Mais uma vez, exatamente onde é melhor de fazer isso é
distribuição de dependentes. Aqui estão os lugares que conhecemos até
agora:
Debian
/etc/init.d/boot (para versões mais antigas)
/etc/init.d/rcS (para versões mais recentes)
Um pacote brltty é fornecido (ver [http://packages.debian.org/brltty])
a partir de versão 3.0 (Woody). Uma vez que este pacote cuida da
partida BRLTTY, não há necessidade de código fornecido pelo usuário
estiver instalado.
RedHat
/etc/rc.d/rc.sysinit
Cuidado que versões posteriores, a fim de apoiar um processo de
inicialização mais orientada para o utilizador do sistema, tem esse
script reinvoke si só, que está sob o controle de initlog. Olha,
provavelmente, até perto do topo, para um conjunto de linhas como
estas:
# Execute novamente a nós mesmos através initlog
if [-z "$ IN_INITLOG"]; then
[-f /sbin/initlog] && exec /sbin/initlog $ INITLOG_ARGS –r
/etc/rc.sysinit
fi
Inicializando o BRLTTY partir do resultado em duas reinvocações do
BRLTTY processos em execução ao mesmo tempo. Se a sua versão do script
tem esse recurso, certifique-se de começar BRLTTY após as linhas que
implementá-lo.
Slackware
/etc/rc.d/rc.S
SuSE
/sbin/init.d/boot
Uma alternativa é começar BRLTTY a partir de /etc/inittab. Você tem
duas opções, se você escolher esta rota.
Se você quer que ela seja iniciada muito cedo, não precisa ser
reiniciado automaticamente para encerrar, em seguida, adicione uma
linha como esta antes do primeiro: sysinit: a linha que já está lá
dentro.
brl::sysinit:/bin/brltty
Se você não se importa que seja iniciado mais tarde, mas quero que ele
seja reiniciado automaticamente para encerrar, adicione uma linha como
esta em qualquer lugar dentro do arquivo.
brl:12345:respawn:/bin/brltty –n
A opção -n (--nodaemon) é muito importante quando executando BRLTTY
com facilidade init respawn. Você vai acabar com centenas de processos
BRLTTY todos rodando ao mesmo tempo, se você esquecer de especificar.
Verifique se o identificador (bt nestes exemplos) já não está sendo
usado por outra entrada, e, se for, escolher uma opção diferente.
Note-se que um comando como kill -TERM é suficiente para parar BRLTTY
em suas trilhas. Se ele morre durante a entrada em modo de usuário
único, por exemplo, pode muito bem ser devido a um problema desta
natureza.
Alguns sistemas, como parte da seqüência de boot, sonda as portas
seriais (normalmente, a fim de localizar automaticamente o mouse e
deduzir seu tipo). Se o seu display braille estiver usando uma porta
serial, este tipo de sondagem pode ser o suficiente para obtê-lo
confuso. Se isso acontecer com você, então tente reiniciar o driver
braille (veja o comando RESTARTBRL). Melhor ainda, desligar a porta
serial. sobre como fazer isso:
Red Hat
A sondagem é feita por um serviço chamado kudzu. Use o comando:
chkconfig --list kudzu,
para ver se ele foi ativado. Use o comando:
chkconfig kudzu off
Para desativá-lo. Posteriormente, os lançamentos permitem que você
execute kudzu, sem deixar de sondagem das portas seriais. Para fazer
isso, editar o arquivo /etc/sysconfig/kudzu/ e definir SAFE para yes.
Se você deseja iniciar BRLTTY antes de qualquer sistema de arquivos são
montados, em seguida, garantir que todos os seus componentes estão
instalados no sistema de arquivos raiz. Veja as opções --with-execute-
root, --bindir, --libdir, --with-writable-directory, e –with-data-
directory.
3.5 Considerações de segurança
BRLTTY precisa ser executado com privilégios de root, porque ele
precisa ler e escrever de acesso para a porta para o qual o display
braille é conectado, acesso de leitura /dev/vcsa ou equivalente (para
consultar as dimensões e posição do cursor, e rever o conteúdo da tela
em destaque), e ler e gravar o acesso ao console do sistema (para a
entrada de seta chave durante cursor encaminhamento, para a inserção de
caracteres de entrada durante a pasta, para simulação de chave
utilizando as teclas no display braille, para recuperar tradução saída
de caractere e fonte de tela tabelas de mapeamento, e para a ativação
do apito interno). O acesso aos dispositivos necessários podem,
evidentemente, ser concedido a um usuário não-root alterando as
permissões de arquivo associado com os dispositivos. Meramente ter
acesso ao console, no entanto, não é suficiente porque ativar o aviso
sonoro interno e simulando golpes de tecla ainda requerem privilégios
de root. Então, se você estiver disposto a desistir de cursor de
roteamento, cortar e colar, bips, e tudo isso, você pode executar
BRLTTY sem privilégios de root.
3.6 Restrições de Compilação e Tempo de Execução
Alert Tunes
Algumas plataformas não suportam todos os dispositivos de música. Veja
Tune Device.
Driver sintetizador de voz FestivalLite
O driver para o text-to-speech FestivalLite é construído somente se o
pacote foi instalado. Este driver e o driver para o text-to-speech do
Theta (veja --with-theta) não podem ser simultaneamente ligados ao
binário BRLTTY (veja --with-speech-driver).
Driver Libbraille Display Braille
O driver para o pacote Libbraille é construído somente se o pacote foi
instalado.
Driver sintetizador de voz Mikropuhe
O driver para o text-to-speech Mikropuhe é construído somente se o
pacote foi instalado. Este driver não pode ser incluído se o binário
BRLTTY é estaticamente ligados (ver a opção --enable-standalone-
programs), porque um arquivo estático não está incluído no pacote.
Driver do sintetizador de voz Theta
O driver para o text-to-speech Theta é construído somente se o pacote
foi instalado.
Este driver e o driver para o text-to-speech FestivalLite (veja --with-
flite) não podem ser simultaneamente ligados ao binário BRLTTY (veja --
with-speech-driver). Se esse driver é construído como um objeto
carregado dinamicamente compartilhada então $ THETA_HOME/lib deve ser
adicionado à variável de ambiente LD_LIBRARY_PATH antes BRLTTY é
invocado porque os objetos compartilhados dentro do pacote não contém
caminhos de pesquisa em tempo de execução de suas dependências.
Driver sintetizador de voz ViaVoice
O driver para o text-to-speech ViaVoice é construído somente se o
pacote foi instalado.
Este driver não pode ser incluído se o binário BRLTTY é estaticamente
ligados (ver --enable-standalone-programs), porque um arquivo estático
não está incluído no pacote.
Driver VideoBraille Display Braille
O driver para o display Braille VideoBraille é construído em todos os
sistemas, mas só funciona em Linux.
3.7 Instalação a partir de um arquivo RPM
Para instalar BRLTTY de um RPM (RedHat Package Manager) do arquivo,
faça o seguinte:
1. Baixe o pacote binário que corresponde ao seu hardware. Vai ser um
arquivo chamado brltty-release-version.architecture.rpm, por exemplo,
brltty-3.0-1.i386.rpm.
2. Instale o pacote.
rpm -Uvh brltty-release-version.architecture.rpm
Isto deve ser feito como root. Estritamente falando, a opção –u (update)
é a única que é necessário. A opção -v (verbose) exibe o nome do pacote
como ele está sendo instalado. A opção -h (hashes) exibe uma barra de
progresso (usando sinais de hash).
Para os corajosos, nós também fornecemos a fonte do arquivo RPM
(.src.rpm), mas isso está fora do escopo deste documento.
Para desinstalar BRLTTY, faça:
rpm-e brltty
3.8 Outros Utilidades
Construindo BRLTTY também resulta na construção de ajudas e pequenos
utilitários de diagnóstico.
3.8.1 brltty-config
Este utilitário cria uma série de variáveis de ambiente para valores que
refletem a instalação atual do BRLTTY (ver Build Options). Deve ser
executado dentro de um ambiente shell existente, isto é, não como um
comando em seu próprio direito, e só pode ser usado por scripts que
suportam a sintaxe Bourne Shell.
As seguintes variáveis de ambiente são definidas:
BRLTTY_VERSION
O número de versão do pacote BRLTTY.
BRLTTY_EXECUTE_ROOT
root em tempo de execução para o pacote instalado. Configurado com --
with-execute-root.
BRLTTY_PROGRAM_DIRECTORY
Diretorio de programas executáveis (binários, executáveis). Configurada
através --with-program-directory.
BRLTTY_LIBRARY_DIRECTORY
Diretório de drivers. Configurada através de --with-library-directory.
BRLTTY_WRITABLE_DIRECTORY
Diretório que pode ser gravado. Configurado através do --with-writable-
directory.
BRLTTY_DATA_DIRECTORY
Diretorio de tabelas e páginas de ajuda. Configurada via --with-data-
directory.
BRLTTY_MANPAGE_DIRECTORY: Diretorio de páginas de manual. Configurada
via --with-manpage-directory.
BRLTTY_INCLUDE_DIRECTORY: Diretório para arquivos de cabeçalho C BrlAPI.
Configurado através --with-include-directory.
BRLAPI_VERSION
O número da versão BrlAPI (Application Programming Interface do BRLTTY).
BRLAPI_RELEASE
O número da versão completa de BrlAPI.
BRLAPI_AUTH
O nome do arquivo de chave de BrlAPI.
Além disso, as seguintes variáveis de ambiente padrão autoconf também
são definidos:
prefix
Subroot para arquivos independentes de arquitetura. Configurado através
do --prefix.
exec_prefix
Subroot para arquivos dependentes de arquitetura. Configurada via --
exec-prefix.
bindir
Local padrão para o diretório do programa. Configurada via --bindir.
libdir
Diretório estático BrlAPI de arquivo e objetos carregáveis
dinamicamente. Suporte padrão o diretório da biblioteca. Configurada via
--libdir.
sysconfdir
Diretório para arquivos de configuração. Suporte padrão para o diretório
de dados. Configurada via --sysconfdir.
mandir
Localização padrão para o diretório páginas de manual. Configurada via -
-mandir.
includedir
Suporte padrão para o diretório arquivos de cabeçalho. Configurada via -
-includedir.
3.8.2 brltty-install
Este utilitário copia BRLTTY hierarquia de arquivos instalado a partir
de um local para outro.
brltty-install to [from]
to
A localização para o qual a hierarquia de arquivos instalados foi
copiada. Deve ser um diretório existente.
from
A localização do qual a hierarquia de arquivos instalados é para ser
tomado. Se for especificado, então ele deve ser um diretório existente.
Se não for especificado, então o local utilizado para a construção é
assumida.
Este utilitário pode ser usado, por exemplo, para copiar BRLTTY para um
disco de raiz. Se um disquete de root é montada como /mnt e BRLTTY está
instalado no sistema principal, em seguida, digitando
brltty-install/mnt
cria cópias do BRLTTY, juntamente com todos os seus dados e arquivos da
biblioteca, para a raiz de disquete.
Alguns problemas foram sentidos quando copia o BRLTTY entre sistemas com
diferentes versões da biblioteca C compartilhada. Este vale a pena
investigar se você tem dificuldades.
3.8.3 brltest
Este utilitário testa um driver do display braile, e também fornece uma
forma interativa de aprender quais as teclas do display braille. Ele
deve ser executado como root.
brltest -option ... [driver [name= value ...]]
_driver
O driver para o display braille. Ela deve ser uma de duas letras do
código de identificação do driver. Se não for especificado, então o
primeiro driver configurado com -- with-braille-driver é assumida.
_name = value
Definir um parâmetro de driver display Braille. Para obter uma descrição
dos parâmetros aceitos por um driver específico, consulte a documentação
do driver.
-ddevice --device = device
O caminho absoluto para o dispositivo para o qual o display braille está
ligado. Se não for especificado, o dispositivo configurado por --with-
braille-device é assumida.
-Ddirectory--data-directory = directory
O caminho absoluto para o diretório onde os drivers dos arquivos de
dados reside. Se não for especificado, então o diretório configurado
através do --with-data-directory é assumida.
-Ldirectory--library-directory = directory
O caminho absoluto para o diretório onde residem os drivers. Se não for
especificado, então o diretório configurado através do --libdir é
assumida.
-wdirectory --writable-directory=directory:
O caminho absoluto para um diretório que pode ser gravado. Se não for
especificado, então o diretório configurado com --with-writable-
directory é assumida.
-h --help
Mostra um resumo das opções de linha de comando, e depois sair.
Este utilitário usa o comando do BRLTTY Command Learn Mode. Quando
pressionar a tecla do tempo limite é de 10 segundos. O tempo de espera
de mensagens é de 4 segundos.
3.8.4 spktest
Este utilitário testa um driver sintetizador de voz. Pode precisar de
ser executado como root.
spktest -option ... [driver [name=value ...]]
_driver
O driver para sintetizador de voz. Ela deve ter uma de duas letras do
código de identificação do driver. Se não for especificado, então o
primeiro driver configurado via --with-speech-driver é assumida.
_name = value
Definir o parâmetro do driver do sintetizador de voz. Para obter uma
descrição dos parâmetros aceitos por um driver específico, consulte a
documentação do driver.
-tstring --text-string = string
O texto a ser falado. Se não for especificado, entrada padrão é a
leitura.
-Ddirectory --data-directory=directory
O caminho absoluto para o diretório onde os arquivos de dados do driver
reside. Se não for especificado, então o diretório configurado através
do --with-data-directory é assumida.
-Ldirectory --library-directory = directory
O caminho absoluto para o diretório onde residem os drivers. Se não for
especificado, então o diretório configurado através do --libdir é
assumida.
-h--help: mostrar um resumo das opções de linha de comando, e depois
sair.
3.8.5 scrtest
Este utilitário testa o driver da tela. Ele deve ser executado como
root.
scrtest -option ... [name = value ...]
_name = value
Definir um parâmetro de driver tela. Para obter uma descrição dos
parâmetros aceitos por um driver específico, consulte a documentação do
driver.
-lcolumn--lest = column
Especifique o ponto de partida da coluna (à esquerda)(origem zero) da
região. Se esse valor não for fornecido, então um valor padrão, com base
na largura especificada, é selecionado de modo que a região será
centralizada horizontalmente.
-ccount --columns = count
Especifique a largura da região (em colunas). Se esse valor não for
fornecido, então um valor padrão, com base na coluna inicial
especificado, é selecionado de modo que a região será centralizada
horizontalmente.
-trow --top = row
Especifique a linha (de cima) partida (origem zero) da região. Se esse
valor não for fornecido, então um valor padrão, com base na altura
especificada, é selecionado de modo que a região está centrada
verticalmente.
-rcount --rows = count
Especifique a altura da região (em linhas). Se esse valor não for
fornecido, então um valor padrão, com base na linha especificada de
partida, é selecionado de modo que a região está centrada verticalmente.
-h –help
mostrar um resumo das opções de linha de comando, e depois sair.
Notas:
· Se nenhuma coluna de partida, nem uma largura região é especificado,
então a região é centrada na horizontal e começa na coluna 5.
· Se nenhuma linha de partida, nem a altura da região é especificado,
então a região é verticalmente centrado e começa na linha 5.
A seguir o padrão de saída:
1. Uma linha detalhando as dimensões da tela.
Screen: widthxheight
2. Uma linha que detalha a posição (origem zero) do cursor.
Cursor: [column, row]
3. Uma linha que detalha o tamanho da região da tela selecionada, e a
posição (origem zero), do seu canto superior esquerdo.
Region: widthxheight@[column, row]
4. O conteúdo da região da tela selecionada. Não são impressos os
caracteres com espaços em branco.
3.8.6 ttbtest
Este utilitário testa uma tabela de texto (ver Tabela de Texto).
ttbtest -option ... input-table output-table
input-table
O caminho do sistema de arquivo com a tabela de entrada de texto. Se
isso é relativo, então é suportado no diretório configurado através --
with-data-directory.
output-table
O caminho do sistema de arquivos para a tabela de texto de saída. Se
isso é relativo, então ele está apoiado no diretório de trabalho atual.
Se este parâmetro não é fornecido, em seguida, tabela de saída está
escrito.
-iformat --input-format = format
Especifique o formato da tabela de entrada. Se esta opção não é
fornecida, em seguida, o formato da tabela de entrada é deduzida a
partir da extensão do nome da tabela de entrada do arquivo.
-oformat --output-format = format
Especifique o formato da tabela de saída. Se esta opção não é fornecida,
o formato da tabela de saída, que decorre da extensão do nome da tabela
de saída do arquivo.
-ccharset --charset = charset
Especifique o nome do caractere de 8 bits para usar quando interpretar
as tabelas. Se esta opção não é fornecida, definir o caractere de host
que está sendo usado.
-e --edit
Chamar o editor de tabela de texto. Se a tabela de saída for
especificado, as alterações são escritas para ele. Se não, então a
tabela de entrada é reescrita.
-h --help
Mostrar um resumo das opções de linha de comando, e depois sair.
Se nenhuma ação especial é requerida, a tabela de saída é facultativa.
Se não for especificada, a tabela de entrada está marcada. Se for
especificado, a tabela de entrada é convertido.
Os formatos de tabela a seguir são suportados:
ttb
BRLTTY
sbl
SuSE blinux
a2b
Gnopernicus
gnb
Gnome Braille
3.8.7 ctbtest
Este utilitário testa uma tabela de contração (ver Tabela de Contração).
O texto lido a partir dos arquivos de entrada (ou Standard input) é
reescrita para a saída padrão como contratada braille.
ctbtest -option ... input-file ...
input-file
A lista de arquivos a serem processados. Qualquer número de arquivos
pode ser especificado. Eles são processados da esquerda para a direita.
O nome de arquivo especial - é interpretada para significar a entrada
padrão. Se nenhum arquivo for especificado, entrada padrão é processado.
-cfile --contraction-table = file
O caminho do sistema de arquivos para o quadro de contração. Se isso é
relativo, então é suportado no diretório configurado --with-data-
directory. A extensão do .ctb é opcional. Se esta opção não é fornecida,
em seguida, en-us-g2 é assumido.
-tfile |auto –text-table = file|auto
Especificar a tabela de texto (ver Text Tables). Se um caminho relativo
for fornecido, então ele está apoiado em /etc/brltty (ver --with-data-
directory e o --with-execute-root). A extensão .ttb é opcional. Veja a
tabela de texto do arquivo de configuração para a configuração de tempo
de execução padrão. Esta configuração pode ser alterada com a
preferência Text Table.
-wcolumns --output-width =columns
O comprimento máximo de uma linha de saída. Cada linha de entrada
contratada está envolvida dentro de linhas de saida quantas forem
necessárias. Se essa opção não for especificada, não há limite, e há uma
correspondência um-para-um entre as linhas de entrada e saída.
-h -–help
Mostrar um resumo das opções de linha de comando, e depois sair.
A tabela de texto é usado:
? Para definir o caractere de saída de forma que o braille contratado
será exibida corretamente. A mesma tabela que será usada pelo
BRLTTY quando a saída é lido deve ser especificado.
? Para definir as representações braille dos caracteres definidos na
tabela de contração como = (ver secção Tradução de Caracteres).
A tabela brf.ttb texto é fornecido para uso com este utilitário. Ele
define o formato usado nos arquivos .brf. Este também é o formato
preferido usado pela maioria das impressoras em braille e dentro
distribuída eletronicamente documentos em braille. Esta tabela efetiva
permite que este utilitário para ser usado como um tradutor de texto
braille.
3.8.8 tunetest
Este utilitário testa músicas de alerta, e também fornece uma maneira
fácil de compor novas melodias. Pode precisar de ser executado como
root.
tunetest -option ... {note duration} ...
note
Um padrão MIDI de número de nota. Deve ser um número inteiro de 1 a 127,
com 60 representantes Middle C. Cada valor representa um padrão
cromático semi-tom, com os próximos valores inferiores e superiores que
representam, respectivamente, as notas imediatamente inferior e
superior.
duration
A duração da nota em milissegundos. Deve ser um número inteiro de 1 a
255.
-ddevice --device = device
O dispositivo no qual a tocar a música.
Beeper
o apito interno (console gerador de tom).
Pcm
a interface digital de áudio na placa de som.
Midi
o Musical Instrument Digital Interface na placa de som.
Fm
o sintetizador de FM em um cartão de AdLib, OPL3, Sound Blaster, ou o
equivalente de som.
O nome do dispositivo pode ser abreviada. Veja Dispositivo de Tune para
obter detalhes sobre o dispositivo padrão e as restrições da plataforma.
-vloudness --volume=loudness
Especificar o volume da produção (volume) como uma porcentagem do
máximo. O volume de saída padrão é 50.
-pdevice --pcm-device = device
Especifique o dispositivo a ser usado para o áudio digital (ver
Especificação do Dispositivo PCM). Esta opção não estará disponível se a
opção --disable-pcm-support for especificada.
-mdevice --midi-device = device
Especifique o dispositivo a ser usado para o Musical Instrument Digital
Interface (ver Especificação do Dispositivo MIDI). Esta opção não estará
disponível se a opção --disable-midi-support build option foi
especificado.
-iinstrument --instrument = instrument
O instrumento a ser usado se o dispositivo selecionado para midi. O
instrumento padrão é um acoustic grand piano. As palavras que compõem o
nome do instrumento deve ser separados um do outro por um único sinal de
menos em vez de espaços, e qualquer uma das palavras pode ser abreviada.
Um piano acústico, por exemplo, pode ser especificado como a-gra-pi.
-h –help
Mostrar um resumo das opções de linha de comando, e depois sair.
4 - Usando o BRLTTY
Antes de iniciar o BRLTTY, você precisa configurar a sua linha Braille.
Na maioria dos casos isso é feito simplesmente conectando-o a uma porta
serial disponível, e depois ligá-lo. Depois de configurado o display
execute BRLTTY simplesmente digitando o comando brltty no shell prompt
(isto deve ser feito como root). Verifique a opção -d de linha de
comando, as diretivas de arquivo de configuração do dispositivo
braille, e a opção de construção --with-braille-device para alternativas
sobre como dizer ao BRLTTY qual dispositivo que o display está
conectado. Verifique a opção -b de linha de comando, as diretivas de
arquivo de configuração do dispositivo braille, e a opção de construção
--with-braille-device para alternativas sobre como dizer ao BRLTTY que
tipo de display braille você tem. Verifique a opção -B de linha de
comando, e o braille-parameters das diretiva de arquivo de configuração
sobre como passar parâmetros para o driver do seu display braille.
Uma mensagem indicando o nome do programa (BRLTTY) e seu número de
versão aparecerá brevemente (ver a opção -M de linha de comando) no
display braille. A display mostrará então uma pequena área da tela,
incluindo o cursor. Por padrão o cursor é representado com os pontos 7 e
8 sobreposto ao caracter que ele está.
Qualquer atividade de tela será refletida na tela em Braille. O display
também irá acompanhar o andamento do cursor na tela. Esse recurso é
conhecido como o cursor tracking.
Basta digitar no teclado e ler o display, no entanto, não é suficiente.
Tente digitar um comando que causará um erro, e pressionar enter. O erro
aparece na tela, mas, a menos que tenha um display multi-linha, as
chances são de que não é visível no display braille. Tudo que você vê
nela é outra janela de comandos. O que é necessário, então, é uma
maneira de mover a janela braille em torno da tela. As teclas no display
braille em si pode ser usado para enviar comandos para BRLTTY que, além
de um monte de outras coisas, também pode fazer exatamente isso.
4.1 – Comandos
Infelizmente, os vários display braille não oferecem um conjunto de
controles. Alguns têm o padrão de seis pontos chaves, alguns têm oito, e
outros não têm nenhum. Alguns têm as teclas do polegar, mas não há um
número padrão deles. Alguns possuem um botão acima de cada célula
braille. Alguns têm interruptores liga/desliga(rocker switches). Alguns
têm uma barra fácil de alcançar, que funciona como um joystick. Alguns
têm as combinações dos anteriores. Porque a natureza e a disposição de
cada display é tão diferente, consulte o documentação para o display
específico, a fim de descobrir exatamente o que suas teclas fazem.
Comandos BRLTTY são referidos pelo nome neste manual. Se você esquecer
qual é a tecla(s) no seu display braille para usar um comando
particular, em seguida, consulte a sua página de ajuda dos driver’s. A
tecla principal você deve imediatamente guardar na memória, portanto, é
único para o comando HELP. Use as teclas de movimento regular (conforme
descrito abaixo) para navegar na página de ajuda, e pressione a help
novamente para sair.
4.1.1 Deslocamento Vertical
Veja também as PRINDENT/NXINDENT e o PRDIFCHAR/NXDIFCHAR teclas de
roteamento de comandos.
LNUP/LNDN
Ir para cima/baixo em uma linha. Se o comando pular linha idêntica foi
ativado (veja o comando SKPIDLNS), então esses comandos, ao invés de
mover exatamente uma linha, serão associados os comandos
PRDIFLN/NXDIFLN.
WINUP/WINDN
Ir para cima/baixo em uma janela. Se a janela é apenas uma linha alta
move 5 linhas.
PRDIFLN/NXDIFLN
Ir para cima/baixo para a linha mais próxima com conteúdo diferente. Se
o comando pular linha idêntica foi ativado (veja o comando SKPIDLNS),
então esses comandos, ao invés de pular linhas idênticas, serão
associados os comandos LNUP/LNDN.
ATTRUP/ATTRDN
Ir para cima/baixo para a linha mais próxima com diferentes atributos
(caracter em destaque).
TOP/BOT
Vá para a linha superior/inferior.
TOP_LEFT/BOT_LEFT
Vá para o canto top-left/bottom-left.
PRPGRPH/NXPGRPH
Ir para a próxima linha do parágrafo anterior/seguinte (a primeira linha
não-branco para além do próximo linha em branco). A linha atual é
incluída na pesquisa para o espaço inter-paragráfo.
PRPROMPT/NXPROMPT
Ir para o prompet comando anterior/seguinte.
PRSEARCH/NXSEARCH
Procura para trás/frente para a próxima ocorrência da cadeia de
caracteres no buffer de corte (ver Recortar e Colar) que não estiver
dentro da janela braille. Os recursos de pesquisa para a
esquerda/direita, começando imediatamente no caracter à direita/esquerda
da janela, e envolvendo a borda da tela. A pesquisa não diferencia
maiúsculas de minúsculas.
4.1.2 Deslocamento Horizontal
Veja também as SETLEFT teclas de encaminhamento de comando.
CHRLT/CHRRT
Vá para a esquerda/direita de um caracter.
HWINLT/HWINRT
Vá para a esquerda/direita da metade de uma janela.
FWINLT/FWINRT
Vá para a esquerda/direita de uma janela. Estes comandos são
particularmente úteis porque quebram automaticamente quando atingir a
borda da tela. Outros recursos, como a sua capacidade de pular janelas
em branco (veja o comando SKPBLNKWINS), reforçar a sua utilidade.
FWINLTSKIP/FWINRTSKIP
Vá para a esquerda/direita para a janela mais próxima não-branca.
LNBEG/LNEND
Ir para o início/fim da linha.
4.1.3 Deslocamento Implícito
Veja também GOTOMARK teclas de encaminhamento de comando.
HOME
Vai para onde está o cursor.
BACK
Volte para onde o comando de movimento mais recente colocado no display
braille. Esta é uma maneira fácil de voltar para onde você estava lendo,
após um evento inesperado (como acompanhamento do cursor) movendo a
janela braille em um momento inoportuno.
RETURN
? Se o movimento mais recente da janela do braille foi automático,
por exemplo, como resultado do monitoramento de cursor, então volta
para onde o comando de movimento mais recente colocá-lo (veja o
comando BACK).
? Se o cursor não estiver dentro da janela do braille, em seguida,
vai para onde está o cursor (veja o comando HOME).
4.1.4 Caracteristica de Ativação
Cada um desses comandos tem três formas: activate (ativar o recurso),
desactivate (desativar o recurso), e toggle (se estiver desligado então
irá ligar, e se estiver ligado irá desligar). Exceto conforme indicado,
cada um desses recursos está inicialmente off, e, quando on, afeta a
operação BRLTTY como um todo. A configuração inicial de algumas dessas
características podem ser alteradas através do menu de preferências.
FREEZE
Congela a imagem da tela. BRLTTY faz uma cópia da tela (conteúdo e
atributos) a partir do momento em que a imagem da tela é congelada e em
seguida, ignora todas as atualização da tela até que ela seja
descongelada. Esta característica torna mais fácil, por exemplo, uma
amostra da saída de uma aplicação que escreve muito, muito rapidamente.
DISPMD
Mostrar o destaque (os atributos) de cada caracter dentro da display
braille, em vez dos próprios caracteres(o conteúdo). Esse recurso é
útil, por exemplo, quando você precisa localizar um item em destaque. Ao
mostrar o conteúdo da tela, o quadro de texto é usado (veja a opção de
linha de comando -t, o quadro de texto do arquivo de diretiva de
configuração, e --with-text-table como opção de construção). Ao mostrar
os atributos da tela, a tabela de atributos é usado (veja -a, os
attributes-table diretiva de arquivo de configuração, e --with-
attributes-table opção de construção). Este recurso só afeta o terminal
virtual atual.
SIXDOTS
Mostrar caracteres usando 6 pontos, ao invés de 8 pontos, em braille. Os
pontos 7 e 8 ainda são usados por outras características como a
representação do cursor e enfatizando o carácter realçado. Se uma tabela
de contração foi selecionada (veja a opção -c e da tabela de contração
das diretivas de configuração de arquivo), então ele é usado. Esta
configuração também pode ser alterada com a preferência do estilo de
texto.
SLIDEWIN
Se o controle de cursor (veja o comando CSRTRK) está on, então, sempre
que o cursor move-se muito perto (ou mais) ou outra extremidade da
janela do braille, reposicionar horizontalmente a janela de tal forma
que o cursor, mantendo-se nesse lado, está mais próximo da centro. Se
este recurso está off a janela braille está sempre posicionado de modo
que sua extremidade esquerda é um múltiplo de sua largura da borda
esquerda da tela. Esta configuração também pode ser alterada com a
preferência Sliding Window.
SKPIDLNS
Ao invés de mover exatamente uma linha para cima ou para baixo, salta
linhas anteriores, que têm o mesmo conteúdo da linha atual. Esta
característica afeta o comandos LNUP/LNDN, bem como o recurso de linha
de embalagem de FWINRT/FWINLT e o comando FWINLTSKIP/FWINRTSKIP. Esta
configuração também pode ser alterada com a preferência Skip Identical
Lines.
SKPBLNKWINS
Pular janelas em branco durante a leitura para frente ou para trás. Este
recurso afeta os comandos FWINLT/FWINRT. Esta configuração também pode
ser alterada com a preferência Skip Blank Windows.
CSRVIS
Mostrar o cursor pela superposição de um ponto padrão (veja o comando
CSRSIZE) em cima do caracter onde ela está. Este recurso está
inicialmente on. Esta configuração também pode ser alterada com a
preferência do Mostrar Cursor.
CSRHIDE
Ocultar o cursor (veja o comando CSRVIS), a fim de ler exatamente o
caracter abaixo dela. Este recurso só afeta o terminal atual vi
CSRTRK
Vestígio(seguir) do cursor. Se o cursor se move para um local que não
seja dentro da janela do braille, então automaticamente move a janela de
braille para a nova localização do cursor. Você geralmente quer este
recurso ativado, uma vez que minimiza os efeitos de rolagem da tela, e
uma vez que, durante a entrada, a região onde você está atualmente
escrevendo sempre é visível. Se este recurso faz com que a janela de
braille salte em um momento inoportuno, use o comando BACK para voltar
para onde você estava lendo. Talvez seja necessário desativar esse
recurso ao usar um aplicativo que atualiza continuamente a tela,
mantendo um layout de dados fixo. Este recurso está inicialmente ligado.
Este recurso só afeta o terminal virtual atual.
CSRSIZE
Representa o curso com os oito ponto(um bloco sólido), e não apenas com
os pontos 7 e 8 (um sublinhado). Esta configuração também pode ser
mudada com a preferência do Curso Style.
CSRBLINK
Pisca(liga e desliga de acordo com um intervalo pré-definido) o símbolo
que representa o cursor(veja o comando CSRVIS). Esta configuração também
pode ser mudada com a preferência do Blinking Cursor.
ATTRVIS
Sublinhado(com combinações dos pontos 7 e 8) o caracter destacado.
Sem sublinhado
Branco sobre preto(normal),cinza sobre preto, branco sobre azul,
preto sobre cinza.
Pontos 7 ou 8
Preto sobre branco (vídeo reverso).
Pino 8
Todo o resto.
Esta configuração também pode ser mudada com a preferência do
Mostrar Atributos.
ATTRBLINK
Pisca(muda de ligado e desligado de acordo com o intervalo predefinido)
o atributo sublinhado(veja o comando ATTRVIS). Este recurso esta
inicialmente ligado. Esta configuração também pode ser mudada com a
preferência do Blinking Attributes.
CAPBLINK
Pisca(liga e desliga de acordo com um intervalo pré-definido) a letra
maiúscula. Esta configuração também pode ser mudada com a preferência do
Blinking Capitals.
TUNES
Tocar uma melodia curta pré-definidas (ver Alert Tunes) sempre que
ocorra um evento significativo. Este recurso esta inicialmente ligado.
Esta configuração também pode ser alterada com a preferência Alerta de
Tunes.
AutoRepeat
Automaticamente repete um comando em um intervalo regular após um atraso
inicial enquanto a sua chave (combinação) continua pressionada. Apenas
alguns drivers suportam esta funcionalidade, a principal limitação é que
muitos display braille não sinalizam teclas apertadas e teclas liberadas
como eventos separados distintamente. Este recurso esta inicialmente
ligado. Esta configuração também pode ser alterada com a preferência de
Autorepetição.
AUTOSPEAK
Automaticamente falar:
? A nova linha quando a janela braille é movida verticalmente.
? caracteres que são inseridos ou excluídos.
? O caracter ao qual o cursor é movido.
Este recurso esta inicialmente desligado. Esta configuração também pode
ser alterada com a preferência de Auto-Fala.
4.1.5 Modo de Seleção
HELP
Alterne para a página de ajuda do display braille. Isto é onde você pode
encontrar um resumo on-line das coisas que as teclas do seu display
braille fazem, e como interpretar o status das células. Use os comandos
regular de movimento vertical e horizontal para navegar pela página de
ajuda. Chame o comando de ajuda novamente para voltar para a tela.
INFO
Alterne para a exibição de status (ver seção The Status Display para
mais detalhes). Ele apresenta um resumo com a posição do cursor, a
posição da janela braille, e os estados de uma série de características
do BRLTTY. Chame este comando novamente para voltar para a tela.
LEARN
Alternar para o modo de comando aprender (ver seção Command Learn Mode
para mais detalhes). Isto é como você pode aprender de forma interativa
o que as teclas do seu display braille fazem. Chamar este comando
novamente para voltar para a tela. Este comando não estará disponível se
a opção --disable-learn-mode foi especificada na opção de construção.
4.1.6 Preferencias de Manutenção
PREFMENU
Escolha do menu de preferências (Ver Menu Preferências). Chama esse comando de
novo para retornar as operações normais.
PREFSAVE
Salva as configurações de preferências atuais (Ver Preferências).
PREFLOAD
Armazena as configurações de preferências mais recentes (Ver Preferencias).
4.1.7 Menu de Navegação
MENU_FIRST_ITEM/MENU_LAST_ITEM
Ir para o primeiro/último item no menu.
MENU_PREV_ITEM/MENU_NEXT_ITEM
Ir para o anterior/seguinte item no menu.
MENU_PREV_SETTING/MENU_NEXT_SETTING
Retroceder/Expandir o atual item do menu.
4.1.8 Controles de Fala
SAY_LINE
Fala a linha atual. A preferência do Say-Line Mode determina se fala
pendente é descartada em primeiro lugar.
SAY_ABOVE
Fale a parte superior da tela (termina com a linha atual).
SAY_BELOW
Fale a parte inferior da tela (começando com a linha atual).
MUTE
Pare de falar imediatamente.
SPKHOME
Vá para onde o cursor fala.
SAY_SLOWER/SAY_FASTER
Aumentar/diminuir a velocidade de leitura (ver também a preferência de
Speech Rate). Este comando só está disponível se um driver que suporta
ele está sendo usado.
SAY_SOFTER/SAY_LOUDER
Aumentar/diminuir o volume da voz (ver também a preferência de Speech
Volume). Este comando só está disponível se um driver que suporta ele
está sendo usado.
4.1.9 Comutação do Terminal Virtual
Veja também SWITCHVT encaminhamento de teclas de comando.
SWITCHVT_PREV/SWITCHVT_NEXT
Mude para o anterior/próximo terminal virtual.
4.1.10 Outros Comandos
CSRJMP_VERT
Encaminha (trazer) o cursor para qualquer lugar na linha de cima da
janela do braille (ver Roteamento de Cursor). O cursor é movido por uma
simulação vertical das teclas de seta pressionadas. Este comando nem
sempre funciona, porque alguns aplicativos ou move o cursor um pouco
imprevisível ou use as teclas de seta para outros fins que não o
movimento do cursor. É um pouco mais seguro do que outros comandos de
roteamento do cursor, porém, porque não faz nenhuma tentativa de simular
as setas da esquerda e direita.
PASTE
Insira os caracteres no buffer de corte na posição atual do cursor (ver
Copiar e Colar).
RESTARTBRL
Pare e reinicie o controlador de visualização em Braille.
RESTARTSPEECH
Pare e reinicie o controlador de sintetizador de voz.
4.1.11 Comandos de Carácter
ROUTE
Encaminha (trazer) o cursor para o caractere associado a tecla de
roteamento (ver Roteamento de Cursor). O cursor é movido por uma
simulação das teclas de seta pressionadas. Este comando nem sempre
funciona, porque alguns aplicativos ou move o cursor um pouco
imprevisível ou use as teclas de seta para outros fins que não o
movimento do cursor.
CUTBEGIN
Apoia-se no início do bloco de corte para o caracter associado com a
tecla de roteamento (ver Copiar e Colar). Este comando limpa o buffer de
corte.
CUTAPPEND
Apoia-se no início do bloco de corte para o caráter associado com a
tecla de roteamento (ver Copiar e Colar). Este comando não limpar o
buffer de corte.
CUTRECT
Apoia-se no fim do bloco de corte para o caráter associado com a tecla
de roteamento, e anexar a região retangular para o buffer de corte (ver
Copiar e Colar).
CUTLINE
Apoia-se no fim do bloco de corte para o caráter associado com a tecla
de roteamento, e anexar a região linear para o buffer de corte (ver
Copiar e Colar).
COPYCHARS
Copie o bloco de caráter apoiado-se por duas tecla de roteamento para o
buffer de corte (ver Copiar e Colar).
APNDCHARS
Acrescente o bloco de caráter apoiand-se por duas teclas de roteamento
para o buffer de corte (ver Copiar e Colar).
PRINDENT/NXINDENT
Ir para cima/baixo para a próxima linha que não está mais avançado do
que a coluna associada à tecla de roteamento.
DESCCHAR
Momentaneamente (veja a opção -M de linha de comando) exibi uma mensagem
descrevendo o caráter associado com a tecla de roteamento. Ela revela os
valores decimais e hexadecimais do caracter, as cores de primeiro plano
e fundo, e, quando presentes, atributos especiais (bright e brink). A
mensagem é assim:
char 65 (0x41): white on black bright blink
SETLEFT
Reposiciona horizontalmente a janela braille de modo que sua borda
esquerda é a coluna associada à tecla de roteamento. Esta característica
torna muito fácil colocar a janela exatamente onde ela é necessária, e,
por conseguinte, para mostra o que tem as teclas de roteamento, quase
elimina a necessidade de muito movimento fundamenta dajanela (como os
comandos CHRLT/CHRRT e HWINLT/HWINRT).
PRDIFCHAR/NXDIFCHAR
Ir para cima/baixo para a próxima da linha que tem um caráter diferente
na coluna associada à tecla de roteamento.
4.1.12 Comandos de Suporte
SWITCHVT
Muda para o terminal virtual cujo número (contagem a partir de 1)
corresponde ao da tecla de roteamento. Veja também os comandos de troca
de terminal virtual SWITCHVT_PREV/SWITCHVT_NEXT.
SETMARK
Marcar (lembre-se), a posição atual da janela braille num registo
associado com a telca de roteamento. Veja o comando GOTOMARK. Este
recurso só afeta o terminal virtual atual.
GOTOMARK
Move a janela braille para a posição anteriormente marcada (veja o
comando SETMARK) com a mesma tecla de roteamento. Este recurso só afeta
o terminal virtual atual.
4.2 - Arquivos de configuração
Padrões do sistema para diversas configurações podem ser estabelecidas
dentro de um arquivo de configuração. O nome padrão para este arquivo é
/brltty.conf /etc, embora possa ser substituído com a opção de linha de
comando -f. Ele não precisa existir. Um modelo para ele pode ser
encontrado dentro do subdiretório DOCS.
As linhas em branco são ignoradas. Um comentário começa com um sinal
numérico (#), e continua até o fim da linha. As seguintes diretivas são
reconhecidas:
api-parameters name=value,...
Especifica os parâmetros para a Application Programming Interrface. Se o
mesmo parâmetro for especificado mais de uma vez, a sua atribuição mais
a direita é usada. Para obter uma descrição dos parâmetros aceitos pela
interface, consulte o manual de referência BrlAPI. Veja as opções de
construção --with-api-parameters para os padrões estabelecidos durante o
processo de construção. Esta diretiva pode ser substituído com a opção
de linha de comando -A.
attributes-table file
Especifica a tabela de atributos (ver Attributes Tables para obter
detalhes). Se um caminho relativo for fornecido, então ele está ancorado
em /etc /brltty (ver as opções de compilação --with-data-directory e --
with-execute-root para mais detalhes). A extensão .atb é opcional. O
padrão é usar a tabela built-in (veja a opção de construção --with-
attributes-table). Esta diretiva pode ser substituída com a opção de
linha de comando -a.
braille-device device,...
Especifica o dispositivo para o qual o display braille está ligado
(consulte a seção Braille Device Specification). Veja a opção construção
--with-braille-device para o padrão estabelecido durante o processo de
construção. Esta diretiva pode ser substituída com a opção de linha de
comando-d.
braille-driver driver,...|auto
Especifica o driver do display braille (ver seção Driver Specification).
O padrão é a realização de auto-detecção. Esta diretiva pode ser
substituída com a opção de linha de comando -b.
braille-parameters [driver:]name=value,...
Especifica os parâmetros para os drivers do display braille. Se o mesmo
parâmetro for especificado mais de uma vez, a sua atribuição mais a
direita é usada. Se um nome de parâmetro é qualificado por um driver
(consulte a seção Driver Identification Codes), então essa configuração
só se aplica ao driver, se não é, então se aplica a todos os drivers.
Para obter uma descrição dos parâmetros aceitos por um driver
específico, consulte a documentação desse drive. Veja a de opção
construção --with-braille-parameters para os padrões estabelecidos
durante o processo de construção. Esta diretiva pode ser substituída com
a opção de linha de comando -B.
contraction-table file
Especifica a tabela de contração (ver seção Contraction Tables para mais
detalhes). Se um caminho relativo for fornecido, então ele está ancorado
em /etc/brltty (ver as opções de construção --with-data-directory e --
with-execute-root para mais detalhes). A extensão .ctb. é opcional. A
tabela de contração é usado quando o recurso de 6-pontos braille é
ativado (veja o comando SIXDOTS e a preferência Text Style). O padrão é
mostrar descontracionada 6-pontos braille. Esta diretiva pode ser
substituída com a opção de linha de comando -c. Não está disponível se a
opção de construção --disable-contracted-braille foi especificada.
key-table file|auto
Especifica a tabela de tecla (ver Key Tables para detalhes). Se um
caminho relativo for fornecido, então ele está ancorado em /etc/brltty
(ver as opções de compilação --with-data-directory e --with-execute-root
para mais detalhes). A extensão .ktb é opcional. O padrão é não usar uma
tabela de teclas. Esta diretiva pode ser substituída com a opção de
linha de comando -k.
keyboard-properties name=value,...
Especifica as propriedades dos teclado(s) a serem monitorados. Se a
mesma propriedade for especificada mais de uma vez, a sua atribuição
mais a direita é usada. Consulte a seção Keyboard Properties para obter
uma lista das propriedades que podem ser especificadas. O padrão é
monitorar todos os teclados. Esta diretiva pode ser substituída com a
opção de linha de comando -K.
midi-device device
Especifica o dispositivo a ser usado para o Musical Instrument Digital
Interface (ver seção MIDI Device Specification). Esta diretiva pode ser
substituída com a opção de linha de comando -m. Não está disponível se a
opção de construção --disable-midi-support foi especificada.
pcm-device device
Especifica o dispositivo a ser usado para o áudio digital (ver seção PCM
Device Specification). Esta diretiva pode ser substituída com a opção
linha de comando -p. Não está disponível se a opção de construção --
disable-pcm-support foi especificada.
preferences-file file
Especifica a localização do arquivo que sera usada para salvar e carregar as
preferencias de usuario. Se um caminho relativo é fornecido, será anexado em
/var/lib/brltty. O padrão é usado em brltty.prefs. O diretório pode ser reescrit
com o comando -F.
release-device boolean
Querendo ou não, para liberar o dispositivo ao qual o display braille
está ligado quando a tela ou janela atual não pode ser lido.
On(on)
Libera o dispositivo.
Off(off)
Não liberar o dispositivo.
A configuração padrão é ligado em plataformas Windows e desligado em
todas as outras plataformas. Esta diretiva pode ser substituída com a
opção de linha de comando -r.
screen-driver driver
Especifica o driver da tela (ver seção Drivers de Tela Suportados). Veja
a opção de construção --with-screen-driver para o padrão estabelecido
durante o processo de compilação. Esta diretiva pode ser substituída com
a opção de linha de comando -x.
screen-parameters [driver:]name=value,...
Especifica os parâmetros para os drivers de tela. Se o mesmo parâmetro
for especificado mais de uma vez, a sua atribuição mais a direita é
usada. Se um nome de parâmetro é qualificado por um driver (consulte a
seção Drivers de Tela Suportados), em seguida, a definição só se aplica
ao drive, se não é, então, se aplica a todos os drivers. Para obter uma
descrição dos parâmetros aceitos por um driver específico, consulte a
documentação do drive. Veja a opção de construção --with-screen-
parameters para os padrões estabelecidos durante o processo de
construção. Esta diretiva pode ser substituída com a opção de linha de
comando -X.
speech-driver driver,...|auto
Especifica o driver do sintetizador de voz (ver seção Especificação de
Driver). O padrão é a realização de auto-detecção. Esta diretiva pode
ser substituída com a opção de linha de comando -s. Não está disponível
se a opção de construção --disable-speech-support foi especificada.
speech-fifo file
Especifica a FIFO (um arquivo especial que funciona como um tubo) que é
usado por outras aplicações que desejam ter acesso ao driver de fala
BRLTTY. Esta diretiva pode ser substituída com a opção de linha de
comando -F. Não está disponível se a opção de construção --disable-
speech-support foi especificada.
speech-parameters [driver:]name=value,...
Especifica os parâmetros para os drives de sintetizador de voz. Se o
mesmo parâmetro é especificado mais de uma vez, a sua atribuição mais a
direita é usada. Se um nome de parâmetro é qualificado por um driver
(consulte a seção Código de Identificação de Driver), então essa
configuração só se aplica ao drive, senão se aplica a todos os drivers.
Para obter uma descrição dos parâmetros aceitos por um driver
específico, consulte a documentação do drive. Veja a opção de construção
--with-speech-parameters para os padrões estabelecidos durante o
processo de construção. Esta diretiva pode ser substituída com o opção
de linha de comando -S.
text-table file|auto
Especifica a tabela de texto(veja a seção Tabelas de Texto para
detalhes). Se um caminho relativo for fornecido, então ele está ancorado
em /etc/brltty (veja as opções de compilação –with-data-directory e –
with-execute-root para mais detalhes). A extensão .ttb é opcional. O
padrão é executar auto-seleção do locale-based, com alternativa para a
tabela build-in (veja a opção compilação --with-text-table). Esta
diretiva pode ser subtituída com a opção de linha de comando –t.
speech-input name
Especifica o nome do arquivo do objeto do sistema (FIFO, pipe name, socket name,
etc) que pode ser usado com outras aplicações para conversão text-to-speech via
driver de fala BRLTTY. Este diretório pode ser reescrito com o comando -i.
Não está disponivel se a opção na compilação não for especificada --disable-
speech-support.
4.3 - Opções de Linha de Comando
Muitas configurações podem ser explicitamente especificadas ao chamar
BRLTTY. Os comandos brltty aceitam as seguintes opções:
-afile --attributes-table=file
Especifica a tabela de atributos (veja seção Tabelas de Atributos). Se
um caminho relativo for fornecido, então ele está ancorado em
/etc/brltty (veja as opções de compilação –with-data-directory e –with-
execute-root para mais detalhes). A extensão .atb não é necessária.Veja
as configurações do arquivo attributes-table para a configuração padrão
de run-time. Esta configuração pode ser alterada com a preferência
Tabela de Atributos.
-bdriver,...|auto --braille-driver=driver,...|auto
Especifica o drive do display braille (veja seção Especificação de
Driver). Veja as configurações do arquivo braille-drive para a
configuração padrão de run-time.
-cfile --contraction-table=file
Especifica a tabela de contração (veja seção Tabela de Contração). Se um
caminho relativo for fornecido, então ele está ancorado em /etc/brltty
(veja as opções de compilação --with-data-directory e --with-execute-
root para mais detalhes). A extensão .ctb é opcional. A tabela de
contração é usado quando o recurso de 6-pontos braille é ativado (veja o
comando SIXDOTS e a preferência Estilo de Texto). Veja as configurações
do arquivo tabela de contração para a configuração padrão de run-time.
Esta configuração pode ser alterada com a preferência Tabela de
Contração. Esta opção não está disponível se a opção de construção --
disable-contracted-braille foi especificada.
-ddevice,... --braille-device=device,...
Especifica o dispositivo para o qual o display braille está ligado (ver
seção Especificação Dispositivo Braille). Veja as configurações do
arquivo braille-device para a configuração padrão de run-time.
-e --standard-error
Escreve mensagens de disgnóstico de erro padrão. O padrão é gravá-los
via syslog
-ffile --configuration-file=file
Especifica o local do arquivo de configuração que será utilizado para a
criação das configurações padrões de run-time.
-h -–help
Mostra um resumo das opções de linha de comando aceitas pelo BRLTTY, e
depois sai.
-kfile --key-table=file
Especifica a tabela de teclas (veja seção Key Tables pra detalhes). Se
um caminho relativo for fornecido, então ele está ancorado em
/etc/brltty (veja as opções de compilação --with-data-directory e --
with-execute-root para mais detalhes). A extensão .ktb é opcional. Esta
configuração pode ser alterada com a preferência Tabela de Telas.
-llevel --log-level=level
Especifique o limite de gravidade para geração de mensagens de
diagnóstico. Os seguintes níveis são reconhecidos.
0
emergência
1
alerta
2
crítico
3
erro
4
aviso
5
advertência
6
informações
7
debug
Ou o número ou o nome pode ser fornecido, bem como o nome pode ser
abreviado. Se não for especificado, então o nível informação é assumido
(veja a opção -q para mais detalhes).
-mdevice --midi-device=device
Especifica o dispositivo a ser usado para o Music Instrument Digital
Interface (ver seção Especificação de Dispositivos MIDI). Veja as
configurações do arquivo midi-device para a configuração padrão de run-
time. Esta opção não está disponível se a opção de construção --disable-
midi-support foi especificada.
-n --no-daemon
Especifica que BRLTTY irá ficar em primeiro plano. Se não for
especificado, então BRLTTY torna-se um processo em background (daemon)
após se inicialização, mas antes de iniciar qualquer um dos drivers
selecionados.
-pdevice --pcm-device=device
Especifica o dispositivo a ser usado para o áudio digital (ver seção
Especificação do Dispositivo PCM). Veja as configurações do arquivo pcm-
device para a configuração padrão de run-time. Esta opção não estará
disponível se a opção a opção de compilação --disable-pcm-support foi
especificado.
-q –quiet
Log menos informação. Esta opção altera o nível de log (veja a opção -l)
para notice se qualquer das opção -v ou -V seja especificado, e para
warnig caso contrário.
-r --release-device
Libera o dispositivo para o qual o display braille está ligado quando a
tela ou janela atual não pode ser lido. Veja as configurações do arquivo
release-device para a configuração padrão de run-time.
-sdriver,...|auto --speech-driver=driver,...|auto
Especifica o driver do sintetizador de voz (ver seção Especificação de
Driver). Veja as configurações do arquivo speech-driver para a
configuração padrão de run-time. Esta opção não estará disponível se a
opção de construção --disable-speech-support foi especificado.
-tfile --text-table=file
Especifica a tabela de texto (ver seção Tabela de Texto). Se um caminho
relativo for fornecido, então ele está ancorado em /etc/brltty (ver as
opções de construção --with-data-directory e --with-execute-root para
mais detalhes). A extensão .ttb é opcional. Veja as configurações do
arquivo text-table para a configuração padrão de run-time. Esta
configuração pode ser alterada com a preferência Tabela Texto.
-v –verify
Mostrar a versão atual do BRLTTY, do lado do servidor de sua interface
de programação de aplicativo, do braille selecionado e drivers de fala,
e depois sai. Se a opção-q não for especificado, então também exibir os
valores das opções depois de todas as fontes serem consideradas. Se mais
de um driver braille (veja a opção de linha de comando -b) e/ou mais de
um dispositivo braile (veja a opção linha de comando -d) tenha sido
especificado, então a autodetecção do display Braille é realizado. Se
mais de um driver de fala(veja a opção de linha de comando -s) tenha
sido especificado, então a autodetecção do sintetizador de voz é
realizada.
-xdriver --screen-driver=driver
Especifica o driver da tela (ver seção Drivers Suportados de Tela). Veja
as configurações do arquivo screen-driver para a configuração padrão de
run-time.
-Aname=value,... --api-parameters=name=value,...
Especifica os parâmetros para a Application Programming Interface. Se o
mesmo parâmetro é especificado mais de uma vez, a sua atribuição mais a
direita é usada. Para obter uma descrição dos parâmetros aceitos pela
interface, consulte o manual de referência BrlAPI. Veja as configurações
do arquivo api-parameters para a configuração padrão de run-time.
-B[driver:]name=value,... --braille-parameters=[driver:]name=value,...
Especifica os parâmetros para os drivers do display braille. Se o mesmo
parâmetro é especificado mais de uma vez, a sua atribuição mais a
direita é usada. Se um nome de parâmetro é qualificado por um driver
(consulte a seção Códigos de Identificação de Drivers), então essa
configuração só se aplica ao drive, se não é, então se aplica a todos os
drivers. Para obter uma descrição dos parâmetros aceitos por um driver
específico, consulte a documentação do driver. Veja as configurações do
arquivo braille-parameters para a configuração padrão de run-time.
-E --environment-variables
Reconhece as variáveis de ambiente para determinar as configurações
padrão para as opções de linha de comando não especificada (ver seção
Opções de Linha de Comando). Se esta opção for especificada, e se a
variável de ambiente associados a uma opção não especificada é definida,
então o valor da variável de ambiente é utilizado. Os nomes dessas
variáveis de ambiente são baseados em nomes grandes das opções que
correspondem a:
? Todas as letras são em maiúsculas.
? Os underscores (_) são utilizados em vez de sinais de menos (-).
? O prefixo BRLTTY_ é adicionado.
Esta opção é particularmente útil no sistema operacional Linux, pois
permite configuração padrão a ser passado para BRLTTY através de
parâmetros de inicialização. As seguintes variáveis de ambiente são
suportadas:
BRLTTY_API_PARAMETERS
Parâmetros para a Application Programming Interface (veja a opção de
linha de comando -A).
BRLTTY_ATTRIBUTES_TABLE
A tabela de atributos (veja a opção de linha de comando -a).
BRLTTY_BRAILLE_DEVICE
O dispositivo do display braille (veja a opção de linha de comando -d).
BRLTTY_BRAILLE_DRIVER
O driver do display braille (veja a opção de linha de comando -b).
BRLTTY_BRAILLE_PARAMETERS
Parâmetros para o driver do display braille (veja a opção de linha de
comando -B).
BRLTTY_CONFIGURATION_FILE
O arquivo de configuração (veja a opção de linha de comando -f).
BRLTTY_CONTRACTION_TABLE
A tabela de contração (veja a opção de linha de comando -c).
BRLTTY_KEY_TABLE
A tabela de teclas (veja a opção de linha de comando -k).
BRLTTY_KEYBOARD_PROPERTIES
As propriedades do teclado (veja a opção de linha de comando -K).
BRLTTY_MIDI_DEVICE
O dispositivo Musical Instrument Digital Interface (veja a opção de
linha de comando -m).
BRLTTY_PCM_DEVICE
O dispositivo de audio digital (veja a opção de linha de comando -p).
BRLTTY_RELEASE_DEVICE
Querendo ou não libera o dispositivo para o qual o display braille está
ligado quando a tela ou janela atual não pode ser lido (veja a opção de
linha de comando -r).
BRLTTY_SCREEN_PARAMETERS
Parâmentros para o driver da tela (veja a opção de linha de comando -X).
BRLTTY_SPEECH_DRIVER
O driver do sintetizador de voz (veja a opção de linha de comando -s).
BRLTTY_SPEECH_FIFO
A passagem FIFO da voz ( veja a opção de linha de comando -F).
BRLTTY_SPEECH_PARAMETERS
Parâmetros para o driver do sintetizado de voz ( veja a opção de linha
de comando -S).
BRLTTY_TEXT_TABLE
A tabela de texto ( veja a opção de linha de comando -t).
-Ffile --speech-fifo=file
Especifica a FIFO (um arquivo especial que funciona como um tubo) que é
usado por outras aplicações que desejam ter acesso ao driver BRLTTY da
fala. Se não é especificado, FIFO não é criado. Veja as configurações do
arquivo speech-fifo para a configuração padrão de run-time. Esta opção
não estará disponível se a opção de construção --disable-speech-support
foi especificada.
-i --install-service
Instala o BRLTTY como o serviço BrlAPI. Isso significa que:
· BRLTTY será iniciado automaticamente quando o sistema é
inicializado.
· Aplicações podem saber que um servidor BrlAPI está sendo
executado.
Esta opção só é suportado na plataforma Windows.
-Kname=value,... --keyboard-properties=name=value,...
Especifica as propriedades do teclado(s) a ser monitorado. Se a mesma
propriedade for especificada mais de uma vez, a sua atribuição mais a
direita é usada. Consulte a seção Keyboard Prperties para obter uma
lista das propriedades que podem ser especificadas. Veja as
configurações do arquivo keyboard-properties para a configuração padrão
de run-time.
-Mcsecs --message-delay=csecs
Especifica a quantidade de tempo (em centésimos de segundo) que o BRLTTY
mantém seu próprio gerador de mensagens internamente no display braille.
Se não for especificado, então 400 (4 segundos) é assumida.
-N --no-api
Desativa a interface de programação de aplicativo.
-Pfile --pid-file=file
Especifica o arquivo onde o BRLTTY escreve o seu identificador de
processo (PID). Se não especificado, BRLTTY não escreve o seu processo
de identificação em qualquer lugar.
-R --remove-service
Remove o serviço BrlAPI. Isso significa que:
· BRLTTY não será iniciado automaticamente quando o sistema é
inicializado.
· Aplicações podem saber que nenhum servidor BrlAPI está sendo
executado.
Esta opção só é suportado na plataforma Windows.
-S[driver:]name=value,... --speech-parameters=[driver:]name=value,...
Especifica os parâmetros para os drivers do sintetizador de voz. Se o
mesmo parâmetro é especificado mais de uma vez, a sua atribuição mais a
direita é usada. Se um nome de parâmetro é qualificado por um driver
(consulte a seção Código de Identificação de Drivers), então essa
configuração só se aplica ao driver, se não se aplica a todos os
drivers. Para obter uma descrição dos parâmetros aceitos por um driver
específico, consulte a documentação do driver. Veja as configurações do
arquivo speech-parameters para a configuração padrão de run-time.
-Ucsecs --update-interval=csecs
Especifica o intervalo (em centésimos de segundo) em que a janela do
braille é atualizada com o novo conteúdo da tela. Se não for
especificado, então, 4 (40 milisegundos) é assumido.
-V --version
Mostra a versão atual do BRLTTY, do lado do servidor de sua interface de
programação de aplicativo, e dos drivers que foram ligados ao seu
binário, e depois sai. Se a opção-q não for especificado, então também
exibir informações de direitos autorais.
-X[driver:]name=value,... --screen-parameters=[driver:]name=value,...
Especifica os parâmetros para os drivers da tela. Se o mesmo parâmetro é
especificado mais de uma vez, a sua atribuição mais a direita é usada.
Se um nome de parâmetro é qualificado por um driver (consulte a seção
Drivers Suportados de Tela), então essa configuração só se aplica a esse
driver, se não é, então se aplica a todos os drivers. Para obter uma
descrição dos parâmetros aceitos por um driver específico, consulte a
documentação do driver. Veja as configurações do arquivo screen-
parameters para a configuração padrão de run-time.
5. Descrições das Características
5.1 Cursor de roteamento
Ao mover a janela de Braille em torno da tela, para análise do texto,
por exemplo, em um editor, muitas vezes você precisa levar o cursor até
um carácter especifico dentro da janela do braille. Você provavelmente
vai achar que isso uma tarefa bastante difícil para um número de razões.
Uma delas é que você pode não saber onde está o cursor, e que você pode
perder seu lugar ao tentar encontrá-lo. Outra é que o cursor pode mover
imprevisivelmente quando as setas forem pressionadas (alguns editores,
por exemplo, não permitem que o cursor seja mais direito ao fim da
linha). Cursor roteamento fornece apenas essa capacidade de saber onde
está o cursor, através da simulação das prensas mesma seta-chave que
você tem que digitar manualmente, e pelo acompanhamento do progresso do
cursor que se move.
Alguns displays braille têm um botão, conhecido como uma tecla de
cursor, acima de cada célula. Essas chaves usam o comando ROUTE para
encaminhar o cursor para o local desejado.
Cursor de roteamento é muito conveniente e eficaz, porém não totalmente
confiável. Uma razão para isso é que a sua implementação atual assume
VT100 cursor seqüências de escape chave. Outra é que algumas aplicações
fazem coisas fora do padrão em resposta ao detectar que uma tecla do
cursor foi pressionado. Um pequeno problema encontrado dentro de alguns
editores (como vi), como já mencionado acima, é que eles jogam em algum
movimento imprevisível horizontal quando o movimento vertical é
solicitado porque eles não permitem que o cursor fiquem à direita do
final de uma linha . Um dos principais problemas encontrados dentro de
alguns navegadores web (como o lynx) é que as teclas de seta para
baixo/cima são usadas para mover entre os links (que podem saltar linhas
e / ou mover o cursor horizontalmente, mas que raramente move o cursor
uma linha na direção desejada), e que a esquerda e teclas de seta para a
direita são usados para selecionar as ligações (que não tem
absolutamente nada a ver com qualquer forma de movimento do cursor que
seja, e que até muda totalmente o conteúdo da tela).
Cursor de roteamento não funciona muito bem em um sistema muito
carregado, e definitivamente não funciona muito bem ao trabalhar em um
sistema remoto através de um link lento. Isto é assim porque de todas as
verificações que devem ser feitos ao longo do caminho, a fim de lidar
com o movimento do cursor imprevisível, a fim de assegurar que qualquer
erro tem pelo menos uma chance de lutar para ser desfeito. Mesmo BRLTTY
tenta ser bastante inteligente, ainda deve essencialmente esperar para
ver o que acontece após cada pressionamento da seta-chave.
Uma vez que uma solicitação de cursor de roteamento foi feita, BRLTTY
continua tentando encaminhar o cursor para o local pretendido, até um
tempo limite de expiração antes que o cursor alcança essa localização, o
cursor parece estar se movendo na direção errada, ou se mudar para um
terminal virtual diferente. Uma tentativa é feita para usar o movimento
vertical para trazer o cursor para a linha direita, e, se essa for bem
sucedida, essa tentativa é feita, então usa o movimento horizontal para
trazer o cursor para a coluna da direita. Se outra solicitação é feita
enquanto ainda se está em andamento, em seguida, a primeira é anulada e
o segundo é iniciada.
Um cursor mais seguro, porém menos potente de roteamento, CSRJMP_VERT,
usa apenas o movimento vertical para trazer o cursor para qualquer lugar
no top da linha da janela braille. É especialmente útil em um conjunto
com as aplicações (como lynx) onde o movimento do cursor horizontal
nunca deve ser tentado.
5.2 Copiar e Colar
Este recurso permite que você pegue algum texto que já está na tela e
digitá-la na posição atual do cursor. Usando ele economiza tempo e evita
erros quando uma peça longa e/ou complicadas do texto precisa ser
copiado, e mesmo quando a mesma peça curta e simples do texto precisa
ser copiado muitas vezes. É particularmente útil para coisas como nomes
de arquivo longos, linhas de comandos complicados, os endereços de e-
mail e URL. Cortar e colar texto envolve três passos simples:
1. Marque o canto superior esquerdo da área retangular ou no início da
área linear na tela, que deve ser agarrado (corte). Se o display tem
chaves de roteamento, em seguida, move a janela braille, para que o
primeiro carácter a ser cortado aparecer em qualquer lugar dentro dela
e, em seguida:
· Invocar o comando CUTBEGIN para iniciar um novo buffer de corte.
· Invocar o comando CUTAPPEND para anexar ao buffer de corte
existentes, pressionando as chave associadas a ele e depois pressionar a
tecla de roteamento associado com o personagem.
2. Marque o canto inferior direito da área retangular ou o fim da área
linear na tela, que deve ser agarrado (corte). Se o display tem chaves
de roteamento, move a janela de braille para que o último caracter a ser
cortado aparece em qualquer lugar dentro dela e, em seguida:
· Invocar o comando CUTRECT para cortar uma área retangular.
· Invocar o comando CUTLINE para cortar uma área linear pressionando
as chave associadas a ele e depois pressionar a tecla de roteamento
associado com o carácter. Marcando o fim da área de corte acrescenta o
conteúdo da tela selecionada com o buffer de corte. O excesso de espaço
em branco é removido no final de cada linha no buffer de corte de modo
que os espaços indesejados no final não vão ser colado para trás do
carácter de controle que serão substituídos por espaços em branco.
3. Inserir (colar) o texto onde ele é necessário. Coloque o cursor sobre
o carácter onde o texto deve ser colado, e invocar o comando PASTE. Você
pode colar o mesmo texto varias vezes sem recortar. Esta descrição
assume que você já está em algum tipo de modo de entrada. Se você colar
quando você estiver em algum outro tipo de modalidade (como comando vi),
então é melhor você estar ciente de que os caracteres no buffer de corte
vão fazer.
O buffer de corte também é usado pelos comandos PRSEARCH/NXSEARCH.
5.3 Suporte do Ponteiro (Mouse) via GPM
Se BRLTTY é configurado com a opção de compilação --enable-gpm no
sistema onde a aplicação gpm foi instalada, em seguida, ele vai
interagir com o cursor (mouse).
Mover o ponteiro e arrastar a janela braille (veja Window Follows
Pointer). Sempre que o ponteiro é movido para além da borda da janela do
braille, a janela do braille é arrastada (um carácter por vez). Isto dá
ao usuário braille outra forma bidimensional para inspecionar o conteúdo
da tela ou mover-se rapidamente a janela braille para o local desejado.
Ele também dá uma visão de observador de maneira fácil para mover a
janela de braille para algo que ele gostaria que o usuário Braille possa
ler.
O gpm usa vídeo reverso para mostrar onde o cursor está. Sublinhando os
caracteres em destaque (veja o comando ATTRVIS) deve ser ativado,
portanto, quando o usuário braille pretende usar o ponteiro.
Esse recurso também permite o acesso do usuário em Braille para gpm é
cortado e colado. Embora você deve ler a documentação própria gpm, aqui
estão algumas notas sobre a forma como ele funciona.
· Cópia do carácter atual para o buffer cortado por um único clique
com o botão esquerdo.
· Cópia da palavra atual (espaço delimitado) para o buffer de corte
com um duplo clique com o botão esquerdo.
· Cópia da linha atual para o buffer de corte de triplo-clique com o
botão esquerdo.
· Cópia de uma região linear para o buffer de corte da seguinte
forma:
1. Coloque o ponteiro do mouse sobre o primeiro carácter da região.
2. Pressione (e mantenha pressionado) o botão esquerdo.
3. Mova o ponteiro para o último carácter da região (todos os
caracteres selecionados são destacados).
4. Solte o botão esquerdo.
· Cole (entrada) o conteúdo atual do buffer de corte clicando o botão
do meio do mouse de três botões, ou clicando com o botão direito do
mouse de dois botões.
· Aparece para o buffer de corte usando o botão direito do mouse de
três botões.
5.4 Alerta de Tunes
BRLTTY alerta para a ocorrência de eventos significativos, tocando
melodias curtas predefinidas. Este recurso pode ser ativado e desativado
com um comando TUNES ou o Alert Tunes. As músicas são tocadas através do
apito interno, por padrão, mas outras alternativas podem ser
selecionadas com a preferência de Tune Device.
Cada evento significativo está associado, do maior para a menor
prioridade, com um ou mais dos seguintes procedimentos:
a tune
Se uma música tem sido associado com o evento, se o Alert Tunes (veja
também o comando TUNES) está ativo e se o dispositivo de ajuste for
selecionado (veja a preferência de Dispositivos Tune) pode ser aberto,
então a música é tocada.
a dot pattern
Se um padrão de pontos tem sido associado com o evento, e se a
preferência do Alert Dots está ativo, então o padrão de pontos é exibido
rapidamente em cada célula braille. Alguns displays braille não
respondem com rapidez suficiente para que este mecanismo funcione de
forma eficaz.
a message
Se a mensagem tem sido associada com o evento, e se a preferência Alert
Messages estiver ativa, ela é exibido por alguns segundos (veja a opção
-m de linha de comando).
Estes eventos incluem:
· Quando o driver do display Braille começa ou pára.
· Quando um comando demorado concluí.
· Quando um comando não pode ser executado.
· Quando uma marca é definida.
· Quando o início ou o fim do bloco de corte é definida.
· Quando um recurso é ativado ou desativado.
· Quando o controle de cursor é ligado ou desligado.
· Quando a imagem da tela é congelada ou descongelada.
· Quando a janela braille envolvida ou até o início da próxima
linha ou até o fim da linha anterior.
· Quando as linhas idênticas são ignorados.
· Quando uma solicitação não pode ser executada.
· Quando o cursor começa o roteamento, termina, ou falha.
5.5 Configurações de Preferências
Quando BRLTTY é iniciado, ele carrega um arquivo que contém as
definições de preferências. O arquivo não precisa existir, ele é criado
pela primeira vez, as configurações são salvas com o comando PREFSAVE.
As configurações mais recentemente salvas podem ser restauradas a
qualquer momento com o comando PREFLOAD.
O nome para este arquivo é /etc/brltty-driver.prefs. Onde driver tem
duas letras do código de identificação de driver.
5.5.1 Menu de Preferências
As configurações de preferências são salvos como dados binários que,
portanto, não pode ser editado manualmente. BRLTTY, no entanto, tem um
menu simples do que você pode facilmente mudá-los.
O menu é ativado pelo comando PREFMENU. O display braille (ver -m)
mostra o título do menu, e em seguida, apresenta o item atual e sua
configuração atual.
5.5.1.1 Menu de Navegação
Consulte o Comandos do Menu de Navegação para a lista completa dos
comandos que permitem que você selecione os itens e altere as
configurações dentro do menu. Para compatibilidade com drivers antigos,
os comandos de janela do movimento, que alteraram os significados, neste
contexto, também pode ser usado.
TOP/ BOT, TOP_LEFT/BOT_LEFT, PAGE_UP/PAGE_DOWN
Ir para o primeiro item / último no menu (o mesmo como
MENU_FIRST_ITEM/MENU_LAST_ITEM).
LNUP/LNDN, PRDIFLN/NXDIFLN, CURSOR_UP/CURSOR_DOWN
Ir para o item anterior / seguinte no menu (o mesmo que
MENU_PREV_ITEM/MENU_NEXT_ITEM).
WINUP/WINDN, CHRLT/CHRRT, CURSOR_LEFT/CURSOR_RIGHT, BACK/HOME
Diminuir aumentar / definir o item de menu atual (o mesmo que
MENU_PREV_SETTING/MENU_NEXT_SETTING).
Notas:
· As chaves de roteamento também pode ser usado para selecionar uma
opção para o item atual. Se o item tem ajustes numéricos, em seguida,
toda a linha de chaves de roteamento atua como uma barra de rolagem, que
abrange toda a gama de valores válidos. Se o item tem chamado
configurações, então as chaves de roteamento correspondem com as
configurações.
· Use o comando PREFLOAD desfazer todas as alterações que foram feitas
desde a sua entrada no menu.
· Use o comando PREFMENU (novamente) para deixar as novas configurações
de fato, sair do menu, e retomar a operação normal. Se a opção "Save
Settings on Exit" é definido, então, além disso, as novas configurações
são gravadas no arquivo de configurações de preferências. Qualquer
comando não é reconhecido pelo sistema de menu também faz essas coisas
mesmo.
5.5.1.2 Itens de Menu
Salvar ao sair
Ao sair do menu de preferências:
No
Não salvar automaticamente as configurações de preferências.
Yes
Salvar automaticamente as configurações de preferências.
A configuração inicial é No.
Text Style
Ao exibir o conteúdo da tela (veja o comando DISPMD), os caracteres
mostram:
8-dot
Com os oito pontos.
6-dot
Com apenas pontos de 1 a 6. Se uma tabela de contração foi
selecionada(veja a opção -c da linha de comando e da tabela de contração
do arquivo de configuração), então ele é usado.
Esta configuração também pode ser alterado com o comando SIXDOTS.
Skip Identical Lines
Quando se deslocam para cima ou para baixo exatamente uma linha com os
comandos LNUP/LNDN, bem como o recurso de FWINRT/FWINLT e comandos
FWINLTSKIP/FWINRTSKIP:
No
Não pule linhas passadas, que têm o mesmo conteúdo da linha atual.
Yes
Pula linhas passadas, que têm o mesmo conteúdo da linha atual.
Esta configuração também pode ser alterado com o comando SKPIDLNS.
Skip Blank Windows
Quando se deslocam para a esquerda ou direita, com os comandos
FWINLT/FWINRT:
No
Não pular janelas em branco.
Yes
Pular janelas em branco.
Esta configuração também pode ser alterado com o comando SKPBLNKWINS.
Which Blank Windows
Se as janelas em branco devem ser ignorados:
All
passar todos eles.
Fim da Linha
apenas ignorar aqueles que estão no final (do lado direito) de uma
linha.
Resto da Linha
apenas ignorar aqueles que estão no final (do lado direito) de uma
linha durante a leitura para a frente, e no início (do lado esquerdo) de
uma linha durante a leitura para trás.
Sliding Window
Se o cursor está a ser controlado (veja o comando CSRTRK), e o cursor
move-se demasiado perto (ou mais) uma das janela do Braille:
No
Reposicionar horizontalmente a janela de modo que sua extremidade
esquerda é um múltiplo de sua largura da borda esquerda da tela.
Yes
Horizontalmente reposicionar a janela de tal forma que o cursor,
mantendo-se nesse lado da janela, está mais próximo do centro.
Esta configuração também pode ser alterado com o comando SLIDEWIN.
Eager Sliding Window
Se a janela de braille é slide:
No
Reposicioná-lo sempre que o cursor se move para além de uma ou outra
extremidade.
Yes
Reposicioná-lo sempre que o cursor move-se muito perto de uma das
extremidades.
A configuração inicial é No.
Window Overlap
Quando se deslocam para a esquerda ou direita com os comandos
FWINLT/FWINRT, esta configuração especifica quantos caracteres
horizontalmente adjacente janelas braille devem sobrepor-se uns aos
outros por. O ajuste inicial é 0.
AutoRepeat
Enquanto a chave (combinação) para um comando permanece pressionado:
No
Não repita automaticamente o comando.
Yes
Automaticamente repetir o comando em um intervalo regular, após um
atraso inicial.
Os seguintes comandos são elegíveis para auto reply:
· O comando LNUP/LNDN.
· O comando PRDIFLN/NXDIFLN.
· O comando CHRLT/CHRRT.
· Operações panorâmica da janela Braille (ver AutoRepeat Panning).
· Operações de Page-Up e Page-Down.
· Operações de cursor-up e cursor-down.
· Operações de cursor esquerda e cursor direita.
· Operações de Backspace e Delete.
· Carácter de entrada.
Apenas alguns drivers suportam esta funcionalidade, a principal
limitação é que muitos display braille não sinalizam tanto teclas
pressionadas e chaves como eventos separados distintamente. Esta
configuração também pode ser alterado com o comando AutoRepeat. A
configuração inicial é YES.
AutoRepeat Panning
Quando a preferência Autorepeat está habilitada:
No
Não há operações de autorepeat da janela panorâmica em braille.
Yes
Operações de AutoRepeat para janela panorâmica em braille.
Esta preferência atinge os comandos FWINLT/FWINRT. A configuração
inicial é No.
AutoRepeat Delay
Quando um carácter é a auto repetitivo, esta configuração especifica a
quantidade de tempo (veja Configurações de Tempo), que deve passar antes
auto repetição começa. A configuração inicial é 50.
AutoRepeat Interval
Quando um carácter está sendo auto repetitivo, esta configuração
especifica a quantidade de tempo (veja Configurações de Tempo) entre
cada reexecução. A configuração inicial é 10.
Show Cursor
Ao exibir o conteúdo da tela (veja o comando DISPMD):
No
Não mostrar o cursor.
Yes
Mostrar o cursor.
Esta configuração também pode ser alterado com o comando CSRVIS. A
configuração inicial é Yes.
Cursor Style
Ao mostrar o cursor, representá-lo:
Underline
Com pontos 7 e 8.
Block
Com os oito pontos.
Esta configuração também pode ser alterado com o comando CSRSIZE.
Blinking Cursor
Quando o cursor está a ser mostrado:
No
Deixar-se visível o tempo todo.
Yes
Torná-lo alternadamente, visíveis e invisíveis de acordo com um
intervalo predefinido.
Esta configuração também pode ser alterado com o comando CSRBLINK.
Cursor Visible Time
Quando o cursor está a ser piscou, esta configuração especifica o
período de tempo (veja time settings) durante cada ciclo que está a ser
visível. A configuração inicial é de 40.
Cursor Invisible Time
Quando o cursor está a ser piscou, esta configuração especifica o
período de tempo (veja time settings) durante cada ciclo que é ser
invisível. A configuração inicial é de 40.
Show Cursor
Ao exibir o conteúdo da tela (veja o comando DISPMD):
No
Não mostrar o cursor.
Yes
Mostrar o cursor.
Esta configuração também pode ser alterado com o comando CSRVIS. A
configuração inicial é Yes.
Cursor Style
Ao mostrar o cursor, representá-lo:
Underline
Com pontos 7 e 8.
Block
Com os oito pontos.
Esta configuração também pode ser alterado com o comando CSRSIZE.
Blinking Cursor
Quando o cursor está a ser mostrado:
No
Deixar-se visível o tempo todo.
Yes
Torná-lo alternadamente, visíveis e invisíveis de acordo com um
intervalo predefinido.
Esta configuração também pode ser alterado com o comando CSRBLINK.
Cursor Visible Time
Quando o cursor está a ser piscou, esta configuração especifica o
período de tempo (veja time settings) durante cada ciclo que está a ser
visível. A configuração inicial é de 40.
Cursor Invisible Time
Quando o cursor está a ser piscou, esta configuração especifica o
período de tempo (veja time settings) durante cada ciclo que é ser
invisível. A configuração inicial é de 40.
Show Attributes
Ao exibir o conteúdo da tela (veja o comando DISPMD):
No
Não sublinhar os caracteres em destaque.
Yes
Sublinhar caracteres em destaque.
Esta configuração também pode ser alterado com o comando ATTRVIS.
Blinking Attributes
Quando os caracteres em destaque são sublinhados:
No
Deixe o indicador visível o tempo todo.
Yes
Faça o indicador alternadamente visíveis e invisíveis de acordo com
um intervalo predefinido.
Esta configuração também pode ser alterado com o comando ATTRBLINK.
Attributes Visible Time
Quando o carácter sublinhado em destaque piscar, esta configuração
especifica o período de tempo (veja time settings) durante cada ciclo
que está a ser visível. A configuração inicial é de 20.
Attributes Invisible Time
Quando o carácter sublinhado em destaque piscar, esta configuração
especifica o período de tempo (veja time settings) durante cada ciclo
que é ser invisível. A configuração inicial é de 60.
Blinking Capitals
Ao exibir o conteúdo da tela (veja o comando DISPMD):
No
Deixar maiúsculas visível o tempo todo.
Yes
Faça letras maiúsculas alternadamente visíveis e invisíveis de acordo
com um intervalo predefinido.
Esta configuração também pode ser alterado com o comando CAPBLINK.
Capitals Visible Time
Quando as letras maiúsculas são destacadas, esta configuração especifica
o período de tempo (veja time settings) durante cada ciclo que estão a
ser visíveis. A configuração inicial é de 60.
Capitals Invisible Time
Quando as letras maiúsculas são destacadas, esta configuração especifica
o período de tempo (veja time settings) durante cada ciclo que estão a
ser invisível. A configuração inicial é de 20.
Braille Firmness
Ajuste a consistência (ou rigidez) dos pontos braille. Pode ser definido
como:
· Máximo
· Alta
· Média
· Baixo
· Mínimo
Essa preferência está disponível somente se um driver que suporta ele
está sendo usado. A configuração inicial é média.
Window Follows Pointer
Ajuste a sensibilidade dos pontos braille para tocar. Pode ser definido
como:
· Máximo
· Alta
· Média
· Baixo
· Mínimo
Essa preferência está disponível somente se um driver que suporta ele
está sendo usado. A configuração inicial é média.
Window Follows Pointer
Ao mover o dispositivo de cursor (mouse):
No
Não arrastar a janela braille.
Yes
Arraste a janela braille.
Esta preferência é apenas apresentada se a opção de compilação --enable-
gpm foi especificada.
Highlight Window
Ao mover a janela do Braille:
No
Não dar destaque a área da tela nova.
Yes
Destaque da área nova tela.
Este recurso permite que um observador com visão para ver onde está a
janela braille e, portanto, saber o que o usuário está lendo em braille.
Qualquer movimento da janela em braille (manual, controle do cursor,
etc), exceto quando se move em resposta ao ponteiro (mouse) movimento
(veja Windows Follows Pointer), faz com que a área da tela
correspondente ao novo local da janela Braille ser destacada. Se a
preferência Show Attributes está habilitada, somente o caractere
correspondente ao canto superior esquerdo da janela do braille é
destacado.
Alert Tunes
Sempre que um evento significativo, com uma melodia associada ocorre
(ver Alerta de Tunes):
No
Não tocar a música.
Yes
Tocar a música.
Esta configuração também pode ser alterado com o comando TUNES. A
configuração inicial é Yes.
Tune Device
Tocar músicas de alerta através de:
Beeper
O apito interno (console gerador de tom). Esta configuração é suportada
em Linux, no OpenBSD, no FreeBSD e no NetBSD. É sempre seguro para usar,
embora possa ser um pouco fraco. Este dispositivo não está disponível se
a opção de compilação --disable-bipper-suport foi especificada.
PCM
A interface digital de áudio na placa de som. Esta configuração é
suportada no Linux (via /dev/dsp), no Solaris (via /dev/audio), no
OpenBSD (via /dev/audio0), sobre FreeBSD (via /dev/dsp), e no NetBSD
(via /dev/audio0). Ele não funciona quando este dispositivo já está
sendo usado por outro aplicativo. Este dispositivo não está disponível
se a opção de compilação --disable-pcm-support foi especificada.
MIDI
O Musical Instrument Digital Interface na placa de som que está definida
é compatível com Linux (através do /dev/sequencer). Ele não funciona
quando este dispositivo já está sendo usado por outro aplicativo. Este
dispositivo não está disponível se a opção de compilação --disable-midi-
support foi especificada.
FM
O sintetizador de FM em um cartão de AdLib, OPL3, Sound Blaster, ou o
equivalente de som. Esta configuração é suportada em Linux. Os
resultados são imprevisíveis e potencialmente não muito bons, se for
usado com uma placa de som que não suporta esse recurso. Este
dispositivo não está disponível se a opção de compilação --disable-fm-
support foi especificada.
A configuração inicial é Beeper sobre as plataformas que suportam, e PCM
sobre as plataformas que não o fazem.
PCM Volume
Se a interface de áudio digital da placa de som está sendo usado para
tocar as músicas alerta, esta configuração especifica o volume (como uma
porcentagem do máximo) em que estão a ser tocado. A configuração inicial
é de 70.
MIDI Volume
Se o Musical Instrument Digital Interface (MIDI) da placa de som está
sendo usado para tocar as músicas alerta, esta configuração especifica o
volume (como uma porcentagem do máximo) em que estão a ser tocado. A
configuração inicial é de 70.
MIDI Instrument
Se o Musical Instrument Digital Interface (MIDI) da placa de som está
sendo usada para tocar as músicas alerta, esta configuração especifica
qual o instrumento a ser utilizado (ver MIDI Table Instrument). A
configuração inicial é Acoustic Grand Piano.
FM Volume
Se o sintetizador FM da placa de som está sendo usado para tocar as
músicas alerta, esta configuração especifica o volume (como uma
porcentagem do máximo) em que estão a ser tocado. A configuração inicial
é de 70.
Alert Dots
Sempre que um evento significativo associado com um padrão de pontos
ocorre (ver Alerta de Tunes):
No
Não exibir o padrão de pontos.
Yes
Resumidamente exibir o padrão de pontos.
Se melodias de alerta são para ser jogado (veja o comando TUNES e o
Alerta de Tunes), se uma música tem sido associado com o evento, e se o
dispositivo da canção selecionado pode ser aberto, então,
independentemente da configuração dessa preferência, o padrão de pontos
não será exibido.
Alert Messages
Sempre que um evento significativo, com uma mensagem associada ocorre
(ver Alerta de Tunes):
No
Não mostrar a mensagem.
Yes
Mostrar a mensagem.
Se as mensagens de alerta são tocadas (veja o comando TUNES e a
preferência Alerta de Tunes), se uma música tem sido associado com o
evento, e se o dispositivo de ajuste selecionado pode ser aberto, ou se
o alerta padrões de pontos que devem ser exibidas (consulte Alert Dots)
e se um padrão de pontos tem sido associado com o evento, então,
independentemente da configuração dessa preferência, a mensagem não é
exibida.
Say-Line Mode
Ao usar o comando SAY_LINE:
Immediate
Descartar discurso pendentes.
Enqueue
Não descartar pendentes discurso.
A configuração inicial é immediate.
Autospeak
No
Só falar quando for solicitado a fazê-lo.
Yes
Automaticamente falar:
· A nova linha quando a janela é movida verticalmente braille.
· Caracteres que são inseridos ou excluídos.
· O carácter ao qual o cursor é movido.
Esta configuração também pode ser alterado com o comando AUTOSPEAK. A
configuração inicial é No.
Speech Rate
Ajustar a velocidade de fala (0 é o mais lento, 20 é o mais rápido).
Essa preferência está disponível somente se um driver que suporta ele
está sendo usado. Esta configuração também pode ser alterado pelos
comandos SAY_SLOWER/SAY_FASTER. A configuração inicial é 10.
Speech Pitch
Ajuste o volume da voz (0 é o mais baixo, 20 é o mais alto). Essa
preferência está disponível somente se um driver que suporta ele está
sendo usado. Esta configuração também pode ser alterado com os comandos
SAY_SOFTER/SAY_LOUDER. A configuração inicial é 10.
Speech Pitch
Ajustar o tom de voz (0 é o menor e o 20 é o mais alto). Essa
preferência está disponível somente se um driver que suporta ele está
sendo usado. A configuração inicial é 10.
Speech Punctuation
Ajuste a quantidade de pontuação que é falado. Pode ser definido como:
· All
· Some
· All
Essa preferência está disponível somente se um driver que suporta ele
está sendo usado. A configuração inicial é some.
Status Style
Esta configuração especifica o caminho que as células de estado estão a
ser utilizados. Você não deveria precisam de tocar com nelas. Isso
permite que os desenvolvedores BRLTTY para testar as configurações de
status da pilha para display braille que eles realmente não têm.
None
Não use as células de status. Essa configuração é sempre seguro, mas
também é completamente inútil.
Alva
As células status conter:
1 - A localização do cursor (veja abaixo).
2 - A localização do canto superior esquerdo da janela do braille
(ver abaixo).
3 - Uma carta indicando o estado de BRLTTY.
Na ordem de precedência:
a
Tela atributos estão a ser mostrados (veja o comando DISPMD).
f
A imagem da tela é congelada (veja o comando FREEZE).
f
O cursor está sendo controlado (veja o comando CSRTRK).
blank
Nada de especial.
A localização do cursor e a janela braille são apresentados de uma
maneira interessante. Os pontos 1 a 6 representam o número da linha com
uma carta de a (para 1) por y (para 25). Os pontos 7 e 8 (os dois extra
na parte inferior) representam o número janela horizontal braille como
segue:
No Dots
A primeira janela (à esquerda).
Dot 7
A segunda janela.
Dot 8
A terceira janela.
Dots 7 e 8
A quarta janela.
Em ambos os casos, os indicadores guardados: a linha 26 é representado
pela letra A, e a quinta janela horizontal braille é representado por
nenhum ponto, na parte inferior.
Tieman
As células de status devem conter:
1-2: As colunas (contando a partir 1) do cursor (como mostrado na
metade superior das células) e no canto superior esquerdo da janela do
braille (mostrado na metade inferior das células).
3-4: As linhas (contando a partir 1) do cursor (como mostrado na
metade superior das células) e no canto superior esquerdo da janela do
braille (mostrado na metade inferior das células).
5: Cada ponto indica se um recurso é ativado como se segue:
Dot 1: A imagem da tela é congelada (veja o comando FREEZE).
Dot 2: atributos da tela estão sendo exibidos (veja o comando
DISPMD).
Dot 3: Alerta músicas estão sendo tocadas (veja o comando TUNES).
Dot 4: O cursor está sendo mostrado (veja o comando CSRVIS).
Dot 5: O cursor é um bloco sólido (veja o comando CSRSIZE).
Dot 6: O cursor está piscando (veja o comando CSRBLINK).
Dot 7: O cursor está a ser controlado (veja o comando CSRTRK).
Dot 8: A janela vai deslizar braille (veja o comando SLIDEWIN).
PowerBraille 80
As células status conter:
1: A linha (contando a partir de 1) correspondente à parte superior
da janela em braille. Os dígitos das dezenas é mostrado na metade
superior da pilha, e os dígitos das unidades é apresentada na
metade inferior da célula.
Generic
Esta definição passa um monte de informações para o driver braille, e o
driver decide forma de apresentá-lo.
MDV
As células de status devem conter:
1-2: A localização do canto superior esquerdo da janela do braille.
A linha (contando a partir de 1) é mostrado na metade superior das
células, e na coluna (contando a partir de 1) é mostrado na metade
inferior das células.
Voyager
As células de status devem conter:
1: A linha (contando a partir de 1) correspondente à parte superior
da janela braille (ver below).
2: A linha (contando a partir de 1) onde o cursor está (veja
below).
3: Se a tela está congelada (veja o comando FREEZE), depois a letra
F. Se não for, então a coluna (contando a partir de 1) onde está o
cursor (veja below).
Os números de linhas e colunas são mostrados os números de dois dígitos
em uma única célula. Os dígitos das dezenas são mostrados na metade
superior da pilha, e os dígitos das unidades são apresentadas na metade
inferior da célula.
A configuração inicial do driver de display Braille é dependente.
Text Table
Selecione a tabela de texto. Ver seção de Tabelas de Texto para mais
detalhes. Veja a opção -t para a configuração inicial. Esta preferência
não é salvo.
Attributes Table
Selecione a tabela de atributos. Ver Tabela de Atributos. Veja a opção
de linha de comando -t para a configuração inicial. Esta preferência não
é salvo.
Contraction Table
Selecione a tabela de contração. Ver Tabela de Contração. Consulte a
linha de comando -c para a configuração inicial. Esta preferência não é
salvo.
Key Table
Selecione a tabela chave. Ver Tabelas de Teclas. Consulte a linha de
comando -k para a configuração inicial. Esta preferência não é salvo.
Notas:
· Todos os parâmetros de tempo em centésimos de segundo. Eles são
múltiplos do intervalo da janela de atualização braille (veja a
linha de comando -u) dentro da faixa de 1 a 100.
5.6 Status do Display
O status do display é um resumo do estado atual BRLTTY, que se encaixa
totalmente dentro da janela do braille. Alguns displays braille têm um
conjunto de células de status que são usados para exibir permanentemente
algumas dessas informações, bem como (consulte a documentação para o
driver do display). Os dados apresentados por este display não são
estáticos, e podem ser alteradas a qualquer momento, em resposta a tela
de atualizações e/ou comandos BRLTTY.
Use o comando INFO para alternar para a exibição de status, e usá-lo
novamente para retornar para a tela. O layout das informações contidas
está dependente do tamanho da janela do braille.
5.6.1 Display com 21 células ou mais
Pneumáticos curta têm sido utilizados, apesar de serem um tanto
enigmática, a fim de mostrar o layout da coluna precisa.
wx:wy cx:cy vt tcmfdu
wx:wy
A coluna e linha (contando a partir de 1) na tela correspondente ao
canto superior esquerdo da janela do braille.
cx:cy
A coluna e linha (contando a partir de 1) sobre a tela
correspondente à posição do cursor.
vt
O número (contando a partir 1) do terminal virtual atual.
t
O estado do recurso de controle de cursor (veja o comando CSRTRK).
blank
controle de cursor está off.
t
controle de cursor está on.
c
O estado dos recursos visibilidade do cursor (ver o CSRVIS e
CSRBLINK).
blank
O cursor não estiver visível, e não piscar quando se faz visível.
b
O cursor não é visível, e começa a piscar quando se faz visível.
v
O cursor é visível, e não está piscando.
B
O cursor é visível e está piscando.
m
O modo de exibição atual (veja o comando DISPMD).
t
Tela de conteúdo (texto) está sendo exibido.
a
Tela de realce (atributos) está sendo exibido.
f
O estado do recurso de tela congelada (veja o comando FREEZE).
blank
A tela não está congelada.
d
O número de pontos braille sendo usado para exibir cada caracter
(veja o comando SIXDOTS).
8
Todos os oito pontos estão sendo usados.
6
Somente pontos 1 a 6 estão sendo usados.
u
O estado da maiúscula (letra maiúscula) apresentam características
(veja o comando CAPBLINK).
blank
Letras maiúsculas não piscar.
B
Piscar letras maiúsculas.
5.6.2 Display com 20 células ou menos
Pneumático curto têm sido utilizados, apesar de serem um tanto
enigmática, a fim de mostrar o layout da coluna precisa.
xxyys vt tcmfdu
xx
As colunas (contando a partir de 1) sobre a tela correspondente à
posição do cursor (como mostrado na metade superior das células) e
para o canto superior esquerdo da janela do braille (mostrado na
metade inferior das células).
yy
As linhas (contando a partir de 1) sobre a tela correspondente à
posição do cursor (como mostrado na metade superior das células) e
para o canto superior esquerdo da janela do braille (mostrado na
metade inferior das células).
s
As definições de algumas das características do BRLTTY. Um recurso
é ativado se o ponto correspondente é gerado.
Dot 1: Congela a imagem da tela (veja o comando FREEZE).
Dot 2: Mostrar atributos (veja o comando DISPMD).
Dot 3: Tunes de alerta (veja o comando TUNES).
Dot 4: Cursor visível (veja o comando CSRVIS).
Dot 5: Bloco de cursor (veja o comando CSRSIZE).
Dot 6: Cursor piscando (veja o comando CSRBLINK).
Dot 7: Cursor de monitoramento (veja o comando CSRTRK).
Dot 8: Janela deslizante (veja o comando SLIDEWIN).
vt
O número (contando a partir 1) do terminal virtual atual.
t
O estado do recurso de controle de cursor (veja o comando CSRTRK).
blank
Controle de cursor está off.
t
Controle cursor está on.
c
O estado dos recursos visibilidade do cursor (ver o CSRVIS e
CSRBLINK).
blank
O cursor não estiver visível, e não piscar quando se faz visível.
b
O cursor não é visível, e começa a piscar quando se faz visível.
v
O cursor é visível, e não está piscando.
B
O cursor é visível e está piscando.
m
O modo de exibição atual (veja o comando DISPMD).
t
Tela de conteúdo (texto) está sendo exibido.
a
Tela de realce (atributos) está sendo exibido.
f
O estado do recurso de tela congelada (veja o comando FREEZE).
blank
A tela não está congelada.
f
A tela está congelada.
d
O número de pontos braille sendo usado para exibir cada caracter
(veja o comando SIXDOTS).
8
Todos os oito pontos estão sendo usados.
6
Somente pontos 1 a 6 estão sendo usados.
u
O estado da maiúscula (letra maiúscula) apresentam características
(veja o comando CAPBLINK).
blank
Letras maiúsculas não piscar.
B
Piscar letras maiúsculas.
5.7 Comando de Modo de Aprendizagem
Comando modo de aprendizagem é uma forma interativa de aprender o que as
teclas no visor do Braille faz. Pode ser acessado tanto pelo comando
LEARN ou através do utilitário brltest. Esse recurso não estará
disponível se a opção de compilação --disable-learn-mode foi
especificado.
Quando este modo está inscrito, a mensagem command learn mode é escrita
no display braille. Então, cada tecla (ou combinação de teclas) sobre a
tela é pressionada, uma mensagem curta que descreva a sua função BRLTTY
está escrito. Este modo sai imediatamente se a tecla (ou combinação de
teclas) para o comando LEARN é pressionado. Ele sai automaticamente, e a
mensagem done é escrita, se dez segundos transcorrer sem qualquer tecla
no display sendo pressionado. Observe que alguns displays não têm sinal
ao display e/ou alguns drivers não sinalizam BRLTTY até que todas as
teclas são liberadas.
Se uma mensagem for maior que o display Braille, então é exibida em
segmentos. O comprimento de cada segmento, mas o último é um a menos do
que a largura do display, com o caracter mais à direita no visor a ser
definida como um sinal de menos. Cada segmento se mantenha no visor seja
por alguns segundos (veja a opção-M) ou até que qualquer tecla na tela é
pressionada.
6 – Tabelas
6.1 - Tabelas de Texto
Os arquivos com nomes no formato *. ttb são tabelas de texto, e com
nomes no formato *.tti são textos subtabelados. Eles são usados pelo
BRLTTY para traduzir os caracteres na tela em suas respectivas
representações de 8 pontos no computador braille.
BRLTTY é inicialmente configurado para usar a tabela de texto North
American Braille Computer Code(NABCC). Além desse padrão, as
alternativas a seguir são fornecidas:
Auto
auto-seleção da localidade-base
ar Árabe (genérico)
as Assamês
awa Awadhi
bg Búlgaro
bh Bihari
bn Bengali
bo Tibetano
bra Braj (?Braj Bhasha )
brf para visualização de arquivos. brf dentro de um editor ou
pager
cs Checo
cy Galês
da Dinamarquês
de Alemão
dra Dravidianas
el Grego
em Inglês
en_CA Inglês (Canadá)
en_UK Inglês (Reino Unido)
en_US Inglês (Estados Unidos)
en-nabcc Inglês (North American Braille Computer Code)
eo Esperanto
es Espanhol
et Estoniano
fi Finlandes
fr Francês
fr_CA Francês (Canadá)
fr_FR Francês (França)
fr_2007 Francês (unificado)
fr-cbifs Francês (Code Braille Informatique Français Standard)
ga Irlandês
gd Gaélico
gon Gondi
gu Guzerate
he Hebraico
hi Hindi
hr Croata
hu Húngaro
hy Armênio
is Islandes
it Italiano
kha Khasi
kn Canará
kok Concanis
kru Kurukh
lt Lituana
lv Letã
mg Malgaxe
mi Maori
ml Malaiala
mni Manipuri
mr Marati
mt Maltês
mun Mundari
mwr Marwari
ne Nepali
new Newari
nl Holandês
nl_BE Holandês (Bélgica)
nl_NL Holandês (Países Baixos)
no Norueguês
no-generic Norueguês (com suporte para outros idiomas)
no-oub Norueguês (Utvalg Offentlig para Blindeskrift)
nwc Antigo Newari
or Oriá
pa Panjabi
pi Páli
pl Polonês
pt Português
ro Romeno
ru Russo
sa Sânscrito
sat Santali
sd Sindi
sk Eslovaco
sv Sueco
sw Suaíli
ta Tâmil
te Telugu
tr Turco
vi Vietnamita
Veja a opção de linha de comando -t, a configuração text-table do
arquivo de directiva, e a opção de construção --with-text-table para
obter detalhes sobre como usar uma tabela de texto alternativo.
6.1.1 Tabela de Formato de Texto
A tabela de texto consiste em uma seqüência de directivas, um por linha,
que definem como cada character é representado em braille. UTF-8
caracter encoding deve ser usado. O espaço em branco (espaços, tabs) no
início de uma linha, assim como antes e/ou após qualquer operando de
qualquer directiva, é ignorado. Linhas que contêm apenas espaço em
branco são ignoradas. Se o primeiro caráter não-espaço em branco antes
de uma linha é "#" então essa linha é um comentário e é ignorado.
6.1.2 Tabela de Diretivas de Texto
As seguintes diretivas são fornecidas:
char character dots # comentários
Use a diretiva char para especificar como um caracter Unicode será
representado em braille.
character
Os caracteres Unicode a serem definidos. Podem ser:
· Qualquer caracter único que não seja uma barra-invertida ou um
carácter de espaço em branco.
· Um caracter especial prefixado de barra-invertida. São eles:
\b
Carácter de retrocesso.
\f
Carácter formfeed (quebra de página).
\n
Carácter de nova linha.
\o###
Representação de um carácter de três dígitos octal.
\r
Carácter de retorno de transporte.
\s
Carácter de espaço.
\t
Carácter de tab horizontal.
\u####
Representação de um carácter hexadecimal de quatro dígito.
\U########
Representação de um carácter hexadecimal de oito dígito.
\v
Carácter de tab horizontal.
\x##
Representação de um carácter hexadecimal de dois dígitos.
\X##
(o caso do X e dos dígitos não é significativa).
f
A tela está congelada.
\#
Um sinal de número literal.
\<name>
O nome Unicode de um carácter(use _ para espaço).
\\
Uma barra-invertida literal.
dots
A representação braille dos caracteres Unicode. É uma seqüência de 1-8
números dos pontos. Se o número do ponto de seqüência é colocado entre
parênteses, em seguida, os números dos pontos podem ser separados um do
outro por espaço em branco. Um número de ponto é um dígito dentro do
intervalo de 1-8, tal como definido pela Standard Braille Dot Numbering
Convention. O ponto especial de número 0 não é reconhecido quando entre
parênteses, e significa que não há pontos, não podendo ser usado em
conjunto com qualquer outro número de pontos.
Exemplos
· char a 1
· char b (12)
· char c ( 4 1 )
· char \\ 12567
· char \s 0
· char \x20 ()
· char \<LATIN_SMALL_LETTER_D> 145
byte byte dots # comment
Use a diretiva de byte para especificar como um carácter no conjunto de
caracteres local está sendo representado em braille. Foi mantido para
compatibilidade com versões anteriores, mas não deve ser usado.
Carácteres Unicode devem ser definidos (através da diretiva char) para
que a tabela de texto permanece válida, independentemente do qual
conjunto de caracteres local usado.
byte
O caráter local a ser definido. Pode ser especificado da mesma forma
como um operador character da diretiva char exceto que as formas
específicas de Unicode (\u,\U,\<) não podem ser utilizados.
dots
A representação braille do carácter local. Pode ser especificado da
mesma forma como operando dots da directiva char.
include file # comment
Use a diretiva include para incluir o conteúdo de um texto subtabelado.
Ele é recursivo, o que significa que qualquer texto subtabelado pode-se
incluir ainda em outro texto subtabela. Cuidados devem ser tomados para
garantir que "include loop" não seja criado.
file
O arquivo a ser incluído. Pode ser um relativo ou um caminho absoluto.
Se relativo, ele está ancorada no diretório contendo o arquivo incluido.
6.2 Tabela de Atributos
Os arquivos com nomes no formato *.atb são tabelas de atributos, e com
nomes no formato *.ati são atributos subtabelas. Eles são usados quando
BRLTTY é mostrado na tela de atributos e não o conteúdo da tela (veja o
comando DISPMD). Cada um dos oito pontos braille representa um dos oito
bits de atributo VGA.
Os seguintes atributos são fornecidas:
attributes
A coluna da esquerda representa as cores de primeiro plano:
Dot 1 Red
Dot 2 Green
Dot 3 Blue
Dot 7 Bright
A coluna do lado direito representa as cores de fundo:
Dot 4 Red
Dot 5 Green
Dot 6 Blue
Dot 8 Blink
Um ponto é levantado quando o bit de atributo correspondente está
ligado. Este é o padrão da tabela de atributos, pois é a mais intuitiva.
Um dos seus problemas, porém, é que é difícil discernir a diferença
entre normal (branco sobre fundo preto) e inversa (preto sobre fundo
branco) vídeo.
attrib
A coluna da esquerda representa as cores de primeiro plano:
Dot 1 Red
Dot 2 Green
Dot 3 Blue
Dot 7 Bright
A coluna do lado direito representa as cores de fundo:
Dot 4 Red
Dot 5 Green
Dot 6 Blue
Dot 8 Blink
Um bit de fundo desencadeará seus pontos correspondentes, enquanto que
um bit de primeiro plano desencadeará seus correspondentes pontos. Essa
lógica intuitiva realmente torna mais fácil de ler as combinações de
atributos mais comumente usados.
Veja a opção de linha de comando -a, a diretiva de arquivo de
configuração attributes-tables, e a opção de criação --with-attributes-
table para obter detalhes sobre como usar uma tabela de atributos
alternativos.
6.2.1 Tabela de Formatos dos Atributos
Uma tabela de atributos consiste em uma seqüência de diretivas, um por
linha, que definem como as combinações de atributos VGA estão sendo
representados em braile. Caracteres UTF-8 devem ser utilizados. O espaço
em branco (espaços, tabs) no início de uma linha, assim como antes e/ou
após qualquer operando de qualquer diretiva, é ignorado. Linhas que
contêm apenas espaço em branco são ignoradas. Se o caráter não-espaço em
branco antes de uma linha for "#" então essa linha é um comentário e é
ignorado.
6.2.2 Tabela de Diretórios dos Atributos
As seguintes diretivas são fornecidas:
dot dot state # comment
Use a diretiva dot para especificar o que um determinado ponto
representa.
dot
O ponto a ser definido. É um único dígito no intervalo 1-8, tal como
definido pela Standard Braille Dot Numbering Convention.
state
O que o ponto representa. Pode ser:
=attribute
O ponto é levantado se o atributo nome está on.
~attribute
O ponto é levantado se o atributo nome está off.
Os nomes dos bits de atributo são:
0X01 fg-blue
0X02 fg-green
0x04 fg-red
0x08 fg-bright
0X10 bg-blue
0x20 bg-green
0x40 bg-red
0x80 blink
Exemplos:
· dot 1 =fg-red
· dot 2 ~bg-blue
include file # comment
Use a diretiva include para incluir o conteúdo de um atributos
subtabela. Ele é recursivo, o que significa que os atributos subtabela
pode-se incluir ainda em outros atributos subtabela. Cuidados devem ser
tomados para garantir que "include loop" não seja criado.
file
O arquivo a ser incluído. Pode ser um relativo ou um caminho absoluto.
Se relativo, ela está ancorada no diretório contendo o arquivo
incluindo.
6.3 Tabela de Contração
Os arquivos com nomes no formato *.ctb são tabelas de contração, e com
nomes no formato *.cti são subtabelas de contração. Eles são usados pelo
BRLTTY para traduzir as seqüências de caracteres na tela em suas
respectivas representações contração em braille.
BRLTTY apresenta contração em braille se:
· A tabela de contração foi selecionada. Consulte a opção de linha
de comando -c e as diretivas do arquivo de configuração contraction-
table para obter mais detalhes.
· O recurso 6-dot braille foi ativado. Veja o comando SIXDOTS e o
Text Style para mais detalhes.
Esse recurso não estará disponível se a opção de construção --disable-
contracted-braille foi especificada.
As seguintes tabelas de contração são fornecidas:
af Afrikaans (contracionado)
am Amharic (não-contracionado)
de-basis German (não-contracionado)
de-kurzschrift German (contracionado - padrão1998)
de-vollschrift German (contrações básicas)
en-ueb-g2 Unified English Braille (grau 2)
en-us-g2 American English (grau 2)
es Spanish (grau 2)
fr-abrege French (contracionado)
fr-integral French (não-contracionado)
ha Hausa (contracionado)
id Indonesian (contracionado)
já Japanese (não-contracionado)
ko-g1 Korean (grau 1)
ko-g2 Korean (grau 2)
ko Korean (não-contracionado)
mg Malagasy (contracionado)
mun Munda (contracionado)
nl Dutch (contracionado)
ny Chichewa (contracionado)
ipa International Phonetic Alphabet
pt Portuguese (grau 2)
si Sinhalese (não-contracionado)
sw Swahili (contracionado)
th Thai (contracionado)
zh-tw Taiwanese Chinese (não-contracionado)
zh-tw-ucb Taiwanese Chinese (Unique Chinese Braille)
zu Zulu (contracionado)
Veja a opção de linha de comando -c, e as diretivas do arquivo de
configuração contraction-table para obter detalhes sobre como usar uma
tabela de contração.
6.3.1 Tabela de Formato de Contração
Uma tabela de contração consiste de uma seqüência de entradas, uma por
linha, que define como as seqüências de caracteres devem ser
representadas em Braille. Caracteres UTF-8 devem ser usados. O espaço em
branco (espaços, tabs) no início de uma linha, assim como antes e/ou
depois de qualquer operando, é ignorado. Linhas que contêm apenas espaço
em branco são ignoradas. Se o caráter não-espaço em branco antes de uma
linha é "#" então essa linha é um comentário e é ignorado.
O formato de uma entrada na tabela de contração é:
directive operand ... [comment]
Cada diretiva tem um número específico de operandos. Qualquer texto além
do último operando de uma diretiva é interpretado como um comentário. A
ordem das entradas dentro de uma tabela de contração é, em geral, tudo o
que é conveniente para seu mantenedor (s). Uma entrada que define uma
entidade, e.g. class, deve preceder todas as referências a essa
entidade.
Entradas que combinam sequências de caracteres são automaticamente
rearranjadas do maior para o menor, de modo que o maior sempre é
preferível. Se mais uma entrada corresponde a seqüência de caracteres,
então a sua tabela original de ordenação é mantida. Assim, a mesma
seqüência pode ser traduzida de forma diferente em circunstâncias
diferentes.
6.3.2 Tabela de Operandos de Contração
characters
O primeiro operando de uma seqüência de caracteres correspondente as
diretivas e a seqüência de caracteres a ser correspondida. Cada carácter
dentro da seqüência pode ser:
· Qualquer caracter único que não seja uma barra-invertida ou um
carácter de espaço em branco.
· Um caracter especial prefixado de barra-invertida. São eles:
\b
Carácter de retrocesso.
\f
Carácter formfeed (quebra de página).
\n
Carácter de nova linha.
\o###
Representação de um carácter de três dígitos octal.
\r
Carácter de retorno de transporte.
\s
Carácter de espaço.
\t
Carácter de tab horizontal.
\u####
Representação de um carácter hexadecimal de quatro dígito.
\U########
Representação de um carácter hexadecimal de oito dígito.
\v
Carácter de tab horizontal.
\x##
Representação de um carácter hexadecimal de dois dígitos.
\X##
(o caso do X e dos dígitos não é significativa).
\#
Um sinal de número literal.
\<name>
O nome Unicode de um carácter(use _ para espaço).
\\
Uma barra-invertida literal.
representation
O segundo operando dessa seqüência de caracteres correspondentes a
diretivas que tem uma representação braille da seqüência. Cada célula
braille é especificada como uma seqüência de 1-8 números de pontos. Um
número de ponto é um dígito dentro do intervalo 1-8, tal como definido
pela Standard Braille Dot Numbering Convention. O número de ponto
especial 0, que não pode ser usado em conjunto com qualquer outro número
de pontos, significa que não há pontos.
6.3.3 Opcodes
Um opcode é uma palavra-chave que diz o tradutor como interpretar os
operandos. Os opcodes são agrupados aqui por função.
6.3.3.1 Administração de Tabela
Estes opcodes torna mais fácil de escrever as tabelas contração. Eles
não têm nenhum efeito direto sobre a tradução de caracteres.
include path
Incluir o conteúdo de outro arquivo. Codificação pode ser em qualquer
profundidade. Os caminhos relativos são ancorados no diretório do
arquivo incluído.
locale locale
Define a localidade para a interpretação de carácteres (letras
minúsculas, maiúsculas, números, etc.) O local pode ser especificado
como:
language[_country][.charset][@modifier]
O componente language é necessário e deverá ser um código de duas letras
para línguas no padrão ISO-639. O componente country é opcional e deverá
ser um código de duas letras no padrão ISO-3166. O componente charset é
opcional e deve ser um nome de conjunto de caracteres, e.g. ISO-8859-1.
C
7-bit ASCII.
-
Sem localidade.
A última especificação de localidade se aplica à tabela inteira. Se este
opcode não for usado, a localidade C é assumida.
6.3.3.2 Definição de símbolo especial
Estes opcodes definem símbolos especiais que devem ser inseridos no
texto em braile, a fim de esclarecê-lo.
capsign dots
O símbolo que capitaliza uma única letra.
begcaps dots
O símbolo que se inicia um bloco de letras maiúsculas em uma
palavra.
endcaps dots
O símbolo que termina um bloco de letras maiúsculas em uma palavra.
letsign dots
O símbolo que marca uma carta que não faz parte de uma palavra.
numsign dots
O símbolo que marca o início de um número.
6.3.3.3 Tradução de Carácter
Estes opcodes definem as representações braille para sequências de
carácteres. Cada um deles define uma entrada na tabela de contração.
Essas entradas podem ser definidas em qualquer ordem, exceto, como
indicado abaixo, quando definem representações alternativas para a
seqüência da mesma natureza.
Cada um desses opcodes possui um carácter operando (que deve ser
especificado como uma string), e uma condição embutida que regem a sua
elegibilidade para o uso. O texto é processado estritamente de esquerda
para a direita, caractere por caractere, com a entrada mais elegível
para cada posição a ser utilizada. Se houver mais de uma entrada
elegível para uma determinada posição, então aquele com a maior cadeia
de caractere é usado. Se houver mais de uma entrada elegível para a
mesma string de caracteres, então a uma definição mais próxima do início
da tabela é usada (isso é a dependência de ordem única).
Muitos desses opcodes têm um dot operando que define a representação
braille para seu operando characters. Também pode ser especificado como
um sinal de igual (=), caso em que significa uma de duas coisas. Se a
entrada é para um único carácter, então isso significa que a atual
representação braille selecionada no computador (ver a opção de linha de
comando -t e a diretiva text-table do arquivo de configuração) para que
o caráter é para ser usado. Se é para uma seqüência de multi-caráteres,
então a representação padrão para cada caracter (veja always) dentro da
seqüência deve ser usada.
Alguns termos especiais são usados nas descrições desses opcodes.
word
Uma seqüência máxima de uma ou mais letras consecutivas.
Agora, finalmente, aqui está a descrição opcode:
literal characters
Traduz toda a seqüência de caracteres delimitada por espaço em
branco no braille do computador (ver a opção de linha de comando -t
e a diretiva text-table do arquivo de configuração).
replace characters characters
Substitui o primeiro conjunto de caracteres, não importa onde eles
aparecem, com a segunda. Os carácteres substituídos não são
reprocessado.
always characters dots
Traduz os carácteres, não importa onde eles aparecem. Se há apenas
um carácter, então, além disso, defini a representação padrão para
esse carácter.
repeatable characters dots
Traduz os carácteres, não importa onde eles aparecem. Ignora
quaisquer repetições consecutivas da mesma sequência.
largesign characters dots
Traduz os personagens, não importa onde eles aparecem. Retira os
espaço em branco entre as palavras consecutivas acompanhado por
este opcode.
lastlargesign characters dots
Traduz os carácteres, não importa onde eles aparecem. Remove o
espaço em branco anterior se a palavra anterior foi acompanhado
pelo opcode largesign.
word characters dots
Traduz os carácteres se eles são uma palavra.
joinword characters dots
Traduz os carácteres se eles são uma palavra. Remove o seguinte
espaço em branco se o primeiro caractere depois é uma letra.
lowword characters dots
Traduz os carácteres se eles são uma palavra delimitada branco-
espaço.
contraction characters
Prefixa os carácteres com um sinal de letra (veja letsign) se eles
são uma palavra.
sufword characters dots
Traduz os carácteres se eles são uma palavra ou no início de uma
palavra.
prfword characters dots
Traduz os carácteres se eles são uma palavra ou no final de uma
palavra.
begword characters dots
Traduz os carácteres se eles estão no início de uma palavra.
begmidword characters dots
Traduz os carácteres se eles estão ou no início ou no meio de uma
palavra.
midword characters dots
Traduz os carácteres se eles estão no meio de uma palavra.
midendword characters dots
Traduz os carácteres se eles estão ou no meio ou no final de uma
palavra.
endword characters dots
Traduz os carácteres se eles estão no final de uma palavra.
prepunc characters dots
Traduz os carácteres se eles são parte da pontuação no início de
uma palavra.
postpunc characters dots
Traduz os carácteres se eles são parte da pontuação no final de uma
palavra.
begnum characters dots
Traduz os carácteres se eles estão no início de um número.
midnum characters dots
Traduz os carácteres se eles estão no meio de um número.
endnum characters dots
Traduz os carácteres se eles estão no final de um número.
6.3.3.4 Classes de Caracteres
Estes opcodes definem e usam classes de carácteres. Uma classe de
caracteres associa um conjunto de carácteres com um nome. O nome, em
seguida, refere-se a qualquer carácter dentro da classe. Um carácter
pode pertencer a mais de uma classe.
As classes de carácteres a seguir são automaticamente pré-definicadas
com base na localidade selecionada:
digit
Carácteres numéricos.
letter
Ambas os caracteres maiúsculos e minúsculos do alfabeto. Algumas
localidades têm letras adicionais que não são nem maiúsculas nem
minúsculas.
lowercase
Carácteres do alfabeto em minúsculo.
punctuation
Carácteres impresso que não são nem espaço em branco e nem
alfanuméricos.
space
Caracteres espaço em branco. Na localidade padrão, esses são:
espaço, tabulações horizontal e vertical, de retorno de carro, a
nova linha, formfeed(quebra de página).
uppercase
Carácteres do alfabeto em maiúsculo.
Os opcodes que definem e usam as classes de carácteres são:
class name characters
Defini uma nova classe de carácter. Os carácteres operando devem
ser especificados como uma string. Uma classe de caracter não pode
ser utilizada até que ela seja definida.
after class opcode ...
O opcode especificado é mais restrito na seqüência de caracteres
correspondente e deve ser imediatamente precedido por um carácter
que pertence à classe especificada. Se este opcode é usado mais de
uma vez na mesma linha, então a união dos caracteres em todas as
classes é usada.
before class opcode ...
O opcode especificado é mais restrito na seqüência de caracteres
correspondente e deve ser imediatamente seguido por um carácter que
pertence à classe especificada. Se este opcode é usado mais de uma
vez na mesma linha, então a união dos caracteres em todas as
classes é usada.
6.4 Tabelas de Teclas
Os arquivos com nomes no formato *. ktb são tabelas chaves, e com nomes
no formato *. kti são subtabelas chaves. Eles são usados por BRLTTY para
vincular ao display braille e ao teclado combinações de teclas para
comandos do BRLTTY.
Os nomes dos display braille nos arquivos de tabela chaves começam com
brl-xx-, onde xx é o código de duas letras de identificação do
driver(driver identification code). O resto do nome identifica o modelo
(s) para os quais a tabela chave é usada.
Os nomes dos teclados nos arquivos de tabela chaves começam com kbd-. O
resto do nome descreve o tipo de teclado para qual a tabela chaves foi
concebido.
Os seguintes teclados de tabela chaves são fornecidos:
kbd-desktop
ligações para teclado completo
kbd-keypad
ligações para navegação baseado em teclado numérico
kbd-laptop
ligações para teclados sem um teclado númerico
Consulte a opção de linha de comando -k e a directiva do arquivo de
configuração key-table para obter detalhes sobre como selecionar uma
tabela chaves do teclado.
6.4.1 Tabela de Diretivas de Teclas
Uma tabela chaves consiste em uma seqüência de diretivas, uma por linha,
que definem como as teclas e combinações de teclas devem ser
interpretadas. UTF-8 caracter encoding deve ser usado. O espaço em
branco (espaços, tabs) no início de uma linha, assim como antes e/ou
depois de qualquer operando, é ignorado. Linhas que contêm apenas espaço
em branco são ignoradas. Se o caráter não-espaço em branco antes de uma
linha é um sinal de número (#) então essa linha é um comentário e é
ignorada.
A prioridade para a resolução de cada evento da tecla
pressionada/liberada é a seguinte:
1. Uma hotkey pressionada ou liberação definida dentro do contexto
atual. Veja a diretiva hotkey para mais detalhes.
2. A combinação de teclas definida dentro do contexto atual.
Consulte a diretiva bind para detalhes.
3. Um comando do teclado braille definido dentro do contexto atual.
Veja as directivas map e superimpose para mais detalhes.
4. A combinação de teclas definida dentro do contexto padrão.
Consulte a diretiva bind para detalhes.
As diretrizes a seguir são fornecidas:
6.4.1.1 Atribuir Diretiva
Criar ou atualizar uma variável associada com o atual nível de incluir.
A variável é visível para o atual e incluem os níveis mais baixos, mas
não incluem os níveis mais elevados.
assign variable [value]
variable
O nome da variável. Se a variável não existir no atual nível de
incluir então ela é criada.
value
O valor que será atribuído à variável. Se não for fornecido, então
um valor de comprimento zero (nulo) é atribuído.
A seqüência de escape \{variable} é substituída com o valor da variável
chamada dentro das chaves. A variável deve ter sido definida no atual ou
um nível de incluir superior.
Exemplos:
· assign nullValue
· assign ReturnKey Key1
· bind \{ReturnKey} RETURN
6.4.1.2 Diretiva de vínculo
Define quais comandos BRLTTY é executado quando uma combinação
específica de uma ou mais teclas é pressionada. A ligação é definida
dentro do contexto atual.
bind keys command
keys
A combinação de teclas que será vinculada. É uma seqüência de um ou mais
nomes de chaves separadas pelo sinal de mais (+). O nome da chave
final(ou única) pode ser opcionalmente prefixado com um ponto de
exclamação (!). As chaves podem ser pressionadas em qualquer ordem, com
a ressalva de que se o nome da chave final é prefixado com um ponto de
exclamação em seguida, ele deve ser pressionado por último. O prefixo do
ponto de exclamação significa que o comando é executado assim que a
tecla é pressionada. Se não for utilizado, o comando é executado assim
que qualquer uma das teclas é liberada.
command
O nome de um comando BRLTTY. Um ou mais modificadores podem ser
opcionalmente anexado ao nome do comando, usando um sinal positivo (+)
como separador.
Para comandos que ativa/desativa o recurso:
? Se o modificador +on for especificado, o recurso está habilitado.
? Se o modificador +off é especificada, o recurso está desativado.
? Se nem +on ou +off é especificado, o estado do recurso é
ativado/desativado.
Para comandos que mover a janela braille:
? Se o modificador +route é especificado, então, se necessário, o
cursor é automaticamente encaminhado para que fique sempre visível
no display braille.
Para comandos que move a janela braille para uma linha específica na
tela:
? Se o modificador +toleft for especificado, a janela de braile
também é movida para o início dessa linha.
? Se o modificador +scaled é especificado, o conjunto de chaves
vinculadas ao comando é interpretado como se fosse uma barra de
rolagem. Se não for, então não há uma correspondência de um-para-um
entre as teclas e linhas.
Para comandos que exigem um deslocamento:
O modificador +offset, onde offset é um número inteiro não negativo,
pode ser especificado. Se não for fornecido, então +0 é assumido.
Exemplos:
? bind Key1 CSRTRK
? bind Key1+Key2 CSRTRK+off
? bind Key1+Key3 CSRTRK+on
? bind Key4 TOP
? bind Key5 TOP+route
? bind VerticalSensor GOTOLINE+toleft+scaled
? bind Key6 CONTEXT+1
6.4.1.3 Diretiva de Contexto
Definir formas alternativas de interpretar certos acontecimentos-chave
e/ou combinações. Um contexto contém as definições criadas pelas
directivas bind, hotkey, map, e superimpose.
context identifier [title]
identifier
Qual a definição posterior do contexto deve ser criada dentro. Podem
ser:
· Um desses nomes especiais:
default
O contexto padrão. Se a combinação de teclas não foi definida dentro do
contexto atual, então a sua definição no contexto padrão é usado. Isso
só se aplica as definições criadas pela diretiva de vinculo.
menu
Esse contexto é utilizado quando dentro do menu de preferências do
BRLTTY.
· Um número inteiro no intervalo de 0 a 252. Contexto 0 é uma
maneira alternativa para se referir ao contexto padrão. Os números
mais altos de contexto devem ser evitados porque o maior número
permitido está sujeito a alteração sem aviso prévio, se, por
exemplo, os contextos mais nomeados são adicionados.
title
Uma descrição person-readable do contexto. Ele pode conter espaços, e as
convenções de capitalização padrão deve ser usado. Este operando é
opcional. Se for fornecido ao selecionar um contexto que já tem um
título, então os dois devem coincidir.Contextos nomeado já tem títulos
internamente atribuídos. Contextos numéricos são inicialmente criados
sem títulos.
Um contexto é criado a primeira vez que ele é selecionado. Pode ser re-
selecionado qualquer número de vezes depois disso.
Todas as definições subseqüentes até a próxima diretiva context ou no
final do corrente nível de incluir são criadas dentro do contexto
selecionado. O contexto inicial de nível superior da tabela chave é
padrão. O contexto inicial incluído em uma subtabela chave é o contexto
que foi selecionado quando ele foi incluído. Contextos de mudanças
incluídos dentro de subtabelas chaves não afetam o contexto da mesa,
incluindo tabela chave ou subtabela.
Se um contexto tem um título (todos os contextos nomeados e os contextos
numérico para o qual o operando title foi fornecido), então é
persistente*. Quando um evento-chave faz com um contexto de persistência
ser ativado, esse contexto atual permanece até que um evento posterior
chave faz um contexto diferente persistente ser ativado.
Se um contexto não tem um título (os contextos numéricos para os quais o
operando title não foi fornecido), então ele é temporário. Quando um
evento chave provoca um contexto temporário a ser ativado, esse contexto
só é usado para interpretar o evento chave mais próximo.
Exemplos:
· context menu
· context 1 Braille Input
· context 2
6.4.1.4 Directiva de Ocultar
Especifica se deseja ou não certas definições (ver as diretivas, hotkey,
map, e superimpose) e notas (ver a diretiva note) serão incluídas no
texto da tabela de chave de ajuda.
hide state
state
Uma dessas palavras-chaves:
on
Estão excluídos.
off
Eles estão incluídos.
O estado especificado se aplica as todas as definições e notas
subseqüentes até a próxima diretiva hide ou o fim do atual nível de
incluir. O estado inicial da tabela chave de nível superior é off. O
estado inicial incluído em uma subtabela chave é o estado que foi
selecionado quando ele foi incluído. Mudanças de estado incluídos dentro
de uma subtabelas chave não afetam o estado incluindo na tabela chave ou
subtabela.
Exemplo:
· hide on
6.4.1.5 Diretiva de Hotkey
Vincula os eventos press e release de uma tecla específica para dois
comandos separados BRLTTY. Os vinculos são definidas dentro do contexto
atual.
hotkey key press release
key
O nome da tecla que será limitada.
press
O nome do comando BRLTTY que deve ser executado sempre que a tecla
é pressionada.
release
O nome do comando BRLTTY que deve ser executado sempre que a tecla
é liberada.
Modificadores podem ser acrescentados aos nomes de comando. Veja o
operando command da diretiva bind para mais detalhes.
Especifique NOOP se nenhum comando será executado. Especificando NOOP
para ambos os comandos efetivamente desativa a chave.
Exemplos:
· hotkey Key1 CSRVIS+off CSRVIS+on
· hotkey Key2 NOOP NOOP
6.4.1.6 Diretiva IfKey
Condicionalmente processo uma diretiva da tabela chave somente se o
aparelho tem uma chave particular.
ifkey key directive
key
O nome da chave, cuja disponibilidade está a ser testado.
directive
A diretiva da tabela chave que deve ser condicionalmente processado.
Exemplos:
· ifkey Key1 ifkey Key2 bind Key1+Key2 HOME
6.4.1.7 Diretiva Include
Processa as diretivas dentro de uma subtabela chave. É recursiva, o que
significa que qualquer subtabela chave pode ser incluir ainda em outra
subtabela chave. Cuidados devem ser tomados para garantir que "incluem
loop" não seja criado.
include file
file
A subtabela chave que será incluída. Pode ser um caminho relativo
ou absoluto. Se relativo está ancorado no diretório que contém a
incluindo a tabela chave ou subtabela.
Exemplos:
? include common.kti
? include /path/to/my/keys.kti
6.4.1.8 Diretiva de Mapa
Mapeia uma tecla para uma função do teclado em braille. O mapeamento é
definido dentro do contexto atual.
map key function
key
O nome da tecla que será mapeada. Mais de uma tecla pode ser
mapeada para a mesma função teclado em braille.
function
O nome da função do teclado em braille. Pode ser uma das seguintes
palavras:
DOT1
O padrão braille do ponto superior esquerdo.
DOT2
O padrão braille do ponto do meio esquerdo.
DOT3
O padrão braille do ponto inferior esquerdo.
DOT4
O padrão braille do ponto superior direito.
DOT5
O padrão braille do ponto do meio direito.
DOT6
O padrão braille do ponto inferior direito.
DOT7
O ponto braille do computador inferior esquerdo.
DOT8
O ponto braille do computador inferior direito.
SPACE
A barra de espaço.
SHIFT
A tecla shift.
UPPERCASE
Se uma letra minúscula está sendo inserido então traduzi para seu
equivalente em maiúsculas.
CONTROLE
A chave de controle.
META
A tecla Alt esquerda.
Se a combinação de teclas consiste apenas de chaves que foram mapeadas
para funções do teclado em braile, e se essas funções quando combinadas
formam um comando de teclado braille válido, então o comando é executado
logo que qualquer uma das teclas é liberado. Um comando de teclado
braille válido deve incluir ou qualquer combinação dos pontos chaves ou
a barra de espaço (mas não ambos). Se pelo menos um ponto chave é
incluído, então as funções do teclado em braille especificados pelas
diretivas superimpose dentro do mesmo contexto também estão
implicitamente incluídos.
Exemplos:
· map Key1 DOT1
6.4.1.9 Diretiva Note
Adiciona uma explicação person-readable para o texto de ajuda da tabela
chaves. As notas são usadas, por exemplo, para descrever o
posicionamento, tamanhos e formas das teclas do dispositivo.
note text
text
A explicação que será adicionada. Ele pode conter espaços, e deve
ser gramaticalmente correta.
Cada nota especifica exatamente uma linha de texto explicativo. espaço à
esquerda é tão ignorado recuo não pode ser especificado.
Não há limite para o número de notas que podem ser especificadas. Todos
eles estão reunidos e apresentados em um único bloco no início do texto
de ajuda da tabela chaves.
Exemplo:
note Key1 is the round key at the far left on the front surface.
6.4.1.10 Diretiva de sobreposição
Inclui implicitamente uma função do teclado sempre que um comando de
teclado braille consiste em pelo menos um dot é executado. A inclusão
implícita é definida dentro do contexto atual. Qualquer número deles
pode ser especificado.
superimpose function
function
O nome da função do teclado braille. Veja o operando function da
diretiva map para detalhes.
Exemplo:
superimpose DOT7
6.4.1.11 Diretiva Title
Apresenta um resumo person-readable do propósito das tabelas chaves
title text
text
Um resumo de uma linha de como a tabela chave é usado. Ele pode
conter espaço, e as convenções de capitalização padrão deve ser
usado.
O título da tabela chave pode ser especificado apenas uma vez.
Exemplo:
title Bindings for Keypad-based Navigation
6.4.2 Propriedades do Teclado
O padrão é que todos os teclados são monitorados. Um subconjunto de
teclados pode ser selecionado por uma ou mais propriedades seguintes
(veja a opção de linha de comando –K, e a diretiva do arquivo de
configuração keyboard-properties).
type
O tipo de barramento, especificado com uma das seguintes palavras-
chaves: any, ps2, usb, Bluetooth
vendor
Identificação do vendedor, especificado com um inteiro de 16-bits não
sinalizado.
product
Identificação do produto, especificado com um inteiro de 16-bits não
sinalizado.
Os identificadores vendor e product podem ser especificados em notação
decimal (sem prefixo), octal( prefixado por 0), ou hexadecimal
(prefixado por 0x). Especificando 0 significa corresponder a qualquer
valor (como se a propriedade não foi especificada).
7. Tópicos Avançados
7.1 Instalação de múltiplas versões
É fácil ter mais de uma versão do BRLTTY instalado no mesmo sistema ao
mesmo tempo. Esse recurso permite que você teste uma nova versão antes
de remover o antigo.
A opção de compilação --with-execute-root permite que você instale a
hierarquia de arquivo em qualquer lugar que você deseja. Lembrando que é
melhor para manter todos os componentes BRLTTY dentro do sistema de
arquivos root, você pode compila-los assim:
. /configure --with-execute-root =/brltty-3.1
make install
Você pode executá-lo assim:
/brltty-3.1/bin/brltty
Quando a versão 3.2 é liberado, basta instalá-lo em um local diferente e
executar o novo arquivo executável a partir daí.
. /configure --with-execute-root =/brltty-3.2
make install
/brltty-3.2/bin/brltty
Até agora, este paradigma é um pouco estranho, pelo menos, duas razões.
Uma desses nomes é muito difícil de escrever, e o outro é que você não
quer mexer com a seqüência de inicialização do sistema cada vez que você
quiser mudar para uma versão diferente do BRLTTY. Estes problemas são
facilmente resolvidos adicionando um link simbólico para o executável.
ln-s /brltty-3.1/bin/brltty /bin/brltty
Quando é hora de mudar para a nova versão, apenas o link repoint
symbolc.
ln-s /brltty-3.2/bin/brltty /bin/brltty
Se você quiser ficar realmente, então inicie um outro nível de indireção
para fazer todos os arquivos BRLTTY para qualquer versão que eles estão
em todos os locais padrão. Primeiro, crie um link simbólico através de
um local comum repointable de cada uma das localizações padrão de
BRLTTY.
ln -s /brltty/bin/brltty /bin/brltty
ln -s /brltty/etc/brltty /etc/brltty
ln -s brltty /lib/brltty /lib/brltty
Então, tudo que você precisa fazer é apontar /brltty a versão desejada.
ln -s /brltty-3.1 /brltty
7.2 Instalação/Ajuda dos Discos de root para o Linux
BRLTTY pode funcionar como um executável autônomo. Tudo o que ele
precisa saber pode ser explicitamente configurado em tempo de compilação
(veja Opções de Compilação). Se o diretório de dados (ver na opção de
compilação --with-data-directory e --with-execute-root) não existir,
então BRLTTY olha em /etc para os arquivos que ele necessita. Mesmo que
nenhum destes arquivos não existem, BRLTTY ainda funciona!
Se, por alguma razão, você já criou o diretório de dados (normalmente
/etc/brltty), é importante definir suas permissões para que somente o
root possa criar arquivos dentro dela.
chmod 755 /etc/brltty
A tela do aparelho de inspeção de conteúdo (normalmente /dev/vcsa) é
necessária. Ela já deve existir a menos que sua distribuição do Linux é
bastante antiga. Se necessário, você pode criá-lo com:
mknod /dev/vcsa c 7 128
chmod 660 /dev/vcsa
chown root.tty /dev/vcsa
Um problema freqüentemente encontrado ao tentar usar BRLTTY em um
ambiente incerto como um disco de root ou de um sistema incompleto é que
ela não pôde encontrar as bibliotecas compartilhadas (ou partes) de que
necessita. Discos de root costumam usar subconjunto e/ou versões
desatualizadas das bibliotecas que podem ser inadequados. A solução é
configurar BRLTTY com a opção --enable-standalone-programs. Isso remove
todas as dependências de bibliotecas compartilhadas, mas, infelizmente,
também cria um arquivo executável maior. Há uma série de opções de
compilação que pode ser usado para remover de recursos desnecessários do
BRLTTY, a fim de atenuar um pouco esse problema (ver Build Features).
O executável é eliminado durante o make install. Isto reduz
significativamente o seu tamanho retirando sua tabela de símbolo. Você
receberá um executável muito menor, portanto, se você concluir o
processo de compilação completo, e depois copiá-lo de seu local
instalado. Se, no entanto, copiá-lo do diretório de compilação, vai ser
muito grande. Não se esqueça de tira-lo.
strip brltty
7.3 - Melhorias futuras
Além de corrigir os erros e dar suporte a mais tipos de displays
braille, esperamos, se o tempo permitir, trabalhar sobre o seguinte:
Better Attribute Handling
* Acompanhamento de Atributo.
* Misto de texto e modo de atributo.
Scroll Tracking
Bloquear a janela de uma linha braille já que rola na tela.
Better Speech Support
* Braille mistos e de fala para leitura mais rápida do texto.
* Melhor navegação de speech.
* Mais sintetizadores de voz.
Screen Subregions
Ignorar o movimento do cursor fora da região, e definir limites de
navegação suave nas bordas da região.
Veja o arquivo TODO para uma lista mais completa.
7.4 Bugs conhecidos
No momento da escrita (dezembro 2001), os seguintes problemas são
conhecidos:
Cursor de roteamento é implementado como um looping do sub-processo que
corre na prioridade reduzida para evitar o uso de muito tempo de CPU. Os
diferentes sistemas que é carregado requer diferentes configurações de
seus parâmetros. Os padrões funcionam muito bem em um editor de Unix
típico de um sistema bastante leve, mas muito pobre em algumas outras
situações, por exemplo, em um link lento de série para um host remoto.
Apêndice:
A. Display Braille Suportados
BRLTTY suporta os seguintes displays braille:
B. Sintetizadores de Fala Suportados:
BRLTTY suporta os seguintes sintetizadores de fala:
Nome Modelos
____________________________________________________________
Alva Delphi (4nn)
BrailleLite
CombiBraille
eSpeak text to speech engine
ExternalSpeech runs /usr/local/bin/externalspeech
Festival text to speech engine
FestivalLite text to speech engine
GenericSay pipes to /usr/local/bin/say
Mikropuhe text to speech engine
Swift text to speech engine
Theta text to speech engine
ViaVoice text to speech engine
C – Código de Identificação de Driver
Código
Nome
al
Alva
at
Albatross
ba
BrlAPI
bl
BrailleLite
bm
Baum (Native, HT, PB1, PB2)
bn
BrailleNote
cb
CombiBraille
ec
EcoBraille
es
eSpeak
eu
EuroBraille
fl
FestivalLite
fs
FreedomScientific
fv
Festival
gs
GenericSay
hm
HIMS
ht
HandyTech
il
IrisLinux
lb
Libbraille
lt
LogText
mb
MultiBraille
md
MDV
mn
MiniBraille
mp
Mikropuhe
mt
Metec
no
no driver
pg
Pegasus
pm
Papenmeier
sd
SpeechDispatcher
sk
Seika
sw
Swift
th
Theta
ts
Telesensory Systems Inc.
tt
TTY
vd
VideoBraille
vo
Voyager
vr
Virtual
vs
VisioBraille
vv
ViaVoice
xs
ExternalSpeech
xw
XWindow
D. Drivers de Tela Suportados
BRLTTY suporta os seguintes drivers de tela:
as AT-SPI
hd
Este driver fornece um acesso direto para a tela do console Hurd. É só
selecionar a opção padrão do sistema Hurd.
Name Models
_____________________________________________________________
Albatross 46/80
Alva ABT (3nn)
Delphi (4nn)
Satellite (5nn)
Braille System 40
Braille Controller 640/680
Baum Inka
Vario/RBT
SuperVario/Brailliant
PocketVario
VarioPro
EcoVario
VarioConnect/BrailleConnect
Refreshabraille
BrailComm III
BrailleLite 18/40/M20/M40
BrailleNote 18/32
BrlAPI
CombiBraille 25/45/85
EcoBraille 20/40/80
EuroBraille AzerBraille
Clio
Iris
NoteBraille
Scriba
Esys 12/40
FreedomScientific Focus 1 44/70/84
Focus 2 40/80
Focus Blue 40
PAC Mate 20/40
HandyTech Modular 20/40/80
Modular Evolution 64/88
Active Braille
Braille Wave
Easy Braille
Braille Star 40/80
Bookworm
Braillino
HIMS Braille Sense
SyncBraille
Libbraille
LogText 32
MDV MB208/MB408L/MB408S (protocol 5)
Metec BD-40
MiniBraille 20
MultiBraille MB125CR/MB145CR/MB185CR
Papenmeier Compact 486
Compact/Tiny
IB 80 CR Soft
2D Lite (plus)
2D Screen Soft
EL 80
EL 2D 40/66/80
EL 40/66/70/80 S
EL 2D 80 S
EL 40 P
EL 80 II
Elba 20/32
Trio 40/Elba20/Elba32
Pegasus 20/27/40/80
Seika 40
TSI Navigator 20/40/80
PowerBraille 40/65/80
TTY terminfo
VideoBraille 40
Virtual TCP/Unix, client/server
VisioBraille 20/40
Voyager 44/70
Part232 (serial adapter)
BraillePen/EasyLink
XWindow X11
Windows
Code Name
____________________________________________________
al Alva
at Albatross
ba BrlAPI
bc BrailComm
bl BrailleLite
bm Baum (Native, HT, PB1, PB2)
bn BrailleNote
cb CombiBraille
ec EcoBraille
es eSpeak
eu EuroBraille
fl FestivalLite
fs FreedomScientific
fv Festival
gs GenericSay
hm HIMS
ht HandyTech
il IrisLinux
lb Libbraille
lt LogText
mb MultiBraille
md MDV
mn MiniBraille
mp Mikropuhe
mt Metec
no no driver
pg Pegasus
pm Papenmeier
sd SpeechDispatcher
sk Seika
sw Swift
th Theta
ts Telesensory Systems Inc.
tt TTY
vd VideoBraille
vo Voyager
vr Virtual
vs VisioBraille
vv ViaVoice
xs ExternalSpeech
xw XWindow
lx Este driver fornece um acesso direto no console do Linux. É só
selecionar a opção padrão do sistema Linux.
sc Este driver fornece um acesso direto na tela do programa. Selecione
todos os sistemas, na opção padrão se o driver de tela nativo é
disponível. O caminho da tela que nós fornecemos (ver Subdiretório
de Caminhos) deverá ser aplicado. Usado neste driver junto com o
fato da tela deverá ser rodada concorrentemente, o BRLTTY faz o uso
efetivo apenas depois do usuário ter logado.
wn Este driver fornece um acesso direto com o console do Windows. É só
selecionado a opção padrão em Windows/Cygwin systems.
E. Sintaxe de Operação
E.1. Especificação do Driver
Um display braille ou um driver sintetizador de fala deverá ser especificado com
duas letras “código de identificação de driver”.
Uma virgula delimita a lista de drivers especificada. Se isto está feito então a
autodetecção é feita usando cada lista de drivers em seqüência. Você deverá
precisar experimentar na ordem determinada como mais confiável quando alguns
drivers autodetectados forem melhores que os outros.
Se uma única palavra auto é especificada quando a autodetecção é fornecida
usando apenas aqueles drivers que são conhecidos é confiável nesse propósito.
E.2. Especificação do Dispositivo Braille
Em geral, a especificação do dispositivo Braille (ver linha de comando –d, o
arquivo de configuração “braille-device”, e na compilação a opção “—with-
braille-device”) é qualificada: dado. Para ser compatível com versões
anteriores, se a serial é assumida.
A seguir os tipos de dispositivos são suportados:
Bluetooth
Para o dispositivo bluetooth, especifica bluetooth:address (bt : pode ser
usado). O endereço deverá ser seis pares de dígitos de hexadecimal
separados por dois pontos, e.g. 01:23:45:67:89:AB.
Serial
Para o dispositivo serial, especificado: /path/to/device. A serial é
opcional (para compatibilidade anterior). Se um caminho relativo é dado
enquanto o caminho é anexado em /dev (a localização onde os dispositivos
são definidos no sistema unix). As especificações do dispositivo a seguir
todas se referem para o primeiro dispositivo serial no Linux:
? serial:/dev/ttyS0
? serial:ttyS0
? /dev/ttyS0
? ttyS0
USB
Para o dispositivo USB, especificado USB: o BRLTTY será procurado pelo
primeiro dispositivo USB que foi marcado pelo driver do display braille
que está sendo usado. Se isto é inadequado, e.g. se você tem mais de um
display braille USB que requer um mesmo driver, então você pode refinar a
especificação do dispositivo por numero de serial visível no display, e.g.
usb:12345. N.B.: A característica de identificação do numero serial” não
funciona em alguns modelos por causa de alguns fabricantes não setarem o
numero serial USB em todos ou setam mais não com um único valor.
A virgula delimita a lista de dispositivos braille especificados. Se isso é
feito enquanto a autodeteção é feita em cada lista de dispositivo em seqüência.
Este característica é particularmente usual se você tem um display braille com
mais de uma interface, e.g. ambos uma serial e uma porta USB. No caso é
usualmente melhor a lista de portas USB primeiro, e.g. usb:serial:/dev/ttyS0, de
port. In this case it's usually better to list the USB port first, desde que a
autodeteção tende ser confiavel do que o esperado.
E.3. Especificação do Dispositivo PCM
Na maioria dos casos os dispositivos PCM é um caminho cheio e apropriado para o
dispositivo do sistema. Exceções são:
ALSA
O nome dos argumentos são dispositivos físicos e lógicos i.e.
name[:argument,...].
O dispositivo PCM padrão é:
Plataforma Dispositivo
_______________________________________________________
FreeBSD /dev/dsp
Linux/ALSA hw:0,0
Linux/OSS /dev/dsp
NetBSD /dev/audio
OpenBSD /dev/audio
Qnx preferred PCM output device
Solaris /dev/audio
E.4. Especificação do Dispositivo MIDI
Na maioria dos casos de dispositivos MIDI é um caminho completo e apropriado do
para o dispositivo do sistema. Exceções são:
ALSA
O cliente e porta são separadas por uma virgula, i.e. client:port. Cada um deve
ser especificado como um numero ou como um caso especial de substring do nome.
O dispositivo padrão MIDI é:
Plataforma Dispositivo
____________________________________________________________
Linux/ALSA the first available MIDI output port
Linux/OSS /dev/sequencer
F. Convenção do Padrão Braille para numeração
Um padrão braille de celulas consiste em 6 pontos para alinhados em 3 linhas e 2
colunas. Cada ponto pode ser identificado por os números abaixo:
1 Topo-esquerda (linha 1, coluna 1).
2 Meio-esquerda (linha 2, coluna 1).
3 Fim-esquerda (linha 3, coluna 1).
4 Topo-direita (linha 1, coluna 2).
5 Meio-direita (linha 2, coluna 2).
6 Fim-direita (linha 3, coluna 2).
Display braille tem introduzido 40 linhas no fim.
7 Abaixo-esquerda (linha 4, coluna 1).
8 Abaixo-direita (linha 4, coluna 2).
Talvez a imagem ficará mais facil de entender.
1 o o 4
2 o o 5
3 o o 6
7 o o 8
G. Código Norte-Americano do Padrão Braille
Num Hex Pontos Descrição
+-----------------------------------------------------------------+
| 0 00 [7 4 8] NUL (vazio) |
| 1 01 [7 1 8] SOH (inicio do cabeçalho) |
| 2 02 [7 21 8] STX (inicio do texto) |
| 3 03 [7 14 8] ETX (fim do texto) |
| 4 04 [7 145 8] EOT (fim da transmissão) |
| 5 05 [7 1 5 8] ENQ (pesquisa) |
| 6 06 [7 214 8] ACK (reconhecimento) |
| 7 07 [7 2145 8] BEL (campainha) |
| 8 08 [7 21 5 8] BS (back space) |
| 9 09 [7 2 4 8] HT (tab horizontal) |
| 10 0A [7 2 45 8] LF (linha de avanço) |
| 11 0B [73 1 8] VT (tab vertical) |
| 12 0C [7321 8] FF (forma de avançar) |
| 13 0D [73 14 8] CR (retorno) |
| 14 0E [73 145 8] SO (shift out) |
| 15 0F [73 1 5 8] SI (shift in) |
| 16 10 [73214 8] DLE (data link escape) |
| 17 11 [732145 8] DC1 (direct control 1) |
| 18 12 [7321 5 8] DC2 (direct control 2) |
| 19 13 [732 4 8] DC3 (direct control 3) |
| 20 14 [732 45 8] DC4 (direct control 4) |
| 21 15 [73 1 68] NAK (não reconhecimento) |
| 22 16 [7321 68] SYN (sincronização) |
| 23 17 [7 2 4568] ETB (fim do bloco de texto) |
| 24 18 [73 14 68] CAN (cancela) |
| 25 19 [73 14568] EM (fim do meio) |
| 26 1A [73 1 568] SUB (substituto) |
| 27 1B [7 2 4 68] ESC (escape) |
| 28 1C [7 21 568] FS (arquivo separador) |
| 29 1D [7 214568] GS (grupo separador) |
| 30 1E [7 45 8] RS (gravador separador) |
| 31 1F [7 4568] US (unidade separador) |
| 32 20 [ ] espaço |
| 33 21 [ 32 4 6 ] ponto de exclamação |
| 34 22 [ 5 ] marcação de texto |
| 35 23 [ 3 456 ] simbolo do numero |
| 36 24 [ 214 6 ] simbolo de dolar |
| 37 25 [ 14 6 ] simbolo de porcento |
| 38 26 [ 3214 6 ] ampersand |
| 39 27 [ 3 ] acento agudo |
| 40 28 [ 321 56 ] parenteses esquerdo |
| 4 291 [ 32 456 ) parenteses direito |
| 42 2A [ 1 6 ] asterisco |
| 43 2B [ 3 4 6 ] sinal de mais |
| 44 2C [ 6 ] virgula |
| 45 2D [ 3 6 ] sinal de menos |
| 46 2E [ 4 6 ] ponto |
| 47 2F [ 3 4 ] contra barra |
| 48 30 [ 3 56 ] zero |
| 49 31 [ 2 ] um |
| 50 32 [ 32 ] dois |
| 51 33 [ 2 5 ] três |
| 52 34 [ 2 56 ] quatro |
| 53 35 [ 2 6 ] cinco |
| 54 36 [ 32 5 ] seis |
| 55 37 [ 32 56 ] sete |
| 56 38 [ 32 6 ] oito |
| 57 39 [ 3 5 ] nove |
| 58 3A [ 1 56 ] ponto e virgula |
| 59 3B [ 56 ] dois pontos |
| 60 3C [ 21 6 ] jacaré menos |
| 61 3D [ 321456 ] igual |
| 62 3E [ 3 45 ] jacaré mais |
| 63 3F [ 1456 ] interrogação |
| 64 40 [7 4 ] e comercial |
| 65 41 [7 1 ] maiusculo a |
| 66 42 [7 21 ] maiusculo b |
| 67 43 [7 14 ] maiusculo c |
| 68 44 [7 145 ] maiusculo d |
| 69 45 [7 1 5 ] maiusculo e |
| 70 46 [7 214 ] maiusculo f |
| 71 47 [7 2145 ] maiusculo g |
| 72 48 [7 21 5 ] maiusculo h |
| 73 49 [7 2 4 ] maiusculo i |
| 74 4A [7 2 45 ] maiusculo j |
| 75 4B [73 1 ] maiusculo k |
| 76 4C [7321 ] maiusculo l |
| 77 4D [73 14 ] maiusculo m |
| 78 4E [73 145 ] maiusculo n |
| 79 4F [73 1 5 ] maiusculo o |
| 80 50 [73214 ] maiusculo p |
| 81 51 [732145 ] maiusculo q |
| 82 52 [7321 5 ] maiusculo r |
| 83 53 [732 4 ] maiusculo s |
| 84 54 [732 45 ] maiusculo t |
| 85 55 [73 1 6 ] maiusculo u |
| 86 56 [7321 6 ] maiusculo v |
| 87 57 [7 2 456 ] maiusculo w |
| 88 58 [73 14 6 ] maiusculo x |
| 89 59 [73 1456 ] maiusculo y |
| 90 5A [73 1 56 ] maiusculo z |
| 91 5B [7 2 4 6 ] colchete esquerdo |
| 92 5C [7 21 56 ] barra invertida |
| 93 5D [7 21456 ] colchete direito |
| 94 5E [7 45 ] acento circunflexo |
| 95 5F [ 456 ] sobretraço |
| 96 60 [ 4 ] acento grave |
| 97 61 [ 1 ] minusculo a |
| 98 62 [ 21 ] minusculo b |
| 99 63 [ 14 ] minusculo c |
| 100 64 [ 145 ] minusculo d |
| 101 65 [ 1 5 ] minusculo e |
| 102 66 [ 214 ] minusculo f |
| 103 67 [ 2145 ] minusculo g |
| 104 68 [ 21 5 ] minusculo h |
| 105 69 [ 2 4 ] minusculo i |
| 106 6A [ 2 45 ] minusculo j |
| 107 6B [ 3 1 ] minusculo k |
| 108 6C [ 321 ] minusculo l |
| 109 6D [ 3 14 ] minusculo m |
| 110 6E [ 3 145 ] minusculo n |
| 111 6F [ 3 1 5 ] minusculo o |
| 112 70 [ 3214 ] minusculo p |
| 113 71 [ 32145 ] minusculo q |
| 114 72 [ 321 5 ] minusculo r |
| 115 73 [ 32 4 ] minusculo s |
| 116 74 [ 32 45 ] minusculo t |
| 117 75 [ 3 1 6 ] minusculo u |
| 118 76 [ 321 6 ] minusculo v |
| 119 77 [ 2 456 ] minusculo w |
| 120 78 [ 3 14 6 ] minusculo x |
| 121 79 [ 3 1456 ] minusculo y |
| 122 7A [ 3 1 56 ] minusculo z |
| 123 7B [ 2 4 6 ] chave esquerda |
| 124 7C [ 21 56 ] barra vertical |
| 125 7D [ 21456 ] chave direita |
| 126 7E [ 45 ] acento til |
| 127 7F [7 456 ] DEL (delete) |
| 128 80 [ 4 8] <control> |
| 129 81 [ 1 8] <control> |
| 130 82 [ 21 8] BPH (break permitted here) |
| 131 83 [ 14 8] NBH (no break here) |
| 132 84 [ 145 8] <control> |
| 133 85 [ 1 5 8] NL (proxima linha) |
| 134 86 [ 214 8] SSA (começa a seleção de area) |
| 135 87 [ 2145 8] ESA (fim de seleção de area) |
| 136 88 [ 21 5 8] CTS (seta tabulação de caracter) |
| 137 89 [ 2 4 8] CTJ (justifica tabulação de caracter) |
| 138 8A [ 2 45 8] LTS (seta a tabulação de linha) |
| 139 8B [ 3 1 8] PLD (linha parcial para baixo) |
| 140 8C [ 321 8] PLU (linha parcial para cima) |
| 141 8D [ 3 14 8] RLF (reverse line feed) |
| 142 8E [ 3 145 8] SS2 (single shift two) |
| 143 8F [ 3 1 5 8] SS3 (single shift three) |
| 144 90 [ 3214 8] DCS (controle de dispositivo de string) |
| 145 91 [ 32145 8] PU1 (uso privado um) |
| 146 92 [ 321 5 8] PU2 (uso privado dois) |
| 147 93 [ 32 4 8] STS (seta estado de transmissão) |
| 148 94 [ 32 45 8] CC (cancela caracter) |
| 149 95 [ 3 1 68] MW (message waiting) |
| 150 96 [ 321 68] SGA (inicio da area protegida) |
| 151 97 [ 2 4568] EGA (fim da area protegida) |
| 152 98 [ 3 14 68] SS (inicio da string) |
| 153 99 [ 3 14568] <controle> |
| 154 9A [ 3 1 568] SCI (introdução do caracter unico) |
| 155 9B [ 2 4 68] CSI (introdução de controle de sequencia) |
| 156 9C [ 21 568] ST (terminador de string) |
| 157 9D [ 214568] OSC (comando de operação de sistema) |
| 158 9E [ 45 8] PM (mensagem privada) |
| 159 9F [ 4568] APC (comando de programa de aplicação) |
| 160 A0 [7 8] sem quebra de espaço |
| 161 A1 [732 4 6 ] ponto de exclamação invertido |
| 162 A2 [7 214 6 ] simbolo do centavo |
| 163 A3 [73 456 ] simbolo da libra |
| 164 A4 [7 14 6 ] símbolo da moeda |
| 165 A5 [73214 6 ] simbolo do yen |
| 166 A6 [7 1 56 ] broken bar |
| 167 A7 [73 5 ] section sign |
| 168 A8 [7 5 ] trema |
| 169 A9 [732 56 ] simbolo de copyright |
| 170 AA [ 8] feminine ordinal indicator |
| 171 AB [7 21 6 ] left-pointing double angle quotation mark |
| 172 AC [7 2 56 ] not sign |
| 173 AD [73 6 ] soft hyphen |
| 174 AE [732 6 ] registered sign |
| 175 AF [7 2 6 ] macron |
| 176 B0 [73 56 ] degree sign |
| 177 B1 [73 4 6 ] plus-minus sign |
| 178 B2 [732 ] superscript two |
| 179 B3 [7 2 5 ] superscript three |
| 180 B4 [73 ] acute accent |
| 181 B5 [7 56 ] micro sign |
| 182 B6 [732 5 ] pilcrow sign |
| 183 B7 [7 4 6 ] middle dot |
| 184 B8 [7 6 ] cedilha |
| 185 B9 [7 2 ] superscript one |
| 186 BA [7 ] masculine ordinal indicator |
| 187 BB [73 45 ] right-pointing double angle quotation mark |
| 188 BC [7321 56 ] vulgar fraction one quarter |
| 189 BD [7321456 ] vulgar fraction one half |
| 190 BE [732 456 ] vulgar fraction three quarters |
| 191 BF [7 1456 ] interrogação invertida |
| 192 C0 [732 5 8] capital a grave |
| 193 C1 [7 1 68] capital a acute |
| 194 C2 [7 2 8] capital a circumflex |
| 195 C3 [7 5 8] capital a tilde |
| 196 C4 [73214 68] capital a diaeresis |
| 197 C5 [73 45 8] capital a ring above |
| 198 C6 [73 8] capital ae |
| 199 C7 [73 4 68] capital c cedilla |
| 200 C8 [732 568] capital e grave |
| 201 C9 [7 21 68] capital e acute |
| 202 CA [732 8] capital e circumflex |
| 203 CB [73214568] capital e diaeresis |
| 204 CC [732 68] capital i grave |
| 205 CD [7 14 68] capital i acute |
| 206 CE [7 2 5 8] capital i circumflex |
| 207 CF [7321 568] capital i diaeresis |
| 208 D0 [7 68] capital eth |
| 209 D1 [7 4 68] capital n tilde |
| 210 D2 [73 5 8] capital o grave |
| 211 D3 [7 14568] capital o acute |
| 212 D4 [7 2 568] capital o circumflex |
| 213 D5 [7 568] capital o tilde |
| 214 D6 [732 4 68] capital o diaeresis |
| 215 D7 [7 1 6 ] simbolo de multiplicação |
| 216 D8 [73 4 8] capital o stroke |
| 217 D9 [73 568] capital u grave |
| 218 DA [7 1 568] capital u acute |
| 219 DB [7 2 68] capital u circumflex |
| 220 DC [732 4568] capital u diaeresis |
| 221 DD [7 214 68] capital y acute |
| 222 DE [73 68] capital thorn |
| 223 DF [73 4568] small sharp s |
| 224 E0 [ 32 5 8] small a grave |
| 225 E1 [ 1 68] small a acute |
| 226 E2 [ 2 8] small a circumflex |
| 227 E3 [ 5 8] small a tilde |
| 228 E4 [ 3214 68] small a diaeresis |
| 229 E5 [ 3 45 8] small a ring above |
| 230 E6 [ 3 8] small ae |
| 231 E7 [ 3 4 68] small c cedilla |
| 232 E8 [ 32 568] small e grave |
| 233 E9 [ 21 68] small e acute |
| 234 EA [ 32 8] small e circumflex |
| 235 EB [ 3214568] small e diaeresis |
| 236 EC [ 32 68] small i grave |
| 237 ED [ 14 68] small i acute |
| 238 EE [ 2 5 8] small i circumflex |
| 239 EF [ 321 568] small i diaeresis |
| 240 F0 [ 68] small eth |
| 241 F1 [ 4 68] small n tilde |
| 242 F2 [ 3 5 8] small o grave |
| 243 F3 [ 14568] small o acute |
| 244 F4 [ 2 568] small o circumflex |
| 245 F5 [ 568] small o tilde |
| 246 F6 [ 32 4 68] small o diaeresis |
| 247 F7 [73 4 ] simbolo de divisão |
| 248 F8 [ 3 4 8] small o stroke |
| 249 F9 [ 3 568] small u grave |
| 250 FA [ 1 568] small u acute |
| 251 FB [ 2 68] small u circumflex |
| 252 FC [ 32 4568] small u diaeresis |
| 253 FD [ 214 68] small y acute |
| 254 FE [ 3 68] small thorn |
| 255 FF [ 3 4568] small y diaeresis |
+-----------------------------------------------------------------+
H. Tabela de Instrumento MIDI
Piano
0
Acoustic Grand Piano
1
Bright Acoustic Piano
2
Electric Grand Piano
3
Honkytonk Piano
4
Electric Piano 1
5
Electric Piano 2
6
Harpsichord
7
Clavi
Chromatic Percussion
8
Celesta
9
Glockenspiel
10
Music Box
11
Vibraphone
12
Marimba
13
Xylophone
14
Tubular Bells
15
Dulcimer
Organ
16
Drawbar Organ
17
Percussive Organ
18
Rock Organ
19
Church Organ
20
Reed Organ
21
Accordion
22
Harmonica
23
Tango Accordion
Guitar
24
Nylon Acoustic Guitar
25
Steel Acoustic Guitar
26
Jazz Electric Guitar
27
Clean Electric Guitar
28
Muted Electric Guitar
29
Overdriven Guitar
30
Distortion Guitar
31
Guitar Harmonics
Bass
32
Acoustic Bass
33
Finger Electric Bass
34
Pick Electric Bass
35
Fretless Bass
36
Slap Bass 1
37
Slap Bass 2
38
Synth Bass 1
39
Synth Bass 2
Strings
40
Violin
41
Viola
42
Cello
43
Contrabass
44
Tremolo Strings
45
Pizzicato Strings
46
Orchestral Harp
47
Timpani
Ensemble
48
String Ensemble 1
49
String Ensemble 2
50
Synth Strings 1
51
Synth Strings 2
52
Choir Aahs
53
Voice Oohs
54
Synth Voice
55
Orchestra Hit
Brass
56
Trumpet
57
Trombone
58
Tuba
59
Muted Trumpet
60
French Horn
61
Brass Section
62
Synth Brass 1
63
Synth Brass 2
Reed
64
Soprano Saxophone
65
Alto Saxophone
66
Tenor Saxophone
67
Baritone Saxophone
68
Oboe
69
English Horn
70
Bassoon
71
Clarinet
Pipe
72
Piccolo
73
Flute
74
Recorder
75
Pan Flute
76
Blown Bottle
77
Shakuhachi
78
Whistle
79
Ocarina
Synth Lead
80
Lead 1 (square)
81
Lead 2 (sawtooth)
82
Lead 3 (calliope)
83
Lead 4 (chiff)
84
Lead 5 (charang)
85
Lead 6 (voice)
86
Lead 7 (fifths)
87
Lead 8 (bass + lead)
Synth Pad
88
Pad 1 (new age)
89
Pad 2 (warm)
90
Pad 3 (polysynth)
91
Pad 4 (choir)
92
Pad 5 (bowed)
93
Pad 6 (metallic)
94
Pad 7 (halo)
95
Pad 8 (sweep)
Synth FM
96
FX 1 (rain)
97
FX 2 (soundtrack)
98
FX 3 (crystal)
99
FX 4 (atmosphere)
100
FX 5 (brightness)
101
FX 6 (goblins)
102
FX 7 (echoes)
103
FX 8 (science-fiction)
Ethnic
104
Sitar
105
Banjo
106
Shamisen
107
Koto
108
Kalimba
109
Bag Pipe
110
Fiddle
111
Shanai
Percussive
112
Tinkle Bell
113
Agogo
114
Steel Drum
115
Wooden Block
116
Taiko Drum
117
Melodic Tom
118
Synth Drum
119
Reverse Cymbal
Sound Effects
120
Guitar Fret Noise
121
Breath Noise
122
Seashore
123
Bird Tweet
124
Telephone Ring
125
Helicopter
126
Applause
127
Gunshot