1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
|
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&kpovmodeler;">
<!ENTITY package "tdegraphics">
<!ENTITY Povray "<application>POV-Ray</application>">
<!ENTITY % addindex "IGNORE">
<!ENTITY % French "INCLUDE">
]>
<book lang="&language;">
<bookinfo>
<title>Manuel de &kpovmodeler;</title>
<authorgroup>
<author><firstname>Lauri</firstname> <surname>Watts</surname> <affiliation> <address><email>lauri@kde.org</email></address>
</affiliation>
</author>
<author><firstname>Andreas</firstname> <surname>Zehender</surname> <affiliation> <address><email>zehender@kde.org</email></address>
</affiliation>
</author>
<author><firstname>Olivier</firstname> <surname>Saraja</surname> <affiliation> <address><email>olivier@linuxgraphic.org</email></address>
</affiliation>
</author>
&traducteurGuillaumeDuweltzRebert;
</authorgroup>
<legalnotice>&FDLNotice;</legalnotice>
<date>2002-09-07</date>
<releaseinfo>1.00.00</releaseinfo>
<abstract>
<para>&kpovmodeler; est un modeleur graphique 3D, qui peut générer des scènes pour &Povray; </para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KPovModeler</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Introduction</title>
<para>&kpovmodeler; est une application de modélisation 3D qui génère des scènes &Povray;</para>
<para>Bien qu'il ne soit pas indispensable de connaître parfaitement l'application &Povray; pour bien utiliser &kpovmodeler;, il est fortement recommandé de lire et de comprendre la documentation de &Povray;.</para>
<para>Pour trouver plus d'informations sur &Povray; allez à <ulink url="http://www.povray.org">www.povray.org</ulink>.</para>
</chapter>
<chapter id="the-interface">
<title>L'interface &kpovmodeler;</title>
<para>Quand vous lancez &kpovmodeler;, la disposition par défaut est la suivante :</para>
<screenshot>
<screeninfo>La disposition de la vue par défaut</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="defaultviewlayout.png" format="PNG"/></imageobject>
<textobject><phrase>La disposition de la vue par défaut</phrase></textobject>
</mediaobject>
</screenshot>
<itemizedlist>
<listitem>
<para><link linkend="menu-reference">Barres de menus (1)</link></para>
</listitem>
<listitem>
<para>Barres d'outils (2)</para>
</listitem>
<listitem>
<para><link linkend="the-object-tree">L'arborescence des objets (3)</link></para>
</listitem>
<listitem>
<para><link linkend="the-properties-view">Vue des propriétés des objets (4)</link></para>
</listitem>
<listitem>
<para><link linkend="the-wireframe-views">Vues de la caméra et en mode fil de fer (5)</link></para>
</listitem>
</itemizedlist>
<sect1 id="the-object-tree">
<title>L'arborescence des objets</title>
<para>L'arborescence des objets affiche les objets dans la scène et leur hiérarchie.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="objecttree.png" format="PNG"/></imageobject>
<textobject><phrase>L'arborescence des objets</phrase></textobject>
</mediaobject>
</screenshot>
<sect2 id="object-tree-selecting-object">
<title>Sélection d'objets</title>
<para>Dans une arborescence d'objets, vous pouvez sélectionner des objets. Une fois un objet sélectionné, ses attributs sont affichés dans la <link linkend="the-properties-view">vue des propriétés</link> et dessinés en jaune dans les <link linkend="the-wireframe-views">vues fil de fer</link>.</para>
<para>Vous pouvez sélectionner plusieurs objets. Cependant, vous ne pouvez pas sélectionner un enfant d'un objet déjà sélectionné, car tous les enfants sont sélectionnés indirectement avec le parent.</para>
<para>Si un seul objet est sélectionné, il est dorénavant référencé comme étant <quote>l'objet actif</quote>.</para>
</sect2>
<sect2 id="object-tree-add-objects">
<title>Ajout d'objets</title>
<para>Pour ajouter un nouvel objet à l'arborescence des objets, sélectionnez l'objet où vous voulez l'insérer, et cliquez sur l'icône de la barre d'outils, ou choisissez une entrée dans le menu <guimenu>Insertion</guimenu></para>
<para>Il existe trois positions possibles pour un nouvel objet :</para>
<itemizedlist>
<listitem><para>En tant que premier enfant de l'objet actif</para></listitem>
<listitem><para>En tant que dernier enfant de l'objet actif</para></listitem>
<listitem><para>En tant qu'enfant de même parent</para></listitem>
</itemizedlist>
<para>S'il y a plusieurs position possible, le menu contextuel suivant vous demandera de choisir la bonne position :</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
<textobject><phrase>La fenêtre surgissante d'insertion de position</phrase></textobject>
</mediaobject>
</screenshot>
</sect2>
<sect2 id="object-tree-remove-objects">
<title>Suppression d'objets</title>
<para>Pour supprimer des objets, sélectionnez-les, et choisissez <guimenuitem>Supprimer</guimenuitem> soit à partir du menu <guimenu>Édition</guimenu>, soit avec le menu contextuel du &BDS;.</para>
</sect2>
<sect2 id="object-tree-move-objects">
<title>Déplacer des objets.</title>
<para>Pour déplacer des objets, glissez-déposez les objets sélectionnés sur l'arborescence d'objets.</para>
<para>Vous pouvez également couper un objet, et l'insérer à une nouvelle position</para>
</sect2>
</sect1>
<sect1 id="the-properties-view">
<title>La vue des propriétés</title>
<para>La vue des propriétés affiche les attributs de l'objet actif.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="objectpropertiesview.png" format="PNG"/></imageobject>
<textobject><phrase>La vue des propriétés</phrase></textobject>
</mediaobject>
</screenshot>
<para>Si vous avez changé des propriétés, cliquez le bouton <guibutton>Appliquer </guibutton> pour rendre les changements permanents. Si vous avez saisi des données non valables, une boîte de dialogue apparaîtra avec une description de l'erreur. Vous pourrez alors ajuster les propriétés et cliquer à nouveau sur le bouton <guibutton>Appliquer</guibutton>, ou annuler ces changements avec le bouton <guibutton>Annuler</guibutton>.</para>
<para>Si vous avez paramétré le chemin vers votre documentation utilisateur de &Povray; dans <link linkend="configure-povray-tab">fenêtre de configuration</link>, vous pouvez ouvrir la page de référence &Povray; pour l'objet affiché avec le bouton <guibutton>Aide</guibutton> </para>
<note><para>Vous avez besoin de la documentation utilisateur de &Povray; en HTML version 3.1g ou 3.5 pour utiliser cette fonctionnalité. Si votre distribution ne contient pas cette documentation, vous pouvez la télécharger <ulink url="ftp://ftp.povray.org/pub/povray/Old-Versions/Official-3.1g/Docs/povhtml.zip">ici</ulink>. Le paquetage version 3.5 de &Povray; contient la documentation html.</para>
</note>
<para>Si vous éditez une texture ou une partie d'une texture, vous pouvez la prévisualiser dans la vue des propriétés.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="texturepreview.png" format="PNG"/></imageobject>
<textobject><phrase>La vue des propiétés, prévisualisation de texture</phrase></textobject>
</mediaobject>
</screenshot>
<para>Actionnez le bouton <guibutton>Prévisualisation</guibutton> dans la vue des propriétés et une petit scène d'exemple avec la texture sélectionnée sera calculée. Par défaut, toute la texture sera dessinée, même si l'option « pas le haut » est sélectionnée. Si vous voulez dessiner seulement une partie de la texture (par exemple une texture à l'intérieur d'une texture map et non la texture map en entier), cochez la case <guilabel>local</guilabel>.</para>
</sect1>
<sect1 id="the-wireframe-views">
<title>Les vues fil de fer</title>
<sect2 id="orthographic-views">
<title>Les vues orthogonales</title>
<para>Les vues fil de fer orthogonales affichent la scène comme une projection orthogonale suivant l'un des axes.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="topview.png" format="PNG"/></imageobject>
<textobject><phrase>La vue fil de fer du dessus</phrase></textobject>
</mediaobject>
</screenshot>
<para>Il y a six sortes de vues fil de fer orthogonales :</para>
<itemizedlist>
<listitem><para>Dessus</para></listitem>
<listitem><para>Dessous</para></listitem>
<listitem><para>Gauche</para></listitem>
<listitem><para>Droite</para></listitem>
<listitem><para>Face</para></listitem>
<listitem><para>Arrière</para></listitem>
</itemizedlist>
<para>Chaque type affiche la scène avec une perspective différente.</para>
<sect3 id="graphical-change">
<title>Changements d'attributs graphiques</title>
<para>Dans les vues orthogonales, vous pouvez changer les propriétés des attributs des objets graphiquement avec la souris.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="controlpoints.png" format="PNG"/></imageobject>
<textobject><phrase>Les points de contrôle de l'objet caméra</phrase></textobject>
</mediaobject>
</screenshot>
<para>La capture d'écran ci-dessous montre les points de contrôle de la caméra. Vous pouvez bouger les points de contrôle pour modifier la position et la direction de la caméra.</para>
<para>Si une transformation est sélectionnée, les points de contrôle sont enlevés et une petite croix est affichée dans la vue fil de fer. La croix marque le centre des agrandissements et des rotations, ainsi que la position pour les translations. Vous pouvez changer les transformations avec la souris en la déplaçant à l'intérieur de la vue.</para>
<para>Certains objets comme les patches bicubiques gèrent la sélection et la modification de plusieurs points de contrôle.</para>
<informaltable>
<tgroup cols="2"><tbody>
<row>
<entry>&BGS;</entry>
<entry>Sélectionnez un point de contrôle et désélectionnez tous les autres</entry>
</row>
<row>
<entry><keycombo action="click">&Ctrl; <mousebutton> bouton gauche</mousebutton></keycombo> de la souris</entry>
<entry>Sélectionne ou désélectionne un point de contrôle.</entry>
</row>
<row>
<entry><keycombo action="click">&Maj;<mousebutton>bouton gauche</mousebutton></keycombo> de la souris</entry>
<entry>Dessine un rectangle dans la vue. Tous les points de contrôle à l'intérieur de ce rectangle seront sélectionnés, les autres seront désélectionnés</entry>
</row>
<row>
<entry>Bouton <keycombo action="click">&Maj;&Ctrl;<keycap>gauche</keycap></keycombo> de la souris</entry>
<entry>Dessine un rectangle dans la vue, tous les points de contrôle à l'intérieur de ce rectangle seront sélectionnés</entry>
</row>
</tbody></tgroup>
</informaltable>
</sect3>
<sect3 id="display-window-selection">
<title>Sélection de l'affichage d'une fenêtre</title>
<para>Vous pouvez zoomer et translater la vue pour changer l'affichage de la fenêtre.</para>
<informaltable>
<tgroup cols="2"><tbody>
<row>
<entry>&BCS;</entry>
<entry>Translater la vue</entry>
</row>
<row>
<entry><mousebutton>roue</mousebutton></entry>
<entry>Zoome la vue en fonction de la position de la souris</entry>
</row>
<row>
<entry><keycap>Gauche</keycap>, <keycap>Droite</keycap>, <keycap>Haut</keycap>, <keycap>Bas</keycap> </entry>
<entry>Translater la vue</entry>
</row>
<row>
<entry><keycombo action="simul"><keycap>Ctrl</keycap><keycap>Gauche</keycap></keycombo>, <keycombo action="simul"><keycap>Ctrl</keycap><keycap>Droite</keycap></keycombo></entry>
<entry>Zoome la vue</entry>
</row>
</tbody></tgroup>
</informaltable>
</sect3>
</sect2>
<sect2 id="camera-view">
<title>La vue Caméra</title>
<para>La vue caméra affiche la scène du point de vue de la caméra.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="cameraview.png" format="PNG"/></imageobject>
<textobject><phrase>La vue caméra</phrase></textobject>
</mediaobject>
</screenshot>
<para>La boîte bleue affiche le champ de la vue quand la scène est calculée.</para>
<para>Vous ne pouvez pas changer les points de contrôle dans la vue caméra.</para>
</sect2>
<sect2 id="visibility-levels">
<title>Niveaux de Visibilité</title>
<para>Par défaut tous les objets sont affichés dans les vues fil de fer.</para>
<para>Chaque objet des vues fil de fer possède un niveau de visibilité. Vous pouvez spécifier un niveau de visibilité relatif au niveau de visibilité de l'objet parent, ou une valeur absolue. Les objets ne sont affichés que s'ils sont sélectionnés ou que leur niveau de visibilité est plus petit ou égal au niveau de visibilité de la scène dans la barre d'outils.</para>
</sect2>
</sect1>
<sect1 id="view-layouts">
<title>Disposition des Vues</title>
<para>&kpovmodeler; fournit une disposition des vues par défaut : l'arborescence des objets et la vue des propriétés des objets sur la gauche et les quatre vues graphique sur la droite.</para>
<para>Si vous n'aimez pas la disposition par défaut, ou que vous avez besoin d'une autre disposition, vous pouvez librement en configurer un nouvelle. Vous pouvez même enregistrer plusieurs dispositions, et passer de l'une a l'autre à la volée.</para>
<sect2 id="change-the-view-layout">
<title>Modifier la Disposition des Vues</title>
<para>Vous pouvez déplacer les vues existantes glissant la barre en haut de chaque vue ou vous voulez.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="dockwidget.png" format="PNG"/></imageobject>
<textobject><phrase>La poignée d'attache du tableau de bord</phrase></textobject>
</mediaobject>
</screenshot>
<para>Pour attacher un élément graphique à une vue existante, glissez la poignée d'attache au sommet ou au bas de la vue. Un rectangle vous indiquera la nouvelle position.</para>
<para>Pour créer une nouvelle colonne, glissez la poignée d'attache à la droite ou à la gauche d'une vue. Les vues s'étaleront alors sur toute la hauteur de la fenêtre.</para>
<para>Si vous voulez que plusieurs vues partagent le même espace de travail, glissez la poignée d'attache d'une vue au centre d'une autre vue. Vous pourrez ensuite passer de l'une à l'autre en cliquant sur l'onglet correspondant au sommet des vues.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="dockwidgettab.png" format="PNG"/></imageobject>
<textobject><phrase>La disposition de vue tabulaire</phrase></textobject>
</mediaobject>
</screenshot>
<para>La dernière possibilité de disposition est d'avoir des vues flottantes : les vues ne sont pas attachées dans la vue principale. Pour détacher une vue, glissez la poignée d'attache sur le bureau de travail ou pressez la petite flèche qui pointe vers le coté haut-gauche.</para>
<para>Pour fermer une vue, cliquez la petite croix dans la barre de vue. Pour empêcher la fermeture d'une fenêtre, cliquez sur le petit bouton entre la flèche et la croix.</para>
<para>Vous pouvez ajouter des vues supplémentaires à votre vue principale. Le menu <guimenu>Affichage</guimenu> contient une entrée pour chaque type de vue. Les nouvelles vues seront placées au hasard, vous pourrez ensuite les déplacer où vous voulez.</para>
</sect2>
<sect2 id="save-a-view-layout">
<title>Enregistrer la disposition des vues</title>
<para>Vous pouvez enregistrer la disposition courante avec le menu <menuchoice> <guimenu>Affichage</guimenu> <guimenuitem>Enregistrer la disposition des vues...</guimenuitem> </menuchoice>. Une boîte de dialogue vous laissera le choix de sélectionner une disposition existante, ou d'en créer une nouvelle.</para>
<para>Vous pouvez alors ajuster finement la disposition de vue dans la boîte de dialogue <link linkend="configure-view-layout-tab">paramétrages</link>. </para>
</sect2>
<sect2 id="switching-between-view-layout">
<title>Alterner les dispositions des vues</title>
<para>Vous pouvez passer à une disposition de vue enregistrée en sélectionnant le menu <menuchoice><guimenu>Affichage</guimenu><guimenuitem>Disposition des vues</guimenuitem></menuchoice></para>
</sect2>
</sect1>
</chapter>
<chapter id="povray-interaction">
<title>Interaction avec &Povray;</title>
<sect1 id="rendering-the-scene">
<title>Calculer la scène</title>
<para>Une fois que vous avez créé une scène, vous voudrez la dessiner. &kpovmodeler; utilise &Povray; 3.1g pour calculer la scène, donc vous avez besoin d'une installation correcte de &Povray;. Au moment de l'écriture de ce document, &Povray; 3.5 est paru. Cette version n'est pas gérée par &kpovmodeler; version 1.0.</para>
<para>Allez à l'adresse <ulink url="http://www.povray.org">www.povray.org</ulink> pour télécharger une version de &Povray; ainsi que les instructions d'installation.</para>
<para>Pour calculer la scène courante, actionnez l'icône de calcul du rendu <inlinemediaobject> <imageobject><imagedata fileref="rendericon.png" format="PNG"/></imageobject> <textobject><phrase>L'icône de calcul du rendu</phrase></textobject> </inlinemediaobject> dans la barre d'outils, ou sélectionnez l'entrée du menu <menuchoice><guimenu>Affichage</guimenu><guimenuitem>Rendu</guimenuitem></menuchoice>.</para>
<sect2 id="render-modes">
<title>Modes de calcul du rendu</title>
<para>Un mode de rendu est similaire à une entrée des fichier ini de &Povray;. Il spécifie la taille de l'image, les niveaux de qualité pour le calcul. Si vous voulez calculer une scène avec différents niveaux de qualité, ainsi que différentes tailles, vous pouvez ajouter autant de modes de rendu que vous le souhaitez, allant d'une rapide prévisualisation à des images plein écran de haute résolution, et avec un grand niveau de qualité.</para>
<sect3 id="render-modes-configuration">
<title>Configuration des modes de calcul du rendu</title>
<para>Quand vous actionnez l'icône de paramétrage du calcul de rendu <inlinemediaobject> <imageobject><imagedata fileref="rendersettingsicon.png" format="PNG"/></imageobject> <textobject><phrase>Modes de rendu</phrase></textobject> </inlinemediaobject> dans la barre d'outils ou que vous sélectionnez le menu <menuchoice><guimenu>Vue</guimenu><guimenuitem>Modes de rendu...</guimenuitem></menuchoice>, La boîte de dialogue suivante s'ouvrira :</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="rendermodesselection.png" format="PNG"/></imageobject>
<textobject><phrase>La boîte de dialogue de sélection des modes de rendu</phrase></textobject>
</mediaobject>
</screenshot>
<para>La première boîte de dialogue vous affiche une liste de tous les modes de rendu disponible.</para>
<variablelist>
<varlistentry><term><guibutton>Ajouter</guibutton></term>
<listitem><para><action>Ajoute un mode de rendu par défaut dans la liste</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Supprimer</guibutton></term>
<listitem><para><action>Enlève le mode de rendu sélectionné de la liste</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Édition</guibutton></term>
<listitem><para><action>Ouvre une boîte de dialogue pour éditer le mode de rendu sélectionné</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Monter</guibutton></term>
<listitem><para><action>Déplace le mode de rendu sélectionné d'une position vers le haut</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Descendre</guibutton></term>
<listitem><para><action>Déplace le mode de rendu sélectionné d'une position vers le bas</action>.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Le bouton <guibutton>Édition</guibutton> ouvre la boîte de dialogue de configuration suivante :</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="rendermodesize.png" format="PNG"/></imageobject>
<textobject><phrase>L'onglet « Taille » des modes de rendu</phrase></textobject>
</mediaobject>
</screenshot>
<para>Chaque mode de rendu a une description. Vous pouvez saisir n'importe quelle description, mais elle doit refléter les propriétés du mode de rendu.</para>
<para>Dans l'onglet <guilabel>Taille</guilabel>, vous pouvez saisir la largeur et la hauteur de l'image calculée. Si vous ne voulez calculer qu'une petite partie de l'image, cochez la case <guilabel>Sous-sélection</guilabel> et saisissez la partie de l'image à calculer dans les champs ci-dessous.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="rendermodequality.png" format="PNG"/></imageobject>
<textobject><phrase>L'onglet « Qualité » des modes de rendu</phrase></textobject>
</mediaobject>
</screenshot>
<para>Dans l'onglet <guilabel>Qualité</guilabel>, vous pouvez sélectionner plusieurs niveaux de qualité pour les images à calculer.</para>
<para>Dans la liste déroulante <guilabel>Qualité</guilabel>, vous pouvez sélectionner les fonctionnalités que &Povray; utilisera pour les calculs. Les possibilités vont d'un simple modèle de coloration et d'illumination, à des modèles très complexes avec éclairage avec inter-réflexion et diffusion. Consultez le manuel de &Povray; pour une description détaillée des caractéristiques de rendu.</para>
<para>Si une image est calculée avec un seul échantillon par pixel, plusieurs erreurs peuvent survenir. Ces images ont souvent du moirage ou des effets de crénelage dans les courbes et les lignes, et des détails peuvent être perdus si leur apparence est plus petite qu'un pixel. Cet effet est appelé : <quote>crénelage</quote>.</para>
<para>&Povray; utilise une technique appelée <quote>anticrénelage</quote> pour réduire l'impacte de ces erreurs. En général, les images apparaîtront plus lisse avec cette option.</para>
<para>Si vous activez l'anticrénelage, &Povray; calculera et combinera plus d'un échantillon par pixel. Ceci est appelé le <quote>superéchantillonage</quote></para>
<para>&Povray; supporte deux méthodes de superéchantillonnage. La première est une méthode adaptative non-récursive ; <quote>adaptative</quote> parce que le superéchantillonnage dépend de l'entourage direct du pixel calculé. Tous les pixels ne sont pas échantillonnés avec cette méthode. La seconde méthode est une méthode adaptative récursive ; <quote>récursive</quote> car chaque pixel est divisé et subdivisé récursivement, et <quote>adaptative</quote> car la profondeur de récursivité dépend de la valeur de la couleur calculée.</para>
<para>Quand vous sélectionnez la première méthode, &Povray; lance un rayon par pixel. Si la différence de couleur entre la valeur de ce pixel et celle de ses voisins dépasse un certain seuil, chacun des pixels est superéchantilonné en lançant un nombre fixe de rayons supplémentaires. Si vous réglez la profondeur à une valeur de 4, une grille de 4x4 points sera calculée, une valeur de 5 résultera en une grille de 5x5 (25) échantillons par pixel.</para>
<para>La différence entre deux pixels est calculée comme suit : r<subscript>1</subscript>, g<subscript>1</subscript> et b<subscript>1</subscript> sont les valeurs de rouge, vert et bleu du premier pixel ; r<subscript>2</subscript>, g<subscript>2</subscript> et b<subscript>2</subscript> sont les valeurs de rouge, vert et bleu du second pixel. La différence est alors : </para>
<para>diff = abs(r<subscript>1</subscript>-r<subscript>2</subscript>) + abs(g<subscript>1</subscript>-g<subscript>2</subscript>) + abs(b<subscript>1</subscript>-b<subscript>2</subscript>)</para>
<para>La méthode récursive commence avec 4 échantillons par pixel. Si la valeur de couleur résultante dépasse un certain seuil, le pixel est subdivisé en 4 sous pixels qui sont tracés séparément, et testé pour une prochaine sous-division. Vous pouvez spécifier la profondeur de récursivité maximum avec la valeur de profondeur.</para>
<para>Une méthode additionnelle pour réduire les effets de crénelage consiste à ajouter du « bruit » au processus d'échantillonage, appelée <quote>jittering</quote>. Si vous activez le jittering, &Povray; va modifier légèrement l'échantillon pour réduire le nombre de motifs de couleur régulier.</para>
<para>Le dernier paramètre de qualité est la radiosité. La radiosité est une fonctionnalité expérimentale de &Povray; qui calcule les réflexion de lumière inter-diffuse. Soyez patient quand vous calculez une scène avec cette option.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="rendermodeoutput.png" format="PNG"/></imageobject>
<textobject><phrase>L'onglet des modes de rendu</phrase></textobject>
</mediaobject>
</screenshot>
<para>Dans le dernier onglet, vous pouvez configurer si vous voulez qu'un canal alpha soit calculé par &Povray;. Un pixel sera alors transparent si le rayon correspondant ne rencontre aucun objet.</para>
</sect3>
<sect3 id="choosing-a-render-mode">
<title>Choisir un mode de rendu</title>
<para>Vous pouvez sélectionner le mode de rendu dans la liste déroulante dans la barre d'outils de calcul de rendu.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="rendermodestoolbar.png" format="PNG"/></imageobject>
<textobject><phrase>La barre d'outils des modes de rendu</phrase></textobject>
</mediaobject>
</screenshot>
</sect3>
</sect2>
<sect2 id="the-render-window">
<title>La fenêtre de rendu</title>
<para>Quand vous lancez le calcul d'une scène, cette fenêtre s'ouvrira :</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="renderwindow.png" format="PNG"/></imageobject>
<textobject><phrase>La fenêtre de rendu</phrase></textobject>
</mediaobject>
</screenshot>
<para>Elle affiche l'image calculée, la progression et la vitesse de calcul actuelle.</para>
<variablelist>
<varlistentry><term><guibutton>Arrêter</guibutton></term>
<listitem><para><action>Arrêter &Povray;</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Suspendre</guibutton></term>
<listitem><para><action>Suspendre le calcul de rendu</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Reprendre</guibutton></term>
<listitem><para><action>Reprendre le calcul de rendu</action>.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Résultat de Povray...</guibutton></term>
<listitem><para><action>Ouvre une autre fenêtre qui affiche les messages de la console &Povray;</action>. Si &Povray; se termine anormalement, vous pouvez trouver la raison dans cette fenêtre.</para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Enregistrer...</guibutton></term>
<listitem><para><action>Vous permet de sauvegarder l'image quand elle est calculée.</action></para>
</listitem>
</varlistentry>
<varlistentry><term><guibutton>Fermeture</guibutton></term>
<listitem><para><action>Ferme la fenêtre de calcul de rendu</action>.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<sect1 id="exporting-and-importing-povray">
<title>Exportation et Importation</title>
<sect2 id="exporting-and-importing-a-whole-scene">
<title>Exportation et Importation d'un scène entière</title>
<para>Vous pouvez exporter une scène vers &Povray; avec le menu <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Exporter...</guimenuitem></menuchoice>.</para>
<para>La boîte de dialogue de sauvegarde de fichier vous permettra de choisir le nom et l'endroit ou enregistrer votre fichier.</para>
<note><para>&kpovmodeler; ajoutera automatiquement l'extension <literal role="extension">.pov</literal>.</para></note>
<para>Pour importer une scène &Povray;, sélectionnez le menu <menuchoice><guimenu>Fichier</guimenu><guimenuitem>Importer...</guimenuitem></menuchoice> et choisissez un fichier dans la boîte de dialogue.</para>
<note><para>Toute la syntaxe de &Povray; n'est pas gérée par &kpovmodeler; pour le moment. S'il y a des erreurs ou des alertes durant l'importation, une boîte de dialogue vous montrera la liste des messages.</para></note>
<tip><para>Si vous voulez importer du code de &Povray; non géré par &kpovmodeler; modifiez les sources avec ces deux commentaires spéciaux <quote>//*PMRawBegin</quote> et <quote>//*PMRawEnd</quote>.</para></tip>
</sect2>
<sect2 id="exporting-and-importing-single-objects">
<title>Exportation et Importation d'un seul objet</title>
<para>Vous pouvez glisser des objets de l'arborescence d'objets vers un éditeur de texte pour exporter le code &Povray;. Cela insérera le code des objets dans le fichier texte courant de votre éditeur de texte. Pour importer des objets dans la scène, sélectionnez simplement le code dans votre éditeur de texte, et glissez-le dans l'arborescence d'objets.</para>
<para>Vous pouvez utiliser les fonctionnalités de copier/coller de &kpovmodeler; et de votre éditeur de texte pour échanger du code &Povray;.</para>
</sect2>
</sect1>
</chapter>
<chapter id="customizing">
<title>Configuration de &kpovmodeler;</title>
<sect1 id="configure-povray-tab">
<title>L'onglet <guilabel>Povray</guilabel></title>
<sect2 id="configure-povray-command">
<title><guilabel>Commande Povray</guilabel></title>
<para>La commande povray est appelée quand &kpovmodeler; calcule une scène. Les commandes courantes sont <quote>povray</quote> ou <quote>x-povray</quote>.</para>
</sect2>
<sect2 id="configure-povray-documentation">
<title><guilabel>Documentation utilisateur de Povray</guilabel></title>
<para>Si vous pressez le bouton <guibutton>Aide</guibutton> dans la vue propriétés, &kpovmodeler; ouvre la documentation utilisateur de &Povray; pour les objets affichés. Paramétrez ici le chemin vers votre documentation ainsi que la version de documentation. Les versions gérées sont 3.1g et 3.5.</para>
</sect2>
<sect2 id="configure-povray-library-paths">
<title><guilabel>Chemin des Bibliothèques</guilabel></title>
<para>&Povray; cherche des fichiers externes (hauteur de champs de données par exemple) dans les chemins de bibliothèques de &Povray;. Si vous faites référence à des fichiers qui ne sont pas dans le dossier de la scène, vous devez l'ajouter à la liste. Si un fichier existe dans plusieurs chemins de bibliothèque, ce sera celui dans le premier chemin de la liste qui sera utilisé.</para>
<para>Vous pouvez changer l'ordre avec les boutons <guibutton>Monter</guibutton> et <guibutton>Descendre</guibutton>.</para>
</sect2>
</sect1>
<sect1 id="configure-graphical-view-tab">
<title>L'onglet <guilabel>Vue graphique</guilabel></title>
<sect2 id="configure-colors">
<title><guilabel>Couleurs</guilabel></title>
<para>L'onglet Couleurs vous permet de configurer les couleurs utilisées pour les vues graphiques.</para>
<variablelist>
<varlistentry>
<term><guilabel>Fond :</guilabel></term>
<listitem><para>Couleur du fond.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Maillage :</guilabel></term>
<listitem><para>Les couleurs pour les maillages. La deuxième couleur est utilisée si l'objet est sélectionné.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Points de contrôle :</guilabel></term>
<listitem><para>La couleur des points de contrôle. La deuxième couleur est utilisée si le point de contrôle est sélectionné.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Axes :</guilabel></term>
<listitem><para>Les couleurs pour les axes x, y et z.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Champs de vue :</guilabel></term>
<listitem><para>La couleur des champs de vue rectangle dans la vue caméra et les étiquettes de type de vue.</para></listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="configure-grid">
<title>La grille</title>
<para>Cette page vous permet de configurer la grille dans les vues fil de fer.</para>
<sect3 id="configure-displayed-grid">
<title><guilabel>Grille affichée</guilabel></title>
<variablelist>
<varlistentry>
<term><guilabel>Couleur :</guilabel></term>
<listitem><para>La couleur de grille.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Distance :</guilabel></term>
<listitem><para>La distance minimale entre deux lignes de grille.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="configure-control-point-grid">
<title><guilabel>Grille des points de contrôle.</guilabel></title>
<para>Vous pouvez ajuster les points de contrôle sur la grille avec le menu contextuel des vues fil de fer. Ici, vous pouvez configurer la grille pour des translations, agrandissements et rotations séparément.</para>
</sect3>
</sect2>
<sect2 id="configure-detail-levels">
<title><guilabel>Objets</guilabel></title>
<sect3 id="configure-object-subdivisions">
<title><guilabel>Subdivisions</guilabel></title>
<para>Vous pouvez configurer les niveaux de détails de différents objets ici.</para>
<para>De grandes valeurs aboutiront à un maillage plus fin et donc une meilleure approximation pour les objets affichés, mais cela ralenti le calcul de rendu. Pour certains objets tels que les sphères vous pouvez configurer le niveau de détail pour deux directions séparément.</para>
</sect3>
<sect3 id="configure-object-sizes">
<title><guilabel>Tailles</guilabel></title>
<para>Vous permet de configurer la taille d'affichage des objets infinis dans les vues fil de fer.</para>
</sect3>
<sect3 id="configure-camera-views">
<title><guilabel>Vues caméra</guilabel></title>
<para>Si vous cochez la case <guilabel>Détails élevés pour des projections améliorées</guilabel>, toutes les lignes du maillage sont subdivisées si la caméra utilise une projection améliorée. Les projections améliorées sont toutes les projections sauf les projections en perspective et orthogonale. Cette fonctionnalité améliore grandement les approximations de ces projections mais ralentit le calcul de rendu.</para>
</sect3>
</sect2>
</sect1>
<sect1 id="configure-dialog-view-tab">
<title>L'onglet <guilabel>Vue des propriétés</guilabel></title>
<sect2 id="configure-texture-preview">
<title><guilabel>Prévisualisation de la texture</guilabel></title>
<para>Cette page vous permet de configurer la prévisualisation de texture dans la vue propriétés.</para>
<variablelist>
<varlistentry>
<term><guilabel>Taille</guilabel></term>
<listitem><para>La taille de l'image de prévisualisation.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Gamma :</guilabel></term>
<listitem><para>La correction Gamma.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Objets calculés</guilabel></term>
<listitem><para>Définit la petite scène d'exemple. Au moins un objet doit être sélectionné.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mur</guilabel></term>
<listitem><para>Si la case <guilabel>Activer le mur</guilabel> est cochée, un mur sera calculé derrière les objets. Le mur aura pour texture un motif quadrillé avec deux couleurs configurables.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sol</guilabel></term>
<listitem><para>Si la case <guilabel>Activer le sol</guilabel> est cochée, un sol sera calculé en dessous des objets. Le sol aura pour texture un motif quadrillé avec deux couleurs configurables.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Anticrénelage</guilabel></term>
<listitem><para>Si la case <guilabel>Appliquer l'anticrénelage</guilabel> est cochée, la méthode d'anticrénelage non-récursive sera utilisé pour calculer la scène. Vous pouvez configurer la profondeur et les valeurs seuil. Allez voir la <link linkend="render-modes-configuration">section des modes de rendu</link> pour une description détaillé des paramètres.</para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
<sect1 id="configure-view-layout-tab">
<title>L'onglet <guilabel>Disposition de Vues</guilabel></title>
<para>Dans cette page, vous pouvez régler finement des dispositions de vue existante, ou en créer de nouvelles. Allez voir la section <link linkend="view-layouts">Disposition de Vues</link> pour savoir comment créer et enregistrer des dispositions de vue.</para>
<sect2 id="configure-default-layout">
<title>La disposition de vues par défaut</title>
<para>La liste déroulante <guilabel>Disposition de vue par défaut :</guilabel> liste toutes les dispositions de vue disponibles. &kpovmodeler; utilisera la disposition de vue sélectionnée au démarrage du programme.</para>
</sect2>
<sect2 id="configure-list-of-view-layouts">
<title>Listes des dispositions de vues</title>
<para>La liste <guilabel>Dispositions de vues disponibles</guilabel> montre toutes les dispositions de vue disponibles. Vous pouvez ajouter une nouvelle disposition de vue avec le bouton <guibutton>Ajouter</guibutton> et supprimer la disposition sélectionnée avec le bouton <guibutton>Supprimer</guibutton>.</para>
<para>La disposition de vue sélectionnée est affichée dans la boîte <guilabel>Disposition de vues</guilabel></para>
</sect2>
<sect2 id="configure-view-layout-details">
<title>Détails de la disposition de vue</title>
<para>Chaque disposition de vue est identifiée par son nom. Le nom doit être unique et ne doit pas être vide.</para>
<para>La liste ci-dessous affiche les noms de toutes les vues pour la disposition de vues sélectionnée. Vous pouvez ajouter une nouvelle vue avec le bouton <guibutton>Ajouter</guibutton> et enlever la vue sélectionnée avec le bouton <guibutton>Supprimer</guibutton>.</para>
<para>Les attributs des vues sont :</para>
<variablelist>
<varlistentry>
<term><guilabel>Type :</guilabel></term>
<listitem>
<para>Le type de vue. Allez voir <link linkend="the-interface">l'interface &kpovmodeler;</link> pour une description de chaque type de vue.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Type de vue 3D :</guilabel></term>
<listitem>
<para>La projection pour les vues fil de fer. Vous pouvez choisir une des six projections orthogonales ou le mode caméra.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Position du tableau de bord :</guilabel></term>
<listitem>
<para>La position de la vue. <guilabel>Nouvelle Colonne</guilabel> créera une nouvelle colonne à la droite des vues précédentes, <guilabel>En Dessous</guilabel> attachera la vue en dessous de la vue précédente, <guilabel>Tabulaire</guilabel> créera une vue tabulaire en prenant en compte les autres vues, et <guilabel>Flottante</guilabel> n'attachera pas la vue dans la fenêtre principale, mais créera une fenêtre séparée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Largeur de colonne :</guilabel></term>
<listitem>
<para>La largeur de colonne en pourcentage de la largeur de la vue principale.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Hauteur de vue :</guilabel></term>
<listitem>
<para>La hauteur de vue en pourcentage de la hauteur de la vue principale.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Largeur :</guilabel> et <guilabel>Hauteur :</guilabel></term>
<listitem>
<para>La taille en pixels pour des vues mobiles</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Position x :</guilabel> et <guilabel>y :</guilabel></term>
<listitem>
<para>La position du bureau pour des vues mobiles.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
</chapter>
<chapter id="basic-tutorial">
<title>Tutoriel de base : créer votre première scène</title>
<para>Bon, vous venez juste d'installer &Povray; et &kpovmodeler; et vous voulez déjà commencer à créer une scène sans aucune connaissance de ces logiciels. Voici comment débuter : si vous suivez les étapes de ce tutoriel, vous serez capable de créer la scène la plus répandue parmi les débutants : une sphère au-dessus d'un plan.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="tutorial01-final-render.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
<para>À n'importe quel moment, vous pouvez lancer le calcul de la scène en utilisant une de ces méthodes :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Affichage</guimenu><guimenuitem>Calcul du Rendu</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmrender.png" format="PNG"/></imageobject> </inlinemediaobject></para>
<para>Mais vous devez prendre en considération ces avertissements avant de vous plaindre si vous n'obtenez qu'un écran noir. Si c'est la première fois que vous utilisez un logiciel de 3D, faites attention à ces règles d'or :</para>
<itemizedlist>
<listitem><para>Si vous ne créez pas de caméra, aucune règle ne s'appliquera au moteur de calcul de rendu, et donc il ne pourra rien calculer. Le résultat sera une image noire.</para></listitem>
<listitem><para>Si vous ne créez pas de source de lumière, toute votre scène sera sombre, et le résultat sera une image noire.</para></listitem>
<listitem><para>Les objets pour lesquels aucune texture n'a été définie n'apparaîtront pas dans l'image calculée.</para></listitem>
</itemizedlist>
<sect1 id="basic-tutorial-step-1">
<title>Étape 1 : lancez &kpovmodeler;</title>
<para>Si tout est installé convenablement, une fois &kpovmodeler; chargé, vous découvrirez les paramètres par défaut des fenêtres suivant :</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="defaultviewlayout.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Prenez quelques minutes pour explorer les menus et icônes disponibles. Si vous avez du temps, lisez également la documentation histoire de vous faire une idée de ce que peut vous apporter ce logiciel.</para>
<itemizedlist>
<listitem>
<para><link linkend="menu-reference">Barres de menus (1)</link></para>
</listitem>
<listitem>
<para>Barres d'outils (2)</para>
</listitem>
<listitem>
<para><link linkend="the-object-tree">L'arborescence des objets (3)</link></para>
</listitem>
<listitem>
<para><link linkend="the-properties-view">Vue des propriétés des objets (4)</link></para>
</listitem>
<listitem>
<para><link linkend="the-wireframe-views">Vues de la caméra et en mode fil de fer (5)</link></para>
</listitem>
</itemizedlist>
<para>Vous aurez besoin d'utiliser chacun d'eux intensivement maintenant, donc gardez-les en mémoire.</para>
<para>&kpovmodeler; démarre avec une scène simple. Pour suivre ce tutoriel, vous devez tout d'abord supprimer tous les objets de l'arborescence d'objets. Sélectionnez la scène et choisissez le menu <menuchoice><guimenu>Édition</guimenu><guimenuitem>Supprimer</guimenuitem></menuchoice>. Vous devriez avoir maintenant une scène vide.</para>
</sect1>
<sect1 id="basic-tutorial-step-2">
<title>Étape 2 : créer la Caméra</title>
<para>La première chose sera de créer un caméra. Pour se faire, vous avez deux moyens à votre disposition :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guimenuitem>Caméra</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmcamera.png" format="PNG"/></imageobject> </inlinemediaobject></para>
<para>Les vues fil de fer montrent comment la caméra est réglée au regard de la scène. En particulier, nous pouvons maintenant voir quelque chose dans les quatre vues fil de fer. En bas à droite, il s'agit de la vue du point de vue de la caméra. C'est ce que nous verrons vraiment quand nous lancerons le calcul de la scène.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="tutorial01-camera-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>L'arborescence d'objets affiche maintenant une nouvelle entrée, nommée <quote>Caméra</quote>. Si vous cliquez dessus, cela affectera le contenu de la vue des propriétés de l'objet, où l'on peut trouver plusieurs paramètres associés à la caméra. Il peut être utile de faire référence à la documentation de &Povray; pour en savoir plus sur ces paramètres.</para>
<screenshot>
<mediaobject>
<imageobject><imagedata fileref="tutorial01-camera-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Nous ne changerons rien au paramétrage de base de la caméra, ce sera le contenu d'autres tutoriels, mais veuillez noter que dans les vues graphiques, la caméra a des points de contrôle qui vous permettent de modifier la direction dans laquelle pointe la caméra. Pour cela cliquez simplement sur ces points et déplacez-les où vous le désirez.</para>
</sect1>
<sect1 id="basic-tutorial-step-3">
<title>Étape 3 : créer une source de lumière</title>
<para>De la même façon que nous avons créé la caméra, nous allons à présent créer une source de lumière :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guimenuitem>Lumière</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmlight.png" format="PNG"/></imageobject> </inlinemediaobject></para>
<para>Une nouvelle entrée apparaît maintenant dans l'arborescence d'objet. Si vous cliquez sur l'entrée de la source de lumière. La vue des propriétés change pour afficher les paramètres disponibles de la source de lumière. Nous changerons quelques paramètres pour que la source de lumière se trouve au-dessus de l'horizon (<guilabel>y</guilabel>=3), et un peu sur la droite (<guilabel>x</guilabel>=1) et en avant plan (<guilabel>z</guilabel>=1). Nous pouvons aussi renommer la source de lumière (<guilabel>Nom</guilabel>=<quote>Lumière principale</quote>). Modifiez les valeurs dans la vue propriétés de l'objet comme suit :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-light-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Une fois que vous avez actionné le bouton <guilabel>Appliquer</guilabel> (ou tapé Entrée), la vue fil de fer et l'arborescence d'objet change immédiatement pour refléter ces modifications, et voici ce que devrait voir la caméra.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-light-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="basic-tutorial-step-4">
<title>Étape 4 : créer le sol</title>
<para>Il existe plusieurs manières de créer un sol pour notre scène. Une méthode pourrait être d'insérer un objet boîte (<menuchoice><guimenu>Insertion</guimenu><guisubmenu>Primitives de solides finis</guisubmenu><guimenuitem>Boîte</guimenuitem></menuchoice>) et redimensionner x à 100, y à 0 et z à 100, par exemple, mais c'est une façon de faire un peu lourde.</para>
<para>En fait, &kpovmodeler; vous offre une possibilité intéressante : vous pouvez créer un plan infini qui représentera le sol :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Primitives de solides infinis</guisubmenu> <guimenuitem>Plan</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outil : cliquez sur l'icône <inlinemediaobject><imageobject><imagedata fileref="cr22-action-pmplane.png" format="PNG"/></imageobject> </inlinemediaobject> </para>
<para>Maintenant, en sélectionnant le plan dans l'arborescence d'objets, changez le nom pour avoir quelque chose de plus parlant pour vous et pressez le bouton <guilabel>Appliquer</guilabel> (ou Entrée). L'arborescence d'objet va mettre a jour le nom de l'entrée.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-plane-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>La vue fil de fer vous affiche également le plan maintenant, même s'il apparaît comme étant de dimension finie pour l'instant. Mais ne vous inquiétez pas, il s'étendra jusqu'à la ligne d'horizon quand vous lancerez le calcul de la scène !</para>
<para>Si vous regardez l'arborescence d'objets, vous remarquerez que l'entrée correspondant au sol peut être étendue si vous cliquez sur le <quote>plus</quote> affiché devant cette entrée. Une fois fait, vous voyez plusieurs paramètres apparentés à l'objet. Dans ce cas, il n'y en a pas beaucoup, à part les options standard à chaque nouvel objet : agrandissement, rotation et translation. En sélectionnant chacun d'eux, vous pourrez modifier les paramètres disponible dans la vue propriétés de l'objet.</para>
<screenshot>
<mediaobject> <imageobject><imagedata fileref="tutorial01-plane-tree-expanded.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Dans cette scène, vous allez déplacer arbitrairement le sol d'une unité vers le bas, et pour vous aider, sélectionnez déplacer, et ajuster les paramètres comme suit :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-plane-tree-translate.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Votre scène devrait ressembler à ce qu'il y a sur l'image suivante.</para>
<screenshot><mediaobject><imageobject><imagedata fileref="tutorial01-plane-graphic.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="basic-tutorial-step-5">
<title>Étape 5 : donner une Texture au Sol.</title>
<para>Vous devez d'abord sélectionner le sol avant de pouvoir lui appliquer une texture. Plusieurs possibilités s'offrent à nous, mais nous utiliserons la technique la plus simple possible.</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Pigment</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmpigment.png" format="PNG"/></imageobject> </inlinemediaobject>.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Dans chacun des cas, une fenêtre surgissante vous demandera de choisir une façon dont seront insérés les objets. Choisissez <guilabel>Premier Enfant</guilabel>. Le pigment apparaît maintenant dans l'arborescence d'objet. Vous pouvez changer son nom dans la vue propriétés (<guilabel>Nom</guilabel>=<quote>Pigment sol</quote>), et cliquer sur le bouton <guibutton>Prévisualisation</guibutton> pour voir quel sera le rendu du pigment.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-pigment.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Bien sûr, la prévisualisation du pigment ne montre rien d'autre qu'un matériel noir mat, car nous devons définir les paramètres du pigment. Quoi qu'il en soit, gardez à l'esprit que vous pouvez toujours avoir un aperçu des vos matériaux en utilisant le bouton <guibutton>Prévisualisation</guibutton>. Nous allons maintenant définir les couleurs du pigment. Une fois de plus, plusieurs possibilités s'offrent à nous, mais nous choisirons la méthode la plus directe pour l'instant.</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Liste de couleurs</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmcolorlist.png" format="PNG"/></imageobject> </inlinemediaobject>.</para>
<para>Si aucune couleur n'apparaît sur la boîte et la sphère de prévisualisation, cliquez sur le bouton <guibutton>Appliquer</guibutton> avant d'appeler la prévisualisation.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-color-list.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Le matériel du sol a été correctement paramétré ! Si vous lancez le calcul de rendu maintenant en utilisant l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmrender.png" format="PNG"/></imageobject> </inlinemediaobject>, vous devriez avoir ceci :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-wrong-colors-render.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Bien sûr, ces couleurs ne sont peut être pas celle que vous souhaitiez. Nous devons encore voir comment les modifier. Dans le cas d'une liste de couleurs, vous devez définir deux nouveaux types d'attributs appelés <guilabel>Couleur pleine</guilabel>. Vérifiez que la liste de couleurs est bien sélectionnée dans l'arborescence d'objets. Ensuite répétez deux fois cette opération (vous ne pouvez pas le faire plus de fois, car une liste de couleurs pour un quadrillage ne peut accepter que deux couleurs pleines) :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Couleur pleine</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmsolidcolor.png" format="PNG"/></imageobject> </inlinemediaobject>.</para>
<para>Dans l'arborescence d'objets, sélectionnez l'une après l'autre les deux couleurs solides, et changez leur attributs dans la vue des propriétés :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-solid-color-1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>...ces attributs sont pour la première couleur solide (pressez le bouton <guibutton>Appliquer</guibutton> !),</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-solid-color-2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>...et ces attributs sont pour la seconde couleur solide (actionnez encore le bouton <guibutton>Appliquer</guibutton> !).</para>
<para>Bien sûr, un nouveau calcul de rendu prouvera que tout a été pris en compte :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-ground-render.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="basic-tutorial-step-6">
<title>Étape 6 : créer la sphère</title>
<para>Pour cette étape, nous devrions déjà être plus a l'aise, car nous commençons à comprendre le fonctionnement général de &kpovmodeler;. Dans l'arborescence d'objets, sélectionnez la l'entrée « scène ». Créer la sphère est aussi simple que de créer le sol.</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Primitives de solides finis</guisubmenu> <guimenuitem>Sphère</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmsphere.png" format="PNG"/></imageobject> </inlinemediaobject>.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="insertaspopup.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Comme précédemment, sélectionnez <guilabel>Premier Enfant</guilabel> quand on vous le demandera.</para>
<para>La vue propriétés des objets vous permet de changer ses paramètres immédiatement, ce que nous allons faire maintenant. En réglant le <guilabel>Rayon</guilabel> à 1 (n'oubliez pas d'actionner Entrée ou le bouton <guibutton>Appliquer</guibutton>), nous serons sûrs que la sphère sera en contact avec le sol. Sinon, comme nous avons déplacé le sol d'une unité vers le bas, la sphère aurait l'air de flotter au-dessus du sol.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Bien entendu, un calcul du rendu nous donnera un résultat étrange : comme vu précédemment, la sphère apparaît avec un matériel noir mat. Nous allons lui allouer un matériel plus approprié à l'étape suivante.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-render-nocolor.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="basic-tutorial-step-7">
<title>Étape 7 : ajouter une texture à la sphère</title>
<para>Avec la sphère sélectionnée, vous pouvez maintenant lui allouer un matériel. Comme nous l'avons déjà fait pour le sol, mettons sur la sphère une couleur :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Pigment</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject><imageobject><imagedata fileref="cr22-action-pmpigment.png" format="PNG"/></imageobject> </inlinemediaobject> </para>
<para>Sélectionnez <guilabel>Premier Enfant</guilabel> et renommez l'objet en <quote>Sphère pigment</quote>, par exemple. En sélectionnant l'entrée pigment de la sphère, insérez une couleur uniforme et réglez les paramètres comme suit :</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Couleur pleine</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject><imageobject><imagedata fileref="cr22-action-pmsolidcolor.png" format="PNG"/></imageobject> </inlinemediaobject></para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-solid-color.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Vous pouvez déjà lancer le calcul de la scène et obtenir un premier résultat basique :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-render-solidcolor.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Mais il y a d'autres effets plus intéressants à ajouter si nous prenons le temps d'ajouter des attributs de finition.</para>
<para>En utilisant le menu : <menuchoice><guimenu>Insertion</guimenu><guisubmenu>Textures</guisubmenu> <guimenuitem>Finition</guimenuitem></menuchoice></para>
<para>En utilisant la barre d'outils : cliquez sur l'icône <inlinemediaobject> <imageobject><imagedata fileref="cr22-action-pmfinish.png" format="PNG"/></imageobject> </inlinemediaobject>.</para>
<para>Changez ensuite les valeurs d'après la capture suivante et actionnez <guibutton>Appliquer</guibutton> ou Entrée.</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-finish-dialog.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>Les paramètres <guilabel>Specular</guilabel> et <guilabel>Réflexion</guilabel> donnent de particulièrement beaux effets visuel, il sont en particulier parfaits pour des effets de verre ou de chrome, même si le paramètre <guilabel>Métallique</guilabel> n'a pas été coché à cette étape :</para>
<screenshot>
<mediaobject><imageobject><imagedata fileref="tutorial01-sphere-render-finish.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="basic-tutorial-conclusion">
<title>Conclusion</title>
<para>Vous devez maintenant avoir un bon aperçu des possibilités de kpovmodeler, et vous êtes maintenant suffisamment capable de créer de simples mais belles scènes.</para>
</sect1>
</chapter>
<chapter id="concepts">
<title>Concepts de base</title>
<sect1 id="what-is-raytracing">
<title>Qu'est ce que le Raytracing ?</title>
<para>Le Raytracing est une méthode de <link linkend="gloss-rendering">calcul de rendu</link>, c'est-à-dire, créer une image 2D à partir d'une scène 3D.</para>
<para>Quand vous lancez le calcul d'une scène, le moteur de rendu lance des rayons hypothétiques depuis le point de vue de l'utilisateur (c'est-à-dire, depuis la caméra à partir de laquelle vous regardez la scène) vers chaque pixel de la scène. Il calcule comment les rayons vont se réfléchir, et se réfracter sur les objets, ainsi que les effets des sources de lumières et phénomènes atmosphériques tels que le brouillard. La scène est ainsi construite pixel par pixel.</para>
<para>Comme vous pouvez l'imaginer, sans caméra, vous ne pouvez rien voir - la caméra est vos <quote>yeux</quote> dans la scène. De plus, sans lumière, vous ne verrez rien non plus - Ce sera tout simplement noir. Donc toute scène que vous voulez calculer doit contenir des sources de lumière, des objets et au moins une caméra.</para>
</sect1>
</chapter>
<chapter id="objects-reference">
<title>Référence des Objets</title>
<para>Pour une référence complète de tous les objets et attributs, allez voir la documentation utilisateur de &Povray;.</para>
</chapter>
<chapter id="menu-reference">
<title>Référence des menus</title>
<sect1 id="file-menu">
<title>Le menu <guimenu>Fichier</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Nouveau</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Crée un nouvelle scène.</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Fichier</guimenu> <guimenuitem>Importer...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Importe une scène &Povray;</action> créée hors de &kpovmodeler;.</para>
<para>Une boîte de dialogue standards'ouvrira, vous permettant de choisir un fichier. Les fichiers Povray ont généralement comme extension <literal role="extension">*.pov</literal> ou <literal role="extension">*.inc</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Ouvrir...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Ouvre un fichier.</action> La boîte de dialogue standard vous permettra de choisir un fichier que vous avez créé auparavant avec &kpovmodeler;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Fichier</guimenu> <guisubmenu>Récemment ouverts</guisubmenu> </menuchoice></term>
<listitem>
<para><action>Ouvre un fichier à partir d'une liste de fichiers sur lesquels vous avez travaillé récemment.</action></para>
<para>À chaque fois que vous ouvrez ou créez un nouveau modèle, il est ajouté à ce sous-menu, remplaçant ainsi la plus vieille entrée de la liste.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Enregistrer</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Enregistre la scène active courante.</action></para>
<para>Si vous avez déjà enregistré cette scène, elle sera enregistrée dans le même fichier. Si c'est une nouvelle scène, il vous sera demandé de choisir un fichier de sauvegarde.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Fichier</guimenu> <guimenuitem>Enregistrer sous...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Enregistre la scène active courante dans un nouveau fichier.</action></para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Fichier</guimenu> <guimenuitem>Exporter...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Exporte la scène dans un fichier &Povray;.</action></para>
<para>La boîte de dialogue de sauvegarde de fichier vous permettra de choisir le nom et l'endroit ou enregistrer votre fichier.</para>
<note><para>&kpovmodeler; ajoutera automatiquement l'extension <literal role="extension">.pov</literal>.</para></note>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Fichier</guimenu> <guimenuitem>Recharger</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Revient dans l'état ou la scène se trouvait la dernière fois que vous l'avez enregistrée.</action> Les changements que vous avez fait depuis seront perdus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Imprimer...</guimenuitem> </menuchoice></term>
<listitem>
<para>La fonction d'impression n'est pas encore implémentée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Fermer</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Ferme la scène courante</action> sans quitter &kpovmodeler;</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut> <guimenu>Fichier</guimenu> <guimenuitem>Quitter</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Quitte</action> &kpovmodeler;. Si vous avez des modifications non enregistrées, vous aurez encore une chance de le faire avant de quitter.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="edit-menu">
<title>Le Menu <guimenu>Édition</guimenu></title>
<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> </shortcut> <guimenu>Édition</guimenu> <guimenuitem>Annuler</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Annule votre dernière action.</action></para>
<para>Cette entrée de menu n'est pas accessible tant que vous n'avez pas fait de changement dans la scène courante.</para><!-- FIXME: is the number of items in the -->
<!-- undo history configurable? -->
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"> &Ctrl;&Maj;<keycap>Z</keycap></keycombo></shortcut> <guimenu>Édition</guimenu> <guimenuitem>Refaire</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Refait la dernière action annulée.</action> Cette entrée de menu n'est pas accessible tant que vous n'avez pas utilisé <menuchoice><guimenu>Édition</guimenu> <guimenuitem>Annuler</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"> &Ctrl;<keycap>X</keycap></keycombo></shortcut> <guimenu>Édition</guimenu> <guimenuitem>Couper</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Coupe</action> le ou les objet(s) actuellement sélectionné(s), et les met dans le presse-papiers.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"> &Ctrl;<keycap>C</keycap></keycombo></shortcut> <guimenu>Édition</guimenu> <guimenuitem>Copier</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Copie</action> le ou les objet(s) actuellement sélectionné(s), et les met dans le presse-papiers.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"> &Ctrl;<keycap>V</keycap></keycombo></shortcut> <guimenu>Édition</guimenu> <guimenuitem>Coller</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Colle</action> le contenu du presse-papiers.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Édition</guimenu> <guimenuitem>Supprimer</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Supprime</action> le ou les objet(s) actuellement sélectionné(s) de la scène.</para>
<!-- FIXME: Shouldn't this be bound to the delete key? -->
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="view-menu">
<title>Le Menu <guimenu>Affichage</guimenu></title>
<variablelist>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Nouvel arbre des objets</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="the-object-tree">Arborescence d'objets</link>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Nouvelle vue des propriétés</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="the-properties-view">Vue des propriétés des objets</link>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Nouvelle vue du haut</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective du dessus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Nouvelle vue du bas</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective du dessous.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Nouvelle vue de gauche</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective de gauche.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Vue</guimenu> <guimenuitem>Nouvelle vue de droite</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective de droite.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Vue</guimenu> <guimenuitem>Nouvelle vue avant</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective de l'avant.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Vue</guimenu> <guimenuitem>Nouvelle vue de l'arrière</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="orthographic-views">vue orthogonale</link> à partir de la vue en perspective de l'arrière.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Vue</guimenu> <guimenuitem>Nouvelle vue de caméra</guimenuitem> </term>
<listitem>
<para><action>Crée</action> une nouvelle <link linkend="camera-view">vue caméra</link>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Disposition des vues</guimenuitem> </term>
<listitem>
<para>Contient une liste de toutes les dispositions de vues existantes. Modifie la disposition avec celle sélectionnée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Enregistrer la disposition des vues</guimenuitem> </term>
<listitem>
<para>Enregistre la disposition de vue courante. Une boîte de dialogue s'ouvre pour choisir un nom pour cette nouvelle disposition, ou pour en écraser une existante.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Modes de rendu...</guimenuitem> </term>
<listitem>
<para>Ouvre la boîte de dialogue <link linkend="render-modes-configuration"> configuration des modes de rendu</link></para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Rendu</guimenuitem> </term>
<listitem>
<para>Calcule le rendu de la scène.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Fenêtre de rendu</guimenuitem> </term>
<listitem>
<para>Affiche la fenêtre de rendu de &Povray;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Affichage</guimenu> <guimenuitem>Réaffichage</guimenuitem> </term>
<listitem>
<para>Réaffiche les vues fil de fer.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="insert-menu">
<title>Le menu <guimenu>Insertion</guimenu></title>
<para>Actions de création pour tous les objets &Povray; gérés.</para>
</sect1>
<sect1 id="settings-menu">
<title>Le menu <guimenu>Configuration</guimenu></title>
<para>Ce menu fourni des options pour configurer &kpovmodeler;, changer son apparence, les raccourcis clavier, et les comportements par défaut.</para>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Paramètres</guimenu> <guimenuitem>Afficher la barre d'état</guimenuitem> </menuchoice></term>
<listitem><para><action>Affiche/cache la barre d'état.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Montrer le chemin</guimenuitem> </menuchoice></term>
<listitem><para><action>Affiche/cache le chemin dans la légende.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Enregistrer la configuration</guimenuitem> </menuchoice></term>
<listitem><para><action>Enregistre les paramètres courants.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer les raccourcis clavier...</guimenuitem> </menuchoice></term>
<listitem><para><action>Ouvre une boîte de dialogue pour modifier la définition des touches.</action> En utilisant cette option, vous pourrez changer les raccourcis standard pour les commandes de &kpovmodeler;, ou en créer de nouvelles.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer les barres d'outils...</guimenuitem> </menuchoice></term>
<listitem><para><action>Ouvre une boîte de dialogue pour configurer la barre d'outils.</action> Vous pouvez ajouter et enlever des boutons pour les commandes de &kpovmodeler; avec cette option.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer KPovModeler...</guimenuitem> </menuchoice></term>
<listitem><para><action>Ouvre la boîte de dialogue de configuration de &kpovmodeler;</action></para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="help-menu">
<title>Le Menu <guimenu>Aide</guimenu></title>
&help.menu.documentation; </sect1>
</chapter>
<chapter id="credits-and-licenses">
<title>Remerciements et licences</title>
<para>&kpovmodeler; copyright 2001,2002 Les auteurs de &kpovmodeler;.</para>
<itemizedlist>
<title>Auteurs</title>
<listitem>
<para>Andreas Zehender <email>zehender@kde.org</email></para>
</listitem>
<listitem>
<para>Luis Passos Carvalho <email>lpassos@mail.telepac.pt</email></para>
</listitem>
<listitem>
<para>Phillippe Van Hecke <email>lephiloux@tiscalinet.be</email></para>
</listitem>
<listitem>
<para>Leonardo Skorianez <email>skorianez@bol.com.br</email></para>
</listitem>
</itemizedlist>
<para>Documentation copyright 2002 Lauri Watts <email>lauri@kde.org</email></para>
<para>Documentation copyright 2002 Andreas Zehender <email>zehender@kde.org</email></para>
<para>Documentation copyright 2002 Olivier Saraja <email>olivier@linuxgraphic.org</email></para>
<para>Traduction française par &GuillaumeDuwelzRebert;.</para>
&underFDL; &underGPL; </chapter>
<glossary id="glossary">
<title>Glossaire</title>
<glossentry id="gloss-bump-map">
<glossterm>Bump Map</glossterm>
<glossdef>
<para>Une <quote>bump map</quote> est une façon de simuler une surface rugueuse, sans avoir à modéliser chaque petit <quote>défaut</quote> sur la surface, et sans changer la surface géométrique de l'objet lui-même.</para>
<para>Il est classique d'utiliser le même fichier en tant que <quote>bump map</quote> et <quote><link linkend="gloss-texture-map">texture map</link></quote>.</para>
</glossdef>
</glossentry>
<glossentry id="gloss-primitives">
<glossterm>Primitives</glossterm>
<glossdef>
<para>Les primitives sont les formes géométrique de bases que vous pouvez utiliser en tant que <quote>blocs de construction</quote>. La plupart des modeles 3D sont créés avec plusieurs dizaine, ou centaine de ces primitives, qui sont éditées et manipulées pour leur donner une apparence plus réaliste.</para>
</glossdef>
</glossentry>
<glossentry id="gloss-rendering">
<glossterm>Calcul du rendu</glossterm>
<glossdef>
<para>Pas encore écrit</para>
</glossdef>
</glossentry>
<glossentry id="gloss-texture-map">
<glossterm>Texture Map</glossterm>
<glossdef>
<para>Une <quote>texture map</quote> est une façon d'appliquer des couleurs à la surface d'un objet, pixel par pixel, en appliquant un fichier image en tant que map de couleur</para>
<para>Il est courant d'enregistrer l'image en tant que <quote><link linkend="gloss-bump-map">bump map</link></quote>.</para>
</glossdef>
</glossentry>
</glossary>
&documentation.index;
<appendix id="installation">
<title>Installation</title>
&install.intro.documentation;
&install.compile.documentation;
</appendix>
</book>
|