Inkscape Wiki - User contributions [en]

Text

2017-08-02T19:40:50Z

~suv: /* Types of Text */ fix typo in attribute name

== Introduction ==

'''This page describes Inkscape's text processing.'''

Text processing is probably the most complicated part of the Inkscape code base. Processing text is a multistep process:

# Read in text, breaking it into chunks that have the same styling (usually a <tspan>) and a unique postion.
# Layout the text, taking into consideration styling (font, font-size, etc.).
# Render the text to screen.

=== Source Code ===

Most of the code that handles text layout (including fonts) can be found in <code>src/libnrtype</code>. The actual rendering code is in <code>src/drawing/drawing-text.cpp</code>. (''nr'' stands for ''New Renderer''.) The GUI code is distributed over a number of files: for interactive ''on-screen'' editing look in <code>src/ui/tools/text-tool.cpp</code>, <code>src/text-editing.cpp</code>, and <code>src/text-chemistry.cpp</code>. The text ''Toolbar'' code is in <code>src/widgets/text-toolbar.cpp</code>. The ''Text and Font'' dialog code is in <code>src/ui/dialog/text-edit.cpp</code>.

=== Types of Text ===

There are several distinct kinds of text in Inkscape:

* ''Normal SVG text''. This is handled by the <text> and <tspan> elements. Inkscape always puts text inside a <tspan>. Multi-line text is mimicked by adding the attribute <code>sodipodi:role="line"</code> to each <tspan> that represents a line. (One can also get multiline text by setting the 'white-space' property to preserve line feeds but there is no GUI and only Firefox supports this method.) The code for these elements is found in <code>src/sp-text.cpp</code> and <code>src/sp-tspan.cpp</code>.
* ''Flowed SVG 1.2 text''. This text is flowed inside a shape. It is handled by the <flowtext> element. No browser implemented this type of text. The only know implementation other than Inkscape is in Batik (if the 'version' attribute is set to 1.2). The code for the elements used in flowed text is found in <code>src/sp-flowtext.cpp</code>, <code>src/sp-flowregion.cpp</code>, and <code>src/sp-flowdiv.cpp</code>.
* ''Text-on-a-path''. This is text that flows along a path. It is handled by the <textPath> element. It is widely supported by browsers. The code for this element is found in <code>sp-textpath.h</code> and <code>sp-tspan.cpp</code>.
* ''SVG 2 Text-in-a-shape''. This is text flowed inside a shape according to the rules of CSS. Inkscape can render such text. A GSoC project aims to replace ''Flowed'' SVG 1.2 text with this type of text. This method has the advantage that one can provide a natural fallback mechanism that works with SVG 1.1. It relies on CSS properties applied to the <text> element to define which shapes to fill.

== Fonts ==

Fonts are fundamental to the display of text. Font handling is partially operating system dependent.

Font handling code is in the following files found in <code>src/libnrtype</code>:

* <code>FontFactory.h/FontFactory.cpp</code>
* <code>font-instance.h/FontInstance.cpp</code>
* <code>font-lister.h/FontLister.cpp</code>

=== The ''Font Factory'' ===

The '''Font Factory''' handles retrieving a list of fonts from the operating system and stores the list in a map. If the compile time flag <code>USE_PANGO_WIN32</code> is set, the font factory uses <code>pango_win32_xxx</code> functions to create the map, otherwise <code>pango_ft2_xxx</code> functions are used.

The most important job of the ''Font Factory'' is to take the Pango description of a font (stored as a <code>PangoFontDescription</code>) and return a ''font_instance'' that matches the description (see next section). As part of this process, the ''OpenType'' substitution tables are examined to build up a list of what glyph substitutions the font offers (this is not available when the <code>USE_PANGO_WIN32</code> flag is set).

Most of the rest of the ''Font Factory'' class code deals with extracting out information used for font selection in the GUI from the map such as a list of font families and their styles. A few adjustments are made to match Pango to CSS (Sans -> sans-serif, etc.). Pango is happy to synthesize bold and italic fonts. This is disabled except for the generic CSS faces ('sans-serif', 'serif', etc.).

=== The ''Font Instance'' ===

The '''font-instance''' class keeps track of a single font face. Like the ''Font Factory'', the code depends on the the compile time flag <code>USE_PANGO_WIN32</code>. The class functions provide access to font-wide data sush as the font's ascent, descent, and xheight.

Perhaps the most important function is <code>font_instance::LoadGlyph()</code> which provides access to glyph data including the glyph outline. This glyph outline is used when rendering the glyph.

=== The ''Font Lister'' ===

The '''font_lister''' class sets up a <code>Gtk::ListStore</code> containing all the fonts available on the system and those used in an SVG file (which may include fonts not on the system). It handles things like CSS 'font-family' values that include fallbacks as well as finding the best font to substitute when a specified font is not available.

A couple ''helper'' functions are also provided that are used in the GUI, including one that causes used fonts to be displayed in blue and unavailable fonts to be displayed with a red stike-through.

One weakness in the current implementation is that if two fonts have the same CSS property values, only the first is shown since there is no way to distinguish between the two using a <code>PangoFontDescription</code>. To get around the limitation, CSS allows the use of the ''@font-face'' rule. It should be possible for Inkscape to add support for this rule.

== Text Layout ==

Text layout is handled by first reading in a text object and breaking it up into chunks, one chunk for each piece of text that has a unique style or a specified position (through the 'x' or 'y' attributes) (<code>Layout-TNG_Input.cpp</code>). Then a layout engine attempts to position each chunk in turn (<code>Layout-TNG-Compute.cpp</code>). A chunk may be broken into smaller chunks if needed to by the line fitting algorithm (<code>Layout-TNG-Scanline-Makers.cpp</code>). Finally, the text is output via the <code>Layout::show()</code> function (<code>Layout-TNG-Output.cpp</code>).

== Text Rendering ==

Text rendering is handled in <code>src/display/drawing-text.cpp</code>. Text rendering is very similar to shape rendering except that the glyph outlines are used and that text decorations can be added.

Release notes/0.92.1

2017-02-10T04:17:54Z

~suv: Update status of bug #1645016 (fix backported from trunk)

{{Other languages | en = {{FULLPAGENAME}}}}

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.92.1 is a stability and bugfix release. For a complete list of bugs fixed in 0.92.1, see the [https://launchpad.net/inkscape/+milestone/0.92.1 Launchpad milestone page].

==Regression fixes==
* Text: baseline-spacing related issues with regular and flowed text in legacy Inkscape SVG files (Bug #[https://bugs.launchpad.net/inkscape/+bug/1655483 1655483] and others).
* Text: Default baseline spacing stored in relative units is always converted to document units (Bug #[https://bugs.launchpad.net/bugs/1645016 1645016])
* Path effects: Crash on ungroup if group contains elements with path effects (Bug #[https://bugs.launchpad.net/inkscape/+bug/1657591 1657591])
* Clipboard: Pasting a path effect from clipboard fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656093 1656093])
* Clipboard: Fix copy&pasting of groups which contain elements with path effects (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656527 1656527])
* Selection: Node tool can selected objects on locked layers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656141 1656141])
* Clones: Critical warnings with clones and symbols (Bug #[https://bugs.launchpad.net/inkscape/+bug/1653184 1653184])
* About screen missing for several UI languages (Bug #[https://bugs.launchpad.net/inkscape/+bug/1659426 1659426])

==Important bugfixes==
* Bitmap images: Crash when opening files with invalid image links (Bug #[https://bugs.launchpad.net/inkscape/+bug/1660142 1660142])
* Bitmap images: Fix path separators in relative image links (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1659347 1659347])
* File import: Failure to open CDR/Visio/WPG files from paths with special characters (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656763 1656763])

==Translations==
* Catalan: Tutorial translation ("Basic") added
* Czech: UI translation updated
* French: UI translation updated
* French: Man page, Readme and Keys & mouse reference updated
* German: Man page and Keys & mouse reference updated
* Icelandic: UI translation updated
* Italian: UI translation updated
* Latvian: UI translation updated
* Russian: Tutorial translation ("Tracing Pixel Art") added
* Russian: UI translation updated
* Spanish: UI translation updated
* Slovak: Tutorial translation ("Tracing Pixel Art") added
* Slovak: UI translation updated
* Ukrainian: UI translation updated

==Documentation==
* Shortcuts: Add shortcut '7' for cycling through path effect parameters in node tool (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656713 1656713])
* Shortcuts: Add new Shift+I shortcut to keys and mouse reference (Bug #[https://bugs.launchpad.net/inkscape/+bug/1644609 1644609])
* Man page: Add new --no-convert-text-baseline-spacing command line option (Bug #[https://bugs.launchpad.net/inkscape/+bug/1661811 1661811])

==Known issues==
* DPI Change: Dialog needs better explanation of available options (Bug #[https://bugs.launchpad.net/bugs/1659229 1659229])
* DPI Change: Provide command line options for batch-processing legacy files (Bug #[https://bugs.launchpad.net/bugs/1659489 1659489])
* DPI Change: known issues with 'Scale elements' option ([https://bugs.launchpad.net/bugs/1653230 1653230],[https://bugs.launchpad.net/bugs/1653236 1653236],[https://bugs.launchpad.net/bugs/1654342 1654342],[https://bugs.launchpad.net/bugs/1654796 1654796],[https://bugs.launchpad.net/bugs/1654880 1654880],[https://bugs.launchpad.net/bugs/1654903 1654903],[https://bugs.launchpad.net/bugs/1655005 1655005],[https://bugs.launchpad.net/bugs/1655053 1655053],[https://bugs.launchpad.net/bugs/1660228 1660228])
* DPI Change: Default grids in documents created with Inkscape 0.91 don't scale correctly (Bug #[https://bugs.launchpad.net/bugs/1653893 1653893])
* Selection: Missing transformation handles after reset of rotation center (Bug #[https://bugs.launchpad.net/bugs/1657874 1657874])
* Renderer: Artifacts in Gaussian blur effects with default quality settings (Bug #[https://bugs.launchpad.net/bugs/1656383 1656383])
* Node editor: Deselecting selected nodes of complex paths takes a long time (Bug #[https://bugs.launchpad.net/bugs/1652100 1652100])
* Fill and Stroke: HSL color selector may show corrupted colors, defunct 5th slider (Bug #[https://bugs.launchpad.net/bugs/1635982 1635982])

==Previous releases==
* [[Release notes/0.92]]

Release notes/0.92.1

2017-02-04T03:47:22Z

~suv: /* Known issues */

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.92.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.92.1, see the [https://launchpad.net/inkscape/+milestone/0.92.1 Launchpad milestone page].

==Regression fixes==
* Text: baseline-spacing related issues with regular and flowed text in legacy Inkscape SVG files (Bug #[https://bugs.launchpad.net/inkscape/+bug/1655483 1655483] and others).
* Path effects: Crash on ungroup if group contains elements with path effects (Bug #[https://bugs.launchpad.net/inkscape/+bug/1657591 1657591])
* Clipboard: Pasting a path effect from clipboard fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656093 1656093])
* Clipboard: Fix copy&pasting of groups which contain elements with path effects (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656527 1656527])
* Selection: Node tool can selected objects on locked layers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656141 1656141])
* Clones: Critical warnings with clones and symbols (Bug #[https://bugs.launchpad.net/inkscape/+bug/1653184 1653184])
* About screen missing for several UI languages (Bug #[https://bugs.launchpad.net/inkscape/+bug/1659426 1659426])

==Important bugfixes==
* Bitmap images: Crash when opening files with invalid image links (Bug #[https://bugs.launchpad.net/inkscape/+bug/1660142 1660142])
* Bitmap images: Fix path separators in relative image links (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1659347 1659347])
* File import: Failure to open CDR/Visio/WPG files from paths with special characters (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656763 1656763])

==Translations==
* Catalan: Tutorial translation ("Basic") added
* Czech: UI translation updated
* Italian: UI translation updated
* Latvian: UI translation updated
* Russian: Tutorial translation ("Tracing Pixel Art") added
* Russian: UI translation updated
* Spanish: UI translation updated
* Slovak: UI translation updated
* Ukrainian: UI translation updated

==Documentation==
* Shortcuts: Add shortcut '7' for cycling through path effect parameters in node tool (Bug #[https://bugs.launchpad.net/inkscape/+bug/1656713 1656713])
* Shortcuts: Add new Shift+I shortcut to keys and mouse reference (Bug #[https://bugs.launchpad.net/inkscape/+bug/1644609 1644609])

==Known issues==
* Text: Default baseline spacing stored in relative units is always converted to document units (Bug #[https://bugs.launchpad.net/bugs/1645016 1645016])
* DPI Change: Dialog needs better explanation of available options (Bug #[https://bugs.launchpad.net/bugs/1659229 1659229])
* DPI Change: Provide command line options for batch-processing legacy files (Bug #[https://bugs.launchpad.net/bugs/1659489 1659489])
* DPI Change: known issues with 'Scale elements' option ([https://bugs.launchpad.net/bugs/1653230 1653230],[https://bugs.launchpad.net/bugs/1653236 1653236],[https://bugs.launchpad.net/bugs/1654342 1654342],[https://bugs.launchpad.net/bugs/1654796 1654796],[https://bugs.launchpad.net/bugs/1654880 1654880],[https://bugs.launchpad.net/bugs/1654903 1654903],[https://bugs.launchpad.net/bugs/1655005 1655005],[https://bugs.launchpad.net/bugs/1655053 1655053],[https://bugs.launchpad.net/bugs/1660228 1660228])
* DPI Change: Default grids in documents created with Inkscape 0.91 don't scale correctly (Bug #[https://bugs.launchpad.net/bugs/1653893 1653893])
* Selection: Missing transformation handles after reset of rotation center (Bug #[https://bugs.launchpad.net/bugs/1657874 1657874])
* Renderer: Artifacts in Gaussian blur effects with default quality settings (Bug #[https://bugs.launchpad.net/bugs/1656383 1656383])
* Node editor: Deselecting selected nodes of complex paths takes a long time (Bug #[https://bugs.launchpad.net/bugs/1652100 1652100])
* Fill and Stroke: HSL color selector may show corrupted colors, defunct 5th slider (Bug #[https://bugs.launchpad.net/bugs/1635982 1635982])

==Previous releases==
* [[Release notes/0.92]]

Release notes/0.92.1

2017-02-04T01:27:45Z

~suv:

Release notes/0.92.1

2017-02-03T22:32:52Z

~suv: Create draft version for Inkscape 0.92.1 release notes

Line Height Bugs

2017-02-02T16:46:27Z

~suv: /* Bug Reports */ add most recent bug report related to line height (in flowed text)

This page is to track bugs and issues regarding the changes to 'line-height' in 0.92.

=Background=

0.92 introduces changes in behavior with regards to line spacing. Changes were made in order to adhere to the CSS definition of the 'line-height' property. Work was motivated by a desire to handle units in the 'line-height' property as well as to prepare for SVG 2 multi-line text.

=Key Issues=

The following issues have been identified by testing a variety of pre-0.92 Inkscape files:

# Pre 0.92 Inkscape interprets % 'line-height' values incorrectly. CSS dictates that 'line-height' values with units are "computed" at the point the are defined and it is the computed value that is inherited by child elements. On the other hand, unit-less 'line-height' values pass the "uncomputed" value to child elements and the child elements compute their own line spacing.
# Pre 0.92 Inkscape ignores the "strut". The "strut" is the minimum spacing between lines as determined by the 'font-size' and 'line-height' values of the outermost text element. For example, if one has a 'font-size' of 40px and a 'line-height' value of 1.25, the strut value is 50px. No lines inside the <text> element can be spaced closer together than 50px.
# Inkscape 0.92.0 introduces a bug in spacing blank lines. Blank lines (which are represented by empty <tspan> elements) are spaced according to the strut value, incorrectly ignoring styling information on the <tspan>. If one sets the strut value to zero, it appears that blank lines are not rendered.
# The placement of the first line in flowed text may be shifted slightly from pre 0.92 Inkscape. This is due to a correction on positioning the first line, again to better adhere to CSS. For the most part, any shift should be minor.

=Other Issues=

# The 'sodipodi:line-height' attribute should be removed.

=Bug Reports=

* [https://bugs.launchpad.net/inkscape/+bug/1661281 Bug #1661281] “object disappears with v0.92”
* [https://bugs.launchpad.net/inkscape/+bug/1655483 Bug #1655483] “Inkscape 0.92 line space problem with text of Inkscape 0.91”
* [https://bugs.launchpad.net/inkscape/+bug/1655412 Bug #1655412] “Space between base lines misbehavior”
* [https://bugs.launchpad.net/inkscape/+bug/1652340 Bug #1652340] “Extension for 0.92.x to fix line spacing in legacy documents”
* [https://bugs.launchpad.net/inkscape/+bug/1652006 Bug #1652006] “Line spacing differs between 0.91 an 0.92b4”
* [https://bugs.launchpad.net/inkscape/+bug/1644299 Bug #1644299] “text and image not displaying in 0.92pre3”
* [https://bugs.launchpad.net/inkscape/+bug/1642133 Bug #1642133] “Inkscape shows text with ridiculously wide line spacing”
* [https://bugs.launchpad.net/inkscape/+bug/1617692 Bug #1617692] “Spacing Between Baselines Messed Up 0.92 15081”
* [https://bugs.launchpad.net/inkscape/+bug/1556400 Bug #1556400] “line height all equal in development version”


=Test Files=

su_v has assembled a set of test files that can be found at: https://gitlab.com/su-v/test-files

Identified issues in test files:

<pre>
1274158: Issue had to do with bitmap import. Note: file contains <flowRoot> elements without text.

The file exposes two issues:

1. The strut issue.
2. The improper inheritance of % line-height values.

(Inkscape multi-line text.)

1382923: The actual issue had to do with changing from 'px' to 'pt' font size.

The file exposes the strut issue.

Simplest fix is to set the outer font-size to zero to
create a zero-height strut.

(Inkscape multi-line text.)

1513959: Pre 0.92 line-height % values inherited incorrectly.

Fix is to convert % to unitless.

(<flowRoot> text.)

1642133: Pre 0.92 the strut was not used. Here the outer font-size
is larger than the inner font-sizes so the strut value is
limiting how close the lines can be spaced.

Easiest fix is to set outer font-size to zero and line-height
to 1.25. sodipodi:linespacing attribute should be removed.

(Inkscape multi-line text.)

AmigaBallTutorial:

Pre 0.92 the strut was not used. Here, due to the 12px
font-size on the outer text element a 15px strut is created
(the default value for line-height is 1.25). Line spacing can
never be less than the strut value.

The easiest fix is to change the 12px font-size on the outer
text element to 9px, to match the inner font-size's.

An alternative fix is to set the outer line-height to 0 (but
this fails due to incorrect spacing of empty lines).

(Inkscape multi-line text.)

</pre>

= References=

* [http://wiki.inkscape.org/wiki/index.php/Release_notes/0.92#Line_Spacing Line spacing section in release notes.]
* Tav's [http://tavmjong.free.fr/blog/?p=1632 blog post] on line spacing.

Leadership Committee Status Updates

2017-01-26T17:44:08Z

~suv: /* Minutes */ fix link for 2016-04-01 log

== Place and Time ==

We meet in #inkscape-devel on [https://freenode.net/ freenode].

Board meetings are typically the first Friday of each month.

Everybody in the Inkscape community is invited to participate.

Next meeting: [http://www.timeanddate.com/worldclock/fixedtime.html?month=1&day=6&year=2017&hour=20&min=00&sec=0&p1=0 Noon PST/15:00 DMT (DoctorMonTime)/21:00 CET, (click for world clock)], Fri, January 6th, 2017.

Meetings should be announced in advance on [https://lists.sourceforge.net/lists/listinfo/inkscape-devel inkscape-devel] and [https://lists.sourceforge.net/lists/listinfo/inkscape-board inkscape-board] mailing lists.

== Agenda ==

* Merchandise sales [bryce, Mc]
** Spreadshirt account now ready to go
** Need volunteers to set up and administer the Inkscape shop
** Self-serve merchandise sales - spreadshirt, cafepress, Golden Ribbon, Think Penguin or similar [Mc-]
*** √ Investigate how you setup where your money goes
*** √ Register an 'Inkscape Admin' account on the site (and add credentials to our credentials repo)
*** Need to define our designs (SVG). Maybe official "about" images, inkscape logo, etc. just to start
*** Maybe arrange things to give some cash back to original authors, esp. for about screen images
*** Upload a few designs
*** Decide on a price to set
*** Convince people to buy the items
*** Can set up a "shop" for your brand
*** Mc- will help work on getting this set up

* Followup to sponsorship level [bryce]
** Need to add mention of the five levels onto the Sponsor page
** c.f. https://sourceforge.net/p/inkscape/mailman/message/34460338/

* Inkscape forum followup

* Mesh gradient feature followup [tav]

* LGM 2017 (Rio de Janeiro: April 20-23 [dates not final]) [ted]

* Funded development [bryce]
** Are the three projects still relevant? Yes
** Identify Manager/Reviewer/Second for each of the jobs
** How should we advertise the jobs?

* Next hackfest

* GSoC 2017 [tav]
** JavaScript "extensions"
** Polyfills
** Coordinate inversion
** Remove dependence on garbage collector
** etc.

* Other Business

=== Action Items ===
* svg 2.0:
** √<s>Land GUI changes for enabling meshgradients for 0.92.x</s> [Tavmjong]
** √<s>Release a pre3 with meshgradients</s> [bryce]
** Look at warning/cleaning for "plain svg" [doctormo]
* Merchandise Sales
** Get doctormo and prkos added as shopkeepers

* Future hackfests
** 0.93 oriented hackfest [Tavmjong] [[HackfestGtk3]] [[Hackfest_0.93]]
*** Location and time highly TBD
*** Tav will brainstorm on wiki about what it might look like
** SCALE oriented event [scislac]
*** Maybe could include class on contributing/hacking on inkscape (JonCruz suggestion)
** Hackfest organizational tips
*** Process: Have folks propose options, and then trade off cost projections and benefits
*** Try to organize group lodging (same hotel, rented/air-bnb house, http://www.linuxhotel.de/community.en.html, etc.)
*** Send a scout ahead of time to help avoid slummy accommodations
*** Catered lunches help keep everyone focused (we're already reimbursing on lunches, so cost differential isn't huge, and it saves hassle all around)
*** Boots on the ground at a location can be a huge help if plans go awry
*** Prefer locations with local inkscape community on the ground

* Fundraising
** Need to engage a few more fund raising efforts, esp. with release as a goal

* Forum
** inkscapeforum is overwhelmed by moderation actions required (spam mostly), roughly 4000 new per month (50 spams per valid message), and lacks adequate active administrators
** √<s>Contact inkscapeforum (deadline next Board meeting)</s> [Scislac]
*** √<s>Maybe request database dump (and maybe site tarball).</s>
*** If we can get a DB dump, consider feasibility of simply transplanting the phpBB
** √<s>Establish an "Inkscape Forum Exploratory Committee" to lay groundwork in case we need to establish our own Inkscape-managed forum</s>
*** √<s>Recruit 3-5 folks for this committee. Ask Brynn to chair.</s> [Bryce]
*** √<s>Evaluate pros/cons of potential forum software candidates</s>
**** Are there DJango forums plugins as functional as phpBB?
**** Consider benefits of tight/loose integration with our Django website vs. something standalone
**** Consider hosting requirements (OSUOSL or elsewhere??)
**** Consider administrative requirements for maintaining/upgrading software
*** Plan the chartering of a moderation team
*** Plan steps for curtailing spam. E.g. akismet, req. account to post; auto-ban spammer accounts; etc.
*** Plan steps for customizing the forum site design appearance / style
*** Present a recommended course of action

* Credentials management for board members and administrators [bryce]
** GPG keys
** Policy on website credential access
** List of administrators needing credential access
** Setting up a shared project administrative account for various services
** Check that our credentials escrow includes √<s>twitter</s>, facebook, Inkscape forum admin, and IRC moderation keys [bryce]

* Finalization of Budget 2016 [bryce]
** Update the budget, see what $$ remains in the hackfest fund [bryce]
* [https://inkscape.org/en/support-us/funded-development/ Funded development] [bryce]
* Add a C++-11 conversion project with tasks detailed to the Roadmap for 0.93 or later. [valavanisalex]
* Regularly check sponsor ads / sponsor mentions on the website (Advance Systems: added Dec 9th, 2016)

== Blocked Action Items ==

* Privacy Policy [drmo] ~ Blocked waiting on time availability by SFC
* Amend CoC reporting section ~ Waiting until we have a dedicated email, e.g. abuse@inkscape.org
* Rekindle release process for 0.91.1 [scislac]
* Verify large donation landed in our account, and then confirm and followup with Scislac for next steps on recognition, etc. [bryce]
** (No sign of it having landed...)

== Past Agenda Items ==

* √<s>Make mention of the code of conduct on the mailing list and website</s> [bryce]
* √<s>Brainstorm future hackfests</s>
** Focused hackfests? Possible topics: 0.92 release, GTK3.
* √<s>Followup to GPLv2+ licensing</s> [tweenk]
* √<s>Followup to CoC work</s>
* √<a>Arrange vote on GPLv2+ board statement</s> [bryce]
* √<s>GSoC 2016 kickoff</s> [scislac]
* √<s>Debrief from [[Hackfest2016|Hackfest 2016]]: Leeds</s> [valavanisalex]
* √<s>New agenda for next month</s> [bryce]
* √<s>Post meeting minutes</s> [scislac]
* √<s>Arrange vote on Leeds hackfest proposal</s> [bryce]
* √<s>Identify who has not registered their GPG keys for credentials access, that should</s> [bryce]
* √<s>Prepare for GSoC 2016 project application</s>
** √<s>Get Project Suggestions list ready for GSoC</s> [bryce]
** √<s>Send bryce list of required details for Project Suggestions page</s> [scislac]
** √<s>Submit mentoring application (opens Feb 8th, deadline Feb 19th)</s> [scislac]
** √<s>Solicit mentors to be pre-assigned to project ideas (tweenk & tav already volunteered)</s> [scislac]
* √<s>Contact GIMP developers about licensing of GPLv3+ code included in Inkscape</s> [tweenk]
* √<s>GPLv2+</s> [tweenk]
** √<s>tweenk will followup regarding resolution of remaining licensing issues</s>
* √<s>Rekindle release process for 0.92. Need to complete cmake work, enter feature freeze, and announce timeline for finishing the release</s> [bryce]

== Minutes ==

* Meeting 2014-09-15: transcript https://inkscape.org/en/gallery/item/392/
* Meeting 2014-09-29: transcript https://inkscape.org/en/gallery/item/854/
* Meeting 2014-10-08: transcript https://inkscape.org/en/gallery/item/950/
* Meeting 2014-10-15: transcript https://inkscape.org/en/gallery/item/1436/
* Meeting 2014-11-05: transcript https://inkscape.org/en/gallery/item/2204/
* Meeting 2014-11-12: transcript https://inkscape.org/en/gallery/item/2210/
* Meeting 2014-11-19: transcript https://inkscape.org/en/gallery/item/2216/
* Meeting 2014-11-26: transcript https://inkscape.org/en/gallery/item/2498/
* Meeting 2015-10-02: transcript https://inkscape.org/en/gallery/item/6701/
* Meeting 2015-11-06: transcript https://inkscape.org/en/gallery/item/6886/
* Meeting 2015-12-04: transcript https://inkscape.org/en/gallery/item/7056/
* Meeting 2016-01-08: transcript https://inkscape.org/en/gallery/item/7276/
* Meeting 2016-04-01: transcript https://inkscape.org/en/gallery/item/9565/
* Meeting 2016-05-06: transcript https://inkscape.org/en/gallery/item/9563/
* Meeting 2016-06-03: transcript https://inkscape.org/en/gallery/item/9667/
* Meeting 2016-07-08: transcript https://inkscape.org/en/gallery/item/9766/
* Meeting 2016-08-05: transcript https://inkscape.org/en/gallery/item/9864/
* Meeting 2016-09-02: transcript https://inkscape.org/en/gallery/item/9971/
* Meeting 2016-11-04: transcript https://inkscape.org/en/gallery/item/10241/
* Meeting 2016-12-02: transcript https://inkscape.org/en/gallery/item/10484/
* Meeting 2017-01-06: transcript https://inkscape.org/en/gallery/item/10582/

Release notes/0.92

2017-01-16T01:08:32Z

~suv: /* Live Path Effects */ mention new feature for Bend and Pattern Along Path LPEs

{{Other languages|en=Release notes/0.92}}

== Inkscape 0.92 ==

== Release highlights ==

Released on '''2017-01-01'''.

* [[Mesh Gradients]] are now supported.
* Many SVG2 and CSS3 properties are now supported (e.g. paint-order, mix-blend-mode). Not all are available from the GUI.
* The new Object dialog allows to select, label, hide and lock any object in the drawing from a dialog that lists them all
* Selection sets make it possible to 'group' objects together regardless of document structure
* Guides can now be locked to avoid accidental movement
* Several new path effects have been added, among them Envelope/Perspective, Lattice Deformation, Mirror and Rotate Copies
* There are several new extensions (e.g. a seamless pattern extension) and a new filter (colorblindness simulation) included in the release, many old extensions have been updated or got new features
* Spray tool and measure tool received a set of nifty new features
* Interactive smoothing for lines created with the Pencil tool
* BSplines (and more) are available for the Pen tool
* Checkerboard background can be used to more easily see object transparencies

[https://inkscape.org/en/~jabiertxof/%E2%98%85inkscape-092-showcase Watch the video which presents the latest version]

== Important changes ==

* The default resolution was changed from 90dpi to 96dpi, to match the CSS standard. For more background information, please see [[Units_In_Inkscape | the Wiki article about handling of units in Inkscape]]. Inkscape 0.92 will attempt to identify 'legacy' Inkscape files that need to be converted. If such a file is detected, the user will be offered three options:
*# Set 'viewBox'. Inkscape will add an appropriate 'viewBox' which will do a global scaling of the document. It will also adjust the document width and height if necessary.
*# Scale elements. Inkscape will scale each internal element.
*# Ignore. Do nothing. This is an appropriate choice for documents meant for screen display.
*:''[See [https://bugs.launchpad.net/inkscape/+bug/1389723 release blocker bug report] for more details.]''

* For developers and packagers, the switch from autotools to CMake is a relevant change (users who do not compile their own version will not be affected). While the old system is still available for 0.92, it is now also possible to compile Inkscape using CMake ([[CMake |Background info about why this change was made]] and [[Working with CMake | How to work with CMake]]).

== Manipulating Objects ==

=== Objects Dialog ===

New dialog for manipulating the object tree.

* Drag and drop reordering of objects.
* Lock, and hide one or more items.
* Use Ctrl+F to search for an item.
* Select one or more objects in the drawing.
* Shows individual objects as well as layers.
* Ability to change highlight color of objects.
* Ability to set blend mode per object.

Imported from Ponyscape.

=== Selection Sets Dialog ===

New dialog that allows the creation of selection sets that are not affected by document structure.

Usage:

* '''Open''' Dialog with 'Object > Selection sets'

* To '''create''' a new selection set:
*# click on the '+' button at the bottom of the dialog (double-click on its label to edit)

* To '''add objects''' to a selection set:
*# select object on the canvas
*# in the 'Selection sets' dialog click on the '+' icon before the selection set in the list

* To '''select all objects''' of a selection set:
*# deselect any existing selection and click on the selection set in the list

* To '''remove an object''' from a selection set:
*# select the selection set in the dialog
*# click on 'Items' to show all objects in the set
*# select an object on the canvas or in the Items list in the dialog
*# click on the 'Delete' icon (trashbin) before the object in the list

* To '''delete''' a selection set:
*# select it in the list and click on the '-' button at the bottom of the dialog

== Text ==

=== Font Features ===

It is now possible to take advantage of '''OpenType tables''' to select alternative glyphs from a font. For this, '''a third tab''' ('Variants') has been added to the 'Text and Font' dialog. Note that browser support is still limited. Inkscape must also be linked with a recent version of the Pango library.

=== Vertical Text ===

Support for vertical text layout has been improved.
* The default behavior for Latin bases glyphs has been changed. They are now rotated sideways as required by the SVG 1.1 standard.
* Support for the CSS 3 'text-orientation' property has been added. (Note that this property is not yet fully supported by browsers.)
* The CSS 3 values for the 'writing-mode' property are supported in rendering. Saving still uses the deprecated SVG 1.1 values.

=== Accessibility ===

Converting text to a path will save the text in the 'aria-label' attribute. This is useful for accessibility and could eventually be used by Inkscape to reconstruct the text.

=== Line Spacing ===

Line spacing in Inkscape now follows the CSS standard for the 'line-height' property. Note the following points:

* [[File:Text_flexible_spacing.png |thumb| right | Outer: "font-size:40px;line-height:1.25"]] [[File:Text_flexible_spacing3.png |thumb| right | Outer: "font-size:40px;line-height:1.25em"]] The unit for 'line-height' can now be chosen. Previous versions of Inkscape used a unitless value. When the value is unitless, the line spacing is recalculated for each change in font size. This is the most commonly expected behaviour. When the value has a unit, the line spacing is calculated at the point where the CSS 'line-height' property is defined and that value is used regardless of following changes in font size. This however, will not always lead to evenly spaced lines due to the idiosyncrasies of how line spacing is calculated in CSS. (See Tav's write up [http://tavmjong.free.fr/blog/?p=1632 CSS Text Line Spacing Exposed] for the details.)

* [[File:Text_flexible_spacing2.png |thumb| right | Outer: "font-size:40px;line-height:0", Inner: "line-height:1.25em"]] The minimum spacing between lines is determined by the 'strut' value. This is determined by the product of the 'font-size' and 'line-height' values on the outermost text element. These values are shown and can be set when the "Outer Style" button is enabled in the Text Tool's Tool Control bar. To set the 'strut' to zero, set the outer style 'line-height' to zero. If the 'strut' has zero height, you'll need to set 'line-height' on all the inner text elements to keep the lines from being on top of each other. Use Ctrl-A to select all the text and disable the "Outer Style" button to set the "line-height" on all the inner elements. Note: when the "Outer Style" button is not enabled, the "Font size" and "Line height" boxes show the values of either the high-lighted selected text or at the cursor point (if no text is selected). Changes in font size and line spacing will be applied to the selected text or to all the inner elements (if no text is selected). Unlike other styling properties (e.g. fill color), there is no visual indicator of which characters have a particular 'line-height' value. One can step through character by character with the cursor to determine a span of characters with the same 'line-height' value.

* [[File:Text_flexible_spacing4.png |thumb| right | Outer: "font-size:40px;line-height:1.25", Inner: "line-height:0"]] To create a set of evenly spaced lines regardless of font size, set the 'strut' value to the desired line spacing and then set the inner 'line-height' values to zero.

== Live Path Effects ==

* Now some suitable LPEs can be applied to clips and masks.
* Helper lines come again to life.
* The option to add a bend path directly was added to the pen/pencil shape combo box.
* On-canvas controls for the width parameter have been added to the Pattern Along Path and Bend LPE.

=== Spiro Live ===

Extended video: https://www.youtube.com/watch?v=bFakiI5f0-Y

Based upon Spiro Live Path Effect, now shows the result while drawing.

* '''Cusp''' nodes can be created by holding down the Shift key.
* When you append a path in cusp and Spiro mode, the helper preview path will be displayed.

[[File:Spirolive.gif]]

=== BSpline ===

Extended video https://www.youtube.com/watch?v=vwV0DHvA-OE

==== Pen & Node mode ====

Uses the '''BSpline Live Path Effect''' while creating and editing paths.

* Works with Pen and Pencil tool directly.
* Create '''cusp''' nodes by holding down the Shift key (Pen/Bézier tool only).
* When a path is appended, a preview helper path will also be shown.
* Hold down Shift key and drag on a handle to change the '''weight''' of a bspline in node tool.
* Custom '''weight steps''' are applied by holding '''CTRL''' down and dragging on a handle with the node tool (no Shift key required).
* Double-click on a handle resets weight to default

[[File:Bspline.gif]] [[File:Bspline2.gif]]

==== Live Path Effect mode ====

[[File:Bspline3.gif|170px|right|thumb|Bspline LPE]]

The options in the Live Path Effect dialog give you full control over bspline paths.

* Option to set to '''Default weight''' (0.3333 times curve segment)
* Option to make nodes '''cusp'''
* Numeric input for '''weight'''
* Option to set number of '''Steps with CTRL''' to quickly snap the weight in node/handle editing
* '''Apply changes if weight ...''' applies changes in the widgets to all nodes with weight == 0 or weight > 0 or both, for example, retains cusp nodes when you change the weight and have unselected "Apply changes if weight == 0".
* '''Change only selected nodes''' applies to all other widgets changes.
* Shows a '''helper path''' with the final shape and the generated new nodes.

=== Roughen ===

[[File:Roughen.png|170px|right|thumb|Roughen LPE]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This path effect is a semi-clone of two extensions, ("add nodes" and "jitter nodes") and handles units.

The parameters are similar to both extensions and adds a global randomizer.

* Can be applied to paths, shapes and groups.
* Can be applied to clips and masks, if they are vector objects.

[[File:Roughen.gif]]

=== Simplify ===

[[File:Simplify.png|170px|thumb|right|Simplify LPE]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Simplifies a vector element using a non-destructive live path effect.

* Can be used on paths, shapes and groups of these.
* Can be applied to clips and masks, if they are vector objects
* The effect's threshold can be modified in the preferences dialog, by setting a numeric parameter.
* Apply Simplify multiple times in the same LPE.

[[File:Simplify.gif]]

This path effect can optionally be applied directly via the pencil/freehand drawing tool's tool bar when creating a new path. It then replaces the normal smoothing (which would be a destructive operation).

=== Perspective/Envelope ===

[[File:Perspective-envelope.png|170px|thumb|right|Perspective/Envelope LPE]]

Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Both deformations can be applied by specifying 4 points.

* Two modes, perspective and envelope
* Can be used on paths, shapes and groups.
* Also works with vector clips and masks.

[[File:Perspective-envelope.gif]]

=== Lattice Deformation 2 ===

[[File:Latice2.png|170px|thumb|right|Lattice Deformation 2 LPE]]

Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

* Deforms an object by 25 handles arranged in a mesh
* Optionally deforms symmetrically along vertical or horizontal axis or both.
* Can be applied to paths, shapes and groups.
* Also works on vector clips and masks.

[[File:Latice2.gif]]

=== Show Handles ===

[[File:ShowHandles.png|170px|thumb|right|Show Handles LPE]]

Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

An LPE version of the Show Handles extension.

* Works on paths, shapes and groups.
* Works on clones.
* Node and Handle shapes are resizeable
* If not applied to a clone, this is a destructive LPE, it does not save styles, better work on a copy!

[[File:ShowHandles.gif]]

=== Transform by two points ===

[[File:TransformByTwoKnots.png|170px|thumb|right|Transform by 2 points LPE]]

Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw 
Extended video (Elastic rubber): https://www.youtube.com/watch?v=lOWTeZC_LjM

Transforms an element by two control points (e.g. moving, skewing, resizing and rotation). You can position the control points on the bounding box edge midpoints or by the index of the nodes of the original path.
Thanks to Ivan Louette for the idea for this effect!

* Works on paths, shapes. With groups you have limited features constrained to bounding box.
* Allows snapping of both control points.
* Allows to fix angle or distance.
* Elastic mode to simulate a rubber band path.
* Two bounding box edge midpoints can be used as control points if 'From original width' is active.

[[File:TransformByTwoKnots.gif]]

=== Rotate copies ===

[[File:LPERotateCopies.png|170px|thumb|right|Rotate copies LPE]]

Extended video (partial fuse path): https://www.youtube.com/watch?v=UpI8gRbkTu4 
Extended video (live editing): https://www.youtube.com/watch?v=fBQpvfgT4mE 
Extended video (kaleidoscope): https://www.youtube.com/watch?v=LfMixSKy3Eo

Arranges identical elements dynamically on an arc or circle.

* Works on paths, shapes and groups of paths.
* Allows to fuse the result to create kaleidoscope-like effects
* Allows to arrange the copies on an arc when the 360° copies checkbox is not checked.
* Live editing.

=== Mirror Symmetry ===

[[File:LPEMirror.png|170px|thumb|right|Mirror LPE]]

Extended video: https://www.youtube.com/watch?v=m1sj4AeU3Yo

Mirrors an item dynamically.

* Works on paths, shapes and groups.
* Allows to fuse the result.
* Different mirror lines: Free, bounding box center X, bounding box center Y, Document center X, Document center Y.

=== Attach Path ===

[[File:LPEAttachPath.png|80px|thumb|right|Attach Path LPE]]

Connect a path to another path (optionally at each end), by attaching it to a specified location on the other path (specified as in <node number>.<fraction of segment length>, or by dragging a handle).

The connecting curve segment can be shaped with handles, or by entering a number.

This LPE makes it possible for the first time to have 'crossings' between paths that move with the path when it is modified, which isn't possible within the SVG specification.

=== Bounding Box ===

[[File:LPEBoundingBox.png|80px|thumb|right|Bounding Box LPE]]

An arbitrary path can be used to serve as a bounding box rectangle for the path that is linked. It will follow all transformations of the linked path. This can, for example, be used to provide a background for exporting as png.

=== Ellipse by 5 Points ===

[[File:LPEEllipse5Points.png|80px|thumb|right|Ellipse by 5 Points LPE]]

An ellipse will be constructed, whose circumference will go through each of the nodes of a 5-node path.

=== Fill between Many ===

[[File:LPEFillBetweenMany.png|80px|thumb|right|Fill Between Many LPE]]

Adds a fill to a collection of independent open paths, connecting their ends with straight lines.

* The LPE is applied to one path (which will be converted into the fill, and serves as a 'container' for the effect).
* The other paths, which are part of the drawing, can then be added to it by copy-pasting in the LPE dialog.
* The order in which the paths are filled can be changed, and the direction can be reversed for each path independently.

Now it is possible to apply the kind of path effects which only work on a path without subpaths (PowerStroke, Taper Stroke, ...) to the single paths (see image for an example).

=== Fill between Strokes ===

[[File:LPEFillBetweenStrokes.png|80px|thumb|right|Fill Between Strokes LPE]]

Similar to 'Fill between Many', but can only be used on two open paths, to fill them seamlessly.

* Requires a 'container' path, which will turn into the fill after the first path has been added to the LPE.
* Connects one couple of path ends with a stroke, if the path that functions as a container has a stroke set.
* Can also be used to apply a duplicate stroke.

=== Interpolate Points ===

[[File:LPEInterpolatePoints.png|80px|thumb|right|Interpolate Points LPE variations]]

This LPE redraws all path segments, using one of the following interpolation methods:

* Centripetal Catmull-Rom
* CubicBezierFit
* CubicBezierJohan
* Linear
* SpiroInterpolator

=== Join Type ===

[[File:LPEJoinTypepng.png|80px|thumb|right|Join Type LPE variations]]

The LPE allows you to set the type of connection to be used on cusp nodes and path end caps.

* Available join types:
** Beveled
** Extrapolated Arc
** Extrapolated Arc Alt1
** Extrapolated Arc Alt2
** Extrapolated Arc Alt3
** Miter
** Miter Clip
** Rounded
* Available end cap types:
** Butt
** Peak
** Rounded
** Square
* Set Miter limit
* Set stroke width

=== Taper Stroke ===

[[File:LPETaperStroke.png|80px|thumb|right|Taper Stroke LPE variations]]

Draw tapered strokes with different settings for open paths without subpaths.

* Change width of stroke ends with handles on both ends, or by entering offset numerically
* Different amounts of rounding can be applied
* Stroke width can be changed
* Join type for cusp nodes can be selected:
** Beveled
** Extrapolated
** Miter
** Rounded

== Pen / Bézier tool ==

* New shortcut to automatically close a path when it is being drawn: Shift + Enter

== Spray tool ==

Extended video 1 (No overlap): https://www.youtube.com/watch?v=uehj4ATOWos 
Extended video 2 (No overlap multiple items): https://www.youtube.com/watch?v=1eTG2U3qlb4 
Extended video 3 (Over visible, pick color): https://www.youtube.com/watch?v=aTdKu7mAZE8 
Extended video 4 (Pressure): https://www.youtube.com/watch?v=kWdQnxd_z30 
Extended video 5 (Trace -clones- dialog): https://www.youtube.com/watch?v=Zn3vzf-yA_w

* New eraser mode
* More pressure toggles added
* "No overlap" option with optional multiple elements
* "No overlap" option between different background colors
* Configurable offset for overlaps
* Color picker from center or average area
* Apply picked color to fill
* Apply picked color to stroke
* Invert picked colors
* Spray over transparent background areas
* Spray over non-transparent background areas
* Makes use of "Trace the drawing" options from Tiled Clones dialog

== Measure tool ==

Extended video: https://www.youtube.com/watch?v=OE0cVDGCzbM

* Measure is kept until a new one is made (only visible when using measure tool)
* Repositioning of origin/end
* Convert to object
* Convert to guides
* Add just the distance measurement, consisting of editable text and a line indicating start and end
* Display a 'phantom measurement' temporarily to be able to compare two measurements
* Reverse origin/end
* Measure global
* Measure only current layer
* Change precision

== Gradient tool ==

* To accomodate for keyboards that do not have an Insert key, the keyboard combination '''Shift+I''' can now also be used to insert a new stop into a gradient.

== Align and Distribute ==

* NEW: drop-down chooser with options to align nodes relative to each other in node editing mode.

== Import / Export ==

=== Export PDF / EPS / PS ===

* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

=== Export Optimized SVG ===

* Completely redesigned settings dialog
* Starting with version 0.92, Inkscape uses the Scour version installed on the system (e.g. via "pip install scour") instead of a bundled version so you can always profit from the latest improvements
* A lot of new features and fixes in the Scour module itself, check out the [https://github.com/scour-project/scour/blob/master/HISTORY.md release notes] (Scour 0.26 from 2011-05-09 was the version that has been bundled with Inkscape 0.91)

=== Export to PNG ===

* PNG file extension is now enforced, to prevent exporting with invalid / misleading file extensions.

== Extensions ==

=== New ===
* Render > '''Seamless Pattern''' ([https://www.youtube.com/watch?v=MYGKAF7EPFY Screencast])
* Images > '''Set Image Attributes''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/1357808 1357808], can be used to fix the scaling problem of raster images in SVGs created with previous Inkscape versions)
* Render > '''NiceCharts''' ([https://github.com/Moini/NiceCharts/tree/patch-1 github repo, not maintained])
* Arrange > '''Deep Ungroup''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/171117 171117])

=== Plotter Driver ===

==== Multiple Pens ====

The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:

* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====

The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

=== PDF Import ===

The image 'interpolate' value is now used to determine how to display bitmaps (interpolated or blocky).

=== Miscellaneous Improvements ===

* Arrange > '''Restack''' has new options to reverse and shuffle the z-order of selected objects.
* Render > '''Random Tree''' has new option to omit redundant segments.
* Visualize Path > '''Measure Path''' has additional text layout options.
* Render > '''Barcode''' was updated with new EAN2 code and extended EAN13 with automatic EAN2 and EAN5 additions
* Color > '''Randomize''' now allows to set the range for randomization, and (with some limits) can now also randomize opacity
* Modify Path > '''Jitter nodes''' was partially rewritten and now also supports Pareto and Log-Normal distributions.

=== Extension Development ===

* It is now possible for an extension to retrieve a list of selected nodes (See Bug #[https://bugs.launchpad.net/inkscape/+bug/171287 171287] for an example extension).

== Filters / Blend Modes ==

=== New Filters ===

* Color > '''Color Blindness''' filter allows to simulate different color blindness conditions.

=== New Blend Modes ===

Blend Modes can now be applied to '''single objects as well as to layers'''.

In addition to the previously available modes 'Multiply', 'Screen', 'Darken' and 'Lighten', the following modes are now available:

* Overlay
* Color Dodge
* Color Burn
* Hard Light
* Soft Light
* Difference
* Exclusion
* Hue
* Saturation
* Color
* Luminosity

== Other dialogs ==

=== Document Properties: Licences ===

All selectable licences have been updated to most current version.

=== Filter Editor ===

Filter list now displays how often a filter is used.

== Menus ==

* 'Resize page to selection' added to Edit menu, shortcut: Shift+Ctrl+R
* 'Pop selection out of group' available in context menu of objects which are part of a group, when the group has been entered, and via the 'Objects' menu. It will move the object up by one level in the grouping hierarchy.
* 'Create Clip Group' from context menu groups the selected objects and clips that group with a clone of itself. This allows for quick creation of, for example, inset shadows.

== Other user interface ==

=== Node Snapping ===

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

=== Checkerboard Background ===

It is now possible to use a checkerboard background when editing. This allows one to clearly see the transparency of objects. (See "Page" tab of the "Document Properties" dialog.)

=== View Box ===

One can now set the SVG 'viewBox' attribute from the GUI. This attribute sets the ''scale'' of the drawing by determining the real-world value of the SVG ''user unit'' (pixel size).

=== Lock Guides ===

Now guides can be locked and unlocked globally or individually.

=== Panning ===

Panning with space bar can now be deactivated in the Preferences (uncheck Behavior > Scrolling > Mouse Move pans when Space is pressed).

== SVG and CSS ==

* The 'marker-orientation' property now recognizes units ('deg', 'rad', 'grad' and 'turn').
* The new SVG 2 'context-fill' and 'context-stroke' properties are implemented which allows the auto-matching of arrowhead fill color to path stroke color.
* The new SVG 2 marker orientation attribute value 'auto-start-reverse' is implemented. This allows one arrow marker to be used for both ends of a path.
* The new CSS 3 'mix-blend-mode' and 'isolation' properties are implemented, allowing setting the blend mode between objects without using filters.
* The new SVG 2 'paint-order' property is now supported. This allows setting the order in which the fill, stroke, and markers are drawn (see the 'Stroke style' tab in the 'Fill and Stroke' dialog).
* The SVG 1.2/SVG 2 'vector-effect' property's 'non-scaling-stroke' value is now supported. This will keep the stroke width fixed regardless of the zoom factor.
* The new SVG 2 'mesh' paint server is supported, including bicubic ''auto-smoothing''. A primitive GUI is available.
* The SVG 1.1 'text-decoration' property is now rendered (underlines, strike through, etc.). CSS 3 'text-decoration' properties are also rendered.
* The new SVG 2 'hatch' paint server is now supported.
* The CSS 'white-space' property is now supported. Use of this property was added in SVG 2 to replace the now deprecated 'xml:space' attribute.
* The SVG 1.1 'textLength" and 'textAdjust' attributes are implemented, however, there is no GUI for these attributes.
* Rendering of the Component Transfer filter primitive has been corrected.
* Units are now recognized in the text and tspan 'x', 'y', 'dx', and 'dy' attributes.
* Percentage values are now interpreted correctly for shapes.

New SVG 2 and CSS 3 features are generally not enabled in the GUI until widespread support in browsers.

== New dependencies ==

* The Paintbucket and Trace Bitmap tools now use an external copy of the Potrace library, which is available in many Linux distributions or can be obtained from http://potrace.sourceforge.net
* Export to Optimized SVG now depends upon an external copy of the Scour python module, which can be obtained via pip (pip install scour), package management (version may be outdated) or from the [https://github.com/scour-project/scour/releases scour project github site]. For Windows versions, the module is included.

== Translations ==

New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Icelandic, Kannada, Kashmiri (Perso-Arabic and Devanagari), Konkani (Latin and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devanagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

Many other translations have been updated and improved.

== Notable Bugfixes ==

* Severe performance issues on MS Windows, 64bit Inkscape builds on systems with Intel graphic cards (hiding the rulers was a workaround for Inkscape 0.91) ([https://bugs.launchpad.net/inkscape/+bug/1351597 bug #1351597])
* On MS Windows, 64bit Inkscape builds, printing may result in mostly black pages when partial opacity is used in the document ([https://bugs.launchpad.net/inkscape/+bug/1418865 bug #1418865])
* Printing offsets page (Windows) ([https://bugs.launchpad.net/inkscape/+bug/918319 bug #918319])
* "Tiled Clones" inside transformed groups/layers in resized documents are displaced ([https://bugs.launchpad.net/inkscape/+bug/168651 bug #168651])
* Displaced clones, offsets ([https://bugs.launchpad.net/inkscape/+bug/844909 bug #844909], [https://bugs.launchpad.net/inkscape/+bug/653574 bug #653574], [https://bugs.launchpad.net/inkscape/+bug/1152657 bug #1152657], [https://bugs.launchpad.net/inkscape/+bug/1245339 bug #1245339], [https://bugs.launchpad.net/inkscape/+bug/168013 bug #168013], [https://bugs.launchpad.net/inkscape/+bug/177751 bug #177751])
* Crash on quit before saving has completed, resulting in incompletely saved files ([https://bugs.launchpad.net/inkscape/+bug/967416 bug #967416])
* Guides: Colour not rendered opening saved document ([https://bugs.launchpad.net/inkscape/+bug/1374870 bug #1374870])
* Text tool: Fails to set new default font family ([https://bugs.launchpad.net/inkscape/+bug/1227232 bug #1227232])
* Extensions: Failure with documents lacking width/height attributes ([https://bugs.launchpad.net/inkscape/+bug/1461346 bug #1461346], [https://bugs.launchpad.net/inkscape/+bug/1463623 bug #1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) ([https://bugs.launchpad.net/inkscape/+bug/1269698 bug #1269698])
* Text rendering cuts off trailing character ([https://bugs.launchpad.net/inkscape/+bug/1283194 bug #1283194], [https://bugs.launchpad.net/inkscape/+bug/1450675 bug #1450675])
* Paste style - markers are omitted ([https://bugs.launchpad.net/inkscape/+bug/1467674 bug #1467674])
* DXF export doesn't support <line> and <circle> elements ([https://bugs.launchpad.net/inkscape/+bug/1474347 bug #1474347], [https://bugs.launchpad.net/inkscape/+bug/1489320 bug #1489320])
* Crash when importing raster images of different file types ([https://bugs.launchpad.net/inkscape/+bug/1467103 bug #1467103])
* Filter effects and blur quality options broken ([https://bugs.launchpad.net/inkscape/+bug/1512729 bug #1512729]) (To get the same render quality in 0.92 as you had in 0.91, you need to set filter effects quality to 'Better' and the blur quality to 'Average'.)
* Shape: 'Triangle in' and 'Triangle out' are identical ([https://bugs.launchpad.net/inkscape/+bug/1525401 bug #1525401])

Many other crashes, memory leaks and lots of little things have also been fixed. For an exhaustive list of bugs that have been fixed, please see the [https://launchpad.net/inkscape/+milestone/0.92 milestones page for Inkscape 0.92] and the [https://launchpad.net/inkscape/+milestone/0.91.1 milestones page for the (not released) Inkscape version 0.91.1].

== Known Issues ==

* Fonts that are loaded by font managing software on Windows are not available for selection in Inkscape ([https://bugs.launchpad.net/inkscape/+bug/1416674 bug #1416674])
* Dialogs that have been minimized do not open again until their icon in the dock is clicked on ([https://bugs.launchpad.net/inkscape/+bug/1270295 bug #1270295], will be fixed in 0.93)
* The opacity indicator isn't initialized correctly (0% opacity even when the object is fully opaque, [https://bugs.launchpad.net/inkscape/+bug/1463078 bug #1463078], will be fixed in 0.93)
* For some texts, the line height that is used for displaying the text in 0.91 doesn't correspond to the one that is used in 0.92, so line height is larger than it should be (as a workaround, [https://bugs.launchpad.net/inkscape/+bug/1652340 there is an extension available that can fix those texts]).

[Please fill in]

== Previous releases ==
* [[Release notes/0.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Release notes/0.92

2016-10-05T09:42:19Z

~suv: /* Geometric Construction Tool */ remove section describing an (unstable) experimental LPE feature

{{Other languages|en=Release_notes/0.92}}

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* The new Object dialog allows to select, label, hide and lock any object in the drawing from a dialog that lists them all
* Selection sets make it possible to 'group' objects together regardless of document structure
* Guides can now be locked to avoid accidental movement
* Several new path effects have been added, among them Envelope/Perspective, Lattice Deformation, Mirror and Rotate Copies
* There are several new extensions (e.g. a seamless pattern extension) and a new filter (colorblindness simulation) included in the release, many old extensions have been updated or got new features
* Many SVG2 and CSS3 properties are now supported for rendering (e.g. paint-order, mix-blend-mode)
* Spray tool and measure tool received a set of nifty new features
* Interactive smoothing for lines created with the Pencil tool
* BSplines (and more) are available for the Pen tool
* Checkerboard background can be used to more easily see object transparencies

[Please, if someone knows that any of these will not be in the release, remove them from the list. Should we add the font features, too?]

== Manipulating Objects ==

=== Objects Dialog ===

New dialog for manipulating the object tree.

* Drag and drop reordering of objects.
* Find, lock, and hide individual items.
* Shows individual objects as well as layers.
* Ability to change highlight color of objects.
* Ability to set blend mode per object.

Imported from Ponyscape.

=== Selection Sets Dialog ===

New dialog that allows the creation of selection sets that are not affected by document structure.

Usage:

* '''Open''' Dialog with 'Object > Selection sets'

* To '''create''' a new selection set:
# Click on the '+' button at the bottom of the dialog to create a new selection set (double-click on its label to edit)

* To '''add objects''' to a selection set:
# select object on the canvas
# in the 'Selection sets' dialog click on the '+' icon before the selection set in the list

* To '''select all objects''' of a selection set:
# deselect any existing selection and click on the selection set in the list

* To '''remove an object''' from a selection set
# select the selection set in the dialog
# click on 'Items' to show all objects in the set
# select an object on the canvas or in the Items list in the dialog
# click on the 'Delete' icon (trashbin) before the object in the list

* To '''delete a selection set''', select it in the list and click on the '-' button at the bottom of the dialog

== Text ==

=== Font Features ===

It is now possible to take advantage of OpenType tables to select alternative glyphs from a font. Note that browser support is still limited. Inkscape must also be linked with a recent version of the Pango library.

=== Vertical Text ===

Support for vertical text layout has been improved.
* The default behavior for Latin bases glyphs has been changed. They are now rotated sideways as required by the SVG 1.1 standard.
* Support for the CSS 3 'text-orientation' property has been added. (Note that this property is not yet fully supported by browsers.)
* The CSS 3 values for the 'writing-mode' property are supported in rendering. Saving still uses the deprecated SVG 1.1 values.

=== Accessibility ===

Converting text to a path will save the text in the 'aria-label' attribute. This is useful for accessibility and could eventually be used by Inkscape to reconstruct the text.

== Live Path Effects ==
Now some suitable LPE's are applied to clips and mask. 
Helper lines come again to live 
Added to pen/pencil shape combo box the option to add a bend path directly 

==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3333 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions + a global randomizer.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

Add deformations by a mesh. 
Vertical,horizontal or both symmetry.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

==== Transform by two points ====
[[File:TransformByTwoKnots.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw 
Extended video (Elastic rubber): https://www.youtube.com/watch?v=lOWTeZC_LjM

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups with less power.
* Allow snapping of both control points
* Allow fix angle or distance.
* Elastic mode to simulate a flex path
* From original width, set the control points based on bounding box

[[File:TransformByTwoKnots.gif]]

==== Rotate copies ====
[[File:RotateCopies.png|170px|thumb|right]]
Extended video (partial fuse path): https://www.youtube.com/watch?v=UpI8gRbkTu4 
Extended video (live editing): https://www.youtube.com/watch?v=fBQpvfgT4mE 
Extended video (kaleidoscope): https://www.youtube.com/watch?v=LfMixSKy3Eo 

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups.
* Allow fuse the result to make kaleidoscope
* Allow non 360 fuse.
* Live editing

==== Mirror Symmetry ====
Extended video: https://www.youtube.com/watch?v=m1sj4AeU3Yo 
Mirror a item

* Works on paths, shapes and groups.
* Allows to fuse the result
* Different mirror lines: Free, X, Y, Middle Document[X], Middle Document[Y]

== Spray tool ==
Extended video 1 (No overlap): https://www.youtube.com/watch?v=uehj4ATOWos 
Extended video 2 (No overlap multiple items): https://www.youtube.com/watch?v=1eTG2U3qlb4 
Extended video 3 (Over visible, pick color): https://www.youtube.com/watch?v=aTdKu7mAZE8 
Extended video 4 (Pressure): https://www.youtube.com/watch?v=kWdQnxd_z30 
Extended video 5 (Trace -clones- dialog): https://www.youtube.com/watch?v=Zn3vzf-yA_w 
todo: a video showing all features joined

* New eraser mode
* More pressure toggles added
* "No overlap" option with optional multiple elements
* "No overlap" option between different background colors
* Configurable offset for overlaps
* Color picker from center or average area
* Apply picked color to fill
* Apply picked color to stroke
* Invert picked colors
* Spray over transparent background areas
* Spray over non-transparent background areas
* Makes use of "Trace the drawing" options from Tiled Clones dialog

== Measure tool ==
Extended video: https://www.youtube.com/watch?v=OE0cVDGCzbM

* Persistent measure
* Reposition of origin/end
* Convert to measure item
* Convert to guides
* Convert measure to quote
* Reverse origin/end
* Measure global
* Measure only current layer
* Add precision
* Add scale

== Align and Distribute ==
* NEW: drop-down chooser with options to align nodes relative to each other in node editing mode.

== File Format Support ==
* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

== Extensions ==

=== New ===
* Render > '''Seamless Pattern''' ([https://www.youtube.com/watch?v=MYGKAF7EPFY Screencast])
* Images > '''Set Image Attributes''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/1357808 1357808])
* Render > '''NiceCharts''' ([https://github.com/Moini/NiceCharts/tree/patch-1 github repo, not maintained])
* Arrange > '''Deep Ungroup''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/171117 171117])

=== Plotter Driver ===

==== Multiple Pens ====
The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:
* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====
The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

=== PDF Import ===

The image 'interpolate' value is now used to determine how to display bitmaps (interpolated or blocky).

=== Miscellaneous Improvements ===
* Arrange > '''Restack''' has new options to reverse and shuffle the z-order of selected objects.
* Render > '''Random Tree''' has new option to omit redundant segments.
* Visualize Path > '''Measure Path''' has additional text layout options.
* Render > '''Barcode''' was updated with new EAN2 code and extended EAN13 with automatic EAN2 and EAN5 additions

=== Extension Development ===
* It is now possible for an extension to retrieve a list of selected nodes (Bug #[https://bugs.launchpad.net/inkscape/+bug/171287 171287]).

== Filters ==
=== New ===
* Color > '''Color Blindness''' filter allows to simulate different color blindness conditions.

== Other dialogs ==

=== Document Properties: Licences ===

All selectable licences have been updated to most current version.

=== Filter Editor ===

Filter list now displays how often a filter is used.

== Menus ==

* 'Resize page to selection' added to Edit menu, shortcut: Shift+Ctrl+R

== Other user interface ==

=== Node Snapping ===

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

=== Checkerboard Background ===

It is now possible to use a checkerboard background when editing. This allows one to clearly see the transparency of objects.

=== View Box ===

One can now set the SVG 'viewBox' attribute from the GUI. This attribute sets the scale of the drawing by determining the real-world value of the SVG user unit (pixel size).

=== Lock Guides ===

Now guides can be locked and unlocked globally or individually.

== SVG and CSS ==

* The 'marker-orientation' property now recognizes units ('deg', 'rad', 'grad' and 'turn').
* The new SVG 2 'context-fill' and 'context-stroke' properties are implemented which allows the auto-matching of arrowhead fill color to path stroke color.
* The new SVG 2 marker orientation attribute value 'auto-start-reverse' is implemented. This allows one arrow marker to be used for both ends of a path.
* The new CSS 3 'mix-blend-mode' and 'isolation' properties are implemented, allowing setting the blend mode between objects without using filters.
* The new SVG 2 'paint-order' property is now supported. This allows setting the order in which the fill, stroke, and markers are drawn (buttons will be available in the Fill and Stroke dialog).
* The new SVG 2 'mesh' paint server is supported, including bicubic auto-smoothing. A primitive GUI is available.
* The SVG 1.1 'text-decoration' property is now rendered (underlines, strike through, etc.). CSS 3 'text-decoration' properties are also rendered.
* The new SVG 2 'hatch' paint server is now supported.
* The CSS 'white-space' property is now supported. Use of this property was added in SVG 2 to replace the now deprecated 'xml;space' attribute.
* The SVG 1.1 'textLength" and 'textAdjust' attributes are implemented, however, there is no GUI for these attributes.
* Rendering of the Component Transfer filter primitive has been corrected.
* Units are now recognized in the text and tspan 'x', 'y', 'dx', and 'dy' attributes.
* Percentage values are now interpreted correctly for shapes.

New SVG 2 and CSS 3 features are generally not enabled in the GUI until widespread support in browsers.

== New dependencies ==

The Paintbucket and Trace Bitmap tools now use an external copy of the Potrace library, which is available in many Linux distributions or can be obtained from http://potrace.sourceforge.net

== Translations ==
New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Kannada, Kashmiri (Perso-Arabic and Devanagari), Kokani (Roman and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devnagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

== Notable Bugfixes ==

[Please fill in]

== Known Issues ==

[ Please fill in - unit change, extension]

==Previous releases==
* [[Release notes/0.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Release notes/0.92

2016-06-19T18:42:18Z

~suv: /* Geometric Construction Tool */ add link to related report tracking required changes to all build systems

{{Other languages|en=Release_notes/0.92}}

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* The new Object dialog allows to select, label, hide and lock any object in the drawing from a dialog that lists them all
* Selection sets make it possible to 'group' objects together regardless of document structure
* Guides can now be locked to avoid accidental movement
* Several new path effects have been added, among them Envelope/Perspective, Lattice Deformation, Mirror and Rotate Copies
* There are several new extensions (e.g. a seamless pattern extension) and a new filter (colorblindness simulation) included in the release, many old extensions have been updated or got new features
* Many SVG2 and CSS3 properties are now supported for rendering (e.g. paint-order, mix-blend-mode)
* Spray tool and measure tool received a set of nifty new features
* Interactive smoothing for lines created with the Pencil tool
* BSplines (and more) are available for the Pen tool
* Checkerboard background can be used to more easily see object transparencies

[Please, if someone knows that any of these will not be in the release, remove them from the list. Should we add the font features, too?]

== Manipulating Objects ==

=== Objects Dialog ===

New dialog for manipulating the object tree.

* Drag and drop reordering of objects.
* Find, lock, and hide individual items.
* Shows individual objects as well as layers.
* Ability to change highlight color of objects.
* Ability to set blend mode per object.

Imported from Ponyscape.

=== Selection Sets Dialog ===

New dialog that allows the creation of selection sets that are not affected by document structure.

Usage:

* '''Open''' Dialog with 'Object > Selection sets'

* To '''create''' a new selection set:
# Click on the '+' button at the bottom of the dialog to create a new selection set (double-click on its label to edit)

* To '''add objects''' to a selection set:
# select object on the canvas
# in the 'Selection sets' dialog click on the '+' icon before the selection set in the list

* To '''select all objects''' of a selection set:
# deselect any existing selection and click on the selection set in the list

* To '''remove an object''' from a selection set
# select the selection set in the dialog
# click on 'Items' to show all objects in the set
# select an object on the canvas or in the Items list in the dialog
# click on the 'Delete' icon (trashbin) before the object in the list

* To '''delete a selection set''', select it in the list and click on the '-' button at the bottom of the dialog

== Text ==

=== Font Features ===

It is now possible to take advantage of OpenType tables to select alternative glyphs from a font. Note that browser support is still limited. Inkscape must also be linked with a recent version of the Pango library.

=== Vertical Text ===

Support for vertical text layout has been improved.
* The default behavior for Latin bases glyphs has been changed. They are now rotated sideways as required by the SVG 1.1 standard.
* Support for the CSS 3 'text-orientation' property has been added. (Note that this property is not yet fully supported by browsers.)
* The CSS 3 values for the 'writing-mode' property are supported in rendering. Saving still uses the deprecated SVG 1.1 values.

=== Accessibility ===

Converting text to a path will save the text in the 'aria-label' attribute. This is useful for accessibility and could eventually be used by Inkscape to reconstruct the text.

== Live Path Effects ==
Now some suitable LPE's are applied to clips and mask. 
Helper lines come again to live 
Added to pen/pencil shape combo box the option to add a bend path directly 

==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3333 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions + a global randomizer.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

Add deformations by a mesh. 
Vertical,horizontal or both symmetry.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

==== Transform by two points ====
[[File:TransformByTwoKnots.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw 
Extended video (Elastic rubber): https://www.youtube.com/watch?v=lOWTeZC_LjM

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups with less power.
* Allow snapping of both control points
* Allow fix angle or distance.
* Elastic mode to simulate a flex path
* From original width, set the control points based on bounding box

[[File:TransformByTwoKnots.gif]]

==== Rotate copies ====
[[File:RotateCopies.png|170px|thumb|right]]
Extended video (partial fuse path): https://www.youtube.com/watch?v=UpI8gRbkTu4 
Extended video (live editing): https://www.youtube.com/watch?v=fBQpvfgT4mE 
Extended video (kaleidoscope): https://www.youtube.com/watch?v=LfMixSKy3Eo 

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups.
* Allow fuse the result to make kaleidoscope
* Allow non 360 fuse.
* Live editing

==== Mirror Symmetry ====
Extended video: https://www.youtube.com/watch?v=m1sj4AeU3Yo 
Mirror a item

* Works on paths, shapes and groups.
* Allows to fuse the result
* Different mirror lines: Free, X, Y, Middle Document[X], Middle Document[Y]

== Spray tool ==
Extended video 1 (No overlap): https://www.youtube.com/watch?v=uehj4ATOWos 
Extended video 2 (No overlap multiple items): https://www.youtube.com/watch?v=1eTG2U3qlb4 
Extended video 3 (Over visible, pick color): https://www.youtube.com/watch?v=aTdKu7mAZE8 
Extended video 4 (Pressure): https://www.youtube.com/watch?v=kWdQnxd_z30 
Extended video 5 (Trace -clones- dialog): https://www.youtube.com/watch?v=Zn3vzf-yA_w 
todo: a video showing all features joined

* New eraser mode
* More pressure toggles added
* "No overlap" option with optional multiple elements
* "No overlap" option between different background colors
* Configurable offset for overlaps
* Color picker from center or average area
* Apply picked color to fill
* Apply picked color to stroke
* Invert picked colors
* Spray over transparent background areas
* Spray over non-transparent background areas
* Makes use of "Trace the drawing" options from Tiled Clones dialog

== Measure tool ==
Extended video: https://www.youtube.com/watch?v=OE0cVDGCzbM

* Persistent measure
* Reposition of origin/end
* Convert to measure item
* Convert to guides
* Convert measure to quote
* Reverse origin/end
* Measure global
* Measure only current layer
* Add precision
* Add scale

== Geometric Construction Tool ==

* Helps to create: line segments, circles by specific points, parallels, perpendicular lines, angle bisectors, mirrored paths by applying a Live Path Effect.
[Needs usage instructions!]

[Note: the LPE tool (and experimental LPEs) need to be disabled in the stable release branch (it's ok to have them enabled in unstable trunk: helps preventing bit-rot of experimental / unfinished path effects considered experimental), and this section removed from the release notes. The disabling of experimental features in the stable release branch is tracked in [https://bugs.launchpad.net/inkscape/+bug/1589340 Bug #1589340].]

== Align and Distribute ==
* NEW: drop-down chooser with options to align nodes relative to each other in node editing mode.

== File Format Support ==
* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

== Extensions ==

=== New ===
* Render > '''Seamless Pattern''' ([https://www.youtube.com/watch?v=MYGKAF7EPFY Screencast])
* Images > '''Set Image Attributes''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/1357808 1357808])
* Render > '''NiceCharts''' ([https://github.com/Moini/NiceCharts/tree/patch-1 github repo, not maintained])
* Arrange > '''Deep Ungroup''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/171117 171117])

=== Plotter Driver ===

==== Multiple Pens ====
The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:
* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====
The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

=== PDF Import ===

The image 'interpolate' value is now used to determine how to display bitmaps (interpolated or blocky).

=== Miscellaneous Improvements ===
* Arrange > '''Restack''' has new options to reverse and shuffle the z-order of selected objects.
* Render > '''Random Tree''' has new option to omit redundant segments.
* Visualize Path > '''Measure Path''' has additional text layout options.
* Render > '''Barcode''' was updated with new EAN2 code and extended EAN13 with automatic EAN2 and EAN5 additions

=== Extension Development ===
* It is now possible for an extension to retrieve a list of selected nodes (Bug #[https://bugs.launchpad.net/inkscape/+bug/171287 171287]).

== Filters ==
=== New ===
* Color > '''Color Blindness''' filter allows to simulate different color blindness conditions.

== Other dialogs ==

=== Document Properties: Licences ===

All selectable licences have been updated to most current version.

=== Filter Editor ===

Filter list now displays how often a filter is used.

== Menus ==

* 'Resize page to selection' added to Edit menu, shortcut: Shift+Ctrl+R

== Other user interface ==

=== Node Snapping ===

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

=== Checkerboard Background ===

It is now possible to use a checkerboard background when editing. This allows one to clearly see the transparency of objects.

=== View Box ===

One can now set the SVG 'viewBox' attribute from the GUI. This attribute sets the scale of the drawing by determining the real-world value of the SVG user unit (pixel size).

=== Lock Guides ===

Now guides can be locked and unlocked globally or individually.

== SVG and CSS ==

* The 'marker-orientation' property now recognizes units ('deg', 'rad', 'grad' and 'turn').
* The new SVG 2 'context-fill' and 'context-stroke' properties are implemented which allows the auto-matching of arrowhead fill color to path stroke color.
* The new SVG 2 marker orientation attribute value 'auto-start-reverse' is implemented. This allows one arrow marker to be used for both ends of a path.
* The new CSS 3 'mix-blend-mode' and 'isolation' properties are implemented, allowing setting the blend mode between objects without using filters.
* The new SVG 2 'paint-order' property is now supported. This allows setting the order in which the fill, stroke, and markers are drawn (buttons will be available in the Fill and Stroke dialog).
* The new SVG 2 'mesh' paint server is supported, including bicubic auto-smoothing. A primitive GUI is available.
* The SVG 1.1 'text-decoration' property is now rendered (underlines, strike through, etc.). CSS 3 'text-decoration' properties are also rendered.
* The new SVG 2 'hatch' paint server is now supported.
* The CSS 'white-space' property is now supported. Use of this property was added in SVG 2 to replace the now deprecated 'xml;space' attribute.
* The SVG 1.1 'textLength" and 'textAdjust' attributes are implemented, however, there is no GUI for these attributes.
* Rendering of the Component Transfer filter primitive has been corrected.
* Units are now recognized in the text and tspan 'x', 'y', 'dx', and 'dy' attributes.
* Percentage values are now interpreted correctly for shapes.

New SVG 2 and CSS 3 features are generally not enabled in the GUI until widespread support in browsers.

== New dependencies ==

The Paintbucket and Trace Bitmap tools now use an external copy of the Potrace library, which is available in many Linux distributions or can be obtained from http://potrace.sourceforge.net

== Translations ==
New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Kannada, Kashmiri (Perso-Arabic and Devanagari), Kokani (Roman and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devnagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

== Notable Bugfixes ==

[Please fill in]

== Known Issues ==

[ Please fill in - unit change, extension]

==Previous releases==
* [[Release notes/0.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Release notes/0.92

2016-06-05T21:19:37Z

~suv: /* Geometric Construction Tool */

{{Other languages|en=Release_notes/0.92}}

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

== Manipulating Objects ==

=== Objects Dialog ===

New dialog for manipulating the object tree.

* Drag and drop reordering of objects.
* Find, lock, and hide individual items.
* Shows individual objects as well as layers.
* Ability to change highlight color of objects.
* Ability to set blend mode per object.

Imported from Ponyscape.

=== Selection Sets Dialog ===

New dialog that allows the creation of selection sets that are not affected by document structure.

Usage:

* '''Open''' Dialog with 'Object > Selection sets'

* To '''create''' a new selection set:
# Click on the '+' button at the bottom of the dialog to create a new selection set (double-click on its label to edit)

* To '''add objects''' to a selection set:
# select object on the canvas
# in the 'Selection sets' dialog click on the '+' icon before the selection set in the list

* To '''select all objects''' of a selection set:
# deselect any existing selection and click on the selection set in the list

* To '''remove an object''' from a selection set
# select the selection set in the dialog
# click on 'Items' to show all objects in the set
# select an object on the canvas or in the Items list in the dialog
# click on the 'Delete' icon (trashbin) before the object in the list

* To '''delete a selection set''', select it in the list and click on the '-' button at the bottom of the dialog

== Text ==

=== Font Features ===

It is now possible to take advantage of OpenType tables to select alternative glyphs from a font. Note that browser support is still limited. Inkscape must also be linked with a recent version of the Pango library.

=== Vertical Text ===

Support for vertical text layout has been improved.
* The default behavior for Latin bases glyphs has been changed. They are now rotated sideways as required by the SVG 1.1 standard.
* Support for the CSS 3 'text-orientation' property has been added. (Note that this property is not yet fully supported by browsers.)
* The CSS 3 values for the 'writing-mode' property are supported in rendering. Saving still uses the deprecated SVG 1.1 values.

=== Accessibility ===

Converting text to a path will save the text in the 'aria-label' attribute. This is useful for accessibility and could eventually be used by Inkscape to reconstruct the text.

== Live Path Effects ==
Now some suitable LPE's are applied to clips and mask. 
Helper lines come again to live 
Added to pen/pencil shape combo box the option to add a bend path directly 

==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3333 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions + a global randomizer.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

Add deformations by a mesh. 
Vertical,horizontal or both symmetry.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

==== Transform by two points ====
[[File:TransformByTwoKnots.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw 
Extended video (Elastic rubber): https://www.youtube.com/watch?v=lOWTeZC_LjM

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups with less power.
* Allow snapping of both control points
* Allow fix angle or distance.
* Elastic mode to simulate a flex path
* From original width, set the control points based on bounding box

[[File:TransformByTwoKnots.gif]]

==== Rotate copies ====
[[File:RotateCopies.png|170px|thumb|right]]
Extended video (partial fuse path): https://www.youtube.com/watch?v=UpI8gRbkTu4 
Extended video (live editing): https://www.youtube.com/watch?v=fBQpvfgT4mE 
Extended video (kaleidoscope): https://www.youtube.com/watch?v=LfMixSKy3Eo 

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups.
* Allow fuse the result to make kaleidoscope
* Allow non 360 fuse.
* Live editing

==== Mirror Symmetry ====
Extended video: https://www.youtube.com/watch?v=m1sj4AeU3Yo 
Mirror a item

* Works on paths, shapes and groups.
* Allows to fuse the result
* Different mirror lines: Free, X, Y, Middle Document[X], Middle Document[Y]

== Spray tool ==
Extended video 1 (No overlap): https://www.youtube.com/watch?v=uehj4ATOWos 
Extended video 2 (No overlap multiple items): https://www.youtube.com/watch?v=1eTG2U3qlb4 
Extended video 3 (Over visible, pick color): https://www.youtube.com/watch?v=aTdKu7mAZE8 
Extended video 4 (Pressure): https://www.youtube.com/watch?v=kWdQnxd_z30 
Extended video 5 (Trace -clones- dialog): https://www.youtube.com/watch?v=Zn3vzf-yA_w 
todo: a video showing all features joined

* New mode eraser
* Add more pressure toggles
* No overlap option with optional multiple elements
* No overlap between colors
* Configurable offset for overlaps
* Color picker from center or average area
* Apply color picked to fill
* Apply color picked to stroke
* Invert picked colors
* Spray over transparent
* Spray over non-transparent
* Allow picker enabled sprays to use "Trace Clones" options

== Measure tool ==
Extended video: https://www.youtube.com/watch?v=OE0cVDGCzbM

* Persistent measure
* Reposition of origin/end
* Convert to measure item
* Convert to guides
* Convert measure to quote
* Reverse origin/end
* Measure global
* Measure only current layer
* Add precision
* Add scale

== Geometric Construction Tool ==

* Helps to create: line segments, circles by specific points, parallels, perpendicular lines, angle bisectors, mirrored paths by applying a Live Path Effect.
[Needs usage instructions!]

[Note: AFAIU the LPE tool (and experimental LPEs) need to be disabled in the stable release branch (it's ok to have them enabled in unstable trunk: helps preventing bit-rot of experimental / unfinished path effects considered experimental), and this section removed from the release notes.]

== Align and Distribute ==
* NEW: drop-down chooser with options to align nodes relative to each other in node editing mode.

== File Format Support ==
* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

== Extensions ==

=== New ===
* Render > '''Seamless Pattern''' ([https://www.youtube.com/watch?v=MYGKAF7EPFY Screencast])
* Images > '''Set Image Attributes''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/1357808 1357808])
* Render > '''NiceCharts''' ([https://github.com/Moini/NiceCharts/tree/patch-1 github repo, not maintained])
* Arrange > '''Deep Ungroup''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/171117 171117])

=== Plotter Driver ===

==== Multiple Pens ====
The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:
* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====
The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

=== PDF Import ===

The image 'interpolate' value is now used to determine how to display bitmaps (interpolated or blocky).

=== Miscellaneous Improvements ===
* Arrange > '''Restack''' has new options to reverse and shuffle the z-order of selected objects.
* Render > '''Random Tree''' has new option to omit redundant segments.
* Visualize Path > '''Measure Path''' has additional text layout options.
* Render > '''Barcode''' was updated with new EAN2 code and extended EAN13 with automatic EAN2 and EAN5 additions

=== Extension Development ===
* It is now possible for an extension to retrieve a list of selected nodes (Bug #[https://bugs.launchpad.net/inkscape/+bug/171287 171287]).

== Filters ==
=== New ===
* Color > '''Color Blindness''' filter allows to simulate different color blindness conditions.

== Other dialogs ==

=== Document Properties: Licences ===

All selectable licences have been updated to most current version.

=== Filter Editor ===

Filter list now displays how often a filter is used.

== Menus ==

* 'Resize page to selection' added to Edit menu, shortcut: Shift+Ctrl+R

== Other user interface ==

=== Node Snapping ===

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

=== Checkerboard Background ===

It is now possible to use a checkerboard background when editing. This allows one to clearly see the transparency of objects.

=== View Box ===

One can now set the SVG 'viewBox' attribute from the GUI. This attribute sets the scale of the drawing by determining the real-world value of the SVG user unit (pixel size).

=== Lock Guides ===

Now guides can be locked and unlocked globally or individually.

== SVG and CSS ==

* The 'marker-orientation' property now recognizes units ('deg', 'rad', 'grad' and 'turn').
* The new SVG 2 'context-fill' and 'context-stroke' properties are implemented which allows the auto-matching of arrowhead fill color to path stroke color.
* The new SVG 2 marker orientation attribute value 'auto-start-reverse' is implemented. This allows one arrow marker to be used for both ends of a path.
* The new CSS 3 'mix-blend-mode' and 'isolation' properties are implemented, allowing setting the blend mode between objects without using filters.
* The new SVG 2 'paint-order' property is now supported. This allows setting the order in which the fill, stroke, and markers are drawn (buttons will be available in the Fill and Stroke dialog).
* The new SVG 2 'mesh' paint server is supported, including bicubic auto-smoothing. A primitive GUI is available.
* The SVG 1.1 'text-decoration' property is now rendered (underlines, strike through, etc.). CSS 3 'text-decoration' properties are also rendered.
* The new SVG 2 'hatch' paint server is now supported.
* The CSS 'white-space' property is now supported. Use of this property was added in SVG 2 to replace the now deprecated 'xml;space' attribute.
* The SVG 1.1 'textLength" and 'textAdjust' attributes are implemented, however, there is no GUI for these attributes.
* Rendering of the Component Transfer filter primitive has been corrected.
* Units are now recognized in the text and tspan 'x', 'y', 'dx', and 'dy' attributes.
* Percentage values are now interpreted correctly for shapes.

New SVG 2 and CSS 3 features are generally not enabled in the GUI until widespread support in browsers.

== New dependencies ==

The Paintbucket and Trace Bitmap tools now use an external copy of the Potrace library, which is available in many Linux distributions or can be obtained from http://potrace.sourceforge.net

== Translations ==
New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Kannada, Kashmiri (Perso-Arabic and Devanagari), Kokani (Roman and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devnagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

== Notable Bugfixes ==

[Please fill in]

== Known Issues ==

[ Please fill in - unit change, extension]

==Previous releases==
* [[Release notes/0.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Coding Style

2016-05-21T17:02:49Z

~suv: /* Inkscape Coding Style Discussion */ update outdated link

== Inkscape Coding Style Discussion ==

The official code style documentation is on the main website: [https://inkscape.org/develop/coding-style/ Inkscape Coding Style]

This page is for discussing and working out changes and improvements to that document. When concensus
is reached, the document can be updated in SVN in the inkscape_web module.

=== Editor support ===

Place the following at the end of source files to help emacsen & vim users follow some of our guidelines automatically:
<pre>
/*
Local Variables:
mode:c++
c-file-style:"stroustrup"
c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
indent-tabs-mode:nil
fill-column:99
End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :
</pre>

Once you've added those lines, close the file and re-open it for it to take effect.

Then (for emacsen users), one can re-indent a region with C-M-\.

=== camelCase v. Underscores ===
* The new coding standards require non-static member functions to be in pseudoCamelCase, and every other type of function to use underscores.
* The current codebase has very few real C++ objects, half of these objects (or more) seem to use underscores for their member functions, the other half seem to use pseudoCamelCase.
** Over-all, 95% of Inkscape's codebase uses underscores in function names (of course, 90% of the code is still C).
*** It seems underscores are what Inkscape developers are already used to.

* I prefer CamelCase for type names (classes), exceptions, namespaces, and the like. But pseudoCamelCase in member functions clutters the visual space; making types, exceptions, and namescapes stand out much less. And it makes the code much harder (for me) to read.

** This is a personal preference. I find CamelCase to be more legible and more concise, as it takes less space and thus allows for longer identifiers. [[User:JonCruz|JonCruz]]

** Why is there this inconsistency with regard to function names in the new coding standard?
*** (I.e., why a few functions pseudoCamelCase, and everything else underscores?)
** Could all functions just use underscores? (Like the current codebase, like Gtkmm, like Linux, like the C & C++ standard libraries, and like almost every other project out there?)
** Is static vs. non-static member functions really that big of an issue to warrant a change to pseudoCamelCase?

* Hey, we're not programming in Java (or Qt) here! This is C++, where underscore reigns supreme.

** A key point here is the misconception that camel case is not a C/C++ thing. Many platforms used camel case, including the Microsoft Windows API, Apple Macintosh API, etc. [[User:JonCruz|JonCruz]]

** CamelCase is also prevalent in many other "non-pc" languages such as Smalltalk.

=== Underscore as first character of identifiers ===
* Please consider that the C++ standard reserves _* identifiers [17.4.3.1.2]: "Each name that begins with an underscore is reserved to the implementation for use as a name in the global namespace".
* You can use a '''leading underscore for class members''' (variables of a class), to clearly mark them as a class member. This may prevent bugs: for example a temporary variable called 'curve' would hide an SPShape's '_curve' member if it did not have that leading underscore.

=== Tabs and Alignment ===

Inkscape code uses 4 spaces for indentation and '''no tabs anywhere'''.

That's clear (not to mention sensible). However, on the mail Coding Style page it says this:

We have decided to use 4 spaces as a tab for the project.

Calling it a "tab" (rather than something like "indentation amount") is a little confusing, I think. It made me think that source files should have tab characters, but that the editor should be set up to interpret them as being 4 columns (i.e., taking you to the next multiple of 4 columns).

=== Whitespace: Space between sigil and following token? ===

I.e. do we write ‘<code>int *p</code>’ or ‘<code>int * p</code>’; ‘<code>int *f()</code>’ or ‘<code>int * f()</code>’; ‘<code>int *const p</code>’ or ‘<code>int * const p</code>’ ?

Arguments in favour of no space:

* Promotes better understanding of C/C++'s parsing rules for cases like ‘<code>int *a, b</code>’: the sigil applies only to <code>a</code> in that example, not to <code>b</code>.
** This argument is much less applicable to the case that the following identifier names a function: it is very rare for function prototypes to “syntactically share return types” that way; this rarity reduces the importance of knowing the meaning of ‘<code>int * a(), b()</code>’.
* Less horizontal whitespace usage (reducing the chance of overflowing the available width or requiring a continuation line).
** However, note that overflow is rare for variable declarations; for function headers, continuation doesn't hinder understanding of the header in question, so the argument rather becomes one of taking up more lines, reducing how many statements are visible in one screenful.
* For the case of declarations inside function bodies (and other cases as well, to a lesser extent), ‘<code>Foo * foo</code>’ is more easily mistaken for executable code (as distinct from a declaration) than ‘<code>Foo *foo</code>’ is.
* Less typing. (Minimal importance.)

Arguments in favour of space:

* For the cases where the following token is an identifier, improves the legibility of the identifier. For cases where the following token is a cv-qualifier (‘const’, ‘volatile’), the space improves the legibility of the sigil.

An additional issue is the relative prevalence of the approaches in existing code: this relates to either consistency or the cost of changing code (to the extent that changing is done manually).

Before doing any counting, the impression of one developer [writing this] is that no-space is much more common, but with-space is far from unheard-of. (It's valuable to get an informal impression as a defense against any deficiencies in simplistic automated counting: e.g. we ought to give more weight to code that's often looked at / changed than code that's less often looked at or changed, and should give more weight to code considered Inkscape code than imported code.)

The results of a simplistic automated count confirm that: there are 28037 lines with the no-space style to 7204 lines with the with-space style, a ratio of about 3.9:1; or 1899 vs 746 (2.5:1) in .h files. For the following-token-is-function-identifier case, the gap is narrower, at 1350 vs 792 (1.7:1).

The simplistic automated count in question is:

:find $ -name '*.h' -o -name '*.cpp' $ -type f -print0 |
::xargs -0 cat |tr '\t' ' ' |
::egrep -c '(void|int|unsigned|char|short|float|double|\<[A-Z][a-zA-Z0-9_]*)(( *const)? *[*&])+[a-zA-Z_]'

for no-space, and inserting ‘ +’ before the final ‘[a-zA-Z_]’ for with-space. (‘volatile’ is not used in Inkscape source code at the time of writing.) For the following-token-is-function-identifier case, the final ‘[a-zA-Z_]’ was extended to ‘[a-zA-Z_][a-zA-Z0-9_]* *\(’. Note that this means that both the no-space and with-space counts exclude Gnu-style function definition heads (where the return type is on a separate line).

=== Brace Placement ===

Arguments against "disco"/compact braces:

* Make it hard to match braces visually.

:Partial counter-argument: emacsen & vim each have brace-locating commands. (Emacsen: C-M-u, C-M-n, C-M-p, C-M-d (up/next/prev/down); vim: `[ {', `] }'.)

* The brace closes a block, not an if "statement".

:However, the block is intimately related to the if/for/while in ways that a normal block is not.

=== Functions vs methods, i.e. member vs non-member functions ===

* Information-hiding principle suggests that if a function doesn't need access to private variables then it's better not to make it a member function.

** In more detail: when one wants to change some detain about a private variable, then one must look through everything that has access to that variable. This is easier if there's less code that has access to the variable, e.g. if one uses non-member functions in preference to member-functions.

* Virtual functions must of course be member functions.

* Trivial getter/setter functions seem most natural as member functions. (This is mostly a matter of style or tradition rather than technical reasons.)
** "barType getBar() const { return _bar; }" / "void setBar(barType x) { _bar = x; }" are trivial. It's not clear how much else is to be considered trivial.

* For things needing access to private variables, the requirement of the `friend' declaration for non-member functions is a cost: extra clutter in the class definition, requires updating for changes in the signature; and many of the arguments for non-member functions disappear.

* Member functions must be declared in the class definition, which tends to require more recompilation because one can't use a separate header file.

** Sometimes one can break the class into smaller, simpler classes if there are lots of member functions.

* A related issue is that it's harder (impossible) to write private specializations (same name but subclass arguments): any specialization must be declared in the class definition too, so it isn't private other than through comments.

* The shorter names typical of member functions are harder to search for.

** (Counter-argument: this is a matter of custom, there's no technical reason why one can't use long names for member functions, or even short names for non-member functions.)

** Someone has claimed that some tools do relatively well at finding the right version of a given name. Can someone give examples of such a tool (and some comment as to how widely used that tool is or can be by our developers) ?

* Pointers to member functions aren't as easily used as pointers to non-member functions. ("unwieldy", "heavy-weight".)

* Member functions can't be given static linkage.

=== <tt>static</tt> vs anonymous namespaces for file-local functions/objects ===

The current C++ standard marks this type of `<tt>static</tt>' as deprecated, meaning "Normative for the current edition of the Standard, but not guaranteed to be part of the Standard in future revisions".

(Reference: Final Draft of the C++ standard, Annex D "Compatibility features"; and §7.3.1.1 "Unnamed namespaces", ¶2.)

However, g++ up to 3.4 (and possibly later) don't give anonymous-namespace names the same advantages given to static names:

* Warning if the name isn't referenced (and hence unused).
* Optimizations when the function/object can't be used from other object files.
* Static linkage (relevant to analysis using nm).

In addition, having a <tt>static</tt> tag in the declaration itself makes it easier for the programmer to see that the name isn't referenced outside of this translation unit.

Consequently, it is recommended that we use <tt>static</tt> for names not referenced from other translation units.

If and when we encounter a compiler that rejects `static' for objects in namespace scope, we can easily replace `<tt>static</tt>' with `<tt>namespace {</tt> ... <tt>}</tt>'.

=== What to put in what header file ===

Reasons for change:
* Reduce compilation times (most important)
* Fix the mess of NR::Point, NR::Matrix etc. header files. Less confusion as to what needs to be #included, or where to look for the definition of something (especially in the cases where tags-like programs don't help, e.g. if looking for something helpful for a known task rather than having a known name).

What won't change:
* foo.h will still provide the same things it always has (unless you count things "accidentally" provided, which we hope to become less). It's just that some content may be physically moved to a file that foo.h #includes.

The issues are:

* Ease for callers (what file/s to #include). This is largely taken care of by having files that #include other header files, and in particular having the foo.h file as at present.

* "I need to change the blah declaration/definition; what file do I edit?".

* Information we want ppl to be aware of.

Definitions are handled by tags/idutils/global etc (though all of these tools have limitations in their ability to find the _right_ definition).
Declarations that are separate from the definition: [non-member] function declarations are the main case. member functions (obviously kept in same physical file as their class definition); non-member functions

Here are some types of things to be found in header files. Whatever rules you hypothesize, check that the rules cover each of these cases.

* class foo definition
* "class foo;" forward declarations
* struct foo_class (i.e. GObject "class"/vtable type)
* IS_FOO, FOO cast etc. macros
* ancilliary types (e.g. struct StopOnTrue for marshalling)
* enums
* relevant instantiations (traits etc.)
* foo_do_blah (declaration of function defined in .cpp file)
* inline function definitions
* should declaration & definition of inline functions go in different files (there are pros & cons)
* other constants, including #defines
* other macros. Where is the line between "other macro" and "inline function" and IS_FOO macros?

The physical placement of the IS_FOO etc. macros (as distinct from what header files "provide" them) isn't important: we never need to edit them, and they're relatively easy to find by either primitive tags-like programs or by grep.
* This unimportance-of-physical-location is reflected in the inconsistency of current practice, sometimes placing them with foo.h and sometimes in blah-forward.h.
* Exception to unimportance-of-physical-location: IS_FOO etc. should not be physically in the same header file as something that's "expensive" and unneeded by one or more translation units that need IS_FOO etc. ("Expensive" in same sense as `amount' defined below in `Reducing compile times'.)

The main thing for IS_FOO etc. is what header file(s) provide the macro. Thankfully, this is easy in the common case: usually any function that needs the definition of IS_FOO also needs lots of other things relevant to the foo type, so would simply #include foo.h.

Relevant properties of function declarations:

* It is common to add or remove functions, or change the arguments.

* Typically not found by tags-like programs. E.g. neither `tags' nor `TAGS' files store the location of declarations (other than the definition).

* Programmers want to know what functions (including methods, macros, inline things) are available (or rather "is there something that does blah").

** Probably doxygen or the like is the best task for this, though we'd need to make it convenient to use.

* Needed in advance of function definitions (whether in .cpp file or inline function definitions). Not needed in advance by macro definitions per se (but needed in advance of function definitions where the macro is expanded).

Inline function definitions:

* Relatively expensive in compile time for translation units that don't use that inline function definition.
* Must come after (in the translation unit) all referenced declarations. Sometimes this requires that it be outside of the class definition or in a separate file from related declarations. (E.g. if foo.h and bar.h each provide an inline function definition that requires declarations provided by the other file.)

Operator overloading:

* Can be unclear whether to associate with the type of the left operand or the type of the right operand.
* We can simplify things for users of the function by having both left.h and right.h provide it (i.e. have both left.h and right.h #include it). This suggests that it should be physically neither in left.h nor right.h (unless it's OK for left.h to pull in all of right.h or vice versa).

Reducing compile times

* For each translation unit U, reduce the amount of material that gets included by U and isn't needed by U.
** "Amount" is measured by cost: how often that material changes (causing a recompile), and how expensive it is to compile (e.g. inline function definitions).

* In what circumstances does a translation unit include things that it doesn't need?
** Inline function definitions.
** Needs a function declaration but doesn't need the type definition.
*** A special [non-] case of this is needing a member function declaration. Member function declarations can't be separated from their class definition. See also `methods vs functions' above.
** Suppose that struct Foo has a `Bar _bar' member. The translation unit may need to create Foo objects (and thus need the type definition of Bar to know its size), but not need to access _bar (so not needing anything from bar.h other than the type definition of Bar).
*** This is very common. Common examples of Bar: SPShape, NR::Point/NR::Matrix.
** Needs some function declarations but not others.
** Needs some type forward declarations but not others.
** Comments are never needed for compilation.
** Definition of a marshaller is needed only by emitters. However, it's difficult to separate the marshaller from the signal, and difficult to separate the signal from the definition of the containing type (SPDesktop, SPItem).
** Including the definition of a type when its declaration would suffice.
** Copy&paste of #include lines.

* Ways of reducing the need for type definitions:
** Store just a pointer instead of the whole type.
** Provide a wrapper function (not inlined) for `new Foo'.

==Preprocessor MACROS==

Capitalizing or not?

# define IS_FINITE(_a) (std::isfinite(_a))

===Arguments pro capitalizing===
* Macros don't have a namespace and can therefore easily clash with other names. This happened in the isFinite case. where we had across several files:
#define isFinite(x) ...
...
class Point {
bool isFinite(int x)
}
This obviously nameclashed, where a capitalized IS_FINITE would have never clashes as (I guess) nobody uses capitalized function names. Note that an inline function instead of macro would also have worked.
* Some macros can expand strangely (don't have good example now), so it is good that the user knows it does so.
* Note that it is often also possible to define an inline function instead of a macro!!! (which is a better solution?)

===Arguments against capitalizing===

== User Interface Coding Rules ==

=== Complex User Interface Items and Containers (Dialogs, Panels, Frames...) ===

* Each one have to be developped as a C++ class
* Declare all UI widgets that are used in the container as protected initialisation-time allocated members
protected:
Gtk::Label _anchorLabel;
* Initialize all widgets in the member initialization list of the container constructor
MyDialog::MyDialog():
_anchorLabel(_("Look at this label"))
{
...

=== Dialogs ===

* Dialogs source codes have to be localized in src/ui/dialog/
* A dialog belongs to the namespace Inkscape::UI::Dialog

=== Widgets ===

* Widget source codes have to be localized in src/ui/widget/
* A widget belongs to the namespace Inkscape::UI::Widget

[[Category:Developer Discussion]]

GTK+ 3 issues

2016-05-21T01:44:17Z

~suv: /* Standard Practice */ fix formatting as bullet list (remove space in first column)

This page is for Gtk documentation, any issues, questions or notes about the porting of inkscape to Gtk3. This document will be sent to the gtk/gnome developers and may be useful for Gimp developers who undergo the same process.

Other pages:
* [[GTK%2B 3 migration]]
* [[GTK%2B Issues]]

== Issues ==

Document your issues with porting Inkscape to Gtk3 below.

* [https://bugs.launchpad.net/inkscape/+bugs?field.tag=gtk3 GTK 3 Bugs]
* Building with Gdk 3.20 and --enable-strict-build (default) fails due to deprecated symbols. Use --enable-strict-build=no.
* Jumping palette. The color bar/palette does not seem to be able to decide how high it should be, at least for some combinations of palette width, height, etc. See launchpad bug [https://bugs.launchpad.net/inkscape/+bug/1201545 #1201545].
** This might have been fixed by r14870 - the icon clipping problem.
** Don't see why r14870 would have fixed this. r14871 disables the overlaid scrollbars introduced by Gtk3 3.16.
** The 'Wrap' option doubles the height of the swatches but doesn't actually do any wrapping.
* <strike>Icons are too small / cut. (if someone can find the launchpad bug for this one, please add link here). This is probably caused by the use of SPIcon instead of a standard GtkImage widget.</strike>
** The clipping of icons in the toolbar is fixed in r14870. Problem had to do with custom button widget which wraps icon. The preferred/minimum width/height was not taking into account the padding around the icon.
** We have too many ways of creating buttons with icons which leads to inconsistency of behavior.
* All custom widgets now use the Cairo drawing model. All need to be fully tested, and several (e.g., the filter editor) are not rendered correctly.
* Several of the Gtk+ widgets have changed their layout (in particular, the GtkSpinButton is now much wider). Many of the toolbars now overflow the screen horizontally, and many dialogs are now far too wide. The layout of affected containers should be redesigned to account for this.
* The rules for sizing of widgets within containers has changed in Gtk+ 3. In many cases, widgets will initially appear far too big, or with zero size. All dialogs and containers need to be checked for these issues.
* Mac Issues:
** No tablet input support on Mac (e.g. Wacom). MyPaint seems to be working on this.
*** https://community.mypaint.org/t/how-to-build-mypaint-on-mac-osx-without-macports/344
*** https://bugzilla.gnome.org/show_bug.cgi?id=695701
** Support for global menu bar.
*** GEdit uses OSX menu bar and has native file dialogs
* The text "Blur" and "Opacity" inside the "interactive progress bar" widgets (are these custom widgets?) in Fill and stroke dialog are cut in half or less, and are rendered unreadable. There is also some different modes of interaction, with top half of the widgets meaning "move instantly to this point" and (part of) bottom half meaning "slightly adjust value", however the latter is really hard to use as it's something like on or two pixel rows high.
* Window size preference "Small" does not result in a small window.
* Gtk 3.20: "Gtk-WARNING **: Allocating size to GdlDock 0x4ca2930 without calling gtk_widget_get_preferred_width/height(). How does the code know the size to allocate?" Maybe not our bug, see: https://bugzilla.gnome.org/show_bug.cgi?id=765700

== Standard Practice ==

List any repetitive actions during the upgrade and note anything that needed doing when moving from gtk2 to gtk3 widgets (for examine hbox and vbox) be clear if the action is using gtk3 or gtkmm (which often papers over some of the move to gtk3)

* GtkHBox and GtkVBox are now just GtkBox with an orientation attribute.
* Changing to Gtk::Box is a quick fix but there is a warning in the documentation that Gtk::Box will eventually be removed. Gtk::Grid is the "proper" replacement.

We should switch to using CSS styling.

* See: http://www.gtkforums.com/viewtopic.php?f=3&t=988&p=72088=GTK3+with+CSS#p72088
* Ruler code uses CSS styling but @bg_color doesn't seem to be defined. I (Tav) have hard coded off-white for the moment. This works in 3.18 but is ignored in 3.20. The CSS API changed in 3.20. See:
** https://bugzilla.gnome.org/show_bug.cgi?id=765433
** https://blogs.gnome.org/mclasen/2015/11/20/a-gtk-update/
** https://feaneron.com/2016/01/04/quick-guide-to-port-an-app-for-gtk-3-20/
** Looks like we'll need a lot of #ifdefs to handle the changes in 3.20.
** It appears possible to have separate style files for pre 3.20 and 3.20 but I (Tav) don't know how to do this.
* A number of places in our code we use hard coded CSS.
** spw-utilities.cpp <code>GtkWidget { font-size: 12pt; }</code> (In utility for setting font size of widgets.)
** ruler.cpp <code>SPRuler { background-color: @bg_color; }</code>
** svg-view-widget.cpp <code>SPCanvas { background-color: white; }</code>
** desktop-widget.cpp <code>GtkWidget { padding-left: 0; ... }</code> (Restricted to Lock guides)
** font-selector.cpp <code>#font_selector_family { -GtkWidget-wide-seperators: true; -GtkWidget-seperator-height: 6; }</code>
** text-toolbar.cpp <code>#TextFontFamilyAction_combobox { ... }</code> <code>combobox window.popup scrolledwindow treeview seperator { ... }</code>
* We should standardize the widget naming scheme.

Use GtkInspector:

GTK_DEBUG=interactive ~/path_to_gtk3/bin/inkscape

== Widgets ==

List any and all custom widgets currently being used in Inkscape.

* Rulers - src/widgets/ruler.cpp
** Should probably be updated from GIMP.
* SPIcon - src/widgets/icon.cpp
** Should be replaced with regular GtkImage.
** SPIcon does more than rendering the icon:
**# Handles custom size: Inkscape::ICON_SIZE_DECORATION
**# Old to new icon name conversion
**# Rendering icons from icon.svg
**# Rendering into cache
** All the above could be removed.
* SPCanvas - src/display/sp-canvas.cpp
** Needs to stay a custom widget. Fixed for GTK3.
* EgeAdjustmentAction (ege-adjustment-action.h/.cpp)
** Used for things like Height, Width
** Internally uses GtkSpinbutton which has large '+' '-' buttons. See https://developer.gnome.org/gtk3/stable/GtkSpinButton.html

== Ideas ==

Any ideas which are interesting

* No ideas yet

== Deferred changes ==

Work items, which should be carried out after the release of Inkscape 0.93. These are tasks, which would be impractical to perform until after we have permanently ended our support for Gtk+ 2. For example, these may make use of new Gtk+ 3 features, which have no simple fallback available in Gtk+ 2.

* Delete all Gtk+ 2 backward-compatibility code. This will remove over 700 blocks of conditional build instructions from our code base, and thousands of lines of redundant code. This is essential for future maintainability, and will greatly simplify future work on Gtk+ 3 features.
* Load all theme information from an external CSS style sheet. This will potentially tidy our code by removing hard-coded styling instructions, and will make it possible to properly apply user themes to Inkscape.
* Switch to using a GtkIconTheme, with all custom icons installed in a standard way instead of bundled within a single SVG document. This will make it easier to provide user icon themes, and get rid of a lot of deprecated code.
** We should also unify all the code for creating buttons with icons.
** GTK3 respects the HiDPI setting while GTK2 does not. System icons are rendered with high DPI when needed but Inkscape specific icons are not. This will probably be fixed by moving to GtkIconTheme.
** Many GTK methods using GtkIconSize have been deprecated but GtkIconSize itself has not been. This can be confusing. We have a custom value for GtkIconSize that we should try to remove.
* Switch to using GtkApplication instead of GtkMain.
* Switch to using GAction instead of GtkAction <- this one might be deferred indefinitely; see Gimp's direction for comparison (Gimp has stated they will not switch).

CMake Tasks

2016-04-22T11:05:38Z

~suv: /* Priorities for 0.92 */ Todo: install shared inkscape_base lib

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected. (Related: [https://bugs.launchpad.net/inkscape/+bug/1514588 bug #1514588])

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Convert the OS X packaging scripts to use cmake ([https://bugs.launchpad.net/inkscape/+bug/1502774 bug #1502774])

* Convert the WIN32 build system to use cmake (specific details needed..._

* Support changes for new plugin system (hackfest 2016): install and relink shared inkscape_base library.

* '''DONE:''' Drop the checks for getopt.h, since we no longer use that.

* '''DONE:''' Add a test whether '-std=c++11' is required for libsigc++ and/or glibmm/gtkmm ([https://bugs.launchpad.net/inkscape/+bug/1488079 bug #1488079], see comment [https://bugs.launchpad.net/inkscape/+bug/1488079/comments/48 48])

* '''DONE:''' Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated. See patch and discussion in [https://bugs.launchpad.net/inkscape/+bug/1554143 bug #1554143].

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

* Add [https://cmake.org/cmake/help/v3.0/module/GNUInstallDirs.html GNUInstallDirs.cmake] and update all installation paths to use the provided variables.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

CMake Tasks

2016-04-22T11:00:41Z

~suv: /* Priorities for 0.92 */ rephrase todo for OS X (building itself works)

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected. (Related: [https://bugs.launchpad.net/inkscape/+bug/1514588 bug #1514588])

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Convert the OS X packaging scripts to use cmake ([https://bugs.launchpad.net/inkscape/+bug/1502774 bug #1502774])

* Convert the WIN32 build system to use cmake (specific details needed..._

* '''DONE:''' Drop the checks for getopt.h, since we no longer use that.

* '''DONE:''' Add a test whether '-std=c++11' is required for libsigc++ and/or glibmm/gtkmm ([https://bugs.launchpad.net/inkscape/+bug/1488079 bug #1488079], see comment [https://bugs.launchpad.net/inkscape/+bug/1488079/comments/48 48])

* '''DONE:''' Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated. See patch and discussion in [https://bugs.launchpad.net/inkscape/+bug/1554143 bug #1554143].

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

* Add [https://cmake.org/cmake/help/v3.0/module/GNUInstallDirs.html GNUInstallDirs.cmake] and update all installation paths to use the provided variables.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

Notes on Packaging for OS X

2016-03-05T17:22:15Z

~suv: /* 2014: osxmenu (~suv) */ update status

= Current Status =

; Available download
: Inkscape 0.91 [http://inkscape.org/en/download/mac-os/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (32bit app for Leopard and Snow Leopard, 64bit app for Lion and later)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678]
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: GIO-based clip art import not supported - [https://bugs.launchpad.net/inkscape/+bug/943148 Bug #943148]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: Lion and later: no support for Retina/HiDPI displays - [https://bugs.launchpad.net/inkscape/+bug/1216795 Bug #1216795]
: Mavericks and later: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]
: Mavericks and later: embedding bitmap images on import or paste from clipboard may crash Inkscape - [https://bugs.launchpad.net/inkscape/+bug/1398521 Bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 Bug #1410793]
: Mavericks and later: application bundle is not signed [https://bugs.launchpad.net/inkscape/+bug/1363305 Bug #1363305]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: improve language detection
: improve CLI usage
: include dbus (without launchd support), gvfs (clipart import, GTK3 file chooser)

; Extensions
: include ps2pdf (Ghostscript)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, abandoned

; Known issues
: canvas redraws with Quartz backend are delayed (Screen recording [https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%208.mp4 1],[https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4 2])
: exchanging drawing content with native apps via clipboard fails ([https://bugs.launchpad.net/inkscape/+bug/546934 lp:546934], [https://bugzilla.gnome.org/show_bug.cgi?id=692123 gtk:692123])

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

; Available download
: current link to available downloads on the [https://code.launchpad.net/~suv-lp/inkscape/osxmenu branch page] under 'Testing'

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 Proposal] merged into trunk in revision [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13620 13620]
: Update is included in the stable release branch [http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ 0.91.x].

; Related branch
: <strike>[https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]</strike> (merged)

; Available download:
: Stable release packages: [https://inkscape.org/en/download/mac-os/ 0.91] (requires 10.5.8 or later)
: Unstable trunk packages: [https://www.dropbox.com/sh/2n7aim2wcrn6l3h/AADjQQ_484Z_Po1X3RSqa29na?dl=0 0.91+devel (DropBox)] (requires 10.7 or later)

CMake Tasks

2016-01-22T20:13:58Z

~suv: /* Priorities for 0.92 */

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected. (Related: [https://bugs.launchpad.net/inkscape/+bug/1514588 bug #1514588])

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Drop the checks for getopt.h, since we no longer use that.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Add a test whether '-std=c++11' is required for libsigc++ and/or glibmm/gtkmm ([https://bugs.launchpad.net/inkscape/+bug/1488079 bug #1488079], see comment [https://bugs.launchpad.net/inkscape/+bug/1488079/comments/48 48])

* Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated.

* Convert the OSX build system to use cmake ([https://bugs.launchpad.net/inkscape/+bug/1502774 bug #1502774])

* Convert the WIN32 build system to use cmake

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

* Add [https://cmake.org/cmake/help/v3.0/module/GNUInstallDirs.html GNUInstallDirs.cmake] and update all installation paths to use the provided variables.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

CMake Tasks

2016-01-22T20:13:24Z

~suv: /* Priorities for 0.92 */ add check for c++11

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected. (Related: [https://bugs.launchpad.net/inkscape/+bug/1514588 bug #1514588])

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Drop the checks for getopt.h, since we no longer use that.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Add a test whether '-std=c++11' is required for libsigc++ and/or glibmm/gtkmm ([https://bugs.launchpad.net/inkscape/+bug/1488079 1488079], see comment [https://bugs.launchpad.net/inkscape/+bug/1488079/comments/48 48])

* Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated.

* Convert the OSX build system to use cmake ([https://bugs.launchpad.net/inkscape/+bug/1502774 bug #1502774])

* Convert the WIN32 build system to use cmake

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

* Add [https://cmake.org/cmake/help/v3.0/module/GNUInstallDirs.html GNUInstallDirs.cmake] and update all installation paths to use the provided variables.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

CMake Tasks

2016-01-19T23:22:44Z

~suv: /* Priorities for 0.92 */ add bug links

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add configurable options for Python/Perl (see configure --help). I think this may require adding FindPython.cmake and FindPerl.cmake functions (possibly these are provided by cmake already? If not, we can probably find existing reusable modules via google.) option() calls will need added for each to allow users to control whether to include perl/python scripting support. Then some logic will be needed to test these variables and set up the appropriate #defines in config.h. Look at the cmake logic for LCMS or Poppler or etc. in DefineDependsandFlags.cmake as examples of what needs done.

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected. (Related: [https://bugs.launchpad.net/inkscape/+bug/1514588 bug #1514588])

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Drop the checks for getopt.h, since we no longer use that.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated.

* Convert the OSX build system to use cmake ([https://bugs.launchpad.net/inkscape/+bug/1502774 bug #1502774])

* Convert the WIN32 build system to use cmake

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

CMake Tasks

2016-01-19T23:20:32Z

~suv: /* Misc. Cleanup and Nice To Haves */ add bug link

== Priorities for 0.92 ==

* Remove the hardcoded defines in CMakeLists.txt. These are marked out in the "BAD HACKS" section with add_definitions() calls. I suspect many of these are simply unnecessary, like HAVE_CONFIG_H and _FORTIFY_SOURCE. None are documented as to why they were added - perhaps investigate these further, or just test that the build works without them and drop them for now until their need becomes clearer?

* Add configurable options for Python/Perl (see configure --help). I think this may require adding FindPython.cmake and FindPerl.cmake functions (possibly these are provided by cmake already? If not, we can probably find existing reusable modules via google.) option() calls will need added for each to allow users to control whether to include perl/python scripting support. Then some logic will be needed to test these variables and set up the appropriate #defines in config.h. Look at the cmake logic for LCMS or Poppler or etc. in DefineDependsandFlags.cmake as examples of what needs done.

* Add locale installation support to the UNIX section in CMakeLists.txt. These are the po files in Inkscape's po/ subdirectory, and at least for me this appears to be working properly. We already have a simple po/CMakeLists.txt that looks like it does the basics already, including a GETTEXT_PROCESS_PO_FILES() call appears to be putting the files in the binary build's share/locale directory, and we're already hooking it in via the add_subdirectory() call in the top level CMakeLists.txt. Probably worth just checking that inkscape with localization turned on is able to find the appropriate po file and provide translated strings in its user interface, and just verify locales are working as expected.

* Compare dists created by cmake with dists created by autoconf. Set up parallel build trees for cmake and autoconf, and do a make dist in each. Then unpack the tarballs created by each method, create a sorted recursive file listing for each, and diff them. Filter out the cmake-specific and automake-specific files. Look for files autoconf is including in the dist that cmake isn't, and files that cmake includes that autoconf doesn't. For each file determine if it's needed, and adjust the cmake rules accordingly.

* Drop the checks for getopt.h, since we no longer use that.

* Review configure.ac and Makefile.ac for other configurable or required features and libraries. For each of these dependencies, verify that cmake is checking for it in the root CMakeLists.txt or one of the included files in CMakeScripts/*.cmake.

* Get 'make check' to work. Presently it generates an error "No test configuration file found!" A lot of the test harness appears to already be set up, so presumably there's just a bit more configuration needed to get it activated.

* Convert the OSX build system to use cmake

* Convert the WIN32 build system to use cmake

== Misc. Cleanup and Nice To Haves ==

These tasks are not priorities for 0.92 but don't risk breaking anything beyond cmake so are safe to land any time.

* Avoid clobbering CMAKE_* variables. set(CMAKE_FOO "bar") is wrong, it should be set(CMAKE_FOO "${CMAKE_FOO} bar)

* DefineDependsandFlags.cmake explicitly includes GTK2_* stuff, but would just GTK2_INCLUDE_DIRS and GTK2_LIBRARY_DIRS work?

* Automatically update the author dialog using AUTHORS. Look at how the man pages are updated from AUTHORS in the cmake scripts; the dialog can be updated in a similar manner, just that the names need to be formatted differently for the C++ compilation. TRANSLATORS can be done the same way. Probably COPYING as well.

* Rename FindPANGOMM.cmake to FindPangoMM.cmake, to make file name casing consistent. Perhaps there are other modules that should be renamed for consistency too? Be sure any renames don't break the build when those modules are in use.

* Ensure the man pages rebuild when edited. I don't think I set up the dependency tracking correctly for inkscape.pod.in and the other pod files, because they don't rebuild automatically when modified.

* Improve the pango/cairo configuration logic. DefineDependsandFlags.cmake contains platform checks for which libraries to include specifically, which should be generalized and perhaps moved into FindCairo*.cmake and/or FindPango*.cmake modules. ([https://bugs.launchpad.net/inkscape/+bug/1512379 bug #1512379])

* Restructure the helper cmake scripts. Presently a lot of configuration logic is broken out into CMakeScripts/*.cmake files. Where these contain helper routines or otherwise self-contained chunks of functionality that is reasonably abstracted from Inkscape this is fine, but some of these are really just Inkscape-specific logic that probably would be better to just leave inline in the top CMakeLists.txt file. E.g. DefineDependsandFlags.cmake, ConfigCompileFlags.cmake, and ConfigPaths.cmake should be considered to merge back in. Having them broken out separately just obscures configuration logic, and likely will just make things more inconvenient for developers trying to get a handle on the application's configuration.

* Improve the GTK3 Experimental logic. DefineDependsandFlags.cmake contains a large chunk of code for handling GTK3 libraries. As inkscape itself gets ported to Gtk3, I'm guessing a lot of this build configuration logic will need redone or improved. Probably worthwhile to examine GIMP and other gtk/cmake based projects that may be further along in their Gtk3 conversion.

* ConfigChecks.cmake includes tests for a bunch of basic C functions. Many of these are things I believe we can reasonably assume to be present in modern compilers. It hurts little to retain these if they provide tangible benefits, but they do take up time during configuration, so if they're completely redundant we should just drop them. I think as long as we are requiring minimum versions on particular compilers, or if we're checking for certain C++ standards level compliance of the compilers, we can assume a lot of these functions are already there.

* As a corollary to the previous task, ConfigChecks.cmake should perhaps include checks for header files and function calls that we use, that may not be present in every compiler. C++-11 features, for example, might fit here, or anything that is platform-dependent.

* We include a UsePkgConfig.cmake file, but I wonder if this is actually necessary. Reasonably modern cmake has pkgconfig support built-in, so perhaps with a bit of adjustment we could drop this file? I think we should be able to just do "find_package(PkgConfig REQUIRED)"

* Cleanup rendundant stuff in the root CMakeLists.txt no longer needed in recent versions of cmake. I wonder if some of our cmake_policy() statements are redundant with setting cmake's minimum version to 2.8. Other stuff may simply be restating default values, such as CMAKE_MODULE_PATH.

* Cleanup the version specification and insertion. We set the version in INKSCAPE_VERSION, but cmake allows setting the version via project() now, which might be better. We have some plumbing to communicate the version number into the application's code, namely src/inkscape-version.cpp, which supposedly is generated by inkscape-version.cmake (this should probably be doublechecked, I'm not 100% certain it's actually triggered.) I wonder if much of this is superfluous: cmake is creating config.h from config.h.cmake to supply defines for PACKAGE_VERSION, and we could also add the broken down version bits by using cmake's PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, and PROJECT_VERSION_PATCH if we need that.

== Post-0.92 ==

The following cmake related projects should be left until after autoconf is dropped, else they'll likely break autoconf or require it to be updated in turn. Easier to wait until after 0.92 when autoconf is scheduled to be dropped.

* Drop the autoconf files: autogen.sh, configure.in, etc. etc.

* Move fix-roff-punct to the packaging/ directory. This is used only by the man page creation routines, and doesn't need to be kept at the top level so long as it can be found by the cmake script that uses it.

* Drop btool-related files. Doublecheck that the win32 and osx packaging tools have switched over to cmake before doing this.

Release notes/0.91.1

2015-11-30T13:20:08Z

~suv: /* Translations */ fix typo

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.91.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.91.1, see the [https://launchpad.net/inkscape/+milestone/0.91.1 Launchpad milestone page].

==Regression fixes==
* Crash opening files (Glib::ConvertError exception) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1404934 1404934])
* Crash deleting text (Bug #[https://bugs.launchpad.net/inkscape/+bug/1029690 1029690], Bug #[https://bugs.launchpad.net/inkscape/+bug/1391374 1391374], Bug #[https://bugs.launchpad.net/inkscape/+bug/1426879 1426879])
* Crash selecting multiple objects with zh_TW interface language (Bug #[https://bugs.launchpad.net/inkscape/+bug/1428967 1428967])
* Crash undoing duplicate gradient, markers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1417173 1417173], Bug #[https://bugs.launchpad.net/inkscape/+bug/1357805 1357805])
* Renderer: Memory leak on zooming (Bug #[https://bugs.launchpad.net/inkscape/+bug/1424000 1424000])
* Renderer: Opacity of <image> elements inside groups (Bug #[https://bugs.launchpad.net/inkscape/+bug/1434122 1434122])
* Snapping: Enable snapping of cusp nodes by default (Bug #[https://bugs.launchpad.net/inkscape/+bug/1422296 1422296])
* Markers lost after copy and paste (Bug #[https://bugs.launchpad.net/inkscape/+bug/1254762 1254762])
* Text rendering cuts off trailing character (Bug #[https://bugs.launchpad.net/inkscape/+bug/1283194 1283194], Bug #[https://bugs.launchpad.net/inkscape/+bug/1450675 1450675])
* Text tool: Fails to set new default font family (Bug #[https://bugs.launchpad.net/inkscape/+bug/1227232 1227232])
* Node tool: Rubberband selection frame doesn't contrast (Bug #[https://bugs.launchpad.net/inkscape/+bug/1494445 1494445])
* Tracing: 'Multiscan > Brightness steps' fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1456387 1456387])
* Extensions: Failure with documents lacking width/height attributes (Bug #[https://bugs.launchpad.net/inkscape/+bug/1461346 1461346], Bug #[https://bugs.launchpad.net/inkscape/+bug/1463623 1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1269698 1269698])

==Important bugfixes==
* Crash on quit before saving has completed (Bug #[https://bugs.launchpad.net/inkscape/+bug/967416 967416])
* Tiled Clones inside transformed groups broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/168651 168651], Bug #[https://bugs.launchpad.net/inkscape/+bug/469885 469885])
* Displaced clones, offsets (Bug #[https://bugs.launchpad.net/inkscape/+bug/844909 844909], Bug #[https://bugs.launchpad.net/inkscape/+bug/653574 653574], Bug #[https://bugs.launchpad.net/inkscape/+bug/1152657 1152657], Bug #[https://bugs.launchpad.net/inkscape/+bug/1245339 1245339], Bug #[https://bugs.launchpad.net/inkscape/+bug/168013 168013], Bug #[https://bugs.launchpad.net/inkscape/+bug/177751 177751])
* Printing offsets page (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/918319 918319])
* Text, Rectangle tool: unit scale for spinboxes in controls bar (Bug #[https://bugs.launchpad.net/inkscape/+bug/1248120 1248120], Bug #[https://bugs.launchpad.net/inkscape/+bug/772057 772057])
* Guides: Colour not rendered opening saved document (bug #[https://bugs.launchpad.net/inkscape/+bug/1374870 1374870])
* Outdated Creative Commons licenses (3.0 instead of 4.0) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1452266 1452266])

==Translations==
* Catalan: UI translation updated
* Chinese (zh_CN): UI translation updated
* German: UI translation updated, man page translation added, Keys and mouse reference translation added
* Hungarian: UI translation updated
* Icelandic: UI translation added
* Italian: UI translation updated
* Latvian: UI translation updated
* Polish: UI translation updated
* Russian: fix for Envelope extension
* Slovak: UI translation updated
* Chinese/Taiwan: fix for crash on select

==Known issues==
* Pattern may disappear or render black (Bug #[https://bugs.launchpad.net/inkscape/+bug/953992 953992], Bug #[https://bugs.launchpad.net/inkscape/+bug/1292459 1292459], Bug #[https://bugs.launchpad.net/inkscape/+bug/1465753 1465753], Bug #[https://bugs.launchpad.net/inkscape/+bug/1489168 1489168])
* Bitmap export: Export selection won't remember last used file name (Bug #[https://bugs.launchpad.net/inkscape/+bug/1153829 1153829])
* Performance: Dragging objects in compex document very slow (Bug #[https://bugs.launchpad.net/inkscape/+bug/1198317 1198317])
* UI: Minimized docked dialogs don't open from the menu, toolbar button or shortcut (Bug #[https://bugs.launchpad.net/inkscape/+bug/1270295 1270295])
* SVG Font Editor: Kerning tab broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/1406543 1406543])
* Fonts (Windows): Inkscape doesn't show fonts loaded by font manager (Bug #[https://bugs.launchpad.net/inkscape/+bug/1416674 1416674])
* Text: Incorrect vowel & consonant position while typing in Thai (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425387 1425387])
* Filter: Filter applied on group does not auto redraw when edited (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425542 1425542])
* Filter: Object or image disappear when adding a color matrix (Bug #[https://bugs.launchpad.net/inkscape/+bug/1429107 1429107])
* ... see also [[Release notes/0.91#Known_issues]].

==Previous releases==
* [[Release notes/0.91]]

Release notes/0.91.1

2015-11-30T13:19:24Z

~suv: /* Translations */

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.91.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.91.1, see the [https://launchpad.net/inkscape/+milestone/0.91.1 Launchpad milestone page].

==Regression fixes==
* Crash opening files (Glib::ConvertError exception) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1404934 1404934])
* Crash deleting text (Bug #[https://bugs.launchpad.net/inkscape/+bug/1029690 1029690], Bug #[https://bugs.launchpad.net/inkscape/+bug/1391374 1391374], Bug #[https://bugs.launchpad.net/inkscape/+bug/1426879 1426879])
* Crash selecting multiple objects with zh_TW interface language (Bug #[https://bugs.launchpad.net/inkscape/+bug/1428967 1428967])
* Crash undoing duplicate gradient, markers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1417173 1417173], Bug #[https://bugs.launchpad.net/inkscape/+bug/1357805 1357805])
* Renderer: Memory leak on zooming (Bug #[https://bugs.launchpad.net/inkscape/+bug/1424000 1424000])
* Renderer: Opacity of <image> elements inside groups (Bug #[https://bugs.launchpad.net/inkscape/+bug/1434122 1434122])
* Snapping: Enable snapping of cusp nodes by default (Bug #[https://bugs.launchpad.net/inkscape/+bug/1422296 1422296])
* Markers lost after copy and paste (Bug #[https://bugs.launchpad.net/inkscape/+bug/1254762 1254762])
* Text rendering cuts off trailing character (Bug #[https://bugs.launchpad.net/inkscape/+bug/1283194 1283194], Bug #[https://bugs.launchpad.net/inkscape/+bug/1450675 1450675])
* Text tool: Fails to set new default font family (Bug #[https://bugs.launchpad.net/inkscape/+bug/1227232 1227232])
* Node tool: Rubberband selection frame doesn't contrast (Bug #[https://bugs.launchpad.net/inkscape/+bug/1494445 1494445])
* Tracing: 'Multiscan > Brightness steps' fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1456387 1456387])
* Extensions: Failure with documents lacking width/height attributes (Bug #[https://bugs.launchpad.net/inkscape/+bug/1461346 1461346], Bug #[https://bugs.launchpad.net/inkscape/+bug/1463623 1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1269698 1269698])

==Important bugfixes==
* Crash on quit before saving has completed (Bug #[https://bugs.launchpad.net/inkscape/+bug/967416 967416])
* Tiled Clones inside transformed groups broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/168651 168651], Bug #[https://bugs.launchpad.net/inkscape/+bug/469885 469885])
* Displaced clones, offsets (Bug #[https://bugs.launchpad.net/inkscape/+bug/844909 844909], Bug #[https://bugs.launchpad.net/inkscape/+bug/653574 653574], Bug #[https://bugs.launchpad.net/inkscape/+bug/1152657 1152657], Bug #[https://bugs.launchpad.net/inkscape/+bug/1245339 1245339], Bug #[https://bugs.launchpad.net/inkscape/+bug/168013 168013], Bug #[https://bugs.launchpad.net/inkscape/+bug/177751 177751])
* Printing offsets page (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/918319 918319])
* Text, Rectangle tool: unit scale for spinboxes in controls bar (Bug #[https://bugs.launchpad.net/inkscape/+bug/1248120 1248120], Bug #[https://bugs.launchpad.net/inkscape/+bug/772057 772057])
* Guides: Colour not rendered opening saved document (bug #[https://bugs.launchpad.net/inkscape/+bug/1374870 1374870])
* Outdated Creative Commons licenses (3.0 instead of 4.0) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1452266 1452266])

==Translations==
* Catalan: UI translation updated
* Chinese (zh_CN): UI translation updated
* German: UI translation updated, man page translation added, Keys and mouse reference translation added
* Hungarian: UI translation updated
* Icelandic: UI translation added
* Italian: Ui translation updated
* Latvian: UI translation updated
* Polish: UI translation updated
* Russian: fix for Envelope extension
* Slovak: UI translation updated
* Chinese/Taiwan: fix for crash on select

==Known issues==
* Pattern may disappear or render black (Bug #[https://bugs.launchpad.net/inkscape/+bug/953992 953992], Bug #[https://bugs.launchpad.net/inkscape/+bug/1292459 1292459], Bug #[https://bugs.launchpad.net/inkscape/+bug/1465753 1465753], Bug #[https://bugs.launchpad.net/inkscape/+bug/1489168 1489168])
* Bitmap export: Export selection won't remember last used file name (Bug #[https://bugs.launchpad.net/inkscape/+bug/1153829 1153829])
* Performance: Dragging objects in compex document very slow (Bug #[https://bugs.launchpad.net/inkscape/+bug/1198317 1198317])
* UI: Minimized docked dialogs don't open from the menu, toolbar button or shortcut (Bug #[https://bugs.launchpad.net/inkscape/+bug/1270295 1270295])
* SVG Font Editor: Kerning tab broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/1406543 1406543])
* Fonts (Windows): Inkscape doesn't show fonts loaded by font manager (Bug #[https://bugs.launchpad.net/inkscape/+bug/1416674 1416674])
* Text: Incorrect vowel & consonant position while typing in Thai (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425387 1425387])
* Filter: Filter applied on group does not auto redraw when edited (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425542 1425542])
* Filter: Object or image disappear when adding a color matrix (Bug #[https://bugs.launchpad.net/inkscape/+bug/1429107 1429107])
* ... see also [[Release notes/0.91#Known_issues]].

==Previous releases==
* [[Release notes/0.91]]

Extensions: INX widgets and parameters

2015-11-22T01:27:08Z

~suv: /* gui-tip */

Here you will find the different parameter elements you may use in your .inx files (Inkscape Extensions)

== Introduction ==
Use parameter elements to capture user input for further use by a script. The basic structure of the element is:

<code><pre>
<param name="some_name" type="some_type">default value</param>
</pre></code>

The default value is the value that is shown in the input control the first time the user opens the dialog window. Inkscape automatically displays the values used last time when the dialog window is opened again.

== Common attributes ==
===type===
Gives the type of parameter (int|float|string|boolean|enum|notebook|description|optiongroup|color).

===name===
Identifier of the parameter.

===gui-text===
Label of the parameter.

Not used by the notebook parameter (you can set the attribute, but it doesn't show in the dialog).

===gui-description===
Tooltip of the parameter.

===gui-hidden===
If true, hide the parameter in the GUI (default to false).

== Types ==

{| class="wikitable" style="width:100%"
|-
! Type
! Code
! Result
|-
|string
|A textbox to capture a '''character string'''.
<code><pre>
<param name="some_name" type="string" _gui-text="Some text label">Some default text</param>
</pre></code>
|[[File:INX_sample-string.png]]
|-
|int
|To get a textbox for an '''integer''' number. Limit the input range with the <code>min</code> and <code>max</code> attributes. By default, min=0 and max=10.
<code><pre>
<param name="some_name" type="int" min="1" max="100" _gui-text="Some label text">1</param>
</pre></code>
|[[File:INX_sample-int.png]]
|-
|float
|To get a textbox for a '''float number'''. Limit the input range with the <code>min</code> and <code>max</code> attributes. To set the number of decimal places, use the <code>precision</code> attribute. By default, min=0, max=10, and precision=1
<code><pre>
<param name="some_name" type="float" precision="3" min="0" max="9999"
_gui-text="Some label text">1.234</param>
</pre></code>
|[[File:INX_sample-float.png]]
|-
|boolean
|Gives a '''checkbox'''. Set the default value to <code>true</code> or <code>1</code>, <code>false</code> or <code>0</code>.
<code><pre>
<param name="some_name" type="boolean" _gui-text="Some label text">false</param>
</pre></code>
|[[File:INX_sample-boolean.png]]
|-
|enum
|Creates a list of choices where the user can only select '''one option''' using a drop down select list. Create the different choices with <code><item></code> elements. The first item is selected by default. The '''returned value''' for the optiongroup element is the '''value attribute of the selected item'''.
<code><pre>
<param name="some_name" type="enum" _gui-text="Some label text">
<_item value="1">First option</_item>
<_item value="2">Second option</_item>
</param>
</pre></code>
|[[File:INX_sample-enum.png]]
|-
|optiongroup
|Creates a list of choices where the user can only select '''one option'''. By default this is displayed as radiobuttons. Set the attribute <code>appearance="minimal"</code> to display a drop down select list instead. Create the different choices with <code><option></code> elements. The first option is selected by default. The '''returned value''' for the optiongroup element is the '''value attribute of the selected option'''.
<code><pre>
<param name="some_name" type="optiongroup" appearance="minimal"
_gui-text="Some label text">
<_option value="1">First option</_option>
<_option value="2">Second option</_option>
</param>
</pre></code>
|[[File:INX_sample-optiongroup-minimal.png]]
|-
|color
|Creates a control to select a '''color'''. The returned value is a RGBA-value.
<code><pre>
<param name="some_name" type="color"></param>
</pre></code>
|[[File:INX_sample-color.png]]
|-
|description
|To show some text in the dialog window, for example as "help" text.
<code><pre>
<param name="some_name" type="description">Some text here.</param>
</pre></code>
|[[File:INX_sample-description.png]]
|-
|notebook
|Creates a '''set of pages''' or tab-sheets. Create individual pages with the <code><page></code> element. The '''returned value''' for the notebook parameter element is the name of the '''selected''' page/tab.
<code><pre>
<param name="some_name" type="notebook">
<page name="name_page_1" _gui-text="First page">
<param>...</param>
</page>
<page name="name_page_2" _gui-text="Second page">
<param>...</param>
</page>
</param>
</pre></code>
|[[File:INX_sample-notebook.png]]
|}

[[Category:Developer Documentation]]
[[Category:Extensions]]

Release notes/0.91.1

2015-10-27T13:12:42Z

~suv: /* Translations */

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.91.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.91.1, see the [https://launchpad.net/inkscape/+milestone/0.91.1 Launchpad milestone page].

==Regression fixes==
* Crash opening files (Glib::ConvertError exception) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1404934 1404934])
* Crash deleting text (Bug #[https://bugs.launchpad.net/inkscape/+bug/1029690 1029690], Bug #[https://bugs.launchpad.net/inkscape/+bug/1391374 1391374], Bug #[https://bugs.launchpad.net/inkscape/+bug/1426879 1426879])
* Crash selecting multiple objects with zh_TW interface language (Bug #[https://bugs.launchpad.net/inkscape/+bug/1428967 1428967])
* Crash undoing duplicate gradient, markers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1417173 1417173], Bug #[https://bugs.launchpad.net/inkscape/+bug/1357805 1357805])
* Renderer: Memory leak on zooming (Bug #[https://bugs.launchpad.net/inkscape/+bug/1424000 1424000])
* Renderer: Opacity of <image> elements inside groups (Bug #[https://bugs.launchpad.net/inkscape/+bug/1434122 1434122])
* Snapping: Enable snapping of cusp nodes by default (Bug #[https://bugs.launchpad.net/inkscape/+bug/1422296 1422296])
* Markers lost after copy and paste (Bug #[https://bugs.launchpad.net/inkscape/+bug/1254762 1254762])
* Text rendering cuts off trailing character (Bug #[https://bugs.launchpad.net/inkscape/+bug/1283194 1283194], Bug #[https://bugs.launchpad.net/inkscape/+bug/1450675 1450675])
* Text tool: Fails to set new default font family (Bug #[https://bugs.launchpad.net/inkscape/+bug/1227232 1227232])
* Node tool: Rubberband selection frame doesn't contrast (Bug #[https://bugs.launchpad.net/inkscape/+bug/1494445 1494445])
* Tracing: 'Multiscan > Brightness steps' fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1456387 1456387])
* Extensions: Failure with documents lacking width/height attributes (Bug #[https://bugs.launchpad.net/inkscape/+bug/1461346 1461346], Bug #[https://bugs.launchpad.net/inkscape/+bug/1463623 1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1269698 1269698])

==Important bugfixes==
* Crash on quit before saving has completed (Bug #[https://bugs.launchpad.net/inkscape/+bug/967416 967416])
* Tiled Clones inside transformed groups broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/168651 168651], Bug #[https://bugs.launchpad.net/inkscape/+bug/469885 469885])
* Displaced clones, offsets (Bug #[https://bugs.launchpad.net/inkscape/+bug/844909 844909], Bug #[https://bugs.launchpad.net/inkscape/+bug/653574 653574], Bug #[https://bugs.launchpad.net/inkscape/+bug/1152657 1152657], Bug #[https://bugs.launchpad.net/inkscape/+bug/1245339 1245339], Bug #[https://bugs.launchpad.net/inkscape/+bug/168013 168013], Bug #[https://bugs.launchpad.net/inkscape/+bug/177751 177751])
* Printing offsets page (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/918319 918319])
* Text, Rectangle tool: unit scale for spinboxes in controls bar (Bug #[https://bugs.launchpad.net/inkscape/+bug/1248120 1248120], Bug #[https://bugs.launchpad.net/inkscape/+bug/772057 772057])
* Guides: Colour not rendered opening saved document (bug #[https://bugs.launchpad.net/inkscape/+bug/1374870 1374870])
* Outdated Creative Commons licenses (3.0 instead of 4.0) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1452266 1452266])

==Translations==
* Catalan: UI translation updated
* German: UI translation updated, man page translation added, Keys and mouse reference translation added
* Hungarian: UI translation updated
* Icelandic: UI translation added
* Italian: Ui translation updated
* Latvian: UI translation updated
* Polish: UI translation updated
* Russian: fix for Envelope extension
* Slovak: UI translation updated
* Chinese/Taiwan: fix for crash on select

==Known issues==
* Pattern may disappear or render black (Bug #[https://bugs.launchpad.net/inkscape/+bug/953992 953992], Bug #[https://bugs.launchpad.net/inkscape/+bug/1292459 1292459], Bug #[https://bugs.launchpad.net/inkscape/+bug/1465753 1465753], Bug #[https://bugs.launchpad.net/inkscape/+bug/1489168 1489168])
* Bitmap export: Export selection won't remember last used file name (Bug #[https://bugs.launchpad.net/inkscape/+bug/1153829 1153829])
* Performance: Dragging objects in compex document very slow (Bug #[https://bugs.launchpad.net/inkscape/+bug/1198317 1198317])
* UI: Minimized docked dialogs don't open from the menu, toolbar button or shortcut (Bug #[https://bugs.launchpad.net/inkscape/+bug/1270295 1270295])
* SVG Font Editor: Kerning tab broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/1406543 1406543])
* Fonts (Windows): Inkscape doesn't show fonts loaded by font manager (Bug #[https://bugs.launchpad.net/inkscape/+bug/1416674 1416674])
* Text: Incorrect vowel & consonant position while typing in Thai (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425387 1425387])
* Filter: Filter applied on group does not auto redraw when edited (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425542 1425542])
* Filter: Object or image disappear when adding a color matrix (Bug #[https://bugs.launchpad.net/inkscape/+bug/1429107 1429107])
* ... see also [[Release notes/0.91#Known_issues]].

==Previous releases==
* [[Release notes/0.91]]

Release notes/0.91.1

2015-10-27T13:12:10Z

~suv: /* Translations */

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.91.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.91.1, see the [https://launchpad.net/inkscape/+milestone/0.91.1 Launchpad milestone page].

==Regression fixes==
* Crash opening files (Glib::ConvertError exception) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1404934 1404934])
* Crash deleting text (Bug #[https://bugs.launchpad.net/inkscape/+bug/1029690 1029690], Bug #[https://bugs.launchpad.net/inkscape/+bug/1391374 1391374], Bug #[https://bugs.launchpad.net/inkscape/+bug/1426879 1426879])
* Crash selecting multiple objects with zh_TW interface language (Bug #[https://bugs.launchpad.net/inkscape/+bug/1428967 1428967])
* Crash undoing duplicate gradient, markers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1417173 1417173], Bug #[https://bugs.launchpad.net/inkscape/+bug/1357805 1357805])
* Renderer: Memory leak on zooming (Bug #[https://bugs.launchpad.net/inkscape/+bug/1424000 1424000])
* Renderer: Opacity of <image> elements inside groups (Bug #[https://bugs.launchpad.net/inkscape/+bug/1434122 1434122])
* Snapping: Enable snapping of cusp nodes by default (Bug #[https://bugs.launchpad.net/inkscape/+bug/1422296 1422296])
* Markers lost after copy and paste (Bug #[https://bugs.launchpad.net/inkscape/+bug/1254762 1254762])
* Text rendering cuts off trailing character (Bug #[https://bugs.launchpad.net/inkscape/+bug/1283194 1283194], Bug #[https://bugs.launchpad.net/inkscape/+bug/1450675 1450675])
* Text tool: Fails to set new default font family (Bug #[https://bugs.launchpad.net/inkscape/+bug/1227232 1227232])
* Node tool: Rubberband selection frame doesn't contrast (Bug #[https://bugs.launchpad.net/inkscape/+bug/1494445 1494445])
* Tracing: 'Multiscan > Brightness steps' fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1456387 1456387])
* Extensions: Failure with documents lacking width/height attributes (Bug #[https://bugs.launchpad.net/inkscape/+bug/1461346 1461346], Bug #[https://bugs.launchpad.net/inkscape/+bug/1463623 1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1269698 1269698])

==Important bugfixes==
* Crash on quit before saving has completed (Bug #[https://bugs.launchpad.net/inkscape/+bug/967416 967416])
* Tiled Clones inside transformed groups broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/168651 168651], Bug #[https://bugs.launchpad.net/inkscape/+bug/469885 469885])
* Displaced clones, offsets (Bug #[https://bugs.launchpad.net/inkscape/+bug/844909 844909], Bug #[https://bugs.launchpad.net/inkscape/+bug/653574 653574], Bug #[https://bugs.launchpad.net/inkscape/+bug/1152657 1152657], Bug #[https://bugs.launchpad.net/inkscape/+bug/1245339 1245339], Bug #[https://bugs.launchpad.net/inkscape/+bug/168013 168013], Bug #[https://bugs.launchpad.net/inkscape/+bug/177751 177751])
* Printing offsets page (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/918319 918319])
* Text, Rectangle tool: unit scale for spinboxes in controls bar (Bug #[https://bugs.launchpad.net/inkscape/+bug/1248120 1248120], Bug #[https://bugs.launchpad.net/inkscape/+bug/772057 772057])
* Guides: Colour not rendered opening saved document (bug #[https://bugs.launchpad.net/inkscape/+bug/1374870 1374870])
* Outdated Creative Commons licenses (3.0 instead of 4.0) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1452266 1452266])

==Translations==
* Catalan: UI translation updated
* German: UI translation updated, man page translation added, Keys and mouse reference translation added
* Hungarian: UI translation updated
* Icelandic UI translation added
* Italian: Ui translation updated
* Latvian: UI translation updated
* Polish: UI translation updated
* Russian: fix for Envelope extension
* Slovak: UI translation updated
* Chinese/Taiwan: fix for crash on select

==Known issues==
* Pattern may disappear or render black (Bug #[https://bugs.launchpad.net/inkscape/+bug/953992 953992], Bug #[https://bugs.launchpad.net/inkscape/+bug/1292459 1292459], Bug #[https://bugs.launchpad.net/inkscape/+bug/1465753 1465753], Bug #[https://bugs.launchpad.net/inkscape/+bug/1489168 1489168])
* Bitmap export: Export selection won't remember last used file name (Bug #[https://bugs.launchpad.net/inkscape/+bug/1153829 1153829])
* Performance: Dragging objects in compex document very slow (Bug #[https://bugs.launchpad.net/inkscape/+bug/1198317 1198317])
* UI: Minimized docked dialogs don't open from the menu, toolbar button or shortcut (Bug #[https://bugs.launchpad.net/inkscape/+bug/1270295 1270295])
* SVG Font Editor: Kerning tab broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/1406543 1406543])
* Fonts (Windows): Inkscape doesn't show fonts loaded by font manager (Bug #[https://bugs.launchpad.net/inkscape/+bug/1416674 1416674])
* Text: Incorrect vowel & consonant position while typing in Thai (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425387 1425387])
* Filter: Filter applied on group does not auto redraw when edited (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425542 1425542])
* Filter: Object or image disappear when adding a color matrix (Bug #[https://bugs.launchpad.net/inkscape/+bug/1429107 1429107])
* ... see also [[Release notes/0.91#Known_issues]].

==Previous releases==
* [[Release notes/0.91]]

Release notes/0.92

2015-10-22T23:02:08Z

~suv: /* Extensions */

{{Other languages|en=Release_notes/0.92}}

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

== Dialogs, etc. ==

=== Objects ===
Hierarchy of document
* Imported from Ponyscape
* Includes individual objects as well as layers
* Allows changing of highlight color of objects
* Drag and drop reordering of objects
* Find, lock, and hide individual items

=== Selection Sets ===
Create selection sets that are not affected document structure
=== Live Path Effects ===
Now some suitable LPE's are applied to clips and mask. 
Helper lines come again to live 
Added to pen/pencil shape combo box the option to add a bend path directly 
==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3334 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Fillet/Chamfer ====
----
[[File:Fillet-chamfer.png|170px|right|thumb]]
Extended video: https://www.youtube.com/watch?v=wJKzGhJULfc

* '''Four types:''' fillet, inverse fillet, chamfer and inverse chamfer.
* Fillet/Chamfer knots are green diamonds
* '''Change Fillet/Chamfer types:''' <kbd>Ctrl+click</kbd> green knot
* '''Fillet/Chamfer knot dialog:''' <kbd>Shift+click</kbd> green knot
* Handle units.
* Methods '''Auto,Force Arcs or Force Bezier'''. Auto use arcs for straight lines and bezier for curves.
* Numeric '''radius input'''.
* Optional helper path with knot direction
* Two kind of radius, '''fixed and flexible'''.
* Optional Knot distance to node instead radius
* Ignore 0 radius knots.
* Change only selected nodes.
* Chamfer subdivisions input. -double-chamfer, triple chamfer....-
* Hide Knots, some times useful. ex: 0 radius knot.
* Type change buttons
[[File:Fillet-chamfer2.gif]]

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions + a global randomizer.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

Add deformations by a mesh. 
Vertical,horizontal or both symmetry.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

==== Transform by two points ====
----
[[File:TransformByTwoKnots.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups with less power.
* Allow snapping of both control points
* Allow fix angle or distance.
* Elastic mode to simulate a flex path
* From original width, set the control points based on bounding box

[[File:TransformByTwoKnots.gif]]

== File Format Support ==
* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

== Extensions ==

=== New ===
* Render > '''Seamless Pattern''' ([https://www.youtube.com/watch?v=MYGKAF7EPFY Screencast])
* Images > '''Set Image Attributes''' (Bug #[https://bugs.launchpad.net/inkscape/+bug/1357808 1357808])

=== Plotter Driver ===

==== Multiple Pens ====
The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:
* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====
The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

=== Miscellaneous Improvements ===
* Arrange > '''Restack''' has new options to reverse and shuffle the z-order of selected objects.
* Render > '''Random Tree''' has new option to omit redundant segments.
* Visualize Path > '''Measure Path''' has additional text layout options.

== Other user interface ==

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

== Translations ==
New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Kannada, Kashmiri (Perso-Arabic and Devanagari), Kokani (Roman and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devnagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

Release notes/0.91.1

2015-10-05T05:49:54Z

~suv: Add draft for Release notes 0.91.1 (just in case)

==Release highlights==

'''DRAFT - Not yet released.'''

Inkscape 0.91.1 is a stability and bugfix release.
For a complete list of bugs fixed in 0.91.1, see the [https://launchpad.net/inkscape/+milestone/0.91.1 Launchpad milestone page].

==Regression fixes==
* Crash opening files (Glib::ConvertError exception) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1404934 1404934])
* Crash deleting text (Bug #[https://bugs.launchpad.net/inkscape/+bug/1029690 1029690], Bug #[https://bugs.launchpad.net/inkscape/+bug/1391374 1391374], Bug #[https://bugs.launchpad.net/inkscape/+bug/1426879 1426879])
* Crash selecting multiple objects with zh_TW interface language (Bug #[https://bugs.launchpad.net/inkscape/+bug/1428967 1428967])
* Crash undoing duplicate gradient, markers (Bug #[https://bugs.launchpad.net/inkscape/+bug/1417173 1417173], Bug #[https://bugs.launchpad.net/inkscape/+bug/1357805 1357805])
* Renderer: Memory leak on zooming (Bug #[https://bugs.launchpad.net/inkscape/+bug/1424000 1424000])
* Renderer: Opacity of <image> elements inside groups (Bug #[https://bugs.launchpad.net/inkscape/+bug/1434122 1434122])
* Snapping: Enable snapping of cusp nodes by default (Bug #[https://bugs.launchpad.net/inkscape/+bug/1422296 1422296])
* Markers lost after copy and paste (Bug #[https://bugs.launchpad.net/inkscape/+bug/1254762 1254762])
* Text rendering cuts off trailing character (Bug #[https://bugs.launchpad.net/inkscape/+bug/1283194 1283194], Bug #[https://bugs.launchpad.net/inkscape/+bug/1450675 1450675])
* Text tool: Fails to set new default font family (Bug #[https://bugs.launchpad.net/inkscape/+bug/1227232 1227232])
* Node tool: Rubberband selection frame doesn't contrast (Bug #[https://bugs.launchpad.net/inkscape/+bug/1494445 1494445])
* Tracing: 'Multiscan > Brightness steps' fails (Bug #[https://bugs.launchpad.net/inkscape/+bug/1456387 1456387])
* Extensions: Failure with documents lacking width/height attributes (Bug #[https://bugs.launchpad.net/inkscape/+bug/1461346 1461346], Bug #[https://bugs.launchpad.net/inkscape/+bug/1463623 1463623])
* UI: Missing icons with Gtk+'s built-in icon theme (Windows, OS X) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1269698 1269698])

==Important bugfixes==
* Crash on quit before saving has completed (Bug #[https://bugs.launchpad.net/inkscape/+bug/967416 967416])
* Tiled Clones inside transformed groups broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/168651 168651], Bug #[https://bugs.launchpad.net/inkscape/+bug/469885 469885])
* Displaced clones, offsets (Bug #[https://bugs.launchpad.net/inkscape/+bug/844909 844909], Bug #[https://bugs.launchpad.net/inkscape/+bug/653574 653574], Bug #[https://bugs.launchpad.net/inkscape/+bug/1152657 1152657], Bug #[https://bugs.launchpad.net/inkscape/+bug/1245339 1245339], Bug #[https://bugs.launchpad.net/inkscape/+bug/168013 168013], Bug #[https://bugs.launchpad.net/inkscape/+bug/177751 177751])
* Printing offsets page (Windows) (Bug #[https://bugs.launchpad.net/inkscape/+bug/918319 918319])
* Text, Rectangle tool: unit scale for spinboxes in controls bar (Bug #[https://bugs.launchpad.net/inkscape/+bug/1248120 1248120], Bug #[https://bugs.launchpad.net/inkscape/+bug/772057 772057])
* Guides: Colour not rendered opening saved document (bug #[https://bugs.launchpad.net/inkscape/+bug/1374870 1374870])
* Outdated Creative Commons licenses (3.0 instead of 4.0) (Bug #[https://bugs.launchpad.net/inkscape/+bug/1452266 1452266])

==Translations==
* Catalan: UI translation updated
* German: UI translation updated, man page translation added, Keys and mouse reference translation added
* Hungarian: UI translation updated
* Italian: Ui translation updated
* Latvian: UI translation updated
* Polish: UI translation updated
* Russian: fix for Envelope extension
* Slovak: UI translation updated
* Chinese/Taiwan: fix for crash on select

==Known issues==
* Pattern may disappear or render black (Bug #[https://bugs.launchpad.net/inkscape/+bug/953992 953992], Bug #[https://bugs.launchpad.net/inkscape/+bug/1292459 1292459], Bug #[https://bugs.launchpad.net/inkscape/+bug/1465753 1465753], Bug #[https://bugs.launchpad.net/inkscape/+bug/1489168 1489168])
* Bitmap export: Export selection won't remember last used file name (Bug #[https://bugs.launchpad.net/inkscape/+bug/1153829 1153829])
* Performance: Dragging objects in compex document very slow (Bug #[https://bugs.launchpad.net/inkscape/+bug/1198317 1198317])
* UI: Minimized docked dialogs don't open from the menu, toolbar button or shortcut (Bug #[https://bugs.launchpad.net/inkscape/+bug/1270295 1270295])
* SVG Font Editor: Kerning tab broken (Bug #[https://bugs.launchpad.net/inkscape/+bug/1406543 1406543])
* Fonts (Windows): Inkscape doesn't show fonts loaded by font manager (Bug #[https://bugs.launchpad.net/inkscape/+bug/1416674 1416674])
* Text: Incorrect vowel & consonant position while typing in Thai (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425387 1425387])
* Filter: Filter applied on group does not auto redraw when edited (Bug #[https://bugs.launchpad.net/inkscape/+bug/1425542 1425542])
* Filter: Object or image disappear when adding a color matrix (Bug #[https://bugs.launchpad.net/inkscape/+bug/1429107 1429107])
* ... see also [[Release notes/0.91#Known_issues]].

==Previous releases==
* [[Release notes/0.91]]

Release notes/0.92

2015-09-30T00:44:00Z

~suv: Add File Format Section; add note about change of default PostScript Level for cli export

{{Other languages|en=Release_notes/0.92}}

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

== Dialogs, etc. ==

=== Objects ===
Hierarchy of document
* Imported from Ponyscape
* Includes individual objects as well as layers
* Allows changing of highlight color of objects
* Drag and drop reordering of objects
* Find, lock, and hide individual items

=== Selection Sets ===
Create selection sets that are not affected document structure
=== Live Path Effects ===
Now some suitable LPE's are applied to clips and mask. 
Helper lines come again to live 
Added to pen/pencil shape combo box the option to add a bend path directly 
==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3334 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Fillet/Chamfer ====
----
[[File:Fillet-chamfer.png|170px|right|thumb]]
Extended video: https://www.youtube.com/watch?v=wJKzGhJULfc

* '''Four types:''' fillet, inverse fillet, chamfer and inverse chamfer.
* Fillet/Chamfer knots are green diamonds
* '''Change Fillet/Chamfer types:''' <kbd>Ctrl+click</kbd> green knot
* '''Fillet/Chamfer knot dialog:''' <kbd>Shift+click</kbd> green knot
* Handle units.
* Methods '''Auto,Force Arcs or Force Bezier'''. Auto use arcs for straight lines and bezier for curves.
* Numeric '''radius input'''.
* Optional helper path with knot direction
* Two kind of radius, '''fixed and flexible'''.
* Optional Knot distance to node instead radius
* Ignore 0 radius knots.
* Change only selected nodes.
* Chamfer subdivisions input. -double-chamfer, triple chamfer....-
* Hide Knots, some times useful. ex: 0 radius knot.
* Type change buttons
[[File:Fillet-chamfer2.gif]]

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions + a global randomizer.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE 
Symmetry video: https://www.youtube.com/watch?v=jhuVjqFA6ig

Add deformations by a mesh. 
Vertical,horizontal or both symmetry.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

==== Transform by two points ====
----
[[File:TransformByTwoKnots.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=ZLmYdWoXXIw

Transform a element by two control points. You can position the control points by bounding box or by original path node index.
Thanks Ivan Louette for the idea of the effect.

* Work on paths, shapes and groups with less power.
* Allow snapping of both control points
* Allow fix angle or distance.
* Elastic mode to simulate a flex path
* From original width, set the control points based on bounding box

[[File:TransformByTwoKnots.gif]]

== File Format Support ==
* The default PostScript level for exporting from the command line changes from 2 to 3 (consistent with the user interface PS exporter which defaults to level 3). Level 3 is required for gradient support.

== Extensions ==

=== Plotter Driver ===

==== Multiple Pens ====
The Plotter driver (Extensions -> Export -> Plot) can now handle multiple pens to create colorful drawings on Pen Plotters:
* Create a layer for every pen to use and move the corresponding drawings into it
* Name the layer with a title like "Pen 1" or "MyLayerName Pen 1", where the number corresponds to the pen number the plotter should use
* The layer name always overrides the standard pen setting in the plot menu

==== Serial Connection ====
The connection settings now allow you to specify rarely used serial connection settings like byte size, stop bits and parity. Most plotters use the default settings, so only change these if you know what you are doing.

=== HPGL Export ===

The HPGL export (File -> Save as -> HP Grafics Language file) has now the same multiple pens feature as the [[#Plotter Driver]].

=== HPGL Import ===

The HPGL import (File -> Open -> Select .hpgl file) can now import multiple pens into corresponding layers, see [[#Plotter Driver]] for more information.

== Other user interface ==

Snapping in the node tool has been improved:

* When double clicking to insert new nodes, the position of these new nodes will snap to for example path intersections and to path-guide intersections
* When grabbing a segment of a path and dragging it to deform it, the pointer will now snap

== Translations ==
New UI translations for Assamese, Bodo, Dogri, Gujarati, Hindi, Kannada, Kashmiri (Perso-Arabic and Devanagari), Kokani (Roman and Devanagari scripts), Maithili, Malayalam, Manipuri (Meetei Mayek and Bengali scripts), Marathi, Odia, Santali (Devnagari and Ol-Chiki scripts), Sanskrit, Sindhi, Tamil, Urdu (Perso-Arabic and Devanagari scripts).

Notes on Packaging for OS X

2015-06-20T16:48:01Z

~suv: /* 2014: osx-packaging-update (Liam P. White, ~suv) */

= Current Status =

; Available download
: Inkscape 0.91 [http://inkscape.org/en/download/mac-os/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (32bit app for Leopard and Snow Leopard, 64bit app for Lion and later)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678]
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: GIO-based clip art import not supported - [https://bugs.launchpad.net/inkscape/+bug/943148 Bug #943148]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: Lion and later: no support for Retina/HiDPI displays - [https://bugs.launchpad.net/inkscape/+bug/1216795 Bug #1216795]
: Mavericks and later: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]
: Mavericks and later: embedding bitmap images on import or paste from clipboard may crash Inkscape - [https://bugs.launchpad.net/inkscape/+bug/1398521 Bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 Bug #1410793]
: Mavericks and later: application bundle is not signed [https://bugs.launchpad.net/inkscape/+bug/1363305 Bug #1363305]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: improve language detection
: improve CLI usage
: include dbus (without launchd support), gvfs (clipart import, GTK3 file chooser)

; Extensions
: include ps2pdf (Ghostscript)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, wip

; Known issues
: canvas redraws with Quartz backend are delayed (Screen recording [https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%208.mp4 1],[https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4 2])
: exchanging drawing content with native apps via clipboard fails ([https://bugs.launchpad.net/inkscape/+bug/546934 lp:546934], [https://bugzilla.gnome.org/show_bug.cgi?id=692123 gtk:692123])

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

; Available download
: current link to available downloads on the [https://code.launchpad.net/~suv-lp/inkscape/osxmenu branch page] under 'Testing'

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 Proposal] merged into trunk in revision [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13620 13620]
: Update is included in the stable release branch [http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ 0.91.x].

; Related branch
: <strike>[https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]</strike> (merged)

; Available download:
: Stable release packages: [https://inkscape.org/en/download/mac-os/ 0.91] (requires 10.5.8 or later)
: Unstable trunk packages: [https://www.dropbox.com/sh/2n7aim2wcrn6l3h/AADjQQ_484Z_Po1X3RSqa29na?dl=0 0.91+devel (DropBox)] (requires 10.7 or later)

Notes on Packaging for OS X

2015-06-20T16:44:54Z

~suv: /* 2014: osx-packaging-update (Liam P. White, ~suv) */ update download links

= Current Status =

; Available download
: Inkscape 0.91 [http://inkscape.org/en/download/mac-os/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (32bit app for Leopard and Snow Leopard, 64bit app for Lion and later)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678]
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: GIO-based clip art import not supported - [https://bugs.launchpad.net/inkscape/+bug/943148 Bug #943148]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: Lion and later: no support for Retina/HiDPI displays - [https://bugs.launchpad.net/inkscape/+bug/1216795 Bug #1216795]
: Mavericks and later: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]
: Mavericks and later: embedding bitmap images on import or paste from clipboard may crash Inkscape - [https://bugs.launchpad.net/inkscape/+bug/1398521 Bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 Bug #1410793]
: Mavericks and later: application bundle is not signed [https://bugs.launchpad.net/inkscape/+bug/1363305 Bug #1363305]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: improve language detection
: improve CLI usage
: include dbus (without launchd support), gvfs (clipart import, GTK3 file chooser)

; Extensions
: include ps2pdf (Ghostscript)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, wip

; Known issues
: canvas redraws with Quartz backend are delayed (Screen recording [https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%208.mp4 1],[https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4 2])
: exchanging drawing content with native apps via clipboard fails ([https://bugs.launchpad.net/inkscape/+bug/546934 lp:546934], [https://bugzilla.gnome.org/show_bug.cgi?id=692123 gtk:692123])

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

; Available download
: current link to available downloads on the [https://code.launchpad.net/~suv-lp/inkscape/osxmenu branch page] under 'Testing'

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 Proposal] merged into trunk in revision [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13620 13620]
: Update is included in the stable release branch [http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ 0.91.x] for upcoming release.

; Related branch
: <strike>[https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]</strike> (merged)

; Available download:
: Stable release packages: [https://inkscape.org/en/download/mac-os/ 0.91] (requires 10.5.8 or later)
: Unstable trunk packages: [https://www.dropbox.com/sh/2n7aim2wcrn6l3h/AADjQQ_484Z_Po1X3RSqa29na?dl=0 0.91+devel (DropBox)] (requires 10.7 or later)

Notes on Packaging for OS X

2015-06-20T16:40:17Z

~suv: /* Roadmap */ update based on current status (Inkscape 0.91)

= Current Status =

; Available download
: Inkscape 0.91 [http://inkscape.org/en/download/mac-os/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (32bit app for Leopard and Snow Leopard, 64bit app for Lion and later)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678]
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: GIO-based clip art import not supported - [https://bugs.launchpad.net/inkscape/+bug/943148 Bug #943148]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: Lion and later: no support for Retina/HiDPI displays - [https://bugs.launchpad.net/inkscape/+bug/1216795 Bug #1216795]
: Mavericks and later: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]
: Mavericks and later: embedding bitmap images on import or paste from clipboard may crash Inkscape - [https://bugs.launchpad.net/inkscape/+bug/1398521 Bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 Bug #1410793]
: Mavericks and later: application bundle is not signed [https://bugs.launchpad.net/inkscape/+bug/1363305 Bug #1363305]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: improve language detection
: improve CLI usage
: include dbus (without launchd support), gvfs (clipart import, GTK3 file chooser)

; Extensions
: include ps2pdf (Ghostscript)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, wip

; Known issues
: canvas redraws with Quartz backend are delayed (Screen recording [https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%208.mp4 1],[https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4 2])
: exchanging drawing content with native apps via clipboard fails ([https://bugs.launchpad.net/inkscape/+bug/546934 lp:546934], [https://bugzilla.gnome.org/show_bug.cgi?id=692123 gtk:692123])

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

; Available download
: current link to available downloads on the [https://code.launchpad.net/~suv-lp/inkscape/osxmenu branch page] under 'Testing'

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 Proposal] merged into trunk in revision [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13620 13620]
: Update is included in the stable release branch [http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ 0.91.x] for upcoming release.

; Related branch
: <strike>[https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]</strike> (merged)

; Available download:
: Stable pre-release packages: [https://www.dropbox.com/sh/magg5vw5j3y1y3u/AAD-l8JqwCyUNuoWYNRKufyHa?dl=0 0.91.x (DropBox)] (unofficial, requires 10.7 or later)
: Unstable trunk packages: [https://www.dropbox.com/sh/2n7aim2wcrn6l3h/AADjQQ_484Z_Po1X3RSqa29na?dl=0 0.91+devel (DropBox)] (unofficial, requires 10.7 or later)

Notes on Packaging for OS X

2015-06-20T16:35:36Z

~suv: /* Current Status */ update for current package (Inkscape 0.91)

= Current Status =

; Available download
: Inkscape 0.91 [http://inkscape.org/en/download/mac-os/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (32bit app for Leopard and Snow Leopard, 64bit app for Lion and later)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678]
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: GIO-based clip art import not supported - [https://bugs.launchpad.net/inkscape/+bug/943148 Bug #943148]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: Lion and later: no support for Retina/HiDPI displays - [https://bugs.launchpad.net/inkscape/+bug/1216795 Bug #1216795]
: Mavericks and later: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]
: Mavericks and later: embedding bitmap images on import or paste from clipboard may crash Inkscape - [https://bugs.launchpad.net/inkscape/+bug/1398521 Bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 Bug #1410793]
: Mavericks and later: application bundle is not signed [https://bugs.launchpad.net/inkscape/+bug/1363305 Bug #1363305]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: re-enable system fonts
: improve language detection
: improve CLI usage

; Extensions
: use Python 2.7 (64bit) (provided by OS X)
: include ps2pdf, UniConvertor
: include dbus (without launchd support) (0.91)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, wip

; Known issues
: canvas redraws with Quartz backend are delayed (Screen recording [https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%208.mp4 1],[https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4 2])
: exchanging drawing content with native apps via clipboard fails ([https://bugs.launchpad.net/inkscape/+bug/546934 lp:546934], [https://bugzilla.gnome.org/show_bug.cgi?id=692123 gtk:692123])

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

; Available download
: current link to available downloads on the [https://code.launchpad.net/~suv-lp/inkscape/osxmenu branch page] under 'Testing'

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 Proposal] merged into trunk in revision [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13620 13620]
: Update is included in the stable release branch [http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_91_BRANCH/files/head:/packaging/macosx/ 0.91.x] for upcoming release.

; Related branch
: <strike>[https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]</strike> (merged)

; Available download:
: Stable pre-release packages: [https://www.dropbox.com/sh/magg5vw5j3y1y3u/AAD-l8JqwCyUNuoWYNRKufyHa?dl=0 0.91.x (DropBox)] (unofficial, requires 10.7 or later)
: Unstable trunk packages: [https://www.dropbox.com/sh/2n7aim2wcrn6l3h/AADjQQ_484Z_Po1X3RSqa29na?dl=0 0.91+devel (DropBox)] (unofficial, requires 10.7 or later)

Emergency save

2015-05-01T14:57:37Z

~suv: (page needs update)

{{Other languages|en=Emergency save|de=Sicherungskopie}}
{{Needs_update}}
TODO: Update locations for all platforms based on [http://article.gmane.org/gmane.comp.graphics.inkscape.devel/34141 Re: Emergency save could need testing]

When Inkscape crashes, it tries to save the document as a backup with following name:

<filename>.<datetime>.#

If the document has not been saved yet, the name is:

inkscape-emergency.<datetime>.#

Note, that there is no <code>.svg</code> file name ending.

=== On Unix (Linux, Mac OS X, *BSD, etc.) ===

Inkscape tries to save in the following paths:

# Home directory (<code>~/</code>, <code>$HOME</code>, <code>/home/<username>/</code>)
# <code>/tmp/</code>
# In the current working directory
(in that order).

=== On Windows ===

Inkscape tries to save in <code>%UserProfile%</code>:

* XP/2003: <code>C:\Documents and Settings\<username>\</code>
* Vista/7: <code>C:\Users\<username>\</code>

[[Category:User Documentation]]

A better Bucket Fill tool fill

2015-04-26T16:28:58Z

~suv: /* Complaints and requests over the years for a better bucket tool: */ add another bug report link (RFE for geometric mode)

== '''Problem:''' ==

The current bucket fill tool is creating fills based on bitmap pixels of the screen, rather than the vector lines data. It is dependent on the zoom level of the viewport.
This is not necessarily the problem. The actual fill algorithm is creating less than desireable results that leave a lot of laborious clean up work for the artist.

Compared to some developments for this tool in other open source and proprietary software, the fill algorithm is outdated.

- Some times does not fill the area at all and just freezes for a while.

- It leaves empty corner areas all over the place, which the artist has to then manually fix
[[File:BucketToolCornerAreas.png|400px|thumb|center]]

- It leaves empty areas at tight places, where it is somewhat hard to clean them up:
[[File:BucketFillCornerAreasExample.jpg|400px|thumb|center]]
Even if you "grow" your fills, that does not cure the problem.

- Extreme threshold leads to bigger probability of the bucket tool freezing for a bit and not creating a fill at all.

- The "Close gaps" feature is not very intelligent. It closes the gap in one area,while often leaving undesirable empty spaces in other areas. The gap is not being closed at the end of the two lines - which again leaves laborious clean up work for the artist.

- The actual resulting fill is not very precise, the fill nodes are not placed well, are too dense and/or are not corners when needed.

'''Whatever you do with it, it always leaves small pixel areas unfilled!
The shame in it is that it can not properly fill cleanly inked (with the calligraphy tool) lineart it leaves gaps everywhere.
It is a pain to then manually fill them. Zoom in and out to get them. Try filling spiky hair. Just try it.
'''

== '''Complaints and requests over the years for a better bucket tool:''' ==
It has been requested numerous times to improve the bucket fill tool in inkscape.
If you look at the mailing list, the forum and Launchpad -
you will find many users asking for an alternative bucket fill tool that works in a different way to the current one:

https://bugs.launchpad.net/inkscape/+bug/656498

https://bugs.launchpad.net/inkscape/+bug/182930

https://bugs.launchpad.net/inkscape/+bug/170588 (geometric mode)

== '''Possible ways to approach this''' ==

'''Vector bucket fill mode''' - instead of filling areas based on visible pixels, fill it based on surrounding vector shapes.

You can already emulate this sort of bucket fill tool by doing the following workaround:

[https://www.youtube.com/watch?v=XeFgXKzCOlQ&t=3m34s @YouTube]

Having said that I believe that this approach is very hackish and inconvenient. It would be much better if inkscape had a proper tool to do this instead!

Pros:

- The fills are very precise, their nodes fit the surrounding shapes well. Corner nodes are present where needed. Density is good.

- Doesn't leave empty areas like the bucket fill tool at all. The result is much better!

Cons:

- The fills only get created if the area is completely closed. (needs to be implemented an "auto close gap")

- The fills follow the interior shape too precisely. This sometimes leaves small spaces between line and fill when rendered. The artists often needs to "Grow" the line a little bit. Ideally the fill border should be precisely under the middle of the ink lines. (needs to be implemented "grow/shrink" feature)

'''Better bitmap fill algorithm''' - The current fill algorithm suffers from the downsides of the old bucket tool.
There have been big developments over the years and the bucket fill workflow has improved immensely.

1. Gmic colorize - Gimp and Krita recently got a way better fill algorithm:
here is a link with more information of how it works-
https://github.com/mypaint/mypaint/issues/150

Here is explanation of why it is better:
http://www.davidrevoy.com/article240/gmic-line-art-colorization

2. More intelligent Auto-close gaps: https://github.com/callaa/Drawpile/issues/189
Close gap is a feature that is present in a few manga art related painting applications.
It is a planned feature for Krita.

What it does:
It tells the bucket tool to automatically close gaps with an invisible straight line, before doing the fill operation. That stop paint from spilling outside of an area, without affecting the classic "Tolerance" value

[[File:CloseGapsExample3.png|400px|thumb|center]]

If two lines do not overlap and there is a gap between them: Close gap at the end of both lines.

If two lines overlap: Do not auto close gap.

Here is an example of its use in paintstorm studio:
[https://www.youtube.com/watch?v=oXUReniLyqw&t=2m4s @YouTube]

Proposal by Todor Imreorov <blurymind@gmail.com>

Release notes

2015-02-24T11:07:33Z

~suv:

Here are the release notes for all versions of Inkscape. The list of release notes ''in all languages'' is at [[Special:PrefixIndex/Release notes/]].

* [[Release notes/0.92]] (next major release)

* [[Release notes/0.91]] (current release)
* [[Release notes/0.48.5]]
* [[Release notes/0.48.4]]
* [[Release notes/0.48.3]]
* [[Release notes/0.48.2]]
* [[Release notes/0.48.1]]
* [[Release notes/0.48]]
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:About Inkscape]]

SymbolsDialog

2015-02-09T14:57:32Z

~suv: /* Editing Symbols */

=Symbols Dialog=

== Features ==

Allows copying and pasting symbols (<symbol> elements) from both the document being edited and from symbol libraries.

== Use ==

* Open ''Symbol dialog'':
** Object -> Symbol dialog..., or
** Ctrl-Shift-Y. (Note, the shortcut was used for Edit->Undo. I am guessing that this shortcut is pretty unused.)

* Select symbol set

* Drag and drop symbol into document, or
* Copy and paste by
** Click on symbol to copy to clipboard
** Paste (Ctrl-V) to document.

== Symbol Libraries ==

Symbol libraries are sets of symbols located in one SVG document. Inkscape will look for libraries in the ''share/symbols'' directories (both system and personal). Any <symbol> elements defined in the <defs> section will be picked up. (<symbol> elements are allowed anywhere in an SVG document according to the spec, but Inkscape seems to have some trouble if they are not in the <defs> section.)

In order to allow styling of symbols from within Inkscape, styling should be kept out of <symbol> elements as much as possible. It is then possible for a symbol to inherit the styling of the <use> element that references it. In order to provide a default style to a <symbol> one can either provide a general default style in the root <svg> element of the library or add a symbol specific default style by putting a style string in the "inkscape:symbol-style" attribute inside the symbol element. When a symbol is selected in the Symbol dialog, the style will be added to the <use> element in the clipboard.

Note that as a symbol library is an ordinary SVG file, one can also include documentation and/or sample diagrams in the same file.

There are two sample sets of symbols, one with Logic symbols and with AIGA/DOT transportation symbols.

Visio stencil files (.vss) can also be used as a source of symbols by dropping the files into the ''share/symbols'' directory (if libvisio has been linked in).

== Editing Symbols ==

=== Original Draft & Implementation ===
Two commands are available to allow editing of symbols from within Inkscape:

* '''Object->Symbol to Group''':

This converts the <symbol> referenced by the selected <use> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <use> element (clone) that referenced the symbol should be left referencing the group. No default styling is applied to the group itself (since there is no <use> element to inherit it from).

* '''Object->Group to Symbol'''

This converts a selected group to a <symbol> element. No <use> element is created. Any <use> elements that referenced the group will now reference the symbol. The new symbol can be selected in the Symbol dialog in the ''Current Document'' Symbol set. (You may need to unselect and then reselect the ''Current Document'' set to get the symbol to show.)

A lot of alternative ways were tried to be able to round-trip symbols to groups and back. This method seemed the most straight forward and avoids issues with transforms and styling.

Copying (Ctrl-C) and then pasting a symbol, or duplicating a symbol creates a new <use> element (clone) referencing the same symbol.

To copy a <symbol> for creating a new <symbol>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group a useful "id" and "title" using the Object Properties dialog).

=== Current implementation in 0.91 ===

The implementation of this feature was later changed (TODO: update with detailed description for current status in 0.91 - Bug #[https://bugs.launchpad.net/inkscape/+bug/1419345 1419345]).

== Bugs/Issues ==

* Full list of Symbols Bugs: [https://bugs.launchpad.net/inkscape/+bugs?field.tag=symbols Launchpad Bug List]
* Switching Desktop should switch Document Symbol set. (At the moment this is not an issue as each desktop gets its own Symbol dialog.)
* Symbol to Group/Group to Symbol should trigger an update to the symbols shown in the Symbol dialog when symbol set ''Current Document'' is selected.
* Editing a symbol should result in updating the image in the Symbol's dialog.
* Symbols have not been tested well inside Inkscape.
* Symbols referring to external elements (gradients, etc.) probably won't work.
* Symbols can have their own viewbox, this has not been tested.

== Future Enhancements ==

* Generic symbols: It should be possible to extend the Symbol dialog to include <g> elements as well as <symbol> elements. A group could be marked as a symbol by adding an "inkscape:symbol" tag. In this way one can put place holders in for things like text:

<pre>
<g role="inkscape:symbol">
<symbol id="wrapperBox">...</symbol>
<text id="label">...</text>
</g>
</pre>

* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.

[[Category:Dialogs]]

SymbolsDialog

2015-02-09T14:52:18Z

~suv: /* Editing Symbols */ needs update, see e.g. bug #1419345 and questions asked elsewhere

=Symbols Dialog=

== Features ==

Allows copying and pasting symbols (<symbol> elements) from both the document being edited and from symbol libraries.

== Use ==

* Open ''Symbol dialog'':
** Object -> Symbol dialog..., or
** Ctrl-Shift-Y. (Note, the shortcut was used for Edit->Undo. I am guessing that this shortcut is pretty unused.)

* Select symbol set

* Drag and drop symbol into document, or
* Copy and paste by
** Click on symbol to copy to clipboard
** Paste (Ctrl-V) to document.

== Symbol Libraries ==

Symbol libraries are sets of symbols located in one SVG document. Inkscape will look for libraries in the ''share/symbols'' directories (both system and personal). Any <symbol> elements defined in the <defs> section will be picked up. (<symbol> elements are allowed anywhere in an SVG document according to the spec, but Inkscape seems to have some trouble if they are not in the <defs> section.)

In order to allow styling of symbols from within Inkscape, styling should be kept out of <symbol> elements as much as possible. It is then possible for a symbol to inherit the styling of the <use> element that references it. In order to provide a default style to a <symbol> one can either provide a general default style in the root <svg> element of the library or add a symbol specific default style by putting a style string in the "inkscape:symbol-style" attribute inside the symbol element. When a symbol is selected in the Symbol dialog, the style will be added to the <use> element in the clipboard.

Note that as a symbol library is an ordinary SVG file, one can also include documentation and/or sample diagrams in the same file.

There are two sample sets of symbols, one with Logic symbols and with AIGA/DOT transportation symbols.

Visio stencil files (.vss) can also be used as a source of symbols by dropping the files into the ''share/symbols'' directory (if libvisio has been linked in).

== Editing Symbols ==

=== Original Draft & Implementation ===
Two commands are available to allow editing of symbols from within Inkscape:

* '''Object->Symbol to Group''':

This converts the <symbol> referenced by the selected <use> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <use> element (clone) that referenced the symbol should be left referencing the group. No default styling is applied to the group itself (since there is no <use> element to inherit it from).

* '''Object->Group to Symbol'''

This converts a selected group to a <symbol> element. No <use> element is created. Any <use> elements that referenced the group will now reference the symbol. The new symbol can be selected in the Symbol dialog in the ''Current Document'' Symbol set. (You may need to unselect and then reselect the ''Current Document'' set to get the symbol to show.)

A lot of alternative ways were tried to be able to round-trip symbols to groups and back. This method seemed the most straight forward and avoids issues with transforms and styling.

Copying (Ctrl-C) and then pasting a symbol, or duplicating a symbol creates a new <use> element (clone) referencing the same symbol.

To copy a <symbol> for creating a new <symbol>, first convert the symbol to a group, copy the group, edit the copied group, and convert both groups back to symbols (give the new group a useful "id" and "title" using the Object Properties dialog).

=== Current implementation in 0.91 ===

The implementation of this feature was later changed (TODO: update with detailed description for current status in 0.91).

== Bugs/Issues ==

* Full list of Symbols Bugs: [https://bugs.launchpad.net/inkscape/+bugs?field.tag=symbols Launchpad Bug List]
* Switching Desktop should switch Document Symbol set. (At the moment this is not an issue as each desktop gets its own Symbol dialog.)
* Symbol to Group/Group to Symbol should trigger an update to the symbols shown in the Symbol dialog when symbol set ''Current Document'' is selected.
* Editing a symbol should result in updating the image in the Symbol's dialog.
* Symbols have not been tested well inside Inkscape.
* Symbols referring to external elements (gradients, etc.) probably won't work.
* Symbols can have their own viewbox, this has not been tested.

== Future Enhancements ==

* Generic symbols: It should be possible to extend the Symbol dialog to include <g> elements as well as <symbol> elements. A group could be marked as a symbol by adding an "inkscape:symbol" tag. In this way one can put place holders in for things like text:

<pre>
<g role="inkscape:symbol">
<symbol id="wrapperBox">...</symbol>
<text id="label">...</text>
</g>
</pre>

* Connectors: Symbols beg for the use of connectors. It would be easy to define connection points inside a symbol. The Logic symbols include extra nodes to make snapping of input/output lines to the correct places easier. These nodes would be better defined as connection points. Work on an [http://dev.w3.org/SVG/modules/connector/SVGConnector.html SVG Connector] proposal is in progress.

[[Category:Dialogs]]

Release notes/0.91

2015-02-08T22:22:39Z

~suv: /* Improvements */ color markers extension disabled in 0.91 (see bug #1055796)

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

The Inkscape community announces the release of Inkscape 0.91. Inkscape is an multi-platform, Open-Source Vector Graphics Editor that uses SVG as its native file format. Digital artists use it to produce professional quality work. Engineers and scientists use it to create clear drawings to explain their ideas. Everyday people use it to create simple drawings, develop their design skills, and just have fun. This new version features faster and more accurate rendering, new and improved tools, as well as better and wider file-format support.

==Release highlights==

Released on '''2015-01-28'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:

** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.

* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.5|0.48.5]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X, the conflict with X11/XQuartz's pasteboard syncing has not been solved yet: turning off "Update Pasteboard when CLIPBOARD changes" in X11 Preferences prevents that vector data copied or cut to the clipboard gets rasterized on paste. ([https://bugs.launchpad.net/inkscape/+bug/307005 bug #307005])
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])
* On OS X 10.9 or later, turning off "Displays have separate spaces" in Mission Control helps when using X11 across multiple displays. ([https://bugs.launchpad.net/inkscape/+bug/1244397 bug #1244397])
* The reworked '''Import Clip Art''' feature is not available with current OS X packages. ([https://bugs.launchpad.net/inkscape/+bug/943148 bug #943148])
* On MS Windows, the icons for Preferences, Undo, Redo and Revert are missing. ([https://bugs.launchpad.net/inkscape/+bug/1269698 bug #1269698])
* On MS Windows, 64bit Inkscape builds on systems with Intel graphic cards may expose lagging when dragging objects or drawing (pen, pencil and calligraphy tools); hiding the rulers can help to improve performance. ([https://bugs.launchpad.net/inkscape/+bug/1351597 bug #1351597])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Tracking Dependencies

2015-02-07T15:00:57Z

~suv: /* Distros */ fill in versions for Windows devlibs 64bit (from pkgconfig files)

== Overview ==

We need help getting our basic lib dependencies listed out and kept up to date. Also we need to track which versions of which distros have the needed dependencies.

To get glib and GTK+ dependencies figured out, people can go through the API documentation and look for the 'since' entries saying when calls were added. Then look for those calls in our source. Voila! we'll have base minimum dependencies figured out.

== Libs ==

C++ bindings are not included, since their required versions match those of the C counterparts.

{| class="wikitable"
|-
! Library
! v 0.91
! trunk
! trunk (GTK+ 3.0 build)
|-
| Boehm-GC
| 7.1
| 7.1
| 7.1
|-
| Cairo
| 1.10
| 1.10
| 1.10
|-
| GDL
| N/A
| N/A
| 3.3.4
|-
| Glib
| 2.28
| 2.28
| 2.28
|-
| GTK+
| 2.24
| 2.24
| 3.2
|-
| GNU Scientific Library
| ?
| ?
| ?
|-
| LittleCMS
| 1.13
| 1.13
| 1.13
|-
| libxml
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
|-
| libxslt
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
|-
| Pango
| ?
| ?
| 1.24
|-
| Poppler
| ''0.5.9*''
| ''0.5.9*''
| ''0.5.9*''
|-
| libsigc++
| ''2.0.12*''
| ''2.0.12*''
| ''2.0.12*''
|}

''* Tentative dependency''

== Distros ==

Note: This table is not relevant to (non-fink) MacOS X, where we ship the desired version with Inkscape.

{| class="wikitable"
|-
! Distro
! cairo
! cairomm
! glib
! glibmm
! gtk+
! gtkmm
! pango
! poppler
! gdl
! lcms
! libsigc++
! libgc 
|-
| style="background:Violet;"|Windows Devlibs (32bit) [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs/trunk] (r53)
| 1.11.2
| 1.10.0
| 2.28.8
| 2.28.2
| style="background:Violet;"| 2.24.10
| style="background:Violet;"| 2.24.2
| 1.28.3
| 0.12.1
| style="background:Violet;"| (none)
| 1.17 2.4
| 2.2.11
| 7.1
|-
| Windows Devlibs Gtk+ 3 branch [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs/devlibs-gtk3] (r34)
| 1.10.2
| 1.10.0
| 2.38.0
| 2.36.0
| 2.24.18 3.8.1
| 2.24.2 3.8.0
| 1.34.0
| 0.22.5
| 3.4.2
| 1.19 2.4
| 2.2.10
| 7.2d
|-
| Windows Devlibs 64bit [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs64/trunk] (r17)
| 1.14.1
| 1.11.2
| 2.40.0
| 2.40.0
| 2.24.23 3.13.1
| 2.24.4 3.12.0
| 1.36.3
| 0.24.2
| 3.12.0
| - 2.6
| 2.3.1
| 7.2
|-
| Debian 7.0 (Wheezy, stable)
| 1.12.2
| 1.10.0
| 2.33.12
| 2.32.1
| 2.24.10 3.4.2
| 2.24.2 3.4.2
| 1.32.5
| 0.18.4
| 3.4.2
| 1.19 2.2
| 2.2.10
| 7.1
|-
| Fedora 20
| 1.13.1+git
| 1.10.0
| 2.38.2
| 2.38.1
| 2.24.22 3.10.6
| 2.24.4 3.10.1
| 1.36.1
| 0.24.3
| 3.10.0
| 1.19 2.5
| 2.3.1
| 7.2d
|-
| OpenSuSE 13.1 EOL 2015-05-01[http://en.opensuse.org/Lifetime]
| 1.12.16
| 1.10.0
| 2.38.1
| 2.38.0
| 2.24.22 3.10.2
| 2.24.4 3.10.0
| 1.36.0
| 0.24.3
| 3.10.0
| 1.19 2.5
| 2.3.1
| 7.2d
|-
| Ubuntu 12.04 LTS (Precise) EOL 2017-04
| 1.10.2
| 1.10.0
| 2.32.4
| 2.32.0
| 2.24.10 3.4.2
| 2.24.2 3.4.0
| 1.30.0
| 0.18.4
| 3.3.91
| 1.19 2.2
| 2.2.10
| 7.1
|-
| Ubuntu 14.04 (Trusty) EOL 2019-04
| 1.13.0
| 1.10.0
| 2.40.2
| 2.39.93
| 2.24.23 3.10.8
| 2.24.4 3.10.1
| 1.36.3
| 0.24.5
| 3.8.1
| 1.19 2.5
| 2.2.10
| 7.2d
|-
| Ubuntu 14.10 (Utopic), EOL 2015-07
| 1.13.0
| 1.10.0
| 2.42.1
| 2.42.0
| 2.24.25 3.12.2
| 2.24.4 3.12.0
| 1.36.6
| 0.26.5
| 3.12.0
| 1.19 2.6
| 2.2.11
| 7.2d
|-
| Ubuntu 15.04 (Vivid) (As of 2015-02-07), EOL 2016-01
| 1.14.0
| 1.11.2
| 2.43.3
| 2.42.0
| 2.24.25 3.14.7
| 2.24.4 3.14.0
| 1.36.8
| 0.30.0
| 3.14.0
| 1.19 2.6
| 2.4.0
| 7.2d
|}

{| class="wikitable"
|-
! Legend
|-
| style="background:Red;"| Inkscape stable unsupported
|-
| style="background:Orange;"| Inkscape trunk unsupported
|-
| style="background:Violet;"| GTK+ 3 builds unsupported
|}

== Getting and Installing Source packages ==

If your distro does not have some packages available (like many don't, ie, Fedora Core 2), you must often download
source packages and build and install them yourself. Actually this is not that hard, and is similar to
doing a Gentoo 'emerge.'

* Usually you download a file with a name like somepackage-1.0.tar.gz. Unpack it with

$ tar zxf somepackage-1.0.tar.gz
or
$ tar jxf somepackage-1.0.tar.bz2

* Then 'cd' into the new directory.

* Configure it with the command:

$ ./configure

* Build it with:

$ make

* As the 'root' user, install it with:

# make install

=== Boehm-GC ===

Source: http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source

* Download this file:
** http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.8.tar.gz
* Unpack it
** tar zxf gc6.8.tar.gz
* Configure and build it
** cd gc6.8
** ./configure --disable-shared --enable-static
** make
* Install it
** su (or however else you become root)
** make install

Binaries: If searching for a package for GC, the name of it is sometimes:

* gc
* libgc
* gc-devel
* libgc-devel
* boehm-gc (on Gentoo)
* debian/ubuntu: sudo apt-get install libgc-dev

=== libSigc++ ===

Source: http://ftp.gnome.org/pub/GNOME/sources/libsigc++/2.2/libsigc++-2.2.3.tar.bz2

With this file, and for GlibMM and GtkMM below, it is usually desirable for us developers to
build this C++ library statically. This removes a dependency that might be difficult for an
end-user during installation. Configure it with:

./configure --enable-static --disable-shared

=== GlibMM ===
Try to match your Glib2 version with GlibMM's version. For example, if your Glib2 is 2.16.6, download glibmm-2.16.4.tar.bz2.

Latest source: http://ftp.gnome.org/pub/GNOME/sources/glibmm/

=== GtkMM ===
Usually you can try the latest version of GtkMM, but if you get version mismatch errors, try older releases.

Source: http://ftp.gnome.org/pub/GNOME/sources/gtkmm/2.12/gtkmm-2.12.7.tar.bz2

=== cairomm ===

if you got prompted about cairomm, try first solve your cairo version, so you can grab [http://www.cairographics.org/releases/ there] a compatible version.

=== Boost ===

Many users have reported when building from source that after installing the above dependencies, the configure script still requires a "boost" package. It can be found below, but even after installing, you will need to create a symlink to allow the configure script to find it:

ln -s /usr/local/include/boost_1_xx_x/boost /usr/local/include/boost

Source: http://www.boost.org/users/download/

=== Poppler ===

Source: http://poppler.freedesktop.org/

Poppler is required for PDF import. There are several potential issues:
* Some Linux distributions do not ship the Xpdf headers required by Inkscape. In such cases, you need to recompile Poppler, passing --enable-xpdf-headers on the configure line or install the libpoppler-private-dev package. See [https://bugs.launchpad.net/inkscape/+bug/254849 this wishlist bug]. This typically manifests in error messages like this:
<pre>In file included from extension/internal/pdfinput/svg-builder.cpp:19:
extension/internal/pdfinput/svg-builder.h:32:23: error: CharTypes.h: No such file or directory
...
make[2]: *** [extension/internal/pdfinput/svg-builder.o] Error 1
make[2]: Leaving directory `/tmp/build/inkscape-0.46/src'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/tmp/build/inkscape-0.46'
make: *** [all] Error 2</pre>
* Inkscape 0.47 does not compile with Poppler >= 0.12.2. If you need to compile Inkscape on such systems, use the development version from Bazaar, where this bug is fixed. See [https://bugs.launchpad.net/inkscape/+bug/487038 the bug report] for details and a minimal patch.
* Inkscape compiled with Poppler <= 0.12.1 will run on systems with Poppler >= 0.12.2, but the PDF import function will crash instantly. This problem does not concern Windows users, since the correct Poppler version is contained in the Windows installer package. This cannot be fixed on Inkscape's side: those two versions of Poppler are not ABI compatible, yet share the same soname. See [https://bugs.launchpad.net/inkscape/+bug/258504 this bug] for more details.
* Poppler's Xpdf headers are not guaranteed to be API-compatible between releases. It's likely that future Poppler versions will break PDF import in some way. PDF import works at least up to 0.12.4 but might not work with later versions.

[[Category:About Inkscape]]
[[Category:Developer Documentation]]

Tracking Dependencies

2015-02-07T14:43:49Z

~suv: /* Distros */ add Inkscape Devlibs for Windows 64-bit

== Overview ==

We need help getting our basic lib dependencies listed out and kept up to date. Also we need to track which versions of which distros have the needed dependencies.

To get glib and GTK+ dependencies figured out, people can go through the API documentation and look for the 'since' entries saying when calls were added. Then look for those calls in our source. Voila! we'll have base minimum dependencies figured out.

== Libs ==

C++ bindings are not included, since their required versions match those of the C counterparts.

{| class="wikitable"
|-
! Library
! v 0.91
! trunk
! trunk (GTK+ 3.0 build)
|-
| Boehm-GC
| 7.1
| 7.1
| 7.1
|-
| Cairo
| 1.10
| 1.10
| 1.10
|-
| GDL
| N/A
| N/A
| 3.3.4
|-
| Glib
| 2.28
| 2.28
| 2.28
|-
| GTK+
| 2.24
| 2.24
| 3.2
|-
| GNU Scientific Library
| ?
| ?
| ?
|-
| LittleCMS
| 1.13
| 1.13
| 1.13
|-
| libxml
| ''2.6.11*''
| ''2.6.11*''
| ''2.6.11*''
|-
| libxslt
| ''1.0.15*''
| ''1.0.15*''
| ''1.0.15*''
|-
| Pango
| ?
| ?
| 1.24
|-
| Poppler
| ''0.5.9*''
| ''0.5.9*''
| ''0.5.9*''
|-
| libsigc++
| ''2.0.12*''
| ''2.0.12*''
| ''2.0.12*''
|}

''* Tentative dependency''

== Distros ==

Note: This table is not relevant to (non-fink) MacOS X, where we ship the desired version with Inkscape.

{| class="wikitable"
|-
! Distro
! cairo
! cairomm
! glib
! glibmm
! gtk+
! gtkmm
! pango
! poppler
! gdl
! lcms
! libsigc++
! libgc 
|-
| style="background:Violet;"|Windows Devlibs (32bit) [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs/trunk] (r53)
| 1.11.2
| 1.10.0
| 2.28.8
| 2.28.2
| style="background:Violet;"| 2.24.10
| style="background:Violet;"| 2.24.2
| 1.28.3
| 0.12.1
| style="background:Violet;"| (none)
| 1.17 2.4
| 2.2.11
| 7.1
|-
| Windows Devlibs Gtk+ 3 branch [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs/devlibs-gtk3] (r34)
| 1.10.2
| 1.10.0
| 2.38.0
| 2.36.0
| 2.24.18 3.8.1
| 2.24.2 3.8.0
| 1.34.0
| 0.22.5
| 3.4.2
| 1.19 2.4
| 2.2.10
| 7.2d
|-
| Windows Devlibs 64bit [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs64/trunk] (r17)
| 1.14.1
| ??
| ??
| ??
| ?? ??
| ?? ??
| ??
| ??
| ??
| ?? ??
| ??
| ??
|-
| Debian 7.0 (Wheezy, stable)
| 1.12.2
| 1.10.0
| 2.33.12
| 2.32.1
| 2.24.10 3.4.2
| 2.24.2 3.4.2
| 1.32.5
| 0.18.4
| 3.4.2
| 1.19 2.2
| 2.2.10
| 7.1
|-
| Fedora 20
| 1.13.1+git
| 1.10.0
| 2.38.2
| 2.38.1
| 2.24.22 3.10.6
| 2.24.4 3.10.1
| 1.36.1
| 0.24.3
| 3.10.0
| 1.19 2.5
| 2.3.1
| 7.2d
|-
| OpenSuSE 13.1 EOL 2015-05-01[http://en.opensuse.org/Lifetime]
| 1.12.16
| 1.10.0
| 2.38.1
| 2.38.0
| 2.24.22 3.10.2
| 2.24.4 3.10.0
| 1.36.0
| 0.24.3
| 3.10.0
| 1.19 2.5
| 2.3.1
| 7.2d
|-
| Ubuntu 12.04 LTS (Precise) EOL 2017-04
| 1.10.2
| 1.10.0
| 2.32.4
| 2.32.0
| 2.24.10 3.4.2
| 2.24.2 3.4.0
| 1.30.0
| 0.18.4
| 3.3.91
| 1.19 2.2
| 2.2.10
| 7.1
|-
| Ubuntu 14.04 (Trusty) EOL 2019-04
| 1.13.0
| 1.10.0
| 2.40.2
| 2.39.93
| 2.24.23 3.10.8
| 2.24.4 3.10.1
| 1.36.3
| 0.24.5
| 3.8.1
| 1.19 2.5
| 2.2.10
| 7.2d
|-
| Ubuntu 14.10 (Utopic), EOL 2015-07
| 1.13.0
| 1.10.0
| 2.42.1
| 2.42.0
| 2.24.25 3.12.2
| 2.24.4 3.12.0
| 1.36.6
| 0.26.5
| 3.12.0
| 1.19 2.6
| 2.2.11
| 7.2d
|-
| Ubuntu 15.04 (Vivid) (As of 2015-02-07), EOL 2016-01
| 1.14.0
| 1.11.2
| 2.43.3
| 2.42.0
| 2.24.25 3.14.7
| 2.24.4 3.14.0
| 1.36.8
| 0.30.0
| 3.14.0
| 1.19 2.6
| 2.4.0
| 7.2d
|}

{| class="wikitable"
|-
! Legend
|-
| style="background:Red;"| Inkscape stable unsupported
|-
| style="background:Orange;"| Inkscape trunk unsupported
|-
| style="background:Violet;"| GTK+ 3 builds unsupported
|}

== Getting and Installing Source packages ==

If your distro does not have some packages available (like many don't, ie, Fedora Core 2), you must often download
source packages and build and install them yourself. Actually this is not that hard, and is similar to
doing a Gentoo 'emerge.'

* Usually you download a file with a name like somepackage-1.0.tar.gz. Unpack it with

$ tar zxf somepackage-1.0.tar.gz
or
$ tar jxf somepackage-1.0.tar.bz2

* Then 'cd' into the new directory.

* Configure it with the command:

$ ./configure

* Build it with:

$ make

* As the 'root' user, install it with:

# make install

=== Boehm-GC ===

Source: http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source

* Download this file:
** http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.8.tar.gz
* Unpack it
** tar zxf gc6.8.tar.gz
* Configure and build it
** cd gc6.8
** ./configure --disable-shared --enable-static
** make
* Install it
** su (or however else you become root)
** make install

Binaries: If searching for a package for GC, the name of it is sometimes:

* gc
* libgc
* gc-devel
* libgc-devel
* boehm-gc (on Gentoo)
* debian/ubuntu: sudo apt-get install libgc-dev

=== libSigc++ ===

Source: http://ftp.gnome.org/pub/GNOME/sources/libsigc++/2.2/libsigc++-2.2.3.tar.bz2

With this file, and for GlibMM and GtkMM below, it is usually desirable for us developers to
build this C++ library statically. This removes a dependency that might be difficult for an
end-user during installation. Configure it with:

./configure --enable-static --disable-shared

=== GlibMM ===
Try to match your Glib2 version with GlibMM's version. For example, if your Glib2 is 2.16.6, download glibmm-2.16.4.tar.bz2.

Latest source: http://ftp.gnome.org/pub/GNOME/sources/glibmm/

=== GtkMM ===
Usually you can try the latest version of GtkMM, but if you get version mismatch errors, try older releases.

Source: http://ftp.gnome.org/pub/GNOME/sources/gtkmm/2.12/gtkmm-2.12.7.tar.bz2

=== cairomm ===

if you got prompted about cairomm, try first solve your cairo version, so you can grab [http://www.cairographics.org/releases/ there] a compatible version.

=== Boost ===

Many users have reported when building from source that after installing the above dependencies, the configure script still requires a "boost" package. It can be found below, but even after installing, you will need to create a symlink to allow the configure script to find it:

ln -s /usr/local/include/boost_1_xx_x/boost /usr/local/include/boost

Source: http://www.boost.org/users/download/

=== Poppler ===

Source: http://poppler.freedesktop.org/

Poppler is required for PDF import. There are several potential issues:
* Some Linux distributions do not ship the Xpdf headers required by Inkscape. In such cases, you need to recompile Poppler, passing --enable-xpdf-headers on the configure line or install the libpoppler-private-dev package. See [https://bugs.launchpad.net/inkscape/+bug/254849 this wishlist bug]. This typically manifests in error messages like this:
<pre>In file included from extension/internal/pdfinput/svg-builder.cpp:19:
extension/internal/pdfinput/svg-builder.h:32:23: error: CharTypes.h: No such file or directory
...
make[2]: *** [extension/internal/pdfinput/svg-builder.o] Error 1
make[2]: Leaving directory `/tmp/build/inkscape-0.46/src'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/tmp/build/inkscape-0.46'
make: *** [all] Error 2</pre>
* Inkscape 0.47 does not compile with Poppler >= 0.12.2. If you need to compile Inkscape on such systems, use the development version from Bazaar, where this bug is fixed. See [https://bugs.launchpad.net/inkscape/+bug/487038 the bug report] for details and a minimal patch.
* Inkscape compiled with Poppler <= 0.12.1 will run on systems with Poppler >= 0.12.2, but the PDF import function will crash instantly. This problem does not concern Windows users, since the correct Poppler version is contained in the Windows installer package. This cannot be fixed on Inkscape's side: those two versions of Poppler are not ABI compatible, yet share the same soname. See [https://bugs.launchpad.net/inkscape/+bug/258504 this bug] for more details.
* Poppler's Xpdf headers are not guaranteed to be API-compatible between releases. It's likely that future Poppler versions will break PDF import in some way. PDF import works at least up to 0.12.4 but might not work with later versions.

[[Category:About Inkscape]]
[[Category:Developer Documentation]]

Release notes/0.91

2015-02-02T11:46:14Z

~suv: /* Known issues */

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

The Inkscape community announces the release of Inkscape 0.91. Inkscape is an multi-platform, Open-Source Vector Graphics Editor that uses SVG as its native file format. Digital artists use it to produce professional quality work. Engineers and scientists use it to create clear drawings to explain their ideas. Everyday people use it to create simple drawings, develop their design skills, and just have fun. This new version features faster and more accurate rendering, new and improved tools, as well as better and wider file-format support.

==Release highlights==

Released on '''2015-01-28'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:

** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.
* '''Color Markers to Match Stroke''' extension improvements. The markers can now inherit the fill and stroke colors and alpha channels from the object, or be customized with color selectors in a separate tab.
* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.5|0.48.5]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X, the conflict with X11/XQuartz's pasteboard syncing has not been solved yet: turning off "Update Pasteboard when CLIPBOARD changes" in X11 Preferences prevents that vector data copied or cut to the clipboard gets rasterized on paste. ([https://bugs.launchpad.net/inkscape/+bug/307005 bug #307005])
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])
* On OS X 10.9 or later, turning off "Displays have separate spaces" in Mission Control helps when using X11 across multiple displays. ([https://bugs.launchpad.net/inkscape/+bug/1244397 bug #1244397])
* The reworked '''Import Clip Art''' feature is not available with current OS X packages. ([https://bugs.launchpad.net/inkscape/+bug/943148 bug #943148])
* On MS Windows, the icons for Preferences, Undo, Redo and Revert are missing. ([https://bugs.launchpad.net/inkscape/+bug/1269698 bug #1269698])
* On MS Windows, 64bit Inkscape builds on systems with Intel graphic cards may expose lagging when dragging objects or drawing (pen, pencil and calligraphy tools); hiding the rulers can help to improve performance. ([https://bugs.launchpad.net/inkscape/+bug/1351597 bug #1351597])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Notes On Units Handling in Extensions in 0.91

2015-01-31T02:05:32Z

~suv:

Since the release of Inkscape 0.48.4 there has been a fundamental change made in the scaling of length variables in Inkscape. The [http://www.w3.org/TR/SVG11/coords.html#ViewBoxAttribute <code>viewBox</code>] attribute has been introduced as a standard feature of all files, and its size is determined by the units that are chosen for the variable <code>inkscape:document-units</code> (see dialog ''Document Properties: Default Units''). In the Python extensions this has led to the requirement that units of length variables must be explicitly taken into account, otherwise they will not scale correctly when changing the ''Default Units'' (see [https://bugs.launchpad.net/inkscape/+bug/1240455 Bug 1240455]). Previously this type of scaling was done with a call to <code>inkex.unittouu()</code>, the new syntax for this call is <code>self.unittouu()</code>. Attached is a list of situations in which you may need to do this type of scaling, to convert to document units:

# When reading the document height/width (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/dxf_outlines.py dxf_outlines.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/dxf_outlines.py r12722])
# When reading any .inx file input variable that has units of length (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/grid_cartesian.py grid_cartesian.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13007#share/extensions/grid_cartesian.py r13007])
# When specifying a stroke-width or font-size in a style attribute (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/split.py split.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/split.py r12722]; [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/render_gears.py render_gears.py] [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/render_gears.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13001#share/extensions/render_gears.py r13001], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13036#share/extensions/render_gears.py r13036])
# For multiple items in a group, it may be more efficient to scale the group with a transform, rather than scaling individual objects (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/render_barcode.py render_barcode.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13015#share/extensions/render_barcode.py r13015]).
# Remember that console commands like <code>inkscape --query-all</code>, to query the bbox, return pixels regardless of the document units, so they will need to be converted (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/dimension.py dimension.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13028#share/extensions/dimension.py r13028]).
# Remember that guides, which are in the <code>sodipodi:namedview</code> section, are not affected by document units, so they do not need to be scaled (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/guides_creator.py guides_creator.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/guides_creator.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13007#share/extensions/guides_creator.py r13007]).
# If you are creating new classes unique to your application, you may need to provide a mechanism to allow your new class to continue to access <code>unittouu()</code> (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/ink2canvas.py ink2canvas.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/ink2canvas.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13027#share/extensions/ink2canvas.py r13027]).

----
Original version of the notes by Alvin Penner: [https://bugs.launchpad.net/inkscape/+bug/1240455/+attachment/4041646/+files/scaling.txt scaling.txt] (see comments 31-34 in [https://bugs.launchpad.net/inkscape/+bug/1240455 Bug 1240455])

[[Category:Extensions]]

PythonEffectTutorial

2015-01-31T02:02:38Z

~suv: update for 0.91

Effect extensions in Inkscape means a simple programs or scripts that reads an SVG file from standard input, transforms it somehow and prints it to the standart output. Usually Inkscape sits on both ends, providing the file with some parameters as input first and finally reading the output, which is then used for further work.
[[Image:Effect_flow.svg|thumb|right|400px]]

We will write a simple effect extension script in [http://docs.python.org Python] that will put "Hello World!" or "Hello <value of --what option>!" string in the center of document and inside a new layer.

== Effect Extension Script ==

First of all create a file ''hello_world.py'' and make it executable with the Python interpreter with the well-known directive:
<pre>
#!/usr/bin/env python
</pre>

If you're going to put the file somewhere else than into inkscape's installation directory, we need to add a path so that python can find the necessary modules:
<pre>
import sys
sys.path.append('/usr/share/inkscape/extensions') # or another path, as necessary
</pre>

Import the ''inkex.py'' file with the ''Effect'' base class that will do most of the work for us and the ''simplestyle.py'' module with support functions for working with CSS styles. We will use just the ''formatStyle'' function from this module:
<pre>
import inkex
from simplestyle import *
</pre>

Declare a ''HelloWordEffect'' class that inherits from ''Effect'' and write a constructor where the base class is initialized and script options for the option parser are defined:
<pre>
class HelloWorldEffect(inkex.Effect):
def __init__(self):
inkex.Effect.__init__(self)
self.OptionParser.add_option('-w', '--what', action = 'store',
type = 'string', dest = 'what', default = 'World',
help = 'What would you like to greet?')
</pre>

The complete documentation for the ''OptionParser'' class can be found at [https://docs.python.org/2/library/optparse.html docs.python.org]. Here we just use the ''add_option'' method which has as first argument a short option name, as second argument a long option name and then a few other arguments with this meaning:

* ''action'' - An action which should be done with option value. In this case we use action ''store'' which will store option value in ''self.options.<destination>'' attribute.
* ''type'' - Type of option value. We use string here.
* ''dest'' - Destination of option action specified by ''action'' argument. Using ''what'' value we say that we want to store option value to self.options.what attribute.
* ''default'' - Defalut value for this option if it is not specified.
* ''help'' - A help string that will be displayed if script will be given no arguments or some option or argument will have wrong syntax.

Inkscape will create a GUI form with widgets for all specified options and prefill them with the default values specified using the ''.inx'' file for this extension which we will write later.

We need to override only one ''Effect'' class method to provide the desired effect functionality:
<pre>
def effect(self):
what = self.options.what
</pre>
As you can imagine we just stored the ''--what'' option value to the ''what'' variable.

Now we will finally start to do something. We will have to work with the XML representation of the SVG document that we can access via ''Effect'''s ''self.document'' attribute.
It is of lxml's '' _ElementTree'' class type. Complete documentation for the lxml package can be found at [http://lxml.de/ lxml.de].

First we get SVG document's ''svg'' element and its dimensions:
<pre>
svg = self.document.getroot()
# or alternatively
# svg = self.document.xpath('//svg:svg',namespaces=inkex.NSS)[0]

# Again, there are two ways to get the attibutes:
width = self.unittouu(svg.get('width'))
height = self.unittouu(svg.attrib['height'])
</pre>
The ''xpath'' function returns a list of all matching elements so we just use the first one of them.

We now create an SVG group element ('' 'g' '') and "mark" it as a layer using Inkscape' SVG extensions:
<pre>
layer = inkex.etree.SubElement(svg, 'g')
layer.set(inkex.addNS('label', 'inkscape'), 'Hello %s Layer' % (what))
layer.set(inkex.addNS('groupmode', 'inkscape'), 'layer')
</pre>
This creates ''inkscape:label'' and ''inkscape:groupmode'' attributes, which will only be read by Inkscape or compatible applications. To all other viewers, this new element looks just like a plain SVG group.

Now we create an SVG text element with a text value containing the "Hello World" string:
<pre>
text = inkex.etree.Element(inkex.addNS('text','svg'))
text.text = 'Hello %s!' % (what)
</pre>

Set the position of the text to the center of SVG document:
<pre>
text.set('x', str(width / 2))
text.set('y', str(height / 2))
</pre>

If we want to center the text on its position we need to define the CSS style of the SVG ''text'' element. Actually we use the ''text-anchor'' SVG extension to CSS styles to do that work:
<pre>
style = {'text-align' : 'center', 'text-anchor' : 'middle'}
text.set('style', formatStyle(style))
</pre>

Finally we connect all created elements together and put them into the SVG document:
<pre>
layer.append(text)
</pre>

We just defined a class that inherited from the original effect extension so we have to create an instance of it and execute it in the main control flow:
<pre>
effect = HelloWorldEffect()
effect.affect()
</pre>

== Extension Description File ==

To include script in Inkscape's main menu create ''hello_world.inx'' file describing script evokation.

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<inkscape-extension xmlns="http://www.inkscape.org/namespace/inkscape/extension">
<_name>Hello World!</_name>
<id>org.ekips.filter.hello_world</id>
<dependency type="executable" location="extensions">hello_world.py</dependency>
<dependency type="executable" location="extensions">inkex.py</dependency>
<param name="what" type="string" _gui-text="What would you like to greet?">World</param>
<effect>
<object-type>all</object-type>
<effects-menu>
<submenu _name="Examples"/>
</effects-menu>
</effect>
<script>
<command reldir="extensions" interpreter="python">hello_world.py</command>
</script>
</inkscape-extension>
</pre>

Create ''<param>'' element for every option of a script and ''<dependency>'' for every included module which is not from Python standard library. Inkscape will search for this modules in directory with script. ''<effect>'' element and its descendants defines name of menu item evoking our new "Hello World!" extension.

If the inx file isn't well formed or if any of the dependencies wasn't met, the extension won't show up in the menu. If your extension doesn't show up, take a look at extension-errors.log, which may give you a hint why it wasn't loaded.

== Installation ==

To install a new extenstion just put ''hello_world.py'' and ''hello_world.inx'' files with all dependency modules to the ''<path_to_inkscape>/extensions'' or ''~/.config/inkscape/extensions'' directory. On Linux you will probably have to make the python script executable first if you haven't done this yet. This is usually done by the usual command (or in your preferred file manager):
<pre>
$ chmod a+x hello_world.py
</pre>

Now start Inkscape. A new menu item ''Hello World!'' in ''Extensions->Examples'' menu should appear.

== Complete Source Code ==

Here is a complete commented source pre of ''hello_world.py'' script file:

<pre>
#!/usr/bin/env python

# These two lines are only needed if you don't put the script directly into
# the installation directory
import sys
sys.path.append('/usr/share/inkscape/extensions')

# We will use the inkex module with the predefined Effect base class.
import inkex
# The simplestyle module provides functions for style parsing.
from simplestyle import *

class HelloWorldEffect(inkex.Effect):
"""
Example Inkscape effect extension.
Creates a new layer with a "Hello World!" text centered in the middle of the document.
"""
def __init__(self):
"""
Constructor.
Defines the "--what" option of a script.
"""
# Call the base class constructor.
inkex.Effect.__init__(self)

# Define string option "--what" with "-w" shortcut and default value "World".
self.OptionParser.add_option('-w', '--what', action = 'store',
type = 'string', dest = 'what', default = 'World',
help = 'What would you like to greet?')

def effect(self):
"""
Effect behaviour.
Overrides base class' method and inserts "Hello World" text into SVG document.
"""
# Get script's "--what" option value.
what = self.options.what

# Get access to main SVG document element and get its dimensions.
svg = self.document.getroot()
# or alternatively
# svg = self.document.xpath('//svg:svg',namespaces=inkex.NSS)[0]

# Again, there are two ways to get the attibutes:
width = self.unittouu(svg.get('width'))
height = self.unittouu(svg.attrib['height'])

# Create a new layer.
layer = inkex.etree.SubElement(svg, 'g')
layer.set(inkex.addNS('label', 'inkscape'), 'Hello %s Layer' % (what))
layer.set(inkex.addNS('groupmode', 'inkscape'), 'layer')

# Create text element
text = inkex.etree.Element(inkex.addNS('text','svg'))
text.text = 'Hello %s!' % (what)

# Set text position to center of document.
text.set('x', str(width / 2))
text.set('y', str(height / 2))

# Center text horizontally with CSS style.
style = {'text-align' : 'center', 'text-anchor': 'middle'}
text.set('style', formatStyle(style))

# Connect elements together.
layer.append(text)

# Create effect instance and apply it.
effect = HelloWorldEffect()
effect.affect()
</pre>

Last edited by --[[User:Rubikcube|Rubikcube]] 21:18, 7 August 2008 (UTC), based on a version by
[[User:Blackhex|Blackhex]] 11:59, 26 April 2007 (UTC)
[[Category:Developer Documentation]]
[[Category:Extensions]]

Release notes/0.91

2015-01-25T11:21:01Z

~suv: /* Known issues */

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

'''(not released yet - [[AnnouncePlanning091]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:
** '''Extrapolated''': this extrapolates the contour of the stroked path to obtain a more natural looking miter join.
** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.
* '''Color Markers to Match Stroke''' extension improvements. The markers can now inherit the fill and stroke colors and alpha channels from the object, or be customized with color selectors in a separate tab.
* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.4|0.48.4]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X, the conflict with X11/XQuartz's pasteboard syncing has not been solved yet: turning off "Update Pasteboard when CLIPBOARD changes" in X11 Preferences prevents that vector data copied or cut to the clipboard gets rasterized on paste. ([https://bugs.launchpad.net/inkscape/+bug/307005 bug #307005])
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])
* On OS X 10.9 or later, turning off "Displays have separate spaces" in Mission Control helps when using X11 across multiple displays. ([https://bugs.launchpad.net/inkscape/+bug/1244397 bug #1244397])
* The reworked '''Import Clip Art''' feature is not available with current OS X packages. ([https://bugs.launchpad.net/inkscape/+bug/943148 bug #943148])
* On MS Windows, the icons for Preferences, Undo, Redo and Revert are missing. ([https://bugs.launchpad.net/inkscape/+bug/1269698 bug #1269698])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Release notes/0.91

2015-01-25T06:43:10Z

~suv: /* Known issues */

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

'''(not released yet - [[AnnouncePlanning091]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:
** '''Extrapolated''': this extrapolates the contour of the stroked path to obtain a more natural looking miter join.
** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.
* '''Color Markers to Match Stroke''' extension improvements. The markers can now inherit the fill and stroke colors and alpha channels from the object, or be customized with color selectors in a separate tab.
* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.4|0.48.4]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X, the conflict with X11/XQuartz's pasteboard syncing has not been solved yet: turning off "Update Pasteboard when CLIPBOARD changes" in X11 Preferences prevents that vector data copied or cut to the clipboard gets rasterized on paste. ([https://bugs.launchpad.net/inkscape/+bug/307005 bug #307005])
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])
* On OS X 10.9 or later, turning off "Displays have separate spaces" in Mission Control helps when using X11 across multiple displays. ([https://bugs.launchpad.net/inkscape/+bug/1244397 bug #1244397])
* The reworked '''Import Clip Art''' feature is not available with current OS X packages. ([https://bugs.launchpad.net/inkscape/+bug/943148 bug #943148])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Release notes/0.91

2015-01-25T06:28:01Z

~suv: /* Known issues */

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

'''(not released yet - [[AnnouncePlanning091]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:
** '''Extrapolated''': this extrapolates the contour of the stroked path to obtain a more natural looking miter join.
** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.
* '''Color Markers to Match Stroke''' extension improvements. The markers can now inherit the fill and stroke colors and alpha channels from the object, or be customized with color selectors in a separate tab.
* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.4|0.48.4]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])
* The reworked '''Import Clip Art''' feature is not available with current OS X packages. ([https://bugs.launchpad.net/inkscape/+bug/943148 bug #943148])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Release notes/0.91

2015-01-25T06:21:21Z

~suv: /* Known issues */

{{Other languages|en=Release_notes/0.91}}

==Inkscape 0.91==

'''(not released yet - [[AnnouncePlanning091]])'''

==Release highlights==

Released on '''«YYYY-MM-DD»'''.

* Cairo rendering for display and PNG export
* OpenMP multithreading for all filters
* C++ code conversion
* Major improvements in the Text tool
* Measure tool
* Type design features [http://libregraphicsworld.org/blog/entry/inkscape-explores-type-design-gets-measure-tool],[http://understandingfonts.com/blog/2011/11/typography-extensions-in-inkscape-0-49/]
* Symbol library and support for Visio stencils
* Cross platform WMF and EMF import and export
* Improved support for Corel DRAW documents, Visio importer
* Support for real world document and page size units, e.g. millimeters
* Numerous usability improvements
* Native Windows 64-bit build
* See [[Release_notes/0.91#Notable_bug_fixes|Notable bug fixes]]

==Rendering and performance==

Inkscape 0.91 includes a new renderer based on the Cairo library. This work was done mainly during Google Summer of Code 2010 and 2011 projects.

* '''Improved performance.''' The new renderer is significantly faster on most drawings. Renderings of the most complex objects are automatically cached to improve responsiveness during editing.
* '''OpenMP multithreading for filters.''' Filters use all available processor cores for computation. This results in substantial speedups when editing drawings containing large filtered objects on multi-core systems.
* '''Substantial memory savings.''' Inkscape now uses less memory when opening complex drawings, in some cases using only 25% of the memory used by Inkscape 0.48. Larger files can now be opened.
* '''Responsiveness improvements.''' The rendering of the SVG drawing is now cached. This results in massive improvements in responsiveness of path highlights, object selection / deselection, and path editing in delayed update mode.
* '''Rendering bug fixes.''' Most of the rendering glitches in our bug tracker are no longer present in Inkscape 0.91. The following things now render correctly:
** Pattern fills (no more gaps between tiles, regardless of transformation)
** Stroke of transformed objects in patterns
** Patterns containing clipped objects
** Nested clipping paths
** Masked and clipped objects with large masks / clipping paths in Outline view
** Paths with wide strokes and long miters
** Fonts

===Color display mode===

A '''grayscale''' display color mode has been added, that shows a preview of your drawing in grayscale. <kbd>Shift+numpad5</kbd> toggles the color display mode between normal and grayscale.

==Tools==

=== Node tool ===
The tool control bar for the Node Tool features a new dropdown to insert new nodes on the selected segments extreme values. For example, (as demonstrated in the image below) it is possible to add a new node at the highest point in a curve using '''Insert Node at Max Y'''

[[File:Add nodes at max.gif]]

=== Measurement tool ===
The Measurement tool is a new feature for the artist to measure the elements in their drawing. To use the measurement tool, simply choose the tool, click anywhere on the drawing and drag the ruler out. The measurement tool will live-update with measurements of length and angles as you pass over objects in your drawing.

[[File:Ruler.png]]

=== Text tool ===
* Text size default unit is now points (<code>pt</code>) and is customizable (<code>px</code>,<code>pt</code>,<code>pc</code>,<code>mm</code>,<code>cm</code>,<code>in</code>,<code>em</code>)
* Text toolbar shows full list of font style variants for that font
* Files with text in <code>em</code> units read correctly
* Font substitution warning dialog

=== Gradients ===
* Gradient toolbar enhanced to select and modify gradient stops, invert, repeat, and link gradients
* On-canvas gradient editing fixes: double clicking to create stops, correct focus on select
* Gradients sortable by color, name and usage in Fill/Stroke
* Gradients can be renamed in Fill/Stroke

== Dialogs, etc. ==

=== Arrange (was rows and columns) ===
- '''NEW:''' renamed to 'Arrange'
- '''NEW:''' polar arrangement (separate tab)
<http://issuu.com/ddeclara/docs/inkscape_radial_arrangement>

=== Align and Distribute ===
* The new updated Inkscape features a new set of buttons in the '''Align and Distribute Dialog''' called '''Exchange position of selected objects'''. It adds the ability to exchange the positions of the objects that the artist has selected.
** In the following example, three objects were selected, and their positions were exchaged with each other (using this new feature) according to their selection order.
[[File:Swap-objects.gif]]
** There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (<code>z-index</code>) order, or just exchange them clockwise based on the object's position on the page.

* Keyboard shortcuts (<kbd>Ctrl+Alt+Keypad numbers</kbd>) for align operations

=== Document Properties ===
Optionally disable antialiasing (bug #170356, interface partially implemented)

=== Find/Select ===
* It is now easier to select items which are not at the top of the Z-order: use <kbd>Alt+mouse wheel scroll</kbd> to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use <kbd>Shift+Alt+mouse wheel</kbd> scroll to add to the existing selection). At present, groups are not honoured, i.e., only individual items within groups are considered.
* New '''Find/Replace''' dialog can operate on text or any attribute
* "Select Same" is a new feature that allows an artist to select objects that have the same properties as the currently selected object. For example, you could select an object that has a fill of blue. Then, using the new feature select all other objects in the drawing with a fill set to that same shade of blue.

[[File:Selectsame.gif]]

The new feature is a menu choice under '''Edit ▶︎ Select Same''' or as a Context menu if you right click on a selected object. Also there are other choices available to select same, including: matching both Fill and Stroke, matching just stroke, matching stroke style, or matching on object type.

=== Fill and Stroke ===
* The Gradient view in the fill and stroke dialog now displays a list of all the gradients in the document. The list displays the gradient, the gradient name, and number of uses of that gradient in the document.
[[File:Gradient-fill-stroke.png‎]]

* More compact Markers selectors

=== Layers ===
* Drag and drop to reorder layers and create sublayers
* '''Show/Hide All layers''' options in context menu

=== Symbols ===

Inkscape has a new Symbols dialog. The dialog displays symbols from a symbol library. Inkscape 0.91 includes five example libraries: logic symbols, AIGA/DOT transportation symbols, map symbols, flow chart shapes and word balloons. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <code><symbol></code> element.) Symbols can be dragged from the dialog onto the Inkscape canvas.


Any document with symbols can serve as a source for a symbol library. Simply copy it to the <code class="file">symbols</code> directory in your configuration directory (typically <code class="file">share/inkscape</code>). If proper care is taken, symbols can be provided with default fill and stroke colors that later can be overridden by the user.

Visio Stencil files (<code class="file">.vss</code>) can also be used by dropping them in the same <code class="file">symbols</code> directory. Results may not be as satisfactory as using SVG symbol libraries.

See the [http://wiki.inkscape.org/wiki/index.php/SymbolsDialog Symbols Dialog] Wiki page for more details.

=== Text and Font ===
* '''NEW:''' lists fonts used in the current document at the top
* '''NEW:''' select all text objects with same font as current selection
* '''NEW (to be verified):''' support list with fallback fonts (CSS2)

=== Transform ===
* Rotation of objects clockwise or counterclockwise

=== Markers ===
* Markers now take objects color

=== Trace Bitmap ===
* Trace bitmap preview updates live and is resizeable

===Live Path Effects===

An object's '''Live Path Effects''' are now forked upon object duplication.

====PowerStroke====

Here a list of the current state. Note that this is very much work in progress and '''anything can change'''. I think this is the most efficient place of keeping track how the powerstroke LPE works.

* Stroke knots are purple diamonds
* When first applied, 3 stroke knots are added: start, end, and somewhere in the middle along the path
* '''Add nodes:''' <kbd>Ctrl+click</kbd> purple knot
* '''Delete nodes:''' <kbd>Ctrl+Alt+click</kbd> purple knot
* "sort points" reorders the stroke knots according to where they lie along the path (where they are closest to the path), instead of keeping them in original order.
* Start and end caps can be specified. The SVG cap types are available, as well as an extra type, "Zero width", that is identical to adding a width control knot at the start/end of the path with zero width.
* Join type can be specified. In addition to the SVG join types, there are two new types:
** '''Extrapolated''': this extrapolates the contour of the stroked path to obtain a more natural looking miter join.
** '''Extrapolated arc''': [http://tavmjong.free.fr/SVG/LINEJOIN/index.html Mathematical explanation].
** '''Spiro''': rounds the join using a spiro curve (the '''rounded''' type rounds the curve using an elliptical arc).

[http://imgh.us/powerstroke-ell.png example screenshot]

====Clone Original====
The Clone original LPE ignores the path data of the path it has been applied to; instead, it '''copies the original-d path data''', i.e. the path data before LPE calculation, from the path linked to by the Linked path parameter.

The Clone original LPE is made to be used in conjunction with powerstroke. Powerstroke creates a path with a variable stroke, but this path can then not be filled (because the fill is used as the stroke). To fill a powerstroked path, one must create a second path (dummy path), apply the Clone original LPE and link it to the powerstroked path. Because this second path clones the original path data before the Powerstroke LPE, it can be used to fill the powerstroked path.

To quickly create a dummy path and apply this effect, one can select the path to 'clone' and click the menu item '''Edit ▶︎ Clone ▶︎ Clone original path (LPE)'''.

Like for normal clones, pressing <kbd>Shift+D</kbd>, when the selected path has the Clone original LPE applied, selects the path referred to by the LPE.

Another very useful ability of the Clone original LPE is to create a clone with a different style than its referred path. To facilitate this, the LPE dialog will add the Clone original LPE when a clone is selected and the "+" button is pressed.

===Filters===
The new Custom predefined filters allow users to create predefined filters with custom parameters. See [[SpecCustomPredefinedFilters]].

=== Trace Pixel Art (<code>libdepixelize</code>) ===
A [https://launchpad.net/libdepixelize new library] developed for Inkscape to automatically vectorize raster images specialized in Pixel Art was integrated in the form of the "Trace Pixel Art" dialog (menu item '''Path ▶︎ Trace Pixel Art...'''). Good and old general "Trace Bitmap" is still there. Check the [http://research.microsoft.com/en-us/um/people/kopf/pixelart/supplementary/index.html supplementary material] of the algorithm authors to see a preview of how the algorithm behaves.

==Other User Interface==

=== General ===
* Canvas background color can be set without exporting it (background transparency is only used for export but not the canvas).
* Panning the canvas with the <kbd>Space bar</kbd> is now always turned on and doesn't require an additional mouse button press to grab the canvas: just press the <kbd>Space bar</kbd> and move the mouse pointer to pan the canvas.

=== Guides ===
* Guides visibility can be toggled by clicking the ruler
* Guides can now have labels, and the colour of individual guides can also be set by the user. To label or colour a guide, double click on the guideline to bring up the guide properties dialog.
[[File:Labelled-guides.png]]

=== Menu/Access ===

* The interface elements are accessible through the keyboard with <kbd>ALT+key</kbd> in many more dialogs
* "Text and Font", "Fill and Stroke", and "Check Spelling" dialogs are added to the text object context menu (right click)
* Menu items renamed:
** '''Edit ▶︎ Preferences'''
** '''Edit ▶︎ Input Devices'''
** '''File ▶︎ Cleanup Document'''
* Checkboxes to indicated status of View ▶︎ Grid/Guides/Snap/Color Management
* Group/Ungroup from the context menu

=== Preferences ===
* New keyboard shortcut editor
* '''Prefs ▶︎ Interface''' -- New option for dockbar and switcher style (icons, text, icons & text) (bug #1098416)
* '''Prefs ▶︎ Interface ▶︎ Windows''' -- optionally don't save & restore documents viewport (bug #928205)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- unit selector for steps (move, scale, inset/outset) (bug #170293)
* '''Prefs ▶︎ Behavior ▶︎ Steps''' -- option for relative snapping of guideline angles (rev 10307)
* '''Prefs ▶︎ Behavior ▶︎ Clones''' -- optionally relink linked offsets on duplication (bug #686193)
* '''Prefs ▶︎ Input/Output ▶︎ SVG output''' -- NEW: optionally enforce relative or absolute coordinates (bug #1002230)

=== Dialogs ===
* Dialog status and position is remembered between sessions
* Most dialogs now dockable (including "Object properties", "Object attributes", "Text and Font", "Check spelling", "Export PNG image", "XML editor", "Find/Replace", and "Tiled clones")
* New preference to allow Windows users to choose between native and Gtk Open/Save dialog
* Preferences dialog cleanup
* Document Metadata dialog merged into Document Properties

===Simple calculations in spinboxes===
In most spinboxes (a spinbox is an entry field with up and down "spinbuttons" next to it) you can now write simple calculations. Some examples:

* <samp>2 * 3</samp>
* <samp>50 + 100</samp>, or
* <samp>((12 + 34) * (5 + 5) - 2) / 2</samp>

Moreover, you can use units in entering values, like <samp>2 + 2 cm</samp>. The result will be converted to the selected unit for the particular entry.

===Configurable Control Handles===

New preferences have been added to allow for the size of the on-canvas controls to be increased or decreased. The "Input Devices" section has been updated to control this.

==Translations==
* The ''Keyboard and mouse reference'' (inkscape-docs project) and the labels of color palettes are now translatable.
* New UI translation in Latvian.
* New tutorial translations in Galician and Greek.
* New ''Keyboard and mouse reference'' translation in Belarusian.
* New man pages in Chinese (zh_TW) Greek (el), Japanese (ja) and Slovak (sk), and updated French translation. ''[Galician (gl) and Polish (pl) in progress]''
* Man pages now use PO files for translation (inkscape-docs project).
* The tutorial generation system now fully supports RTL languages.

==File format support==
* New Flash XML Graphics (FXG) export format.
* New Synfig Animation Studio (SIF) export format.
* New HTML5 Canvas export format
* New Visio (VSD) import format, based on [http://www.freedesktop.org/wiki/Software/libvisio libvisio].
* New internal CorelDraw (CDR) import format, based on [http://www.freedesktop.org/wiki/Software/libcdr libcdr].
* XAML export improvements (including a new Silverlight compatible mode).
* Compressed SVG and media export extension improvements. New options:
** set an image directory in the zip file
** add a text file that lists the fonts used in the SVG document.
* New preference to allow users to always link, embed or ask when importing bitmaps.
* New preferences that allow the checking of SVG on input and/or export for invalid or not useful elements, attributes, and properties. Options control whether such items generate warnings (when Inkscape is run from the command line) or in removing such items.
* The <code>--export-text-to-path</code> option now works with Plain SVG export.

===EMF/WMF===
EMF and WMF input and output filters have been completely rewritten and are now cross-platform. It is now possible to copy and paste EMF files between Windows applications running in Wine and a native Linux version of Inkscape.

===Gimp XCF===
* The '''Save Background''' option allows users to choose if the page background is saved with each GIMP layer.
* The exported layers now use the <code>label</code> attribute or, if not set, the <code>id</code> attribute
* New '''Resolution''' option
* New '''Help''' tab
* Some bugs and warnings fixed

===PDF===
* '''Bleed/margin:''' Added an option to specify an extra margin by which the bounding box to be exported is expanded. This may be helpful to export a PDF with a small white margin around the drawing, or for exporting a bleed region a few mm outside the area of the page.

===PDF/EPS/PS + LaTeX===
* Added the possibility of scaling the image. The <code>calc</code> package must be included in the preamble. Then the image can be scaled by defining <code>\svgscale</code> instead of <code>\svgwidth</code>.
* The font shape is now also exported. <code>\textit{}</code> for italic text, <code>\textbf{}</code> for bold text, and <code>\textsl{}</code> (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape, not '''italic'''. Thus, the result in LaTeX will be '''slanted''', instead of '''italic'''. It is better to '''use another font''' in Inkscape when you want true italics.

==Extensions==
===Units: Breaking change===
Due to the implementation of proper document units, the functions <code>inkex.unittouu</code> and
<code>inkex.uutounit</code> had to be modified and moved to the <code>inkex.Effect</code> class.

Unit conversion calls should be replaced with <code>inkex.Effect.unittouu</code> and <code>inkex.Effect.uutounit</code> calls (usually <code>self.unittouu</code> and <code>self.uutounit</code>).

See also: [[Notes On Units Handling in Extensions in 0.91]]

===New===
* The new '''guillotine extension''' is used for exporting PNG slices from a drawing. The slice rectangles are defined by adding horizontal and vertical guides within the canvas boundary, the canvas boundary serves as the outside of the sliced area.
* The new [http://en.wikipedia.org/wiki/G-code '''G-code'''] tools extension converts paths to G-code (using circular interpolation), makes offset paths and engraves sharp corners using cone cutters.
* New [http://en.wikipedia.org/wiki/QR_code QR code] generator.
* New '''isometric grid generator'''.
* New '''bitmap crop''' extension.
* New '''Extract text''' extension. Outputs a document’s text elements in a chosen order.
* New '''Merge text''' extension.
* New '''HSL adjust''' extension.
* New '''Replace font''' extension.
* New '''N-Up layout''' extension.
* New '''Voronoï diagram''' extension (creates Voronoï diagrams and Delaunay triangulations based on the selected objects' barycenter).
* New '''Interpolate Attribute''' in a group extension.
* New '''Typography extensions''' menu.
* New '''[http://www.evilmadscientist.com/2011/hershey-text-an-inkscape-extension-for-engraving-fonts/ Hershey Text]''' extension.

===Improvements===
* '''Number nodes.''' New parameters allowing users to choose the starting dot number and the numbering step between two nodes.
* '''Color Markers to Match Stroke''' extension improvements. The markers can now inherit the fill and stroke colors and alpha channels from the object, or be customized with color selectors in a separate tab.
* Optional sliders added on <code>float</code> and <code>int</code> extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with <code>msgctxt</code>).
* New sub-menus in the '''Render''' menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

Rendering of the following properties is now supported (without UI except via XML editor):

* <code>clip-rule</code>
* <code>color-interpolation-filters</code>: Non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.
* <code>text-decoration</code>: Underline, strike-through, over line.
* <code>text-decoration-line</code>, <code>text-decoration-style</code>: Preliminary support (CSS 3).
* <code>paint-order</code>: Allows stroke to be painted under fill; useful for text.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked (in the underlying code and in the GUI) to should make the snapping preferences easier to understand, maintain, and find and fix any remaining snapping bugs
* Inkscape now also snaps perpendicularly and tangentialy to paths, when creating paths in the pen tool, when dragging nodes, or when manipulating guides. Newly created guides (dragged off the ruler) will snap perpendicularly or tangentialy to any curve that is being snapped to. Two checkboxes have been added to the document properties dialog (on the snapping tab). Please note that snapping perpendicularly or tangetialy will not work in the selector tool when transforming an object or a selection of objects.
* Intersections of paths and guides can now be snapped to too
* Snapping has been implemented fully for transforming selections of multiple nodes in the node tool
* Snapping to text anchors and baselines has been implemented properly
* If one has chosen for only snapping the snap source closest to the mouse pointer, then the tab key can be used to cycle to the next closest snap source

==Notable bug fixes==
Notable bug fixes since last bug fix release ([[Release notes/0.48.4|0.48.4]]):
* Images are no longer recompressed when embedding or exporting them. [https://bugs.launchpad.net/inkscape/+bug/871563]
* Relative image paths are no longer stored as absolute (regression introduced with [[Release notes/0.47|0.47]]).
* Many rendering glitches were fixed.
* The rendering of the stroke on transformed objects now matches the SVG specification.
* Values entered in the numeric input boxes for the selector tool (<code>X</code>, <code>Y</code>, <code>width</code>, <code>height</code>) are much more accurately applied.
* Inkscape launches faster due to new icon cache (on disk) and improved font loading. (Bug #[https://bugs.launchpad.net/inkscape/+bug/488247 488247])

==Known issues==
* '''On MS Windows when the desktop colordepth is set to 16-bit, Inkscape is unusable because of exploding memory usage.''' Please set the '''colordepth''' to 32-bit.
* The Cairo library used in the new renderer does not implement downscaling, which causes large bitmaps to be pixelated on export. [https://bugs.launchpad.net/inkscape/+bug/804162] The issue can be fixed by upgrading to Cairo 1.14.0. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]
* On OS X 10.9 or later, embedding bitmap images on import or paste from clipboard may crash Inkscape. ([https://bugs.launchpad.net/inkscape/+bug/1398521 bug #1398521], [https://bugs.launchpad.net/inkscape/+bug/1410793 #1410793])

==Previous releases==
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

[[Category:Marketing]]

Extension subsystem

2014-12-15T02:12:25Z

~suv: /* See Also */

[[Category:Extensions]]
== General ==
The Extension system is a way to add functionality to Inkscape. The
design of the extension system is similar to the [http://en.wikipedia.org/wiki/Bridge_pattern bridge design pattern],
breaking apart the functionality that is being provided, and the
implementation of that functionality. The term ''extension'' is used to
describe all of this, the functionality and the implementation.

== Functionality Provided ==
There are several types of functionality provided by the extensions
system today, and more are slated for the future.
* '''Input.''' Input extensions take data from a file and bring it into Inkscape. Even reading SVG files (Inkscape's native format) is implemented as an internal extension. Input extensions can be chained so that extensions can be created that don't make it all the way to SVG directly. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Input.php code reference])
* '''Output.''' Output extensions take the data from Inkscape and turn it into a file. SVG Output is an internal extension. Output extensions can also be chained. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Output.php code reference])
* '''Effect.''' Effects are extension that take a document, and possibly a selection, and change it in some way. This could be anything from changing colors to generating fractals. These are similar to Filters in The GIMP. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Effect.php code reference])
* '''Print.''' Print are extensions that require a little more work from Inkscape itself. They provide a set of functions that allow Inkscape to 'render' the document onto the extension. These are the most complex to implement, but can provide the most functionality to a potential developer of extensions. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Print.php code reference])
* '''Path Effects.''' Path effects provide a way to change a path. They allow a user to edit a path using the standard Inkscape path editing tools, but then have it look differently than just a line. This could include everything from adding hash marks to making the line look like it's on fire. (not in Doxygen yet)
* '''Tools.''' Tools are the ways that you draw in Inkscape. Rectangle tool, circle tool, star tool... the goal is to eventually have the ability to add tools as extensions. (no code)

== Implementation Types ==
While the functionality that the extension provides is described above, how that gets done is a different story. The Inkscape extensions system allows for programmers to implement their extension in a variety of ways, trying to match their particular skillset.
* '''Internal.''' Any extension type can be implement in C or C++ and directly linked into the Inkscape codebase. While in general the goal is to move as much out of the main Inkscape binary, this makes sense for many extensions including things like SVG input/output.
* '''Scripts.''' Scripts are where Inkscape uses standard in and standard out on an external executable to implement the functionality. This allow Inkscape to reuse a variety of utilities that already do format conversion or implement cool things in SVG. Typically the scripts that are effects use a SVG DOM library in their programming language of choice.
* '''XSLT.''' This implementation is done in the XSLT language, and uses libxml's XSLT parser that is already linked with Inkscape.
* '''DOM Scripts.''' As Inkscape finishes its DOM implementation the goal will be to provide this directly to scripts. This will allow for faster execution, but also other access to Inkscape's internals and algorithms.

== Maturity ==
The extension system is currently able to provide functionality from the '''Input''', '''Output''', and '''Effects''' categories. A plan has been scoped for the implementation of '''Path Effects''' but work has not yet begun. I am not aware of the status of the '''Tools''' functionality described above.

'''Internal''' and '''Script''' implementations are available to the developer. Bob Jamison (aka ishmal) has done a large amount of work toward '''DOM Scripts''' but there are not yet any working examples. I am not aware of the status of the '''XSLT''' implementation. '''Note:''' XSLT at this time appears to support input and output filtering, but not effects filters (i.e. there is no implementation of Inkscape::Extension::Implementation::XSLT::effect(), only ::open() and ::save() )

== See Also ==
* [[ScriptingHOWTO]]: an explanation of the details for creating an extension with the Script implementation.
* [[MakingAnINX]]: every Extension needs an INX file.
* [http://article.gmane.org/gmane.comp.graphics.inkscape.devel/16210 A message from Ted Gould] describing the functionality and implementation types.
* [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/doc/extension_system.txt The original extension architecture document from inkscape svn.] It would be good to look through this document and move pertinent facts onto this page.

Extension subsystem

2014-12-15T01:19:39Z

~suv: /* See Also */ update link to current trunk repo

[[Category:Extensions]]
== General ==
The Extension system is a way to add functionality to Inkscape. The
design of the extension system is similar to the [http://en.wikipedia.org/wiki/Bridge_pattern bridge design pattern],
breaking apart the functionality that is being provided, and the
implementation of that functionality. The term ''extension'' is used to
describe all of this, the functionality and the implementation.

== Functionality Provided ==
There are several types of functionality provided by the extensions
system today, and more are slated for the future.
* '''Input.''' Input extensions take data from a file and bring it into Inkscape. Even reading SVG files (Inkscape's native format) is implemented as an internal extension. Input extensions can be chained so that extensions can be created that don't make it all the way to SVG directly. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Input.php code reference])
* '''Output.''' Output extensions take the data from Inkscape and turn it into a file. SVG Output is an internal extension. Output extensions can also be chained. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Output.php code reference])
* '''Effect.''' Effects are extension that take a document, and possibly a selection, and change it in some way. This could be anything from changing colors to generating fractals. These are similar to Filters in The GIMP. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Effect.php code reference])
* '''Print.''' Print are extensions that require a little more work from Inkscape itself. They provide a set of functions that allow Inkscape to 'render' the document onto the extension. These are the most complex to implement, but can provide the most functionality to a potential developer of extensions. ([http://inkscape.modevia.com/doxygen/html/classInkscape_1_1Extension_1_1Print.php code reference])
* '''Path Effects.''' Path effects provide a way to change a path. They allow a user to edit a path using the standard Inkscape path editing tools, but then have it look differently than just a line. This could include everything from adding hash marks to making the line look like it's on fire. (not in Doxygen yet)
* '''Tools.''' Tools are the ways that you draw in Inkscape. Rectangle tool, circle tool, star tool... the goal is to eventually have the ability to add tools as extensions. (no code)

== Implementation Types ==
While the functionality that the extension provides is described above, how that gets done is a different story. The Inkscape extensions system allows for programmers to implement their extension in a variety of ways, trying to match their particular skillset.
* '''Internal.''' Any extension type can be implement in C or C++ and directly linked into the Inkscape codebase. While in general the goal is to move as much out of the main Inkscape binary, this makes sense for many extensions including things like SVG input/output.
* '''Scripts.''' Scripts are where Inkscape uses standard in and standard out on an external executable to implement the functionality. This allow Inkscape to reuse a variety of utilities that already do format conversion or implement cool things in SVG. Typically the scripts that are effects use a SVG DOM library in their programming language of choice.
* '''XSLT.''' This implementation is done in the XSLT language, and uses libxml's XSLT parser that is already linked with Inkscape.
* '''DOM Scripts.''' As Inkscape finishes its DOM implementation the goal will be to provide this directly to scripts. This will allow for faster execution, but also other access to Inkscape's internals and algorithms.

== Maturity ==
The extension system is currently able to provide functionality from the '''Input''', '''Output''', and '''Effects''' categories. A plan has been scoped for the implementation of '''Path Effects''' but work has not yet begun. I am not aware of the status of the '''Tools''' functionality described above.

'''Internal''' and '''Script''' implementations are available to the developer. Bob Jamison (aka ishmal) has done a large amount of work toward '''DOM Scripts''' but there are not yet any working examples. I am not aware of the status of the '''XSLT''' implementation. '''Note:''' XSLT at this time appears to support input and output filtering, but not effects filters (i.e. there is no implementation of Inkscape::Extension::Implementation::XSLT::effect(), only ::open() and ::save() )

== See Also ==
* [[ScriptingHOWTO]]: an explaination of the details for creating an extension with the Script implementation.
* [[MakingAnINX]]: every Extension needs an INX file.
* [http://sourceforge.net/mailarchive/message.php?msg_id=15742559|A message from Ted Gould] describing the functionality and implementation types.
* [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/doc/extension_system.txt The original extension architecture document from inkscape svn.] It would be good to look through this document and move pertinent facts onto this page.

Extension requirements

2014-12-15T01:14:38Z

~suv: /* Binary packages */ outdated, package at modevia no longer available.

{{Other languages|en=Effect requirements}}

For info about what effects can do, screenshots, and how to make your own go to [http://www.ekips.org/comp/inkscape/ Aarons Site]
If you are interested in opening special file formats through extensions, see [[GettingExtensionsWorking]].

== Python Effects ==
=== on Debian GNU / Linux ===
apt-get install python python-lxml

=== on Microsoft Windows ===
From version .44 onwards, Inkscape now includes Python in the download, and has effects enabled by default.
The latest stable Inkscape version includes Python 2.6.5.

=== on Mac OS X ===

Starting with version 0.46, Inkscape contains the python packages needed for the extension system. All python extensions should work out of the box. However in case you still have trouble you can install them in their regular location.

==== Compiling from source ====
If you prefer, you can install them from source, it is really easy.

# download the source code for [http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103 sourceforge numpy repository] and/or [http://codespeak.net/lxml/index.html#download lxml download section]
# unpack the <code>.tar.gz</code> file <pre>tar -xzf numpy***.tar.gz lxml***.tar.gz</pre>
# for each one <code>cd</code> into the newly created directory
# build C extensions and install (the install is system wide so you need administrator privileges)<pre>sudo python setup.py install</pre>and type your password.

The packages are installed in the site-packages directory of your Python install. This is /Library/Python/2.*/site-packages for the stock install of Python on Mac OS X.

== Perl Effects ==
=== on Debian GNU / Linux ===
apt-get install perl libxml-xql-perl

=== on Gentoo GNU / Linux ===
emerge -a XML-XQL

=== on Microsoft Windows ===
install [http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl [[ActivePerl]]]
install XML::XQL::DOM (perhaps like this?)
1: install prereqs with ppm:
install xml-dom
install parse-yapp
install datemanip
2: download xml-xql from:
http://www.cpan.org/authors/id/T/TJ/TJMATHER/XML-XQL-0.68.tar.gz
3: open command prompt and locate perl"s lib directory with:
perl -e "print qq(@INC)" (mine was C:/Perl/site/lib)
4: unpack xml-xql archive
5: copy contents of XML-XQL-*\lib\XML into C:\Perl\site\lib\XML
6: copy XML-XQL-*\XQLParser\Parser.pm to C:\Perl\site\lib\XML\XQL

== Plugin Effects ==
I have absolutely no idea. Please record your success here. :)

== What if it doesn't work? ==
Run Inkscape from the console

Use the error messges printed to the console to diagnose the problem (very often missing dependencies)

On Windows you will have to redirect output to a text file like this: "inkscape > output.txt"

[[Category:Extensions]]