Code

Refactoring of 3D box tool, mainly to avoid unnecessary creation of perspectives.
[inkscape.git] / inkscape.fr.pod
1 
2 =head1 NOM
4 Inkscape - programme d'édition SVG (Scalable Vector Graphics).
6 =head1 SYNOPSIS
8 C<inkscape [options] [nom_de_fichier ...]>
10 options:
12     -?, --help
13         --usage
14     -V, --version
16     -f, --file=NOMDEFICHIER
18     -e, --export-png=NOMDEFICHIER
19     -a, --export-area=x0:y0:x1:y1
20     -C, --export-area-canvas
21     -D, --export-area-drawing
22         --export-area-snap
23     -i, --export-id=ID
24     -j, --export-id-only
25     -t, --export-use-hints
26     -b, --export-background=COULEUR
27     -y, --export-background-opacity=VALEUR
28     -d, --export-dpi=PPP
29     -w, --export-width=LARGEUR
30     -h, --export-height=HAUTEUR
32     -P, --export-ps=NOMDEFICHIER
33     -E, --export-eps=NOMDEFICHIER
34     -T, --export-text-to-path
35     -B, --export-bbox-page
37     -l, --export-plain-svg=NOMDEFICHIER
39     -I, --query-id=ID
40     -X, --query-x
41     -Y, --query-y
42     -W, --query-width
43     -H, --query-height
45     -x, --extension-directory
47     -p, --print=IMPRIMANTE
49     -g, --with-gui
50     -z, --without-gui
52         --vacuum-defs
54         --g-fatal-warnings
56 =head1 DESCRIPTION
58 B<Inkscape> est un éditeur de dessin au format B<Scalable Vector Graphics (SVG)> doté d'une interface graphique, offrant des possibilités similaires à B<Adobe Illustrator>, B<CorelDraw>, B<Visio>, etc. Les fonctionnalités d'Inkscape comprennent une gestion versatile des formes, le dessin à main levée et les courbes de Bézier, le texte multiligne, le texte suivant un chemin, la transparence, les transformations affines, les remplissages par motif ou dégradé, l'édition de nœuds, l'export SVG vers PNG, le groupement, les calques, les clones interactifs et bien plus encore. L'interface est conçue pour être confortable et efficace pour les utilisateurs expérimentés tout en restant conforme aux spécifications de B<GNOME> permettant ainsi aux utilisateurs d'applications GNOME de s'y habituer rapidement.
60 Le format B<SVG> est un format XML standard pour le dessin vectoriel 2D. Il permet de définir des objets sur un dessin par l'utilisation de points, chemins et formes primitives. Les couleurs, fontes, largeur de contour et autres sont spécifiés en tant qu'attributs de 'style' de ces objets. Le but est de rendre possible l'utilisation de fichiers SVG pour un grand nombre de programmes et d'utilisation, SVG étant un standard et ses fichiers du type texte/xml.
62 B<Inkscape> utilise le SVG comme format natif de ses documents, et a pour but de devenir le plus conforme des programmes de dessin SVG, disponible pour la communeauté du logiciel libre.
65 =head1 OPTIONS
67 =over 8
69 =item B<-?>, B<--help>
71 Affiche un message d'aide.
73 =item B<-V>, B<--version>
75 Affiche la version d'Inkscape et la date de compilation.
77 =item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1>
79 Pour l'export en PNG, définit la zone à exporter en pixels SVG (unité anonyme de longueur utilisée normalement par le format SVG Inkscape). Le comportement par défaut est d'exporter le canevas entier du document. Le point (0,0) est le coin inférieur gauche.
81 =item B<-C>, B<--export-area-canvas>
83 Pour l'export en PNG, la zone exportée est le canevas entier (la page). C'est habituellement le comportement par défaut, aussi spécifier cette option n'est pas nécessaire sauf en cas d'utilisation de --export-id pour exporter un objet spécifique.
85 =item B<-D>, B<--export-area-drawing>
87 Pour l'export en PNG, la zone à exporter est le dessin entier (pas le canevas). Avec cette option, l'image exportée n'affichera que les objets visibles du document sans marge ni massicotage. Peut être combiné avec  --export-use-hints.
89 =item B<--export-area-snap>
91 Arrondi les dimensions de la zone à exporter aux valeurs entières supérieures en unités SVG utilisateur (px).
92 Si vous utilisez une résolution d'export de 90ppp et que vos objets sont alignés aux pixels afin de minimiser l'anti-crénelage, cette option permet de préserver cet alignement même si l'export se fait selon des boîtes de contour (avec --export-id ou --export-area-drawing) qui ne sont pas correctement alignées sur les pixels.
94 =item B<-b> I<COULEUR>, B<--export-background>=I<COULEUR>
96 Couleur de fond du PNG exporté.
97 Cette valeur peut être n'importe quelle chaîne de couleur supportée par le format SVG, par exmeple "#ff007f" ou "rgb(255, 0, 128)".
98 Si cette couleur n'est pas définie, la couleur de page définie dans Inkscape via la boîte de dialogue Préférences du document sera utilisée (enregistrée dans l'attribut pagecolor= de sodipodi:namedview).
100 =item B<-d> I<PPP>, B<--export-dpi>=I<PPP>
102 La résolution utilisée pour l'export en bitmap.
103 Elle est de 90 par défaut, correspondant à 1 pixel SVG (px, aussi appelé "unité utilisateur") s'exportant vers 1 pixel bitmap.
104 Cette valeur préempte la PPP enregistrée avec le document si la commande est utilisée avec --export-use-hints.
106 =item B<-e> I<NOMDEFICHIER>, B<--export-png>=I<NOMDEFICHIER>
108 Spécifie le nom de fichier pour l'export en PNG.
109 S'il existe déjà, il sera écrasé sans demande de confirmation.
111 =item B<-f> I<NOMDEFICHIER>, B<--file>=I<NOMDEFICHIER>
113 Ouvre le(s) document(s) spécifié(s).
114 La chaîne d'option peut être omise, c'est à dire que vous pouvez lister les noms de fichier sans -f.
116 =item B<-g>, B<--with-gui>
118 Tente d'utiliser l'interface graphique (sous Unix, utilise le serveur X, même si $DISPLAY n'est pas défini).
120 =item B<-h> I<HAUTEUR>, B<--export-height>=I<HAUTEUR>
122 Hauteur du bitmap généré en pixels.
123 Cette valeur préempte l'option --export-dpi (ou la PPP enregistrée avec le document si --export-use-hints est aussi utilisé).
125 =item B<-i> I<ID>, B<--export-id>=I<ID>
127 La valeur de l'attribut id de l'objet que vous voulez exporter depuis le document.
128 Par défaut la zone exportée est la boîte de contour de l'objet; vous pouvez préempter ce comportement en utilisant --export-area, --export-area-canvas, ou --export-area-drawing.
130 =item B<-j>, B<--export-id-only>
132 N'exporte que l'objet dont l'id est spécifiée avec avec l'option --export-id. Tout les autres objets seront cachés et n'apparaîtront pas dans le fichier exporté même s'ils chevauchent l'objet effectivement exporté. Cette option est ignorée si --export-id n'est pas aussi utilisé.
134 =item B<-l>, B<--export-plain-svg>=I<NOMDEFICHIER>
136 Exporte le(s) document(s) en SVG brut, sans espace de nom  sodipodi: ou inkscape: et sans métadonnées RDF.
138 =item B<-l>, B<--extension-directory>
140 Liste le contenu du répertoire d'extensions configuré en tant que tel par Inkscape, puis sort. 
141 Cette option est utilisée afin que les extensions externes utilisent la configuration originale générée à l'installation d'Inkscape.
143 =item B<-p> I<IMPRIMANTE>, B<--print>=I<IMPRIMANTE>
145 Imprime le(s) document(s) vers l'imprimante spécifiée en utilisant `lpr -P IMPRIMANTE'.
146 Vous pouvez aussi utiliser `| COMMANDE' pour spécifier un tube de commande différent, ou utiliser `> NOMDEFICHIER' pour écrire le résultat  PostScript dans un fichier au lieu de l'imprimer.
147 N'oubliez pas d'utiliser les guillemets appropriés pour votre shell, par exemple
148 inkscape --print='| ps2pdf - mondoc.pdf' mondoc.svg
150 =item B<-t>, B<--export-use-hints>
152 Utilise le nom de fichier et la PPP enregistrés avec l'objet exporté (uniquement si --export-id est spécifié).
153 Ces valeurs sont automatiquement spécifiées si vous exportez la sélection depuis Inkscape.
154 Donc, si par exemple, vous exportez la forme id="path231" en tant que /home/me/shape.png avec une résolution de 300 ppp depuis le document.svg en utilisant l'interface graphique d'Inkscape, et sauvez le document, vous pourrez réexporter plus tard cette forme vers le même fichier et avec la même résolution en utilisant simplement la commande :
155 inkscape -i path231 -t document.svg
157 Si vous utilisez --export-dpi, --export-width, ou --export-height avec cette option, la PPP enregistrée avec le document sera ignorée et la valeur fournie à la ligne de commande utilisée.
158 Si vous utilisez --export-png avec cette option, le nom de fichier enregistré avec le document sera ignoré et le nom de fichier fourni à la ligne de commande utilisé.
160 =item B<-w> I<LARGEUR>, B<--export-width>=I<LARGEUR>
162 Largeur du bitmap généré en pixels.
163 Cette valeur préempte l'option --export-dpi setting (ou la PPP enregistrée avec le document si --export-use-hints est aussi utilisé).
165 =item B<-y> I<VALEUR>, B<--export-background-opacity>=I<VALEUR>
167 Opacité du fond du PNG exporté.
168 Cela peut être une valeur entre 0.0 and 1.0 (0.0 : complètement transparent, 1.0 complètement opaque) ou supérieure à 1 et inférieure à 255 (255 : complètement opaque).
169 Si cette valeur n'est pas spécifiée et si l'option -b n'est pas utilisée, l'opacité de la page enregistrée avec le document (dans l'attribut inkscape:pageopacity= de sodipodi:namedview) sera utilisée.
170 Si cette valeur n'est pas spécifiée mais que l'option -b est utilisée, la valeur 255 (opacité complète) sera utilisée.
172 =item B<-P> I<NOMDEFICHIER>, B<--export-ps>=I<NOMDEFICHIER>
174 Exporte le(s) document(s) au format PostScript.
176 =item B<-E> I<NOMDEFICHIER>, B<--export-eps>=I<NOMDEFICHIER>
178 Exporte le(s) document(s) au format Encapsulated PostScript.
180 =item B<-T>, B<--export-text-to-path>
182 Convertit les objets texte en chemins lors de l'export, si applicable (ne fonctionne pour le moment qu'avec le format EPS).
184 =item B<-B>, B<--export-bbox-page>
186 Exporte les fichiers avec pour boîte de contour la page complète, si applicable (ne fonctionne pour le moment qu'avec le format EPS).
188 =item B<-I>, B<--query-id>
190 ID de l'objet dont les dimensions sont demandées. Si cette option n'est pas utilisée, la commande retournera les dimensions du dessin, pas de la page ou de la zone affichée.
192 =item B<-X>, B<--query-x>
194 Demande l'abscisse (coordonnée X) du dessin ou, si spécifié avec --query-id, de l'objet. La valeur retournée est en px (unité utilisateur SVG).
196 =item B<-Y>, B<--query-y>
198 Demande l'ordonnée (coordonnée Y) du dessin ou, si spécifié avec --query-id de l'objet. La valeur retournée est en px (unité utilisateur SVG).
200 =item B<-W>, B<--query-width>
202 Demande la largeur du dessin ou, si spécifié avec --query-id, de l'objet. La valeur retournée est en px (unité utilisateur SVG).
204 =item B<-H>, B<--query-height>
206 Demande la hauteur du dessin ou, si spécifié avec --query-id, de l'objet. La valeur retournée est en px (unité utilisateur SVG).
208 =item B<--vacuum-defs>
210 Supprime tous les éléments inutilisés de la section <lt>defs<gt> du fichier SVG.
211 Si cette option est utilisée avec --export-plain-svg, seul le fichier exporté sera affecté.
212 Si cette option est utilisée seule, le fichier spécifé sera modifié.
214 =item B<-z>, B<--without-gui>
216 Ne lance pas l'interface graphique (sous Unix, n'utilise pas le server X); ne traite les fichiers que depuis la console.
217 Ceci est présupposé pour les options -p, -e, -l et --vacuum-defs.
219 =item B<--g-fatal-warnings>
221 Elément des options standards GTK reconnues.  Ceci force Inkscape à quitter pour tout avertissement GTK.  Cette option est listée parce qu'elle est utilisée à des fins de débuggage.
223 =item B<--usage>
225 Affiche un bref message sur l'utilisation d'Inkscape.
227 =back
229 =head1 CONFIGURATION
231 Le fichier de configuration preferences.xml situé dans ~/.inkscape/ est utilisé pour personnaliser les préférences de l'utilisateur.
233 =over 8
235 =item B<interface>
237 Les éléments B<interface> du fichier de configuration sont utilisés pour définir les paramètres liés à l'interface graphique, comme l'état ouvert/fermé de certains éléments de l'interface graphique, etc.
239 =item B<group id="documents">
241 Le groupe documents permet de lister les fichiers récemment ouverts. Chaque document est listé avec son uri (chemin) et son nom.
243 =item B<group id="template">
245 Le groupe template est utilisé pour enregistrer les paramètres liés aux documents vides.
247 =item B<group id="tools">
249 Le groupe tools enregistre les préférences de l'utilisateur quant au style des différents outils (formes, plume calligraphique, etc.).
251 =item B<group id="palette">
253 Le groupe palette permet de définir les styles de pointillés. Ceci vous permet de définir des longueurs caractéristiques pour différents types de pointillés.
255 =item B<group id="dialogs">
257 Le groupe dialogs permet de retenir la position et la taille de toute boîte de dialogue de l'application, de sorte qu'ils s'ouvrent de nouveau à l'endroit où l'utilisateur les a placés lors de la dernière utilisation.
259 =item B<group id="printing">
261 Le groupe printing enregistre les différentes configurations d'impression. Chaque configuration est identifiée par un id. Les propriétés incluent I I<bitmap> (true : vrai / false : faux), I<resolution>, et I<destination>.
263 =item B<group id="options">
265 Le groupe options permet de retenir un certain nombre d'options choisies par l'utilisateur incluant  I<nudgeddistance> (distance d'accroche), I<rotationstep> (incrément de rotation), I<cursortolerance> (tolérance du curseur), et I<dragtolerance> (tolérance du cliquer-déplacer). 
267 =back
269 =head1 DIAGNOSTICS
271 Le programme retourne la valeur zéro après une utilisation réussie ou différente de zéro après un problème.
273 Des messages d'erreur et des avertissements divers peuvent être écrits vers STDERR ou STDOUT. Si le programme se comporte de façon erratique avec un fichier SVG particulier, ou se plante, il est parfois utile de chercher des indices dans ces messages. 
275 =head1 EXEMPLES
277 Bien qu'B<Inkscape> soit principalement conçu comme une application graphique, il peut aussi être utilisé depuis la ligne de commande pour certaines opérations SVG.
279 Imprimer un fichier SVG :
281     inkscape nomdefichier.svg -p '| lpr'
283 Exporter un fichier SVG en PNG avec la résolution par défaut de 90PPP (un pixel bitmap correspondant à une unité utilisateur SVG (px)) :
285     inkscape nomdefichier.svg --export-png=nomdefichier.png
287 Idem, mais en forçant les dimensions du fichier à 600x400 pixels :
289     inkscape nomdefichier.svg --export-png=nomdefichier.png -w600 -h400
291 Idem, mais en exportant le dessin (la boîte de contour de tous les objets), pas la page :
293     inkscape nomdefichier.svg --export-png=nomdefichier.png --export-area-drawing
295 Exporter en PNG l'objet id="text1555", en utilisant le nom de fichier et la résolution utilisés la dernière fois qu'il a été exporté depuis l'interface graphique :
297     inkscape nomdefichier.svg --export-id=text1555 --export-use-hints
299 Idem, mais en utilisant une résolution de 90ppp, en spécifiant un nom de fichier et en arrondissant la zone à exporter aux valeurs entières juste supérieures en unités utilisateur SVG (afin de préserver l'alignement des objets sur des pixels et minimiser l'anti-crénelage) :
301     inkscape nomdefichier.svg --export-id=text1555 --export-png=texte.png --export-snap-area
303 Convertir un document du format SVG Inkscape au format SVG brut :
305     inkscape nomdefichier1.svg --export-plain-svg=nomdefichier2.svg
307 Convertir un document SVG en EPS, en convertissant les textes en chemins :
309     inkscape nomdefichier.svg --export-eps=nomdefichier.eps --export-text-to-path
311 Demander la largeur de l'objet avec un id="text1555":
313     inkscape nomdefichier.svg --query-width --query-id text1555
316 =head1 ENVIRONEMENT
318 B<DISPLAY> pour obtenir l'hôte par défaut et le numéro d'affichage.
320 B<TMPDIR> pour définir le chemin par défaut du répertoire à utiliser pour stocker les fichier temporaires. Le répertoire doit exister.
322 =head1 THEMES
324 Vous pouvez remplacer le fichier d'icônes par défaut B<$PREFIX>/share/inkscape/icons/icons.svg en utilisant le répertoire B<$HOME>/.inkscape/icons/ .  Les icônes sont chargées par nom (ex. : I<fill_none.svg>) ou, si elles sont introuvables, depuis le fichier I<icons.svg>. Si une icône n'est pas trouvée dans l'un de ces emplacements, elle est chargée depuis l'emplacement par défaut du système.
326 Les icônes nécessaires sont chargées depuis les fichiers SVG par recherche de l'id SVG correspondant (Par exemple, pour charger l'icône "fill_none" depuis un fichier, le contenu identifié par l'id SVG "fill_none" est rendu en tant que cette icône, qu'il vienne du fichier I<fill_none.svg> ou du fichier I<icons.svg>).
328 =head1 FICHIERS
330 B<$HOME>/.inkscape/preferences.xml - Le fichier des préférences de l'utilisateur.
332 B<$HOME>/.inkscape/extensions.xml - Les programmes filtres utilisés par l'application.
334 B<$HOME>/.inkscape/icons/{*,icons}.svg - Des icônes pour modifier le thème.
336 =head1 AUTRES INFORMATIONS
338 L'endroit principal pour trouver des informations sur B<Inkscape> est http://www.inkscape.org/.  Le site web contient des liens vers d'autres éléments pertinents : documentation, didacticiels, manuel de l'utilisateur, exemples, archives des listes d'e-mail, la dernière version d'Inkscape et bien d'autres choses.
340 =head1 VOIR AUSSI
342 gimp(1), autotrace, potrace, frontline, ill2svg, rsvg(1), xfig(1), sodipodi, karbon14, dia(1X), batik.
344 Suite de tests de conformité SVG :  http://www.w3.org/Graphics/SVG/Test/
346 Validation de SVG :  http://jiggles.w3.org/svgvalidator/
348 I<Scalable Vector Graphics (SVG) 1.1 Specification>
349 I<W3C Recommendation 14 January 2003>
350 L<http://www.w3.org/TR/SVG11/>
352 I<Scalable Vector Graphics (SVG) 1.2 Specification>
353 I<W3C Working Draft 13 November 2003>
354 L<http://www.w3.org/TR/SVG12/>
356 I<SVG 1.1/1.2/2.0 Requirements>
357 I<W3C Working Draft 22 April 2002>
358 L<http://www.w3.org/TR/SVG2Reqs/>
360 I<Document Object Model (DOM): Level 2 Core>
361 I<Arnaud Le Hors et al editors, W3C>
362 L<http://www.w3.org/TR/DOM-Level-2-Core/>
365 =head1 NOTES SUR L'INTERFACE GRAPHIQUE
367 Pour vous familiariser avec l'utilisation de l'interface graphique d'Inkscape, consultez les didacticiels dans Aide > Didacticiels
369 Inkscape permet d'importer (Fichier > Importer) la plupart des formats bitmaps (PNG, BMP, JPG, XPM, GIF, etc.), du texte brut (nécessite Perl) et le format AI (documents Adobe Illustrator, uniquement jusqu'à la version 7; nécessite Perl).
371 Inkscape permet d'exporter (Fichier > Exporter) des images PNG 32-bits, mais aussi aux formats AI, PS, EPS, PDF (nécessite Ghostscript), DXF et plusieurs autres formats (via Fichier > Enregistrer sous). 
373 Inkscape supporte la pression et l'inclinaison du stylet d'une tablette graphique pour la largeur et l'angle de l'outil calligraphique.
375 Inkscape comporte une interface graphique pour le moteur de vectorisation de bitmaps Potrace (http://potrace.sf.net) qui est inclus dans Inkscape.
377 Inkscape peut utiliser des scripts externes (filtres depuis stdin vers stdout) représentés par des commandes dans le menu Effets. Un script peut avoir une interface graphique, sous forme de boîte de dialogue, permettant de définir différents paramètres et peut obtenir les IDs des objets sélectionnés sur lesquels agir depuis la ligne de commande. Inkscape est livré avec un assortiment d'effets écrits en Python dédiés principalement à la manipulation de chemin.
379 =head1 RACCOURCIS CLAVIER
381 Pour obtenir une liste complète des raccourcis clavier et souris, consultez le fichier doc/keys.html, ou utilisez la commande Clavier et souris dans le menu d'aide de l'interface graphique pour en afficher un tableau SVG.
383 =head1 BUGS
385 Beaucoup de bugs sont connus; veuillez, svp, consulter le site web pour consulter ceux qui ont déjà été rapportés et pour soumettre de nouveaux problèmes. Consultez aussi la section "Known Issues" des notes de votre version (dans le fichier `NEWS').
387 =head1 AUTEURS
389 Ce code doit son existence à un grand nombre de contributeurs tout au long de ses différentes incarnations. La liste qui suit est certainement incomplète, mais permet de reconnaître les nombreuses épaules sur lesquelles cette application s'est appuyée :
391 [% INCLUDE "AUTHORS" %]
393 Cette page de manuel a été créée par Bryce Harrington
394 E<lt>brycehar@bryceharrington.comE<gt>.
396 =head1 HISTORIQUE
398 Le code qui allait devenir Inkscape est né en 1999, avec le programme Gill, GNOME Illustrator, créé par Raph Levien. L'objectif défini pour Gill était de supporter complètement le format SVG. Raph a codé le modèle Postcript de courbes de Bézier, incluant le remplissage et le contour, les coiffes et raccords de lignes, le texte, etc. La page de Raph consacrée à Gill se trouve sur http://www.levien.com/svg/. Le travail sur Gill semble avoir diminué ou s'être arrêté en 2000.
400 L'incarnation suivante du code allait devenir le très populaire Sodipodi, mené par Lauris Kaplinski. Le code est devenu un outil d'illustration puissant après plusieurs années de travail, ajoutant plusieurs nouvelles fonctionnalités, le support multilingue, le portage sous Windows et d'autres systèmes d'exploitation et éliminant certaines dépendances.
402 Inkscape a été lancé en 2003 par quatre développeurs actifs de Sodipodi (Bryce Harrington, MenTaLguY, Nathan Hurst et Ted Gould), qui voulaient faire prendre une orientation différente au code en termes de focalisation sur la conformité SVG, aspect et fonctionnement de l'interface, et d'opportunités de développement ouvertes à plus de participants.
405 =head1 COPYRIGHT ET LICENSE
407 B<Copyright (C)> 1999-2006 des auteurs.
409 B<Inkscape> est un logiciel libre; vous pouvez le redistribuer et/ou le modifier selon les termes de la license GPL.  
412 =for comment
413 $Date$