Initialisation du projet pst-solides3d.git (SVN revision 142)
[pst-solides3d.git] / doc / .svn / text-base / par-couleurs.tex.svn-base
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$]} où
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$]} où
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$]} où
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.