inkscape.fr.pod

   1
   2 =head1 NOM
   3
   4 Inkscape - programme d'édition SVG (Scalable Vector Graphics).
   5
   6 =head1 SYNOPSIS
   7
   8 C<inkscape [options] [nom_de_fichier ...]>
   9
  10 options:
  11
  12     -?, --help
  13         --usage
  14     -V, --version
  15
  16     -f, --file=NOM_DE_FICHIER
  17     -s, --slideshow
  18
  19     -e, --export-png=NOM_DE_FICHIER
  20     -a, --export-area=x0:y0:x1:y1
  21     -D, --export-area-drawing
  22     -i, --export-id=ID
  23     -j, --export-id-only
  24     -t, --export-use-hints
  25     -b, --export-background=COULEUR
  26     -y, --export-background-opacity=VALEUR
  27     -d, --export-dpi=PPP
  28     -w, --export-width=LARGEUR
  29     -h, --export-height=HAUTEUR
  30
  31     -P, --export-ps=NOM_DE_FICHIER
  32     -E, --export-eps=NOM_DE_FICHIER
  33     -T, --export-text-to-path
  34     -B, --export-bbox-page
  35
  36     -l, --export-plain-svg=NOM_DE_FICHIER
  37
  38     -I, --query-id=ID
  39     -X, --query-x
  40     -Y, --query-y
  41     -W, --query-width
  42     -H, --query-height
  43
  44     -x, --extension-directory
  45
  46     -p, --print=IMPRIMANTE
  47
  48     -g, --with-gui
  49     -z, --without-gui
  50
  51         --vacuum-defs
  52
  53         --g-fatal-warnings
  54
  55 =head1 DESCRIPTION
  56
  57 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. 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.
  58
  59 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.
  60
  61 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.
  62
  63
  64 =head1 OPTIONS
  65
  66 =over 8
  67
  68 =item B<-?>, B<--help>
  69
  70 Affiche un message d'aide.
  71
  72 =item B<-V>, B<--version>
  73
  74 Affiche la version d'Inkscape et la date de compilation.
  75
  76 =item B<-a> I<x0:y0:x1:y1>, B<--export-area>=I<x0:y0:x1:y1>
  77
  78 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.
  79
  80 =item B<-D>, B<--export-area-drawing>
  81
  82 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.
  83
  84 =item B<-b> I<COULEUR>, B<--export-background>=I<COULEUR>
  85
  86 Couleur de fond du PNG exporté.
  87 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)".
  88 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 l'espace de nom  sodipodi:namedview).
  89
  90 =item B<-d> I<PPP>, B<--export-dpi>=I<PPP>
  91
  92 La résolution utilisée pour l'export en bitmap.
  93 Elle est de 90 par défaut, correspondant à 1 SVG pixel (px, aussi appelé "unité utilisateur") s'exportant vers 1 pixel bitmap.
  94 Cette valeur préempte la PPP enregistrée avec le document si la commande est utilisée avec --export-use-hints.
  95
  96 =item B<-e> I<NOM_DE_FICHIER>, B<--export-png>=I<NOM_DE_FICHIER>
  97
  98 Spécifie le nom de fichier pour l'export en PNG.
  99 S'il existe déjà, il sera écrasé sans demande de confirmation.
 100
 101 =item B<-f> I<NOM_DE_FICHIER>, B<--file>=I<NOM_DE_FICHIER>
 102
 103 Ouvre le(s) document(s) spécifié(s).
 104 La chaîne optionnelle peut être omise, c'est à dire que vous pouvez lister les noms de fichier sans -f.
 105
 106 =item B<-g>, B<--with-gui>
 107
 108 Tente d'utiliser l'interface graphique (sous Unix, utiliser le serveur X, même si $DISPLAY n'est pas défini).
 109
 110 =item B<-h> I<HAUTEUR>, B<--export-height>=I<HAUTEUR>
 111
 112 Hauteur du bitmap généré en pixels.
 113 Cette valeur préempte l'option --export-dpi (ou la PPP enregistrée avec le document si --export-use-hints est aussi utilisé).
 114
 115 =item B<-i> I<ID>, B<--export-id>=I<ID>
 116
 117 La valeur de l'attribut id de l'objet que vous voulez exporter depuis le document.
 118 La boîte de contour de l'objet est exportée; donc avec cette option, --export-area est ignoré.
 119
 120 =item B<-j>, B<--export-id-only>
 121
 122 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é.
 123
 124 =item B<-l>, B<--export-plain-svg>=I<NOM_DE_FICHIER>
 125
 126 Exporte le(s) document(s) en SVG brut, sans espace de nom  sodipodi: ou inkscape: et sans métadonnées RDF.
 127
 128 =item B<-l>, B<--extension-directory>
 129
 130 Liste le contenu du répertoire d'extensions configuré en tant que tel par Inkscape, puis sort. Cette option est utilisée afin que les extensions externes utilisent la configuration originale générée à l'installation d'Inkscape.
 131
 132 =item B<-p> I<IMPRIMANTE>, B<--print>=I<IMPRIMANTE>
 133
 134 Imprime le(s) document(s) vers l'imprimante spécifiée en utilisant `lpr -P PRINTER'.
 135 Vous pouvez aussi utiliser `| COMMAND' pour spécifier un tube de commande différent, ou utiliser `> FILENAME' pour écrire le résultat  PostScript dans un fichier au lieu de l'imprimer.
 136 N'oubliez pas d'utiliser les guillemets appropriés pour votre shell, ex.
 137 inkscape --print='| ps2pdf - mydoc.pdf' mydoc.svg
 138
 139 =item B<-s>, B<--slideshow>
 140
 141 Affiche les fichiers spécifiés un par un, passant au suivant à chaque évènement clavier ou souris.
 142
 143 =item B<-t>, B<--export-use-hints>
 144
 145 Utilise le nom de fichier et la PPP enregistrés avec l'objet exporté (uniquement si --export-id est spécifié).
 146 Ces valeurs sont automatiquement spécifiées si vous exportez la sélection depuis Inkscape.
 147 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 :
 148 inkscape -i path231 -t document.svg
 149
 150 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.
 151 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é.
 152
 153 =item B<-w> I<LARGEUR>, B<--export-width>=I<LARGEUR>
 154
 155 Largeur du bitmap généré en pixels.
 156 Cette valeur préempte l'option --export-dpi setting (ou la PPP enregistrée avec le document si --export-use-hints est aussi utilisé).
 157
 158 =item B<-y> I<VALEUR>, B<--export-background-opacity>=I<VALEUR>
 159
 160 Opacité du fond du PNG exporté.
 161 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).
 162 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 l'espace de nom sodipodi:namedview) sera utilisée.
 163 Si cette valeur n'est pas spécifiée et l'option -b utilisé, la valeur 255 (opacité complète) sera utilisée.
 164
 165 =item B<-P> I<NOM_DE_FICHIER>, B<--export-ps>=I<NOM_DE_FICHIER>
 166
 167 Exporte le(s) document(s) au format PostScript.
 168
 169 =item B<-E> I<NOM_DE_FICHIER>, B<--export-eps>=I<NOM_DE_FICHIER>
 170
 171 Exporte le(s) document(s) au format Encapsulated PostScript.
 172
 173 =item B<-T>, B<--export-text-to-path>
 174
 175 Convertit les objets texte en chemins lors de l'export, si applicable (ne fonctionne pour le moment qu'avec le format EPS).
 176
 177 =item B<-B>, B<--export-bbox-page>
 178
 179 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).
 180
 181 =item B<-I>, B<--query-id>
 182
 183 ID de l'objet dont les dimensions sont demandées. Si cette option n'est pas utilisée, les demandes retourneront les dimensions du dessin, pas de la page ou de la zone affichée.
 184
 185 =item B<-X>, B<--query-x>
 186
 187 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).
 188
 189 =item B<-Y>, B<--query-y>
 190
 191 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).
 192
 193 =item B<-W>, B<--query-width>
 194
 195 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).
 196
 197 =item B<-H>, B<--query-height>
 198
 199 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).
 200
 201 =item B<--vacuum-defs>
 202
 203 Supprime tous les items inutilisés de la section <lt>defs<gt> du fichier SVG.
 204 Cette option n'a pas d'effet propre, mais est très utile quand elle est utilisée conjointement avec l'option -l.
 205
 206 =item B<-z>, B<--without-gui>
 207
 208 Ne lance pas l'interface graphique (sous Unix, n'utilise pas le server X); ne traite les fichiers que depuis la console.
 209 Ceci est présupposé pour les options -p, -e, et -l.
 210
 211 =item B<--g-fatal-warnings>
 212
 213 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.
 214
 215 =item B<--usage>
 216
 217 Affiche un bref message sur l'utilisation d'Inkscape.
 218
 219 =back
 220
 221 =head1 RACCOURCIS CLAVIER
 222
 223 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.
 224
 225 =head1 CONFIGURATION
 226
 227 Le fichier de configuration preferences.xml situé dans ~/.inkscape/ est utilisé pour personnaliser les préférences de l'utilisateur.
 228
 229 =over 8
 230
 231 =item B<interface>
 232
 233 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, etc.
 234
 235 =item B<group id="documents">
 236
 237 Le groupe documents permet de contenir la liste des fichiers récemment ouverts. Chaque document listé indique son uri (chemin) et nom.
 238
 239 =item B<group id="template">
 240
 241 Le groupe template est utilisé pour enregistrer les paramètres liés aux documents vides.
 242
 243 =item B<group id="tools">
 244
 245 Le groupe tools enregistre les les préférences de l'utilisateur quant au style des différents outils (formes, plume calligraphique, etc.).
 246
 247 =item B<group id="palette">
 248
 249 Le groupe palette permet de définir les styles de pointillés.
 250
 251 =item B<group id="dialogs">
 252
 253 Le groupe dialogs permet de retenir la position et la taille de toute boîte de dialogue de l'application, de sorte qu'ils se lancent à l'endroit où l'utilisateur les a placés lors de la dernière utilisation.
 254
 255 =item B<group id="printing">
 256
 257 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>.
 258
 259 =item B<group id="options">
 260
 261 Le groupe options permet de retenir un certain nombre d'options choisies par l'utilisateur incluant  I<nudgeddistance> (incrément), I<rotationstep> (incrément de rotation), I<cursortolerance> (tolérance du curseur), et I<dragtolerance> (tolérance du cliquer-déplacer).
 262
 263 =back
 264
 265 =head1 DIAGNOSTICS
 266
 267 Le programme retourne la valeur zéro après une utilisation réussie ou différente de zéro après un problème.
 268
 269 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. Il peuvent, par exemple, indiquer qu'un fichier SVG donné contient des éléments ou des attributs non encore supportés par le logiciel.
 270
 271 =head1 EXEMPLES
 272
 273 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.
 274
 275 Imprimer un fichier SVG :
 276
 277     inkscape nom_de_fichier.svg -p '| lpr'
 278
 279 Exporter un fichier SVG en PNG :
 280
 281     inkscape nom_de_fichier.svg --export-png=nom_de_fichier.png -w600 -h400
 282
 283 Convertir un document du format SVG Inkscape au format SVG brut :
 284
 285     inkscape nom_de_fichier1.svg --export-plain-svg=nom_de_fichier2.svg
 286
 287 Convertir un document SVG en EPS, en convertissant les textes en chemins :
 288
 289     inkscape nom_de_fichier.svg --export-eps=nom_de_fichier.eps --export-text-to-path
 290
 291 Demander la largeur de l'objet avec un id="text1555":
 292
 293     inkscape nom_de_fichier.svg --query-width --query-id text1555
 294
 295
 296 =head1 ENVIRONEMENT
 297
 298 B<DISPLAY> pour obtenir l'hôte par défaut et le numéro d'affichage.
 299
 300 B<TMPDIR> pour définir le chemin par défaut du répertoire à utiliser pour stocker les fichier temporaires. Ce répertoire est nécessaire.
 301
 302 =head1 THEMES
 303
 304 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, quand 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.
 305
 306 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 I<icons.svg>).
 307
 308 =head1 FICHIERS
 309
 310 B<$HOME>/.inkscape/preferences.xml - Le fichier des préférences de l'utilisateur.
 311
 312 B<$HOME>/.inkscape/extensions.xml - Les programmes filtres utilisés par l'application.
 313
 314 B<$HOME>/.inkscape/icons/{*,icons}.svg - Des icônes pour modifier le thème.
 315
 316 =head1 AUTRES INFORMATIONS
 317
 318 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.
 319
 320 =head1 VOIR AUSSI
 321
 322 gimp(1), autotrace, potrace, frontline, ill2svg, rsvg(1), xfig(1), sodipodi, karbon14, dia(1X), batik.
 323
 324 Suite de tests de conformité SVG :  http://www.w3.org/Graphics/SVG/Test/
 325
 326 Validation de SVG :  http://jiggles.w3.org/svgvalidator/
 327
 328 I<Scalable Vector Graphics (SVG) 1.1 Specification>
 329 I<W3C Recommendation 14 January 2003>
 330 L<http://www.w3.org/TR/SVG11/>
 331
 332 I<Scalable Vector Graphics (SVG) 1.2 Specification>
 333 I<W3C Working Draft 13 November 2003>
 334 L<http://www.w3.org/TR/SVG12/>
 335
 336 I<SVG 1.1/1.2/2.0 Requirements>
 337 I<W3C Working Draft 22 April 2002>
 338 L<http://www.w3.org/TR/SVG2Reqs/>
 339
 340 I<Document Object Model (DOM): Level 2 Core>
 341 I<Arnaud Le Hors et al editors, W3C>
 342 L<http://www.w3.org/TR/DOM-Level-2-Core/>
 343
 344
 345 =head1 NOTES
 346
 347 Ctrl, Maj et Alt modifient le comportement des actions de cliquer et de cliquer-déplacer pour la plupart des outils. La barre d'état affiche des conseils utiles à ce sujet.
 348
 349 Pour faire tourner un objet, cliquer dessus avec l'outil sélecteur afin de le sélectionner,puis cliquer dessus à nouveau afin d'activer les poignées de rotation.
 350
 351 La commande importer fonctionne avec la plupart des formats bitmap (PNG, BMP, JPG, XPM, GIF etc.) et avec le format vectoriel SVG.
 352 La commande ouvrir ne gère que les fichiers SVG.
 353
 354 Une tablette graphique (Wacom) peut fonctionner avec Inkscape si elle est configurée pour se comporter en tant que périphérique de pointage normal. Nous ne supportons pas encore les fonctionnalités pression/angle ou autres spécifités.
 355
 356 Inkscape fonctionne dès l'installation avec le serveur X d'Apple, mais pour une utilisation sous XFree86, vous devrez activer l'option "SendCoreEvents". Tout ne semble pas encore marcher aussi bien sous Windows.
 357
 358
 359 =head1 BUGS
 360
 361 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. Voici quelques contournements :
 362
 363 Lors de l'import de SVG généré par ill2svg, tous les chemins sont habituellement groupés. Dégroupez-les manuellement.
 364
 365 Si vous utilisez des dégradés et étirez l'icône du fichier sauvé dans Nautilus, vous remarquerez que les dégradés ne sont pas bien rendus. Il s'agit d'un problème connu de Nautilus/RSVG et qui peut être contourné en spécifiant le dégradé dans 'l'espace utilisateur' dans l'éditeur de dégradé.
 366
 367 Consultez aussi la section "Known Issues" des notes de votre version (dans le fichier `NEWS').
 368
 369 =head1 AUTEURS
 370
 371 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 :
 372
 373 [% INCLUDE "AUTHORS" %]
 374
 375 Cette page de manuel a été créée par Bryce Harrington
 376 E<lt>brycehar@bryceharrington.comE<gt>.
 377
 378 =head1 HISTORIQUE
 379
 380 Le code qui allait devenir Inkscape est né en 1999, avec le programme Gill, GNOME Illustrator, créé par Raph Levien. L'objectif clair de 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.
 381
 382 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.
 383
 384 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.
 385
 386
 387 =head1 COPYRIGHT ET LICENSE
 388
 389 B<Copyright (C)> 1999-2005 des auteurs.
 390
 391 B<Inkscape> est un logiciel libre; vous pouvez le redistribuer et/ou le modifier selon les termes de la license GPL.
 392
 393
 394 =for comment
 395 $Date: 2005/04/21 19:39:52 $