INKSCAPE(1) | Inkscape Commands Manual | INKSCAPE(1) |
Inkscape - programme d'édition de SVG (Scalable Vector Graphics).
"inkscape [options] [fichier_1 fichier_2...]"
options :
-?, --help -V, --version --system-data-directory --user-data-directory -p, --pipe --pdf-page=PAGE --pdf-poppler --convert-dpi-method=MÉTHODE --no-convert-text-baseline-spacing -o, --export-filename=FICHIER --export-overwrite --export-type=TYPE[,TYPE]* -C, --export-area-page -D, --export-area-drawing -a, --export-area=x0:y0:x1:y1 --export-area-snap -d, --export-dpi=PPP -w, --export-width=LARGEUR -h, --export-height=HAUTEUR --export-margin=MARGE -i, --export-id=ID_OBJET[;ID_OBJET]* -j, --export-id-only -l, --export-plain-svg --export-ps-level=NIVEAU --export-pdf-version=VERSION -T, --export-text-to-path --export-latex --export-ignore-filters -t, --export-use-hints -b, --export-background=COULEUR -y, --export-background-opacity=VALEUR -I, --query-id=ID_OBJET[,ID_OBJET]* -S, --query-all -X, --query-x -Y, --query-y -W, --query-width -H, --query-height --vacuum-defs --select=ID_OBJET[,ID_OBJET]* --actions=ACTION(:ARG)[;ACTION(:ARG)]* --action-list --verb=VERBE[;VERBE]* --verb-list -g, --with-gui --batch-process --shell
Inkscape est un éditeur de dessin au format Scalable Vector Graphics (SVG) doté d'une interface graphique, offrant des possibilités similaires à Adobe Illustrator, CorelDraw, Xara Xtreme, etc. Les fonctionnalités d'Inkscape comprennent une gestion polyvalente des formes, le dessin à main levée et les courbes de Bézier, le texte multiligne, le texte suivant un chemin, la transparence alpha, les transformations affines, les remplissages par motif ou dégradé, l'édition de nœuds, l'import et l'export avec de nombreux formats incluant PNG et PDF, le groupement, les calques, les clones interactifs, et bien plus encore. L'interface est conçue pour être agréable et efficace pour les utilisateurs expérimentés, tout en restant conforme aux spécifications de GNOME de sorte que les utilisateurs familiers avec d'autres applications GNOME puissent rapidement prendre en main l'interface.
Le format SVG est un format XML normalisé par le W3C pour le dessin vectoriel en 2D. Il permet de définir des objets sur un dessin en utilisant des points, des chemins et des formes primitives. Les couleurs, les polices de caractères, l'épaisseur du contour et autres sont spécifiés comme attributs du style de ces objets. Le but, SVG étant un standard et ses fichiers du texte/XML, est de rendre possible l'utilisation de fichiers SVG pour un grand nombre de programmes et de pratiques.
Inkscape utilise le SVG comme format de document natif, et vise à devenir le programme de dessin vectoriel le plus respectueux du format SVG, disponible dans la communauté du logiciel libre.
L'emplacement du dossier des données système d'Inkscape peut être modifié avec la variable d'environnement INKSCAPE_DATADIR.
L'emplacement par défaut du dossier du profil utilisateur peut être modifié avec la variable d'environnement INKSCAPE_PROFILE_DIR.
L'utilisation du nom de fichier spécial « - » conduit Inkscape à envoyer les données de l'image vers la sortie standard (stdout).
Notez que PostScript n'accepte pas la transparence, et que tout objet transparent dans le SVG original sera automatiquement rastérisé. Les polices utilisées sont incorporées en tant que sous-ensemble. La zone d'exportation par défaut est la page ; vous pouvez la configurer comme étant le dessin avec --export-area-drawing.
Notez aussi que le format PDF préserve la transparence du document SVG original.
Si vous spécifiez plusieurs formats avec une liste d'objets séparés par des points-virgules, chacune sera exportée séparément. Dans ce cas, les fichiers d'export seront nommés ainsi : [fichier_d_entrée]_[ID].[format_d_export]
inkscape -i path231 -t document.svg
Si vous utilisez --export-dpi, --export-width ou --export-height avec cette option, alors la résolution enregistrée (en PPP) sera ignorée et la valeur fournie sur la ligne de commande sera utilisée. Si vous utilisez --export-filename avec cette option, le nom de fichier enregistré avec le document sera ignoré et le nom de fichier fourni sur la ligne de commande utilisé.
Si vous spécifiez une liste d'objets avec des valeurs séparées par des virgules, toute demande de géométrie (par ex. --query-x) retournera une liste de valeurs séparées par des virgules correspondant à la liste des objets indiqués dans --query-id.
Pour les actions seules, --batch-process doit être utilisé.
L'export peut être forcé à tout moment avec l'action export-do. Ceci permet d'effectuer plusieurs exports sur un seul fichier.
Notez que la commande --verb nécessite une interface graphique.
Une fois associée à --select, ces deux options fonctionnent de concert pour permettre aux scripts d'utiliser Inkscape en ligne de commande. Elles peuvent prendre de nombreux paramètres, apparaître sur la ligne de commande aussi souvent que nécessaire et sont exécutées dans l'ordre pour tous les documents spécifiés.
En mode shell, Inkscape attend une séquence d'actions (ou de verbes) en entrée. Elles seront traitées ligne par ligne, après avoir appuyé sur la touche Entrée. Il est possible (mais pas obligatoire) de mettre toutes les actions sur la même ligne.
L'exemple suivant ouvre un fichier et l'exporte dans deux formats différents, puis ouvre un autre fichier et exporte un seul objet :
file-open:fichier1.svg; export-type:pdf; export-do; export-type:png; export-do file-open:fichier2.svg; export-id:rect2; export-id-only; export-filename:rect_seul.svg; export-do
Le fichier de configuration principal se trouve dans ~/.config/Inkscape/preferences.xml ; il contient de nombreux types de paramétrages dont vous pouvez changer la valeur dans Inkscape (la plupart dans la boîte de dialogue Préférences d'Inkscape). Vous pouvez également ajouter des configurations spécifiques dans les sous-répertoires suivants :
$HOME/.config/Inkscape/extensions/ - extensions.
$HOME/.config/Inkscape/icons/ - icônes.
$HOME/.config/Inkscape/keys/ - configuration des raccourcis clavier.
$HOME/.config/Inkscape/templates/ - modèles de document.
Le programme retourne la valeur zéro après une utilisation réussie ou différente de zéro après un problème.
Des messages d'erreur et des avertissements divers peuvent être envoyés vers STDERR ou STDOUT. Si le programme se comporte de façon inconsistante avec un fichier SVG particulier ou plante, ces messages peuvent comporter des indices.
Bien qu'Inkscape soit principalement conçu comme une application graphique, il peut aussi être utilisé depuis la ligne de commande pour effectuer des opérations SVG.
Ouvrir un fichier SVG avec l'interface graphique :
inkscape fichier.svg
Exporter un fichier SVG en PNG avec la résolution par défaut de 96 ppp (une unité utilisateur SVG devient un pixel de l'image matricielle) :
inkscape --export-filename=fichier.png fichier.svg
Idem, mais en forçant les dimensions du fichier à 600×400 pixels :
inkscape --export-filename=fichier.png -w 600 -h 400 fichier.svg
Idem, mais en exportant le dessin (la boîte englobante de tous les objets), et pas la page :
inkscape --export-filename=fichier.png --export-area-drawing fichier.svg
Exporte deux fichiers différents, chacun dans quatre formats de fichiers distincts :
inkscape --export-type=png,ps,eps,pdf fichier1.svg fichier2.svg
Exporter en PNG l'objet avec 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 :
inkscape --export-id=text1555 --export-use-hints fichier.svg
Idem, mais en utilisant une résolution de 96 ppp, en spécifiant un nom de fichier et en arrondissant la zone à exporter aux valeurs entières les plus proches en unités utilisateur SVG (afin de préserver l'alignement des objets sur des pixels et minimiser l'anti-crénelage) :
inkscape --export-id=text1555 --export-filename=texte.png --export-area-snap fichier.svg
Convertir un document du format SVG Inkscape au format SVG simple :
inkscape --export-plain-svg --export-filename=fichier2.svg fichier1.svg
Convertir un document SVG en EPS, en convertissant les textes en chemins :
inkscape --export-filename=fichier.eps --export-text-to-path fichier.svg
Demander la largeur de l'objet avec id="text1555" :
inkscape --query-width --query-id=text1555 fichier.svg
Dupliquer les objets avec les id="path1555" et id="rect835", et appliquer une rotation de 90 degrés sur les duplicatas, enregistrer le SVG et quitter :
inkscape --select=path1555,rect835 --verb="EditDuplicate;ObjectRotate90;FileSave;FileQuit" fichier.svg
Sélectionner tous les objets avec l'étiquette ellipse, leur appliquer à tous une rotation de 30 degrés, enregistrer le fichier et quitter.
inkscape --actions="select-by-element:ellipse;transform-rotate:30;FileSave;FileClose" --batch-process filename.svg
Exporter l'objet avec l'ID MonTriangle avec un fond violet semi-transparent vers le fichier triangle_violet.png, et avec un fond rouge vers le fichier triangle_rouge.png.
inkscape --actions="export-id:MonTriangle; export-id-only; export-background:purple; export-background-opacity:0.5;export-filename:triangle_violet.png; export-do; export-background:red; export-background-opacity:1; export-filename:triangle_rouge.png" fichier.svg
Lire un fichier SVG depuis l'entrée standard (stdin) et l'exporter au format PDF :
cat fichier.svg | inkscape --pipe --export-filename=fichier.pdf
Exporter un SVG vers le format PNG, et l'envoyer vers la sortie standard (stdout), puis le convertir au format JPG avec le programme de conversion d'ImageMagick (convert) :
inkscape --export-type=png --export-filename=- fichier.svg | convert - fichier.jpg
Comme ci-dessus, mais en lisant à partir d'un tube (pipe) (--export-filename peut être omis dans ce cas)
cat fichier.svg | inkscape --pipe --export-type=png | convert - fichier.jpg
Pour plus de détails, voir aussi <http://wiki.inkscape.org/wiki/index.php/Environment_variables>
Vous pouvez remplacer le fichier d'icônes par défaut $PREFIX/share/inkscape/icons/icons.svg en utilisant le répertoire $HOME/.config/inkscape/icons/. Les icônes sont chargées par nom (ex. : fill_none.svg) ou, si elles sont introuvables, depuis le fichier 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.
Les icônes nécessaires sont chargées depuis les fichiers SVG en cherchant l'identifiant SVG correspondant (par exemple, pour charger l'icône « fill_none » depuis un fichier, le contenu identifié par l'identifiant SVG « fill_none » est rendu en tant que cette icône, qu'il vienne du fichier fill_none.svg ou du fichier icons.svg).
La référence principale où trouver des informations sur Inkscape est <https://www.inkscape.org/>. Le site web comporte des actualités, de la documentation, des didacticiels, des exemples, des archives des listes de diffusion, la dernière version du programme, les bases de données contenant les bogues et les demandes de fonctionnalité, des forums, et encore davantage.
potrace, cairo, rsvg, batik, ghostscript, pstoedit.
Suite de tests de conformité SVG : <https://www.w3.org/Graphics/SVG/WG/wiki/Test_Suite_Overview>
Validation de SVG : <https://validator.w3.org/>
Scalable Vector Graphics (SVG) 1.1 Specification W3C Recommendation 16 August 2011 <https://www.w3.org/TR/SVG11/>
Scalable Vector Graphics (SVG) 1.2 Specification W3C Working Draft 13 April 2005 <https://www.w3.org/TR/SVG12/>
Scalable Vector Graphics (SVG) 2 Specification W3C Candidate Recommendation 15 September 2016 <https://www.w3.org/TR/SVG2/>
Document Object Model (DOM): Level 2 Core W3C Recommendation 13 November 2000 <https://www.w3.org/TR/DOM-Level-2-Core/>
Pour vous familiariser avec l'utilisation de l'interface graphique d'Inkscape, consultez le manuel dans Aide > Manuel d'Inkscape et les didacticiels dans Aide > Didacticiels.
En plus du SVG, Inkscape peut importer (Fichier > Importer) la plupart des formats d'images matricielles (PNG, BMP, JPG, XPM, GIF, etc.), du texte brut (nécessite Perl), les formats PS et EPS (nécessite Ghostscript) et les formats PDF et AI (AI version 9.0 ou ultérieur).
Inkscape peut exporter (Fichier > Exporter une image PNG) des images PNG 32 bits, mais aussi aux formats AI, PS, EPS, PDF, DXF et plusieurs autres formats via Fichier > Enregistrer sous.
Inkscape gère la pression et l'inclinaison du stylet d'une tablette graphique pour la largeur, l'angle et la force d'action de plusieurs outils, dont la plume calligraphique.
Inkscape comporte une interface graphique pour le moteur de vectorisation d'image matricielle Potrace (<http://potrace.sf.net>) qui est inclus dans Inkscape.
Inkscape peut utiliser des scripts externes (filtres de stdin vers stdout) représentés par des commandes dans le menu Effets. Un script peut faire intervenir les boîtes de dialogue de l'interface graphique pour définir différents paramètres et peut obtenir les identifiants des objets sélectionnés sur lesquels agir depuis la ligne de commande. Inkscape est livré avec un assortiment d'effets écrits en Python.
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 Aide.
Beaucoup de bogues sont connus ; veuillez vous référer au site web (inkscape.org) pour vérifier ceux qui ont déjà été rapportés et pour soumettre de nouveaux problèmes. Consultez aussi la section « Known Issues » des notes de livraison de votre version (dans le fichier `NEWS').
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 gérer complètement le format SVG. Raph a codé le modèle PostScript 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.
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.
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, d'aspect et de fonctionnement de l'interface, et d'ouverture du développement à plus de participants. Le projet a progressé rapidement, gagnant de nombreux contributeurs très actifs et une multitude de fonctionnalités.
Beaucoup de travail a été depuis consacré à la stabilisation du code et à l'internationalisation. Le moteur de rendu hérité de Sodipodi comportait de nombreux cas limites mathématiques qui entraînaient des plantages lorsque le programme était utilisé à des fins inhabituelles ; ce moteur a alors été remplacé par Livarot qui, bien qu'imparfait, générait moins d'erreurs. Le projet a également adopté la bonne habitude de publier son code régulièrement, et encouragé les utilisateurs à tester des versions en développement du logiciel ; cela a aidé à identifier les nouveaux bogues rapidement, et à assurer qu'il était facile pour les utilisateurs de vérifier les correctifs. Inkscape a ainsi acquis une réputation de programme robuste et fiable.
En parallèle, des efforts ont été faits pour améliorer l'internationalisation et la localisation de l'interface, ce qui a apporté au projet de nouveaux contributeurs du monde entier.
Inkscape a eu un impact positif sur l'attractivité visuelle de l'Open Source en général, en offrant un outil pour créer et partager des icônes, des écrans d'accueil, de l'art pour le web, etc. D'une certaine façon, bien que n'étant qu'un « simple outil de dessin », Inkscape a joué un rôle important en rendant l'Open Source plus stimulant visuellement pour un plus large public.
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 repose :
Maximilian Albert, Joshua A. Andler, Tavmjong Bah, Pierre Barbry-Blot, Jean-François Barraud, Campbell Barton, Bill Baxter, John Beard, John Bintz, Arpad Biro, Nicholas Bishop, Joshua L. Blocher, Hanno Böck, Tomasz Boczkowski, Adrian Boguszewski, Henrik Bohre, Boldewyn, Daniel Borgmann, Bastien Bouclet, Hans Breuer, Gustav Broberg, Christopher Brown, Marcus Brubaker, Luca Bruno, Brynn, Nicu Buculei, Bulia Byak, Pierre Caclin, Ian Caldwell, Gail Carmichael, Ed Catmur, Chema Celorio, Jabiertxo Arraiza Cenoz, Johan Ceuppens, Zbigniew Chyla, Alexander Clausen, John Cliff, Kees Cook, Ben Cromwell, Jon Cruz, Aurélie De-Cooman, Kris De Gussem, Milosz Derezynski, Daniel Díaz, Bruno Dilly, Larry Doolittle, Nicolas Dufour, Tim Dwyer, Maxim V. Dziumanenko, Johan Engelen, Miklos Erdelyi, Ulf Erikson, Noé Falzon, Frank Felfe, Andrew Fitzsimon, Edward Flick, Marcin Floryan, Fred, Ben Fowler, Cedric Gemy, Steren Giannini, Olivier Gondouin, Ted Gould, Toine de Greef, Michael Grosberg, Bryce Harrington, Dale Harvey, Aurélio Adnauer Heckert, René de Hesselle, Carl Hetherington, Jos Hirth, Hannes Hochreiner, Thomas Holder, Joel Holdsworth, Christoffer Holmstedt, Alan Horkan, Karl Ove Hufthammer, Richard Hughes, Nathan Hurst, inductiveload, Thomas Ingham, Jean-Olivier Irisson, Bob Jamison, Ted Janeczko, Marc Jeanmougin, jEsuSdA, Lauris Kaplinski, Lynn Kerby, Niko Kiirala, James Kilfiger, Nikita Kitaev, Jason Kivlighn, Adrian Knoth, Krzysztof Kosiński, Petr Kovar, Benoît Lavorata, Alex Leone, Julien Leray, Raph Levien, Diederik van Lierop, Nicklas Lindgren, Vitaly Lipatov, Ivan Louette, Fernando Lucchesi Bastos Jurema, Pierre-Antoine Marc, Aurel-Aimé Marmion, Colin Marquardt, Craig Marshall, Ivan Masár, Dmitry G. Mastrukov, David Mathog, Matiphas, Patrick McDermott, Michael Meeks, Federico Mena, MenTaLguY, Aubanel Monnier, Vincent Montagne, Tim Mooney, Derek P. Moore, Chris Morgan, Peter Moulder, Jörg Müller, Yukihiro Nakai, Victor Navez, Christian Neumair, Nick, Andreas Nilsson, Mitsuru Oka, Vinícius dos Santos Oliveira, Martin Owens, Alvin Penner, Matthew Petroff, Jon Phillips, Zdenko Podobny, Alexandre Prokoudine, Jean-René Reinhard, Alexey Remizov, Frederic Rodrigo, Hugo Rodrigues, Juarez Rudsatz, Xavier Conde Rueda, Felipe Corrêa da Silva Sanches, Christian Schaller, Marco Scholten, Tom von Schwerdtner, Markus Schwienbacher, Danilo Šegan, Abhishek Sharma, Tim Sheridan, Shivaken, Michael Sloan, John Smith, Sandra Snan, Boštjan Špetič, Aaron Spike, Kaushik Sridharan, Ralf Stephan, Dariusz Stojek, Patrick Storz, Martin Sucha, ~suv, Pat Suwalski, Adib Taraben, Parcly Taxel, Hugh Tebby, Jonas Termeau, David Turner, Andre Twupack, Aleksandar Urošević, Alex Valavanis, Joakim Verona, Lucas Vieites, Daniel Wagenaar, Liam P. White, Sebastian Wüst, Michael Wybrow, Gellule Xg, Daniel Yacob, David Yip, Masatake Yamato, Moritz Eberl, Sebastian Faubel
Copyright (C) 1999-2020 par les auteurs.
Inkscape est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de la licence GPL version 3 ou ultérieure.
2021-04-14 | 1.0.2 |