Page suivante Page précédente Table des matières

4. Utilisation de BRLTTY

Avant de démarrer BRLTTY, vous avez besoin d'installer votre afficheur braille. Dans la plupart des cas, cela se fait simplement en le connectant sur un port série disponible, puis en le mettant sous tension. Après avoir installé votre afficheur, exécutez simplement BRLTTY en tapant la commande BRLTTY sur une invite du shell (vous devez faire cela en tant que root). Intéressez-vous à l'option -d en ligne de commande, à la ligne braille-device du fichier de configuration, et à l'option de compilation --with-braille-device pour d'autres moyens de dire à BRLTTY à quel périphérique votre afficheur est connecté. Regardez l'option -b en ligne de commande, la ligne braille-driver du fichier de configuration, et l'option de compilation --with-braille-driver pour d'autres possibilités concernant la manière d'indiquer à BRLTTY quel type d'afficheur braille vous avez. Observez l'option -B en ligne de commande, et la ligne braille-parameters du fichier de configuration pour d'autres possibilités concernant la manière de passer les paramètres au pilote de votre afficheur braille. Un message donnant le nom du programme (BRLTTY) et son numéro de version apparaîtra brièvement (voir l'option -M en ligne de commande) sur l'afficheur braille. L'afficheur montrera alors une petite zone de l'écran contenant le curseur. Par défaut, le curseur est représenté par les points 7 et 8 superposés sur le caractère où il est.

Toute activité de l'écran sera affichée sur l'afficheur braille. L'afficheur suivra aussi la progression du curseur sur l'écran. Cette caractéristique est connue en tant que cursor tracking.

Toutefois, le fait de simplement taper sur le clavier et lire l'afficheur ne suffit pas. Essayez d'entrer une commande qui provoquera une erreur, et de taper entrée. L'erreur apparaît sur l'écran mais, sauf si vous avez un afficheur à plusieurs lignes, il y a des chances qu'elle ne soit pas visible sur l'afficheur braille. Vous n'y voyez que l'invite du shell. Vous avez donc besoin, à présent, d'un moyen de déplacer la fenêtre braille à travers l'écran. Les touches de l'afficheur braille lui-même peuvent être utilisées pour envoyer les commandes à BRLTTY qui, entre autres choses, peut s'en charger.

4.1 Commandes

Malheureusement, les différents afficheurs braille n'offrent pas des touches de contrôle standard. Certains ont des touches standard six points, certains en ont huit, et d'autres n'en ont pas. Certains ont des touches au niveau des pouces, mais il n'y en a pas beaucoup en standard. Certains ont un bouton au-dessus de chaque cellule braille. Certains ont des boutons qu'il faut pousser. D'autres ont une barre facile d'accès fonctionnant beaucoup comme une manette de jeu. La plupart ont des combinaisons variées des éléments ci-dessus. A cause de la nature et de la disposition si différente entre chaque afficheur, reportez-vous à la documentation de votre afficheur personnel pour trouver ce que fait exactement chaque touche.

Les commandes de BRLTTY sont identifiées par leur nom dans ce manuel. Si vous oubliez la/les touche(s) de votre afficheur braille à utiliser pour une commande particulière, reportez-vous à la page d'aide de son pilote. Par conséquent, la touche que vous devriez mémoriser immédiatement est celle de la commande HELP. Utilisez les routines habituelles (comme décrit ci-dessous) pour naviguer dans la page d'aide, puis pressez de nouveau la touche d'aide pour quitter.

Déplacement vertical

Voir aussi les commandes de routines PRINDENT/NXINDENT et PRDIFCHAR/NXDIFCHAR.

LNUP/LNDN

Monte/descend d'une ligne. Si le saut des lignes identiques a été activé (voir la commande SKPIDLNS), ces commandes, au lieu de se déplacer exactement d'une ligne à l'autre, sont des alias pour les commandes PRDIFLN/NXDIFLN.

WINUP/WINDN

Monte/descend d'un écran. Si l'écran n'est pas plus haut qu'une ligne, elle déplace alors de 5 lignes.

PRDIFLN/NXDIFLN

Monte/descend à la ligne la plus proche ayant un contenu différent. Si le saut de lignes identiques a été activé (voir les commandes SKPIDLNS), ces commandes, plutôt que de sauter des lignes identiques, sont des alias pour les commandes LNUP/LNDN commands.

ATTRUP/ATTRDN

Monte/descend à la ligne la plus proche avec des attributs différents (mise en valeur de caractère).

TOP/BOT

Va au début ou à la fin de la ligne.

TOP_LEFT/BOT_LEFT

Va au coin en haut à gauche ou en bas à gauche.

PRPGRPH/NXPGRPH

Va à la ligne la plus proche du paragraphe précédent/suivant (la première ligne non vide après la ligne vide la plus proche). La ligne courante est incluse dans la recherche de l'espace entre les paragraphes.

PRPROMPT/NXPROMPT

Va à l'invite de commande suivant/précédent.

PRSEARCH/NXSEARCH

Recherche avant/arrière de l'occurrence la plus proche de la chaîne de caractères du tampon coupé (voir Couper-coller) qui n'est pas dans la fenêtre braille. La recherche se fait à gauche/droite, et commence au caractère immédiatement à gauche/droite de la fenêtre, et en englobant le bord de l'écran. La recherche ne tient pas compte de la casse.

Déplacement horizontal

Voir aussi la commande de la routine SETLEFT.

CHRLT/CHRRT

Va à gauche/droite d'un caractère.

HWINLT/HWINRT

Va à gauche/droite de la moitié de la fenêtre.

FWINLT/FWINRT

Va à gauche/droite d'une fenêtre. Ces commandes sont particulièrement utiles parce qu'elles débordent automatiquement quand elles atteignent le bord de l'écran. Les autres caractéristiques, comme celles de sauter les fenêtres vides (voir la commande SKPBLNKWINS), accroissent leur maniabilité.

FWINLTSKIP/FWINRTSKIP

Va à gauche/droite à la fenêtre non-vide la plus proche.

LNBEG/LNEND

Va au début/fin de la ligne.

Déplacement implicite

Voir aussi la commande de routine GOTOMARK.

HOME

Va à l'endroit où se trouve le curseur d'écran.

BACK

Revient là où la commande de déplacement la plus récente a mis la fenêtre braille. C'est une façon facile de retourner à droite de là où vous lisiez, après un événement imprévu (comme une poursuite du curseur) qui déplace la fenêtre braille à un moment inapproprié.

RETURN

Caractéristiques de l'activation

Chacune de ces commandes a trois modes: activate (déclenche la fonction), deactivate (annule la fonction), et toggle (si la fonction est inhibée, la déclenche, et vis versa). Sauf si cela est explicitement dit, chacune de ces fonctions est initialement à off, et, quand elle est on, cela agit sur l'exécution de BRLTTY tout entier. Le paramètre initial de certaines des fonctionnalités peut être changée par le menu préférences.

FREEZE

Gèle l'image de l'écran. BRLTTY fait une copie de l'écran (contenu et attributs) comme au moment où l'image de l'écran est raffraîchie, et ignore dès lors toute mise à jour de l'écran jusqu'à ce qu'il soit réactualisé. Par exemple, cette fonctionnalité facilite la lecture de la sortie d'une application qui écrit beaucoup trop rapidement.

DISPMD

Montre les mises en relief (attributs) de chaque caractère dans la fenêtre braille, plutôt que les caractères eux-mêmes (le contenu). Par exemple, cette fonctionnalité est utile si vous devez mettre en valeur un item. Quand elle montre le contenu de l'écran, la table de traduction de texte est utilisée (voir l'option -t en ligne de commande, la ligne text-table du fichier de configuration et l'option de compilation --with-text-table). Quand elle montre les attributs de l'écran, la table de traduction des attributs est utilisée (voir l'option ``-a'' en ligne de commande, la ligne attributes-table du fichier de configuration, et l'option de compilation ``--with-attributes-table''). Cette fonctionnalité ne s'applique qu'au terminal virtuel courant.

SIXDOTS

Montre les caractères brailles sous la forme 6-points et non 8-points. Les points 7 et 8 sont encore utilisés par d'autres fonctionnalités telles que la représentation du curseur et le soulignement des caractères mis en relief. Si une table de braille abrégé a été sélectionnée (voir l'option -c en ligne de commande, et la ligne contraction-table du fichier de configuration), elle est utilisée. Vous pouvez aussi changer ce paramètre avec la préférence Text Style.

SLIDEWIN

Si le suivit (tracking) du curseur (voir la commande CSRTRK) est on, chaque fois que le curseur se déplace de façon trop limitée (ou pas assez) au-delà de la fin de la fenêtre braille, elle repositionne horizontalement la fenêtre braille, de sorte que le curseur, tant qu'il reste de ce côté, soit plus proche du centre. Si cette caractéristique est off, la fenêtre braille est toujours positionnée de façon à ce que sont côté gauche soit un multiple de de sa largeur depuis le bord gauche de l'écran.

Vous pouvez aussi modifier ce paramètre avec la préférence Sliding Window.

SKPIDLNS

Au lieu de déplacer exactement d'une ligne en haut ou en bas, saute les lignes déjà lues qui ont le même contenu que la ligne courante. Cette caractéristiques influence les commandes LNUP/LNDN, autant que le défilement de la ligne exécutée par les commandes FWINLT/FWINRT et FWINLTSKIP/FWINRTSKIP. Vous pouvez aussi changer ce paramètre avec la préférence Skip Identical Lines.

SKPBLNKWINS

Saute les fenêtres vides déjà passées lors d'une lecture en avant ou en arrière. Cette caractéristique influence les commandes FWINLT/FWINRT. Vous pouvez aussi changer ce paramètre avec la préférence Skip Blank Windows.

CSRVIS

Montre le curseur en superposant un modèle de point (voir la commande CSRSIZE) au-dessus du caractère où il se trouve. A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Show Cursor.

CSRHIDE

Rend le curseur invisible (voir la commande CSRVIS ) de façon à lire précisément le caractère sous lui. Cette caractéristique n'affecte que la console virtuelle courante.

CSRTRK

Poursuite du curseur. Si le curseur se déplace à un endroit qui n'est pas à l'intérieur de la fenêtre braille, il déplace automatiquement la fenêtre braille vers la nouvelle position du curseur. Vous voudrez en principe que cette caractéristique soit active, puisque cela minimise les effets du défilement de l'écran, et puisque, lorsque vous entrez quelque chose, la région à l'intérieur de laquelle vous écrivez actuellement est toujours visible. Si cette option fait sauter la fenêtre braille à un moment inadéquat, utilisez la commande BACK pour revenir là où vous étiez en train de lire. Il se peut que vous deviez désactiver cette option lorsque vous utilisez une application qui raffraîchit en permanence l'écran tant qu'est maintenu une base d'organisation réparée. A l'origine, cette caractéristique est on.

CSRSIZE

Représente le curseur avec les huit points (un bloc complet), au lieu de n'afficher que les points 7 et 8 (un soulignement). Vous pouvez aussi changer ce paramètre avec la préférence Cursor Style.

CSRBLINK

Cache (active et la désactive en fonction d'un intervalle prédéfini) le symbole représentant le curseur (voir la commande CSRVIS). Vous pouvez changer ce paramètre avec la préférence Blinking Cursor.

ATTRVIS

Souligne (avec la combinaison des points 7 et 8) les caractères à mettre en évidence.

no underline

Blanc sur noir (normal), Gris sur noir, Blanc sur bleu, Noir sur cyan.

dots 7 and 8

Noir sur blanc (vidéo inversée).

dot 8

Tout le reste.

Vous pouvez aussi changer ce paramètre avec la préférence Show Attributes.

ATTRBLINK

Masque (active ou désactive selon un intervalle prédéfini) l'attribut souligné (voir la commande ATTRVIS command). A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Blinking Attributes.

CAPBLINK

Masque (active ou désactive selon un intervalle prédéfini) les lettres en majuscule. Vous pouvez aussi changer ce paramètre avec la préférence Blinking Capitals.

TUNES

Joue un son court prédéfini (voir Alert Tunes) chaque fois qu'un événement significatif se produit. A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Alert Tunes.

AUTOREPEAT

Répète automatiquement une commande à un intervalle régulier après un délai initial tant que sa touche (combinaison) reste appuyée. Seuls certains pilotes supportent cette fonctionnalité, la principale limite étant que la plupart des afficheurs brailles ne signale pas en même temps les touches pressées et les touches exécutées comme des événements distinctement séparés. A l'origine, cette caractéristique est on. Vous pouvez aussi changer ce paramètre avec la préférence Autorepeat.

AUTOSPEAK

Dit automatiquement:

A l'origine, cette caractéristique est off. Vous pouvez aussi changer ce paramètre avec la préférence Autospeak.

Mode Sélection

HELP

Se déplace à la page d'aide du pilote d'un afficheur braille. C'est là que vous pouvez trouver un résumé en ligne de choses telles que ce que font les touches de votre afficheur braille, et comment interpréter ses cellules d'état. Utilisez les commandes vertical et horizontal pour naviguer dans la page d'aide. Appelez la commande help de nouveau pour revenir à l'écran.

INFO

Va à l'affichage des états (voir la section Affichage des Statuts pour des détails complets). Cela présente un résumé comprenant la position du curseur, la position de la fenêtre braille, et l'état d'un certain nombre de caractéristiques de BRLTTY. Appelez de nouveau cette commande pour revenir à l'écran.

LEARN

Entre dans le mode d'apprentissage de commande (voir la section Mode Appresntissage Commande pour des détails complets). C'est ainsi que vous pouvez apprendre de façon interactive ce que font les touches de votre afficheur braille. Rappelez cette commande pour revenir à l'écran. Cette commande n'est pas disponible si l'option de compilation --disable-learn-mode a été spécifiée.

Maintenance des préférences

PREFMENU

Accès au menu des préférences (voir Le Preferences Menu pour des détails complets). Rappelez cette commande pour revenir à l'écran. Cette commande n'est pas disponible si l'option de compilation --disable-preferences-menu a été spécifiée.

PREFSAVE

Enregistre les paramètres de préférence courants (voir Preferences pour des détails complets).

PREFLOAD

Recharge les derniers paramètres de préférence sauvegardés (voir Preferences pour des détails complets).

Navigation dans le menu

MENU_FIRST_ITEM/MENU_LAST_ITEM

Va au premier/dernier élément du menu.

MENU_PREV_ITEMMENU_NEXT_ITEM/

Va à l'élément précédent/suivant du menu.

MENU_PREV_SETTING/MENU_NEXT_SETTING

Remonte/descend le paramètre des éléments du menu courant.

Contrôles de la verbosité

SAY_LINE

Dit la ligne courante. La préférence Say-Line Mode détermine si le message en attente est proposé en premier.

SAY_ABOVE

Dit la portion en haut de l'écran (fin à la ligne courante).

SAY_BELOW

Dit la portion en bas de l'écran (début à la ligne courante).

MUTE

Arrête immédiatement la parole.

SPKHOME

Va où se trouve le curseur parlant.

SAY_SLOWER/SAY_FASTER

Diminue/accélère le débit de parole (voir aussi la péférence Débit de parole). Cette commande n'est disponible que si un pilote qui la supporte est utilisé.

SAY_SOFTER/SAY_LOUDER

Diminue/augmente le volume de la parole (voir aussi la préférence Volume de la parole). Cette commande n'est disponible que si un pilote qui la supporte est utilisé.

Aller à un terminal virtuel

Voir aussi la commande de touche de chemin SWITCHVT.

SWITCHVT_PREV/SWITCHVT_NEXT

Va à la console précédente/suivante.

Autres Commandes

CSRJMP_VERT

Amène le curseur n'importe où sur la première ligne de la fenêtre braille (voir Déplacement du Curseur pour des détails complets). Le curseur se déplace grâce à la simulation de l'appui sur les touches de direction verticales. Cette commande ne fonctionne pas toujours car certaines applications, soit déplacent le curseur sans vraiment avertir, soit utilisent les flèches de direction à d'autres fins que le déplacement du curseur. C'est toutefois un peu plus sûr que les autres commandes de déplacement du curseur car cette commande ne tente pas de simuler les flèches gauche et droite.

PASTE

Insère les caractères du tampon coupé à la place courante du curseur. (voir Couper-coller pour des détails complets).

RESTARTBRL

Arrête puis relance le pilote de l'afficheur braille.

RESTARTSPEECH

Arrête puis relance le pilote de la synthèse vocale.

Les routines

ROUTE

Déplace le curseur au caractère associé à la routine (voir Déplacement du Curseur pour des détails complets). Le curseur se déplace grâce à la simulation de l'appui sur les touches de direction verticales. Cette commande ne fonctionne pas toujours car certaines applications, soit déplacent le curseur sans vraiment avertir, soit utilisent les flèches de direction à d'autres fins que le déplacement du curseur.

CUTBEGIN

Positionne le début du bloc coupé au caractère associé à la routine-curseur. (voir Copier-coller pour des détails complets). Cette commande vide le tampon coupé.

CUTAPPEND

Positionne le début du bloc coupé au caractère associé à la routine (voir Copier-coller pour des détails complets). Cette commande ne vide pas le tampon coupé.

CUTRECT

Fixe la fin du bloc coupé au caractère associé à la touche de direction, et place la région rectangulaire sur le tampon coupé (voir Cut and Paste pour des détails complets).

CUTLINE

Fixe la fin du bloc coupé au caractère associé à la touche de direction, et place la partie linéaire sur le bloc coupé (voir Cut and Paste pour des détails complets).

SWITCHVT

Va au terminal virtuel dont le numéro (démarrant à 1) correspond à celui de la routine. Voir aussi les commandes de déplacement dans les terminaux virtuels SWITCHVT_PREV/SWITCHVT_NEXT.

PRINDENT/NXINDENT

Monte/descend à la ligne la plus proche qui n'est pas indentée plus que la colonne associée à la routine.

DESCCHAR

Affiche momentanément (voir l'option -M en ligne de commande) un message décrivant le caractère associé à la routine. Cela montre les valeurs décimales et hexadécimales du caractère, les couleurs de fond et de premier plan, et, lorsqu'ils sont présents, les attributs spéciaux (bright et blink). Le message ressemble à cela:

char 65 (0x41): white on black bright blink

SETLEFT

Replace horrizontalement la fenêtre braille de façon à ce que son côté gauche soit à la colonne associée à la touche de déplacement. Cette caractéristique rend très facile l'action de mettre la fenêtre précisément là où il faut et, donc, pour les afficheurs qui ont des touches routines, élimine presque la nécessité pour beaucoup de déplacements élémentaires de la fenêtre (comme les commandes CHRLT/CHRRT et HWINLT/HWINRT).

SETMARK

Marque la position courante de la fenêtre braille dans une mémoire associée à la routine. Voir la commande GOTOMARK. Cette caractéristique n'affecte que le terminal virtuel courant.

GOTOMARK

Déplace la fenêtre braille à la position précédemment marquée (voir la commande SETMARK) avec la même routine. Cette caractéristique n'affecte que le terminal virtuel courant.

PRDIFCHAR/NXDIFCHAR

Monte ou descend à la ligne la plus proche qui contient un caractère différent dans la colonne associée à la routine-curseur.

4.2 Le fichier de configuration

Des valeurs système par défaut pour certains paramètres peuvent être établis dans un fichier de configuration. Le nom par défaut de ce fichier est /etc/brltty.conf, même s'il peut être contourné par l'option en ligne de commande -f. Son existence n'est pas indispensable. Vous pouvez trouver un ficher type dans le sous-répertoire DOCS

Les lignes vides sont ignorées. Un commentaire commence par un signe nombre (#), et continue jusqu'à la fin de la ligne. Les lignes de commande suivantes sont reconnues:

api-parameters name=valeur,...

Spécifie les paramètres pour l'API. Si vous spécifiez le même paramètre plus d'une fois, sa valeur située le plus à droite est utilisée. Pour une description des paramètres acceptés par l'interface, voyez le manuel de référence BrlAPI. Voir l'option de compilation --with-api-parameters pour les paramètres par défaut établis lors de la procédure de compilation. Cette ligne de commande peut être évitée avec l'option de ligne de commande -A.

attributes-table fichier

Spécifie la table de traduction des attributs (voir la section Translation Tables pour des détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à /etc/brltty (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension .tbl est facultative. Voir l'option de compilation --with-attributes-table pour les paramètres par défaut établis pendant la procédure de compilation. Vous pouvez vous passer de cette ligne de commande avec l'option en ligne de commande -a.

braille-device device,...

Spécifie le périphérique auquel l'afficheur braille est connecté (voir la section Spécification du périphérique braille). Voir l'option de compilation --with-braille-device pour les paramètres par défaut établis durant la procédure de compilation. Vous pouvez vous passer de cette ligne de commande avec l'option -d.

release-device [boléen

Prendre en compte ou non le périphérique auquel l'afficheur braille est connecté lorsque l'écran courant ou la fenêtre ne peuvent être lus.

on

Prend en compte le périphérique.

off

Ne prend pas en compte le périphérique.

Sur les plateformes Windows, le paramètre est on (actif), il est off sur toutes les autres. Vous pouvez éviter cette ligne avec l'option en ligne de commande -r.

braille-driver pilote,...|auto

Spécifie le pilote de l'afficheur braille (voir la section Spécification du pilote). Par défaut, c'est une autodétection qui est effectuée. Vous pouvez éviter cette ligne avec l'option en ligne de commande -b.

braille-parameters [pilote:]nom=valeur,...

Spécifie les paramètres pour les pilotes de l'afficheur braille. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur placée le plus à droite qui est utilisée. Si le nom d'un paramètre est qualifié par celui d'un pilote (voir la section Codes d'identification de pilote) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Par défaut, c'est une autodétection qui est effectuée. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-braille-parameters pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -B.

contraction-table fichier

Spécifie la table abrégé (voir la section Braille abrégé pour des détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à /etc/brltty (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails. L'extension .ctb est facultative. La table d'abrégé est utilisée quand la caractéristique braille 6-points est activée (voir la commande SIXDOTS et la préférence Text Style). Par défaut, affiche le braille 6 points intégral. Vous pouvez éviter cette ligne avec l'option en ligne de commande -c. Elle n'est pas disponible si l'option de compilation --disable-contracted-braille a été spécifiée.

midi-device device

Spécifie le périphérique à utiliser pour l'interface MIDI (voir la section Spécification du périphérique MIDI). Vous pouvez éviter cette ligne avec l'option en ligne de commande -m. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-midi-support.

pcm-device device

Spécifie le périphérique à utiliser pour l'audio (voir la section Spécification du périphérique PCM). Vous pouvez éviter cette ligne avec l'option en ligne de commande -p. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-pcm-support.

screen-parameters name=value,...

Spécifie les paramètres pour le pilote d'écran. Si le même paramètre est spéciié plus d'une fois, sa valeur la plus à droite est utilisée. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-screen-parameters pour les paramètres par défaut établis pendant la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -X.

screen-driver pilote

Voir l'option de compilation --with-screen-driver. Vous pouvez éviter cette ligne avec l'option en ligne de commande -x.

screen-parameters pilotenom=valeur,...

Spécifie les paramètres pour les pilotes d'écran. Si le même paramètre est spéciié plus d'une fois, sa valeur la plus à droite est utilisée. Si un nom de paramètre est affecté à un pilote (voir section Pilotes d'écran supportés), ce paramètre ne s'applique qu'au pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-screen-parameters pour les paramètres par défaut établis pendant la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -X.

speech-driver driver,...|auto

Spécifie le pilote de synthèse vocales (voir la section Spécification du pilote de synthèse). Pah défaut, uneautodétection est effectuée. Vous pouvez éviter cette ligne avec l'option en ligne de commande -s. Elle n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

speech-fifo file

Spécifie le FIFO (un fichier spécial qui fonctionne comme un tuyau en mode "first in first out", premier entré premier sorti) qui doit être utilisé par les autres applications voulant accéder au pilote de la synthèse de BRLTTY. Vous pouvez éviter cette ligne avec l'option en ligne de commande -F. Elle n'est pas disponible si vous avez spécifié --disable-speech-support.

speech-parameters [driver:]name=value,...

Spécifie les paramètres pour les pilotes de synthèse vocale. Si vous spécifiez plus d'une fois le paramètre, c'est sa valeur le plus à droite qui est utilisée. Si le nom d'un paramètre est qualifié par le nom d'un pilote (voir la section Codes d'identification de pilote) ce paramètre s'applique seulement à ce pilote; sinon il s'applique pour tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir l'option de compilation --with-speech-parameters pour les paramètres par défaut établis durant la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -S.

text-table file

Spécifie la table de traduction de texte (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à /etc/brltty (voir les options de compilation --with-data-directory et --with-execute-root. pour plus de détails). L'extension .tbl est facultative. Pour un nom de fichier simple, le préfixe text. est facultatif. Voir l'option de compilation --with-text-table pour les paramètres par défaut établis lors de la procédure de compilation. Vous pouvez éviter cette ligne avec l'option en ligne de commande -t.

4.3 Options en ligne de commande

Un grand nombre de paramètres peuvent être spécifiés explicitement lorsque vous appelez BRLTTY. La commande brltty accepte les options suivantes:

-afile --attributes-table=fichier

Spécifie la table de traduction des attributs (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est déterminé par rapport à /etc/brltty (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension .tbl est facultative. Voir la ligne attributes-table du fichier de configuration pour la sélection des paramètres par défaut lors de l'exécution. Vous pouvez changer ce paramètre avec la préférence Attributes Table.

-bdriver,...|auto --braille-driver=driver,...|auto

Spécifie le pilote de l'afficheur braille (voir la section Spécification du pilote). Voir la ligne braille-driver du fichier de configuration pour les paramètres par défaut à l'exécution.

-cfichier --contraction-table=fichier

Spécifie la table d'abrégé (voir la section Braille abrégé pour les détails). Si vous fournissez un chemin relatif, il est rattaché à /etc/brltty. (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension .ctb est facultative. La table d'abrégé est utilisée lorsque la caractéristique braille 6 points est activée (voir la commande SIXDOTS et la préférence Text Style). Voir la ligne contraction-table du fichier de configuration pour les paramètres par défaut à l'exécution. Vous pouvez changer ce paramètre avec la préférence Contraction Table. Cette option n'est pas disponible si l'option de compilation --disable-contracted-braille a été spécifiée.

-dperipherique,... --braille-device=device,...

Spécifie le périphérique auquel l'afficheur braille est connecté (voir la section Spécification du périphérique braille). Voir la ligne braille-device du fichier de configuration pour les paramètres par défaut à l'exécution.

-e --standard-error

Ecrit les messages de diagnostic sur la console d'erreur standard (stderr). Par défaut, ils s'enregistrent dans syslog.

-ffichier --configuration-file=file

Spécifie l'emplacement du fichier de configuration qui doit être utilisé pour l'établissement des paramètres par défaut à l'exécution.

-h --help

Affiche un résumé des options de la ligne de commande acceptées par BRLTTY, puis quitte.

-lniveau --log-level=level

Spécifie le niveau de sécurité pour l'émission des messages de diagnostique. Les niveaux suivants sont reconnus.

0

emergency (urgence)

1

alert (alerte)

2

critical (critique)

3

error (erreur)

4

warning (attention)

5

notice (note)

6

information

7

debug (mise au point)

Vous pouvez fournir soit le numéro soit le nom, et vous pouvez abréger le nom. Si vous ne spécifiez pas cela, c'est information qui est utilisé (voir l'option -q pour plus de détails).

-mpériphérique --midi-device=device

Spécifie le pilote à utiliser pour l'interface MIDI. (voir la section Spécification du périphérique MIDI). Voir la ligne midi-device du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-midi-support.

-n --no-daemon

Indique à BRLTTY qu'il doit rester au premier plan. Si cette option n'est pas spéciiée, BRLTTY devient un processus en arrière-plan (démon) après s'être initialisé mais avant de démarrer tous les pilotes sélectionnés.

-ppériphérique --pcm-device=device

Spécifie le périphérique à utiliser pour l'audio (voir la section ( Spécification du périphérique PCM). Voir la ligne pcm-device du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-pcm-support.

-q --quiet

Met moins d'informations dans le log. Cette option passe le niveau de journalisation (voir l'option -l à notice si vous avez spécifié l'option -v ou -V, et, sinon, à warning.

-r --release-device=...|auto

Prend en compte le périphérique auquel est connecté l'afficheur braille lorsque l'écran courant ou la fenêtre ne peuvent être lus. Voir la ligne release-device du fichier de configuration pour les paramètres par défaut à l'exécution.

-spériphérique,...|auto --speech-driver=pilote,...|auto

Spécifie le pilote de la synthèse vocale (voir la section Spécification de pilote). Voir la ligne speech-driver du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

-tfichier --text-table=file

Spécifie la table de traduction de texte (voir la section Tables de traduction pour les détails). Si vous fournissez un chemin relatif, il est rattaché à /etc/brltty (voir les options de compilation --with-data-directory et --with-execute-root pour plus de détails). L'extension .tbl est facultative. Pour un nom de fichier simple, le péfixe text. est facultatif. Voir la ligne text-table du fichier de configureation pour les paramètres par défaut à l'exécution. Vous pouvez changer ce paramètre avec la préférence Text Table.

-v --verify

Affiche les versions courantes de BRLTTY, du côté serveur de son API, et des pilotes de synthèse et de braille sélectionnés, puis quitte. Si l'option -q n'est pas spéciifiée, affiche aussi les valeurs des options après que toutes les sources aient été examinées. Si vous avez spécifié plus d'un pilote braille (voir l'option en ligne de commande -b) et/ou plus d'un périphérique braille (voir l'option en ligne de commande -d), une autodétection de l'afficheur braille est entreprise. Si vous avez spécifié plus d'un pilote de synthèse (voir l'option en ligne de commande -s), une autodétection de la synthèse vocale est entreprise.

-xpilote --screen-driver=pilote...

Spécifie le pilote d'écran (voir la section Pilotes d'écran s1ffehtés). Voir la ligne screen-driver du fichier de configuration pour les paramètres par défaut à l'exécution.

-Anom=valeur,... --api-parameters=name=value,...

Spécifie les paramètres pour l'API. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur la plus à droite qui est utilisée. Pour une description des paramètres acceptés par l'interface, reportez-vous au manuel de référence BrlAPI. Voir la ligne api-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

-B[pilote:]nom=valeur... --braille-parameters=[pilote:]nom=valeur,...

Spécifie les paramètres pour les pilotes des afficheurs braille. Si vous spécifiez le même paramètre plus d'une fois, c'est sa valeur le plus à droite qui est utilisée. Si vous qualifiez le nom d'un paramètre par un pilote, (voir la section Codes d'identification des pilotes) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, reportez-vous à la documentation de ce pilote. Voir la ligne braille-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

-E --environment-variables

Reconnaît les variables d'environnement quand les paramètres par défaut pour des options en ligne de commandes non spécifiées sont déterminées. (voir la section Options en ligne de commande). Si vous spécifiez cette option, et si vous définissez une variable d'environnement associée à une option non spécifiée, c'est la valeur de cette variable d'environnement qui est utilisée. Les noms de ces variables d'environnement sont basés sur les noms longs des options auxquelles elles correspondent:

Cette option est particulièrement utile sur les systèmes d'exploitation Linux dans le sens où elle permet de passer des paramètres par défaut à BRLTTY via les paramètres du boot. Les variables d'environnement suivantes sont supportées:
BRLTTY_API_PARAMETERS

Paramètres pour l'API (voir l'option en ligne de commande -A).

BRLTTY_ATTRIBUTES_TABLE

La table de traduction des attributs (voir l'option en ligne de commande -a).

BRLTTY_BRAILLE_DEVICE

Le périphérique de l'afficheur braille (voir l'option en ligne de commande -d).

BRLTTY_RELEASE_DEVICE

Prendre en compte ou non le périphérique auquel l'afficheur braille est connecté lorsque l'écran courant ou la fenêtre ne peuvent être lus (voir l'option -r en lignede commande).

BRLTTY_BRAILLE_DRIVER

Le pilote de l'afficheur braille (voir l'option en ligne de commande -b).

BRLTTY_BRAILLE_PARAMETERS

Paramètres pour le pilote de l'afficheur braille (voir l'option en ligne de commande -B).

BRLTTY_CONFIGURATION_FILE

Le fichier de configuration (voir l'option -f de la ligne de commande).

BRLTTY_CONTRACTION_TABLE

La table d'abrégé (voir l'option -c en ligne de commande).

BRLTTY_MIDI_DEVICE

Le périphérique pour l'interface MIDI (voir l'option -m en ligne de commande).

BRLTTY_PCM_DEVICE

Le périphérique audio (voir l'option -p en ligne de commande).

BRLTTY_SCREEN_PARAMETERS

Paramètres pour le pilote d'écran (voir l'option -X en ligne de commande).

BRLTTY_SPEECH_DRIVER

Le pilote de la synthèse vocale (voir l'option -s en ligne de commande).

BRLTTY_SPEECH_FIFO

Le pont de passage de la synthèse FIFO (voir l'option -F en ligne de commande).

BRLTTY_SPEECH_PARAMETERS

Paramètres pour le pilote de la synthèse vocale (voir l'option -S en ligne de commande).

BRLTTY_TEXT_TABLE

La table de traduction de texte (voir l'optien -a en ligne de commande).

-Ffichier --speech-fifo=file

Spécifie le FIFO (un fichier spécial qui fonctionne comme un tube) qui doit être utilisé par les autres applications souhaitant avoir accès au pilote de synthèse de BRLTTY. Si ce n'est pas spécifié, aucun FIFO n'est créé. Voir la ligne speech-fifo du fichier de configuration pour les paramètres par défaut à l'exécution. Cette option n'est pas disponible si vous avez spécifié l'option de compilation --disable-speech-support.

-Mcsecs --message-delay=csecs

Spécifie le temps (en centièmes de seconde) que prend ÁRLTTY pour afficher ses propres messages internes sur l'afficheur braille. Si ce n'est pas spécifié, c'est 400 (4 secondes) qui est utlisé.

-N --no-api

Désactive l'interface programmatique de l'application.

-Pfichier --pid-file=fichier

Spécifie le fichier à l'intérieur duquel BRLTTY doit écrire ses identifiants de processus (pid). Si cela n'est pas spécifié, BRLTTY écrit ses identifiants de processus nulle part.

-S[driver:]name=value,... --speech-parameters=[driver:]name=value,...

Spécifie les paramètres pour les pilotes de synthèse vocale. Si vous spécifiez plus d'une fois le même paramètre, c'est sa valeur la plus à droite qui est utilisée. Si un nom de paramètre est qualifié par un pilote (voir la section Code d'identification de pilote) ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, voyez la documentation de ce pilote. Voir la ligne speech-parameters du fichier de configuration pour les paramètres par défaut à l'exécution.

-Ucsecs --update-interval=csecs

Spécifie l'intervalle (en centièmes de secondes) auquel la fenêtre braille est synchronisée avec le nouveau contenu de l'écran. Si ce n'est pas spécifié, c'est 4 (40 millisecondes) qui est utilisé.

-V --version

Affiche les versions courantes de BRLTTY lui-même, de la partie serveur de son API, et des pilotes qui ont été liés à son binaire, puis quitte. Si vous ne spécifiez pas l'option -q, affiche aussi les informations légales.

-Xnom=valeur,...--screen-parameters=pilote=nomvaleur...

Spécifie les paramètres pour les pilotes d'écran. Si vous spécifiez plus d'une fois le même paramètre, c'est sa valeur la plus à droite qui est utilisé. Si un paramètre est réservé à un pilote, (voir la section Pilotes d'écran supportés), ce paramètre ne s'applique qu'à ce pilote; sinon il s'applique à tous les pilotes. Pour une description des paramètres acceptés par un pilote en particulier, reportez-vous à sa documentation. Voir la ligne screen-parameters du fichier de configuration pour la sélection des paramètres par défaut à l'exécution.


Page suivante Page précédente Table des matières