# LaTeX/Dessiner avec LaTeX/Dessiner avec PGF et TikZ

LATEX
* Généralités
* Premiers pas
** Installer LaTeX
** Premier exemple
** Lettre
** Éléments de base
** Les classes
** Structuration du texte
** Mise en forme du texte
** Faire des tableaux
** Inclure des images
** Options de mise en forme avancées
** Écrire des mathématiques
** Écrire de la physique
** Écrire des formules chimiques
** Créer une feuille de style
** À l'aide !
* Structure du document
* Gestion de la bibliographie
* Tableaux
* Images
* Éléments flottants
* Mise en forme du texte
* Choix de la police
* Mise en page
* Mathématiques
* Gestion des gros documents
* Faire des présentations
* LaTeX pour enseignants
* Arts et loisirs
** Écrire de la musique
** Dessiner des échiquiers
* Dessiner avec LaTeX
** Dessiner en LaTeX pur
** Dessiner avec PSTricks
** Dessiner avec PGF et TikZ
** Dessiner des molécules
** Réalisation de graphiques mathématiques
* Créer une extension ou une classe
* Programmer avec LaTeX
Annexes
* Vadémécum
* Conversion vers d'autres formats
* Glossaire de typographie
* Index
* Commandes
* Liens externes
PGF signifie « portable graphics format », ou « pretty, good, functional ». Contrairement à ce qu'indique son nom, ce n'est pas un format au sens « format de fichier », mais un ensemble d'instructions pour (La)TeX permettant de faire des dessins vectoriels, et la portabilité est limitée au monde de (La)TeX (TeX, LaTeX, ConTeXt), pour faire du PS ou du PDF. Les instructions PGF se placent au sein d'un environnement pfgpicture. Cela permet de générer du PostScript et du PDF.
TikZ est une extension permettant de générer des images PGF avec une syntaxe assez simple ; c'est en quelques sorte une « surcouche » de PGF pour LaTeX, TikZ est à PGF ce que PSTricks est au PostScript. Selon son auteur Till Tantau, TikZ est un acronyme récursif qui veut dire « TikZ ist kein Zeichenprogramm » : TikZ n'est pas un logiciel de dessin - au sens de « TikZ est un langage pour graphiques ».

## Environnement tikzpicture

L'environnement tikzpicture permet de déclarer à LaTeX que l'on commence une image TikZ. On peut définir un facteur d'échelle ; par exemple, si l'on veut multiplier la taille de l'image dessinée par trois, on utilise :
Pour les petites images, on peut se contenter d'utiliser la commande \tikz : cette commande prend l'argument qui suit, typiquement une commande de dessin et ses paramètres, et l'inclut dans un environnement tikzpicture. On peut soit mettre la commande et ses paramètres entre accolades, soit terminer la commande par un point virgule :
et
équivalent à

## Coordonnées

L'unité de longueur par défaut est le centimètre ; l'unité d'angle est le degré. On peut définir un point par ses coordonnées cartésiennes
ou par ses coordonnées polaires
Par défaut, pour simplifier la présentation, nous considèrerons des coordonnées cartésiennes, mais les coordonnées polaires peuvent être utilisées partout.

## Chemin

Le chemin (path) est la notion de base de TikZ. Un chemin est une série de points séparés par des « opérations d'extension ». Les opérations d'extensions définissent le type de trait qui relient les points :
* -- (deux tirets) : un segment de droite relie les deux points ;
* rectangle : trace un rectangle horizontal dont les angles sont les deux points.
Par exemple, un chemin sous la forme d'une ligne brisée sera de la forme
Si l'on termine le chemin par -- cycle, il sera fermé.
Les points peuvent être définis de manière relatives par rapport à un point précédent : le signe + devant des coordonnées définit un décalage, mais laisse inchangé le point de référence (le point de départ reste la référence), tandis que l'opérateur ++ considère que le point ainsi défini est la nouvelle référence pour les points suivants.
Par exemple,
est équivalent à
tandis que
est équivalent à
Un cercle est un chemin défini à partir de son centre et de son rayon :
où rayon est une longueur indiquée comme à l'habitude sous la forme nombre et unité. par exemple, le cercle de centre O et de rayon 1 cm est défini par :
Pour avoir un arc de cercle, on utilise
par exemple, pour avoir l'arc du cercle précédent compris entre 0 et 90 °, on écrit :
Une ellipse est un chemin défini à partir de son centre et de ses axes horizontal et vertical : :
Pour les courbes de Bézier, les points de passage sont séparés par les points de contrôle :
est l'arc dont les extrémités sont (x$_0$, y$_0$) et (x$_2$, y$_2$), et dont le point de contrôle est (x$_1$, y$_1$). S'il y a plusieurs points de contrôle, ils sont séparés par and. Par exemple, avec deux points de contrôle :

## Traçage de ligne

La commande permettant de tracer une ligne est
où chemin est défini comme précédemment. Par exemple, pour tracer le cercle de centre O et de rayon 1 cm, on écrit :
On peut choisir la couleur du tracé :
On peut aussi ajouter des flèches aux extrémités :

## Surface remplie

Pour avoir une surface remplie (peinte), on utilise la commande
Cette commande accepte la couleur comme paramètre. par exemple, pour tracer un disque gris :
On peut remplir avec un dégradé en utilisant la commande \shade. On peut passer des couleurs en argument :
* dégradé horizontal : \shade[left color=couleur1, right color=couleur2] ;
* dégradé vertical : \shade[top color=couleur1, bottom color=couleur2] ;
* dégradé vers l'extérieur : \shade[inner color=couleur1, outer color=couleur2] ;
* effet de balle : \shade[ball color=couleur].

## Utilisation des nœuds

Un nœud est une boîte qui peut contenir du texte. Pour obtenir un nœud aux coordonnées x et y, on utilise la commande suivante :
La boîte du nœud peut être remplie, son bord peut être tracé et on peut choisir la couleur du texte :
On peut aussi nommer un nœud pour y faire appel ensuite :

## TikZ et Babel french/français

Utiliser TikZ avec la bibliothèque babel en français pose des problèmes car cette bibliothèque rend actifs les caractères { : ; ! ? }.
Pour pallier cette incompatibilité il suffit de rajouter au début d’une séquence TikZ :
Comme par exemple ici :
Si vous voulez faire ceci globalement pour tous les environnements {tikzpicture} il suffit de mettre au début du document :

## Voir aussi
### Liens externes

* PGF sur la CTAN
* TikZ pour l'impatient un manuel en français pour débuter rapidement
* TeXample.net un site proposant de nombreux exemples de dessins et graphiques réalisés via TikZ