Debian Codegraph @

texmf-dist/doc/latex/tikz-optics/tikz-optics.tex

raw
1 \iffalse
2 The tikzoptics library documentation
3
4 Copyright (C) 2013-2016 by
5 Michel Fruchart <[email protected]>
6
7 This work may be distributed and/or modified under the conditions of
8 the LaTeX Project Public License (LPPL), version 1.3c, which can be
9 found at the address:
10 https://www.latex-project.org/lppl/lppl-1-3c/
11
12 Alternatively, it may be distributed and/or modified under the conditions of
13 the GNU Free Documentation License (GNU FDL), version 1.3, which can be found
14 at the address:
15 https://www.gnu.org/licenses/fdl-1.3.en.html
16 or any later version published by the Free Software Foundation.
17 \fi
18 % allow compression of cross references.
19 \pdfminorversion=5
20 \pdfobjcompresslevel=2
21 \documentclass[a4paper]{ltxdoc}
22 \usepackage{etex}
23
24 \usepackage[utf8]{inputenc}
25 \usepackage[T1]{fontenc}
26 \usepackage[french]{babel}
27
28 \usepackage[a4paper,left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
29 \usepackage{amsmath}
30
31 %\usepackage{makeidx}
32 \usepackage[version=3]{mhchem}
33
34 \usepackage{csquotes}
35
36 \usepackage{xkeyval,calc,listings}
37 \usepackage[svgnames,x11names]{xcolor}
38 \usepackage{xxcolor} % tikz
39
40 \usepackage{tikz}
41 \usetikzlibrary{shapes,shapes.misc,shapes.geometric}
42 \usetikzlibrary{arrows}
43 \usetikzlibrary{calc}
44 \usetikzlibrary{positioning}
45 \usetikzlibrary{decorations,decorations.markings,decorations.pathreplacing,decorations.pathmorphing}
46 \usetikzlibrary{patterns}
47 \usetikzlibrary{intersections}
48 \usetikzlibrary{matrix}
49 \usetikzlibrary{fit}
50 \usetikzlibrary{ocgx}
51
52
53 \usepackage{fancyvrb}
54
55
56 \usepackage[framemethod=tikz,usetwoside=false]{mdframed}
57
58 \usepackage{fourier-orns}
59 \usepackage{lmodern}
60 \usepackage[charter]{mathdesign}
61 \usepackage{charter}
62 \def\rmdefault{bch} % not scaled
63 \def\sfdefault{SourceSansPro-TLF}
64
65 \usepackage{textcomp}
66 \usepackage[detect-all=true]{siunitx}
67 \sisetup{
68 math-micro=\muup,
69 math-ohm =\Omegaup,
70 text-micro={\fontfamily{mdbch}\textmu},
71 text-ohm ={\fontfamily{mdbch}\textohm}
72 }
73
74 \usepackage{attachfile2}
75 \attachfilesetup{color=blue}
76
77
78 \usepackage[protrusion=true,expansion,kerning=true,final,verbose=false,babel=false]{microtype}
79 \DisableLigatures{encoding=T1,family=tt*}
80
81
82 % corrige l'interaction foireuse entre tikz et babel[french]
83 \AtBeginEnvironment{tikzpicture}{\shorthandoff{:;!}}
84 \AtBeginEnvironment{pgfpicture}{\shorthandoff{:;!}}
85
86
87 % This is not the standard way to load a tikzlibrary
88 % but I want to make sure that the documentation loads
89 % the corresponding library (and not e.g. the production version).
90 \input{../tikzlibraryoptics.code.tex}
91
92
93 \usepackage{hyperref}
94 \usepackage{bookmark}
95 \hypersetup{%
96 colorlinks=true,
97 linkcolor=blue,
98 filecolor=blue,
99 urlcolor=blue,
100 citecolor=blue,
101 pdfborder=0 0 0,
102 }
103
104
105 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
106 % Macros du manuel pgf/tikz (version : texlive 2012)
107 % cf. http://tex.stackexchange.com/questions/72999/is-there-a-listings-configuration-for-tikz-as-used-in-pgf-tikz-manual
108 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
109 \def\pgfautoxrefs{1}
110 \def\pgfmanual@warning#1{\immediate\write16{! Package pgfmanual Warning: #1}}%
111
112 \input{macros/pgfmanual-en-macros}
113 \input{macros/pgfmanual.prettyprinter.code.tex}
114 \input{macros/pgfmanual.pdflinks.code.tex}
115
116
117 \pgfkeys{
118 % set this to 'false' to disable auto reference generation.
119 % However, a little bit runtime overhead will still remain
120 % (and the \pgfmanualpdflabel commands will still be used)
121 /pdflinks/codeexample links=true,
122 %
123 /codeexample/prettyprint/cs arguments/tikzset/.initial=1,
124 /codeexample/prettyprint/cs/tikzset/.code 2 args={\pgfmanualpdfref{#1}{#1}\{\pgfmanualprettyprintpgfkeys{#2}\pgfmanualclosebrace},
125 /codeexample/prettyprint/cs arguments/usetikzlibrary/.initial=1,
126 /codeexample/prettyprint/cs/usetikzlibrary/.code 2 args={\pgfmanualpdfref{#1}{#1}\{\pgfmanualpdfref{#2}{#2}\pgfmanualclosebrace},
127 /codeexample/prettyprint/cs arguments/usepgflibrary/.initial=1,
128 /codeexample/prettyprint/cs/usepgflibrary/.code 2 args={\pgfmanualpdfref{#1}{#1}\{\pgfmanualpdfref{#2}{#2}\pgfmanualclosebrace},
129 %
130 %
131 %
132 % whenever an unqualified key is found, the following key prefix
133 % list is tried to find a match.
134 /pdflinks/search key prefixes in={/tikz/,/pgf/,/tikz/optics/,/tikz/dim/arrow/,},
135 %
136 % the link prefix written to the pdf file:
137 /pdflinks/internal link prefix=tikzopt,
138 %
139 /pdflinks/warnings=false,
140 % for debugging:
141 /pdflinks/show labels=false,
142 }%
143
144 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
145 % Global styles from pgf/tikz manual (version : texlive 2012)
146 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
147 \tikzset{
148 every plot/.style={prefix=plots/pgf-},
149 shape example/.style={
150 color=black!30,
151 draw,
152 fill=yellow!30,
153 line width=.5cm,
154 inner xsep=2.5cm,
155 inner ysep=0.5cm},
156 line shape example/.style={
157 color=black!30,
158 draw,
159 % fill=black!30, % utile à quoi ?
160 line width=.5cm,
161 inner xsep=2.5cm,
162 inner ysep=0.5cm}
163 }
164
165 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
166 % Specific environnements
167 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
168
169 % Environnement |example only| : aspect similaire à codeexample, mais avec seulement l'exemple (quand le code est trop long)
170 \newmdenv[
171 backgroundcolor=graphicbackground,
172 linewidth=0pt,
173 innerleftmargin=0.09cm,innerrightmargin=0.09cm,innertopmargin=0.09cm,
174 leftmargin=0pt,rightmargin=0pt,
175 skipabove=5pt, skipbelow=-2pt,
176 ]{example only}
177
178 % Environnement |warning|
179 \colorlet{warningbackground}{red!30}
180 \makeatletter
181 \newenvironment{warning}{%
182 \mdfsetup{%
183 backgroundcolor=warningbackground,
184 skipabove=5pt,
185 topline=false,bottomline=false,rightline=false,
186 innerbottommargin=4pt,innertopmargin=0.18cm,
187 leftmargin=0cm, innerleftmargin=0.3cm
188 rightmargin=0cm,innerrightmargin=0.3cm,
189 linewidth=1pt,linecolor=none, topline=false, bottomline=false,
190 }%
191 \begin{mdframed}%
192 \setlength{\parindent}{0pt}%
193 \danger\,%
194 }%
195 {%
196 \end{mdframed}%
197 }%
198
199 % Environnement |update|
200 \colorlet{updatebackground}{blue!30}
201 \newenvironment{update}{%
202 \mdfsetup{%
203 backgroundcolor=updatebackground,
204 skipabove=5pt,
205 topline=false,bottomline=false,rightline=false,
206 innerbottommargin=4pt,innertopmargin=0.18cm,
207 leftmargin=0cm, innerleftmargin=0.3cm
208 rightmargin=0cm,innerrightmargin=0.3cm,
209 linewidth=1pt,linecolor=none, topline=false, bottomline=false,
210 }%
211 \begin{mdframed}%
212 \setlength{\parindent}{0pt}%
213 \danger\,%
214 }%
215 {%
216 \end{mdframed}%
217 }%
218 \makeatother
219
220 \begin{document}
221
222 \VerbatimFootnotes
223
224 \title{optics --- une bibliothèque tikz pour les schémas d'optique}
225 \author{Michel Fruchart \\
226 \href{mailto:michel (dot) fruchart [at] ens-lyon (dot) org}{\texttt{michel (dot) fruchart [at] ens-lyon (dot) org}}}
227
228 \date{\tikzopticsversiondate{} -- version \tikzopticsversion \\[0.15cm]
229 \large\href{https://github.com/fruchart/tikz-optics}{\texttt{https://github.com/fruchart/tikz-optics}}}
230
231 \maketitle
232
233 \section{Introduction}
234
235 Le but de cette bibliothèque est de permettre de facilement faire des schémas optiques avec tikz, c'est-à-dire de dessiner lentilles, miroirs, etc. Le tracé géométriquement correct (ou non) des rayons est laissé à l'utilisateur.
236
237
238 \subsection{Legal matters}
239
240 Cette bibliothèque peut être distribuée et modifiée sous les conditions de la licence LaTeX Project Public License (LPPL), version 1.3c\footnote{\url{http://latex-project.org/lppl/lppl-1-3c.txt}}. Elle peut aussi être distribuée et modifiée sous les conditions de la licence GNU General Public License (GNU GPL), soit la version 2\footnote{\url{http://www.gnu.org/licenses/gpl-2.0.en.html}}, soit toute version ultérieure publiée par la Free Software Foundation. Sa documentation, que vous êtes en train de lire, peut être distribuée sous les conditions de la licence LaTeX Project Public License (LPPL), version 1.3c\footnote{\url{http://latex-project.org/lppl/lppl-1-3c.txt}}. Elle peut aussi être distribuée et modifiée sous les conditions de la licence GNU Free Documentation License (GNU FDL), soit la version 1.3\footnote{\url{https://www.gnu.org/licenses/fdl-1.3.en.html}}, soit toute version ultérieure publiée par la Free Software Foundation.
241
242 \subsection{Installation de la bibliothèque}
243
244 Cette bibliothèque est une \enquote{bibliothèque tikz}. Il y a deux façons de l'utiliser :
245 \begin{itemize}
246 \item en ajoutant le fichier |tikzlibraryoptics.code.tex| dans un dossier où \TeX{} peut le trouver, par exemple dans votre dossier |TEXMFHOME|\footnote{Pour savoir où il se trouve, on peut utiliser la commande \verb|kpsewhich -var-value TEXMFHOME|. }, puis en utilisant la commande |\usetikzlibrary{optics}| ;
247 \item en incluant directement le fichier |tikzlibraryoptics.code.tex| contenant la bibliothèque grâce à la commande |\input|.
248 \end{itemize}
249
250 Si la bibliothèque est placée dans un dossier |TEXMF|, disons |/home/agamemnon/texmf/|, il faut respecter la structure TDS de ces répertoires\footnote{Voir par exemple \url{https://www.ctan.org/TDS-guidelines}}. En pratique, le fichier |tikzlibraryoptics.code.tex| doit être placé dans le dossier |home/agamemnon/texmf/tex/latex/|, ou dans un sous-dossier comme |home/agamemnon/texmf/tex/latex/tikzoptics|. Le plus simple est d'utiliser le contenu de l'archive |tikzoptics.tds.zip|, qui est structuré comme il se doit et peut directement être ajouté dans le dossier |TEXMF| (comme |/home/agamemnon/texmf/|).
251
252 \subsection{Utilisation de la bibliothèque}
253
254 \begin{key}{/tikz/use optics}
255 Après avoir installé la bibliothèque, il suffit de la charger grace à la commande |\usetikzlibrary{optics}|, puis d'utiliser l'option |use optics| sur une |tikzpicture| pour pouvoir utiliser les commandes\footnote{L'option \texttt{use optics} charge les éléments pertinents de \texttt{/tikz/optics/} dans \texttt{/tikz/}, ce qui permet de les utiliser directement. Séparer a priori les commandes dans des espaces de noms différents permet de réduire le risque de collision de noms.}
256
257 \begin{codeexample}[width=5cm]
258 \begin{tikzpicture}[use optics]
259 \node[lens] at (0,0) {};
260 \node[mirror] at (1cm,0) {};
261 \end{tikzpicture}
262 \end{codeexample}
263
264 Si l'option |use optics| n'est pas utilisée, le code plantera lamentablement (dans les cas favorables) ou aura un comportement inattendu (dans les cas moins favorables).
265 \end{key}
266
267 \subsection{Élements sur les \texttt{node} de tikz et leur placement}
268
269 \emph{Pour plus de détails, lire le manuel de tikz.}
270
271 En deux mots, une |node| est en gros un objet, qui peut avoir une certaine forme (|shape|). À différents endroits de cette |node| sont définies des ancres (|anchor|). Au contraire d'une |node| qui est en quelque sorte étendue spatialement, ces ancres représentent des points précis sur le canevas de dessin. La |node| a un nom (facultatif) qui permet d'y faire référence dans la suite du dessin, par exemple pour accéder aux coordonnées d'une ancre.
272
273 La syntaxe minimale pour créer une |node| est |\node {};|, mais cela n'est pas très utile. Il faut spécifier où se trouve la |node| en écrivant |\node at |\meta{position}| {};| (où \meta{position} est une coordonnée, comme |(0,1cm)|). Cela n'est toujours pas très utile car rien n'est dessiné. C'est le rôle des |shape| que de déterminer ce qui est dessiné.
274
275 Dessinons ainsi un rectangle rouge en |(0,0)| (ici, c'est le centre du canevas), et de côté |1cm|\footnote{Dans cette documentation, les longueurs ne sont généralement pas écrites avec les conventions du système international, mais avec les conventions habituelles pour du code tikz.}
276
277 %
278 \begin{codeexample}[width=5cm]
279 \begin{tikzpicture}
280 \draw[style=help lines,gray!50] (-2cm,-2cm) grid[step=0.5cm] (2cm,2cm);
281 \node[rectangle,minimum height=1cm,minimum width=1cm,draw=red] at (0,0) {};
282 \end{tikzpicture}
283 \end{codeexample}
284 %
285 J'ai ajouté une grille de pas |0.5cm| pour mieux voir les coordonnées. Dans cet exemple, c'est le centre du rectangle qui est placé au point |(0,0)|. Pour être plus précis, il s'agit de son ancre |center|. C'est le comportement par défaut, mais tout l'intérêt est qu'on peut placer les autres ancres définies par la |shape| au point spécifié. Ajoutons donc à ce dessin un rectangle bleu dont le bas est situé en |(0,0)|. Comme nous allons avoir plusieurs |node| qui partagent les caractéristiques |rectangle,minimum height=1cm,minimum width=1cm|, je les ai placées dans un \emph{style} que j'ai appelé |joli rectangle| (il ne faudrait pas l'appeler |rectangle| car cela existe déjà). Comme le bas est représenté par l'ancre |south|, il faut ajouter l'option |anchor=south| à la |node|:
286 %
287 \begin{codeexample}[width=5cm]
288 \begin{tikzpicture}
289 \draw[style=help lines,gray!50] (-2cm,-2cm) grid[step=0.5cm] (2cm,2cm);
290 \tikzstyle{joli rectangle}=[rectangle,minimum height=1cm,minimum width=1cm]
291 \node[joli rectangle,draw=red] at (0,0) {};
292 \node[joli rectangle,draw=blue,anchor=south] at (0,0) {};
293 \end{tikzpicture}
294 \end{codeexample}
295 %
296 J'aimerais maintenant tracer un trait noir entre coin en haut à gauche du carré bleu et le coin en bas à droite du carré rouge. Pour cela, il faut pouvoir accéder aux ancres |north west| (en haut à gauche) et |south east| (en bas à droite) des deux |nodes|. Nous allons donc donner un nom à chacune de ces |nodes|, par exemple |Esther| et |Athalie|:
297 %
298 \begin{codeexample}[width=5cm]
299 \begin{tikzpicture}
300 \draw[style=help lines,gray!50] (-2cm,-2cm) grid[step=0.5cm] (2cm,2cm);
301 \tikzstyle{joli rectangle}=[rectangle,minimum height=1cm,minimum width=1cm]
302 \node[joli rectangle,draw=red]
303 (Esther) at (0,0) {};
304 \node[joli rectangle,draw=blue,anchor=south]
305 (Athalie) at (0,0) {};
306 \end{tikzpicture}
307 \end{codeexample}
308 %
309 Pour le moment, cela ne change absolument rien au dessin, mais on peut désormais accéder aux ancres nécessaires par |(Athalie.north west)| et |(Esther.south east)| et dessiner le trait voulu.
310 %
311 \begin{codeexample}[width=5cm]
312 \begin{tikzpicture}
313 \draw[style=help lines,gray!50] (-2cm,-2cm) grid[step=0.5cm] (2cm,2cm);
314 \tikzstyle{joli rectangle}=[rectangle,minimum height=1cm,minimum width=1cm]
315 \node[joli rectangle,draw=red]
316 (Athalie) at (0,0) {};
317 \node[joli rectangle,draw=blue,anchor=south]
318 (Esther) at (0,0) {};
319 \draw (Esther.north west) --(Athalie.south east);
320 \end{tikzpicture}
321 \end{codeexample}
322 %
323
324 Pour placer les points, il est possible d'utiliser une options du genre |left=of (autre node)|, ou encore |above=5mm of (Esther)|. C'est ce qu'on fait dans l'exemple \ref{sec:exemple_dispersion} p.~\pageref{sec:exemple_dispersion}.
325
326 \subsection{Programmer des images : faire des calculs avec tikz}
327
328 \emph{Pour plus de détails, lire le manuel de tikz.}
329
330 Un des principaux avantages\footnote{Un des principaux inconvénients est que cela demande un peu plus de travail, surtout au début.} d'utiliser du code pour générer des schémas est que cela permet de concevoir les schémas comme un programme informatique. Ainsi, on gagne plusieurs choses :
331 \begin{itemize}
332 \item en utilisant des variables pour représenter les longueurs et angles du schéma, on peut facilement l'ajuster immédiatement ainsi que le modifier plus tard au besoin ;
333 \item en utilisant des styles pour l'aspect visuel (couleurs, hachures, etc.), il est plus facile de maintenir une cohérence visuelle entre différents schémas. La modification du style se répercutant sur tous les schémas (tant qu'il n'est pas défini à nouveau), on peut facilement décider de changer le bleu représentant l'eau, ou bien, si on veut distribuer un document en noir et blanc, de la représenter par un motif (|pattern|) approprié ;
334 \item on peut utiliser les diverses ressources de la programmation que sont les boucles, les conditions, et les calculs pour effectuer des tâches répétitives ou complexes ;
335 \item il est possible de réutiliser\footnote{J'aimerais ajouter \enquote{facilement} ici, mais ça n'est hélas pas le cas. Le plus simple est de définir une macro contenant le bout de schéma, et cette méthode marche très bien, mais elle a certaines limites.} des bouts de schéma
336 \end{itemize}
337
338 Le but de cette section est de rappeler rapidement comment faire des calculs avec |pgfmath|. Une référence complète se trouve dans le manuel de |tikz|. Les commandes principales que nous allons utiliser sont la boucle |\foreach|, et les commandes de calcul |\pgfmathcalc| et |\pgfmathresult|, |\pgfmathdef|, et |\pgfmathsetlength|.
339
340 \subsubsection{Calculs}
341
342 La commande |\pgfmathcalc{<expression>}| parse calcule l'|<expression>| qui lui est donnée (selon des règles qui sont spécifiées dans le manuel de tikz) et enregistre le résultat dans la macro |\pgfmathresult|. Si on a besoin de garder ce résultat, il faut le copier dans une autre macro (disons par exemple |\reflexionAngle|) en utilisant |\let\reflexionAngle\pgfmathresult|. La syntaxe des expressions mathématiques est assez naturelle. Pour les détails, je vous renvoie au manuel tikz ; voici néanmoins quelques exemples\footnote{Pour essayer une expression mathématique, le plus simple est d'écrire \verb-\pgfmathparse{2+2}\pgfmathresult-
343 dans le corps d'un document tex : cela affichera \texttt{\pgfmathparse{2+2}\pgfmathresult} dans le pdf. Ici, j'ai omis les \verb+\pgfmathresult+ pour plus de clareté, mais la commande \verb+\pgfmathparse+ n'affiche rien toute seule !
344 } :
345
346 \begin{codeexample}[post={\pgfmathresult}]
347 \pgfmathparse{5*6+3}
348 \end{codeexample}
349
350 \begin{codeexample}[post={\pgfmathresult}]
351 \pgfmathparse{(4^2 + 4)/2}
352 \end{codeexample}
353
354 \begin{codeexample}[post={\pgfmathresult}]
355 \pgfmathparse{factorial(4)}
356 \end{codeexample}
357
358 \begin{codeexample}[post={\pgfmathresult}]
359 % les angles sont en degres !
360 \pgfmathparse{cos(45)}
361 \end{codeexample}
362
363 \begin{codeexample}[post={\pgfmathresult}]
364 % r convertit les degres en radians
365 \pgfmathparse{cos(pi/4 r)}
366 \end{codeexample}
367
368 \begin{codeexample}[post={\pgfmathresult}]
369 \pgfmathparse{abs(-sqrt(2)/2)}
370 \end{codeexample}
371
372 Des fonctions comme |acos|, |sinh|, |ln|, etc. sont disponibles\footnote{Des outils rudimentaires pour travailler avec des vecteurs et un générateur de nombres pseudo-aléatoires existent aussi.}. Il est possible de définir des fonctions via la commande |\pgfmathdeclarefunction| ou la clé |/pgf/declare function|, en fournissant éventuellement une implémentation bas niveau :
373
374
375 \begin{example only}
376 \shorthandoff{;:}
377 \pgfkeys{/pgf/declare function={f(\x)=1.7280+0.01345/(\x^2);}}
378 \pgfmathparse{f(1)}
379 \pgfmathresult
380 \end{example only}
381
382 \begin{codeexample}[code only]
383 \pgfkeys{/pgf/declare function={f(\x)=1.7280+0.01345/(\x^2);}}
384 \pgfmathparse{f(1)}
385 \pgfmathresult
386 \end{codeexample}
387
388 À partir de tikz 3.0, la bibliothèque tikz |math| permet de simplifier l'écriture des calculs.
389
390 Il existe aussi des fonctions logiques, et les opérateurs booléens habituels (|not(x)=!x|, \verb+or(x,y)=x||y+, |and(x,y)=x&&y|). Par convention, le booléen |true| est représenté par |1| et |false| par |0|. On a alors divers outils avec plusieurs syntaxes :
391
392
393 \begin{codeexample}[post={\pgfmathresult}]
394 \pgfmathparse{2 <= 4}
395 \end{codeexample}
396
397 \begin{codeexample}[post={\pgfmathresult}]
398 \pgfmathparse{greater(1,2)}
399 \end{codeexample}
400
401 \begin{codeexample}[post={\pgfmathresult}]
402 \pgfmathparse{not(1.5 == 0 && 1.5 <= 2)}
403 \end{codeexample}
404
405 La commande |\pgfmathsetmacro{<macro>}{<expression>}| parse l'|<expression>| mathématique de la même manière que |\pgfmathcalc|, et enregistre le résultat du calcul dans |<macro>|. Par exemple, |\pgfmathsetmacro{\transitionProbability}{0.5+0.1}| enregistre |0.6| dans |\transitionProbability|. Par contre, si le résultat du calcul est une chaîne de caractères, il faut utiliser quelque chose comme |\pgfmathparse{<expression>}\let<macro>\pgfmathresult|.
406
407 La commande |\pgfmathtruncatemacro| s'utilise comme |\pgfmathsetmacro|, mais elle renvoie un entier (le résultat tronqué), qui peut être utilisé dans une boucle, ou dans une condition. Par exemple, |\pgfmathtruncatemacro\nmax{5/4}| stocke |1| dans |\nmax|.
408
409 \paragraph{Une remarque sur les définitions et les groupes.} |\pgfmathsetmacro| et les commandes assimilées utilisent la primitive TeX |\def| pour définir les macros, ce qui fait qu'on peut redéfinir une macro sans se préoccuper de savoir si elle existait déjà ou non. De manière générale, je préfère utiliser |\def| plutôt que |\newcommand| pour définir et modifier des variables, car elles peuvent devoir changer lors du tracé du dessin. Cela implique de veiller à ne pas redéfinir des commandes existantes par erreur, mais cela évite aussi beaucoup de tracas. Dans la mesure où le contenu d'une |tikzpicture| est contenu à l'intérieur d'un groupe, les éventuelles redéfinitions intempestives n'ont de conséquences qu'à l'intérieur du dessin. Cela veut aussi dire que pour accèder à une variable définie dans une |tikzpicture|, il faut ajouter un |\global| quelque part.
410
411 \subsubsection{Conditions}
412
413 Quelques mots sur les fonctions logiques de tikz et leur utilisation.
414
415 Une expression comme |greater(\x,pi)| est évaluée à |1| si |\x| est plus grand que $\pi$, et à |0| sinon. Toutes les fonctions logiques se comportent de cette manière. Cela permet de définir des fonctions par morceaux, etc. Pour exécuter du code latex sous condition, une méthode (parmi d'autres) consiste en ce qui suit :
416
417
418 \begin{example only}
419 \foreach \x in {1,2,3,4}
420 {
421 \pgfmathparse{greater(\x,pi)}
422 \ifnum\pgfmathresult=1
423 \x{} est plus grand que $\pi$ ;
424 \else
425 \x{} est plus petit que $\pi$ ;
426 \fi
427 }
428 \end{example only}
429 %
430 \begin{codeexample}[code only]
431 \foreach \x in {1,2,3,4}
432 {
433 \pgfmathparse{greater(\x,pi)}
434 \ifnum\pgfmathresult=1
435 \x{} est plus grand que $\pi$ ;
436 \else
437 \x{} est plus petit que $\pi$ ;
438 \fi
439 }
440 \end{codeexample}
441
442
443 %
444 Il peut être nécessaire de stocker le résultat de |\pgfmathresult| dans une macro ; la commande |\pgfmathsetmacro| stockerait |1.0| ou |0.0| (des flottants au lieu d'entiers), qui ne peuvent pas être traités par |\ifnum| : il faut donc faire appel à |\pgfmathtruncateresult|. Ainsi, le code suivant reproduit le même résultat :
445 %
446 \begin{example only}
447 \foreach \x in {1,2,3,4}
448 {
449 \pgfmathtruncatemacro\plusGrandQuePi{greater(\x,pi)}
450 \ifnum\plusGrandQuePi=1
451 \x{} est plus grand que $\pi$ ;
452 \else
453 \x{} est plus petit que $\pi$ ;
454 \fi
455 }
456 \end{example only}
457 %
458 \begin{codeexample}[code only]
459 \foreach \x in {1,2,3,4}
460 {
461 \pgfmathtruncatemacro\plusGrandQuePi{greater(\x,pi)}
462 \ifnum\plusGrandQuePi=1
463 \x{} est plus grand que $\pi$ ;
464 \else
465 \x{} est plus petit que $\pi$ ;
466 \fi
467 }
468 \end{codeexample}
469
470 On peut aussi vouloir spécifier un aspect visuel selon une condition. Une méthode consiste à définir des styles, qu'on assigne selon la condition. Ici, nous tirons un certain nombre de points au hasard dans un carré. Nous voulons distinguer les points qui se trouvent dans un certain cercle des autres. Pour cela, on définit deux styles |inside| et |outside|. Pour le moment, nous allons colorer les points dedans en rouge et deux dehors en bleu :
471
472 \begin{codeexample}[code only]
473 \tikzset{inside/.style={red},outside/.style={blue}}
474 \end{codeexample}
475
476 Ensuite, il suffit d'utiliser la fonction |ifthenelse| pour définir une macro |\pointStyle| qui vaut |inside| ou |outside|, selon la position du point situé en |(\posx,\posy)|. Dans l'exemple qui suit, je me suis rendu compte que les couleurs ne se voient pas quand on imprime en noir et blanc, et j'ai donc dessiné des croix rouges ainsi que des plus bleus en modifiant les styles |inside| et |outside| :
477
478 \begin{codeexample}[]
479 \begin{tikzpicture}
480 \tikzset{inside/.style={red,mark=x},outside/.style={blue,mark=+}}
481 \newdimen\radius
482 \pgfmathsetlength\radius{1cm}
483 \pgfmathsetmacro\k{2}
484 \pgfmathtruncatemacro\NumberOfPoints{15}
485
486 \draw (0,0) circle(\radius);
487 \draw (-\k*\radius,-\k*\radius) rectangle (\k*\radius,\k*\radius);
488
489 \newdimen\posx
490 \newdimen\posy
491 \foreach \nil in {1,2,...,\NumberOfPoints}
492 {
493 \pgfmathsetlength\posx{\k*\radius*rand}
494 \pgfmathsetlength\posy{\k*\radius*rand}
495 \pgfmathparse{ifthenelse(veclen(\posx,\posy)<\radius,"inside", "outside")}
496 \let\pointStyle\pgfmathresult
497 \draw[\pointStyle] plot (\posx,\posy);
498 }
499 \end{tikzpicture}
500 \end{codeexample}
501
502 \subsubsection{Boucles \texttt{foreach}}
503
504 La boucle |\foreach| s'utilise grossièrement de la manière suivante :
505 %
506 \begin{codeexample}[]
507 \foreach \x in {1,2,...,10} {\x,}
508 \end{codeexample}
509 %
510 \begin{codeexample}[]
511 \foreach \x in {0.42,0.5,12.56} {\x,}
512 \end{codeexample}
513 %
514 Il y a un certain nombre de subtilités dans la syntaxe qui permettent de faire des choses élaborées : je vous renvoie au manuel de tikz qui y consacre un chapitre entier ainsi qu'aux exemples. Remarquez que les boucles peuvent être imbriquées.
515
516 Dans l'exemple (inutile) suivant, nous voulons placer une barre tous les |\shift| sur un trait de longueur |\length|. De plus, on veut qu'un trait sur deux soit rouge, et l'autre bleu. On calcule donc le nombre |\imax| de traits à dessiner, puis on utilise une boucle. Dans la boucle, on utilise la parité de la variable de boucle |\i| pour savoir si la barre doit être rouge ou bleue.
517
518 \begin{codeexample}[]
519 \begin{tikzpicture}
520 \pgfmathsetmacro\length{4}
521 \pgfmathsetmacro\shift{0.5}
522 \pgfmathtruncatemacro\imax{\length/\shift}
523
524 \draw (0,0) -- (\length,0);
525 \foreach \i in {0,1,2,...,\imax}
526 {
527 \pgfmathparse{ifthenelse(equal(mod(\i,2),0),"red","blue")}
528 \let\chunkStyle\pgfmathresult
529 \draw[\chunkStyle] (\i*\shift cm,-0.3cm) -- (\i*\shift cm,0.3cm);
530 }
531 \end{tikzpicture}
532 \end{codeexample}
533
534 \subsubsection{Les longueurs}
535
536 En tikz, on travaille toujours, de manière implicite ou explicite, avec des longueurs (et des angles). Par exemple, la coordonnée |(1,2)| signifie généralement |(1cm,2cm)| (en fait, |(1,2)| est vu comme une coordonnée dans un système dont les vecteurs unité ont, par défaut, une longueur d'un centimètre, mais qui peuvent être modifiés).
537 Le plus souvent, il est raisonnable de préciser explicitement les unités et donc de travailler avec des longueurs.
538
539 En (la)tex, les longueurs doivent être déclarées avant d'être utilisées, et contrairement aux macros, il n'est pas d'usage de les déclarer et de les définir en même temps. La commande |\newdimen{<longueur>}| permet de déclarer une longueur\footnote{Pour la même raison que je préfère \texttt{\textbackslash{}def} à \texttt{\textbackslash{}newcommand} pour définir des variables dans les dessins, je préfère \texttt{\textbackslash{}newdimen} à \texttt{\textbackslash{}newlength}.}. Pour lui donner une valeur, le plus simple est d'utiliser la commande |\pgfmathsetlength{<longueur>}{<expression math>}|, qui parse l'|<expression math>| et l'enregistre dans |<longueur>|. Ainsi,
540
541 \begin{codeexample}[]
542 \begin{tikzpicture}
543 \newdimen\hauteurFente
544 \pgfmathsetlength\hauteurFente{3cm}
545 \newdimen\largeurFente
546 \pgfmathsetlength\largeurFente{0.25cm}
547 \newdimen\ecartFentes
548 \pgfmathsetlength\ecartFentes{0.5cm}
549
550 \coordinate (L) at (-\ecartFentes/2,0);
551 \coordinate (R) at (\ecartFentes/2,0);
552 \foreach \x in {L,R}
553 \draw[shift={(\x)}] (-\largeurFente/2,-\hauteurFente/2)
554 rectangle (\largeurFente/2,\hauteurFente/2);
555 \end{tikzpicture}
556 \end{codeexample}
557
558 La commande |\pgfmathsetlength| suppose qu'une grandeur sans unité est donnée en points (|pt|). Ainsi, |\pgfmathsetlength\hauteurFente{3}| équivaut à |\pgfmathsetlength\hauteurFente{3pt}|. Néanmoins, il n'est pas une bonne idée de ne pas spécifier l'unité.
559
560 Les fonctions de comparaison de |pgfmath| (comme |greater|, |less|, |equal|) peuvent être utilisées avec des longueurs : par exemple, |\pgfmathparse{2cm <= 4cm}| donne |1|, alors que |\pgfmathparse{2cm <= 4pt}| donne |0|.
561
562 \subsubsection{Un prisme}
563
564 Armés de ces outils, nous pouvons dessiner le parcours de rayons lumineux à travers un prisme en verre. Quelques calculs d'optique géométrique permettent de déterminer les coordonnées nécessaires au tracé, et on obtient ainsi la figure suivante :
565
566 \begin{example only}
567 \begin{center}
568 \begin{tikzpicture}
569 \newdimen\hauteurVerre
570 \newdimen\largeurVerre
571 \newdimen\distanceSource
572 \newdimen\hauteurSource
573 \newdimen\distanceEcran
574 \pgfmathsetlength\hauteurVerre{2cm}
575 \pgfmathsetlength\largeurVerre{1cm}
576 \pgfmathsetlength\distanceSource{1cm}
577 \pgfmathsetlength\hauteurSource{1cm}
578 \pgfmathsetmacro\glassIndex{1.74}
579 \pgfmathsetlength\distanceEcran{1cm}
580
581 \coordinate (A) at (0,\hauteurVerre);
582 \coordinate (B) at (0,0);
583 \coordinate (C) at (\largeurVerre,0);
584
585 % couleur des rayons
586 \colorlet{current ray color}{red}
587
588 % dessin du prisme
589 \draw (A) -- (B) -- (C) -- cycle;
590
591 % source
592 \coordinate (S) at (-\distanceSource,\hauteurSource);
593
594 % tracé des rayons
595 \foreach \x in {-0.1,0,0.1,0.2,...,1}
596 {
597 \pgfmathsetmacro\inAngle{atan((\hauteurSource-\x*\hauteurVerre)/\distanceSource)}
598 % si le rayon ne croise pas le prisme, pas de déflexion du rayon
599 \pgfmathtruncatemacro\noDeflexion{or(notgreater(\x,0),notless(\x,1))}
600 \ifnum\noDeflexion=1
601 \draw[dashed,current ray color] (S)
602 -- (\distanceEcran,{tan(\inAngle)*(\distanceEcran+\largeurVerre+\distanceSource)});
603 \else
604 \pgfmathsetmacro\midAngle{asin((1/\glassIndex)*sin(\inAngle))}
605 \pgfmathsetmacro\y{\x*(1+\largeurVerre/\hauteurVerre*tan(\midAngle))^(-1)}
606 \pgfmathsetmacro\appexAngle{atan(\largeurVerre/\hauteurVerre)}
607 \pgfmathsetmacro\snellSine{\glassIndex*sin(-\appexAngle+\midAngle)}
608
609 % est-ce que le rayon coupe le bas du prisme ?
610 \pgfmathtruncatemacro\goesOut{greater(\y,1)}
611 \ifnum\goesOut=1
612 % je ne dessine pas les rayons qui couperaient le bas du prisme
613 \else
614 % est-ce qu'il y a réflexion totale ?
615 \pgfmathtruncatemacro\totalReflexion{notgreater(abs(\snellSine),1)}
616 \ifnum\totalReflexion=1
617 \newdimen\screenY
618 \pgfmathsetlength\screenY{
619 (1-\y)*\hauteurVerre + tan(asin(\snellSine)+\appexAngle)*
620 (\largeurVerre+\distanceEcran - \largeurVerre*\y)
621 }
622 \draw[current ray color] (S) -- (\largeurVerre*0,{(1-\x)*\hauteurVerre})
623 -- (\largeurVerre*\y,{(1-\y)*\hauteurVerre})
624 -- (\largeurVerre+\distanceEcran,\screenY);
625 \else
626 \draw[dotted,current ray color] (S) -- (\largeurVerre*0,{(1-\x)*\hauteurVerre})
627 -- (\largeurVerre*\y,{(1-\y)*\hauteurVerre});
628 \fi
629 \fi
630 \fi
631 }
632 \end{tikzpicture}
633 \end{center}
634 \end{example only}
635
636 Comme nous avons utilisé des paramètres ajustables, il est très facile d'adapter le code de manière à tracer les rayons pour plusieurs longueurs d'ondes (en utilisant la loi de Cauchy) :
637
638 \begin{example only}
639 \begin{center}
640 \input{prisme_dispersion.pgf}
641 \end{center}
642 \end{example only}
643 %
644 Le code servant à générer cette figure étant un peu long, je ne l'ai pas inclus dans le corps du document, mais en pièce jointe : \textattachfile[]{prisme_dispersion.pgf}{prisme\_dispersion.pgf}.
645
646
647 \section{Exemples}
648
649 \subsection{Image d'une fente sur un écran}
650
651 Reproduisons un schéma optique simple (qu'il faudrait que je scanne).
652
653 La première étape est de placer tous les éléments. On commence de manière très logique par la lampe, qu'on place en |(0,0)|. Ensuite, tous les éléments sont placé à droite les uns des autres. Par exemple, l'anticalorique est placé à |0.5cm| de la sortie de la lampe (ancre |aperture east| de la |node| |QI|) par l'option |right=0.5cm of (QI.aperture east)|. L'écran et la lentille sont situés relativement à la fente parce que j'ai jugé ça plus pratique pour les modifier indépendamment, mais ce genre de choix dépend de l'humeur et de la situation. J'ai nommé les différents éléments de manière peu cohérente pour souligner que les noms des |nodes| sont très libres : on peut y mettre des espaces, des accents\footnote{Vous remarquerez que je n'utilise pas d'accents dans les exemples de code. C'est parce que le code qui traite ces exemples n'est pas capable de les traiter. Par contre, il n'y a aucun problème à les utiliser dans tikz (une |node| peut s'appeler \texttt{(écran)} sans aucun problème, par exemple).}, etc. Il faut juste éviter d'y mettre de point, virgule, double-point, etc. qui ont un sens particulier (le point sépare le nom d'une |node| de celui de l'ancre visée, par exemple).
654
655 \begin{codeexample}[width=5cm]
656 \begin{tikzpicture}[use optics]
657 \node[halogen lamp] (quartz iode) at (0,0) {Q.I.};
658 \node[heat filter,right=0.5cm of quartz iode.aperture east] (AC) {};
659 \node[slit,right=0.75cm of AC] (fente) {};
660 \node[lens,right=2cm of fente] (L) {};
661 \node[screen,right=5cm of fente] (screen) {};
662 \end{tikzpicture}
663 \end{codeexample}
664
665 %
666 Une deuxième étape consiste à tracer les rayons lumineux. Ici, on a de la chance car toutes les positions nécessaires sont des ancres des différentes |node|. Par exemple, |(L.lens south)| est située juste avant le bas de |L| de manière à ce que le dessin soit joli (mais on peut quand même accéder à ce bas via |(L.south)| - l'idée est qu'il s'agit alors du bas du support annulaire de la lentille). On relie donc les ancres par des |--| dans une commande |\draw|.
667 %
668 \begin{codeexample}[]
669 \begin{tikzpicture}[use optics]
670 \node[halogen lamp] (quartz iode) at (0,0) {Q.I.};
671 \node[heat filter,right=0.5cm of quartz iode.aperture east] (AC) {} ;
672 \node[slit,right=0.75cm of AC] (fente) {};
673 \node[lens,right=2cm of fente] (L) {};
674 \node[screen,right=5cm of fente] (screen) {};
675
676 \draw[red] (fente.slit north) -- (L.lens north) -- (screen.center)
677 (fente.slit south) -- (L.lens south) -- (screen.center);
678 \end{tikzpicture}
679 \end{codeexample}
680 %
681 Il faut ensuite ajouter les étiquettes des différents éléments. Cela est fait via l'option \verb|label|, de la forme \verb|label=|\meta{texte}, ou plus généralement \verb|label=[|\meta{opts}\verb|]|\meta{pos}\verb|:|\meta{texte}. En particulier, pour pouvoir sauter une ligne, il faut par exemple utiliser l'option |align=center|.
682
683 \begin{codeexample}[]
684 \begin{tikzpicture}[use optics]
685 \node[halogen lamp] (quartz iode) at (0,0) {Q.I.};
686 \node[heat filter,right=0.5cm of quartz iode.aperture east,label={below:AC}] (AC) {} ;
687 \node[slit,right=0.75cm of AC,label={below:fente}] (fente) {};
688 \node[lens,right=2cm of fente,label={[align=center]below:achromat \\ $(L)$}] (L) {};
689 \node[screen,right=5cm of fente,label={below:\'ecran}] (screen) {};
690
691 \draw[red] (fente.slit north) -- (L.lens north) -- (screen.center)
692 (fente.slit south) -- (L.lens south) -- (screen.center);
693 \end{tikzpicture}
694 \end{codeexample}
695
696 Enfin, on ajoute les flèches. Pour ce faire, je définis une coordonnée (c'est une |node| qui n'a qu'une seule ancre et qui ne dessine rien) et j'utilise la position verticale de cette coordonnée (point 1) ainsi que les positions horizontales des (centres des) divers objets (point 2), grace à la syntaxe \texttt{(point 1 -\textbar{} point 2)}.
697
698
699 \begin{codeexample}[]
700 \begin{tikzpicture}[use optics]
701 \node[halogen lamp] (quartz iode) at (0,0) {Q.I.};
702 \node[heat filter,right=0.5cm of quartz iode.aperture east,label={below:AC}] (AC) {} ;
703 \node[slit,right=0.75cm of AC,label={below:fente}] (fente) {};
704 \node[lens,right=2cm of fente,label={[align=center]below:achromat \\ $(L)$}] (L) {};
705 \node[screen,right=5cm of fente,label={below:\'ecran}] (screen) {};
706
707 \draw[red] (fente.slit north) -- (L.lens north) -- (screen.center)
708 (fente.slit south) -- (L.lens south) -- (screen.center);
709
710 \coordinate (arrow origin) at (0,1.5cm);
711
712 \draw[>=technical,<->] (arrow origin -| fente) -- (arrow origin -| L) node[midway,above] {$d$};
713 \draw[>=technical,<->] (arrow origin -| L) -- (arrow origin -| screen) node[midway,above] {$D$};
714 \end{tikzpicture}
715 \end{codeexample}
716
717 Quand le style sera au point, il sera possible d'utiliser |dim arrow| pour indiquer les dimensions au lieu de cette méthode légèrement plus laborieuse.
718
719
720
721 \subsection{Des interférences}
722
723 Ici, je n'ai pas utilisé |right=of| et ses amis pour placer les |nodes|, mais des calculs de coordonnées.
724
725
726 \begin{codeexample}[]
727 \begin{tikzpicture}[use optics]
728 \node[laser] (L) at (0,0) {\ce{HeNe}};
729 \node[semi-transparent mirror,rotate=45] (ST) at ($(L)+(3cm,0)$) {};
730 \node[above] at (ST.north) {s\'eparatrice};
731 \node[mirror,rotate=-135] (M1) at ($(ST)+(0,-3cm)$) {};
732 \node[mirror,rotate=-45] (M2) at ($(M1)+(5cm,0)$) {};
733 \node[sensor line,rotate=45,anchor=pixel 3 west,label={[label distance=0.5cm]above right:Caliens}]
734 (Caliens) at ($(ST)+(5cm,0)$) {};
735 \draw[red] (L.aperture east) -- (ST.center) -- (M1.center) -- (M2.center) -- (Caliens.pixel 3 west);
736 \draw[red] (L.aperture east) -- (ST.center) -- (Caliens.pixel 3 west);
737 \end{tikzpicture}
738 \end{codeexample}
739
740 On a utilisé |anchor=pixel 3 west| pour que le centre du capteur soit placé au point |($(ST)+(5cm,0)$)|.
741
742 Plusieurs possibilités pour ajouter un label sont illustrées : créer une |node| au bon endroit avec le texte voulu (ici \emph{séparatrice}), et utiliser la clé \verb|label| (cf. manuel pgf/tikz).
743
744 \subsection{De la dispersion}
745 \label{sec:exemple_dispersion}
746
747 La syntaxe |($(A)!0.6!(B)$)| (\emph{partway modifiers}, lisez le manuel tikz pour les détails) permet de déterminer un point situé à la distance |0.6| entre les points |(A)| et |(B)| (|0| correspond à |(A)| et |1| à |(B)|).
748
749 \begin{codeexample}[]
750 \begin{tikzpicture}[use optics]
751 % [align=center] permet les labels multiligne
752 % [font=\footnotesize] fait un texte plus petit
753 \tikzset{every label/.style={align=center,font=\footnotesize}}
754
755 \node[halogen lamp] (S) at (0,0) {QI};
756 \node[heat filter, right=of S] (AC) {};
757 \node[diaphragm, right=0.1cm of AC] (diaphragme) {};
758 \node[slit, right=0.5cm of diaphragme,label={south:{trou \\ \SI{5}{\milli\meter}}}] (T) {};
759 \node[lens,right=2cm of T] (L) {};
760 \node[screen,right=2cm of L] (ecran) {};
761
762 \draw[red]
763 (T.slit north) -- (L.lens north) -- (ecran.center)
764 (T.slit south) -- (L.lens south) -- (ecran.center);
765
766 \draw[blue]
767 (T.slit north) -- (L.lens north) -- ($(ecran.north)!0.6!(ecran.south)$)
768 (T.slit south) -- (L.lens south) -- ($(ecran.north)!0.4!(ecran.south)$);
769 \end{tikzpicture}
770 \end{codeexample}
771
772
773 \subsection{Un téléscope de Cassegrain}
774
775 Pour dessiner un miroir troué, on utilise la commande |\clip| de tikz (qu'on place dans un |scope| dont le seul contenu est affecté par le |\clip|). On trace alors les rayons à la main, sans se soucier de l'exactitude du schéma.
776
777 \begin{codeexample}[]
778 \begin{tikzpicture}[use optics]
779 % mirror with hole
780 \begin{scope}
781 \clip (-0.75cm,-2.2cm) rectangle (1cm,0-0.33cm) (-0.75cm,2.2cm) rectangle (1cm,0+0.33cm);
782 \node[spherical mirror, object height=4cm, spherical mirror angle=50] (M1) at (0cm,0) {};
783 \end{scope}
784
785 % small mirror
786 \node[convex mirror, spherical mirror orientation=rtl,
787 object height=1cm, spherical mirror angle=90] (M2) at (-4cm,0) {};
788
789 % convergence point
790 \coordinate (F) at (1cm,0);
791
792 % red ray
793 \begin{scope}[red]
794 \draw[-<-] (M1.22) coordinate (P1) -- +(-5cm,0);
795 \draw[->-] (P1) -- (M2.30) coordinate (Q1);
796 \draw[->-] (Q1) -- ($(Q1)!1.25!(F)$) coordinate (R1);
797 \end{scope}
798
799 % blue ray
800 \begin{scope}[blue]
801 \draw[-<<-] (M1.-22) coordinate (P2) -- +(-5cm,0);
802 \draw[->>-] (P2) -- (M2.-30) coordinate (Q2);
803 \draw[->>-] (Q2) -- ($(Q2)!1.25!(F)$) coordinate (R2);
804 \end{scope}
805
806 % violet ray
807 \begin{scope}[violet]
808 \draw[-<-] (M1.22) coordinate (P3) -- +(175:5cm);
809 \draw (P3) -- (M2.22) coordinate (Q3);
810 \draw (Q3) -- ($(Q3)!1.25!($(F)+(0,-0.15cm)$)$) coordinate (R3);
811 \end{scope}
812
813 % sensor
814 \node[generic sensor, anchor=aperture west] at ($(R1)!0.5!(R2)$) {};
815 \end{tikzpicture}
816 \end{codeexample}
817
818 \subsection{De l'optique géométrique et des calculs}
819
820 \begin{codeexample}[]
821 \begin{tikzpicture}[use optics]
822 \node[lens,draw focal points,focal length=1.5cm,object height=2cm] (L) at (0,0) {};
823 \coordinate (P) at (-2cm,0.5cm);
824 \coordinate (Q) at (-2cm,-0.5cm);
825 \draw[red,shorten >=-1cm] (P) -- ($(L.north)!(P)!(L.south)$) -- (L.east focus);
826 \draw[red,shorten >=-1cm] (Q) -- ($(L.north)!(Q)!(L.south)$) -- (L.east focus);
827 \node[screen] at (2.45cm,0) {};
828 \end{tikzpicture}
829 \end{codeexample}
830
831 Cet exemple n'est pas très propre, car j'ai dû allonger manuellement les rayons pour qu'ils aillent jusqu'à l'écran. La méthode suivante, qui consiste à calculer le point d'intersection grâce à une fonction |\toVerticalProjection|, est beaucoup plus propre:
832
833 \begin{codeexample}[]
834 \begin{tikzpicture}[use optics]
835 \node[lens,draw focal points,focal length=1.5cm,object height=2cm] (L) at (0,0) {} ;
836 \coordinate (P) at (-2cm,0.5cm) ;
837 \coordinate (Q) at (-2cm,-0.5cm) ;
838 \node[screen] (S) at (2.5cm,0) {};
839
840 \def\toVerticalProjection#1#2#3{let \p{1} = #1, \p{2} = #2, \p{3} = #3 in
841 -- (\x{3},{\y{1}+(\y{2}-\y{1})/(\x{2}-\x{1})*(\x{3}-\x{1})})}
842
843 \draw[red] (P) -- ($(L.north)!(P)!(L.south)$) coordinate (Plens)
844 \toVerticalProjection{(Plens)}{(L.east focus)}{(S)};
845
846 \draw[red] (Q) -- ($(L.north)!(Q)!(L.south)$) coordinate (Qlens)
847 \toVerticalProjection{(Qlens)}{(L.east focus)}{(S)};
848
849 \end{tikzpicture}
850 \end{codeexample}
851
852 \subsection{De la biréfringence avec un interféromètre de Michelson}
853
854 \input{birefringence_michelson.pgf}
855
856 Cet exemple utilise des intersections pour tracer des rayons lumineux : la syntaxe n'est pas la plus agréable et concise qu'on puisse concevoir, mais elle marche.
857 Cet exemple est aussi l'occasion de montrer l'utilisation du package \texttt{ocgx} avec \texttt{tikz}.
858 Le code de la figure est dans le fichier \textattachfile[]{birefringence_michelson.pgf}{birefringence\_michelson.pgf}.
859
860
861 \section{Référence}
862
863 \subsection{Généralités}
864
865 \subsubsection{Options communes}
866
867 Certaines options sont communes à beaucoup des |shapes| (à l'exception notable des lampes et capteurs).
868
869 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
870 L'option |object height| contrôle la hauteur de la plupart des objets (c'est le cas si rien n'est précisé).
871
872 \begin{codeexample}[width=5cm]
873 \begin{tikzpicture}[use optics,scale=.5]
874 \node[lens, object height=1cm] (L1) at (0,0) {};
875 \node[lens, object height=2cm] (L2) at (3cm,0) {};
876 \end{tikzpicture}
877 \end{codeexample}
878 \end{key}
879
880 \begin{key}{/tikz/optics/object aspect ratio=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/object aspect ratio})}
881 L'option |object aspect ratio| contrôle le rapport d'aspect de la plupart des objets ayant une largeur. Si \meta{number} vaut |1|, la largeur de l'objet est égale à sa hauteur.
882 Si \meta{number}|=1/2|, la largeur de l'objet vaut la moitié de sa hauteur.
883 Quand \meta{number or length} est un nombre sans dimension (e.g. |0.5|), il est interprété comme un rapport d'aspect, relatif à la hauteur. Quand il s'agit d'une longueur dimensionnée (e.g. |1cm|), il est directement interprété comme la largeur (\emph{width}) de l'objet.
884
885 \begin{codeexample}[width=5cm]
886 \begin{tikzpicture}[use optics,scale=.5]
887 \node[polarizer, object aspect ratio=0.2] (L1) at (0,0) {};
888 \node[polarizer, object aspect ratio=0.5] (L2) at (4cm,0) {};
889 \end{tikzpicture}
890 \end{codeexample}
891 \end{key}
892
893 \begin{stylekey}{/tikz/optics/object width}
894 L'option |object width| est un alias pour |object aspect ratio|.
895 \end{stylekey}
896
897 \subsubsection{Longueurs absolues et relatives}
898
899 Les divers éléments ont plusieurs longueurs ajustables. La plupart du temps, il n'est nécessaire de spécifier qu'une seule longueur (généralement la hauteur de l'objet) de manière absolue, c'est-à-dire avec une unité de longueur (|cm|, |pt|, |em|, etc.). Les autres longueurs peuvent être spécifiées en unité de cette longueur absolue de référence (il faut alors spécifier un nombre), ou, si cela s'avère plus pratique, comme des longueurs absolues (il faut alors spécifier une unité). Voici un exemple avec |slit height|, qui peut être spécifié relativement à |object height|.
900
901 \begin{codeexample}[width=6cm]
902 \begin{tikzpicture}[use optics]
903 \draw[style=help lines,gray!50]
904 (-3cm,-2cm) grid[step=0.5cm] (2cm,2cm);
905 \node[slit,object height=2cm,slit height=0.5,red,very thick]
906 at (-2cm,0) {};
907 \node[slit,object height=2cm,slit height=0.25,blue,very thick]
908 at (-1cm,0) {};
909 \node[slit,object height=2cm,slit height=0.5cm,violet,very thick]
910 at (0cm,0) {};
911 \node[slit,object height=2cm,slit height=1cm,orange,very thick]
912 at (1cm,0) {};
913 \end{tikzpicture}
914 \end{codeexample}
915
916 L'intérêt d'utiliser des longueurs \emph{relatives} est que la \emph{forme générale} d'un objet n'est pas modifiée par un changement d'échelle (il n'y a qu'à changer la longueur absolue de référence).
917
918 Les éléments optiques ont plusieurs \enquote{hauteurs}. La hauteur totale est toujours appelée |objet height|, mais par exemple la taille d'une fente est appelée |slit height|, la taille (sans conséquence sur le dessin, mais qui affecte les ancres) d'une lentille sur son support est appelée |lens height|, etc.
919
920 % Note : je ne sais pas si je change les |aspect ratio| par un |object width| qui accepte un \meta{number or length} ...
921 % => C'est fait pour un bon nombre de trucs.
922
923
924 \subsection{Éléments optiques}
925
926 \subsubsection{Lentille}
927
928 \begin{shape}{lens}
929 Dessine une lentille.
930
931 \begin{codeexample}[width=6cm]
932 \begin{tikzpicture}[use optics,scale=.5]
933 \node[lens] (L) at (0,0) {};
934 \end{tikzpicture}
935 \end{codeexample}
936
937
938 \begin{codeexample}[width=6cm]
939 \begin{tikzpicture}[use optics,scale=.5]
940 \node[lens,draw focal points] (L) at (0,0) {};
941 \end{tikzpicture}
942 \end{codeexample}
943
944 \begin{stylekey}{/tikz/optics/draw focal points=\meta{style} (default empty)}
945 On peut tracer les foyers avec |draw focal points|. En donnant \meta{style} en argument à la clé |draw docal points|,
946 on peut déterminer comment sont tracés les foyers. Par exemple \texttt{draw focal points={red}} les trace en rouge, et \texttt{draw focal points={circle,draw=none,fill=blue}} trace un cercle rempli en bleu.
947 \end{stylekey}
948
949 \begin{codeexample}[width=6cm]
950 \begin{tikzpicture}[use optics,scale=.5]
951 \node[lens,draw focal points={red}]
952 (L1) at (0,0) {};
953 \node[lens,draw focal points={circle,draw=none,fill=blue}]
954 (L2) at (3cm,0) {};
955 \end{tikzpicture}
956 \end{codeexample}
957
958 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
959 L'option |object height| est applicable.
960 \end{key}
961
962 \begin{key}{/tikz/optics/focal length=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/focal length})}
963 L'option |focal length| contrôle la distance focale de la lentille.
964
965 \begin{codeexample}[width=6cm,pre={\tikzset{every lens node/.append style={optics,draw focal points}}}]
966 \begin{tikzpicture}[use optics,scale=.5]
967 \node[lens, focal length=1cm] (L1) at (0,0) {};
968 \node[lens, focal length=2cm] (L2) at (0,5cm) {};
969 \end{tikzpicture}
970 \end{codeexample}
971 \end{key}
972
973
974 \begin{key}{/tikz/optics/lens height=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/lens height})}
975 L'option |lens height| contrôle la hauteur de la lentille. Il s'agit soit une longueur abolue (avec unité), soit d'une longueur relative mesurée par rapport à la hauteur totale de la lentille avec support.
976
977 \begin{codeexample}[width=5cm]
978 \begin{tikzpicture}[use optics,scale=.5]
979 \node[lens] (L1) at (1cm,0) {};
980 \node[lens, lens height=0.5] (L2) at (-1cm,0) {};
981 \draw[red] (0,0) -- (L1.lens north) (0,0) -- (L1.lens south);
982 \draw[green] (0,0) -- (L2.lens north) (0,0) -- (L2.lens south);
983 \end{tikzpicture}
984 \end{codeexample}
985
986 % Serait-il plus judicieux d'avoir un système de coordonnées sur la lentille, genre |(L1.0)| pour le centre, |(L1.1)| pour le haut, |(L1.0.5)| pour un point en haut, à mi-lentille, |(L1.-1)| pour le bas, etc. ? Ou est-ce que |($(L1.north)!0.1!(L1.south)$)| suffit amplement ?
987 \end{key}
988
989
990 \begin{key}{/tikz/optics/lens type}
991 L'option |lens type| contrôle le type de lentille. Utiliser |lens type=converging| permet de dessiner une lentille convergente (c'est l'option par défaut), alors que |lens type=diverging| permet de dessiner une lentille divergente.
992
993 \begin{codeexample}[width=5cm]
994 \begin{tikzpicture}[use optics,scale=.5]
995 \node[lens,lens type=converging] (L1) at (-1cm,0) {};
996 \node[lens,lens type=diverging] (L2) at (1cm,0) {};
997 \end{tikzpicture}
998 \end{codeexample}
999 \end{key}
1000
1001
1002 La figure suivante récapitule les ancres définies par |lens|.
1003
1004
1005 \begin{codeexample}[]
1006 \Huge
1007 \begin{tikzpicture}[use optics]
1008 \node[name=s,lens,object height=7cm,focal length=3cm,
1009 lens height=0.5,line shape example] {};
1010 \foreach \anchor/\placement in
1011 {north/above,south/below,lens north/right,lens south/right,center/right,
1012 east focus/above,west focus/above}
1013 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1014 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1015 \end{tikzpicture}
1016 \end{codeexample}
1017
1018 Les clés |east focus| et |west focus| ont pour synonyme |east focal point| et |west focal point|, respectivement.
1019
1020
1021 On peut utiliser la clé \texttt{tikz} \texttt{anchor=} pour placer les lentilles les unes par rapport aux autres.
1022
1023 \begin{codeexample}[width=6cm]
1024 \begin{tikzpicture}[use optics,scale=.5]
1025 \node[lens,draw focal points={red}]
1026 (L1) at (0,0) {};
1027 \node[lens,draw focal points={circle,draw=blue},
1028 focal length=0.5cm,anchor=west focus]
1029 (L2) at (L1.east focus) {};
1030 \end{tikzpicture}
1031 \end{codeexample}
1032
1033 \end{shape}
1034
1035 \subsubsection{Fente}
1036
1037 \begin{shape}{slit}
1038 Dessine une fente.
1039
1040 \begin{codeexample}[width=6cm]
1041 \begin{tikzpicture}[use optics,scale=.5]
1042 \node[slit] (S) at (0,0) {};
1043 \end{tikzpicture}
1044 \end{codeexample}
1045
1046 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1047 L'option |object height| est applicable.
1048 \end{key}
1049
1050
1051 \begin{key}{/tikz/optics/slit height=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/slit height})}
1052 La clé |slit height| définit la hauteur de la fente (s'il s'agit d'une longueur relative, elle est exprimée en unités de la hauteur de l'objet).
1053 Par exemple, \meta{number}|=0.5| donne une fente faisant la moitié de la hauteur du support. De même, \meta{length}|=1cm| donne une fente de |1cm|. Les valeurs de \meta{number} doivent être inférieures à l'unité, et celles de \meta{length} inférieures à celles de |object height|, sans quoi les résultats ne sont pas garantis.
1054
1055 \begin{codeexample}[width=6cm]
1056 \begin{tikzpicture}[use optics,scale=.5]
1057 \node[slit, slit height=0.5] (S) at (0,0) {};
1058 \node[slit, slit height=0.3] (S) at (1cm,0) {};
1059 \node[slit, slit height=0.1] (S) at (2cm,0) {};
1060 \end{tikzpicture}
1061 \end{codeexample}
1062 \end{key}
1063
1064 La figure suivante récapitule les ancres définies par |slit|.
1065
1066 \begin{codeexample}[]
1067 \Huge
1068 \begin{tikzpicture}[use optics]
1069 \node[name=s,slit,object height=8cm,
1070 slit height=0.2,line shape example] {};
1071 \foreach \anchor/\placement in
1072 {north/above,south/below,slit north/right,slit south/right,center/left,
1073 slit center/right}
1074 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1075 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1076 \end{tikzpicture}
1077 \end{codeexample}
1078
1079 \end{shape}
1080
1081 \subsubsection{Double fente}
1082
1083
1084 \begin{shape}{double slit}
1085 Dessine une fente double.
1086
1087 \begin{codeexample}[width=5cm]
1088 \begin{tikzpicture}[use optics,scale=.5]
1089 \node[double slit] (S) at (0,0) {};
1090 \end{tikzpicture}
1091 \end{codeexample}
1092
1093 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1094 L'option |object height| est applicable.
1095 \end{key}
1096
1097
1098 \begin{key}{/tikz/optics/slit height=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/slit height})}
1099 La clé |slit height| définit la hauteur d'une fente (s'il s'agit d'une longueur relative, elle est en unités de la hauteur de l'objet).
1100 Chacune des fentes a une hauteur \meta{number or length}.
1101
1102 \begin{codeexample}[width=5cm]
1103 \begin{tikzpicture}[use optics,scale=.5,optics/slit separation=0.5]
1104 \node[double slit, slit height=0.075] (S) at (0,0) {};
1105 \node[double slit, slit height=0.1] (S) at (1cm,0) {};
1106 \node[double slit, slit height=0.2] (S) at (2cm,0) {};
1107 \end{tikzpicture}
1108 \end{codeexample}
1109 \end{key}
1110
1111 \begin{key}{/tikz/optics/slit separation=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/slit separation})}
1112 La clé |slit separation| définit la distance entre les deux fentes (s'il s'agit d'une longueur relative, elle est en unités de la hauteur de l'objet).
1113
1114 \begin{codeexample}[width=5cm]
1115 \begin{tikzpicture}[use optics,scale=.5]
1116 \node[double slit, slit separation=0.1] (S) at (0,0) {};
1117 \node[double slit, slit separation=0.2] (S) at (1cm,0) {};
1118 \node[double slit, slit separation=0.3] (S) at (2cm,0) {};
1119 \end{tikzpicture}
1120 \end{codeexample}
1121 \end{key}
1122
1123
1124
1125 La figure suivante récapitule les ancres définies par |double slit|.
1126
1127 \begin{codeexample}[]
1128 \Huge
1129 \begin{tikzpicture}[use optics]
1130 \node[double slit,name=s,object height=8cm, slit height=0.15,
1131 slit separation=0.5, line shape example] {};
1132 \foreach \anchor/\placement in
1133 {north/above,south/below,center/left,
1134 slit 1 north/right,slit 1 south/right,slit 1 center/right,
1135 slit 2 north/right,slit 2 south/right,slit 2 center/right}
1136 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1137 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1138 \end{tikzpicture}
1139 \end{codeexample}
1140
1141 \end{shape}
1142
1143
1144 \subsubsection{Miroir}
1145
1146
1147 \begin{shape}{mirror}
1148 Dessine un miroir plan.
1149
1150 \begin{codeexample}[width=6cm]
1151 \begin{tikzpicture}[use optics,scale=.5]
1152 \node[mirror] (S) at (0,0) {};
1153 \end{tikzpicture}
1154 \end{codeexample}
1155
1156 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1157 L'option |object height| est applicable.
1158 \end{key}
1159
1160 \begin{key}{/tikz/optics/mirror decoration separation=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/mirror decoration separation})}
1161 Correspond à la clé |/pgf/decoration/segment length| pour la décoration |border| utilisée pour dessiner le miroir (cf. manuel de pgf/tikz).
1162 La valeur correspondant à |/pgf/decoration/segment length| est obtenue en multipliant \meta{number} par la hauteur du miroir.
1163 \end{key}
1164
1165 \begin{key}{/tikz/optics/mirror decoration amplitude=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/mirror decoration amplitude})}
1166 Correspond à la clé |/pgf/decoration/amplitude| pour la décoration |border| utilisée pour dessiner le miroir (cf. manuel de pgf/tikz).
1167 La valeur correspondant à |/pgf/decoration/amplitude| est obtenue en multipliant \meta{number} par la hauteur du miroir.
1168 \end{key}
1169
1170
1171 La figure suivante récapitule les ancres définies par |mirror|.
1172
1173 \begin{codeexample}[]
1174 \Huge
1175 \begin{tikzpicture}[use optics]
1176 \node[mirror,name=s,object height=8cm,line shape example,
1177 mirror decoration separation=0.141, mirror decoration amplitude=0.2] {};
1178 \foreach \anchor/\placement in
1179 {north/above,south/below,center/right}
1180 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1181 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1182 \end{tikzpicture}
1183 \end{codeexample}
1184
1185 La clé |focus| a pour synonyme |focal point|.
1186
1187 \end{shape}
1188
1189 \subsubsection{Miroir sphérique}
1190
1191 \begin{shape}{spherical mirror}
1192 Dessine un miroir sphérique (concave ou convexe).
1193
1194 \begin{warning}
1195 Cette partie n'est pas encore au point et peut changer sans préavis.
1196 \end{warning}
1197
1198 \begin{codeexample}[width=6cm]
1199 \begin{tikzpicture}[use optics,scale=.5]
1200 \node[spherical mirror] (M) at (0,0) {};
1201 \end{tikzpicture}
1202 \end{codeexample}
1203
1204 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1205 La clé |object height| est applicable.
1206 \end{key}
1207
1208 \begin{key}{/tikz/optics/spherical mirror angle=\meta{angle} (initially \pgfkeysvalueof{/tikz/optics/spherical mirror angle})}
1209 La clé |spherical mirror angle| contrôle l'angle d'ouverture du miroir sphérique (un arc de cercle de hauteur spécifiée par |object height| et d'ouverture angulaire \meta{angle} est dessiné).
1210 Attention à ne pas choisir $\meta{angle}=0$ : utiliser un miroir plat |mirror| à la place.
1211 \begin{codeexample}[width=5cm]
1212 \begin{tikzpicture}[use optics]
1213 \node[spherical mirror, spherical mirror angle=60] at (0,0) {};
1214 \node[spherical mirror, spherical mirror angle=120] at (2cm,0) {};
1215 \node[spherical mirror, spherical mirror angle=180] at (4cm,0) {};
1216 \end{tikzpicture}
1217 \end{codeexample}
1218
1219 \begin{warning}
1220 La fonction |from_radius| est expérimentale.
1221 \end{warning}
1222
1223 Il peut être utile de spécifier non pas l'angle d'ouverture, mais le rayon de courbure du miroir ; dans ce but, une fonction |from_radius(R)| calcule l'angle d'ouverture correspondant au rayon |R|, à hauteur |/tikz/optics/object height| imposée. Bien entendu, il n'est pas possible que la hauteur soit supérieure au double du rayon du miroir.
1224 \begin{codeexample}[width=5cm]
1225 \begin{tikzpicture}[use optics]
1226 \node[spherical mirror, object height=2cm,
1227 spherical mirror angle=from_radius(3cm),
1228 draw mirror focus, draw mirror center={red}] (M) {};
1229 \end{tikzpicture}
1230 \end{codeexample}
1231 \end{key}
1232
1233 \begin{key}{/tikz/optics/spherical mirror type}
1234 La clé |spherical mirror type| contrôle le type de miroir : utiliser |spherical mirror type=concave| donne un miroir concave (c'est l'option par défaut), alors que |spherical mirror type=convex| donne un miroir convexe.
1235 Il est plus commode d'utiliser les styles |convex mirror| et |concave mirror|, qui sont des raccourcis pour cette clé.
1236
1237 \begin{codeexample}[width=5cm]
1238 \begin{tikzpicture}[use optics]
1239 \node[convex mirror, label={[label distance=0.25cm]south:convex mirror}] at (0cm,0) {};
1240 \node[concave mirror, label={[label distance=0.25cm]south:concave mirror}] at (4cm,0) {};
1241 \end{tikzpicture}
1242 \end{codeexample}
1243 \end{key}
1244
1245 \begin{stylekey}{/tikz/optics/concave mirror}
1246 Le style |concave mirror| correspond à |spherical mirror, spherical mirror type=concave|, et dessine un miroir concave. Voir |spherical mirror type| pour un exemple.
1247 \end{stylekey}
1248
1249 \begin{stylekey}{/tikz/optics/convex mirror}
1250 Le style |convex mirror| correspond à |spherical mirror, spherical mirror type=convex|, et dessine un miroir convexe. Voir |spherical mirror type| pour un exemple.
1251 \end{stylekey}
1252
1253
1254 \begin{key}{/tikz/optics/spherical mirror orientation=\meta{type} (initially |ltr|)}
1255 La clé |spherical mirror orientation| contrôle l'orientation de miroir (i.e. dans quel sens on suppose que la lumière se propage). Les valeurs possibles sont |ltr| (\enquote{left to right}) et |rtl| (\enquote{right to left}).
1256
1257 \begin{codeexample}[width=5cm]
1258 \begin{tikzpicture}[use optics]
1259 \node[spherical mirror, spherical mirror orientation=ltr] at (0cm,0) {};
1260 \node[spherical mirror, spherical mirror orientation=rtl] at (2cm,0) {};
1261 \end{tikzpicture}
1262 \end{codeexample}
1263 \end{key}
1264
1265 La décoration du miroir (hachures) est contrôlée par les mêmes clés que celle de |mirror| : |mirror decoration separation| et |mirror decoration amplitude|.
1266
1267
1268 La figure suivante récapitule certaines des ancres définies par |spherical mirror|.
1269
1270 \begin{codeexample}[]
1271 \Huge
1272 \begin{tikzpicture}[use optics]
1273 \node[spherical mirror,name=s,object height=8cm,line shape example,
1274 mirror decoration separation=0.141, mirror decoration amplitude=0.2] {};
1275 \foreach \anchor/\placement in
1276 {north/above,south/below,center/below right,
1277 east/below right,
1278 west/below,
1279 north east/above right,
1280 north west/above left,
1281 south east/below right,
1282 south west/below left,
1283 mirror center/left,
1284 arc start/above,
1285 arc end/below,
1286 arc center/right,
1287 27/right,
1288 focus/above}
1289 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1290 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1291 \end{tikzpicture}
1292 \end{codeexample}
1293
1294 Avec les miroirs sphériques, les \enquote{border anchor} de tikz sont particulièrement utiles. Des ancres numériques (de la forme |node.27|) sont définies, qui permettent d'accèder au bord de la |shape| dans la direction angulaire correspondante (ici à \ang{27}). Rappelons que dans tikz, les angles sont comptés dans le sens trigonométrique à partir de l'axe $Ox$, et exprimés en degrés. Suit un exemple, où on a dessiné le cercle sous-jacent.
1295
1296 \begin{codeexample}[width=5cm]
1297 \begin{tikzpicture}[use optics,scale=.5]]
1298 \coordinate (O) at (0,0);
1299 \node[circle,draw, inner sep=0, outer sep=0,minimum height=2cm, densely dashed, gray!60] (C) at (O) {};
1300 \node[spherical mirror,draw,object height=2cm,anchor=mirror center,
1301 spherical mirror angle=180] (M) at (O) {};
1302 \draw[blue] (O) -- (M.0);
1303 \draw[violet] (O) -- (M.45);
1304 \draw[red] (O) -- (M.90);
1305 \draw[orange] (O) -- (M.135);
1306 \end{tikzpicture}
1307 \end{codeexample}
1308
1309 \begin{warning}
1310 Pour le moment, les angles supérieurs à $\pm$|spherical mirror angle|$/2$ sont traités comme si le miroir était un cercle entier (et pas un arc). Il n'est pas garanti que ce comportement soit maintenu.
1311 \end{warning}
1312
1313 \end{shape}
1314
1315
1316 \begin{stylekey}{/tikz/optics/draw mirror center=\meta{style}}
1317 Le style |draw mirror center| permet de dessiner le centre du miroir (avec le style \meta{style} s'il est spécifié).
1318
1319 \begin{codeexample}[width=5cm]
1320 \begin{tikzpicture}[use optics]
1321 \node[concave mirror,draw mirror center, draw mirror focus={red}] {};
1322 \end{tikzpicture}
1323 \end{codeexample}
1324 \end{stylekey}
1325
1326 \begin{stylekey}{/tikz/optics/draw mirror focus=\meta{style}}
1327 Le style |draw mirror focus| permet de dessiner le foyer du miroir (avec le style \meta{style} s'il est spécifié). Voir |draw mirror center| pour un exemple.
1328 \end{stylekey}
1329
1330 \subsubsection{Polariseur}
1331
1332 \begin{shape}{polarizer}
1333 Dessine un polariseur.
1334
1335 \begin{codeexample}[width=5cm]
1336 \begin{tikzpicture}[use optics,scale=.5]
1337 \node[polarizer] (S) at (0,0) {};
1338 \end{tikzpicture}
1339 \end{codeexample}
1340
1341
1342 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1343 L'option |object height| est applicable.
1344 \end{key}
1345
1346
1347 \begin{key}{/tikz/optics/object aspect ratio=\meta{number} (initially \pgfkeysvalueof{/tikz/optics/object aspect ratio})}
1348 L'option |object aspect ratio| contrôle le rapport d'aspect du polariseur. Si \meta{number} vaut |1|, la largeur de l'objet est égale à sa hauteur.
1349 Si \meta{number}|=1/2|, la largeur du polariseur vaut la moitié de sa hauteur
1350
1351 \begin{codeexample}[width=5cm]
1352 \begin{tikzpicture}[use optics,scale=.5]
1353 \node[polarizer, object aspect ratio=0.2] (L1) at (0,0) {};
1354 \node[polarizer, object aspect ratio=0.5] (L2) at (4cm,0) {};
1355 \end{tikzpicture}
1356 \end{codeexample}
1357 \end{key}
1358
1359
1360
1361 La figure suivante récapitule les ancres définies par |polarizer|.
1362
1363 \begin{codeexample}[]
1364 \Huge
1365 \begin{tikzpicture}[use optics]
1366 \node[polarizer,name=s,object height=8cm,object aspect ratio=0.4,shape example] {};
1367 \foreach \anchor/\placement in
1368 {north/above,south/below,east/right,west/left,center/below,
1369 north east/right,north west/left,south east/right,south west/left}
1370 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1371 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1372 \end{tikzpicture}
1373 \end{codeexample}
1374
1375 \end{shape}
1376
1377
1378 \subsubsection{Séparateur de faisceau}
1379
1380 \begin{stylekey}{/tikz/optics/beam splitter}
1381 Dessine un séparateur de faisceau. Les options et ancres sont les mêmes que pour |polarizer|.
1382
1383 \begin{codeexample}[width=6cm]
1384 \begin{tikzpicture}[use optics,scale=.5]
1385 \node[beam splitter] at (0,0) {};
1386 \end{tikzpicture}
1387 \end{codeexample}
1388
1389 \end{stylekey}
1390
1391
1392 \subsubsection{Prisme à vision directe}
1393
1394 \begin{shape}{double amici prism}
1395 Dessine un prisme à vision directe (double prisme d'Amici).
1396
1397 \begin{codeexample}[width=6cm]
1398 \begin{tikzpicture}[use optics,scale=.5]
1399 \node[double amici prism] (PVD) at (0,0) {};
1400 \end{tikzpicture}
1401 \end{codeexample}
1402
1403
1404 \begin{key}{/tikz/optics/prism height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/prism height})}
1405 La clé |prism height| contrôle la hauteur des trois prismes identiques constituant le PVD (la longueur d'un côté est donc $2/\sqrt{3}$ fois cette hauteur).
1406
1407 \begin{codeexample}[width=5cm]
1408 \begin{tikzpicture}[use optics,scale=.5]
1409 \node[double amici prism, prism height=1cm] (PVD1) at (0,0) {};
1410 \node[double amici prism, prism height=0.5cm] (PVD2) at (4cm,0) {};
1411 \end{tikzpicture}
1412 \end{codeexample}
1413 \end{key}
1414
1415
1416 \begin{key}{/tikz/optics/prism apex angle=\meta{angle} (initially \pgfkeysvalueof{/tikz/optics/prism apex angle})}
1417 La clé |prism apex angle| contrôle l'angle au sommet des trois prismes identiques. \meta{angle} est exprimé en degrés. Si \meta{angle} vaut |60|, les prismes sont des triangles isocèles.
1418
1419 \begin{codeexample}[width=5cm]
1420 \begin{tikzpicture}[use optics,scale=.5]
1421 \node[double amici prism, prism apex angle=40] (PVD1) at (0,0) {};
1422 \node[double amici prism, prism apex angle=60] (PVD2) at (4cm,0) {};
1423 \node[double amici prism, prism apex angle=80] (PVD3) at (10cm,0) {};
1424 \end{tikzpicture}
1425 \end{codeexample}
1426 \end{key}
1427
1428
1429
1430 La figure suivante récapitule les ancres définies par |double amici prism|.
1431
1432 \begin{codeexample}[]
1433 \Huge
1434 \begin{tikzpicture}[use optics]
1435 \node[double amici prism,name=s,prism height=4.5cm,shape example] {};
1436 \foreach \anchor/\placement in
1437 {north/above,south/below,east/right,west/left,center/below,
1438 north east/right,north west/left,south east/right,south west/left}
1439 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1440 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1441 \end{tikzpicture}
1442 \end{codeexample}
1443
1444 \end{shape}
1445
1446
1447 \subsubsection{Élément générique fin}
1448
1449 \begin{shape}{thin optics element}
1450 Dessine un élement générique (utilisé pour des éléments plus spécifiques).
1451 Cette |shape| peut être utile pour dessiner un objet non prévu, en lui donnant un style pertinent.
1452
1453 \begin{codeexample}[width=6cm]
1454 \begin{tikzpicture}[use optics,scale=.5]
1455 \node[thin optics element] (S) at (0,0) {};
1456 \end{tikzpicture}
1457 \end{codeexample}
1458
1459 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1460 L'option |object height| est applicable.
1461 \end{key}
1462
1463 La figure suivante récapitule les ancres définies par |thin optics element|.
1464
1465 \begin{codeexample}[]
1466 \Huge
1467 \begin{tikzpicture}[use optics]
1468 \node[thin optics element,name=s,object height=8cm,line shape example] {};
1469 \foreach \anchor/\placement in
1470 {north/above,south/below,center/right}
1471 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1472 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1473 \end{tikzpicture}
1474 \end{codeexample}
1475
1476 \end{shape}
1477
1478 \subsubsection{Élément générique épais}
1479
1480 \begin{shape}{thick optics element}
1481 Dessine un élément générique épais.
1482
1483 \begin{codeexample}[width=6cm]
1484 \begin{tikzpicture}[use optics,scale=.5]
1485 \node[thick optics element] at (0,0) {};
1486 \end{tikzpicture}
1487 \end{codeexample}
1488
1489
1490 \begin{key}{/tikz/optics/object height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/object height})}
1491 L'option |object height| est applicable.
1492 \end{key}
1493
1494
1495 \begin{key}{/tikz/optics/object aspect ratio=\meta{number or length} (initially 0.05)}
1496 L'option |object aspect ratio| contrôle le rapport d'aspect de l'objet.
1497 \end{key}
1498
1499
1500
1501
1502 La figure suivante récapitule les ancres définies par |thick optics element|.
1503
1504 \begin{codeexample}[]
1505 \Huge
1506 \begin{tikzpicture}[use optics]
1507 \node[thick optics element,name=s,object height=8cm,shape example,object aspect ratio=0.2] {};
1508 \foreach \anchor/\placement in
1509 {north/above,south/below,east/right,west/left,center/below,
1510 north east/right,north west/left,south east/right,south west/left}
1511 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1512 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1513 \end{tikzpicture}
1514 \end{codeexample}
1515
1516 \end{shape}
1517
1518 \subsubsection{Anticalorique}
1519
1520 \begin{stylekey}{/tikz/optics/heat filter}
1521 Le style |heat filter| permet de dessiner un filtre anticalorique. Les options de |thick optics element| sont applicables.
1522
1523 \begin{codeexample}[width=6cm]
1524 \begin{tikzpicture}[use optics,scale=.5]
1525 \node[heat filter] (S) at (0,0) {};
1526 \end{tikzpicture}
1527 \end{codeexample}
1528 \end{stylekey}
1529
1530
1531 \subsubsection{Écran}
1532
1533
1534 \begin{stylekey}{/tikz/optics/screen}
1535 Le style |screen| permet de dessiner un écran. Les options de |thin optics element| sont applicables.
1536
1537 \begin{codeexample}[width=6cm]
1538 \begin{tikzpicture}[use optics,scale=.5]
1539 \node[screen] (S) at (0,0) {};
1540 \end{tikzpicture}
1541 \end{codeexample}
1542 \end{stylekey}
1543
1544 \subsubsection{Réseau de diffraction}
1545
1546 \begin{stylekey}{/tikz/optics/diffraction grating}
1547 Le style |diffraction grating| permet de dessiner un réseau de diffraction. Les options de |thin optics element| sont applicables.
1548
1549 \begin{codeexample}[width=6cm]
1550 \begin{tikzpicture}[use optics,scale=.5]
1551 \node[diffraction grating] (S) at (0,0) {};
1552 \end{tikzpicture}
1553 \end{codeexample}
1554 \end{stylekey}
1555
1556 \subsubsection{Grille}
1557
1558 \begin{stylekey}{/tikz/optics/grid}
1559 Le style |grid| permet de dessiner une grille. Les options de |thin optics element| sont applicables.
1560
1561 \begin{codeexample}[width=6cm]
1562 \begin{tikzpicture}[use optics,scale=.5]
1563 \node[grid] (S) at (0,0) {};
1564 \end{tikzpicture}
1565 \end{codeexample}
1566 \end{stylekey}
1567
1568 \subsubsection{Lame semi-réfléchissante}
1569
1570 \begin{stylekey}{/tikz/optics/semi-transparent mirror}
1571 Le style |semi-transparent mirror| permet de dessiner un miroir semi-réfléchissant. Les options de |thin optics element| sont applicables.
1572
1573 \begin{codeexample}[width=6cm]
1574 \begin{tikzpicture}[use optics,scale=.5]
1575 \node[semi-transparent mirror] (S) at (0,0) {};
1576 \end{tikzpicture}
1577 \end{codeexample}
1578 \end{stylekey}
1579
1580 \subsubsection{Diaphragme}
1581
1582 \begin{stylekey}{/tikz/optics/diaphragm}
1583 Le style |diaphragm| permet de dessiner un diaphragme (c'est un |slit| avec une fente large). Les options de |slit| sont applicables.
1584
1585 \begin{codeexample}[width=6cm]
1586 \begin{tikzpicture}[use optics,scale=.5]
1587 \node[diaphragm] (S) at (0,0) {};
1588 \end{tikzpicture}
1589 \end{codeexample}
1590 \end{stylekey}
1591
1592
1593 \subsection{Lampes et capteurs}
1594
1595 \subsubsection{Entrée/sortie optique générique}
1596
1597 \begin{shape}{generic optics io}
1598 Dessine un système entrée-sortie générique (utilisé pour des objets plus spécifiques).
1599
1600 \begin{codeexample}[width=6cm]
1601 \begin{tikzpicture}[use optics,scale=.5]
1602 \node[generic optics io] (S) at (0,0) {};
1603 \end{tikzpicture}
1604 \end{codeexample}
1605
1606
1607 \begin{key}{/tikz/optics/io body height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/io body height})}
1608 La clé |io body height| contrôle la taille de la lampe. En particulier, \meta{length} spécifie la hauteur du corps de la lampe,
1609 et les autres longueurs sont spécifiées relativement à celle-ci. En modifiant \meta{length}, on modifie donc la taille de la lampe
1610 sans la déformer.
1611
1612 \begin{codeexample}[]
1613 \begin{tikzpicture}[use optics,scale=.5]
1614 \node[generic optics io, io body height=1cm] (L1) at (0,0) {};
1615 \node[generic optics io, io body height=2cm] (L2) at (10cm,0) {};
1616 \end{tikzpicture}
1617 \end{codeexample}
1618 \end{key}
1619
1620 \begin{key}{/tikz/optics/io body aspect ratio=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/io body aspect ratio})}
1621 La clé |io body aspect ratio| contrôle le rapport d'aspect de la lampe. Si \meta{number} vaut |1|, la largeur de la lampe est égale à sa hauteur.
1622 Si \meta{number}|=1/2|, la largeur de la lampe vaut la moitié de sa hauteur
1623
1624 \begin{codeexample}[]
1625 \begin{tikzpicture}[use optics,scale=.5]
1626 \node[generic optics io, io body aspect ratio=1] (L1) at (0,0) {};
1627 \node[generic optics io, io body aspect ratio=2] (L2) at (8cm,0) {};
1628 \end{tikzpicture}
1629 \end{codeexample}
1630 \end{key}
1631
1632 \begin{stylekey}{/tikz/optics/io body width=\meta{number or length}}
1633 La clé |io body width| est un alias pour |io body aspect ratio|.
1634 \end{stylekey}
1635
1636
1637 \begin{key}{/tikz/optics/io aperture width=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/io aperture width})}
1638 La clé |io aperture width| contrôle la largeur du système de sortie de la lampe (qui représente un condenseur, une lentille de collimation, etc.), en unités de la hauteur du corps de la lampe. Si \meta{number}|=0|, le système de sortie n'est pas affiché.
1639
1640 \begin{codeexample}[]
1641 \begin{tikzpicture}[use optics,scale=.5]
1642 \node[generic optics io, io aperture width=0] at (0,0) {};
1643 \node[generic optics io, io aperture width=0.1] at (8cm,0) {};
1644 \node[generic optics io, io aperture width=0.5] at (16cm,0) {};
1645 \end{tikzpicture}
1646 \end{codeexample}
1647 \end{key}
1648
1649
1650
1651
1652 \begin{key}{/tikz/optics/io aperture height=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/io aperture height})}
1653 La clé |io aperture width| contrôle la hauteur du système de sortie de la lampe (qui représente un condenseur, une lentille de collimation, etc.), en unités de la hauteur du corps de la lampe.
1654
1655 \begin{codeexample}[]
1656 \begin{tikzpicture}[use optics,scale=.5]
1657 \node[generic optics io, io aperture height=0.5] at (0,0) {};
1658 \node[generic optics io, io aperture height=0.8] at (8cm,0) {};
1659 \end{tikzpicture}
1660 \end{codeexample}
1661 \end{key}
1662
1663
1664 \begin{key}{/tikz/optics/io aperture shift=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/io aperture shift})}
1665 L'option |io aperture shift| contrôle le décalage du système de sortie de la lampe par rapport au centre, en unités de la hauteur du corps de la lampe.
1666
1667 \begin{codeexample}[]
1668 \begin{tikzpicture}[use optics,scale=.5,
1669 optics,io body height=2cm,io body aspect ratio=0.5,io aperture height=0.3, io aperture width=0.1]
1670 \node[generic optics io,io aperture shift=-0.25] at (-5cm,0) {};
1671 \node[generic optics io,io aperture shift=0] at (0,0) {};
1672 \node[generic optics io,io aperture shift=0.25] at (5cm,0) {};
1673 \end{tikzpicture}
1674 \end{codeexample}
1675 \end{key}
1676
1677
1678 On peut afficher du texte dans le corps d'une lampe en utilisant le texte de la |node|.
1679
1680 \begin{codeexample}[]
1681 \begin{tikzpicture}[use optics,scale=.5]
1682 \node[generic optics io] at (-5cm,0) {Q.I.};
1683 \end{tikzpicture}
1684 \end{codeexample}
1685
1686 \begin{key}{/tikz/optics/io orientation=\meta{type} (initially |ltr|)}
1687 La clé |io orientation| détermine le sens dans lequel est dessiné l'objet (avec l'ouverture à droite (au niveau de l'ancre |east|) quand elle vaut |ltr| et à gauche (au niveau de l'ancre |west|) quand elle vaut |rtl|). Les noms correspondent à \enquote{left to right} et \enquote{right to left}.
1688 Seules les arguments |ltr| et |rtl| sont autorisés. La différence avec |rotate| est que |io orientation| modifie les ancres.
1689
1690 \begin{codeexample}[]
1691 \begin{tikzpicture}[use optics,scale=.5]
1692 \node[generic optics io] at (0,0) {};
1693 \node[generic optics io,io orientation=ltr] at (5cm,0) {};
1694 \node[generic optics io,io orientation=rtl] at (10cm,0) {};
1695 \end{tikzpicture}
1696 \end{codeexample}
1697 \end{key}
1698
1699
1700 On peut afficher du texte dans le corps d'une lampe en utilisant le texte de la |node|.
1701
1702 \begin{codeexample}[]
1703 \begin{tikzpicture}[use optics,scale=.5]
1704 \node[generic optics io] at (-5cm,0) {Q.I.};
1705 \end{tikzpicture}
1706 \end{codeexample}
1707
1708
1709 La figure suivante récapitule les ancres définies par |generic optics io|.
1710
1711 \begin{codeexample}[]
1712 \Huge
1713 \begin{tikzpicture}[use optics]
1714 \node[generic optics io,name=s,io body height=4cm,io aperture width=0.7,io body aspect ratio=1.8,shape example] {};
1715 \foreach \anchor/\placement in
1716 {body north/above,body south/below,body east/above right,body west/right,body center/below,
1717 body north east/above,body north west/above,body south east/below,body south west/below,
1718 aperture north/above,aperture south/below,aperture east/right,aperture west/left,aperture center/below,
1719 aperture north east/right,aperture north west/left,aperture south east/right,aperture south west/left}
1720 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1721 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1722 \end{tikzpicture}
1723 \end{codeexample}
1724
1725 Notons que les ancres |body east| et |aperture west| correspondent au même point. Les deux sont définies dans un souci de cohérence. Une ancre |east| est définie comme |body east| ou |aperture east| en fonction de la valeur de |io orientation| de manière à ce que |east| soit la clé la plus à l'est (à droite). La même chose a lieu pour l'ancre |west|.
1726
1727 La figure suivante récapitule les ancres définies par |generic optics io, io orientation=rtl|.
1728
1729 \begin{codeexample}[]
1730 \Huge
1731 \begin{tikzpicture}[use optics]
1732 \node[generic optics io,name=s,io body height=4cm,io aperture width=0.7,io body aspect ratio=1.8,
1733 io orientation=rtl,shape example] {};
1734 \foreach \anchor/\placement in
1735 {body north/above,body south/below,body east/above right,body west/above right,body center/below,
1736 body north east/above,body north west/above,body south east/below,body south west/below,
1737 aperture north/above,aperture south/below,aperture east/right,aperture west/left,aperture center/below,
1738 aperture north east/right,aperture north west/left,aperture south east/right,aperture south west/left}
1739 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1740 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1741 \end{tikzpicture}
1742 \end{codeexample}
1743
1744 \end{shape}
1745
1746
1747 \subsubsection{Ligne de capteurs}
1748
1749
1750 \begin{shape}{sensor line}
1751 Dessine une ligne de capteurs (type Caliens).
1752
1753 \begin{codeexample}[width=6cm]
1754 \begin{tikzpicture}[use optics,scale=.5]
1755 \node[sensor line] (S) at (0,0) {};
1756 \end{tikzpicture}
1757 \end{codeexample}
1758
1759 \begin{key}{/tikz/optics/sensor line height=\meta{length} (initially \pgfkeysvalueof{/tikz/optics/sensor line height})}
1760 La clé |sensor line height| contrôle la taille de la ligne de capteurs. En particulier, \meta{length} spécifie la hauteur du corps de la ligne,
1761 et les autres longueurs peuvent être spécifiées relativement à celle-ci (en ne donnant pas d'unité). Dans ce cas, en modifiant \meta{length}, on modifie donc la taille de la ligne de capteurs
1762 sans la déformer.
1763
1764 \begin{codeexample}[]
1765 \begin{tikzpicture}[use optics,scale=.5]
1766 \node[sensor line, sensor line height=1cm] (L1) at (0,0) {};
1767 \node[sensor line, sensor line height=2cm] (L2) at (4cm,0) {};
1768 \end{tikzpicture}
1769 \end{codeexample}
1770 \end{key}
1771
1772 \begin{key}{/tikz/optics/sensor line aspect ratio=\meta{number} (initially \pgfkeysvalueof{/tikz/optics/sensor line aspect ratio})}
1773 La clé |sensor line aspect ratio| contrôle le rapport d'aspect de la ligne de capteurs.
1774
1775 \begin{codeexample}[]
1776 \begin{tikzpicture}[use optics,scale=.5]
1777 \node[sensor line, sensor line aspect ratio=0.2] (L1) at (0,0) {};
1778 \node[sensor line, sensor line aspect ratio=0.4] (L2) at (4cm,0) {};
1779 \end{tikzpicture}
1780 \end{codeexample}
1781 \end{key}
1782
1783
1784 \begin{key}{/tikz/optics/sensor line pixel number=\meta{number} (initially \pgfkeysvalueof{/tikz/optics/sensor line pixel number})}
1785 La clé |sensor line pixel number| contrôle le nombre de pixels \meta{number} de la ligne de capteurs.
1786
1787 \begin{codeexample}[]
1788 \begin{tikzpicture}[use optics,scale=.5]
1789 \node[sensor line, sensor line pixel number=2] at (0,0) {};
1790 \node[sensor line, sensor line pixel number=4] at (4cm,0) {};
1791 \node[sensor line, sensor line pixel number=10] at (8cm,0) {};
1792 \end{tikzpicture}
1793 \end{codeexample}
1794 \end{key}
1795
1796
1797 \begin{key}{/tikz/optics/sensor line pixel width=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/sensor line pixel width})}
1798 La clé |sensor line pixel width| contrôle la largeur des pixels : \meta{number or length} est la largeur d'un pixel (par rapport à la largeur du capteur si elle est relative).
1799
1800 \begin{codeexample}[]
1801 \begin{tikzpicture}[use optics,scale=.5]
1802 \node[sensor line, sensor line pixel width=0.3] at (0,0) {};
1803 \node[sensor line, sensor line pixel width=0.8] at (4cm,0) {};
1804 \end{tikzpicture}
1805 \end{codeexample}
1806 \end{key}
1807
1808
1809 \begin{key}{/tikz/optics/sensor line inner ysep=\meta{number or length} (initially \pgfkeysvalueof{/tikz/optics/sensor line inner ysep})}
1810 La clé |sensor line inner ysep| contrôle la séparation entre les bords haut et bas du capteur et les pixels. Si \meta{number or length} est une hauteur relative, elle est comptée par rapport à la hauteur du capteur. La hauteur des pixels est calculée de manière à ce qu'il y en ait un nombre |sensor line pixel number|, en tenant compte de cette séparation.
1811
1812 \begin{codeexample}[]
1813 \begin{tikzpicture}[use optics,scale=.5]
1814 \node[sensor line,sensor line inner ysep=0] at (0,0) {};
1815 \node[sensor line,sensor line inner ysep=0.1] at (4cm,0) {};
1816 \node[sensor line,sensor line inner ysep=0.2] at (8cm,0) {};
1817 \end{tikzpicture}
1818 \end{codeexample}
1819 \end{key}
1820
1821
1822 Les ancres |north|, |south|, |east|, |west|, |center|, |north east|, |north west|, |south east|, |south west|, ainsi que
1823 |pixel <i> <anchor>| où |<anchor>| vaut |north|, |south|, etc. et où |<i>| est le numéro du pixel considéré
1824 (allant de |1| à |sensor line pixel number|) sont définies. Par exemple, on peut utiliser |pixel 3 west|.
1825
1826 La figure suivante récapitule les ancres définies par |sensor line| définies globalement ainsi que pour le pixel 4 (en rouge).
1827
1828 \begin{codeexample}[]
1829 \Huge
1830 \begin{tikzpicture}[use optics]
1831 \node[sensor line,name=s,sensor line height=10cm,sensor line aspect ratio=0.8,
1832 sensor line inner ysep=0.1,sensor line pixel number=5, shape example] {};
1833 \foreach \anchor/\placement in
1834 {north/above,south/below,east/right,west/left,center/below,
1835 north east/right,north west/left,south east/right,south west/left}
1836
1837 \draw[shift=(s.\anchor)] plot[mark=x] coordinates{(0,0)}
1838 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1839
1840 \foreach \anchor/\placement in
1841 {pixel 4 north/above,pixel 4 south/below,pixel 4 east/right,pixel 4 west/left,pixel 4 center/below,
1842 pixel 4 north east/right,pixel 4 north west/left,pixel 4 south east/right,pixel 4 south west/left}
1843 % manque pixel <i> <subanchor>
1844 \draw[red,shift=(s.\anchor)] plot[mark=x,red] coordinates{(0,0)}
1845 node[\placement] {\scriptsize\texttt{(s.\anchor)}};
1846
1847 \end{tikzpicture}
1848 \end{codeexample}
1849
1850 \end{shape}
1851
1852
1853 Remarques :
1854 \begin{itemize}
1855 \item Quand les ancres |east| et |west| ne sont pas définies explicitement, elles sont en fait des alias pour |center|. Cela permet aux clés |right=of...| et assimilées de fonctionner correctement.
1856 \end{itemize}
1857
1858
1859
1860 \subsubsection{Capteur générique}
1861
1862 \begin{stylekey}{/tikz/optics/generic sensor}
1863 Le style |generic sensor| permet de dessiner un capteur. Les options de |generic optics io| sont applicables.
1864
1865 \begin{codeexample}[width=6cm]
1866 \begin{tikzpicture}[use optics,scale=.5]
1867 \node[generic sensor] (S) at (0,0) {};
1868 \end{tikzpicture}
1869 \end{codeexample}
1870 \end{stylekey}
1871
1872 \subsubsection{Lampe générique}
1873
1874 \begin{stylekey}{/tikz/optics/generic lamp}
1875 Le style |generic lamp| permet de dessiner une lampe. Les options de |generic optics io| sont applicables.
1876
1877 \begin{codeexample}[width=6cm]
1878 \begin{tikzpicture}[use optics,scale=.5]
1879 \node[generic lamp] (S) at (0,0) {};
1880 \end{tikzpicture}
1881 \end{codeexample}
1882 \end{stylekey}
1883
1884 \subsubsection{Lampe QI}
1885
1886 \begin{stylekey}{/tikz/optics/halogen lamp}
1887 Le style |halogen lamp| permet de dessiner une lampe de type \enquote{lampe halogène Quartz Iode}. Les options de |generic optics io| sont applicables.
1888
1889 \begin{codeexample}[width=6cm]
1890 \begin{tikzpicture}[use optics,scale=.5]
1891 \node[halogen lamp] (S) at (0,0) {};
1892 \node[halogen lamp] (S) at (5cm,0) {QI};
1893 \end{tikzpicture}
1894 \end{codeexample}
1895 \end{stylekey}
1896
1897 \subsubsection{Lampe spectrale}
1898
1899 \begin{stylekey}{/tikz/optics/spectral lamp}
1900 Le style |spectral lamp| permet de dessiner une lampe de type \enquote{lampe spectrale}. Les options de |generic optics io| sont applicables. Par ailleurs, un style est automatiquement appliqué pour autoriser le texte multiligne.
1901
1902 \begin{codeexample}[width=6cm]
1903 \begin{tikzpicture}[use optics,scale=.5]
1904 \node[spectral lamp] (S) at (0,0) {};
1905 \node[spectral lamp] (S) at (5cm,0) {\ce{Hg} \\ BP};
1906 \end{tikzpicture}
1907 \end{codeexample}
1908 \end{stylekey}
1909
1910 \subsubsection{Laser}
1911
1912 \begin{stylekey}{/tikz/optics/laser}
1913 Le style |laser| permet de dessiner un laser. Les options de |generic optics io| sont applicables.
1914
1915 \begin{codeexample}[width=6cm]
1916 \begin{tikzpicture}[use optics,scale=.5]
1917 \node[laser] (S) at (0,0) {};
1918 \node[laser] (S) at (5cm,0) {\ce{HeNe}};
1919 \end{tikzpicture}
1920 \end{codeexample}
1921 \end{stylekey}
1922
1923 \begin{stylekey}{/tikz/optics/laser'}
1924 Le style |laser'| permet de dessiner un laser sans \enquote{orifice de sortie} (i.e. |io aperture width=0pt|). Les options de |generic optics io| sont applicables.
1925
1926 \begin{codeexample}[width=6cm]
1927 \begin{tikzpicture}[use optics,scale=.5]
1928 \node[laser'] (S) at (0,0) {\ce{Nd}:YAG};
1929 \draw[green] (S.aperture east) -- +(2cm,0);
1930 \end{tikzpicture}
1931 \end{codeexample}
1932 \end{stylekey}
1933
1934 \subsection{Divers}
1935
1936
1937
1938 \subsubsection{Marquer des rayons}
1939
1940 \begin{update}
1941 2014-12-07 : cette partie a été substantiellement modifiée.
1942 \end{update}
1943
1944 \begin{warning}
1945 Cette partie n'est pas encore stable. Les raccourcis |->-|, etc. ne devraient normalement pas changer
1946 \end{warning}
1947
1948 Les flèches pour marquer les rayons sont conçues pour se trouver \emph{vraiment} au milieu du rayon (contrairement à ce qui arrive en utilisant simplement |\arrow{>>}| avec |put arrow|).
1949
1950 \begin{stylekey}{/tikz/optics/->-}
1951 Ce style ajoute une flèche au milieu du chemin.
1952 \begin{codeexample}[width=6cm]
1953 \begin{tikzpicture}[use optics]
1954 \draw[->-] (0,0) -- (1.5cm,1cm);
1955 \end{tikzpicture}
1956 \end{codeexample}
1957 \end{stylekey}
1958
1959 \begin{stylekey}{/tikz/optics/-<-}
1960 Ce style ajoute une flèche au milieu du chemin, dans le sens opposé à |->-|.
1961 \begin{codeexample}[width=6cm]
1962 \begin{tikzpicture}[use optics]
1963 \draw[-<-] (0,0) -- (1.5cm,1cm);
1964 \end{tikzpicture}
1965 \end{codeexample}
1966 \end{stylekey}
1967
1968 \begin{stylekey}{/tikz/optics/->>-}
1969 Ce style ajoute une double flèche au milieu du chemin.
1970 \begin{codeexample}[width=6cm]
1971 \begin{tikzpicture}[use optics]
1972 \draw[->>-] (0,0) -- (1.5cm,1cm);
1973 \end{tikzpicture}
1974 \end{codeexample}
1975 \end{stylekey}
1976
1977 \begin{stylekey}{/tikz/optics/-<<-}
1978 Ce style ajoute une double flèche au milieu du chemin, dans le sens opposé à |-<<-|.
1979 \begin{codeexample}[width=6cm]
1980 \begin{tikzpicture}[use optics]
1981 \draw[-<<-] (0,0) -- (1.5cm,1.1cm);
1982 \end{tikzpicture}
1983 \end{codeexample}
1984 \end{stylekey}
1985
1986 \begin{stylekey}{/tikz/optics/->n-=\{n=\meta{num}, \meta{specs}\}}
1987 Ce style ajoute \meta{num} flèches au milieu du chemin. Les spécifications \meta{specs} sont appliquées aux flèches, suivant la syntaxe de |put arrow|.
1988 \begin{codeexample}[width=6cm]
1989 \begin{tikzpicture}[use optics]
1990 \draw[->n-={n=4}] (0,0) -- (1.5cm,1cm);
1991 \end{tikzpicture}
1992 \end{codeexample}
1993 \end{stylekey}
1994
1995 \begin{stylekey}{/tikz/optics/-<n-={n=\meta{num}, \meta{specs}}}
1996 Ce style ajoute \meta{num} flèches au milieu du chemin, dans le sens opposé à |->n-|.
1997 \begin{codeexample}[width=6cm]
1998 \begin{tikzpicture}[use optics]
1999 \draw[-<n-={n=6}] (0,0) -- (1.5cm,1cm);
2000 \end{tikzpicture}
2001 \end{codeexample}
2002 \end{stylekey}
2003
2004 Des raccourcis allant de |->-| à |->>>>-| (idem pour |-<-|) sont disponibles. Les styles |->-|, |-<-|, etc. utilisent le style |put arrow| avec la flèche |multiple ray arrow|. Ils peuvent donc être configurés en suivant la syntaxe de |put arrow|, par exemple
2005
2006 \begin{codeexample}[width=4cm]
2007 \begin{tikzpicture}[use optics]
2008 \draw[->>-={at=0.25}, ->-={at=0.75}] (0,0) -- (1.5cm,1cm) -- (3cm, 0);
2009 \end{tikzpicture}
2010 \end{codeexample}
2011
2012 Cela marche aussi avec |->n-| et |-<n-|.
2013
2014 \begin{codeexample}[width=4cm]
2015 \begin{tikzpicture}[use optics]
2016 \draw[->n-={n=5, at=0.2, style=red}] (0,0) -- (1.5cm,1cm);
2017 \end{tikzpicture}
2018 \end{codeexample}
2019
2020 \subsubsection{Placer des choses sur les chemins}
2021
2022 \begin{update}
2023 2014-12-07 : cette partie a été substantiellement modifiée.
2024 \end{update}
2025
2026 \begin{warning}
2027 Cette partie n'est pas encore stable. Tout risque de changer à tout moment.
2028 \end{warning}
2029
2030 \begin{key}{/tikz/put arrow}
2031 La clé |put arrow| permet d'ajouter facilement une flèche sur un chemin.
2032
2033 \begin{codeexample}[width=6cm]
2034 \begin{tikzpicture}[use optics]
2035 \draw[put arrow] (0,0) -- (1.5cm,1cm);
2036 \end{tikzpicture}
2037 \end{codeexample}
2038
2039 Par défaut, la flèche est |\arrow{>}| et elle est placée au milieu du chemin.
2040 Pour contrôler ces paramètres, il faut utiliser les sous-clés suivantes :
2041
2042 \begin{key}{/tikz/put arrow/pos=\meta{pos} (initially \pgfkeysvalueof{/tikz/put arrow/pos})}
2043 Positionne la flèche à la position \meta{pos} sur le chemin (par exemple, \meta{pos}|=0.5| place la flèche au milieu du chemin).
2044 \end{key}
2045
2046 \begin{key}{/tikz/put arrow/at}
2047 Alias pour |/tikz/put arrow/pos|.
2048 \end{key}
2049
2050 \begin{key}{/tikz/put arrow/arrow=\meta{arrow specification}}
2051 Utilise la flèche définie par \meta{arrow specification} (par exemple |stealth| ou |latex|).
2052 \end{key}
2053
2054 \begin{key}{/tikz/put arrow/arrow'=\meta{arrow specification}}
2055 Utilise la flèche définie par \meta{arrow specification} (par exemple |stealth| ou |latex|), mais avec une flèche inversée.
2056 \end{key}
2057
2058 \begin{codeexample}[width=6cm]
2059 \begin{tikzpicture}[use optics]
2060 \draw[put arrow={arrow'=stealth}] (0,0) -- (1cm,1cm);
2061 \draw[put arrow={at=0.2}] (2cm,0) -- (3cm,1cm);
2062 \end{tikzpicture}
2063 \end{codeexample}
2064
2065 \begin{key}{/tikz/put arrow/style=\meta{style}}
2066 Le |\meta{style}| est passé à |\arrow[|\meta{style}|]| pour dessiner les flèches.
2067 \end{key}
2068
2069 \begin{codeexample}[width=5cm]
2070 \begin{tikzpicture}[use optics]
2071 \draw[red,put arrow={arrow=latex}]
2072 (0,0) -- (1cm,1cm);
2073 \draw[red,put arrow={arrow=latex,style={blue}}]
2074 (1cm,0) -- (2cm,1cm);
2075 \end{tikzpicture}
2076 \end{codeexample}
2077
2078 \begin{stylekey}{/tikz/put arrow/every arrow}
2079 Il s'agit d'un style passé à toutes les flèches dessinées par |put arrow| (dans la portée du style). Il faut utiliser |every arrow/.style={|\meta{style}|}| (ou |append style|, etc.).
2080 \end{stylekey}
2081
2082 \begin{codeexample}[width=3cm]
2083 \begin{tikzpicture}[use optics]
2084 \draw[red,put arrow={arrow=latex}]
2085 (0,0) -- (1cm,1cm);
2086 \draw[red, put arrow/every arrow/.style={blue},
2087 put arrow={at=0.2}, put arrow={at=0.5}, put arrow={at=0.8}]
2088 (1cm,0) -- (2cm,1cm);
2089 \draw[red, >=latex, put arrow/every arrow/.style={blue},
2090 put arrow={at=0.2}, put arrow={at=0.5}, put arrow={at=0.8}]
2091 (2cm,0) -- (3cm,1cm);
2092 \end{tikzpicture}
2093 \end{codeexample}
2094
2095
2096
2097 Les différentes flèches utilisables sont détaillées dans le manuel de pgf/tikz.
2098
2099 Pour un contrôle plus fin, il faut utiliser la bibliothèque tikz |markings|.
2100
2101 Par ailleurs, pour flécher des rayons lumineux, des styles spécifiques |->-|, |-<-|, |->>-| et |-<<-| ont été définis.
2102
2103 \end{key}
2104
2105 \subsubsection{Placer des coordonnées sur les chemins}
2106
2107 \begin{key}{/tikz/put coordinate=\meta{coordinate} at \meta{position}}
2108
2109 Le style |put coordinate| crée une coordonnée nommée \meta{coordinate}
2110 à l'abscisse curviligne \meta{position} sur le chemin auquel est appliqué le style.
2111
2112 \begin{codeexample}[width=6cm]
2113 \begin{tikzpicture}[use optics]
2114 \draw[put coordinate=P at 0.3,put coordinate=Q at 0.7] (0,0)
2115 to[bend left] (2cm,0);
2116 \draw[red] (P) -- (1cm,-1cm);
2117 \draw[blue] (Q) -- (1cm,-1cm);
2118 \end{tikzpicture}
2119 \end{codeexample}
2120
2121 \end{key}
2122
2123 \subsubsection{Indiquer des dimensions sur les schémas}
2124
2125 \begin{warning}
2126 Cette partie est expérimentale et sujette à beaucoup de changements brusques sans préavis.
2127 \end{warning}
2128
2129 Commençons par un exemple.
2130
2131 \begin{codeexample}[width=6cm]
2132 \begin{tikzpicture}
2133 \draw[fill=yellow!30]
2134 (-1cm,0) coordinate (A) -- (1cm,0) coordinate (B)
2135 -- (1cm,1.5cm) coordinate (B') -- (0.25cm,2.5cm) coordinate (b)
2136 -- (-0.25cm,2.5cm) coordinate (a) -- (-1cm,1.5cm) coordinate (A')
2137 -- cycle;
2138
2139 \draw (A) to[dim arrow'={label'=$D$}] (B);
2140 \draw (A) to[dim arrow={label=$H$}] (A');
2141 \draw (a) to[short dim arrow={label=$d$,label near middle}] (b);
2142 \draw (B') to[dim arrow'={label'=$h$}] (b -| B');
2143 \end{tikzpicture}
2144 \end{codeexample}
2145
2146
2147
2148 \begin{stylekey}{/tikz/dim arrow=\meta{sous-clés}}
2149 Le style |dim arrow| permet d'indiquer des dimensions sur les schémas. Il s'applique à un |to path|. Par exemple,
2150
2151 \begin{codeexample}[width=4cm]
2152 \begin{tikzpicture}[use optics]
2153 \node[circle,fill=red,inner sep=2pt] (a) at (0,0) {};
2154 \node[circle,fill=red,inner sep=2pt] (b) at (2cm,0) {};
2155 \draw (a.center) to[dim arrow={label=$\ell$}] (b.center);
2156 \end{tikzpicture}
2157 \end{codeexample}
2158
2159 La flèche de dimension est décalée par rapport aux positions de départ et d'arrivée de manière à ne pas se superposer
2160 à l'objet dont on veut marquer la dimension.
2161
2162 Plusieurs sous-clés permettent de spécifier des options en écriant |dim arrow={|\meta{sous-clés}|}|.
2163
2164 \begin{key}{/tikz/dim arrow/label=\meta{text}}
2165 La clé |label| permet de spécifier le \meta{texte} à afficher sur la flèche, qui est positionné à gauche de la flèche par rapport au sens du chemin (via |/tikz/auto=left|).
2166 \end{key}
2167
2168 \begin{key}{/tikz/dim arrow/label'=\meta{text}}
2169 La clé |label'| a le même rôle que |label|, mais le \meta{texte} est affiché à droite dans le sens du chemin.
2170 \end{key}
2171
2172
2173 \begin{codeexample}[]
2174 \begin{tikzpicture}
2175 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=1cm] (R) at (0,0) {};
2176
2177 \draw (R.north east) to[dim arrow'={label'=$\ell'$}] (R.south east);
2178 \draw (R.north east) to[dim arrow'={label=$\ell$}] (R.south east);
2179 \end{tikzpicture}
2180 \end{codeexample}
2181
2182 \begin{key}{/tikz/dim arrow/label text=\meta{text}}
2183 La clé |label text| permet de spécifier le \meta{texte} à afficher sur la flèche sans modifier son positionnement.
2184 \end{key}
2185
2186 \begin{stylekey}{/tikz/dim arrow/label style}
2187 La clé |label style| permet de spécifier le style avec lequel le label doit être dessiné.
2188 À moins de le faire exprès, il n'est pas conseillé de remplacer ce style (qui est utilisé pour placer le label), mais plutôt d'y ajouter des spécifications grace à |/.append style|.
2189
2190 \begin{codeexample}[]
2191 \begin{tikzpicture}
2192 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=1cm] (R) at (0,0) {};
2193
2194 \draw (R.north east)
2195 to[dim arrow={label=$L$, label style/.append style=red}] (R.south east);
2196 \draw (R.north west)
2197 to[dim arrow'={label'=$L$}, red] (R.south west);
2198 \end{tikzpicture}
2199 \end{codeexample}
2200 \end{stylekey}
2201
2202 \begin{key}{/tikz/dim arrow/raise=\meta{length} (initially \pgfkeysvalueof{/tikz/dim arrow/raise})}
2203 La clé |raise| permet de spécifier la distance \meta{length} à laquelle doit être dessinée la flèche de dimension par rapport au chemin initial.
2204 \begin{codeexample}[]
2205 \begin{tikzpicture}
2206 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=1cm] (R) at (0,0) {};
2207
2208 \draw (R.north east)
2209 to[dim arrow={label=$\ell$, raise=0.5cm}, black] (R.south east);
2210 \draw (R.north east)
2211 to[dim arrow={label=$\ell$, raise=1cm}, red] (R.south east);
2212 \end{tikzpicture}
2213 \end{codeexample}
2214 \end{key}
2215
2216 \begin{stylekey}{/tikz/dim arrow/no raise}
2217 Équivalent à |raise=0|. (Est-ce bien utile ?)
2218 \end{stylekey}
2219 \end{stylekey}
2220
2221 \begin{stylekey}{/tikz/dim arrow'=\meta{sous-clés}}
2222 Le style |dim arrow'| a le même rôle que |dim arrow|, mais la valeur initiale de |/tikz/dim arrow/raise| est de |-|\texttt{\pgfkeysvalueof{/tikz/dim arrow/raise}} au lieu de \texttt{\pgfkeysvalueof{/tikz/dim arrow/raise}}.
2223
2224 \begin{codeexample}[]
2225 \begin{tikzpicture}
2226 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=1cm] (R) at (0,0) {};
2227
2228 \draw (R.north east) to[dim arrow'={label=$\ell$}, black] (R.south east);
2229 \draw (R.north east) to[dim arrow={label=$\ell$}, red] (R.south east);
2230 \end{tikzpicture}
2231 \end{codeexample}
2232 \end{stylekey}
2233
2234
2235 \begin{stylekey}{/tikz/short dim arrow=\meta{sous-clés}}
2236 Le style |short dim arrow| a le même but que |dim arrow|, mais dans le cas où la dimension à marquer est petite, et où il faut que les flèches soient à l'extérieur.
2237
2238 \begin{codeexample}[width=4cm]
2239 \begin{tikzpicture}[use optics]
2240 \node[circle,fill=red,inner sep=2pt] (a) at (0,0) {};
2241 \node[circle,fill=red,inner sep=2pt] (b) at (1cm,0) {};
2242 \draw (a.center)
2243 to[short dim arrow={label=$\ell$}]
2244 (b.center);
2245 \end{tikzpicture}
2246 \end{codeexample}
2247
2248 Les options de |/tikz/dim arrow| s'appliquent, ainsi que quelques options supplémentaires.
2249
2250 \begin{key}{/tikz/dim arrow/label near start}
2251 La clé |label near start| permet de placer l'étiquette donnant la dimension vers le début du chemin.
2252 C'est le comportement par défaut.
2253
2254 \begin{codeexample}[]
2255 \begin{tikzpicture}
2256 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=0.5cm] (R) at (0,0) {};
2257
2258 \draw (R.north east) to[short dim arrow={label=$\ell$}] (R.south east);
2259 \end{tikzpicture}
2260 \end{codeexample}
2261 \end{key}
2262
2263 \begin{key}{/tikz/dim arrow/label near end}
2264 La clé |label near end| permet de placer l'étiquette donnant la dimension vers la fin du chemin.
2265
2266 \begin{codeexample}[]
2267 \begin{tikzpicture}
2268 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=0.5cm] (R) at (0,0) {};
2269
2270 \draw (R.north east)
2271 to[short dim arrow={label=$\ell$, label near end}] (R.south east);
2272 \end{tikzpicture}
2273 \end{codeexample}
2274 \end{key}
2275
2276 \begin{key}{/tikz/dim arrow/label near middle}
2277 La clé |label near middle| permet de placer l'étiquette donnant la dimension vers le milieu du chemin.
2278 Dans ce cas, l'étiquette n'est pas décalée par rapport à la flèche (parce qu'il n'y a pas de superposition) ; cela peut être rétabli en spécifiant |/tikz/dim arrow/label style| explicitement.
2279
2280 \begin{codeexample}[]
2281 \begin{tikzpicture}
2282 \node[rectangle, draw=black, fill=yellow!30, minimum width=1cm, minimum height=0.5cm] (R) at (0,0) {};
2283
2284 \draw (R.north east)
2285 to[short dim arrow={label=$\ell$, label near middle}] (R.south east);
2286 \end{tikzpicture}
2287 \end{codeexample}
2288 \end{key}
2289
2290
2291
2292 \begin{key}{/tikz/dim arrow/arrow length=\meta{length} (initially \pgfkeysvalueof{/tikz/dim arrow/arrow length})}
2293 La clé |arrow length| permet spécifier la taille \meta{length} des flèches extérieures.
2294 \end{key}
2295 \end{stylekey}
2296
2297 \begin{stylekey}{/tikz/short dim arrow'=\meta{sous-clés}}
2298 Le style |short dim arrow'| a le même rôle que |short dim arrow|, mais la valeur initiale de |/tikz/dim arrow/raise| est de |-0.5cm| au lieu de |0.5cm|.
2299
2300 \begin{codeexample}[width=4cm]
2301 \begin{tikzpicture}[use optics]
2302 \coordinate (a) at (0,0);
2303 \coordinate (b) at (1cm,0);
2304 \draw[red,mark=x, draw=none] plot coordinates {(a) (b)};
2305 \draw (a.center) to[short dim arrow, blue] (b.center);
2306 \draw (a.center) to[short dim arrow', red] (b.center);
2307 \end{tikzpicture}
2308 \end{codeexample}
2309 \end{stylekey}
2310
2311 \section{Remerciements}
2312
2313 Je remercie les collègues et amis qui ont essuyé les plâtres en utilisant les premières versions de cette bibliothèque, et en particulier les auteurs du livre \emph{Physique expérimentale}\footnote{\url{http://www.physique-experimentale.com/}} pour lequel la bibliothèque a été développée.
2314
2315
2316 \end{document}