diff --git a/inkscape.pod b/inkscape.pod
index f8495acaef419057bb7f974fb57baa12976b695b..5870d99cd5690e6a9d4e1599ce6a6fe9ecb24b87 100644 (file)
--- a/inkscape.pod
+++ b/inkscape.pod
options:
options:
- -?, --help
+ -?, --help
--usage
-V, --version
-f, --file=FILENAME
--usage
-V, --version
-f, --file=FILENAME
- -s, --slideshow
-e, --export-png=FILENAME
-a, --export-area=x0:y0:x1:y1
-e, --export-png=FILENAME
-a, --export-area=x0:y0:x1:y1
-T, --export-text-to-path
-B, --export-bbox-page
-T, --export-text-to-path
-B, --export-bbox-page
+ -F, --export-embed-fonts
-l, --export-plain-svg=FILENAME
-l, --export-plain-svg=FILENAME
-Y, --query-y
-W, --query-width
-H, --query-height
-Y, --query-y
-W, --query-width
-H, --query-height
+ -S, --query-all
-x, --extension-directory
-x, --extension-directory
+ --verb-list
+ --verb=VERB-ID
+ --select=OBJECT-ID
+
-p, --print=PRINTER
-g, --with-gui
-p, --print=PRINTER
-g, --with-gui
=item B<-C>, B<--export-area-canvas>
=item B<-C>, B<--export-area-canvas>
-In PNG export, exported area is the entire canvas (page). Usually this is the default, so you
+In PNG and PDF export, exported area is the entire canvas (page). Usually this is the default, so you
don't need to specify this unless you are using --export-id to export a specific object.
=item B<-D>, B<--export-area-drawing>
don't need to specify this unless you are using --export-id to export a specific object.
=item B<-D>, B<--export-area-drawing>
-In PNG export, exported area is the entire drawing (not canvas), i.e. the bounding box
+In PNG and PDF export, exported area is the entire drawing (not canvas), i.e. the bounding box
of all objects of the document. With this option, the exported image will
of all objects of the document. With this option, the exported image will
-display just the visible objects of the document without margins or cropping. Can be
+display just the visible objects of the document without margins or cropping. For PNG, can be
used in combination wtih --export-use-hints.
=item B<--export-area-snap>
used in combination wtih --export-use-hints.
=item B<--export-area-snap>
-Snap the export area outwards to the nearest integer SVG user unit (px) values. If you are using the
+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 90dpi and your graphics are pixel-snapped to minimize antialiasing, this switch
allows you to preserve this alignment even if you are exporting some object's bounding
box (with --export-id or --export-area-drawing) which is itself not pixel-aligned.
default export resolution of 90dpi and your graphics are pixel-snapped to minimize antialiasing, this switch
allows you to preserve this alignment even if you are exporting some object's bounding
box (with --export-id or --export-area-drawing) which is itself not pixel-aligned.
=item B<-d> I<DPI>, B<--export-dpi>=I<DPI>
=item B<-d> I<DPI>, B<--export-dpi>=I<DPI>
-The resolution used for bitmap export.
+The resolution used for PNG export.
The default is 90, which corresponds to 1 SVG user unit
(px, also called "user unit") exporting to 1 bitmap pixel.
This value overrides the DPI hint if used with --export-use-hints.
The default is 90, which corresponds to 1 SVG user unit
(px, also called "user unit") exporting to 1 bitmap pixel.
This value overrides the DPI hint if used with --export-use-hints.
@@ -153,25 +158,50 @@ This value overrides the --export-dpi setting (or the DPI hint if used with --ex
=item B<-i> I<ID>, B<--export-id>=I<ID>
=item B<-i> I<ID>, B<--export-id>=I<ID>
-The id attribute value of the object that you want to export from the document. By
+For PNG and PDF export, the id attribute value of the object that you want
+to export from the document. By
default the exported area is the bounding box of the object; you can override this using
--export-area, --export-area-canvas, or --export-area-drawing.
=item B<-j>, B<--export-id-only>
default the exported area is the bounding box of the object; you can override this using
--export-area, --export-area-canvas, or --export-area-drawing.
=item B<-j>, B<--export-id-only>
-Only export the object whose id is given in --export-id. All other objects are hidden and won't
-show in export even if they overlay the exported object. Without --export-id, this option is ignored.
+Only export to PNG the object whose id is given in --export-id. All other objects are hidden and won't
+show in export even if they overlay the exported object.
+Without --export-id, this option is ignored. For PDF export, this is the default, so this option has no effect.
=item B<-l>, B<--export-plain-svg>=I<FILENAME>
Export document(s) to plain SVG format, without sodipodi: or inkscape: namespaces and without RDF metadata.
=item B<-l>, B<--export-plain-svg>=I<FILENAME>
Export document(s) to plain SVG format, without sodipodi: or inkscape: namespaces and without RDF metadata.
-=item B<-l>, B<--extension-directory>
+=item B<-x>, B<--extension-directory>
Lists the current extension directory that Inkscape is configured to use and
then exits. This is used for external extension to use the same configuration
as the original Inkscape installation.
Lists the current extension directory that Inkscape is configured to use and
then exits. This is used for external extension to use the same configuration
as the original Inkscape installation.
+=item B<--verb-list>
+
+Lists all the verbs that are available in Inkscape by ID. This ID can be
+used in defining keymaps or menus. It can also be used with the --verb
+command line option.
+
+=item B<--verb>=I<VERB-ID>, B<--select>=I<OBJECT-ID>
+
+These two options work together to provide some basic scripting for
+Inkscape from the command line. They both can occur as many times as
+needed on the command line and are executed in order on every document that
+is specified.
+
+The --verb command will execute a specific verb as if it
+was called from a menu or button. Dialogs will appear if that is part
+of the verb. To get a list of the verb IDs available, use the --verb-list
+command line option.
+
+The --select command will cause objects that have the ID
+specified to be selected. This allows various verbs to act upon them. To
+remove all the selections use --verb=EditDeselect. The object IDs
+available are dependent on the document specified to load.
+
=item B<-p> I<PRINTER>, B<--print>=I<PRINTER>
Print document(s) to the specified printer using `lpr -P PRINTER'.
=item B<-p> I<PRINTER>, B<--print>=I<PRINTER>
Print document(s) to the specified printer using `lpr -P PRINTER'.
inkscape --print='| ps2pdf - mydoc.pdf' mydoc.svg
inkscape --print='| ps2pdf - mydoc.pdf' mydoc.svg
-=item B<-s>, B<--slideshow>
-
-Show given files one by one, switching to the next one by any key or mouse event.
-
=item B<-t>, B<--export-use-hints>
Use export filename and DPI hints stored in the exported object (only with --export-id).
=item B<-t>, B<--export-use-hints>
Use export filename and DPI hints stored in the exported object (only with --export-id).
@@ -224,7 +250,17 @@ Export document(s) to Encapsulated PostScript format. Note that PostScript does
=item B<-A> I<FILENAME>, B<--export-pdf>=I<FILENAME>
=item B<-A> I<FILENAME>, B<--export-pdf>=I<FILENAME>
-Export document(s) to PDF 1.4 format. This format preserves the transparency in the original SVG (though not all PDF viewers can display it yet). This option can be used together with --export-text-to-path (currently this is required, because exporting text as text is not yet supported).
+Export document(s) to PDF 1.4 format. This format preserves the
+transparency in the original SVG (though not all PDF viewers
+can display it yet). This option can be used together with
+--export-text-to-path (currently this is required, because
+exporting text as text is not yet supported).
+
+By default, the entire document
+is exported and the page size of the PDF is that of the SVG document. You can
+specify --export-id to export a single object (with PDF page the size
+of that object's bounding box) and --export-area-drawing to make the
+exported PDF page show the entire drawing (by default the SVG page).
=item B<-T>, B<--export-text-to-path>
=item B<-T>, B<--export-text-to-path>
@@ -234,6 +270,10 @@ Convert text objects to paths on export, where applicable (currently works for P
Export files with the bounding box set to the page size, where applicable (currently works for PS and EPS export).
Export files with the bounding box set to the page size, where applicable (currently works for PS and EPS export).
+=item B<-F>, B<--export-embed-fonts>
+
+Embed fonts used in the document into exported PS/EPS file. Note: only Type 1 fonts can be embedded, not TrueType.
+
=item B<-I>, B<--query-id>
Set the ID of the object whose dimensions are queried. If not set, query options will
=item B<-I>, B<--query-id>
Set the ID of the object whose dimensions are queried. If not set, query options will
@@ -255,6 +295,11 @@ Query the width of of the drawing or, if specified, of the object with --query-i
Query the height of 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 of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
+=item B<-S>, B<--query-all>
+
+Prints a comma delimited listing of all objects in the SVG document with
+IDs defined, along with their x, y, width, and height values.
+
=item B<--vacuum-defs>
Remove all unused items from the <lt>defs<gt> section of the SVG file. If this
=item B<--vacuum-defs>
Remove all unused items from the <lt>defs<gt> section of the SVG file. If this
=item B<group id="options">
The options group allows persisting various user selected options
=item B<group id="options">
The options group allows persisting various user selected options
-including I<nudgeddistance>, I<rotationstep>, I<cursortolerance>, and
+including I<nudgedistance>, I<rotationstep>, I<cursortolerance>, and
I<dragtolerance>.
=back
I<dragtolerance>.
=back
The program returns zero on success or non-zero on failure.
The program returns zero on success or non-zero on failure.
-A variety of error messages and warnings are printed to STDERR or
+A variety of error messages and warnings may be printed to STDERR or
STDOUT. If the program behaves erratically with a particular SVG file
STDOUT. If the program behaves erratically with a particular SVG file
-or crashes, it is sometimes useful to look at this output for clues.
+or crashes, it is useful to look at this output for clues.
=head1 EXAMPLES
While obviously B<Inkscape> is primarily intended as a GUI application,
it can be used for doing SVG processing on the commandline as well.
=head1 EXAMPLES
While obviously B<Inkscape> is primarily intended as a GUI application,
it can be used for doing SVG processing on the commandline as well.
-Print an SVG file:
+Open an SVG file in the GUI:
+
+ inkscape filename.svg
+
+Print an SVG file from the command line:
inkscape filename.svg -p '| lpr'
inkscape filename.svg -p '| lpr'
inkscape filename.svg --query-width --query-id text1555
inkscape filename.svg --query-width --query-id text1555
+Duplicate the object with id="path1555", rotate the duplicate 90 degrees, save SVG, and quit:
+
+ inkscape filename.svg --select=path1555 --verb=EditDuplicate --verb=ObjectRotate90 --verb=FileSave --verb=FileClose
+
=head1 ENVIRONMENT
=head1 ENVIRONMENT
B<$HOME>/.inkscape/preferences.xml - The user's preference settings.
B<$HOME>/.inkscape/preferences.xml - The user's preference settings.
-B<$HOME>/.inkscape/extensions.xml - The filter programs to be used in
-the application.
+B<$HOME>/.inkscape/extensions/ - Directory with user's extension effects.
+
+B<$HOME>/.inkscape/icons/ - Directory with user's icons.
+
+B<$HOME>/.inkscape/keys/ - Directory with user's keyboard maps.
+
+B<$HOME>/.inkscape/templates/ - Directory with user's new file templates.
-B<$HOME>/.inkscape/icons/{*,icons}.svg - Icons to overload for themes.
=head1 OTHER INFO
The canonical place to find B<Inkscape> info is at
=head1 OTHER INFO
The canonical place to find B<Inkscape> info is at
-http://www.inkscape.org/. The website includes links to other relevant
-documentation, tutorials, user manual, examples, mailing list archives,
-the latest released version of the program, and more.
+http://www.inkscape.org/. The website has news, documentation,
+tutorials, examples, mailing list archives, the latest released
+version of the program, bugs and feature requests databases, forums,
+and more.
=head1 SEE ALSO
=head1 SEE ALSO
-gimp(1), autotrace, potrace, frontline, ill2svg, rsvg(1), xfig(1), sodipodi,
-karbon14, dia(1X), batik.
+potrace, cairo, rsvg(1), batik, ghostscript, pstoedit.
SVG compliance test suite: http://www.w3.org/Graphics/SVG/Test/
SVG compliance test suite: http://www.w3.org/Graphics/SVG/Test/
To learn Inkscape's GUI operation, read the tutorials in Help > Tutorials.
To learn Inkscape's GUI operation, read the tutorials in Help > Tutorials.
-Inkscape can import (File > Import) most bitmap formats (PNG, BMP, JPG, XPM, GIF etc.),
-plain text (requires Perl), and AI format (Adobe Illustrator documents, versions up to 7 only;
-requires Perl).
+Apart from SVG, Inkscape can import (File > Import) most bitmap formats
+(PNG, BMP, JPG, XPM, GIF, etc.), plain text (requires Perl), PDF,
+and AI format (AI version 9.0 or newer).
-Inkscape exports 32-bit PNG images (File > Export) as well as AI, PS, EPS, PDF (requires
-Ghostscript), DXF and several other formats via File > Save as.
+Inkscape exports 32-bit PNG images (File > Export) as well as AI, PS, EPS, PDF, DXF,
+and several other formats via File > Save as.
-Inkscape can use the pressure and tilt of a graphic tablet pen for width and angle of
-the Calligraphic tool.
+Inkscape can use the pressure and tilt of a graphic tablet pen for width, angle,
+and force of action of several tools, including the Calligraphic pen.
Inkscape includes a GUI front-end to the Potrace bitmap tracing engine
(http://potrace.sf.net) which is embedded into Inkscape.
Inkscape includes a GUI front-end to the Potrace bitmap tracing engine
(http://potrace.sf.net) which is embedded into Inkscape.
Inkscape can use external scripts (stdin-to-stdout filters) that are represented by
commands in the Effects menu. A script can have a GUI dialog for setting various
parameters and can get the IDs of the selected objects on which to act via the command
Inkscape can use external scripts (stdin-to-stdout filters) that are represented by
commands in the Effects menu. A script can have a GUI dialog for setting various
parameters and can get the IDs of the selected objects on which to act via the command
-line. Inkscape comes with an assortment of effects written in Python, mostly for path
-manipulation.
+line. Inkscape comes with an assortment of effects written in Python.
=head1 KEYBINDINGS
=head1 KEYBINDINGS
-To get a complete list of keyboard and mouse shortcuts, view doc/keys.html, or use the Keys and Mouse command in Help menu from the GUI to see an SVG chart.
+To get a complete list of keyboard and mouse shortcuts, view doc/keys.html, or use the Keys and Mouse command in Help menu.
=head1 BUGS
=head1 BUGS
Harrington, MenTaLguY, Nathan Hurst, and Ted Gould, wanting to take a
different direction with the codebase in terms of focus on
SVG compliance, interface look-and-feel, and a desire to open
Harrington, MenTaLguY, Nathan Hurst, and Ted Gould, wanting to take a
different direction with the codebase in terms of focus on
SVG compliance, interface look-and-feel, and a desire to open
-development opportunities to more participants.
+development opportunities to more participants. The project progressed
+rapidly, gaining a number of very active contributors and features.
+
+Much work in the early days of the project focused on code stablization
+and internationalization. The original renderer inherited from Sodipodi
+was laced with a number of mathematical corner cases which led to
+unexpected crashes when the program was pushed beyond routine uses; this
+renderer was replaced with Livarot which, while not perfect either, was
+significantly less error prone. The project also adopted a practice of
+committing code frequently, and encouraging users to run developmental
+snapshots of the program; this helped identify new bugs swiftly, and
+ensure it was easy for users to verify the fixes. As a result, Inkscape
+releases have generally earned a reputation for being robust and
+reliable.
+
+Similarly, efforts were taken to internationalize and localize the
+interface, which has helped the program gain contributors worldwide.
+
+Inkscape has had a beneficial impact on the visual attractiveness of
+Open Source in general, by providing a tool for creating and sharing
+icons, splash screens, website art, and so on. In a way, despite being
+"just an drawing program", Inkscape has played an important role in
+making Open Source more visually stimulating to larger audiences.
=head1 COPYRIGHT AND LICENSE
=head1 COPYRIGHT AND LICENSE
-B<Copyright (C)> 1999-2005 by Authors.
+B<Copyright (C)> 1999-2007 by Authors.
B<Inkscape> is free software; you can redistribute it and/or modify it
under the terms of the GPL.
B<Inkscape> is free software; you can redistribute it and/or modify it
under the terms of the GPL.