Nom

xdvi - Afficheur de fichiers DVI pour le système X Window

Résumé

xdvi .nh [+[page]] [-s shrink] [-S density] [-nocolor] [-nogrey] [-gamma g] [-install] [-noinstall] [-p pixels] [-margins dimen] [-sidemargin dimen] [-topmargin dimen] [-offsets dimen] [-xoffset dimen] [-yoffset dimen] [-paper papertype] [-altfont font] [-nomakepk] [-mfmode mode-def[:dpi]] [-editor editor] [-sourceposition line[:col][ ]filename] [-nofork] [-l] [-rv] [-expert] [-shrinkbuttonn shrink] [-mgs[n] size] [-warnspecials] [-hush] [-hushchars] [-hushchecksums] [-safer] [-fg color] [-bg color] [-hl color] [-bd color] [-cr color] [-bw width] [-display host:display] [-geometry geometry] [-icongeometry geometry] [-iconic] [-font font] [-keep] [-copy] [-thorough] [-wheelunit pixels] [-dvipspath path] [-debug bitmask] [-version] dvi_file .hy

Description

xdvi est un programme qui fonctionne dans le système X window. Il est utilisé pour prévisualiser les fichiers dvi produits par tex (1).

Ce programme est capable d'afficher le fichier avec un facteur d'échelle (entier) et dispose aussi d'une « loupe » qui permet de voir momentanément une partie de l'image à l'échelle normale.

Avant d'afficher quoi que ce soit, il vérifie si le fichier dvi a changé depuis le dernier affichage. Si tel est le cas, xdvi se réinitialisera pour le nouveau fichier dvi . Pour cette raison, il faudrait éviter d'exposer tout ou partie de la fenêtre de xdvi quand *(Te& fonctionne. Cette fonctionnalité vous permet de visualiser plusieurs versions du même fichier en ne lançant xdvi qu'une fois.

En plus des touches du clavier, xdvi permet de se déplacer dans le fichier grâce à des boutons placés sur le côté droit de la fenêtre, ceux-ci ayant la même fonction qu'une séquences de touches.

Options

En plus de pouvoir indiquer le fichier dvi (avec l'extension .dvi ou non), xdvi accepte les options suivantes sur sa ligne de commande. Si l'option commence par un ` + ' au lieu d'un ` - ', l'option retrouve sa valeur par défaut. Ces options peuvent être données via les noms de ressources donnés entre parenthèses dans la description de chacune d'elles.
+ page

Spécifie la première page à afficher. Si + n'est pas suivi d'un nombre, la dernière page est utilisée ; la première page est la valeur par défaut.

-altfont police ( .altFont )

Déclare une police par défaut en remplacement lorsqu'une police du fichier dvi ne peut être trouvée. Ceci est utile, par exemple, avec les polices PostScript <tm>.

-background couleur ( .background )

Détermine la couleur de fond. Équivalent à -bg .

-bd couleur ( .borderColor )

Détermine la couleur du bord de la fenêtre.

-bg couleur ( .background )

Détermine la couleur de fond.

-bordercolor couleur

Équivalent à -bd .

-borderwidth largeur ( .borderWidth )

Spécifie la largeur du bord de la fenêtre. Équivalent à -bw .

-bw largeur ( .borderWidth )

Spécifie la largeur du bord de la fenêtre.

-copy ( .copy )

Utilisez toujours l'opération copy lors de l'affichage des caractères. Cette option peut être nécessaire pour un fonctionnement correct sur un affichage couleur, mais les caractères barrés seront incorrects. Si l'anti-crénelage en niveaux de gris est utilisé, l'option -copy désactivera l'utilisation des plans couleur et n'affichera pas correctement les caractères barrés. Voir aussi -thorough .

-cr couleur ( .cursorColor )

Détermine la couleur du curseur. La couleur par défaut est celle du bord de la page.

-debug bitmask ( .debugLevel )

Si elle est différente de zéro, cette option affiche des informations de débogage additionnelles sur la sortie standard. Le masque de bits devrait être donné sous la forme d'un nombre décimal. Les valeurs des bits sont définies dans le fichier source xdvi.h .

-density densité ( .densityPercent )

Détermine la densité utilisée lors de la mise à l'échelle des « bitmaps » pour les polices. Plus la valeur sera grande, plus claire sera la police. La valeur par défaut est 40. Si l'affichage est en niveaux de gris, cette option est inopérante ; utilisez -gamma à la place. Voir aussi la touche ` S ' . Équivalent à -S .

-display hôte:écran

Spécifie l'hôte et l'écran à utiliser pour l'affichage du fichier dvi file. Par défaut ceci est obtenu à partir de la variable d'environnement DISPLAY.

-dvipspath chemin ( .dvipsPath )

Utilise la commande path en tant que programme dvips pour l'impression. Par défaut on utilise dvips .

-editor éditeur ( .editor )

Spécifie l'éditeur à invoquer pour lire le fichier source correspondant au fichier dvi . Pour plus de détails sur la marche à suivre, voir la section intitulée INFORMATIONS SOURCES SPÉCIALES

-expert ( .expert )

Empêche l'affichage des boutons. Voir aussi la touche ` x ' .

-fg couleur ( .foreground )

Détermine la couleur du texte (avant-plan).

-foreground couleur

Équivalent à -fg .

-font police ( *font )

Détermine la police à utiliser pour les boutons.

-gamma gamma ( .gamma )

Contrôle l'interpolation des couleurs pour la palette des couleurs de l'anti-crénelage en niveaux de gris. La valeur par défaut est 1,0. Pour 0 < gamma < 1, la police sera plus claire (plus proche de la couleur du fond), et pour gamma > 1, la police sera plus sombre (plus proche de la couleur d'avant-plan). Les valeurs négatives se comportent de la même façon, mais utilisent un algorithme légèrement différent. Pour les affichages couleur et en niveaux de gris ; pour les affichages monochromes, voir -density . Voir aussi la touche ` S ' .

-geometry géométrie ( *geometry )

Spécifie la géométrie initiale de la fenêtre.

-hl couleur ( .highlight )

Détermine la couleur du bord de la page. La valeur par défaut est celle de l'avant-plan.

-hush ( .Hush )

Demande à xdvi de supprimer tous les messages d'avertissement possibles.

-hushchars ( .hushLostChars )

Demande à xdvi de supprimer les messages d'avertissement concernant les références aux caractères qui ne sont pas définis dans la police.

-hushchecksums ( .hushChecksums )

Demande à xdvi de supprimer les messages d'avertissement concernant les erreurs de « checksum » entre le fichier dvi et le fichier de police.

-icongeometry géométrie ( .iconGeometry )

Spécifie la position initiale de l'icône.

-iconic ( .iconic )

Demande à xdvi de démarrer icônifié. Le comportement par défaut est de démarrer avec une fenêtre ouverte.

-install ( .install )

Si xdvi fonctionne dans un visuel PseudoColor , (par défaut) il vérifiera s'il y a un visuel TrueColor avec plus de bits par pixel, et commutera vers un tel visuel s'il existe. Sinon il utilisera le visuel courant et la palette de couleurs actuelle. Si l'option -install est sélectionnée, par contre, il utilisera aussi un visuel TrueColor avec une plus grande profondeur de pixels, s'il y en a un disponible ; sinon il installera sa propre palette de couleur sur le visuel courant. Si le visuel courant n'est pas PseudoColor , alors xdvi ne changera pas de visuel ni de palette de couleurs, quelle que soit cette option. La valeur par défaut de la ressource install est la valeur spéciale maybe . Il n'y a pas d'option +install . Voir aussi l'option -noinstall , et la section NIVEAUX DE GRIS ET LES PALETTES DE COULEURS.

-keep ( .keepPosition )

Positionne un drapeau pour indiquer que xdvi ne devrait pas revenir en début de page quand il passe à une nouvelle page. Voir aussi la touche ` k ' .

-l ( .listFonts )

Affiche la liste des polices utilisées.

-margins dimen ( .Margin )

Spécifie la taille des marges du haut et des côtés. Cela détermine la position de début de la page à l'intérieur de la fenêtre comme suit. Si la page tient dans la fenêtre, les positionnements des marges sont ignorés. Si, même après avoir enlevé les marges de gauche, de droite, du haut et du bas, la page déborde de la fenêtre, la page sera affichée de telle sorte que les marges haute et gauche seront cachées, et normalement le coin haut-gauche du texte sera en haut à gauche de la fenêtre. La dimension devrait être un nombre décimal qui peut être suivi par toute abréviation de deux lettres d'unités acceptées par *(Te& ( pt , pc , in , bp , cm , mm , dd , cc , ou sp ). Par défaut, l'unité sera en (pouces) [NDT : un pouce vaut 2,54 cm]. -sidemargin , -topmargin , et la touche ` M .'

-mfmode mode-def[:dpi] ( .mfMode )

Spécifie une chaîne de caractères mode-def qui peut être utilisée lors de la recherche des polices (voir ENVIRONNEMENT, plus bas). Généralement, si vous changez le mode-def , il faut aussi changer la taille de police en une valeur appropriée pour ce mode. Pour ce faire, ajoutez « : » et la valeur en points par pouce ; par exemple, -mfmode ljfour:600 . Cette valeur prévaudra sur celle donnée par la ressource pixelsPerInch ou l'argument -p de la ligne de commande. Le mode metafont est aussi passé à metafont lors de la création automatique de polices. Par défaut, la valeur est cx:300 .

-mgs taille

Équivalent à -mgs1 .

-mgs[n] taille ( .magnifierSize[n] )

Spécifie la taille de la fenêtre à utiliser pour la « loupe » associée au bouton n . La taille peut être donnée par un entier (indiquant que la loupe doit être carrée), ou sous la forme largeur x hauteur . Voir la section ACTIONS DE LA SOURIS. Les valeurs par défaut sont 200x150, 400x250, 700x500, 1000x800, et 1200x1200.

-nocolor ( .color )

Désactive l'utilisation de couleurs spéciales. Cette option peut être basculée avec la touche ` C ' . (Pour cette option, la signification de la ressource correspondante est inversée : -nocolor correspond à color:off ; +nocolor à color:on .)

-nofork ( .fork )

Quand l'argument -sourceposition est utilisé et qu'il n'y a aucune instance appropriée de xdvi déjà lancée, le comportement par défaut de xdvi est de se lancer en tâche de fond (comme s'il était un démon). A contrario, cet argument le fait se lancer en tâche normale. Ceci est utile pour le débogage ou quand xdvi est lancé par des macros incorrectes d' emacs . Si aucun argument -sourceposition n'est spécifié, cette option n'a aucun effet. (Pour cette option, la signification de la ressource correspondante est inversée : -nofork correspond à fork:off ; +nofork à fork:on .)

-nogrey ( .grey )

Désactive l'utilisation de l'anti-crénelage en niveaux de gris lors de l'impression de « bitmaps » réduits. (Pour cette option, la signification de la ressource correspondante est inversée : -nogrey correspond à grey:off ; +nogrey à grey:on .) Voir aussi la touche ` G ' .

-noinstall ( .install )

Empêche le comportement par défaut qui consiste à passer à un visuel TrueColor s'il y en a un disponible avec plus de bits par pixel que le visuel courant. Cette option correspond à la ressource install:off . Il n'y a pas d'option +noinstall . Voir aussi -install , et la section NIVEAUX DE GRIS ET PALETTES DE COULEURS.

-nomakepk ( .makePk )

Désactive la création automatique de fichiers de police qui ne peuvent être trouvés par d'autres moyens. (Pour cette option, la signification de la ressource correspondante est inversée : -nomakepk correspond à makePk:off ; +nomakepk à makePK:on .)

-offsets dimen ( .Offset )

Spécifie les tailles des décalages horizontaux et verticaux de la sortie sur la page. Par un décret du Projet « Stanford *(Te& Project », l'origine par défaut de la page de *(Te& est toujours 1 pouce plus bas et à droite du coin haut-gauche de là, même quand la taille de papier utilisée n'est pas un standard américain. Par conséquent les décalages par défaut sont d'un pouce. L'argument dimen devrait être un nombre décimal qui peut être suivi par toute abréviation de deux lettres d'unités acceptées par *(Te& ( pt , pc , in , bp , cm , mm , dd , cc , ou sp ). Par défaut, l'unité sera en (pouces ) [NDT : un pouce vaut 2,54 cm]. Voir aussi -xoffset et -yoffset .

-p pixels ( .pixelsPerInch )

Définit la taille des polices en pixels par pouce. La valeur par défaut est de 300. Cette option est fournie seulement pour la compatibilité ascendante ; il est préférable de spécifier la taille des polices en donnant le mode de Metafont en même temps ; voir l'option -mfmode .

-paper type de papier ( .paper )

Spécifie la taille de la page une fois imprimée. Elle peut être donnée sous la forme largeurxhauteur, suivie optionnellement par une unité où largeur et hauteur sont des nombres décimaux donnant respectivement la hauteur et la largeur du papier, et l'unité est une abréviation de deux lettres acceptée par *(Te& ( pt , pc , in , bp , cm , mm , dd , cc , ou sp ). Par défaut, l'unité sera en (pouces) [NDT : un pouce vaut 2,54cm]. D'autres synonymes peuvent être utilisés : us (8.5x11 pouces), legal (8.5x14 pouces), foolscap (13.5x17 pouces), tout comme les tailles ISO a1 - a7 , b1 - b7 , c1 - c7 . Chacune a de plus une variante paysage [NDT : « rotated » en anglais] : usr (11x8.5 pouces), a1r - a7r , etc. La taille par défaut est de 8,5 x 11 pouces.

-rv ( .reverseVideo )

Affiche la page en blanc sur fond noir, à l'inverse de l'affichage usuel.

-s réduction ( .shrinkFactor )

Définit le facteur de réduction initial. La valeur par défaut est 3. Si réduction est donnée nulle, le facteur de réduction est calculé de façon que la page tienne dans la fenêtre (comme si la touche « s » avait été frappée sans donner de nombre).

-S densité ( .densityPercent )

Équivalent à -density , q.v.

-safer ( .safer )

Cette option active toutes les options de sécurité disponibles ; elle est prévue pour l'utilisation de xdvi par un navigateur qui a obtenu un fichier dvi ou *(Te& depuis un autre site. Dans le cas présent, cette option est acceptée mais elle n'a aucun effet puisque xdvi a été compilé sans le support pour les commandes spéciales de PostScript.

-shrinkbutton n réduction ( .shrinkButtonn )

Spécifie que le n ième bouton de changement du facteur de réduction devra le changer au facteur réduction. Ceci est utile, par exemple, lorsqu'on utilise des polices 600 dpi ([NDT : dpi = points par pouce]), puisque dans ce cas, réduire d'un facteur 4 n'est pas suffisant. Ici n peut être un nombre de 1 à 3 (dans le positionnement par défaut, le bouton « pleine taille » ([NDT : « Full size »]) n'est pas affecté par ces options). Si les boutons sont personnalisés, des valeurs plus grandes de n (jusqu'à 9) peuvent être utilisées.

-sidemargin dimen ( .sideMargin )

Spécifie la marge de côté (voir l'option -margins ).

-sourceposition ligne[:col][ ]nom de fichier ( .sourcePosition )

Cette option demande à xdvi de chercher dans le fichier dvi la position correspondant à la ligne indiquée (et, optionnellement, la colonne) dans le fichier source .tex, et de la signaler en entourant le texte correspondant d'un rectangle de couleur forte (voir l'option -hl ) De plus, quand xdvi est lancé avec cet argument (et que l'option -nofork est inactive), il s'arrêtera immédiatement : s'il trouve une autre instance de xdvi affichant fichier_dvi , il fera passer cette fenêtre en avant-plan en déplaçant l'affichage à la position donnée du fichier dvi ; sinon il lancera sa propre instance en tâche de fond. Cette option requiert que le fichier fichier_dvi soit préparé avec des informations sources spéciales. Voir la section INFORMATIONS SOURCES SPÉCIALES pour plus de détails.

-thorough ( .thorough ) xdvi

s'assure normalement que les caractères barrés, par exemple enotin ) sont affichés correctement. Sur des écrans monochromes, cela est toujours possible en utilisant une opération logique, soit et soit ou . Sur un écran couleur, en revanche, cela peut demander deux opérations, une pour positionner les bits appropriés, et une autre pour effacer les autres. Si c'est la cas, xdvi utilisera alors par défaut l'opération copy qui ne traite pas correctement les caractères barrés. L'option -thorough choisit une méthode plus lente, mais correcte. Voir aussi -copy .

-topmargin dimen ( .topMargin )

Spécifie les marges haute et basse (voir -margins ).

-version

Affiche la version de xdvi .

-warnspecials ( .warnSpecials )

Demande à xdvi d'afficher les messages d'avertissement pour les chaînes de caractères especiales qu'il ne peut traiter.

-wheelunit pixels ( .wheelUnit )

Définit le déplacement en pixels de l'image vers le haut et le bas à effectuer lors d'une rotation de la molette de la souris. Si ce nombre est zéro cela désactivera la molette. La valeur par défaut est de 80.

-xoffset dimen ( .xOffset )

Spécifie la taille du décalage horizontal de la sortie sur la page. Voir -offsets .

-yoffset dimen ( .yOffset )

Spécifie la taille du décalage vertical de la sortie sur la page. Voir -offsets .

Touches

xdvi reconnaît les touches suivantes si elles sont utilisées dans sa fenêtre. Chacune d'elles peut être précédée par un nombre (positif ou négatif), dont l'interprétation dépendra de la touche frappée. De plus, les touches « Début », « Page précédente », « Page suivante », et les touches « flèches » sont synonymes des touches ` ^ ', ` b ', ` f ', ` l ', ` r ', ` u ', et ` d ' , respectivement.

Les touches données ici sont celles que xdvi assigne par défaut. Elles peuvent être changées--voir la section PERSONNALISATION, plus bas. Le nom apparaissant entre crochets au début des définitions de touches qui suivent est celui qui est assigné à l'action associée à utiliser quand vous les personnalisez. Les utilisateurs qui ne personnalisent pas les définitions de touches peuvent ne pas tenir compte des ces noms.
q [ quit() ]

Quitte le programme. Control-C et control-D ont le même effet.

n [ forward-page() ]

Déplace jusqu'à la page suivante (ou jusqu'à la n ème page suivant celle en cours, si un nombre est donné). Les synonymes sont ` f ', « Entrée », et saut de ligne.

Espace [ down-or-next() ]

Déplace vers le bas de deux tiers de fenêtre, ou à la page suivante si l'on est déjà en bas de la page.

p [ back-page() ]

Déplace à la page précédente (ou de n pages en arrière si un nombre a été donnée). Les synonymes sont ` b ' et control-H.

Suppr [ up-or-previous() ]

Déplace vers le haut de deux tiers de fenêtre, ou à la page précédente si l'on est déjà en haut de la page. La touche « Retour en arrière » a le même effet.

g [ goto-page() ]

Déplace à la page dont le numéro est donné. Initialement, la première page est considérée comme la page numéro 1, mais cela peut être changé avec la touche ` P ' décrite plus bas. Si aucun numéro de page n'est donné c'est la dernière page qui est sélectionnée.

P [ declare-page-number() ]

« Cette page est la page numéro n . » Ceci peut être utilisé pour que la touche ` g ' se réfère à des numéros de pages réels plutôt qu'à des numéros de page absolus.

Control- L [ forward-page(0) ]

Réaffiche la page courante.

^ [ home() ]

Se déplace jusqu'à la position « début » de la page. Il s'agit normalement du coin en haut à gauche de la page, en tenant compte des marges fixées par l'option -margins , décrite plus haut.

u [ up() ]

Déplace vers le haut de deux tiers de fenêtre.

d [ down() ]

Déplace vers le bas de deux tiers de fenêtre.

l [ left() ]

Déplace vers la gauche de deux tiers de fenêtre.

r [ right() ]

Déplace vers la droite de deux tiers de fenêtre.

c [ center() ]

Déplace la page de façon que le point sous le curseur soit déplacé au centre de la fenêtre. Le curseur est aussi positionné au centre.

M [ set-margins() ]

Spécifie les marges de façon que le point sous le curseur soit le coin haut gauche du texte dans la page. Notez que cette commande ne bouge pas l'image. Pour plus de détails sur l'usage des marges, voir l'option -margins .

Control- P

Affiche une nouvelle fenêtre pour permettre à xdvi d'imprimer le fichier dvi ou plusieurs pages de celui-ci. La fenêtre ouverte ne demande pas de commentaires particuliers, mais la fenêtre montrant l'état d'avancement de dvips accepte l'action de certaines touches qui ne sont pas évidentes. Dans cette seconde fenêtre Control- C est équivalent à un clic sur le bouton Annuler , « Entrée » est équivalent à un clic sur le bouton Fermer , et Control- S et Control- Q sélectionnent et désélectionnent, respectivement, l'option qui détermine si la fenêtre d'impression doit rester ouverte après la fin du travail de dvips .

s [ set-shrink-factor() ]

Met le facteur de réduction à la valeur donnée. Si aucun nombre n'a été donné, le plus petit facteur de réduction qui fasse que la page entière tienne dans la fenêtre est utilisé (Les marges sont ignorées lors de ce calcul).

S [ set-density() ]

Spécifie le facteur de densité à utiliser lors des réduction des « bitmaps ». La valeur devrait être un entier entre 0 et 100 ; les valeur élevées produisent des caractères plus fins. Si le mode d'échelle en niveaux de gris est en action, cette commande change plutôt la valeur de gamma. La nouvelle valeur de gamma est le nombre donné divisé par 100 ; les valeurs négatives sont autorisées.

R [ reread-dvi-file() ]

Demande que le fichier dvi soit relu. Ceci vous permet de visualiser plusieurs versions du même fichier en ne lançant xdvi qu'une fois.

k [ set-keep-flag() ]

Normalement quand xdvi change de page, il se positionne aussi au début de la page. La touche ` k ' bascule un drapeau « maintenir la position » qui, quand il est levé, assure que la position est gardée lors des changements de page. ` 0k ' et ` 1k ' baisse et lève ce drapeau, respectivement. Voir aussi l'option -keep .

x [ set-expert-mode() ]

Bascule en mode expert (dans lequel aucun bouton n'est affiché). ` 0x ' et ` 1x ' permettent aussi de sortir et d'entrer dans ce mode, respectivement. Voir aussi l'option -expert .

G [ set-greyscaling() ]

Cette touche bascule l'utilisation de l'anti-crénelage en niveaux de gris lors d'affichage de « bitmaps » réduits. De plus les séquences de touches ` 0G ' et ` 1G ' la désactivent et l'activent, respectivement. Voir aussi l'option -nogrey .

C [ set-color() ]

Cette touche bascule l'utilisation de couleurs spéciales. Les séquences de touches ` 0C ' et ` 1C ' désactivent et activent l'utilisation de couleurs spéciales, respectivement. Voir aussi l'option -nocolor .

Actions de la souris

Si le facteur de réduction est fixé à un nombre différent de un, un clic de l'un des boutons de la souris provoquera l'affichage d'une loupe grossissante qui montrera l'image non réduite au voisinage de la position de la souris. Cette sous-fenêtre disparaîtra dès que le bouton est relâché. Les différents boutons de la souris produisent des fenêtres de tailles différentes comme indiqué par l'option -mgs . Tout déplacement de la souris en maintenant le bouton appuyé, déplacera la loupe grossissante. Pour avoir accès à cet outil via la personnalisation, utilisez l'action magnifier . Son argument est soit une chaîne de caractères de la forme largeur x hauteur , tout comme dans l'option de ligne de commandes -mgs n , ou l'une des chaînes de caractères suivantes *1 jusqu'à *5 , qui se réfèrent à la valeur spécifiée par l'option -mgs n correspondante.

Les barres de défilement (si elles sont visibles) se comportent de façon standard : appuyer sur le bouton 2 dans une barre de défilement déplace le bord haut ou gauche du curseur jusqu'à ce point, et optionnellement le fait glisser; presser le bouton 1 déplace l'image vers le haut ou vers la droite de la même distance que celle qu'il y a entre la position de la souris et le coin haut-gauche de la fenêtre ; presser le bouton 3 déplace l'image vers le bas ou vers la gauche de la même distance.

L'image peut aussi être déplacée en maintenant la touche shift et un bouton de la souris appuyés. La combinaison Shift-bouton 1 n'autorise que le déplacement vertical et Shift-bouton 3 le déplacement horizontal et Shift-bouton 2 permet les deux. Pour accéder à ces actions via la personnalisation, utilisez l'action drag . Cette action prend un paramètre, les caractères « | », « - », ou « + », indiquant un déplacement vertical, horizontal ou les deux.

La molette de souris est prise en compte : les mouvements de la molette déplacent l'image vers le haut ou le bas d'un nombre de pixels fixé par l'option -wheelunit . Pour accéder à ces actions via la personnalisation, utilisez l'action wheel . Cette action prend un paramètre, donnant l'amplitude du déplacement de l'image. Si le paramètre contient un point décimal, la distance est donnée en unité de molette, sinon elle est donnée en pixels.

Actions non liÉes À une touche

Les actions suivantes ne sont liées à aucune touche, mais sont disponibles si l'on utilise la personnalisation.
shrink-to-dpi()

Cette action prend un argument (obligatoire). Elle fixe le facteur de réduction à un entier pour utiliser des polices de caractères avec le nombre de points par pouce spécifié par l'argument. Si xdvi utilise des polices ayant p points par pouce et que l'argument de shrink-to-dpi est n , alors le facteur de réduction correspondant est le quotient p / n , arrondi au plus proche entier.

Personnalisation

Les actions assignées aux touches et au bouton de la souris peuvent être changées en donnant à la ressource mainTranslations une chaîne de traductions comme définie dans la documentation de la boîte à outil X. Les actions devraient être sous le forme décrite dans les sections TOUCHES et ACTIONS DE LA SOURIS.

Les actions assignées aux touches n'ont en général pas d'arguments, ou ceux-ci servent à remplacer un nombre tapé immédiatement avant la touche d'action. Les touches 0 - 9 et le tiret de césure ne peuvent être réassignées, puisqu'elles sont utilisées pour entrer les nombres.

Certaines actions peuvent prendre des arguments spéciaux, comme suit. L'argument de goto-page peut être la lettre ` e ', ce qui indique que le déplacement doit se faire jusqu'à la fin du document. L'argument de set-shrink-factor peut être la lettre ` a ', ce qui indique que le facteur de réduction doit être fixé à la plus petite valeur permettant à la page de tenir dans la fenêtre. Les actions up , down , left , right , up-or-previous , et down-or-next peuvent prendre un nombre décimal comme argument, qui indique de quelle fraction de fenêtre le mouvement doit s'effectuer (au lieu des deux tiers). Enfin, pour les actions de basculement d'un drapeau, telles que set-keep-flag , l'argument peut être la lettre ` t ', qui indique que l'action devrait basculer le drapeau quel que soit le nombre qui a été tapé récemment.

Les actions de la souris devraient se référer seulement aux événements ButtonPress (par exemple <Btn1Down>:magnifier(*1) ). Les événements de déplacement et de relâchement correspondants seront alors traités de façon interne. Une action assignée à une touche peut aussi l'être à un événement de souris, mais pas l'inverse.

En général les chaînes de traduction devraient commencer par « #override », pour indiquer que les actions assignées par défaut aux touches et aux boutons de la souris ne doivent pas être détruites.

Quand des touches ou des boutons de la souris impliquant des modificateurs (comme Ctrl ou Shift) sont personnalisés et leurs versions non modifiées aussi, la version modifiée doit être personnalisée en premier, par exemple :

.nf .ft 3 1n XDvi.mainTranslations: #override Ctrl<Btn1Down>: magnifier(*3) Shift<Btn1Down>: magnifier(*2) <Btn1Down>: magnifier(*1) 1n .ft .fi

Comme xdvi a besoin de capturer les événements de déplacements du pointeur et que le mécanisme de traitement de la boîte à outils X [NDT : X Toolkit en anglais] ne peut pas combiner les évènements de déplacements et de double-cliques en même temps, il n'est pas possible de spécifier des actions liées aux double-cliques dans les personnalisations de xdvi . Pour plus d'informations sur ceci et d'autres aspects des traductions, voir la documentation « X Toolkit Intrinsics documentation ».

Il n'y a aucune option de ligne de commandes pour spécifier la ressource mainTranslations puisque changer celle-ci sur la ligne de commande serait trop complexe. Par contre, voyez la section EXEMPLES DE PERSONNALISATION pour plus d'informations sur la spécification de ressource en vue de test en utilisant l'option de ligne de commandes -xrm .

Le support de souris à molette est contrôlé par la ressource wheelTranslations . Généralement la seule action utilisée par cette ressource devrait être wheel . La valeur par défaut est « <Btn4Down>:wheel(-1.)
<Btn5Down>:wheel(1.) ». Comme cette ressource est implémentée différemment des autres, elle ne devrait pas commencer par « #override » ; quand une valeur est spécifiée pour cette ressource, toutes les actions de la molette devraient être mentionnées.

Les noms des boutons et des actions peuvent aussi être personnalisés de façon similaire. Dans ce cas, la ressource buttonTranslations devrait être une chaîne de caractères décrivant le nom du bouton et l'action associée. La chaîne de caractères est formée de sous-chaînes séparées par le caractère de fin de ligne (`
'), chacune décrivant un bouton. Chaque sous-chaîne est formée du nom du bouton suivi de « : » et une suite d'actions à effectuer lors de l'activation du bouton. À la différence des actions déclenchées par une touche, une action associée à un bouton devrait fournir un argument (si cela a un sens).

La chaîne de caractères formant le nom du bouton peut contenir une indication couleur si elle est insérée dans une séquence d'échappement aux moyens de l'anti-slash ([NDT : ou backslash]) (`\'). Elle peut aussi contenir des séquences spéciales liées aux options de la ligne de commande -shrinkbutton n . Les caractères ` $# ' sont remplacés par l'argument de l'option -shrinkbutton correspondante (si elle est présente). S'il n'y a pas d'option -shrinkbutton correspondante, la valeur est sélectionnée dans la liste des actions qui doit alors contenir au moins une action set-shrink-factor ou shrink-to-dpi . De même la séquence de caractères ` $% ' est remplacée par la valeur du facteur de réduction (en pourcents) déterminé comme ci-dessus. Pour que l'option -shrinkbutton affecte un bouton donné, la chaîne de caractères du nom doit contenir une des séquences suivantes ` $# ', ` $% ', ou ' $_ '. La dernière chaîne indique que l'option -shrinkbutton doit affecter un bouton sans qu'aucun nombre n'apparaisse dans le nom du bouton (le ` $_ ' n'apparaîtra pas dans le nom).

Certaines ressources sont fournies pour permettre la personnalisation de la géométrie des boutons de commande et le timing de la fenêtre lors de son apparition quand dvips traite un requête d'impression. Ils ne sont pas modifiable par les options de la ligne de commande autrement que par l'option -xrm . Toutes ces ressources prennent des valeurs entières.
buttonSideSpacing

Le nombre de pixels à placer de chaque côté du bouton. La valeur par défaut est 6.

buttonTopSpacing

Le nombre de pixels entre le bouton le plus haut et le bord de la fenêtre. La valeur par défaut est 50.

buttonBetweenSpacing

Le nombre de pixels entre les boutons. La valeur par défaut est 20.

buttonBetweenExtra

Le nombre de pixels d'espace additionnel à insérer si la ressource buttonTranslations contient un caractère de fin de ligne supplémentaire. La valeur par défaut est 50.

buttonBorderWidth

La largeur du bord des boutons. La valeur par défaut est 1.

dvipsHangTime

Le temps, en millisecondes, pendant lequel la fenêtre du « processus d'impression Xdvi » persistera après la fin du traitement d'une requête d'impression par dvips . La valeur par défaut est 700 (0,7 seconde). Si cette valeur est négative ou nulle, la fenêtre restera ouverte jusqu'à ce que l'utilisateur la ferme.

dvipsFailHangTime

Même rôle que dvipsHangTime , sauf qu'elle s'applique si dvips retourne un état indiquant une erreur. La valeur par défaut est 3000 (3 secondes).

Exemples de personnalisation


Certains utilisateurs préfèrent que la fenêtre défile progressivement quand ils pressent les touches flèches, plutôt qu'un déplacement de grande amplitude. Pour spécifier ce type de défilement, la ressource suivante peut être utilisée.

.nf .ft 3 1n XDvi.mainTranslations: #override <Key>Up:up(.01) <Key>Down:down(.01) <Key>Left:left(.01) <Key>Right:right(.01) 1n .ft .fi

Pour spécifier la ressource mainTranslations en vue de faire des test, utilisez l'option de ligne de commande -xrm fournie par le « X toolkit ». Par exemple,

.nf .ft 3 1n xdvi -xrm 'XDvi.mainTranslations: #override "z":quit()' ... 1n .ft .fi

or

.nf .ft 3 1n xdvi -xrm 'XDvi.mainTranslations: #override <Key>z:quit()' ... 1n .ft .fi

spécifie que l'appui sur la touche ` z ' provoque l'arrêt de xdvi . Cette méthode marche aussi pour d'autres ressources.

Informations sources spÉciales

Si les fichiers dvi sont préparés correctement, xdvi est capable d'appeler un éditeur à l'endroit du fichier correspondant à tout point donné dans la sortie ( « recherche inverse »). Il peut aussi être utilisé pour aller au point du fichier dvi correspondant à une ligne donnée (et optionnellement à une colonne) dans un fichier source donné (« recherche avant »). Ces deux possibilités requièrent que la version de *(Te& utilisé pour produire le fichier dvi soit compilé avec le support des « informations sources spéciales », et que l'argument -src-specials soit utilisé sur la ligne de commande lors de l'exécution de *(Te&. (Certains paquets de macros adéquats peuvent aussi suffire pour cette fonctionnalité. En fait, les informations de numéros de colonnes ne sont fournis dans aucune version de *(Te&, elles doivent l'être par un paquet de macros. En effet les informations de numéros de colonne rendraient le fichier dvi trop gros; seules des applications très spécialisées en ont besoin).

Recherche inverse . La recherche inverse est faite en se déplaçant à la souris jusqu'à la position désirée sur la page affichée par xdvi , et en appuyant alors sur le bouton 1 et la touche Control du clavier.

À chaque utilisation de cette commande, un nouvelle instance de l'éditeur est invoquée (la commande de l'éditeur peut être un programme tel que emacsclient , par exemple, qui passe l'information à une instance d'un éditeur qui est déjà lancée). L'éditeur est spécifié par l'option de ligne de commande -editor , la ressource .editor ou les variables d'environnement XEDITOR, VISUAL, ou EDITOR ; la première de ces possibilités détermine l'éditeur à appeler. Si aucune n'est donnée, l'éditeur Unix vi est utilisé. La valeur est une chaîne de caractères qui est passée en tant que commande shell dans laquelle les occurrences de « %f » sont remplacées par le nom du fichier, les occurrences de « %l » sont remplacées par le numéro de ligne dans le fichier et (si cela est géré), les occurrences de « %c » sont remplacées par le numéro de colonne dans la ligne. Si aucune occurrence de « %f » n'apparaît dans la chaîne, la chaîne « +%l %f » est ajoutée à la fin de la chaîne. Si l'éditeur a été spécifié par les variable d'environnement VISUAL ou EDITOR la chaîne « xterm -e » est ajoutée au début de la chaîne de caractères ; si l'éditeur a été spécifié par une autre moyen, la chaîne doit être donnée sous la forme d'une commande shell qui est capable d'ouvrir une fenêtre X contenant un éditeur.

Pour faciliter le débogage, la combinaison Ctrl bouton 2 trace des rectangles autour du premier symbole ou règle dans un fichier qui correspond à la ligne du source identifié par les informations spéciales de source. De plus, la combinaison Ctrl bouton 3 tracera de même des rectangles autour de tous les symboles et règles dans le fichier. Ces rectangles sont tracés dans la couleur spécifiée par la couleur de mise en valeur (l'option de ligne de commande -hl ou la ressource .highColor ). De plus les symboles et règles, certains symboles spéciaux de Postscript peuvent aussi être encadrés (ceux fournissant un cadre).

Le fichier à éditer est recherché en premier lieu dans le répertoire contenant le fichier dvi , puis dans le chemin spécifié par les variables d'environnement XDVISOURCES ou TEXINPUTS.

Recherche avant. La recherche avant est invoquée sur la ligne de commande (typiquement un éditeur de texte) en spécifiant l'argument -sourceposition. Le fichier dvi principal fichier_dvi est spécifié comme à l'habitude. « Recherche avant » signifie que xdvi essaiera d'ouvrir la page du fichier fichier_dvi correspondant au numéro de ligne donné (et, optionnellement, au numéro de colonne) dans le fichier .tex source nom_de_fichier , et mettra en lumière la position trouvée en traçant un rectangle dans la couleur highlight (voir l'option -hl) autour du texte correspondant.

De plus l'option -sourceposition demande à xdvi de fonctionner en mode client. « Mode client » signifie que si une autre instance de xdvi précédemment lancée sur cet affichage X visualise le même fichier fichier_dvi , une nouvelle instance lancée avec l'option -sourceposition notifiera à l'instance déjà en fonctionnement d'effectuer la recherche avant puis s'arrêtera. Si une telle instance de xdvi ne peut être trouvée, xdvi démarrera une nouvelle instance en tâche de fond. Dans les deux cas, quand xdvi fonctionne en mode client, il s'arrête immédiatement. Ceci est utile aux programmes (tels que des éditeurs de texte) qui peuvent lancer xdvi en mode client pour se déplacer à un position précise du fichier dvi correspondant à la position courante du curseur dans le fichier .tex sans que l'utilisateur n'ait besoin de fermer la fenêtre de xdvi pour continuer à éditer le fichier. (Notez, par contre, que si l'argument -nofork est donné sur la ligne de commande, ou que la ressource correspondante est spécifiée, le fonctionnement en mode client est un peu différent car xdvi ne se lancera pas en tâche de fond si il n'y a pas d'instance déjà lancée).

L'argument nom_de_fichier doit correspondre au nom de fichier utilisé pour les information spéciales de source dans le fichier dvi . L'espace précédent nom_de_fichier est facultatif ; il n'est nécessaire que pour éviter toute ambiguïté si nom_de_fichier commence par un chiffre ou deux points (« : »). Notez que l'argument doit être encadré de guillemets simples (« ' »), si l'espace est utilisé pour empêcher à l'interpréteur de commandes d'interpréter cet espace comme un séparateur d'argument.

Les information spéciales de source dans le fichier dvi doivent être dans l'un des formats suivants :

.nf 1n src:ligne[ ]nom_de_fichier src:ligne:col[ ]nom_de_fichier src:ligne src:ligne:col src::col 1n .fi

Si nom_de_fichier ou ligne est omis, la valeur la plus récente est utilisée. La première information spéciale de source de chaque page doit être dans l'une des deux premières formes, de façon que les valeurs par défaut ne soit pas héritées d'une page à l'autre.

Signaux

Quand xdvi reçoit un signal SIGUSR1 il relit le fichier dvi.

Informations spÉciales de couleur

Les informations spéciales de couleur gérées par xdvi sont les mêmes que celles de dvips , de façon que le paquet LaTeX color fonctionne avec xdvi . Reportez-vous à la documentation du paquet LaTeX color pour plus de détails sur leur utilisation, et aussi au fichier dvips.tex de documentation dvips pour plus de détails sur le syntaxe et la sémantique des informations spéciales de couleur.

Le support des informations spéciales de couleur inclut la même liste de couleurs prédéfinies que dvips , c'est-à-dire Apricot , Aquamarine , Bittersweet , Black , Blue , BlueGreen , BlueViolet , BrickRed , Brown , BurntOrange , CadetBlue , CarnationPink , Cerulean , CornflowerBlue , Cyan , Dandelion , DarkOrchid , Emerald , ForestGreen , Fuchsia , Goldenrod , Gray , Green , GreenYellow , JungleGreen , Lavender , LimeGreen , Magenta , Mahogany , Maroon , Melon , MidnightBlue , Mulberry , NavyBlue , OliveGreen , Orange , OrangeRed , Orchid , Peach , Periwinkle , PineGreen , Plum , ProcessBlue , Purple , RawSienna , Red , RedOrange , RedViolet , Rhodamine , RoyalBlue , RoyalPurple , RubineRed , Salmon , SeaGreen , Sepia , SkyBlue , SpringGreen , Tan , TealBlue , Thistle , Turquoise , Violet , VioletRed , White , WildStrawberry , Yellow , YellowGreen , YellowOrange . Il est à noter qu'il faut respecter la casse de ces noms.

Pour l'instant les macros ecolorbox et efcolorbox ne sont pas gérées.

Niveaux de gris et palettes de couleurs

La fonction d'anti-crénelage en niveaux de gris de xdvi ne sera pas optimale si l'affichage ne dispose pas de suffisamment de couleurs. Ceci peut arriver si d'autres applications monopolisent une grande partie de la palette de couleurs (même si elles sont icônifiées). Si cela arrive, xdvi affiche un message d'erreur et déclenche l'option -copy . Il en résulte un mauvais rendu des caractères gras ; l'affichage peut aussi être d'une piètre qualité si le nombre de couleurs disponibles est très faible.

Ce genre de problème arrive généralement sur des affichages qui allouent huit bits de mémoire vidéo par pixel. Pour voir combien de bits par pixel sont utilisés par votre affichage, tapez xwininfo dans un fenêtre xterm et cliquez dans la fenêtre racine quand cela vous sera demandée. L'entrée « Profondeur : » [NDT : « Depth: » en anglais] vous donnera alors le nombre de bits par pixel.

Les affichages utilisant au moins quinze bits par pixel sont typiquement des visuels TrueColor qui n'ont pas ce problème puisque leur palette de couleur est allouée de façon permanente et est disponible pour toutes les applications. (La classe de visuel est aussi affichée par xwininfo ). Pour plus d'informations sur les classes de visuels, reportez-vous à la documentation du système X Window.

Pour contourner ce problème on peut soit (a) utiliser plus de bits par pixel (ceci requerra plus de mémoire vidéo ou le remplacement de cette dernière), soit (b) fermer les autres application utilisant une bonne partie de la palette de couleur et ensuite redémarrer xdvi , ou (c) lancer xdvi avec l'option -install .

Netscape est une application qui est souvent la cause de ce problème. Dans ce cas il y a deux alternatives pour remédier à la situation. On peut utiliser « netscape -install » pour que Netscape installe une palette de couleurs privée. Cela peut induire des changements de couleurs bizarre quand la souris est déplacée à une autre fenêtre. Ou on peut utiliser « netscape -ncols 220 » pour limiter Netscape à un nombre réduit de couleurs. Un nombre plus petit de couleurs assurera que les autres applications auront plus de couleurs à leur disposition, mais aussi dégradera la qualité des couleurs dans la fenêtre de Netscape .

Environnement

DISPLAY

Spécifie quel terminal d'affichage graphique utiliser.

TEXMF

Indique le répertoire racine de l'arborescence *(Te& à utiliser lors de la recherche de fichiers. Cela devrait être une liste de répertoires séparés par des « : ». Un « : » supplémentaire dans cette variable incorpore les valeurs par défaut compilées. Voir la section RECHERCHE DE FICHIERS pour plus de détails.

XDVISIZES

Une liste de résolution de polices séparées par des « : ». Si une police ne peut être trouvée ou mise à la taille voulue, ces tailles sont essayées en dernier recours. xdvi essaye la taille réelle de la police avant d'essayer les tailles données. Chaque résolution de police devrait être un entier positif donnant le nombre de points par pouce, ou une chaîne de caractères de la forme magstepn , où n est un nombre -9.5, -9, -8.5, ..., 8, 8.5, 9, or 9.5. La chaîne magstep peut être abrégée en n'importe laquelle de ses sous-chaînes initiales (c'est-à-dire que magstep0.5 peut être abrégé en mag0.5 ou m0.5 (mais pas en mag.5 )). Les entrées magstep n signifient la valeur courante de pixels par pouce, multipliée par 1,2 à la puissance n et arrondie à l'entier le plus proche. Si la liste commence par un « : », la taille système par défaut est utilisée. Les tailles sont exprimées en points par pouce et doivent être des entiers. Les tailles par défaut sont m0 : m0.5 : m1 : m2 : m3 : m4 : m5. xdvi essaiera aussi la taille réelle de la police avant d'essayer les tailles données.

XDVIFONTS

Détermine les chemins dans lesquels il faut chercher les fichiers de polices pk et gf . Voir la section RECHERCHE DE FICHIERS pour plus de détails.

PKFONTS

Détermine les chemins dans lesquels il faut chercher les fichiers de polices pk et gf si XDVIFONTS n'est pas spécifiée.

TEXPKS

Détermine les chemins dans lesquels il faut chercher les fichiers de polices pk et gf si ni XDVIFONTS ni PKFONTS ne sont spécifiées.

TEXFONTS

Détermine les chemins dans lesquels il faut chercher les fichiers de polices pk et gf si aucune des variables XDVIFONTS, PKFONTS, et TEXPKS ne sont spécifiées. Si cette variable utilisée, elle ne devrait contenir aucun signe ` % ' puisque xdvi l'interprète comme un caractère spécial contrairement à d'autres applications.

XDVIVFS

Détermine les chemins dans lesquels il faut chercher les fichiers de polices virtuelles ( fichiers vf ). Voir la section RECHERCHE DE FICHIERS pour plus de détails.

VFFONTS

Détermine les chemins dans lesquels il faut chercher les polices vf si XDVIVFS n'est pas spécifiée. Si cette variable utilisée, elle ne devrait contenir aucun signe ` % ' puisque xdvi l'interprète comme un caractère spécial contrairement à d'autres applications.

XDVISOURCES

Détermine les chemins dans lesquels il faut chercher les fichiers sources lors de l'utilisation des possibilités des informations sources spéciales de xdvi .

TEXINPUTS

Détermine les chemins dans lesquels il faut chercher les fichiers sources si XDVISOURCES n'est pas spécifiée.

XEDITOR

Détermine la commande à exécuter pour lancer l'éditeur si ni l'option de ligne de commande -editor ni la ressource .editor ne sont spécifiées. Voir la section INFORMATIONS SOURCES SPÉCIALES pour plus de détails sur son format.

VISUAL

Détermine l'éditeur à exécuter dans une fenêtre xterm si ni -editor , ni .editor , ni XEDITOR n'est spécifié..

EDITOR

Détermine l'éditeur à exécuter dans une fenêtre xterm si ni -editor , ni .editor , XEDITOR, ni VISUAL n'est spécifié..

XDVIMAKEPK

Adresse du programme (et, optionnellement, l'ordre de ses arguments) à exécuter quand xdvi essaye de créer un fichier de police gf ou pk . Voir la section CRÉATION DE FICHIERS POLICES pour plus de détails.

Recherche de fichiers

Pour pouvoir s'accommoder de l'extrême variété du stockage des polices selon les sites, xdvi a un approche relativement élaborée pour indiquer où chercher les fichiers de polices. Pour d'autres types de fichiers, le mécanisme est similaire, mais plus simple. La méthode de recherche des fichiers pixels de polices sera décrite en premier lieu ; les autres types de fichiers le seront en deuxième lieu. Cette question est assez technique ; en première lecture, il est probablement plus sage de passer directement à la section EXEMPLES DE RECHERCHE DE POLICES.

La variable d'environnement XDVIFONTS (ou PKFONTS, etc., si XDVIFONTS n'est pas spécifiée) contient une liste de spécificateurs séparés par des « : ». Un « : » supplémentaire est remplacé par la valeur par défaut compilée. Ou bien, si aucune de ces variables d'environnement n'est utilisée, la valeur par défaut compilée est utilisée.

Dans chaque spécificateur, les substitutions suivantes sont effectuées :
%f

Remplacé par le nom de la police.

%F

Remplacé par le nom de la police (mais sans effets de bord, voir plus bas).

%d

Remplacé par la taille de la police (en points par pouce).

%b

Remplacé par la base de la résolution ; c'est-à-dire la valeur du paramètre -p ou de la ressource .pixelsPerInch .

%p

Remplacé par le fichier de format de la police (« pk » ou « gf »).

%m

Remplacé par mode-def , tel qu'il a été donné par l'argument -mfmode ou la ressource .mfMode .

%t

Remplacé, séquentiellement, par les répertoires donnés par la variable d'environnement TEXMF (ou sa valeur par défaut compilée). Ceci ne peut être utilisé qu'au début du spécificateur.

%s

Remplacé par « %qfonts/%p/{%m,modeless}// ». Ceci est compatible avec l'arborescence standard de *(Te&. Cette chaîne ne peut être utilisée qu'à la fin du spécificateur.

%S

Remplacé par « %t/%s ».

%q

Remplacé par la chaîne vide. Ceci a pour effet de bord de lancer la fonctionnalité « recherche rapide » décrite plus bas.

%Q

Remplacé par la chaîne vide. Comme %q , cela lance la fonctionnalité « recherche rapide ». Cela interdit aussi la recherche de fichiers par les voies normales si la fonctionnalité « recherche rapide » n'est pas disponible.

%

Remplacé par un signe de pourcentage. De même %: , %* , etc. peuvent être utilisés pour insérer ces caractères spéciaux dans la chaîne destination.

Si aucun [b]