Initialisation du projet pst-solides3d.git (SVN revision 142)
[pst-solides3d.git] / doc / par-couleurs.tex
1 \section {Les couleurs et les dégradés de couleur}
2
3 L'argument \Cadre{[fillcolor=$name$]} permet de spécifier la couleur
4 souhaitée pour les faces externes d'un solide. L'argument
5 \Cadre{[incolor=$name$]} permet de spécifier la couleur souhaitée
6 pour les faces internes d'un solide.
7
8 Les valeurs possibles pour \textsl{name\/} sont toutes celles reconnues
9 par PSTricks (et en particulier son package \texttt{xcolor}).
10
11 \subsection {Couleurs pr\'{e}d\'{e}finies par l'option [\texttt{dvipsnames}]}
12
13 Il y a $68$~couleurs prédéfinies, qui sont identifiées dans le fichier
14 \textsl {solides.pro}~: \textsl {Black}, \textsl {White}, et les
15 $66$~couleurs ci-dessous.
16
17 \bgroup\centering
18 \newcommand{\colorcube}[1]{%
19 \begin{pspicture}(-1.2,-1)(1.2,1)
20 \psframe(-1.2,-1)(1.2,1)
21 \psSolid[object=datfile,
22 file=cubecolor,
23 linewidth=0.07\pslinewidth,
24 linecolor=#1!50,
25 fillcolor=#1,
26 action=draw**]
27 \rput(0,-0.75){\footnotesize \texttt{#1}}
28 \end{pspicture}
29 }
30
31 \parindent0pt
32 %\parskip-8pt
33 \colorcube{GreenYellow}
34 \colorcube{Yellow}
35 \colorcube{Goldenrod}
36 \colorcube{Dandelion}
37 \colorcube{Apricot}
38 \colorcube{Peach}
39
40 \colorcube{Melon}
41 \colorcube{YellowOrange}
42 \colorcube{Orange}
43 \colorcube{BurntOrange}
44 \colorcube{Bittersweet}
45 \colorcube{RedOrange}
46
47 \colorcube{Mahogany}
48 \colorcube{Maroon}
49 \colorcube{BrickRed}
50 \colorcube{Red}
51 \colorcube{OrangeRed}
52 \colorcube{RubineRed}
53
54 \colorcube{WildStrawberry}
55 \colorcube{Salmon}
56 \colorcube{CarnationPink}
57 \colorcube{Magenta}
58 \colorcube{VioletRed}
59 \colorcube{Rhodamine}
60
61 \colorcube{Mulberry}
62 \colorcube{RedViolet}
63 \colorcube{Fuchsia}
64 \colorcube{Lavender}
65 \colorcube{Thistle}
66 \colorcube{Orchid}
67
68 \colorcube{DarkOrchid}
69 \colorcube{Purple}
70 \colorcube{Plum}
71 \colorcube{Violet}
72 \colorcube{RoyalPurple}
73 \colorcube{BlueViolet}
74
75 \colorcube{Periwinkle}
76 \colorcube{CadetBlue}
77 \colorcube{CornflowerBlue}
78 \colorcube{MidnightBlue}
79 \colorcube{NavyBlue}
80 \colorcube{RoyalBlue}
81
82 \colorcube{Blue}
83 \colorcube{Cerulean}
84 \colorcube{Cyan}
85 \colorcube{ProcessBlue}
86 \colorcube{SkyBlue}
87 \colorcube{Turquoise}
88
89 \colorcube{TealBlue}
90 \colorcube{Aquamarine}
91 \colorcube{BlueGreen}
92 \colorcube{Emerald}
93 \colorcube{JungleGreen}
94 \colorcube{SeaGreen}
95
96 \colorcube{Green}
97 \colorcube{ForestGreen}
98 \colorcube{PineGreen}
99 \colorcube{LimeGreen}
100 \colorcube{YellowGreen}
101 \colorcube{SpringGreen}
102
103 \colorcube{OliveGreen}
104 \colorcube{RawSienna}
105 \colorcube{Sepia}
106 \colorcube{Brown}
107 \colorcube{Tan}
108 \colorcube{Gray}
109
110 \egroup
111
112 \subsection {Couleurs pr\'{e}d\'{e}finies par l'option [\texttt{svgnames}]}
113
114 Les couleurs suivantes sont reconnues par pstricks si l'on utilise
115 l'option [\texttt{svgnames}].
116 Par contre, elles ne sont pas identifiées dans le fichier
117 \textsl {solides.pro}~: on ne peut les utiliser directement dans
118 l'option [\texttt{fcol}].
119
120 \bgroup
121 \newcommand{\colorcone}[1]{%
122 \begin{pspicture}(-1.2,-1)(1.2,1)
123 \psframe(-1.2,-1)(1.2,1)
124 \psSolid[object=cone,
125 linewidth=0.07\pslinewidth,
126 % linecolor=#1!50,
127 fillcolor=#1,
128 ngrid=4 12,
129 r=0.2,h=0.37,
130 action=draw**](0,0,-0.05)
131 \rput(0,-0.75){\footnotesize \texttt{#1}}
132 \end{pspicture}
133 }
134
135
136 \parindent0pt
137 %\parskip-8pt
138
139 Ces couleurs sont propos\'{e}es par le package \texttt{xcolor}.
140 \bigskip
141
142 {\centering
143 \colorcone{AliceBlue}
144 \colorcone{AntiqueWhite}
145 \colorcone{Aqua}
146 \colorcone{Aquamarine}
147 \colorcone{Azure}
148 \colorcone{Beige}
149
150 \colorcone{Bisque}
151 \colorcone{Black}
152 \colorcone{BlanchedAlmond}
153 \colorcone{Blue}
154 \colorcone{BlueViolet}
155 \colorcone{Brown}
156
157 \colorcone{BurlyWood}
158 \colorcone{CadetBlue}
159 \colorcone{Chartreuse}
160 \colorcone{Chocolate}
161 \colorcone{Coral}
162 \colorcone{CornflowerBlue}
163
164 \colorcone{Cornsilk}
165 \colorcone{Crimson}
166 \colorcone{Cyan}
167 \colorcone{DarkBlue}
168 \colorcone{DarkCyan}
169 \colorcone{DarkGoldenrod}
170
171 \colorcone{DarkGray}
172 \colorcone{DarkGreen}
173 \colorcone{DarkGrey}
174 \colorcone{DarkKhaki}
175 \colorcone{DarkMagenta}
176 \colorcone{DarkOliveGreen}
177
178 \colorcone{DarkOrange}
179 \colorcone{DarkOrchid}
180 \colorcone{DarkRed}
181 \colorcone{DarkSalmon}
182 \colorcone{DarkSeaGreen}
183 \colorcone{DarkSlateBlue}
184
185 \colorcone{DarkSlateGray}
186 \colorcone{DarkSlateGrey}
187 \colorcone{DarkTurquoise}
188 \colorcone{DarkViolet}
189 \colorcone{DeepPink}
190 \colorcone{DeepSkyBlue}
191
192 \colorcone{DimGray}
193 \colorcone{DimGrey}
194 \colorcone{DodgerBlue}
195 \colorcone{FireBrick}
196 \colorcone{FloralWhite}
197 \colorcone{ForestGreen}
198
199 \colorcone{Fuchsia}
200 \colorcone{Gainsboro}
201 \colorcone{GhostWhite}
202 \colorcone{Gold}
203 \colorcone{Goldenrod}
204 \colorcone{Gray}
205
206 \colorcone{Grey}
207 \colorcone{Green}
208 \colorcone{GreenYellow}
209 \colorcone{Honeydew}
210 \colorcone{HotPink}
211 \colorcone{IndianRed}
212
213 \colorcone{Indigo}
214 \colorcone{Ivory}
215 \colorcone{Khaki}
216 \colorcone{Lavender}
217 \colorcone{LavenderBlush}
218 \colorcone{LawnGreen}
219
220 \colorcone{LemonChiffon}
221 \colorcone{LightBlue}
222 \colorcone{LightCoral}
223 \colorcone{LightCyan}
224 \colorcone{LightGoldenrodYellow}
225 \colorcone{LightGray}
226
227 \colorcone{LightGreen}
228 \colorcone{LightGrey}
229 \colorcone{LightPink}
230 \colorcone{LightSalmon}
231 \colorcone{LightSeaGreen}
232 \colorcone{LightSkyBlue}
233
234 \colorcone{LightSlateGray}
235 \colorcone{LightSlateGrey}
236 \colorcone{LightSteelBlue}
237 \colorcone{LightYellow}
238 \colorcone{Lime}
239 \colorcone{LimeGreen}
240
241 \colorcone{Linen}
242 \colorcone{Magenta}
243 \colorcone{Maroon}
244 \colorcone{MediumAquamarine}
245 \colorcone{MediumBlue}
246 \colorcone{MediumOrchid}
247
248 \colorcone{MediumPurple}
249 \colorcone{MediumSeaGreen}
250 \colorcone{MediumSlateBlue}
251 \colorcone{MediumSpringGreen}
252 \colorcone{MediumTurquoise}
253 \colorcone{MediumVioletRed}
254
255 \colorcone{MidnightBlue}
256 \colorcone{MintCream}
257 \colorcone{MistyRose}
258 \colorcone{Moccasin}
259 \colorcone{NavajoWhite}
260 \colorcone{Navy}
261
262 \colorcone{OldLace}
263 \colorcone{Olive}
264 \colorcone{OliveDrab}
265 \colorcone{Orange}
266 \colorcone{OrangeRed}
267 \colorcone{Orchid}
268
269 \colorcone{PaleGoldenrod}
270 \colorcone{PaleGreen}
271 \colorcone{PaleTurquoise}
272 \colorcone{PaleVioletRed}
273 \colorcone{PapayaWhip}
274 \colorcone{PeachPuff}
275
276 \colorcone{Peru}
277 \colorcone{Pink}
278 \colorcone{Plum}
279 \colorcone{PowderBlue}
280 \colorcone{Purple}
281 \colorcone{Red}
282
283 \colorcone{RosyBrown}
284 \colorcone{RoyalBlue}
285 \colorcone{SaddleBrown}
286 \colorcone{Salmon}
287 \colorcone{SandyBrown}
288 \colorcone{SeaGreen}
289
290 \colorcone{Seashell}
291 \colorcone{Sienna}
292 \colorcone{Silver}
293 \colorcone{SkyBlue}
294 \colorcone{SlateBlue}
295 \colorcone{SlateGray}
296
297 \colorcone{SlateGrey}
298 \colorcone{Snow}
299 \colorcone{SpringGreen}
300 \colorcone{SteelBlue}
301 \colorcone{Tan}
302 \colorcone{Teal}
303
304 \colorcone{Thistle}
305 \colorcone{Tomato}
306 \colorcone{Turquoise}
307 \colorcone{Violet}
308 \colorcone{Wheat}
309 \colorcone{White}
310
311 \colorcone{WhiteSmoke}
312 \colorcone{Yellow}
313 \colorcone{YellowGreen}
314
315 }
316 \egroup
317
318 \section {Les dégradés de couleur}
319
320 Pour les dégradés de couleurs, on dispose des options
321 \Cadre{[hue]}, \Cadre{[inhue]} et \Cadre{[inouthue]} qui permettent
322 respectivement de spécifier si le dégradé doit avoir lieu sur les
323 faces externes, internes, ou toutes.
324
325 Ces dégradés peuvent être dans les espaces HSB, RGB ou CMYK.
326 C'est le nombre d'arguments de \verb+hue+ (resp. \verb+inhue+,
327 \verb+inouthue+) qui détermine le cas de figure
328
329 \subsection {Dégradé dans l'espace HSB, saturation et brillance maximales}
330
331 Il y a 2 arguments~: \Cadre{[hue=$h_0$ $h_1$]}
332 les nombres $h_0$ et $h_1$ vérifiant $0\leq h_0 < h_1 \leq 1$
333 indiquent les bornes du premier paramètre dans l'espace HSB.
334
335 \begin{multicols}{2}
336 \psset{unit=1}
337 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
338 \begin{pspicture}(-4,-1.5)(3,1)
339 \psframe(-4,-1.5)(3,1)
340 \psSolid[object=grille,
341 base=-3 5 -3 3,
342 linecolor=gray,
343 hue=0 1]
344 \end{pspicture}
345
346 \columnbreak
347
348 \begin{verbatim}
349 \psSolid[object=grille,
350 base=-3 5 -3 3,
351 linecolor=gray,
352 hue=0 1]
353 \end{verbatim}
354 \end{multicols}
355
356 \begin{multicols}{2}
357 \psset{unit=1}
358 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
359 \begin{pspicture}(-4,-1.5)(3,1)
360 \psframe(-4,-1.5)(3,1)
361 \psSolid[object=grille,
362 base=-3 5 -3 3,
363 linecolor=gray,
364 hue=0 .3]
365 \end{pspicture}
366
367 \columnbreak
368
369 \begin{verbatim}
370 \psSolid[object=grille,
371 base=-3 5 -3 3,
372 linecolor=gray,
373 hue=0 .3]
374 \end{verbatim}
375 \end{multicols}
376
377 \begin{multicols}{2}
378 \psset{unit=1}
379 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
380 \begin{pspicture}(-4,-1.5)(3,1)
381 \psframe(-4,-1.5)(3,1)
382 \psSolid[object=grille,
383 base=-3 5 -3 3,
384 linecolor=gray,
385 hue=.5 .6]
386 \end{pspicture}
387
388 \columnbreak
389
390 \begin{verbatim}
391 \psSolid[object=grille,
392 base=-3 5 -3 3,
393 linecolor=gray,
394 hue=.5 .6]
395 \end{verbatim}
396 \end{multicols}
397
398 \subsection {Dégradé dans l'espace HSB, saturation et brillance fixes}
399
400 Il y a 4 arguments~: \Cadre{[hue=$h_0$ $h_1$ $s$ $b$]}
401 les nombres $h_0$ et $h_1$ vérifiant $0\leq h_0 < h_1 \leq 1$
402 indiquent les bornes du premier paramètre dans l'espace HSB et où $s$
403 et $b$ sont les paramètres respectifs \textsl {saturastion} et \textsl
404 {brillance}.
405
406 \begin{multicols}{2}
407 \psset{unit=1}
408 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
409 \begin{pspicture}(-4,-1.5)(3,1)
410 \psframe(-4,-1.5)(3,1)
411 \psSolid[object=grille,
412 base=-3 5 -3 3,
413 linecolor=gray,
414 hue=0 1 .8 .7]
415 \end{pspicture}
416
417 \columnbreak
418
419 \begin{verbatim}
420 \psSolid[object=grille,
421 base=-3 5 -3 3,
422 linecolor=gray,
423 hue=0 1 .8 .7]
424 \end{verbatim}
425 \end{multicols}
426
427
428 \begin{multicols}{2}
429 \psset{unit=1}
430 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
431 \begin{pspicture}(-4,-1.5)(3,1)
432 \psframe(-4,-1.5)(3,1)
433 \psSolid[object=grille,
434 base=-3 5 -3 3,
435 linecolor=gray,
436 hue=0 1 .5 1]
437 \end{pspicture}
438
439 \columnbreak
440
441 \begin{verbatim}
442 \psSolid[object=grille,
443 base=-3 5 -3 3,
444 linecolor=gray,
445 hue=0 1 .5 1]
446 \end{verbatim}
447 \end{multicols}
448
449 \subsection {Dégradé dans l'espace HSB, cas général}
450
451 Il y a 7 arguments~: \Cadre{[hue=$h_0$ $s_0$ $b_0$ $h_1$ $s_1$
452 $b_1$ (hsb)]} où les nombres $h_i$, $s_i$ et $b_i$ indiquent les
453 bornes des paramètre HSB.
454
455 \begin{multicols}{2}
456 \psset{unit=1}
457 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
458 \begin{pspicture}(-4,-1.5)(3,1)
459 \psframe(-4,-1.5)(3,1)
460 \psSolid[object=grille,
461 base=-3 5 -3 3,
462 linecolor=gray,
463 hue=0 .8 1 1 1 .7 (hsb)]
464 \end{pspicture}
465
466 \columnbreak
467
468 \begin{verbatim}
469 \psSolid[object=grille,
470 base=-3 5 -3 3,
471 linecolor=gray,
472 hue=0 .8 1 1 1 .7 (hsb)]
473 \end{verbatim}
474 \end{multicols}
475
476 \subsection {Dégradé dans l'espace RGB}
477
478 Il y a 6 arguments~: \Cadre{[hue=$r_0$ $g_0$ $b_0$ $r_1$ $g_1$
479 $b_1$]} où les nombres $r_i$, $g_i$ et $b_i$ indiquent les
480 bornes respectives des $3$ paramètres RGB.
481
482 \begin{multicols}{2}
483 \psset{unit=1}
484 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
485 \begin{pspicture}(-4,-1.5)(3,1)
486 \psframe(-4,-1.5)(3,1)
487 \psSolid[object=grille,
488 base=-3 5 -3 3,
489 linecolor=gray,
490 hue=1 0 0 0 0 1]
491 \end{pspicture}
492
493 \columnbreak
494
495 \begin{verbatim}
496 \psSolid[object=grille,
497 base=-3 5 -3 3,
498 linecolor=gray,
499 hue=1 0 0 0 0 1]
500 \end{verbatim}
501 \end{multicols}
502
503
504 \subsection {Dégradé dans l'espace CMYK}
505
506 Il y a 8 arguments~: \Cadre{[hue=$c_0$ $m_0$ $y_0$ $k_0$ $c_1$ $m_1$
507 $y_1$ $k_1$]} où les nombres $c_i$, $m_i$, $y_i$ et $k_i$ indiquent les
508 bornes respectives des $4$ paramètres CMYK.
509
510 \begin{multicols}{2}
511 \psset{unit=1}
512 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
513 \begin{pspicture}(-4,-1.5)(3,1)
514 \psframe(-4,-1.5)(3,1)
515 \psSolid[object=grille,
516 base=-3 5 -3 3,
517 linecolor=gray,
518 hue=1 0 0 0 0 0 1 0]
519 \end{pspicture}
520
521 \columnbreak
522
523 \begin{verbatim}
524 \psSolid[object=grille,
525 base=-3 5 -3 3,
526 linecolor=gray,
527 hue=1 0 0 0 0 0 1 0]
528 \end{verbatim}
529 \end{multicols}
530
531 \subsection {Dégradé entre 2 couleurs nommées}
532
533 Il y a deux paramètres
534 \Cadre{[hue=$str1$ $str2$]}
535 $str1$ et $str2$ sont des chaînes de caractères désignant des noms de
536 couleurs connues dans \verb+solides.pro+.
537
538 \begin{multicols}{2}
539 \psset{unit=1}
540 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
541 \begin{pspicture}(-4,-1.5)(3,1)
542 \psframe(-4,-1.5)(3,1)
543 \psSolid[object=grille,
544 base=-3 5 -3 3,
545 linecolor=gray,
546 hue=(jaune) (CadetBlue)]
547 \end{pspicture}
548
549 \columnbreak
550
551 \begin{verbatim}
552 \psSolid[object=grille,
553 base=-3 5 -3 3,
554 linecolor=gray,
555 hue=(jaune) (CadetBlue)]
556 \end{verbatim}
557 \end{multicols}
558
559 Si on veut utiliser des couleurs définies par \texttt{xcolor}, on
560 utilise les paramètres \texttt{color1}, \texttt{color2}, etc... de
561 \verb+\psSolid+.
562
563 \begin{multicols}{2}
564 \psset{unit=1}
565 \psset{viewpoint=50 50 20 rtp2xyz,Decran=30}
566 \begin{pspicture}(-4,-1.5)(3,1)
567 \psframe(-4,-1.5)(3,1)
568 \psSolid[object=grille,
569 base=-3 5 -3 3,
570 linecolor=gray,
571 color1=red!50,
572 color2=green!20,
573 hue=(color1) (color2)]
574 \end{pspicture}
575
576 \columnbreak
577
578 \begin{verbatim}
579 \psSolid[object=grille,
580 base=-3 5 -3 3,
581 linecolor=gray,
582 color1=red!50,
583 color2=green!20,
584 hue=(color1) (color2)]
585 \end{verbatim}
586 \end{multicols}
587
588 \subsection{Désactiver la gestion des couleurs}
589
590 Pour certaines utilisations spécifiques, on peut avoir besoin de
591 désactiver la gestion des couleurs. C'est en particulier le cas
592 lorsque l'on utilise un objet déjà présent en mémoire ou défini dans
593 des fichiers externes, Dans ces configurations, si on ne désactive pas
594 la gestion des couleurs et si on n'en définit pas de nouvelles, ce
595 sont les couleurs par défaut qui vont surcharger celles qui étaient
596 sauvegardées.
597
598 Pour désactiver cette gestion, on utilise l'option
599 \Cadre{[deactivatecolor]}.
600
601 \subsection{Exemples d'utilisation des options \texttt{[inhue]} et \texttt{[inouthue]}}
602
603 On rappelle que l'option \texttt{[inhue]} permet de colorier les faces
604 intérieures, \texttt{[hue]} permet de colorier les faces extérieures
605 et \texttt{[inouthue]} peindra dans la continuité faces intérieurs et
606 intérieures.
607
608 On rappelle que pour voir les faces intérieures il faut activer
609 l'option \texttt{hollow}, comme dans les deux exemples suivants.
610
611 \begin{LTXexample}[width=6cm]
612 \psset{lightsrc=45 15 20,
613 viewpoint=50 20 20 rtp2xyz,Decran=50}
614 \begin{pspicture}(-3,-3)(3,3)
615 \psframe(-3,-3)(3,3)
616 \psSolid[object=cube,
617 a=3,ngrid=3,
618 hollow,
619 inouthue=0 1 0.5 1,
620 rm=36 1 44 {} for]%
621 \end{pspicture}
622 \end{LTXexample}
623
624 \begin{LTXexample}[width=6.5cm]
625 \psset{unit=0.5}
626 \psset{lightsrc=30 30 25}
627 \psset{viewpoint=50 40 30 rtp2xyz,Decran=50}
628 \begin{pspicture}(-6,-8)(7,8)
629 \psSurface[ngrid=.25 .25,inouthue=1 0 0.5 1,
630 linewidth=0.5\pslinewidth,axesboxed,
631 algebraic](-4,-4)(4,4){%
632 ((y^2)-(x^2))/4 }
633 \end{pspicture}
634 \end{LTXexample}
635
636 Pour colorier avec les paramètres de \texttt{[hue]} les faces
637 intérieures et extérieures on utilisera l'option \texttt{[hue]} pour
638 l'extérieur et l'option \texttt{[inhue]} pour l'intérieur, comme dans
639 l'exemple suivant :
640
641 \begin{LTXexample}[width=8.5cm]
642 \psset{unit=0.5}
643 \begin{pspicture}(-7,-7)(10,12)
644 \psframe(-7,-7)(10,12)
645 \psset[pst-solides3d]{viewpoint=20 5 10,
646 Decran=50,lightsrc=20 10 5}
647 \psSolid[object=grille,base=-2 2 -2 2,
648 linecolor=white](0,0,-2)
649 % Parametric Surfaces
650 \defFunction{cone}(u,v)
651 {u v Cos mul}{u v Sin mul}{u}
652 \psSolid[object=surfaceparametree,
653 base=-2 2 0 2 pi mul,
654 inhue=0.8 0.2,hue=0.8 0.2,
655 function=cone,linewidth=0.5\pslinewidth,
656 ngrid=25 40]%
657 \gridIIID[Zmin=-2,Zmax=2](-2,2)(-2,2)
658 \end{pspicture}
659 \end{LTXexample}
660

Licence Creative Commons Les fichiers de Syracuse sont mis à disposition (sauf mention contraire) selon les termes de la
Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International.