Chapitre 6 Les commandes \special 

Tout \special ne commençant pas par em: est ignoré sans avertissement.

Les pilotes peuvent comprendre les \special suivants:

special{em:graph xxx} Insère un fichier graphique de nom xxx à cet endroit. Le coin supérieur gauche de la figure est localisé au point de référence d'un caractère s'il doit apparaître là. Vous pouvez utiliser MSP (MS Paint sous Windows 1.x et 2.x), PCX (Paintbrush) et des fichiers BMP noir et blanc. Les fichiers en mode PCX 4 couleurs CGA ne peuvent être utilisés. Les fichiers BMP encodés sur la longueur ne peuvent être utilisés. Tous les pixels non blancs d'un fichier PCX sont imprimés (en supposant une palette standard). Pour des raisons d'efficacité, l'utilisation des fichiers MSP (Windows 2.x) est recommandée. La largeur de la figure ne peut dépasser 32760 pixels, la hauteur ne doit pas dépasser 32766 pixels. Exemple (la taille de la figure est de 21pt par 23pt):

\begin{center}  \begin{picture}(21,23)  \put(0,23){\special{em:graph dvitrans.2}}  \end{picture}  \end{center}

Si un fichier graphique n'est pas trouvé alors que +batch-mode est actif, la figure sera omise et le message d'avertissement 1303 sera affiché. Si un fichier graphique n'est pas trouvé alors que +batch-mode est inactif, il vous sera demandé un nom pour le fichier graphique. Si vous entrez /d, la figure sera omise. si +change-mode est actif, il vous sera demandé un nom de fichier pour chaque commande \special{em:graph} avant que le pilote essaie d'ouvrir le fichier graphique. Si +omit-graphics:on est en action, \special{em:graph} est ignoré.

\special{em:point n[,[x],[y]]}

\special{em:line a[h|v|p],b[h|v|p][,width]}

\special{em:linewidth width}

\special{em:moveto}

\special{em:lineto}

Avec ces commandes des lignes peuvent être tracées selon tout angle désiré. Un point n (1 à 32767) est défini par \special{em:point n} et a les coordonnées du point de référence. Si x ou y ou les deux sont spécifiés, ces valeurs se substituent aux coordonnées du point de référence. Par exemple,

\special{em:point 1,10pt}

définit le point 1 10pt à droite de la marge gauche et avec la coordonnée Y du point de référence.

La commande \special{em:point n} peut être positionnée par l'environnement de LaTeX. Pour Plain TeX, voyez page 389 du TeXbook. Deux tels points peuvent être joints par une ligne: \special{em:line a,b,width} joint les points numérotés a et b par une ligne d'épaisseur +width -- l'épaisseur peut être donnée dans toute unité acceptable par l'option +unit sauf px. Les numéros de point peuvent être suivis d'un h, v ou p montrant comment la fin de la ligne doit être coupée. p la fait couper perpendiculairement à sa direction, h fait une coupure horizontale et v une coupure verticale. p est utilisé par défaut si aucun mode de coupure n'est spécifié. Notez qu'une ligne horizontale ne peut avoir une coupure horizontale ni une ligne verticale une coupure verticale!

Exemple:

\special{em:line 1,2v,4pt}

Les points n'ont pas à être définis avant les lignes qui s'y réfèrent. Les définitions de point et de ligne sont locales à la page courante.

Si un certain nombre de lignes de même épaisseur doivent être tracées, \special{em:linewidth width} peut être utilisé pour fixer l'épaisseur par défaut de toutes les lignes subséquentes sans argument +width -- \special{em:line a,b}. La valeur initiale de l'épaisseur par défaut est de 0.4pt; tout \special{em:line a,b} apparaissant AVANT une linewidth spéciale aura cette épaisseur. Pour éviter les erreurs, l'épaisseur requise de la ligne devra être fixée avant toute figure composée de lignes.

Il existe d'autres commandes de tracé de ligne. \special{em:moveto} fixe le point (de tracé) courant aux coordonnées du point de référence sans tracer de ligne: \special{em:lineto} dessine une ligne entre le point courant et le point de référence, ce dernier devenant alors le point courant. Un polygone peut être tracé avec un seul \special{em:moveto} et un nombre de commandes \special{em:lineto} subséquentes. La largeur de la ligne sera celle fixée par \special{em:linewidth width}.

\special{em:pcl chaîne de caractères} Cette commande est ignorée (sans message d'avertissement) par tous les pilotes sauf Dvihplj. Tous les blancs suivant directement em:pcl sont sautés. Les caractères restants sont copiés sans modification sur la sortie après déplacement du curseur au point de référence. L'exemple suivant imprime un rectangle gris de hauteur et largeur 0.5 in:

\special{em:pcl ^^1b*c15g360h360v2P}

\special{em:pclfile nom} Cette commande est ignorée (sans message d'avertissement) par tous les pilotes sauf Dvihplj. Le fichier nom est copié sans modification sur la sortie après déplacement du curseur au point de référence. Dvihplj cherche seulement le fichier de nom spécifié, c-à-d., dans le répertoire de travail courant si aucun nom de chemin absolu n'est donné. Exemple:

\special{em:pclfile myfile.pcl}