inkscape.pod revision f3462bff432feef773f99bab7d5ae208d077ddb1
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisInkscape - an SVG (Scalable Vector Graphics) editing program.
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis=head1 SYNOPSIS
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisC<inkscape [options] [filename ...]>
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -f, --file=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -e, --export-png=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -a, --export-area=x0:y0:x1:y1
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -C, --export-area-page
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -D, --export-area-drawing
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --export-area-snap
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -i, --export-id=ID
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -j, --export-id-only
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -t, --export-use-hints
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -b, --export-background=COLOR
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -y, --export-background-opacity=VALUE
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -d, --export-dpi=DPI
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -w, --export-width=WIDTH
ddc0e0b53c661f6e439e3b7072b3ef353eadb4afRichard Lowe -h, --export-height=HEIGHT
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -P, --export-ps=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -E, --export-eps=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -A, --export-pdf=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --export-latex
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -T, --export-text-to-path
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --export-ignore-filters
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -l, --export-plain-svg=FILENAME
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -p, --print=PRINTER
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -I, --query-id=ID
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -W, --query-width
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -H, --query-height
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -S, --query-all
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -x, --extension-directory
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --verb=VERB-ID
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --select=OBJECT-ID
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -g, --with-gui
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis -z, --without-gui
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis --g-fatal-warnings
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis=head1 DESCRIPTION
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisB<Inkscape> is a GUI editor for B<Scalable Vector Graphics (SVG)> format
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisdrawing files, with capabilities similar to B<Adobe Illustrator>,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisB<CorelDraw>, B<Xara Xtreme>, etc. Inkscape features include versatile
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisshapes, bezier paths, freehand drawing, multi-line text, text on path,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisalpha blending, arbitrary affine transforms, gradient and pattern fills, node
61ec6b12089c560a32ebd9efdbb057ff92665e60Gordon Rossediting, many export and import formats including PNG and PDF, grouping,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtislayers, live clones, and a lot more. The interface is
61ec6b12089c560a32ebd9efdbb057ff92665e60Gordon Rossdesigned to be comfortable and efficient for skilled users, while
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisremaining conformant to B<GNOME> standards so that users familiar with
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisother GNOME applications can learn its interface rapidly.
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisB<SVG> is a W3C standard XML format for 2D vector drawing. It allows
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisdefining objects in the drawing using points, paths, and primitive
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisshapes. Colors, fonts, stroke width, and so forth are specified as
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis`style' attributes to these objects. The intent is that since SVG is a
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstandard, and since its files are text/xml, it will be
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtispossible to use SVG files in a sizeable number of programs and for a
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtiswide range of uses.
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisB<Inkscape> uses SVG as its native document format, and has the goal of
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisbecoming the most fully compliant drawing program for SVG files
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisavailable in the Open Source community.
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis=item B<-?>, B<--help>
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr JasiukajtisShow help message
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis=item B<-V>, B<--version>
In PNG, PDF, PS, and EPS export, exported area is the drawing (not page), i.e. the bounding box
For PNG export, snap the export area outwards to the nearest integer SVG user unit (px) values. If you are using the
default export resolution of 90 dpi and your graphics are pixel-snapped to minimize antialiasing, this switch
then the page color set in Inkscape in the Document Options dialog will be used (stored in the pagecolor= attribute of sodipodi:namedview).
Option string may be omitted, i.e. you can list the filenames without -f.
Only export to PNG the object whose id is given in --export-id. All other objects are hidden and won't
Without --export-id, this option is ignored. For PDF export, this is the default, so this option has no effect.
Export document(s) to plain SVG format, without sodipodi: or inkscape: namespaces and without RDF metadata.
Remember to do appropriate quoting for your shell, e.g.
So, for example, if you export a shape with id="path231" as /home/me/shape.png at 300 dpi from document.svg using Inkscape GUI, and save the document,
then later you will be able to reexport that shape to the same file with the same resolution simply with
inkscape -i path231 -t document.svg
then the page opacity set in Inkscape in the Document Options dialog will be used (stored in the inkscape:pageopacity= attribute of sodipodi:namedview).
Export document(s) to PostScript format. Note that PostScript does not support transparency, so any transparent objects in the original SVG will be automatically rasterized. Used fonts are subset and embedded. The default export area is page; you can set it to drawing by --export-area-drawing. You can
Export document(s) to Encapsulated PostScript format. Note that PostScript does not support transparency, so any transparent objects in the original SVG will be automatically rasterized. Used fonts are subset and embedded. The default export area is drawing; you can set it to page, however see --export-area-page for applicable limitation. You can specify --export-id to export a single object (all other are hidden).
(e.g. as specified by --export-pdf) and a LaTeX file. Text will not be output in
the PDF/PS/EPS file, but instead will appear in the LaTeX file. This LaTeX file
Export filtered objects (e.g. those with blur) as vectors, ignoring the filters (for PS, EPS, and PDF export).
By default, all filtered objects are rasterized at --export-dpi (default 90 dpi), preserving the appearance.
return the dimensions of the drawing (i.e. all document objects), not the page or viewbox
Query the X coordinate of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
Query the Y coordinate of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
Query the width of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
Query the height of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
The main configuration file is located in ~/.config/inkscape/preferences.xml; it stores
B<$HOME>/.config/inkscape/extensions/ - extension effects.
B<$HOME>/.config/inkscape/icons/ - icons.
B<$HOME>/.config/inkscape/keys/ - keyboard maps.
B<$HOME>/.config/inkscape/templates/ - new file templates.
inkscape filename.svg
inkscape filename.svg -p '| lpr'
Export an SVG file into PNG with the default resolution of 90dpi (one SVG user unit translates to one bitmap pixel):
inkscape filename.svg --export-id=text1555 --export-use-hints
inkscape filename.svg --query-width --query-id text1555
inkscape filename.svg --select=path1555 --verb=EditDuplicate --verb=ObjectRotate90 --verb=FileSave --verb=FileClose
B<$PREFIX>/share/inkscape/icons/icons.svg file, the directory
B<$HOME>/.config/inkscape/icons/ is used. Icons are loaded by name
http://www.inkscape.org/. The website has news, documentation,
SVG compliance test suite: http://www.w3.org/Graphics/SVG/Test/
SVG validator: http://jiggles.w3.org/svgvalidator/
(http://potrace.sf.net) which is embedded into Inkscape.
To get a complete list of keyboard and mouse shortcuts, view doc/keys.html, or use the Keys and Mouse command in Help menu.
Many bugs are known; please refer to the website (inkscape.org) for reviewing the reported ones and to
Raph's Gill page is at http://www.levien.com/svg/. Work on Gill appears
B<Inkscape> is free software; you can redistribute it and/or modify it