Mode d'emploi et manuel de référence

3.4 Attributs

Au minimum, on doit dire à ePiX la taille finale de la figure et les dimensions du rectangle cartésien à allouer. Le préambule doit contenir assez d'information pour créer un espace de travail. Dans le corps du fichier d'entrée, « l'état de dessin» détermine l'apparence de la figure. Les attributs sont des déclarations, ils sont fixés par des commandes qui acceptent des arguments du type déclaré, éventuellement void. Les couleurs et l'épaisseur des chemins sont controllées en écrivant immédiatement des commandes L^AT_EXiennes dans le fichier de sortie ; les autres attributs sont gérés en interne.

Mode angulaire : radians(), degrees() ou revolutions() ;
Épaisseur de chemin : plain(), bold(), pen(double);
Style de chemin :
- solid() ;
- dashed(double). L'argument facultatif est la densité de pointillé, fraction (de 0,05 à 0,95) du chemin occupé par les pointillés;
- dotted(double). L'argument facultatif est le diamètre (en pt) du dot.
Les commandes dash_length(double) et dot_sep(double) fixe la distance (en pt) entre les extrémités d'une ligne pointillées ou tiretées.
Couleur : rgb(densités), cmyk(densités), primary(densité). Une densité est un double compris entre 0 (pas de couleur) et 1 (saturation complète).
Remplissage : fill(bool), l'argument vaut true par défaut.
- Profondeur de gris gray(double), 0: blanc, 1 : noir;
- style de remplissage, couleur de remplissage de PSTricks.
Rotation de texte : label_angle(double)
Rognage et cadrage ;
Caméra.

Mode angulaire

ePiX a trois modes angulaires : radians() (valeur par défaut), degrees() et revolutions(). Ces modes affectent toutes les opérations trigonométriques, y compris les rotations de la caméra, le tracé des arcs et des ellipses, le tracé des courbes en polaires, les angles des étiquettes et les fonctions trigonométriques elles-mêmes. Les fonctions sensibles au mode angulaire ont un nom à capitale, p. ex. Cos, Tan.

Couleur et teinte

ePiX fournit une sortie en couleur par l'intermédiaire de l'extension pstcol, en utilisant les modèles rgb et cmyk. Les teintes de gris des régions sont obtenus à l'aide de eepic.sty (sans faire appel à pstcol). On voit mieux les couleurs après conversion du document au format PostScript ou PDF. Si l'on préfère, on pourra regarder les fichiers EPS grâce à xdvi.

Une couleur rgb est donnée par un triplet de décimaux fixant les densités entre 0 (pas de couleur) et 1 (saturation complète). Une couleur cmyk est déterminée de manière analogue par quatre décimaux. Les densités sortant du domaine [0,1] sont « rognées». Comme les styles de ligne, les couleurs restent actives jusqu'à ce qu'elles soient supplantées. On peut utiliser sept couleurs primaires et le blanc par leurs noms. Dessiner en blanc (white) peut servir de liquide de correction pour retirer des morceaux de manière précise.

  red();            // rgb(1,0,0);
  magenta(0.6);     // cmyk(0,0.6,0,0);
  rgb(0.2,0.7,0.8); // couleur personnelle

PSTricks

PSTricks est une puissante collection de macros, crée par Timothy van Zandt [7] et autres, pour incorporer du PostScript dans L^AT_EX. ePiX utilise PSTricks essentiellement pour le remplissage en couleur mais ne fonctionne pas encore de manière intégrée. On ne devrait utiliser PSTricks dans un fichier qu'en cas d'absolue nécessité. Ce qui suit suppose qu'on a besoin de PSTricks pour le fichier. La commande

  use_pstricks(bool);

fixe un drapeau interne qui détermine si un chemin est tracé comme un chemin path de eepic ou une psline de PSTricks. Lorsqu'elle est émise avant le begin(), cette commande synchronise également l'unitlength et l'épaisseur de ligne de PSTricks avec celles de ePiX et fixe le style de remplissage à « plein». On peut activer et désactiver PSTricks à volonté mais la première activation doit être faite dans le préambule.

Quand pstricks est activé, les commandes de la forme

  fill_color("<color name>");
  psset("<pstricks command>");

sont utilisées pour fixer des attributs comme le style et la couleur des chemins et du remplissage. La couleur de remplissage par défaut est "white". Cet extrait, pris dans le fichier d'exemple contour.xp, montre comment on définit une nouvelle couleur et l'utilisation de psset()

  use_pstricks();      // synchronise longueur, etc.
  begin();
  use_pstricks(false); // désactive temporairement
  ...
  std::cout << "\n\\newrgbcolor{orange}{1 0.7 0.2}";
  psset("fillcolor=orange, linecolor=green, linewidth=1.5pt");

On consultera le manuel de PSTricks pour plus d'information.

Deux incompatibilités majeures impliquent le remplissage et la couleur. À moins que le style de remplissage ne soit explicitement fixé à none, PSTricks remplit tous les chemins même ceux qui ne sont pas fermés. Deuxièmement, PSTricks manipule les couleurs par des chaines nommées, aussi il faut utiliser une sortie brute pour exploiter toute la puissance de PSTricks depuis ePiX.