Inkscape Wiki - User contributions [en]

Release notes/1.4

2024-04-05T15:55:39Z

Zearin: Minor formatting tweaks

Release notes/1.3

2023-04-01T17:37:24Z

Zearin: Minor copy-edits for clarity

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit ➞ Preferences ➞ Rendering ➞ Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** '''Note:''' Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit ➞ Preferences ➞ Interface ➞ Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit ➞ Preferences ➞ Interface ➞ Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for <code>ctrl+alt+t</code> to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit ➞ Preferences ➞ Interface ➞ Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* '''Page:''' the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* '''Selection:''' a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit ➞ Preferences ➞ Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code><kbd>F</kbd></code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (<kbd>CTRL+B</kbd>).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

<code>Preferences ➞ Rendering ➞ Enable OpenGL</code>

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold Shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <kbd>Ctrl</kbd> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New on-canvas blur controls will appear for blur effects from the Fill and Stroke panel, or filters with blur effects from Add Filter. Controls are not linked by default, so you can control horizontal and vertical blurring separately. If you hold '''<kbd>CTRL</kbd>''', you can control both Axes linked. You can control arbitrary angle of blurring if you rotate your object after you set blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new HTML/CSS style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with <kbd>ctrl</kbd>/<kbd>shift</kbd>)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: '''<code><kbd>X</kbd></code>'''.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''<kbd>Shift</kbd> + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path ➞ Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path ➞ Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit ➞ Preferences ➞ Behavior ➞ Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps, and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to <code>fe-image</code> and <code>fe-tile</code> (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need UX work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* <kbd>Space bar</kbd> confirms (select, apply, open)
* <kbd>Shift+→</kbd> and <kbd>Shift+←</kbd> to open/close group
* <kbd>Shift+↑</kbd> and <kbd>Shift+↓</kbd> to move in Z order <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental, and Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences ➞ Behavior ➞ LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences ➞ Behavior ➞ LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc…) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add Visio modern formats <code>vssx</code> and <code>vsdx</code>. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16×16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, <code>d <var>«path data»</var></code>. You can change highlighting themes in <code>Preferences ➞ Interface ➞ Theming</code>.

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of SVGs.

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvas controls that should improve usability. You can add this Live Path Effect from Node tool toolbar: [[File:Asdasdasdasdasd 123.png]]. You can also assign a shortcut to this effect. (No shortcut is set by default.)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added <code>user.css</code> to UI folder to allow tweaking UI without interfering with or fully overriding other CSS files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detects dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter <code>--actions-file</code>. You specify a list like in <code>--actions</code> but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter <code>--active-window</code> / <code>-q</code> that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <code><use></code>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T17:33:16Z

Zearin: Fix typo; minor copy-edits

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit ➞ Preferences ➞ Rendering ➞ Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** '''Note:''' Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit ➞ Preferences ➞ Interface ➞ Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit ➞ Preferences ➞ Interface ➞ Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for <code>ctrl+alt+t</code> to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit ➞ Preferences ➞ Interface ➞ Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* '''Page:''' the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* '''Selection:''' a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit ➞ Preferences ➞ Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code><kbd>F</kbd></code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (<kbd>CTRL+B</kbd>).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

<code>Preferences ➞ Rendering ➞ Enable OpenGL</code>

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold Shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <kbd>Ctrl</kbd> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default, so you can control horizontal and vertical blurring separately. If you hold '''<kbd>CTRL</kbd>''' you can control both Axes linked. You can control arbitrary angle of blurring if you rotate your object after you set blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new HTML/CSS style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with <kbd>ctrl</kbd>/<kbd>shift</kbd>)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: '''<code><kbd>X</kbd></code>'''.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''<kbd>Shift</kbd> + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path ➞ Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path ➞ Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit ➞ Preferences ➞ Behavior ➞ Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps, and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to <code>fe-image</code> and <code>fe-tile</code> (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need UX work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* <kbd>Space bar</kbd> confirms (select, apply, open)
* <kbd>Shift+→</kbd> and <kbd>Shift+←</kbd> to open/close group
* <kbd>Shift+↑</kbd> and <kbd>Shift+↓</kbd> to move in Z order <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental, and Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences ➞ Behavior ➞ LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences ➞ Behavior ➞ LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc…) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add Visio modern formats <code>vssx</code> and <code>vsdx</code>. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16×16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, <code>d <var>«path data»</var></code>. You can change highlighting themes in <code>Preferences ➞ Interface ➞ Theming</code>.

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of SVGs.

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvas controls that should improve usability. You can add this Live Path Effect from Node tool toolbar: [[File:Asdasdasdasdasd 123.png]]. You can also assign a shortcut to this effect. (No shortcut is set by default.)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added <code>user.css</code> to UI folder to allow tweaking UI without interfering with or fully overriding other CSS files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detects dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter <code>--actions-file</code>. You specify a list like in <code>--actions</code> but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter <code>--active-window</code> / <code>-q</code> that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <code><use></code>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T17:30:12Z

Zearin: Use consistent separator in Menu paths

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit ➞ Preferences ➞ Rendering ➞ Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** '''Note:''' Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit ➞ Preferences ➞ Interface ➞ Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit ➞ Preferences ➞ Interface ➞ Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for <code>ctrl+alt+t</code> to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit ➞ Preferences ➞ Interface ➞ Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* '''Page:''' the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* '''Selection:''' a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit ➞ Preferences ➞ Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code><kbd>F</kbd></code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (<kbd>CTRL+B</kbd>).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

<code>Preferences ➞ Rendering ➞ Enable OpenGL</code>

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold Shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <kbd>Ctrl</kbd> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default, so you can control horizontal and vertical blurring separately. If you hold '''<kbd>CTRL</kbd>''' you can control both Axes linked. You can control arbitrary angle of blurring if you rotate your object after you set blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new HTML/CSS style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with <kbd>ctrl</kbd>/<kbd>shift</kbd>)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: '''<code><kbd>X</kbd></code>'''.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''<kbd>Shift</kbd> + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path ➞ Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path ➞ Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit ➞ Preferences ➞ Behavior ➞ Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps, and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to <code>fe-image</code> and <code>fe-tile</code> (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need UX work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* <kbd>Space bar</kbd> confirms (select, apply, open)
* <kbd>Shift+→</kbd> and <kbd>Shift+←</kbd> to open/close group
* <kbd>Shift+↑</kbd> and <kbd>Shift+↓</kbd> to move in Z order <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental, and Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences ➞ Behavior ➞ LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences ➞ Behavior ➞ LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc…) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add Visio modern formats <code>vssx</code> and <code>vsdx</code>. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16×16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, <code>d <var>«path data»</var></code>. You can change highlighting themes in <code>Preferences ➞ Interface ➞ Theming</code>.

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of SVGs.

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvvas controls that should improve usability. You can add this Live path effect from node tool toolbar .[[File:Asdasdasdasdasd 123.png]]. You can also assign a shortcut to this effect (no shortcut is set by default)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added <code>user.css</code> to UI folder to allow tweaking UI without interfering with or fully overriding other CSS files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detects dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter <code>--actions-file</code>. You specify a list like in <code>--actions</code> but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter <code>--active-window</code> / <code>-q</code> that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <code><use></code>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T16:24:43Z

Zearin: Markup keyboard shortcuts

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit > Preferences > Rendering > Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** '''Note:''' Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit → Preferences → Interface → Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit > Preferences > Interface > Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for <code>ctrl+alt+t</code> to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit → Preferences → Interface → Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* '''Page:''' the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* '''Selection:''' a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit > Preferences > Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code>F</code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (<kbd>CTRL+B</kbd>).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

<code>Preferences -> Rendering -> Enable OpenGL</code>

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold Shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <kbd>Ctrl</kbd> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default, so you can control horizontal and vertical blurring separately. If you hold '''<kbd>CTRL</kbd>''' you can control both Axes linked. You can control arbitrary angle of blurring if you rotate your object after you set blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new HTML/CSS style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with <kbd>ctrl</kbd>/<kbd>shift</kbd>)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: '''<code><kbd>X</kbd></code>'''.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''<kbd>Shift</kbd> + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path → Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path → Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit → Preferences → Behavior → Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps, and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to <code>fe-image</code> and <code>fe-tile</code> (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need UX work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* <kbd>Space bar</kbd> confirms (select, apply, open)
* <kbd>Shift+→</kbd> and <kbd>Shift+←</kbd> to open/close group
* <kbd>Shift+↑</kbd> and <kbd>Shift+↓</kbd> to move in Z order <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental, and Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences > Behavior > LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences > Behavior > LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc…) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add Visio modern formats <code>vssx</code> and <code>vsdx</code>. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16×16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, <code>d <var>«path data»</var></code>. You can change highlighting themes in <code>Preferences > Interface > Theming</code>.

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of SVGs.

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvvas controls that should improve usability. You can add this Live path effect from node tool toolbar .[[File:Asdasdasdasdasd 123.png]]. You can also assign a shortcut to this effect (no shortcut is set by default)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added <code>user.css</code> to UI folder to allow tweaking UI without interfering with or fully overriding other CSS files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detects dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter <code>--actions-file</code>. You specify a list like in <code>--actions</code> but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter <code>--active-window</code> / <code>-q</code> that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <code><use></code>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T16:07:52Z

Zearin: Lots of small copy edits for formatting, punctuation, grammar, etc.

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit > Preferences > Rendering > Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** '''Note:''' Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit → Preferences → Interface → Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit > Preferences > Interface > Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for 'ctrl+alt+t' to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit → Preferences → Interface → Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* '''Page:''' the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* '''Selection:''' a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit > Preferences > Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code>F</code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (CTRL+B).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

<code>Preferences -> Rendering -> Enable OpenGL</code>

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold Shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <code>Ctrl</code> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default, so you can control horizontal and vertical blurring separately. If you hold '''<code>CTRL</code>''' you can control both Axes linked. You can control arbitrary angle of blurring if you rotate your object after you set blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new HTML/CSS style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with ctrl/shift)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: <code>'''X'''</code>.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''Shift + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path → Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path → Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit → Preferences → Behavior → Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps, and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to <code>fe-image</code> and <code>fe-tile</code> (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need UX work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* Space bar confirms (select, apply, open)
* Shift -> <- open close group
* Shift up down to move in Z orde <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental + Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences > Behavior > LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences > Behavior > LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc...) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add Visio modern formats vssx and vsdx. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16×16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, <code>d <path data></code>. You can change highlighting themes in <code>Preferences > Interface > Theming</code>.

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of SVGs.

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvvas controls that should improve usability. You can add this Live path effect from node tool toolbar .[[File:Asdasdasdasdasd 123.png]]. You can also assign a shortcut to this effect (no shortcut is set by default)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added user.css to UI folder to allow tweaking UI without interfering with or fully overriding other CSS files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detects dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter <code>--actions-file</code>. You specify a list like in <code>--actions</code> but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter <code>--active-window</code> / <code>-q</code> that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <code><use></code>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T15:57:17Z

Zearin: Markup keyboard shortcuts

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit > Preferences > Rendering > Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** Note: Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit → Preferences → Interface → Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit > Preferences > Interface > Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for 'ctrl+alt+t' to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit → Preferences → Interface → Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* Page: the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* Selection: a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit > Preferences > Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code>F</code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (CTRL+B).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

Preferences -> Rendering -> Enable OpenGL

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <code>Ctrl</code> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default so you can control horizontal and vertical blurring separately. If you hold '''<code>CTRL</code>''' you can control both Axiies linked. You can control arbitrary angle of blurring if you rotate your object after you set your blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new html/css style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with ctrl/shift)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''<kbd>Ctrl+Alt+T</kbd>'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''<kbd>Ctrl+Alt+D</kbd>'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + <kbd>C</kbd> - Drag and object and press <kbd>C</kbd> to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: <code>'''X'''</code>.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''Shift + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path → Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path → Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit → Preferences → Behavior → Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to fe-image and fe-tile (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need ux work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* Space bar confirms (select, apply, open)
* Shift -> <- open close group
* Shift up down to move in Z orde <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental + Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences > Behavior > LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences > Behavior > LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc...) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add visio modern formats vssx and vsdx. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16x16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, d <path data>. You can change highlighting themes in <code>Preferences > Interface > Theming</code>

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of svgs

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvvas controls that should improve usability. You can add this Live path effect from node tool toolbar .[[File:Asdasdasdasdasd 123.png]]. You can also asing e shorcut to this effect (ho shorcut is set by defoult)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added user.css to UI folder to allow tweaking UI without interfering with or fully overriding other css files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detect dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter --actions-file. You specify a list like in --actions but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter --active-window / -q that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <use>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.3

2023-04-01T15:54:30Z

Zearin: Minor readability tweak

{{Box| '''These Release Notes are in Draft Status.'''

Note: Not all animations work, due to Wiki bugs with resizing images. Release notes will be transferred to website, there animations will be working.

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: xxx)]
* [https://gitlab.com/inkscape/extensions/-/commits/master Commit History Extensions (starting from: xxx)]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/master Commit History Documentation (starting from: xxx)]

}}

{{Box| Pending questions:

}}

== Release highlights ==


'''Definitely not released yet.'''

The highlights of this major Inkscape version are:

* [[#Shape_Builder_Tool|Shape builder]] - a new tool for building complex shapes (Boolean tool)
* [[#On-Canvas_Pattern_Editing|On-Canvas Pattern Editing]]
* [[#Pattern_Editor|Pattern Editor]]
* [[#Page_Tool|Page margins & bleed]]
* [[#Document_Resources_Dialog|Document Resources Dialog]]
* Return of [[#Layers_and_Objects_Dialog|Search, opacity & blend modes in Layers & Objects dialog]] and of an optional [[#Snap_toolbar|persistent snap bar]]
* [[#Font_Collections|Font Collections]]
* [[#Syntax_Highlighting|Syntax highlighting in XML Editor]]
* [[#LPE_Dialog|LPE dialog user interface redesign]]
* '''And so much more!'''

== Performance ==

A lot of effort has gone into improving the performance and speed of all aspects in Inkscape. This involved the refactoring of inefficient code, rewriting how Inkscape works with patterns, moving bitmap tracing into a separate thread and so much more!

Canvas rendering is now both multithreaded and done outside of Inkscape's main process thread. This should significantly improve performance while zooming/panning/transforming objects if your computer's processor has more than one core (which it most likely does).

In some cases, this results '''in a 2–4× speedup'''.

You can set the number of processor cores Inkscape should use for rendering in <code>Edit > Preferences > Rendering > Number of Threads</code>. By default, Inkscape tries to be as fast as possible by using as many cores as possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests?scope=all&state=merged&label_name[]=Project%3A%3AMultithreading Multithreading MRs], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4760 MR #4760]).

== General user interface ==

=== Color Palette ===

[[File:Indicators of used colors.png|thumb|Indicators for used colors]]
* Color palette fields now have little indicators that show which color is used for the stroke and fill of a selected object.
* Color pinning ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]):
** You can select colors from the palette that you are using and 'pin' them to the start of the palette, for faster access. By default, these 4 colors are 'Unset', black, grey and white, but you can choose any other color, too. These fields can be made larger, so they can be easily clicked on.
** To add a color to the pinned colors array, right-click on its palette field and select 'Pin color'. The color will then be moved away from its original location in the palette to the palette start.
** To 'unpin' a color, right-click on the pinned color's field and select 'Unpin color'.
** To choose the pinned colors' size, click on the palette bar's hamburger menu icon and select to 'Configure' it, and check / uncheck the option 'Enlarge pinned colors'.
** Note: Pinned colors only show up if the current palette contains them. So when you switch the palette, some colors may be dropped, and when you switch back to a palette that contains them, they will show again.

[[File:Inkscape BHd0t2kzml.gif]]

=== Pasting Options Renamed, and Paste on Page ===

The <code>Paste size</code> entry in the <code>Edit</code> menu has been renamed to <code>Paste…</code>, to hold all 'special' pasting operations that you may need.

A new pasting feature <code>On Page</code> has been added to this renamed menu to paste the copied object(s) into the same position on a different page ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4695 MR #4695]).

For this to work correctly, you must first select the page to paste on by either:

* selecting an object on that page before pasting
* selecting the page with the page tool
* changing the current page using the buttons in the status bar

=== Snap toolbar ===

An option was added in <code>Edit → Preferences → Interface → Toolbars</code> to show snapping options permanently in a dedicated toolbar, similar to Inkscape version 1.1 and earlier.

=== Keyboard shortcuts ===

The keyboard shortcuts for aligning objects vertically and horizontally have been moved to the numeric keypad, where the other alignment shortcuts are, too:

*Vertical alignment was moved from <kbd>Ctrl+Alt+T</kbd> to <kbd>'''Ctrl+Alt+Numpad 1'''</kbd>
*Horizontal alignment was moved from <kbd>Ctrl+Alt+H</kbd> to <kbd>'''Ctrl+Alt+Numpad 7'''</kbd>
[[File:OKLAB.png|thumb|474x474px]]
If you find yourself unable to reach the new shortcuts (for example, because your laptop does not have a keypad, or because the shortcuts do not work - may be the case on Linux with Xfce), you can set them to something else by changing '''both''' the alignment shortcut '''and''' the function that now uses that shortcut (if any). Use the search in <code>Edit > Preferences > Interface > Keyboard</code>. It also allows searching for shortcuts, not only for their name (e.g. search for 'ctrl+alt+t' to find the new default action that is executed when that combo is pressed).

=== Color Pickers ===

Color pickers in Inkscape now support choosing colors in the '''OKLch''' color space, which has just been adopted into the CSS Color Module Level 4 [https://www.w3.org/TR/css-color-4/#ok-lab draft recommendation]. For those who would like to learn more, OKLch and OKLab are described in detail by its creator [https://bottosson.github.io/posts/oklab/ in a blog post].

This additional option is disabled by default. It can be enabled in <code>Edit → Preferences → Interface → Color Selector</code> as "OKHSL", and will then be available in any color picker's dropdown. Note that color values will still be written as RGB hex codes in the SVG source, and Inkscape also does not support reading colors that are defined in that color space. This change is purely adding a new convenient option for choosing colors.

=== Rulers ===

Inkscape's rulers at the canvas boundaries got two new indicator areas:

* Page: the part of the ruler that corresponds to the current page's location is now colored in a different tone, so you can always see where your page ends.
* Selection: a thin blue line indicates and follows the current selection. This line can be turned off in <code>Edit > Preferences > Interface: Show selection in ruler</code>.

Ruler performance has been improved along with these changes.

[needs screenshot of current default]

=== Commands Palette ===

It is no longer necessary to scroll horizontally in the Commands palette (shortcut: <kbd>?</kbd>), as entries are now nicely arranged and formatted and make use of linebreaks. Now all the info for an entry is directly visible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4988 MR #4988])

[Needs new screenshot with more up-to-date ruler or entirely without]

== Canvas ==

Pressing '''<code>F</code>''' temporarily hides on-canvas overlays (transformation handles, grids, guides...). This allows quick preview of final artwork without any distractions.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4395

Added display overlay controls in top right corners. You need to have scrollbars enabled to see it (CTRL+B).

[[File:Ezgif.com-resizeasd.gif|400x400px]]

=== OpenGL (GPU) accelerated canvas ===
An OpenGL-accelerated display mode was added to the canvas to speed up panning, zooming and rotating.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4133

This is NOT a fully GPU-based renderer; content is still rendered on the CPU in exactly the same way as before, so large performance improvements are not to be expected. It does however result in a smoother display and lower CPU usage, especially on HiDPI screens.

OpenGL mode is highly experimental and is turned off by default. It can be turned on at

Preferences -> Rendering -> Enable OpenGL

Note however the following caveats:

*Due to packaging problems, when using the Linux AppImage, OpenGL support either does not work (on X11) or crashes (on Wayland).
* Due to GTK3 bugs, OpenGL mode crashes on Windows, blacks out the screen on MacOS, is slower than software rendering on Linux X11, and is only really usable on Wayland.

For these reasons, it is not expected to be useful until we migrate to GTK4, where we hope that at least some of these bugs have been fixed.

=== Smooth auto-scrolling ===
Auto-scrolling happens when you drag an object off the edge of the canvas. We improved smoothness of this action.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5027

== Tools ==

=== General ===

You can right click on any tool icon in toolbox to see tool preferences.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4982

=== Gradient Tool ===

* Allow changing the ''repeat'' setting when multiple gradients are selected.
* Show 'Multiple gradients' in the stop list when multiple gradients are selected (instead of a random stop).
* Allow editing of the offset of the start/end stops.
* Keep the stop selected after the offset is changed in the toolbar (instead of selecting the first stop of the gradient).

https://gitlab.com/inkscape/inkscape/-/merge_requests/4339

=== Node Tool ===

[[File:Inkscape xfsvsc2oY9.gif|thumb|editing pattern on canvas]]

==== On-Canvas Pattern Editing ====

Pattern editing on canvas is now easier; you can click on any part of a pattern and it will show you controls at that position. We also added an outline that shows you the edges of the pattern. The first square controls position, the circle controls rotation, and the second square controls size. Hold shift to constrain proportions.

We also fixed performance problems with patterns, so now you can have smaller patterns in project and zoom in on them without worrying about Inkscape eating up all your RAM.

==== Draw around Selection ====

We added a new (lasso) selection mode for nodes. Hold <kbd>Alt</kbd> and draw with the Node tool around the nodes that you want to select. This saves a lot of time that was needed before, where you needed to add new nodes to the selection by dragging small rectangles while holding <kbd>Shift</kbd>, whenever nodes were not located together in a convenient rectangular area ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4747 MR #4747]).

==== Better shape preservation when deleting nodes ====
New, improved curve fitting algorithm from FontForge used when deleting nodes on a "smooth" path (rather than corners)

[[File:Spline-fit-1.gif]]

Attempt to apply "preserve shape" only if selected nodes define relatively smooth path. Trying to preserve shape when deleting corners is rarely what's desirable:

[[File:Spline-fit-2.gif]]

With "preserve shape" option ON, algorithm may still decide to insert line segments if it detects what it thinks are corners. Holding <code>Ctrl</code> key while deleting inverts this decision:

[[File:Curve-fit-inverted.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/5082

==== Edit Blur on Canvas ====

New canvas controls for blurring is showed on canvas, if you add blur in fill and stroke panel or add filter that has Blur. Controls are not linked by default so you can control horizontal and vertical blurring separately. If you hold '''<code>CTRL</code>''' you can control both Axiies linked. You can control arbitrary angle of blurring if you rotate your object after you set your blur.

[[File:Inkscape fCXLNVIQp7.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4867

==== On canvas Corners editing ====
We added shorcut for '''Rounded corners''' in to tool bar. First click enable corners and show controls second will delete this effect

[[File:Inkscape E33kBkZM1j.gif]]

=== Page Tool ===
[[File:Ezgif.com-gif-maker (12).gif|right|600x600px]]The Page tool now has controls for margins and bleed:

* An attribute on the page element to record the margin
* A new html/css style box model with tests
* New UI to set margins in the toolbar
* New on-canvas controls for moving margins (with ctrl/shift)
* New display of margins in the same canvas group as the page border
* Snapping for page margins

https://gitlab.com/inkscape/inkscape/-/merge_requests/4523

=== Selector Tool ===

New commands:

*'''Reapply transform''': ''Ctrl+Alt+T'' - This allows a user to perform a transformation multiple times and works from the canvas edits or from transform dialog or the select toolbar. <span style="color: red;">Shortcut needs to change, it opens a terminal on Linux.</span>
*'''Duplicate and transform''': ''Ctrl+Alt+D'' -This performs a duplication and then reapplies the previous transform to the duplicate. <span style="color: red;">Shortcut needs to change, it minimizes the window on Linux.</span>
https://gitlab.com/inkscape/inkscape/-/merge_requests/4506
*'''Clone while dragging:''' drag object + C - Drag and object and press C to clone it in the current position. https://gitlab.com/inkscape/inkscape/-/merge_requests/4752

=== Shape Builder Tool ===

New tool for fast shape building and Boolean operations. Shortcut: <code>'''X'''</code>.

Use: Select multiple overlapping shapes and select the Shape Builder tool. The selection will be fragmented on overlapping areas, while everything else will be hidden until you leave the shape builder. Now you '''Click and drag''' to combine segments together or hold '''Shift + Click and drag''' to subtract, and '''Single click''' on segments to split. Adding is represented by a blue color, removing by pink.

[[File:Shape_builder.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4709

== Path Operations ==

=== Fracture Paths ===

<code>Path → Fracture</code> - every overlapping path will be split into separate object.

=== Flatten Paths ===

<code>Path → Flatten</code> - overlapping objects will be flattened visually (it will delete paths that are hidden behind a top path). Useful for separating colors for Screen printing and offset printing as well as for doing any kind of plotting.

== Masking / Clipping==

*A new option to '''preserve clips / masks when ungrouping''' objects has been added (<code>Edit → Preferences → Behavior → Clippaths and masks: When ungroup, clip/mask is preserved in children</code>). The option is active by default. This means that when you now ungroup a group that has been clipped, the elements inside it will inherit the clip. Previously, the clip was removed and everything became un-clipped. To go back to previous default behavior, deactivate this new option. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3564 MR #3564])

== Dialogs ==
=== Document Resources Dialog ===

[[File:Document resources dialog.gif|thumb|The Document Resources dialog]]

Added a new dialog that shows you an overview of what assets are currently inside your document. You can edit names and export some of the resources from this dialog.

It presents the following document assets:

* fonts
* styles
* colors
* swatches
* gradients
* filters
* patterns
* symbols
* markers
* images
* external references

https://gitlab.com/inkscape/inkscape/-/merge_requests/5003

=== Export Dialog ===

We added new options for how to export multipage in PDF and SVG formats allowing the selection of a single page out of many to export in the single-export tab and improving how batch exporting is done by ordering pages correctly.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5002

=== Fill and Stroke Dialog ===
[[File:Pattern editor1.gif|alt=Pattern editor|right|Pattern editor]]

==== Pattern Editor ====

Added in to UI. You can preview patterns, change Name, Size, Rotation, Offset, Gaps and Colors for some specific patterns. We also added collections of patterns in <code>~paint/</code> so it's easier to be organized. Since this allows having many more patterns preinstalled, we also added a search function and a few new default patterns.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4938

[[File:Inkscape 9yhQG7s68v.gif]]

=== Filter Editor ===
[[File:Filter-resize.gif|alt=Filter-resize|Filter-resize|left]]

Redesign of this dialog:

*Filter selection moved to a popover
* Effects are listed in a popup menu and can be selected by searching (by name)
* Adjusted connector sizes to make them more compact
* Fixed an issue where all parameters would initially be visible in a docked filter dialog
* Fixed min size of parameters panel to make it fit in a narrow docked dialog
* Reactive layout to accommodate wide dialog
* Added primitive filter attributes to fe-image and fe-tile (#1417)
* Replaced GTK color picker with Inkscape color picker

*Sources can now be hidden (for most use cases only the source graphic is useful; other inputs are broken or need ux work).<br />https://gitlab.com/inkscape/inkscape/-/merge_requests/4720[[File:Inkscape Y7U4yzIFTq.gif|thumb]]

=== Layers and Objects Dialog ===

UX improvements:

* You can click and drag to change visibility of multiple objects
* Selecting on group does not auto expand
* Selecting multiple objects and and changing visibility/locking applies to all selected
* We added a search feature; it's a limited implementation - it does not auto-apply search and you need to search for more than 3 characters.
* We added a hover indicator for rows and layer colors
* Added controls for opacity and blending mode

We added shortcuts for layers navigation and actions:

* Arrows to navigate
* Space bar confirms (select, apply, open)
* Shift -> <- open close group
* Shift up down to move in Z orde <br />Improved performance for editing of many obejcts at once
https://gitlab.com/inkscape/inkscape/-/merge_requests/5183[[File:VirtualBoxVM I675gipqe1.gif|thumb|1017x1017px|Place holder demo of new LPE dialog]]

=== Live Path Effects (LPE) ===

==== LPE Dialog ====
The compact new design merges organization and controls into one unit. You can reorder LPE by dragging and dropping the whole effect. It adds a fast search box, and a fast dropdown for adding effects.

Each LPE has 5 controls:

* Show/hide controls
* Visibility of effect
* Delete effect
* Context menu
** Re-order
** Duplicate
** Set as default
** Flatten

[[File:LPE organization.png|right|266x266px]]

[<span style="color:red;">TODO: gif file needs to be edited!</span>]

==== Reorganization of LPEs ====

Since we needed a more compact way to show all LPEs, we decided on a list that is organized into 6 categories:
Tools, Distort, Generate, Convert, Experimental + Favorite

==== Changes ====

* Setting presets for LPE was moved into contextual menu
* Setting Favorite LPE was moved into contextual menu
* Added new feature: flatten - This will apply effect to geometry. It will apply all effects in the stack.
* We removed LPE gallery (you can still enable it in preferences if you wish: <code>Preferences > Behavior > LPE</code>)
* To see experimental LPEs you need to enable it in Preferences: <code>Preferences > Behavior > LPE</code>
* Added an indicator showing which object is selected
* Added conversion commands when you select text objects - since text does not support LPEs yet we added a workaround that converts text to paths or clones the text.
* If you select an object that is associated with an LPE (Clone, Boolean operations, Bend, Fill between many, etc...) you will see a button in the dialog that will take you to the linked geometry/controls.
* Labels inside effects are aligned nicely

https://gitlab.com/inkscape/inkscape/-/merge_requests/4677

=== Swatches Dialog ===

In the Swatches dialog, the option to display colors together with their names (from the .gpl palette file), in a vertical list, is back again.

Enable it by clicking on the Hamburger menu, choosing 'Configure' and selecting the option 'Show color labels' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4957 MR #4957]).[[File:Ezgif.com-optimizeasda.gif|right]]

=== Symbols Dialog ===

This dialog got a new redesign:

* Migrated dialog settings to a popover.
* Saving dialog UI state in preferences (current symbol set and settings are remembered).
* Larger range for scaling (tile size) and symbol zooming.
* Fixed symbol selection color for dark themes.
* Added option to show symbols names.
* Rendering symbols at screen resolution - sharp (high-dpi aware).
* List of symbol sets is searchable and can be filtered.
* Symbol search is live (no need to press enter).
* Symbol rendering is done on-demand, to limit memory use and time needed to switch sets.
* Stats: total number of symbols / how many are visible.

==== New features ====

* You can drag and drop symbols on canvas and they are going to be placed exactly where you dropped them.
* A new icon - the "peace" symbol.
* Improved performance.
* Add visio modern formats vssx and vsdx. Symbols are loaded once, not in each window.
* We added new stock symbols SJJB map icons.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4975
https://gitlab.com/inkscape/inkscape/-/merge_requests/4994
https://gitlab.com/inkscape/inkscape/-/merge_requests/4666
https://gitlab.com/inkscape/inkscape/-/merge_requests/4883
https://gitlab.com/inkscape/inkscape/-/merge_requests/4793
https://gitlab.com/inkscape/inkscape/-/merge_requests/4784

=== Text and Font Dialog ===

==== Font Collections ====

[[File:Font collections opt.gif|thumb|Font collections]]

[todo: document features and how to use them ]
https://gitlab.com/inkscape/inkscape/-/merge_requests/4694

=== Trace Bitmap Dialog ===

Got significant performance boost and a progress bar. Now it runs in the background, allowing you to cancel it if it's taking too long.
https://gitlab.com/inkscape/inkscape/-/merge_requests/4702

=== Welcome Dialog ===
Files are sorted by their last modified date. We Added recovery for files in this list after crash. You can see then by text Emergency save next to file.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5058

=== XML Editor ===

[[File:Syntax highlighting.png|thumb|Syntax highlighting in XML Editor]]
We did small cosmetic changes to UI of this dialog:

* smaller icons (16x16px),
* removed text tool tips.
* Added responsive layout and moved layout controls to the top in a dropdown (auto layout is the default option).

==== Syntax Highlighting ====

For improving readability we added syntax highlighting and auto line-breaking. This works for CSS style tag, inline styling, d <path data>. You can change highlighting themes in <code>Preferences > Interface > Theming</code>

==== Rounding path data ====
We added a feature to round path data. You can also set how many decimal points you want to round to. This gives you granular control over optimizing size of svgs

[[File:Inkscape GAlKvNTcCm.gif]]

https://gitlab.com/inkscape/inkscape/-/merge_requests/4885

== Filters ==

== Live path effects ==
LPE Dialog was completely redesign see [[New redesigned LPE dialog]] for more details. Performance of most of the effects was improved.
=== Roughen ===
UI clean-up and reordering of the controls.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4872

=== Taper Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4906

=== Power Stroke ===
Added support for sub-paths.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4880

=== Corners ===
New design for canvvas controls that should improve usability. You can add this Live path effect from node tool toolbar .[[File:Asdasdasdasdasd 123.png]]. You can also asing e shorcut to this effect (ho shorcut is set by defoult)

https://gitlab.com/inkscape/inkscape/-/merge_requests/5164

== Import / Export ==

=== Refactoring of PDF and AI import ===
The PDF importer was using the svg group as a way of tracking the GfxState matrix, but this actually causes a lot of problems. Using the Sfx CTM matrix state directly provides dependable positions and transformations for creating objects.

* New import PDF dialog GUI using glade
* Added PDF layer support
* Merging of similar path stroke/fill objects
* Removal of state groups
* Rendering text methods, to glyphs and to text
* Embedded font handling for rendering methods
* Much better font-name detection
* ICC Color Profile support
* Margins, bleeds and page sizes retained.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4757

== Templates ==

All template dialogs (Welcome screen, New from Template, Page tool default sizes) now use the same template sizes ([https://gitlab.com/inkscape/extensions/-/merge_requests/479] MR #479)

== Customization / Theming ==
Added user.css to UI folder to allow tweaking UI without interfering with or fully overriding other css files. https://gitlab.com/inkscape/inkscape/-/merge_requests/5004

Fixed hidden icons on menus: https://gitlab.com/inkscape/inkscape/-/merge_requests/4686

== Other ==
Added support for <code>href</code> and <code>xlink:href</code> in SVG header. This makes Inkscape more compatible with SVG 2.

https://gitlab.com/inkscape/inkscape/-/merge_requests/4596

== MacOS-specific Changes ==

== Windows-specific Changes ==

Inkscape detect dark and light theme and maches color of the title bar.

https://gitlab.com/inkscape/inkscape/-/merge_requests/5144
== Extensions ==

=== Features ===
Speed up processing especially on complex documents: https://gitlab.com/inkscape/inkscape/-/merge_requests/4996

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

==== API Changes for Third-Party Extension Developers ====

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

Added a new parameter --actions-file. You specify a list like in --actions but in a file to allow bypassing Windows comandline length limit, and also to allow reuse of action lists.

Added a new parameter --active-window / -q that runs all commands on the active window of an already-running instance of Inkscape.

== Behind the curtains ==

== Notable bugfixes ==
=== Crash fixes ===

Fixed a crash that occurred…

* When…

=== Other bug fixes ===

* LPE related undo bugs: https://gitlab.com/inkscape/inkscape/-/merge_requests/4520
* Fixed bspline LPE with cusp nodes when initially using with node tool. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016
* <use>s retain their LPE correctly when unlinked or converted to paths. The old convert to paths behaviour is still available in the Preferences. https://gitlab.com/inkscape/inkscape/-/merge_requests/5016

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small proportion of users, or are relevant for development and packaging only.

For a complete list, visit [https://gitlab.com/inkscape/inkscape/-/issues?milestone_title=Inkscape+1.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

*…

The Windows installer translation was updated for:

*…

The following documentation translations received updates:

*…

=== Contributing to interface translations ===

Want to help with translations? [https://inkscape.org/contribute/translations/ Learn how to help!]

== Documentation ==

=== Contributing to documentation and documentation translation ===
Contributions to the documentation translations, as well as improvements to its contents, are welcome at [https://gitlab.com/inkscape/inkscape-docs/documentation the inkscape-docs repository].

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.0

2020-04-15T18:16:24Z

Zearin: Add markup to keyboard shortcut

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

<languages />

<translate>

== Inkscape 1.0 == 


'''(definitely not released yet - [[AnnouncePlanning1.0]])'''


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

== Release highlights == 


* [[#customization|Theming support and more new customization options]]
* [[#hidpi|Better HiDPI (high resolution) screen support]]
* [[#macos|Native support for macOS with a signed and notarized .dmg file]]
* [[#origin|Coordinate origin in top left corner by default]]
* [[#canvas|Canvas rotation and mirroring]]
* [[#on-canvas-align|On-Canvas alignment of objects]]
* [[#view-modes|Split view and X-Ray modes]]
* [[#powerpencil|PowerPencil for drawing editable, variable width strokes with a pressure sensitive graphics tablet]]
* [[#png-export|New PNG export options]]
* [[#centerline|Integrated centerline tracing for vectorizing line drawings]]
* [[#symbols|Searchable Symbols dialog]]
* [[#lpe-dialog|New Live Path Effect (LPE) selection dialog]]
* [[#lpes|New Corners (Fillet/chamfer) LPE, (lossless) Boolean Operation LPE, Offset LPE and Measure Segments LPE (and more!)]]
* [[#performance|Path operations, deselection of a large number of paths as well as grouping/ungrouping are much faster now]]
* [[#line-height|Much improved text line-height settings]]
* [[#variable-fonts|Variable fonts support (only if compiled with pango library version >= 1.41.1)]]
* [[#flowed-text|Browser-compatible flowed text]]
* [[#extensions-api|Extensions programming interface updated, with many new options]] - ''Note: this introduces breaking changes, some third-party extensions will have to be updated to work with Inkscape 1.0''
* [[#python3|Python 3 support for extensions]]

== General: Application == 

=== Performance <span id="performance"></span>=== 

Lots of small performance improvements in various areas combine to make Inkscape run smoother than before:

* Accelerated breaking apart of paths and Boolean operations (by disabling intermittent canvas rendering during these operations).
* Accelerated "deselect" speed (by improving internal data structure algorithms).
* Faster grouping and ungrouping of groups with a large number of objects
* Speed boost to operations on large sets of objects in the Objects dialog (Bug [https://gitlab.com/inkscape/inbox/issues/392 #392])
* Faster lookup of attributes (MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448])

=== Mac Application <span id="macos"></span>=== 


Inkscape is now a first-rate native macOS application, and no longer requires XQuartz to operate. The minimum required operating system version is OS X El Capitan 10.11.


It has a standard Mac-style menu bar (rather than a menu bar within the window). Keyboard shortcuts now use the command (<kbd>⌘</kbd>) key rather than the control key. Retina display screen resolution is now supported. The build is now cleanly 64-bit, a prerequisite for macOS Catalina 10.15 and beyond. It comes bundled with Python 3 to power Inkscape extensions.


[[File:Mac_menu_1.0_screenshot.png|665px]]

== General User Interface == 

=== Modernized GUI Toolkit=== 


The user interface has been changed to utilise a more recent version of GTK+ (GTK+ 3). This is a collection of user interface building blocks that Inkscape uses to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI (high resolution) screens.

Bringing the newer GTK+ toolkit to Inkscape has been an eagerly anticipated goal for a long time. It has taken much effort by the Team involved and it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Window position / size / behavior === 


Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
were made. The window manager handles most of the jobs now, which should make it much more robust. If you still encounter problems with this, please report those [https://inkscape.org/report to our bug tracker].

The dialog opacity options have been removed, because they were causing crashes that could not be fixed otherwise.

=== High Resolution Screens <span id="hidpi"></span> === 


Inkscape now supports HiDPI (high resolution) screens natively. This means that icons and node handles will no longer be tiny on monitors with large pixel dimensions, and the canvas will no longer look blurry.

=== Tool box === 

The tools have been reordered and grouped into more logical groups. Zoom and measure tools as well as Spray, Tweak and Eraser are now closer to the bottom. Users can customize the order of the tools by putting a customized version of the file <code>inkscape/share/ui/toolbar-tool.ui</code> into a folder named <code>ui</code> in their Inkscape user configuration folder, if they prefer a different order.

<gallery>
File:Toolbox 1.0.png|''Reordered tools in the tool box''|alt=Reordered tools in the tool box
</gallery>

=== Improved number entry fields === 


Many numeric entry fields no longer change their value when scrolling while the mouse is hovering over them. They now need to be selected (clicked into). Then scrolling will change the value as previously. This change was made, because scrolling docked dialogs easily led to accidental change of values.


Additionally, <kbd>Ctrl+Scroll</kbd> on a selected numeric entry field will now change the value in larger steps.

== Canvas == 

=== Y-Axis Inversion <span id="origin"></span>=== 


During the [https://inkscape.org/en/news/2018/09/20/inkscape-hackfest-kiel-2018-what-happened/ Inkscape Hackfest in Kiel], a significant change by Thomas Holder was integrated into the Inkscape codebase. It sets the origin of the document to the top left corner of the page. This finally makes the coordinates that a user can see in the interface match the ones that are saved in the SVG data (unit conversions/transformations may be required), and makes working in Inkscape more comfortable for people who are used to this more standard behavior. The old behavior can be reactivated in the preferences, at <code>Edit → Preferences → Interface</code> (disable 'Origin in upper left with y-axis pointing down').


<gallery>
File:Origin in upper left.png|''Option in the preferences' 'Interface' section''|alt=Option in the preferences' 'Interface' section
File:Origin in upper left page.png|''Effect of the option (left upper page corner at 0/0)''|alt=Effect of the option (left upper page corner at 0/0)
</gallery>

=== Canvas Rotation <span id="canvas"></span>=== 


With <kbd>Ctrl+Shift+Scroll wheel</kbd> the drawing area can be rotated and viewed from different angles. In the bottom right corner of the window, the viewing angle can be entered manually. Right-click to select between a set of preset values. Keyboard shortcuts for clockwise/counter-clockwise/no rotation can be set in the preferences.


[[File:Canvas rotation.gif]]

=== Canvas Mirroring === 


The canvas can now be flipped, to ensure that the drawing does not lean to one side, and looks good either way.
The vertical/horizontal flipping is available from the menu <code>View → Canvas orientation → Flip horizontally / Flip vertically</code>. Keyboard shortcuts for flipping the canvas can be set in the preferences (<code>Edit → Preferences → Interface → Keyboard shortcuts</code>).


[[File:Flip canvas 300px.gif]]

=== Pinch-to-zoom === 


On supported hardware (trackpad, touchpad, multi-touch screen), the canvas can be zoomed with the two-finger pinch gesture.

=== Duplicate Guides === 


A new option for duplicating guides was added to the 'Guideline' dialog. This new feature, when used in conjunction with the 'relative change' option (dialog needs to be opened twice), makes it easier to create guides that are offset by a certain distance / angle from an existing guide.


[[File:Duplicate guide.png]]

=== Context menu === 


The menu that appears after a right-click on the canvas has been extended with the following items, which makes locking/unlocking and hiding/unhiding individual objects much more comfortable:


* Hide selected objects
* Unhide objects below (the mouse cursor)
* Lock selected objects
* Unlock objects below (the mouse cursor)


<gallery>
File:Context menu.png|''New options in context menu''|alt=New options in context menu
</gallery>

=== Snapping === 


* In <code>Edit → Preferences → Behavior → Snapping</code>, a new option was added to '''disable snapping''' in new documents or files that are opened with Inkscape for the first time.

== View == 

=== Center view on page === 


You can now center the view on the page, without changing the zoom level.


This function is available via:


* <code>View → Zoom</code>
* the Zoom tool's tool controls bar
* Keyboard shortcut <kbd>Ctrl + 4</kbd>

=== Split View Mode <span id="view-modes"></span>=== 

The new Split View Mode features a draggable separator that becomes visible as soon as the Split view mode has been activated. On one side of the separator, the canvas will look just like before, while on the other side, everything will be displayed in outline mode, and objects can more easily be grabbed with the mouse or edited with the node tool.

It can be moved on the canvas by grabbing either the separation line or the central handle. The sides can be switched by clicking on one of the little arrows on the handle.

Activate it with one of:

* <code>View → Split View Mode</code>
* <kbd>Ctrl + 6</kbd>

To deativate the mode, either deactivate the checkbox in the menu again, use the keyboard shortcut a second time, or drag the separator off the canvas.


[[File:Split Screen-smaller.gif]]

=== X-Ray Mode ===

When the X-Ray mode is active, a circular area that shows objects on the canvas in outline mode will follow the mouse pointer. This makes editing complex drawings with many objects layered on top of one another much easier, and is especially useful when used with the node tool.

Activate it with:

* <code>View → XRay Mode</code>
* <kbd>Alt + 6</kbd>

The size of the X-Ray circle can be adjusted in <code>Edit → Preferences → Rendering → Rendering XRay radius</code>.

To deactivate the mode, either deactivate the checkbox in the menu again, or use the keyboard shortcut a second time.

[[File:XRay mode.gif]]

=== Visible Hairlines Display Mode === 


This new display mode is available in the menu under <code>View → Display Mode → Visible Hairlines</code>. It ensures that all lines of nonzero width are visible (with a minimum visible line width), regardless of zoom level, while still drawing everything else normally.


This is especially useful if you need to assign very small line widths for use with CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines. In that case, you will still be able to see the lines, even when zoomed out.


[[File:visible_hairlines.gif]]

== Paths == 

=== Changed behavior of Stroke to Path === 


The 'Stroke to Path' command now not only converts the stroke of a shape to path, but effectively splits it into its components.


In the case of applying it to a path that only has a stroke, the behavior is unchanged.


For paths that don't only have a stroke, but also a fill and/or markers, the result will be a group consisting of:
* Stroke outline turned to path
* Fill (if there was one)
* A group of all markers (if applicable; one group per marker, consisting of its outline and its fill turned into a path)


[[File:Stroke to path.gif]]

=== Unlinking Clones for Path Operations === 


Clones and Symbols are now automatically unlinked, before a Boolean operation (union, difference, etc.), or one of the Path operations 'Combine', 'Break apart', or 'Stroke to Path' is performed.


A setting in the preferences at <code>Behavior → Clones → Unlink Clones</code> allows the User to disable the automatic unlinking.

== Tools == 

=== Bézier Tool === 


The tool mode 'Create sequence of paraxial segments', which previously would only draw lines parallel to the x and y axis of the document, now supports arbitrary starting angles. After the first segment, all further angles will use the current angle ±90°. If you want your first segment to work as in previous versions, you need to press <kbd>Ctrl</kbd> after the first click. This will restrict your options to (by default) 15° steps.


<gallery>
File:Paraxial arbitrary starting angle.gif|''Arbitrary starting angle for paraxial mode''|alt=Arbitrary starting angle for paraxial mode
</gallery>

=== Calligraphy Tool === 


A new option to add dots has been added to the tool. Click in place without moving the mouse to create a dot, <kbd>Shift+Click</kbd> to create a larger dot ''[needs documentation in keyboard shortcut list, https://gitlab.com/inkscape/inkscape-docs/documentation/-/issues/1 ]''.

=== Circle Tool === 


The circle tool can now also create closed ("filleted") circle shapes (closed arcs) with the click of a button.


<gallery>
File:Circle chord.png|''Circle tool shapes in this release''|alt=Circle tool shapes in this release
</gallery>

=== Eraser === 


* Added option to control eraser width with a pressure sensitive input device.
* Added thinning, caps, and tremor options (as used for calligraphy tool).
* New option to erase as clip, which allows the User to non-destructively erase (parts of) various types of elements, including raster images and clones.


[[File:Erase with clip.gif]]

=== Measurement Tool === 


Hovering over a path with the tool now displays the length, height, width, and position of the path. If you hover over a group, it will show the width, height, and position of the group. Holding <kbd>Shift</kbd> switches to showing info about the constituents of the group.


The tool also has a new option to only measure selected objects when using click-and-drag.


<gallery>
File:Measure tool info.png|''New info text from measurement tool (for a group)''|alt=New info text from measurement tool (for a group)
File:Measure tool info group shift.png|''Measurement tool info text for a single path (in a group with Shift)''|alt=Measurement tool info text for a single path (in a group with Shift)
File:Measure selected.png|''Measuring only the selected object (the ice cap)''|alt=Measuring only the selected object (the ice cap)
</gallery>

=== Pencil Tool === 

==== PowerPencil <span id="powerpencil"></span>==== 


Pressure sensitivity can now be enabled for the Pencil tool. This feature makes use of the PowerStroke Live Path Effect (LPE).


New settings for the tool are available for tweaking the behavior of the PowerStroke LPE when it is being created with the Pencil tool (and a graphics tablet/stylus):
* '''Use pressure input''' (in the tool controls bar): activates the PowerStroke feature, if a pressure sensitive device is available.
* '''Min/Max''' (in the tool controls bar): determines the minimal and maximal stroke width (0–100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* '''Caps''' (in the tool controls bar): choose between the options 'butt', 'square', 'round', 'peak' and 'zero width' for the end caps of the stroke.
* Additionally, the PowerStroke LPE itself has been improved, to better work when used in this new way, see [[#PowerStroke_LPE_Improvements|the section about LPE updates]].


[[File:PowerPencil-smaller.gif]]

=== Selection Tool === 

==== On-Canvas Alignment <span id="on-canvas-align"></span>==== 


When the option "Enable on-canvas alignment" is active in the "Align and Distribute" dialog, a new set of handles will appear on canvas when an object is clicked three times (first click: scale handles, second click: rotation/skew handles).


The handles can be used to align the selected objects relative to the area of the current selection.


* <kbd>Shift + click</kbd> on the outer handles aligns on the outside of the selection area.
* Clicking on the central handle will align the selected objects on the horizontal axis. On <kbd>Shift + click</kbd> objects will be aligned on the vertical axis.
* With <kbd>Ctrl + Shift </kbd> the whole selection can be aligned to its outer boundaries / corners as a group (i.e. it is moved by its own <code>width</code> and / or <code>height</code>).


[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool === 

==== More Compact Tool Controls Bar ====

* Some control buttons that have been mutually exclusive (e.g. right-aligned, left-aligned, justified) have been combined into drop-down lists, so they now take up less space.
* Removed the 'Show style of outermost text element' button that made settings confusing.

[[File:Text Tool controls1.0.png|800px]]


==== Better Line Height Settings <span id="line-height></span>====

* Line spacing settings got an overhaul and are now much easier to use. Gone is the unwieldy <code>?</code> button; this is now handled by selecting text on canvas.
* Setting line height works like this now:
** For the whole text: click anywhere into the text without selecting anything, then adjust the line height in the tool controls bar.
** For a specific line: select the text in that line, then adjust the line height in the tool controls bar.
** Set the global line height first, and the specific line heights last. Changing global line height later will remove any line-specific line-heights (even just changing the unit will unset those).
** Line heights for single selected lines cannot go below the height set globally.
** If more than one line is selected, the line height in between those lines can go below the line height set for the whole text.
* The line height settings work in all three text types.

==== Improved Text Selection ==== 


When clicking on a text object, any click within the whole area of the text's bounding box now selects the text (with both selection and text tool).

==== Variable Font Support <span id="variable-fonts"></span>==== 


If Inkscape has been compiled with a Pango library version that is at least 1.41.1, it comes with [[Variable Fonts support | support for variable fonts]] ([https://www.patreon.com/posts/font-variations-17644963 more info about how this looks]. These are fonts that do not come with different faces, but often with various sliding scales for different font properties, like 'boldness', or 'condensing', or even playful features.

==== Basic Support for SVG in OpenType ==== 


Some OpenType fonts with glyphs saved as SVG render now in Inkscape.


<gallery>
File:Variable fonts Decovar.png|''Variable font - both texts use the same font (Decovar)''|alt=Variable font - both texts use the same font (Decovar)
File:SVG in OpenType.png|''SVG Color font (Gilbert Color)''|alt=SVG Color font (Gilbert Color)
</gallery>

==== Browser-compatible flowed text <span id="flowed-text"></span>==== 


[needs pictures]


'''Flowed text''' (created by clicking and dragging a text frame) in previous Inkscape versions was not compatible with browsers, and rendered as 'black boxes' in web browsers and other SVG viewers, or was just missing.

The old flowed text can still be enabled by unchecking <code>Edit → Preferences → Tools → Text: Use SVG2 auto-flowed text</code>.


Now, Inkscape offers to use '''two new types of flowed text''', that have a compatible fallback for use with modern web browsers:


# '''SVG 2 text using the CSS <code>shape-inside</code> property:''' This new flowed text automatically '''includes a fallback option''' (in SVG 1.1), and will show up in web browsers and other software. This type of text can be created by '''clicking and dragging a box''' on canvas, '''if the option 'Use SVG 2 auto-flowed text' is enabled''' in the Text tool's preferences. When the option is enabled, it will also be used for <code>Text → Flow into frame</code> [unconfirmed].
# '''SVG 2 text with <code>inline-size</code> property:''' This is the new "Column mode" of the text tool, that can be created by clicking on the canvas, typing, and then dragging the diamond-shaped handle at the end of the text to determine the width of the text. It creates flowed text columns without a predetermined height. These texts include an SVG 1.1 fallback, too. To convert the text back to SVG 1.1 text, <kbd>Ctrl-click</kbd> on the diamond (this will result in all the text being placed on a single line).


The fallback option can be disabled in <code>Edit → Preferences → Input/Output → SVG export: SVG 2: Insert SVG 1.1 fallback in text</code>.

==== SVG 2 Text Support in Detail ==== 


Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating.


There are several types of SVG 2 text:

===== Multi-line text via the CSS 'white-space' property ===== 


The CSS property [https://developer.mozilla.org/en-US/docs/Web/CSS/white-space 'white-space'] controls how white space is handled. By default, SVG collapses all adjacent white-space including newlines into a single space. By setting the <code>white-space</code> value to <code>pre</code>, <code>pre-line</code>, or <code>pre-wrap</code>, Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the <code>white-space</code> property value. (Supported by Firefox. No SVG 1.1 fallback created by Inkscape.)

===== Multi-line text via the CSS 'inline-size' property ===== 


The CSS property <code>inline-size</code> defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. This text type has an SVG 1.1 fallback, that is included by default.

===== Multi-line text via the CSS 'shape-inside' property ===== 


The CSS property <code>shape-inside</code> allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS <code>shape-subtract</code>, <code>shape-margin</code>, and <code>shape-padding</code> properties.


Multi-line text via the <code>shape-inside</code> property is a direct replacement for SVG 1.2 flowed text. SVG 1.2 never became a final W3C standard and only the Batik SVG renderer besides Inkscape provided any support for SVG 1.2 flowed text. SVG 2 is not yet a final W3C standard but SVG 2 flowed text has one very important advantage over SVG 1.2 flowed text in that it is easy to structure the SVG 2 text such that it will be rendered (almost) correctly by an SVG 1.1 renderer. This means that browsers which do not support SVG 2 text will still render the text.

One disadvantage of using SVG 2 text is that it will not be editable as multi-line text in Inkscape 0.92 (it will still be editable as single lines of text).

== Clipping / Masking == 


Clip paths and masks now have an inverse mode in the menu, using the PowerClip and PowerMask LPEs.


[[File:Inverse clip 400.gif]]

== Filters == 


The size of the filter region can now be adjusted by dragging on two new diamond-shaped nodes with the node tool. This is especially useful for blur filters, whose area has been affected by a transformation of the filtered object.


[[File:Filter region.gif]]

== Live Path Effects == 

=== General === 


Live Path Effects received a major overhaul, with lots of improvements and new features. The main changes are:


* '''New LPE selection dialog'''<span id="lpe-dialog"></span>: the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, to switch between list and tile view, to display info about the selected effect and to apply it. Several additional, experimental path effects are available after the corresponding switch has been activated.
* '''Set default parameters''': default values for any LPE can be set in the respective LPE's dialogue, when it is applied to an object
(''Note: we have the 'multiple desktop preferences' problem here: If you have multiple Inkscape windows open, the last one will determine what will be saved to the preferences file, as preferences changes are only saved when Inkscape is closed, and the settings are only loaded from file when a new window is opened.'')
* '''Clip and Mask''': improved handling
* '''Fix multiple LPE BBox''': a problem with the size of the bounding box when applying multiple LPEs to an object has been fixed. Sometimes you need to add a intermediate LPE bounding box between.
* '''Knots on shapes''': show edit knots in LPE shapes
* '''Switch knots''': change the handles to the correct LPE handles when one selects an LPE in the list of active LPEs for the selected object.


<gallery>
File:LPE set defaults.png|''Set default values for Mirror LPE''|alt=Set default values for Mirror LPE
File:Add LPE dialog.png|''New LPE selection dialog''|alt=New LPE selection dialog
</gallery>

=== New Live Path Effects <span id="lpes></span>=== 

==== Boolean Operations LPE ==== 


The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. That way, two paths can be combined to a single shape, and both are still editable:
# Start with two paths. Groups, Rectangles, or other objects are also okay.
# Copy the second path into the clipboard (<code>Edit → Copy</code>).
# Select the first path and add the boolean LPE (<code>Path → Path Effects → Add path effect (Plus) → Boolean</code>).
# Link the second path to the LPE by clicking on <code>Operand Path - Link to path in clipboard</code>.

Available options:


* union
* symmetric difference
* intersection
* division
* difference

* cut


<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

==== Dashed Stroke LPE ==== 


This new LPE creates uniformly dashed paths, optionally by subdividing the path's segments, or including dashes that are symmetrically wrapped around corners.


<gallery>
File:Dash stroke LPE.png|''Rectangles with dashed stroke LPE with various settings''|alt=Rectangles with dash stroke LPE with various settings
</gallery>


[https://archive.org/details/dash-stroke-lpe Demo Video]

==== Ellipse from Points ==== 


This new LPE creates an optimally fitted ellipse from a path's nodes.


In contrast to the already existing LPE "Ellipse by 5 points" this LPE is more flexible (since, depending on the number of points available, it can fit both circles and ellipses) and has more features. Technical illustrators in particular can benefit from these features.


See [[LPE:_Ellipse_from_Points]] for a documentation.


<gallery>
File:Ellipse from points LPE.png|''Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)''|alt=Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)
</gallery>


==== Corners (Fillet/Chamfer) LPE ==== 


This new LPE adds fillet and chamfer to paths. Also adds a new internal class that allows to handle extra info per node, the LPE itself is an example of use the new classes.


[https://www.youtube.com/watch?v=wJKzGhJULfc Demo video]


<gallery>
File:Chamfer lpe.png|''Chamfer with LPE''|alt=Chamfer by LPE
File:Chamfer with steps.png|''Chamfer with 2 steps''|alt=Chamfer with 2 steps
File:Inverse chamfer with steps.png|''Inverse Chamfer with 2 steps''|alt=Inverse Chamfer with 2 steps
File:Fillet lpe.png|''Fillet with LPE''|alt=Fillet with LPE
File:Inverse fillet lpe.png|''Inverse fillet with LPE''|alt=Inverse fillet with LPE
</gallery>

==== Measure Segments LPE ==== 


This new path effect adds DIN and custom style measuring lines to "straight" segments in a path.


[https://www.youtube.com/watch?v=ppgt2GPm1IY Demo video]


<gallery>
File:Measure segment LPE.png|''Measure Segments LPE''|alt=Measure Segments LPE
</gallery>

==== Offset ==== 


Use this to add an offset to your paths, shapes and groups. Compared with the 'Dynamic Offset' available from the menu, this allows you to:


* define the offset distance numerically, e.g. to offset an object by 3 mm.
* keep sharp corners sharp (or to make them round, or beveled, if you want to), by using different methods for calculating the corners.

==== Power Clip and Power Mask ==== 


This new LPE adds options to clips and masks.

=== New Experimental LPEs === 

==== Angle Bisector ==== 


Draws a line that halves the angle between the first three nodes of the path.

==== Circle by 3 points ==== 


Draws a circle whose circumference passes through the first three nodes of the path.

==== Circle (by center and radius) ==== 


Draws a circle where the first node of the path is the center, and the last node determines the radius.

==== Extrude ==== 


Extrudes the path, creating a face for each path segment.

==== Line segment ==== 


Draws a straight line that connects the first and last node of the path.

==== Parallel ==== 


Creates a draggable line that will always be parallel to a two-node path.

==== Perpendicular Bisector ==== 


Draws a perpendicular line in the middle of the (imaginary) line that connects the start and end nodes.

==== Tangent to Curve ==== 


Draws a tangent with variable length and an additional angle that can be moved along the path.


<gallery>
File:New experimental lpes.png|''New experimental Live Path Effects (overview)''|alt=New experimental Live Path Effects
</gallery>

=== Improved LPEs === 

==== BSPline and Spiro ==== 


Improvements in Pen/Pencil mode. With <kbd>Alt</kbd>, you can move the previous node.

==== Clone Original ==== 


This path effect now allows various objects instead of only paths and is even more powerful.


[https://www.youtube.com/watch?v=JAJAxKNY8lA Demo Video]


[https://ia601501.us.archive.org/34/items/00003303/0000-3303.ogv Demo Video]

==== Fill Between Many / Fill Between Strokes LPE ==== 


New options added:


* Fuse coincident points: [describe]
* Join subpaths: fill each path separately / connect all the fills
* Close: close the fill path that is created, so it can have a stroke on all sides
* LPEs on linked: take the applied live path effects of the filled paths into account (Fill Between Many only)


<gallery>
File:Fill between many new options.png|''New options for the Fill Between Many LPE''|alt=New options for the Fill Between Many LPE
</gallery>

==== Knot LPE ==== 


New options added:


* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Both gaps: interrupt both paths at a crossing

==== Mirror Symmetry and Rotate Copies LPE ==== 


* Split feature: This new feature allows custom styles for each part of the resulting drawing without unlinking the LPE. [https://www.youtube.com/watch?v=mIzrQ2lpzuw Demo Video]
* The LPE display now updates accordingly when there are objects added or removed.


<gallery>
File:Rotate copies LPE with style split.png|''Separate styles for rotated copies''|alt=Separate styles for rotated copies
</gallery>

==== PowerStroke LPE Improvements ==== 


* '''Width scale''' setting added: adjust the overall width of the stroke after it has been drawn.
* '''Closed paths''': PowerStroke now works much better on closed paths.

== Import / Export == 

=== Linking and embedding SVG files === 


On import of an SVG file, there is now a dialog that asks if the user would like to link to the SVG file, to embed it (base64 encoded) into an <code><img></code> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).


The dpi value for displaying embedded SVG files can be set in the import dialog or changed in the object properties dialog.


This makes importing SVG files work (almost) the same as importing raster images.


The 'Embed' and 'Extract' options in the context menu for linked SVG files work the same as they do for raster images. The 'Edit externally' option will open the linked SVG file with Inkscape per default. This setting can be changed in the preferences' 'Imported Images' section.


The displaying of the dialogue can be disabled by checking the 'Don’t ask me again' option.


Linked and embedded SVG images are displayed as their raster representations.

=== Mesh Gradient Polyfill === 


SVG files that include a mesh gradient now automatically include a Javascript polyfill that allows the mesh gradient to display correctly in web browsers.

=== SVG 1.1 compatibility === 


[Fill in: check box in Save as dialog, options in <code>Edit → Preferences → Input/Output → SVG Export</code>]

=== Export PNG images <span id="png-export"></span>=== 


The export dialog has received several new options which are available when you expand the 'Advanced' section.


* Enable interlacing (ADAM7): when loading images, they will be displayed faster
* Bit depth: set the number of bits that code for the color of a pixel, supports grayscale and up to 16-bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of anti-aliasing or disable it
* The option for "Cairo PNG" has been removed from the "Save as" dialog, as it was often confused with the "Export PNG image" option, but only supported a small subset of PNG rendering features.


<gallery>
File:Png-export-options 1.0.png|''PNG export options''|alt=PNG export options
File:Bit depth options 1.0.png|''PNG bit depth options''|alt=PNG bit depth options
File:Compression options 1.0.png|''PNG compression options''|alt=PNG compression options
File:Antialiasing options 1.0.png|''PNG antialiasing options''|alt=PNG antialiasing options
</gallery>

=== PDF Export === 


* External links in the SVG file are now kept when the file is exported to pdf (requires Cairo in version 1.15.4 or higher).
* Some Inkscape file metadata (<code>File → Document properties : Metadata</code>) are now exported to PDF (title, subject, creator, keywords).

=== (E)PS Export === 


* The title and copyright ('rights') info from the document's metadata is now exported to (E)PS.

=== OpenClipart Import === 


The dialog and settings for importing images from OpenClipart have been removed due to openclipart.org being non-functional since mid-April with no information about a return date.

== Extensions == 

=== Extension dialogs === 


Extensions can now have clickable links, images, a better layout with separators and indentation, multiline text fields, file chooser fields and more. For detailed info for development see the [[Release_notes/1.0#For_extension_writers|developer section]] above.

=== Export Layer Slices === 
<code>Extensions → Export → Export Layer Slices</code>


The new 'Export Layer Slices' extension allows you to export PNG "slices" from your image by creating a new layer and drawing rectangles to denote the area of the export.


If you create a layer (default name "slices") with rectangles in it, this extension will export a PNG file for each rectangle into the directory with the name of the {rectangle ID}.png (use Object Properties to set this).


If the export already exists, it will skip it and color the rectangle GREY. If the "Overwrite existing exports" checkbox is selected, and the file was previously generated, it will color the rectangle RED. For new exports that did not previously exist, the rectangle will be GREEN.


If you want to create (square) icons at different sizes, select "Icon mode". Icon mode will create a square export for each dimension in "Sizes".

=== Frame === 
<code>Extensions → Render → Frame</code>


This new extension will add a rectangular frame with a specified stroke width, and specified stroke and fill colors to each object in the selection. Optionally, corners can be rounded, and the frame can be positioned inside or outside the selection. The result can be grouped with the frame, and the object can be clipped to the size of the frame (for further editing).

=== Hershey Text === 
<code>Extensions → Text → Hershey Text</code>


The "Hershey Text" extension, a utility for replacing text by stroke-based paths, has been rewritten.
The most significant improvements are:


* The new version converts all or only the selected text objects in place. This means that it is possible to convert text with paragraphs and to convert multiple text objects at once.
* It now uses '''SVG fonts'''. This means that:
** It is now possible to easily add and use '''custom stroke fonts'''.
** '''Unicode characters''' are now supported.
** Stroke fonts now support '''arbitrary curves''' rather than only straight segments.
* '''Improved font selection''' with basic international characters
* Automated '''font-mapping''': each text will be converted to the available Hershey font with the same font file name (e.g. 'Fancy Font.svg') as the current font (e.g. 'Fancy Font'), if one is available to the extension. The automated mapping overrides any other Hershey font settings.
* An option to '''generate font samples''' in all available SVG fonts is available.
* An '''extensive help text''' is built into the extension.
* Hershey Text is now located in the ''Extensions → Text'' sub-menu.

=== Interactive Mockup === 
<code>Extensions → Web → Interactive Mockup</code>


The new Interactive Mockup extension is intended for use by UI/UX designers. It can help to visualize mockups and create user flows to make interactive demos for approvals.


To use it, select two or more objects: the first one(s) will be the active one (button, area, image, link…), and the last selected will be the element that should be displayed after activation.


Apply the extension, then save as SVG and open it in a browser for demonstrating the mockup to potential users.

=== Meshgradient to Path / Path to Meshgradient === 
<code>Extensions → Modify Path → Mesh → Meshgradient to Path / Path to Meshgradient</code>


A set of two extensions that convert mesh gradient geometry to paths and back.

=== Plot extension === 
<code>Extensions → Export → Plot</code>


The new option 'Convert objects to paths' will take care of converting everything to a path non-destructively before the data is sent to the plotter. [''gives wrong error message, maybe not working? https://gitlab.com/inkscape/inkscape/commit/dd3b6aa099175e2244e1e04dde45bf21a966425e#note_100908512'']

=== QR Code === 
<code>Extensions → Render → Barcode → QR Code</code>


Options for choosing the shape of single QR code dots were added.


<gallery>
File:Barcode extension 1.0.png|''Barcode extension with new options for dot shape at the bottom''|alt=Barcode extension with new options for dot shape at the bottom
File:Hershey font table.png|''Hershey font table (with non-ASCII characters)''|alt=Hershey font table (with non-ASCII characters)
</gallery>

== Palettes == 


* The Munsell palette, the Bootstrap 5 palette and the palette for the new GNOME Human Interface Guidelines (GNOME HIG) have been added to Inkscape's set of stock palettes.
* Users can now also drag the <code>none</code> color field from the palette bar at the bottom onto objects to set their color to <code>none</code>.


<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
File:Bootstrap 5 palette.png|''Bootstrap 5 palette''|Bootstrap 5 palette
File:Gnome HIG palette.png|''GNOME HIG palette''|alt=GNOME HIG palette
</gallery>

== Templates == 


* The '''Desktop''' template has new options for 4k, 5k, and 8k screens.
* Some new page sizes were added to the '''(Blank) Page''' template.
* New: template for an '''A4 3-fold roll flyer'''
* New: template for '''Envelope''' with 2 standard envelope formats


<gallery>
File:Desktop templates.png|''New template options for 'Desktop' template''|alt=New template options for 'Desktop' template
File:A4 3fold roll template.png|''New A4 3-fold roll flyer template''|alt=New A4 3-fold roll flyer template
</gallery>

== SVG and CSS == 


* '''Dashes''': Inkscape can now load and display files with dashes and/or dash offsets defined in units other than the unitless user unit (e.g. <code>%</code>, <code>mm</code>) correctly. There is no user interface for editing these values currently, except for the XML editor. Values for <code>stroke-dasharray</code> that are entered in other units (except for <code>%</code>) will be converted to user units when the new values are set.


* '''Blend modes''' applied via Layers and Objects dialog no longer use SVG filters, but CSS blend modes. These can be exported to PDF without rasterization. An additional option ("Isolate") allows you to <code><span style="color: red;">[... fill me in]</span></code>.


* '''Hairlines''' can now be rendered in Inkscape. There is currently no user interface for adding them yet, though. Hairlines can be specified by adding <code>stroke-width:1px; stroke-width: -ink-hairline; vector-effect:non-scaling-stroke;</code> into the <code><style></code> tag of the object via the XML editor or the Style dialog. Hairlines will be exported to PNG correctly. Export to PDF requires that the Cairo library that your Inkscape program was compiled with contains the additional code from https://gitlab.freedesktop.org/cairo/cairo/merge_requests/21 (as of Oct. 26, 2019, there's no official Cairo version available yet that contains the patch).

== Dialogs == 

=== Arrange === 
<code>Object → Arrange</code>


The 'Polar coordinates' functionality now arranges objects clockwise (in selection order) around the circle/ellipse. This should better correspond to user expectations.

=== Document Properties === 
<code>File → Document Properties</code>


* When resizing the page, the page margin fields can now be '''locked''', so the same value will be used for all margins, but only needs to be entered once.
* The guides panel now has controls to lock or unlock all guides, create guides around the page, and delete all guides. These actions also appear on the Edit menu, making it possible to assign custom keyboard shortcuts.
* '''Grids can now be aligned''' to the corners, edge midpoints, or centre of the page with a button click in the grids panel.
* Checkerboard patterns can now have a color (pending issue with updating the view: https://gitlab.com/inkscape/inkscape/issues/101#note_148034598). This color will also be used as a (non-checkered) background for PNG export.
* A set of new page formats for different Video resolutions (SD/PAL, SD-Widescreen/PAL, SD/NTSC, SD-Widescreen/NTSC, HD 720p, HD 1080p, DCI 2k (Full Frame), UHD 4k, DCI 4k (Full Frame), UHD 8k) has been added.


<gallery>
File:Lock margins doc props.png|''Lock to set same margins for page resizing''|alt=Lock to set same margins for page resizing
File:New guide options doc props.png|''Document properties: Toggle guide lock for document, create page border guides, remove all guides''|alt=Document properties: Toggle guide lock for document, create page border guides, remove all guides
File:Grid alignment doc props.png|''Grid alignment options in document properties''|alt=Grid alignment options in document properties
File:Colorful checkerboard.png|''Checkerboard background with color''|alt=Checkerboard background with color
</gallery>

=== Fill and Stroke === 
<code>Object → Fill and stroke</code>


* The RGBA code entry field now also accepts values like <code>#123</code> and autocompletes them to <code>#112233</code>, automatically removes hash signs in pasted codes, and keeps the old alpha value if the pasted code does not contain any.
* The blur slider is now scaled quadratically as you drag the slider. This makes it easier to apply and adjust smaller blur values.



=== Filter Editor === 
<code>Filters → Filter Editor</code>


The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects === 
<code>Object → Objects</code>


The context (right-click) menu now also contains an entry for '''deleting''' the selected object.

=== Paint Servers === 
<code>Object → Paint Servers</code>


* New dialog that allows you to see a list of patterns and SVG2 hatch fills used in the current document and to assign those to objects. The hatch fills can be modified by their handles on canvas.

=== Preferences === 
<code>Edit → Preferences</code>


* The '''Bitmaps''' subsection has been renamed to '''Imported Images''', as it now applies to both imported (embedded or linked) raster images as well as to imported (embedded or linked) SVG images (i.e. to everything in <code><img></code> tags).
* The '''System''' subsection lists more relevant folders and offers buttons to open those folders with the system's file browser. This makes it easier to find the correct folder, e.g. for resetting the preferences or for adding an extension or a new icon set.
* The '''System''' subsection now has a button for quickly resetting all Inkscape preferences, which also automatically creates a backup of the current preferences.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at <code>Behaviour → Dashes</code>. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in <code>Edit → Preferences → Input/Output → Autosave: Autosave directory</code>).
* The setting for '''Handle size''' has been moved from '''Input devices''' to '''Interface''' to make it more discoverable.


<gallery>
File:Open folders from preferences.png|''Important folders can be opened from the preferences''|alt=Important folders can be opened from the preferences
</gallery>

=== Selection Sets [Hidden]===

[Adjust info according to decision made in https://gitlab.com/inkscape/inkscape/-/merge_requests/1665#note_317458802]

=== Selectors and CSS [Experimental]=== 


* New dialog for adding classes and CSS styles to elements of the drawing
* Currently in experimental status, thus hidden from the menu (<code>Edit → Selectors and CSS</code>)
* Keyboard shortcut <kbd>Ctrl+Shift+Q</kbd> can be used to open the dialog
* Among the [https://gitlab.com/groups/inkscape/-/issues?scope=all&utf8=%E2%9C%93&state=all&search=Selectors known issues], there are a couple crashes, which is the reason why the dialog has been disabled for the 1.0 release.


[Needs screenshot]

=== Symbols <span id="symbols"></span> === 
<code>Object → Symbols</code>


The Symbols dialog can now handle a lot of symbols without delay on startup, and also allows searching. Symbols and symbol sets are now displayed in alphabetical order.


<gallery>
File:Symbols list.png|''Symbol sets ordered alphabetically''|alt=Symbol sets ordered alphabetically
File:Symbols search.png|''Searching for symbols''|alt=Searching for symbols
</gallery>

=== Trace Bitmap <span id="centerline"></span>=== 
<code>Path → Trace Bitmap</code>


A new, unified dialog for vectorizing raster graphics is now available from '''Path → Trace Bitmap'''. It contains the previously separate '''Trace pixelart''' dialog and comes with a new option for centerline tracing.

[needs image]

=== Unicode Characters === 


* The ''''Glyphs' dialog''' has been '''renamed to 'Unicode Characters''''.
* The characters in the dialog's character list now '''use the selected font'''.
* Each character now has a '''tooltip''' that shows a larger version of the character, so one can more easily find the correct character.


<gallery>
File:Unicode character dialog.png|''Unicode characters dialog with large tooltip''|alt=Unicode characters dialog with large tooltip
</gallery>

=== XML Editor === 
<code>Edit → XML Editor</code>


The side of the editor that allows one to set, edit or delete attributes can now be panned both horizontally and vertically, or be hidden entirely. Long items can more easily be edited in a little popup dialog.


<gallery>
File:Xml_editor_popup.png|''XML Editor with editing popup''|alt=XML Editor with editing popup
</gallery>

== Menus == 


* New option to "Unlink clones recursively" added into sub-menu at "Edit → Clone"

== Customization <span id="customization"></span>== 

=== Customize many files in the share folder === 


Many files in <code>/share</code> can be over-ridden by placing files in the user's configuration folder (e.g. <code>~/.config/inkscape</code>).
Configurable contents now includes extensions, filters, fonts, gradients, icons, keyboard shortcuts, [preset markers (not yet: [https://gitlab.com/inkscape/inbox/issues/1400 bug #1400])], [user paint servers (SVG hatches, patterns (currently [https://gitlab.com/inkscape/inbox/issues/1620 crashes paint servers dialog], ...)], palettes, about screen, symbol sets, templates, tutorials and some user interface configuration files. Only the file 'units.xml' cannot be overridden.

=== Fonts === 

==== Load additional fonts ==== 


Inkscape can now load fonts that are not installed on the system. By default Inkscape will load additional fonts from Inkscape's share folder (<code>/share/inkscape/fonts</code>) and the user's configuration folder (<code>~/.config/inkscape/fonts</code>). Custom folders can be set in preferences (see <code>Tools → Text → Additional font directories</code>).


<gallery>
File:Custom font folders.png|''Set custom font folders''|alt=Set custom font folders
</gallery>

=== Keyboard shortcuts === 


* Allow to use "Super", "Hyper" and "Meta" modifier keys
* Improve shortcut handling code. This should fix a lot of issues and allow the use of many shortcuts which were inaccessible before, especially on non-English keyboard layouts.
* The Keyboard shortcut editor now issues a warning when the entered shortcut is already in use.
* It is now possible to assign keyboard shortcuts that align an object to the top-left, top-right, bottom-left or bottom-right corners of the anchor (determined via the 'relative to:' field), or to align the objects' top-left, top-right, bottom-left or bottom-right corners with the opposite corner of the anchor.

=== User interface customization === 


* Inkscape is starting to use glade files for its dialogues, so they can be reconfigured by users. Only one is currently supported (filter editor).
* The contents of the menus can be configured by customising the <code>menus.xml</code> file.
* Toolbar contents for the command bar (<code>commands-toolbar.ui</code>), the snap bar (<code>snap-toolbar.ui</code>), the tool controls bars for each tool (<code>select-toolbar.ui</code>), the toolbox (<code>tool-toolbar.ui</code>) is now configurable.
* The interface colors and some more UI styles can be customized in <code><preferences folder>/ui/style.css</code> (very raw theming support).

=== Theme selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, users can set a custom GTK3 theme for Inkscape. If the theme comes with a dark variant, activating the 'Use dark theme' checkbox will result in the dark variant being used. The new theme will be applied immediately.


New themes can be installed on your system to be made available in the list to choose from. A large selection of (more or less current) GTK3 themes are available for download at [https://www.gnome-look.org/browse/cat/135/ord/top/ gnome-look.org] . On Windows, the new themes can be placed in <code><var>%AppData%</var>\Local\themes\</code>, so that the full path to the theme's CSS files will be <code><var>%AppData%</var>\Local\themes\<theme name>\gtk-3.0\</code>.

=== Icon set selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, the icon set to use can be selected. By default, Inkscape comes with 'hicolor', 'Tango', and the new 'Multicolor' icons. In addition to this, it offers to use the system's icons.


The symbolic icon set that is part of the 'hicolor' icon set as well as the new Multicolor icons can be colorized with custom colors.


<gallery>
File:Tango icons.png|''Light theme with Tango icon set''|alt=Light theme and Tango icon set
File:Hicolor icons.png|''Light theme with hicolor icon set''|alt=Light theme and hicolor icon set
File:Dark with symbolic icons.png|''Dark theme with symbolic icon set''|alt=Dark theme and symbolic icon set
File:Dark symbolic custom color.png|''Dark theme with symbolic icon set and a custom icon color''|alt=Dark theme with custom colored symbolic icon set
File:Multicolor icon set.png|''New Multicolor icon set on dark theme''|alt=New Multicolor icon set on dark theme

</gallery>

=== Saving the current file as template === 


A new entry for saving the current file as a template has been added to the 'File' menu. You need to specify a name for it, and optionally, you can add the template's author, a description and some keywords. A checkbox allows you to set the new template as the default template.


<gallery>
File:Save as templage.png|''Save current file as a template''|alt=Save current file as a template
</gallery>

=== Custom page sizes in Document Properties === 


Inkscape now creates a CSV file (comma separated values) called <code>pages.csv</code>. It is located in your Inkscape user preferences folder, next to your <code>preferences.xml</code> file. This file contains the default page sizes that you can choose from in the 'Page' tab of the 'Document properties' dialog. You can edit the <code>pages.csv</code> file to remove the page sizes you won't use, or to add new ones.

== Command Line == 


The Inkscape command line has undergone a major overhaul with the goal of making it more powerful and flexible for the user and easier to enhance for the developer. The most important changes are:


* Each command-line argument can now be used only once. To specify multiple ''actions'' (''verbs''), use semicolons (e.g. <code>--actions='ObjectFlipVertically;FileSave;FileClose'</code>).
* Many ''actions'' can now take arguments (separated from the ''action'' name by a colon.
* [[Using xverbs|xverbs]] have been removed from Inkscape (command line commands that take parameters from a file, e.g. for saving the selection under a specified filename as SVG file) ([https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/33487d06-e3c1-a4e5-1496-7b370d672d2f%40gmail.com/#msg35392523 mailing list thread]).
* Files can also be saved as Inkscape SVG without calling the GUI save dialog (new command: <code>--export-inkscape-svg</code>)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: <code>--export-id</code>.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: <code>--pdf-page <var>N</var></code>).
* For importing a PDF, the option to import via poppler is now available for the command line as <code>pdf-poppler</code>.
* New verb allows one to swap fill and stroke style from the command line: <code>EditSwapFillStroke</code> (a keyboard shortcut can now be assigned to it) ([https://bugs.launchpad.net/inkscape/+bug/675690 bug 675690])
* The shell mode syntax has changed, too.
* The file name can now be specified with <code>--export-filename</code>
* The command <code>-x</code> / <code>--extension-directory</code> has been removed. Replaced with: <code>--system-data-directory</code> and <code>--user-data-directory</code>.


More information about usage and how to update your commands can be found at [[Using the Command Line]].

== Tutorials / Documentation == 


* Some small updates were made to tutorial texts
* Tutorial files got a new header / footer design, using [https://inkscape.org/~esteban/%E2%98%85inksscreen-10-by-esteban-capella Esteban Capella's entry] for our About Screen Contest.

== Translations [as of 2019-12-18] == 


Translations were updated for:


* Basque
* British English
* Brazilian Portuguese
* Catalan
* Croatian
* Czech
* Dutch
* Finnish
* French
* German
* Greek
* Hindi
* Hungarian
* Icelandic
* Indonesian
* Italian
* Korean
* Latvian
* Norwegian (Bokmål)
* Polish
* Romanian
* Russian
* Slovak
* Spanish
* Swedish
* Turkish
* Ukrainian
* Urdu
* Swedish


Tutorial translations were added for:


* Korean


Translations were dropped for:


* Amharic

== Notable Bugfixes == 


* Symbols: Visio Stencils loaded from <code>.vss</code> files now use their actual name instead of a placeholder derived from the symbol file's name ([https://bugs.launchpad.net/inkscape/+bug/1676144 bug 1676144])
* Shapes on Pen and Pencil tools now retain color and width ([https://bugs.launchpad.net/inkscape/+bug/1707899 bug:1707899]).
* Text and Font dialog: The font selection no longer jumps to the top of the list when clicking Apply.
* Docked dialogs now open on their own when the corresponding functionality is called from a menu or button
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* As of Windows 10 (version 1809) fonts are installed into a new user-specific folder by default. Allow Inkscape to recognize those fonts. ([https://gitlab.com/inkscape/inkscape/issues/50 #50])
* The default Perl interpreter executable on Windows was changed from <code>perl.exe</code> to <code>wperl.exe</code> which should usually avoid flashing a console window. ([https://gitlab.com/inkscape/inkscape/issues/66 #66])
* Some printers who don't correctly recognize the page formats sent by Inkscape, printed only square excerpts of the whole image that was supposed to be printed. Now they print the whole image ([https://gitlab.com/inkscape/inkscape/merge_requests/407 Merge request]).


For an exhaustive list of bugs that have been fixed, please see the [https://launchpad.net/inkscape/1.0.x milestones page for Inkscape 1.0 on Launchpad] and the [https://gitlab.com/inkscape/inkscape/issues?scope=all&utf8=%E2%9C%93&state=closed&milestone_title=Inkscape%201.0 list of milestoned issues on GitLab].

== Breaking changes / Action required == 

=== For users === 

==== Custom Icon Sets ==== 


Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated its own file. The directory structure must follow the [https://developer.gnome.org/icon-theme-spec/ standard structure for Gnome icons].


If you would like to create or convert your own icon set to the new format, please compare the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation's 'share' directory for suitable examples and check out [[Creating a new multicolor icon theme | our guide to making a new multicolor icon theme]].


As a side effect of a bug fix to the icon preview dialog (see below), custom UI icon SVG files need to be updated to have their background color alpha channel set to 0 so that they display correctly (see Bug #[https://bugs.launchpad.net/inkscape/+bug/1661989 1661989]).

==== Third-party extensions <span id="extensions-api"></span>==== 


Most extensions that are maintained by a third-party developer (i.e. that are not an Inkscape stock extension) need to be updated to work with this version of Inkscape. Inkscape contributors have contacted many extension authors already to let them know about the upcoming changes. If your favorite third-party extension still needs to be updated to be compatible with Inkscape 1.0, please point its author to [https://wiki.inkscape.org/wiki/index.php/Release_notes/1.0#For_extension_writers the section about updating one's extension in the Wiki].

==== Dropped / Replaced Extensions ==== 


Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed, as well as some extensions that depended on third-party programs:


'''''Import extensions that have been removed:'''''



* Adobe Illustrator 8.0 and below (UC) (<code>*.ai</code>) (Workaround: rename the file extension to <code>.eps</code>. Newer versions can still be imported if they contain an embedded PDF.)
* Corel DRAW Compressed Exchange files (UC) (<code>*.ccx</code>)
* Corel DRAW 7-X4 files (UC) (<code>*.cdr</code>) (<code>*.cdr</code> in general can still be imported)
* Corel DRAW 7-13 template files (UC) (<code>*.cdt</code>)
* Computer Graphics Metafile files (UC) (<code>*.cgm</code>) 
* Corel DRAW Presentation Exchange files (UC) (<code>*.cmx</code>)
* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 
* Dia Diagram (<code>*.dia</code>) (Workaround: export as a different format from [https://wiki.gnome.org/Apps/Dia/Download Dia]) 


'''''Export extensions that have been removed:'''''


* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 


'''''Extensions that have been replaced:'''''


* <code>Render → LaTeX</code>: The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (<code>Render → LaTeX</code>) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies. It has been replaced by the extension <code>Render → Mathematics → LaTeX (pdflatex)</code> which serves the same purpose.

==== Command line changes ====

The Inkscape command line options [[#Command Line|have changed significantly (see below)]]. Any command line scripts that you have used will need to be updated for Inkscape 1.0.

=== For extension writers === 


Extensions have undergone some fundamental changes.


Inkscape's stock extensions '''have been moved to [https://gitlab.com/inkscape/extensions their own repository]''' and have been updated for compatibility with '''Python 3'''. Internally, extensions have been reorganized, many functions have been deprecated, and new functions have been added.

==== General ==== 


* <span id="python3"></span>Extensions were updated to be compatible with Python 3. While we'll be migrating away from Python 2, extension writers should aim for support of Python 2.7 and Python 3.5+ for maximum compatibility.
* Windows packages now ship with Python 3 (currently Python 3.7). Python 2 is not bundled anymore, so make sure to update your extension to be compatible.
* Inkscape now adds itself to search path on startup, so you should always be able to call it from your extension by simply calling <code>inkscape</code>, without the need to add it to search path manually, or worrying about other potentially incompatible versions of Inkscape being available on search path.
* The folder structure of Windows packages was updated: Binaries were moved from the installation root to <code>bin/</code>, Inkscape's shared files where moved from <code>share/</code> to a <code>share/inkscape</code> subfolder.
* The underscores that were previously necessary to mark elements as translatable are no longer needed. Elements that are usually translated are now by default included in translations. Elements that are usually not translated, are not included. This can be overridden by setting the <code>translatable="yes/no"</code> attribute.
* Extensions (including their <code>.inx</code> files) can now be put into a subdirectory of the <code>extensions/</code> folder to allow for better structuring and separation of extensions.

==== Extension dialogs ==== 


Extension dialogs have some new input types and layout options:


* new multiline text fields
* new file chooser fields
* new <code>appearance="url"</code> for [[INX Parameters]] of type <code>"description"</code>. You can now add clickable links to your extension UI.
* a simpler version of the color chooser field has been added
* new layout options (separator, table-like layouts)
* all [[INX Parameters]] now have the common attribute <code>indent="<var>n</var>"</code> where <code><var>n</var></code> specifies the level of indentation in the extension UI.
* new <code>label</code> parameter
* new option to include an image
* some confusing options have been merged
* new effect extension attribute <code>implements-custom-gui</code> is [http://wiki.inkscape.org/wiki/index.php/INX_extension_descriptor_format#Attributes_description available] to hide the 'Extension is working' dialog.

[needs screenshot]

==== More info ==== 


Please also note the changed [[#Command Line|command line options]], if your extension calls another instance of Inkscape.


More detailed instructions for updating old extensions are available at [[Updating your Extension for 1.0]]. Also check the [https://inkscape.gitlab.io/extensions/documentation/ extension (<code>inkex</code>) API documentation] and the [https://gitlab.com/inkscape/extensions stock extensions repository] for finding comparable extensions. If you have questions about extension development, you can join us in our [https://chat.inkscape.org/channel/inkscape_extensions extension development chat channel].

=== For packagers and those who compile Inkscape === 


* <code>autotools</code> builds have been dropped. Please use <code>CMake</code> for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* <code>libsoup</code> dependency added: we use <code>libsoup</code> for making HTTP requests without a need for <code>dbus</code> and <code>gvfs</code>.
* double-conversion [https://github.com/google/double-conversion] dependency added: <code>lib2geom</code> now depends on an external version of the library.
* Inkscape now uses a git submodule for the <code>extensions/</code> directory. If you have cloned the repository and are not building from the release source code tarball, please note the [https://inkscape.org/en/develop/getting-started/ updated build instructions]
* On Ubuntu 18.04, Gnome's fallback icon set (package 'adwaita-icon-theme-full'), that is needed to display Inkscape's default icons completely, is no longer automatically installed. It has been added as a 'recommends' level dependency.
* lib2geom: [insert up-to-date info here]
* The environment variable <code>INKSCAPE_PORTABLE_PROFILE_DIR</code> has been removed. Please use the equivalent <code>INKSCAPE_PROFILE_DIR</code> instead for changing the location of the profile directory at run time. (see also [https://gitlab.com/inkscape/inkscape/issues/114 #114])
* Inkscape extensions have been updated to work with Python 3, they no longer depend on Python 2 (but still work with it)

== Known Issues== 


[as of Sept. 7th, 2019, "beta0"]


* Various warnings printed to console output
* Slowdown and temporary freezes when opening the font list
* <code>man</code> page not entirely updated yet to account for the changes in the command line interface
* Hatch fill handles are sometimes not shown on the canvas, hatchfill changes are often not displayed (only the first time)
* <code>uniconvertor</code> not available, thus some file formats can no longer be imported
* object transformation handles do not rotate along with the canvas during canvas rotation ([https://gitlab.com/inkscape/inbox/issues/69 inbox#69])


See also: [https://gitlab.com/groups/inkscape/inkscape/issues List of confirmed and ready-to-be-worked-on issues] and [https://gitlab.com/inkscape/inbox/issues List of new user submitted issues, questions and feature requests]

== Inkview == 


'''Inkview''' (a simple SVG viewer) was considerably improved and got some new features:


* Support folders as input (will load all SVG files from the specified folder)<br/>The <code>-r</code> or <code>--recursive</code> option will even allow to search subfolders recursively.
* Implement <code>-t</code> or <code>--timer</code> option which allows to set a time after which the next file will be automatically loaded.
* Add <code>-s</code> or <code>--scale</code> option to set a factor by which to scale the displayed image.
* Add <code>-f</code> or <code>--fullscreen</code> option to launch Inkview in fullscreen mode
* Many smaller fixes and improvements

== Previous releases == 


* [[Release notes/0.92]] ([[Release_notes/0.92.1 |0.92.1]], [[Release_notes/0.92.2 |0.92.2]], [[Release_notes/0.92.3 |0.92.3]], [[Release_notes/0.92.4 |0.92.4]], [[Release_notes/0.92.5 |0.92.5]])
* [[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]]

</translate>

Release notes/1.0

2020-04-15T18:14:46Z

Zearin: Add markup to keyboard shortcut

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

<languages />

<translate>

== Inkscape 1.0 == 


'''(definitely not released yet - [[AnnouncePlanning1.0]])'''


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

== Release highlights == 


* [[#customization|Theming support and more new customization options]]
* [[#hidpi|Better HiDPI (high resolution) screen support]]
* [[#macos|Native support for macOS with a signed and notarized .dmg file]]
* [[#origin|Coordinate origin in top left corner by default]]
* [[#canvas|Canvas rotation and mirroring]]
* [[#on-canvas-align|On-Canvas alignment of objects]]
* [[#view-modes|Split view and X-Ray modes]]
* [[#powerpencil|PowerPencil for drawing editable, variable width strokes with a pressure sensitive graphics tablet]]
* [[#png-export|New PNG export options]]
* [[#centerline|Integrated centerline tracing for vectorizing line drawings]]
* [[#symbols|Searchable Symbols dialog]]
* [[#lpe-dialog|New Live Path Effect (LPE) selection dialog]]
* [[#lpes|New Corners (Fillet/chamfer) LPE, (lossless) Boolean Operation LPE, Offset LPE and Measure Segments LPE (and more!)]]
* [[#performance|Path operations, deselection of a large number of paths as well as grouping/ungrouping are much faster now]]
* [[#line-height|Much improved text line-height settings]]
* [[#variable-fonts|Variable fonts support (only if compiled with pango library version >= 1.41.1)]]
* [[#flowed-text|Browser-compatible flowed text]]
* [[#extensions-api|Extensions programming interface updated, with many new options]] - ''Note: this introduces breaking changes, some third-party extensions will have to be updated to work with Inkscape 1.0''
* [[#python3|Python 3 support for extensions]]

== General: Application == 

=== Performance <span id="performance"></span>=== 

Lots of small performance improvements in various areas combine to make Inkscape run smoother than before:

* Accelerated breaking apart of paths and Boolean operations (by disabling intermittent canvas rendering during these operations).
* Accelerated "deselect" speed (by improving internal data structure algorithms).
* Faster grouping and ungrouping of groups with a large number of objects
* Speed boost to operations on large sets of objects in the Objects dialog (Bug [https://gitlab.com/inkscape/inbox/issues/392 #392])
* Faster lookup of attributes (MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448])

=== Mac Application <span id="macos"></span>=== 


Inkscape is now a first-rate native macOS application, and no longer requires XQuartz to operate. The minimum required operating system version is OS X El Capitan 10.11.


It has a standard Mac-style menu bar (rather than a menu bar within the window). Keyboard shortcuts now use the command (<kbd>⌘</kbd>) key rather than the control key. Retina display screen resolution is now supported. The build is now cleanly 64-bit, a prerequisite for macOS Catalina 10.15 and beyond. It comes bundled with Python 3 to power Inkscape extensions.


[[File:Mac_menu_1.0_screenshot.png|665px]]

== General User Interface == 

=== Modernized GUI Toolkit=== 


The user interface has been changed to utilise a more recent version of GTK+ (GTK+ 3). This is a collection of user interface building blocks that Inkscape uses to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI (high resolution) screens.

Bringing the newer GTK+ toolkit to Inkscape has been an eagerly anticipated goal for a long time. It has taken much effort by the Team involved and it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Window position / size / behavior === 


Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
were made. The window manager handles most of the jobs now, which should make it much more robust. If you still encounter problems with this, please report those [https://inkscape.org/report to our bug tracker].

The dialog opacity options have been removed, because they were causing crashes that could not be fixed otherwise.

=== High Resolution Screens <span id="hidpi"></span> === 


Inkscape now supports HiDPI (high resolution) screens natively. This means that icons and node handles will no longer be tiny on monitors with large pixel dimensions, and the canvas will no longer look blurry.

=== Tool box === 

The tools have been reordered and grouped into more logical groups. Zoom and measure tools as well as Spray, Tweak and Eraser are now closer to the bottom. Users can customize the order of the tools by putting a customized version of the file <code>inkscape/share/ui/toolbar-tool.ui</code> into a folder named <code>ui</code> in their Inkscape user configuration folder, if they prefer a different order.

<gallery>
File:Toolbox 1.0.png|''Reordered tools in the tool box''|alt=Reordered tools in the tool box
</gallery>

=== Improved number entry fields === 


Many numeric entry fields no longer change their value when scrolling while the mouse is hovering over them. They now need to be selected (clicked into). Then scrolling will change the value as previously. This change was made, because scrolling docked dialogs easily led to accidental change of values.


Additionally, <kbd>Ctrl+Scroll</kbd> on a selected numeric entry field will now change the value in larger steps.

== Canvas == 

=== Y-Axis Inversion <span id="origin"></span>=== 


During the [https://inkscape.org/en/news/2018/09/20/inkscape-hackfest-kiel-2018-what-happened/ Inkscape Hackfest in Kiel], a significant change by Thomas Holder was integrated into the Inkscape codebase. It sets the origin of the document to the top left corner of the page. This finally makes the coordinates that a user can see in the interface match the ones that are saved in the SVG data (unit conversions/transformations may be required), and makes working in Inkscape more comfortable for people who are used to this more standard behavior. The old behavior can be reactivated in the preferences, at <code>Edit → Preferences → Interface</code> (disable 'Origin in upper left with y-axis pointing down').


<gallery>
File:Origin in upper left.png|''Option in the preferences' 'Interface' section''|alt=Option in the preferences' 'Interface' section
File:Origin in upper left page.png|''Effect of the option (left upper page corner at 0/0)''|alt=Effect of the option (left upper page corner at 0/0)
</gallery>

=== Canvas Rotation <span id="canvas"></span>=== 


With <kbd>Ctrl+Shift+Scroll wheel</kbd> the drawing area can be rotated and viewed from different angles. In the bottom right corner of the window, the viewing angle can be entered manually. Right-click to select between a set of preset values. Keyboard shortcuts for clockwise/counter-clockwise/no rotation can be set in the preferences.


[[File:Canvas rotation.gif]]

=== Canvas Mirroring === 


The canvas can now be flipped, to ensure that the drawing does not lean to one side, and looks good either way.
The vertical/horizontal flipping is available from the menu <code>View → Canvas orientation → Flip horizontally / Flip vertically</code>. Keyboard shortcuts for flipping the canvas can be set in the preferences (<code>Edit → Preferences → Interface → Keyboard shortcuts</code>).


[[File:Flip canvas 300px.gif]]

=== Pinch-to-zoom === 


On supported hardware (trackpad, touchpad, multi-touch screen), the canvas can be zoomed with the two-finger pinch gesture.

=== Duplicate Guides === 


A new option for duplicating guides was added to the 'Guideline' dialog. This new feature, when used in conjunction with the 'relative change' option (dialog needs to be opened twice), makes it easier to create guides that are offset by a certain distance / angle from an existing guide.


[[File:Duplicate guide.png]]

=== Context menu === 


The menu that appears after a right-click on the canvas has been extended with the following items, which makes locking/unlocking and hiding/unhiding individual objects much more comfortable:


* Hide selected objects
* Unhide objects below (the mouse cursor)
* Lock selected objects
* Unlock objects below (the mouse cursor)


<gallery>
File:Context menu.png|''New options in context menu''|alt=New options in context menu
</gallery>

=== Snapping === 


* In <code>Edit → Preferences → Behavior → Snapping</code>, a new option was added to '''disable snapping''' in new documents or files that are opened with Inkscape for the first time.

== View == 

=== Center view on page === 


You can now center the view on the page, without changing the zoom level.


This function is available via:


* <code>View → Zoom</code>
* the Zoom tool's tool controls bar
* Keyboard shortcut <kbd>Ctrl + 4</kbd>

=== Split View Mode <span id="view-modes"></span>=== 

The new Split View Mode features a draggable separator that becomes visible as soon as the Split view mode has been activated. On one side of the separator, the canvas will look just like before, while on the other side, everything will be displayed in outline mode, and objects can more easily be grabbed with the mouse or edited with the node tool.

It can be moved on the canvas by grabbing either the separation line or the central handle. The sides can be switched by clicking on one of the little arrows on the handle.

Activate it with one of:

* <code>View → Split View Mode</code>
* <kbd>Ctrl + 6</kbd>

To deativate the mode, either deactivate the checkbox in the menu again, use the keyboard shortcut a second time, or drag the separator off the canvas.


[[File:Split Screen-smaller.gif]]

=== X-Ray Mode ===

When the X-Ray mode is active, a circular area that shows objects on the canvas in outline mode will follow the mouse pointer. This makes editing complex drawings with many objects layered on top of one another much easier, and is especially useful when used with the node tool.

Activate it with:

* <code>View → XRay Mode</code>
* <kbd>Alt + 6</kbd>

The size of the X-Ray circle can be adjusted in <code>Edit → Preferences → Rendering → Rendering XRay radius</code>.

To deactivate the mode, either deactivate the checkbox in the menu again, or use the keyboard shortcut a second time.

[[File:XRay mode.gif]]

=== Visible Hairlines Display Mode === 


This new display mode is available in the menu under <code>View → Display Mode → Visible Hairlines</code>. It ensures that all lines of nonzero width are visible (with a minimum visible line width), regardless of zoom level, while still drawing everything else normally.


This is especially useful if you need to assign very small line widths for use with CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines. In that case, you will still be able to see the lines, even when zoomed out.


[[File:visible_hairlines.gif]]

== Paths == 

=== Changed behavior of Stroke to Path === 


The 'Stroke to Path' command now not only converts the stroke of a shape to path, but effectively splits it into its components.


In the case of applying it to a path that only has a stroke, the behavior is unchanged.


For paths that don't only have a stroke, but also a fill and/or markers, the result will be a group consisting of:
* Stroke outline turned to path
* Fill (if there was one)
* A group of all markers (if applicable; one group per marker, consisting of its outline and its fill turned into a path)


[[File:Stroke to path.gif]]

=== Unlinking Clones for Path Operations === 


Clones and Symbols are now automatically unlinked, before a Boolean operation (union, difference, etc.), or one of the Path operations 'Combine', 'Break apart', or 'Stroke to Path' is performed.


A setting in the preferences at <code>Behavior → Clones → Unlink Clones</code> allows the User to disable the automatic unlinking.

== Tools == 

=== Bézier Tool === 


The tool mode 'Create sequence of paraxial segments', which previously would only draw lines parallel to the x and y axis of the document, now supports arbitrary starting angles. After the first segment, all further angles will use the current angle ±90°. If you want your first segment to work as in previous versions, you need to press <kbd>Ctrl</kbd> after the first click. This will restrict your options to (by default) 15° steps.


<gallery>
File:Paraxial arbitrary starting angle.gif|''Arbitrary starting angle for paraxial mode''|alt=Arbitrary starting angle for paraxial mode
</gallery>

=== Calligraphy Tool === 


A new option to add dots has been added to the tool. Click in place without moving the mouse to create a dot, <kbd>Shift+Click</kbd> to create a larger dot ''[needs documentation in keyboard shortcut list, https://gitlab.com/inkscape/inkscape-docs/documentation/-/issues/1 ]''.

=== Circle Tool === 


The circle tool can now also create closed ("filleted") circle shapes (closed arcs) with the click of a button.


<gallery>
File:Circle chord.png|''Circle tool shapes in this release''|alt=Circle tool shapes in this release
</gallery>

=== Eraser === 


* Added option to control eraser width with a pressure sensitive input device.
* Added thinning, caps, and tremor options (as used for calligraphy tool).
* New option to erase as clip, which allows the User to non-destructively erase (parts of) various types of elements, including raster images and clones.


[[File:Erase with clip.gif]]

=== Measurement Tool === 


Hovering over a path with the tool now displays the length, height, width, and position of the path. If you hover over a group, it will show the width, height, and position of the group. Holding <kbd>Shift</kbd> switches to showing info about the constituents of the group.


The tool also has a new option to only measure selected objects when using click-and-drag.


<gallery>
File:Measure tool info.png|''New info text from measurement tool (for a group)''|alt=New info text from measurement tool (for a group)
File:Measure tool info group shift.png|''Measurement tool info text for a single path (in a group with Shift)''|alt=Measurement tool info text for a single path (in a group with Shift)
File:Measure selected.png|''Measuring only the selected object (the ice cap)''|alt=Measuring only the selected object (the ice cap)
</gallery>

=== Pencil Tool === 

==== PowerPencil <span id="powerpencil"></span>==== 


Pressure sensitivity can now be enabled for the Pencil tool. This feature makes use of the PowerStroke Live Path Effect (LPE).


New settings for the tool are available for tweaking the behavior of the PowerStroke LPE when it is being created with the Pencil tool (and a graphics tablet/stylus):
* '''Use pressure input''' (in the tool controls bar): activates the PowerStroke feature, if a pressure sensitive device is available.
* '''Min/Max''' (in the tool controls bar): determines the minimal and maximal stroke width (0–100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* '''Caps''' (in the tool controls bar): choose between the options 'butt', 'square', 'round', 'peak' and 'zero width' for the end caps of the stroke.
* Additionally, the PowerStroke LPE itself has been improved, to better work when used in this new way, see [[#PowerStroke_LPE_Improvements|the section about LPE updates]].


[[File:PowerPencil-smaller.gif]]

=== Selection Tool === 

==== On-Canvas Alignment <span id="on-canvas-align"></span>==== 


When the option "Enable on-canvas alignment" is active in the "Align and Distribute" dialog, a new set of handles will appear on canvas when an object is clicked three times (first click: scale handles, second click: rotation/skew handles).


The handles can be used to align the selected objects relative to the area of the current selection.


* <kbd>Shift + click</kbd> on the outer handles aligns on the outside of the selection area.
* Clicking on the central handle will align the selected objects on the horizontal axis. On <kbd>Shift + click</kbd> objects will be aligned on the vertical axis.
* With <kbd>Ctrl + Shift </kbd> the whole selection can be aligned to its outer boundaries / corners as a group (i.e. it is moved by its own <code>width</code> and / or <code>height</code>).


[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool === 

==== More Compact Tool Controls Bar ====

* Some control buttons that have been mutually exclusive (e.g. right-aligned, left-aligned, justified) have been combined into drop-down lists, so they now take up less space.
* Removed the 'Show style of outermost text element' button that made settings confusing.

[[File:Text Tool controls1.0.png|800px]]


==== Better Line Height Settings <span id="line-height></span>====

* Line spacing settings got an overhaul and are now much easier to use. Gone is the unwieldy <code>?</code> button; this is now handled by selecting text on canvas.
* Setting line height works like this now:
** For the whole text: click anywhere into the text without selecting anything, then adjust the line height in the tool controls bar.
** For a specific line: select the text in that line, then adjust the line height in the tool controls bar.
** Set the global line height first, and the specific line heights last. Changing global line height later will remove any line-specific line-heights (even just changing the unit will unset those).
** Line heights for single selected lines cannot go below the height set globally.
** If more than one line is selected, the line height in between those lines can go below the line height set for the whole text.
* The line height settings work in all three text types.

==== Improved Text Selection ==== 


When clicking on a text object, any click within the whole area of the text's bounding box now selects the text (with both selection and text tool).

==== Variable Font Support <span id="variable-fonts"></span>==== 


If Inkscape has been compiled with a Pango library version that is at least 1.41.1, it comes with [[Variable Fonts support | support for variable fonts]] ([https://www.patreon.com/posts/font-variations-17644963 more info about how this looks]. These are fonts that do not come with different faces, but often with various sliding scales for different font properties, like 'boldness', or 'condensing', or even playful features.

==== Basic Support for SVG in OpenType ==== 


Some OpenType fonts with glyphs saved as SVG render now in Inkscape.


<gallery>
File:Variable fonts Decovar.png|''Variable font - both texts use the same font (Decovar)''|alt=Variable font - both texts use the same font (Decovar)
File:SVG in OpenType.png|''SVG Color font (Gilbert Color)''|alt=SVG Color font (Gilbert Color)
</gallery>

==== Browser-compatible flowed text <span id="flowed-text"></span>==== 


[needs pictures]


'''Flowed text''' (created by clicking and dragging a text frame) in previous Inkscape versions was not compatible with browsers, and rendered as 'black boxes' in web browsers and other SVG viewers, or was just missing.

The old flowed text can still be enabled by unchecking <code>Edit → Preferences → Tools → Text: Use SVG2 auto-flowed text</code>.


Now, Inkscape offers to use '''two new types of flowed text''', that have a compatible fallback for use with modern web browsers:


# '''SVG 2 text using the CSS <code>shape-inside</code> property:''' This new flowed text automatically '''includes a fallback option''' (in SVG 1.1), and will show up in web browsers and other software. This type of text can be created by '''clicking and dragging a box''' on canvas, '''if the option 'Use SVG 2 auto-flowed text' is enabled''' in the Text tool's preferences. When the option is enabled, it will also be used for <code>Text → Flow into frame</code> [unconfirmed].
# '''SVG 2 text with <code>inline-size</code> property:''' This is the new "Column mode" of the text tool, that can be created by clicking on the canvas, typing, and then dragging the diamond-shaped handle at the end of the text to determine the width of the text. It creates flowed text columns without a predetermined height. These texts include an SVG 1.1 fallback, too. To convert the text back to SVG 1.1 text, <kbd>Ctrl-click</kbd> on the diamond (this will result in all the text being placed on a single line).


The fallback option can be disabled in <code>Edit → Preferences → Input/Output → SVG export: SVG 2: Insert SVG 1.1 fallback in text</code>.

==== SVG 2 Text Support in Detail ==== 


Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating.


There are several types of SVG 2 text:

===== Multi-line text via the CSS 'white-space' property ===== 


The CSS property [https://developer.mozilla.org/en-US/docs/Web/CSS/white-space 'white-space'] controls how white space is handled. By default, SVG collapses all adjacent white-space including newlines into a single space. By setting the <code>white-space</code> value to <code>pre</code>, <code>pre-line</code>, or <code>pre-wrap</code>, Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the <code>white-space</code> property value. (Supported by Firefox. No SVG 1.1 fallback created by Inkscape.)

===== Multi-line text via the CSS 'inline-size' property ===== 


The CSS property <code>inline-size</code> defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. This text type has an SVG 1.1 fallback, that is included by default.

===== Multi-line text via the CSS 'shape-inside' property ===== 


The CSS property <code>shape-inside</code> allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS <code>shape-subtract</code>, <code>shape-margin</code>, and <code>shape-padding</code> properties.


Multi-line text via the <code>shape-inside</code> property is a direct replacement for SVG 1.2 flowed text. SVG 1.2 never became a final W3C standard and only the Batik SVG renderer besides Inkscape provided any support for SVG 1.2 flowed text. SVG 2 is not yet a final W3C standard but SVG 2 flowed text has one very important advantage over SVG 1.2 flowed text in that it is easy to structure the SVG 2 text such that it will be rendered (almost) correctly by an SVG 1.1 renderer. This means that browsers which do not support SVG 2 text will still render the text.

One disadvantage of using SVG 2 text is that it will not be editable as multi-line text in Inkscape 0.92 (it will still be editable as single lines of text).

== Clipping / Masking == 


Clip paths and masks now have an inverse mode in the menu, using the PowerClip and PowerMask LPEs.


[[File:Inverse clip 400.gif]]

== Filters == 


The size of the filter region can now be adjusted by dragging on two new diamond-shaped nodes with the node tool. This is especially useful for blur filters, whose area has been affected by a transformation of the filtered object.


[[File:Filter region.gif]]

== Live Path Effects == 

=== General === 


Live Path Effects received a major overhaul, with lots of improvements and new features. The main changes are:


* '''New LPE selection dialog'''<span id="lpe-dialog"></span>: the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, to switch between list and tile view, to display info about the selected effect and to apply it. Several additional, experimental path effects are available after the corresponding switch has been activated.
* '''Set default parameters''': default values for any LPE can be set in the respective LPE's dialogue, when it is applied to an object
(''Note: we have the 'multiple desktop preferences' problem here: If you have multiple Inkscape windows open, the last one will determine what will be saved to the preferences file, as preferences changes are only saved when Inkscape is closed, and the settings are only loaded from file when a new window is opened.'')
* '''Clip and Mask''': improved handling
* '''Fix multiple LPE BBox''': a problem with the size of the bounding box when applying multiple LPEs to an object has been fixed. Sometimes you need to add a intermediate LPE bounding box between.
* '''Knots on shapes''': show edit knots in LPE shapes
* '''Switch knots''': change the handles to the correct LPE handles when one selects an LPE in the list of active LPEs for the selected object.


<gallery>
File:LPE set defaults.png|''Set default values for Mirror LPE''|alt=Set default values for Mirror LPE
File:Add LPE dialog.png|''New LPE selection dialog''|alt=New LPE selection dialog
</gallery>

=== New Live Path Effects <span id="lpes></span>=== 

==== Boolean Operations LPE ==== 


The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. That way, two paths can be combined to a single shape, and both are still editable:
# Start with two paths. Groups, Rectangles, or other objects are also okay.
# Copy the second path into the clipboard (<code>Edit → Copy</code>).
# Select the first path and add the boolean LPE (<code>Path → Path Effects → Add path effect (Plus) → Boolean</code>).
# Link the second path to the LPE by clicking on <code>Operand Path - Link to path in clipboard</code>.

Available options:


* union
* symmetric difference
* intersection
* division
* difference

* cut


<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

==== Dashed Stroke LPE ==== 


This new LPE creates uniformly dashed paths, optionally by subdividing the path's segments, or including dashes that are symmetrically wrapped around corners.


<gallery>
File:Dash stroke LPE.png|''Rectangles with dashed stroke LPE with various settings''|alt=Rectangles with dash stroke LPE with various settings
</gallery>


[https://archive.org/details/dash-stroke-lpe Demo Video]

==== Ellipse from Points ==== 


This new LPE creates an optimally fitted ellipse from a path's nodes.


In contrast to the already existing LPE "Ellipse by 5 points" this LPE is more flexible (since, depending on the number of points available, it can fit both circles and ellipses) and has more features. Technical illustrators in particular can benefit from these features.


See [[LPE:_Ellipse_from_Points]] for a documentation.


<gallery>
File:Ellipse from points LPE.png|''Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)''|alt=Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)
</gallery>


==== Corners (Fillet/Chamfer) LPE ==== 


This new LPE adds fillet and chamfer to paths. Also adds a new internal class that allows to handle extra info per node, the LPE itself is an example of use the new classes.


[https://www.youtube.com/watch?v=wJKzGhJULfc Demo video]


<gallery>
File:Chamfer lpe.png|''Chamfer with LPE''|alt=Chamfer by LPE
File:Chamfer with steps.png|''Chamfer with 2 steps''|alt=Chamfer with 2 steps
File:Inverse chamfer with steps.png|''Inverse Chamfer with 2 steps''|alt=Inverse Chamfer with 2 steps
File:Fillet lpe.png|''Fillet with LPE''|alt=Fillet with LPE
File:Inverse fillet lpe.png|''Inverse fillet with LPE''|alt=Inverse fillet with LPE
</gallery>

==== Measure Segments LPE ==== 


This new path effect adds DIN and custom style measuring lines to "straight" segments in a path.


[https://www.youtube.com/watch?v=ppgt2GPm1IY Demo video]


<gallery>
File:Measure segment LPE.png|''Measure Segments LPE''|alt=Measure Segments LPE
</gallery>

==== Offset ==== 


Use this to add an offset to your paths, shapes and groups. Compared with the 'Dynamic Offset' available from the menu, this allows you to:


* define the offset distance numerically, e.g. to offset an object by 3 mm.
* keep sharp corners sharp (or to make them round, or beveled, if you want to), by using different methods for calculating the corners.

==== Power Clip and Power Mask ==== 


This new LPE adds options to clips and masks.

=== New Experimental LPEs === 

==== Angle Bisector ==== 


Draws a line that halves the angle between the first three nodes of the path.

==== Circle by 3 points ==== 


Draws a circle whose circumference passes through the first three nodes of the path.

==== Circle (by center and radius) ==== 


Draws a circle where the first node of the path is the center, and the last node determines the radius.

==== Extrude ==== 


Extrudes the path, creating a face for each path segment.

==== Line segment ==== 


Draws a straight line that connects the first and last node of the path.

==== Parallel ==== 


Creates a draggable line that will always be parallel to a two-node path.

==== Perpendicular Bisector ==== 


Draws a perpendicular line in the middle of the (imaginary) line that connects the start and end nodes.

==== Tangent to Curve ==== 


Draws a tangent with variable length and an additional angle that can be moved along the path.


<gallery>
File:New experimental lpes.png|''New experimental Live Path Effects (overview)''|alt=New experimental Live Path Effects
</gallery>

=== Improved LPEs === 

==== BSPline and Spiro ==== 


Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

==== Clone Original ==== 


This path effect now allows various objects instead of only paths and is even more powerful.


[https://www.youtube.com/watch?v=JAJAxKNY8lA Demo Video]


[https://ia601501.us.archive.org/34/items/00003303/0000-3303.ogv Demo Video]

==== Fill Between Many / Fill Between Strokes LPE ==== 


New options added:


* Fuse coincident points: [describe]
* Join subpaths: fill each path separately / connect all the fills
* Close: close the fill path that is created, so it can have a stroke on all sides
* LPEs on linked: take the applied live path effects of the filled paths into account (Fill Between Many only)


<gallery>
File:Fill between many new options.png|''New options for the Fill Between Many LPE''|alt=New options for the Fill Between Many LPE
</gallery>

==== Knot LPE ==== 


New options added:


* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Both gaps: interrupt both paths at a crossing

==== Mirror Symmetry and Rotate Copies LPE ==== 


* Split feature: This new feature allows custom styles for each part of the resulting drawing without unlinking the LPE. [https://www.youtube.com/watch?v=mIzrQ2lpzuw Demo Video]
* The LPE display now updates accordingly when there are objects added or removed.


<gallery>
File:Rotate copies LPE with style split.png|''Separate styles for rotated copies''|alt=Separate styles for rotated copies
</gallery>

==== PowerStroke LPE Improvements ==== 


* '''Width scale''' setting added: adjust the overall width of the stroke after it has been drawn.
* '''Closed paths''': PowerStroke now works much better on closed paths.

== Import / Export == 

=== Linking and embedding SVG files === 


On import of an SVG file, there is now a dialog that asks if the user would like to link to the SVG file, to embed it (base64 encoded) into an <code><img></code> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).


The dpi value for displaying embedded SVG files can be set in the import dialog or changed in the object properties dialog.


This makes importing SVG files work (almost) the same as importing raster images.


The 'Embed' and 'Extract' options in the context menu for linked SVG files work the same as they do for raster images. The 'Edit externally' option will open the linked SVG file with Inkscape per default. This setting can be changed in the preferences' 'Imported Images' section.


The displaying of the dialogue can be disabled by checking the 'Don’t ask me again' option.


Linked and embedded SVG images are displayed as their raster representations.

=== Mesh Gradient Polyfill === 


SVG files that include a mesh gradient now automatically include a Javascript polyfill that allows the mesh gradient to display correctly in web browsers.

=== SVG 1.1 compatibility === 


[Fill in: check box in Save as dialog, options in <code>Edit → Preferences → Input/Output → SVG Export</code>]

=== Export PNG images <span id="png-export"></span>=== 


The export dialog has received several new options which are available when you expand the 'Advanced' section.


* Enable interlacing (ADAM7): when loading images, they will be displayed faster
* Bit depth: set the number of bits that code for the color of a pixel, supports grayscale and up to 16-bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of anti-aliasing or disable it
* The option for "Cairo PNG" has been removed from the "Save as" dialog, as it was often confused with the "Export PNG image" option, but only supported a small subset of PNG rendering features.


<gallery>
File:Png-export-options 1.0.png|''PNG export options''|alt=PNG export options
File:Bit depth options 1.0.png|''PNG bit depth options''|alt=PNG bit depth options
File:Compression options 1.0.png|''PNG compression options''|alt=PNG compression options
File:Antialiasing options 1.0.png|''PNG antialiasing options''|alt=PNG antialiasing options
</gallery>

=== PDF Export === 


* External links in the SVG file are now kept when the file is exported to pdf (requires Cairo in version 1.15.4 or higher).
* Some Inkscape file metadata (<code>File → Document properties : Metadata</code>) are now exported to PDF (title, subject, creator, keywords).

=== (E)PS Export === 


* The title and copyright ('rights') info from the document's metadata is now exported to (E)PS.

=== OpenClipart Import === 


The dialog and settings for importing images from OpenClipart have been removed due to openclipart.org being non-functional since mid-April with no information about a return date.

== Extensions == 

=== Extension dialogs === 


Extensions can now have clickable links, images, a better layout with separators and indentation, multiline text fields, file chooser fields and more. For detailed info for development see the [[Release_notes/1.0#For_extension_writers|developer section]] above.

=== Export Layer Slices === 
<code>Extensions → Export → Export Layer Slices</code>


The new 'Export Layer Slices' extension allows you to export PNG "slices" from your image by creating a new layer and drawing rectangles to denote the area of the export.


If you create a layer (default name "slices") with rectangles in it, this extension will export a PNG file for each rectangle into the directory with the name of the {rectangle ID}.png (use Object Properties to set this).


If the export already exists, it will skip it and color the rectangle GREY. If the "Overwrite existing exports" checkbox is selected, and the file was previously generated, it will color the rectangle RED. For new exports that did not previously exist, the rectangle will be GREEN.


If you want to create (square) icons at different sizes, select "Icon mode". Icon mode will create a square export for each dimension in "Sizes".

=== Frame === 
<code>Extensions → Render → Frame</code>


This new extension will add a rectangular frame with a specified stroke width, and specified stroke and fill colors to each object in the selection. Optionally, corners can be rounded, and the frame can be positioned inside or outside the selection. The result can be grouped with the frame, and the object can be clipped to the size of the frame (for further editing).

=== Hershey Text === 
<code>Extensions → Text → Hershey Text</code>


The "Hershey Text" extension, a utility for replacing text by stroke-based paths, has been rewritten.
The most significant improvements are:


* The new version converts all or only the selected text objects in place. This means that it is possible to convert text with paragraphs and to convert multiple text objects at once.
* It now uses '''SVG fonts'''. This means that:
** It is now possible to easily add and use '''custom stroke fonts'''.
** '''Unicode characters''' are now supported.
** Stroke fonts now support '''arbitrary curves''' rather than only straight segments.
* '''Improved font selection''' with basic international characters
* Automated '''font-mapping''': each text will be converted to the available Hershey font with the same font file name (e.g. 'Fancy Font.svg') as the current font (e.g. 'Fancy Font'), if one is available to the extension. The automated mapping overrides any other Hershey font settings.
* An option to '''generate font samples''' in all available SVG fonts is available.
* An '''extensive help text''' is built into the extension.
* Hershey Text is now located in the ''Extensions → Text'' sub-menu.

=== Interactive Mockup === 
<code>Extensions → Web → Interactive Mockup</code>


The new Interactive Mockup extension is intended for use by UI/UX designers. It can help to visualize mockups and create user flows to make interactive demos for approvals.


To use it, select two or more objects: the first one(s) will be the active one (button, area, image, link…), and the last selected will be the element that should be displayed after activation.


Apply the extension, then save as SVG and open it in a browser for demonstrating the mockup to potential users.

=== Meshgradient to Path / Path to Meshgradient === 
<code>Extensions → Modify Path → Mesh → Meshgradient to Path / Path to Meshgradient</code>


A set of two extensions that convert mesh gradient geometry to paths and back.

=== Plot extension === 
<code>Extensions → Export → Plot</code>


The new option 'Convert objects to paths' will take care of converting everything to a path non-destructively before the data is sent to the plotter. [''gives wrong error message, maybe not working? https://gitlab.com/inkscape/inkscape/commit/dd3b6aa099175e2244e1e04dde45bf21a966425e#note_100908512'']

=== QR Code === 
<code>Extensions → Render → Barcode → QR Code</code>


Options for choosing the shape of single QR code dots were added.


<gallery>
File:Barcode extension 1.0.png|''Barcode extension with new options for dot shape at the bottom''|alt=Barcode extension with new options for dot shape at the bottom
File:Hershey font table.png|''Hershey font table (with non-ASCII characters)''|alt=Hershey font table (with non-ASCII characters)
</gallery>

== Palettes == 


* The Munsell palette, the Bootstrap 5 palette and the palette for the new GNOME Human Interface Guidelines (GNOME HIG) have been added to Inkscape's set of stock palettes.
* Users can now also drag the <code>none</code> color field from the palette bar at the bottom onto objects to set their color to <code>none</code>.


<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
File:Bootstrap 5 palette.png|''Bootstrap 5 palette''|Bootstrap 5 palette
File:Gnome HIG palette.png|''GNOME HIG palette''|alt=GNOME HIG palette
</gallery>

== Templates == 


* The '''Desktop''' template has new options for 4k, 5k, and 8k screens.
* Some new page sizes were added to the '''(Blank) Page''' template.
* New: template for an '''A4 3-fold roll flyer'''
* New: template for '''Envelope''' with 2 standard envelope formats


<gallery>
File:Desktop templates.png|''New template options for 'Desktop' template''|alt=New template options for 'Desktop' template
File:A4 3fold roll template.png|''New A4 3-fold roll flyer template''|alt=New A4 3-fold roll flyer template
</gallery>

== SVG and CSS == 


* '''Dashes''': Inkscape can now load and display files with dashes and/or dash offsets defined in units other than the unitless user unit (e.g. <code>%</code>, <code>mm</code>) correctly. There is no user interface for editing these values currently, except for the XML editor. Values for <code>stroke-dasharray</code> that are entered in other units (except for <code>%</code>) will be converted to user units when the new values are set.


* '''Blend modes''' applied via Layers and Objects dialog no longer use SVG filters, but CSS blend modes. These can be exported to PDF without rasterization. An additional option ("Isolate") allows you to <code><span style="color: red;">[... fill me in]</span></code>.


* '''Hairlines''' can now be rendered in Inkscape. There is currently no user interface for adding them yet, though. Hairlines can be specified by adding <code>stroke-width:1px; stroke-width: -ink-hairline; vector-effect:non-scaling-stroke;</code> into the <code><style></code> tag of the object via the XML editor or the Style dialog. Hairlines will be exported to PNG correctly. Export to PDF requires that the Cairo library that your Inkscape program was compiled with contains the additional code from https://gitlab.freedesktop.org/cairo/cairo/merge_requests/21 (as of Oct. 26, 2019, there's no official Cairo version available yet that contains the patch).

== Dialogs == 

=== Arrange === 
<code>Object → Arrange</code>


The 'Polar coordinates' functionality now arranges objects clockwise (in selection order) around the circle/ellipse. This should better correspond to user expectations.

=== Document Properties === 
<code>File → Document Properties</code>


* When resizing the page, the page margin fields can now be '''locked''', so the same value will be used for all margins, but only needs to be entered once.
* The guides panel now has controls to lock or unlock all guides, create guides around the page, and delete all guides. These actions also appear on the Edit menu, making it possible to assign custom keyboard shortcuts.
* '''Grids can now be aligned''' to the corners, edge midpoints, or centre of the page with a button click in the grids panel.
* Checkerboard patterns can now have a color (pending issue with updating the view: https://gitlab.com/inkscape/inkscape/issues/101#note_148034598). This color will also be used as a (non-checkered) background for PNG export.
* A set of new page formats for different Video resolutions (SD/PAL, SD-Widescreen/PAL, SD/NTSC, SD-Widescreen/NTSC, HD 720p, HD 1080p, DCI 2k (Full Frame), UHD 4k, DCI 4k (Full Frame), UHD 8k) has been added.


<gallery>
File:Lock margins doc props.png|''Lock to set same margins for page resizing''|alt=Lock to set same margins for page resizing
File:New guide options doc props.png|''Document properties: Toggle guide lock for document, create page border guides, remove all guides''|alt=Document properties: Toggle guide lock for document, create page border guides, remove all guides
File:Grid alignment doc props.png|''Grid alignment options in document properties''|alt=Grid alignment options in document properties
File:Colorful checkerboard.png|''Checkerboard background with color''|alt=Checkerboard background with color
</gallery>

=== Fill and Stroke === 
<code>Object → Fill and stroke</code>


* The RGBA code entry field now also accepts values like <code>#123</code> and autocompletes them to <code>#112233</code>, automatically removes hash signs in pasted codes, and keeps the old alpha value if the pasted code does not contain any.
* The blur slider is now scaled quadratically as you drag the slider. This makes it easier to apply and adjust smaller blur values.



=== Filter Editor === 
<code>Filters → Filter Editor</code>


The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects === 
<code>Object → Objects</code>


The context (right-click) menu now also contains an entry for '''deleting''' the selected object.

=== Paint Servers === 
<code>Object → Paint Servers</code>


* New dialog that allows you to see a list of patterns and SVG2 hatch fills used in the current document and to assign those to objects. The hatch fills can be modified by their handles on canvas.

=== Preferences === 
<code>Edit → Preferences</code>


* The '''Bitmaps''' subsection has been renamed to '''Imported Images''', as it now applies to both imported (embedded or linked) raster images as well as to imported (embedded or linked) SVG images (i.e. to everything in <code><img></code> tags).
* The '''System''' subsection lists more relevant folders and offers buttons to open those folders with the system's file browser. This makes it easier to find the correct folder, e.g. for resetting the preferences or for adding an extension or a new icon set.
* The '''System''' subsection now has a button for quickly resetting all Inkscape preferences, which also automatically creates a backup of the current preferences.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at <code>Behaviour → Dashes</code>. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in <code>Edit → Preferences → Input/Output → Autosave: Autosave directory</code>).
* The setting for '''Handle size''' has been moved from '''Input devices''' to '''Interface''' to make it more discoverable.


<gallery>
File:Open folders from preferences.png|''Important folders can be opened from the preferences''|alt=Important folders can be opened from the preferences
</gallery>

=== Selection Sets [Hidden]===

[Adjust info according to decision made in https://gitlab.com/inkscape/inkscape/-/merge_requests/1665#note_317458802]

=== Selectors and CSS [Experimental]=== 


* New dialog for adding classes and CSS styles to elements of the drawing
* Currently in experimental status, thus hidden from the menu (<code>Edit → Selectors and CSS</code>)
* Keyboard shortcut <kbd>Ctrl+Shift+Q</kbd> can be used to open the dialog
* Among the [https://gitlab.com/groups/inkscape/-/issues?scope=all&utf8=%E2%9C%93&state=all&search=Selectors known issues], there are a couple crashes, which is the reason why the dialog has been disabled for the 1.0 release.


[Needs screenshot]

=== Symbols <span id="symbols"></span> === 
<code>Object → Symbols</code>


The Symbols dialog can now handle a lot of symbols without delay on startup, and also allows searching. Symbols and symbol sets are now displayed in alphabetical order.


<gallery>
File:Symbols list.png|''Symbol sets ordered alphabetically''|alt=Symbol sets ordered alphabetically
File:Symbols search.png|''Searching for symbols''|alt=Searching for symbols
</gallery>

=== Trace Bitmap <span id="centerline"></span>=== 
<code>Path → Trace Bitmap</code>


A new, unified dialog for vectorizing raster graphics is now available from '''Path → Trace Bitmap'''. It contains the previously separate '''Trace pixelart''' dialog and comes with a new option for centerline tracing.

[needs image]

=== Unicode Characters === 


* The ''''Glyphs' dialog''' has been '''renamed to 'Unicode Characters''''.
* The characters in the dialog's character list now '''use the selected font'''.
* Each character now has a '''tooltip''' that shows a larger version of the character, so one can more easily find the correct character.


<gallery>
File:Unicode character dialog.png|''Unicode characters dialog with large tooltip''|alt=Unicode characters dialog with large tooltip
</gallery>

=== XML Editor === 
<code>Edit → XML Editor</code>


The side of the editor that allows one to set, edit or delete attributes can now be panned both horizontally and vertically, or be hidden entirely. Long items can more easily be edited in a little popup dialog.


<gallery>
File:Xml_editor_popup.png|''XML Editor with editing popup''|alt=XML Editor with editing popup
</gallery>

== Menus == 


* New option to "Unlink clones recursively" added into sub-menu at "Edit → Clone"

== Customization <span id="customization"></span>== 

=== Customize many files in the share folder === 


Many files in <code>/share</code> can be over-ridden by placing files in the user's configuration folder (e.g. <code>~/.config/inkscape</code>).
Configurable contents now includes extensions, filters, fonts, gradients, icons, keyboard shortcuts, [preset markers (not yet: [https://gitlab.com/inkscape/inbox/issues/1400 bug #1400])], [user paint servers (SVG hatches, patterns (currently [https://gitlab.com/inkscape/inbox/issues/1620 crashes paint servers dialog], ...)], palettes, about screen, symbol sets, templates, tutorials and some user interface configuration files. Only the file 'units.xml' cannot be overridden.

=== Fonts === 

==== Load additional fonts ==== 


Inkscape can now load fonts that are not installed on the system. By default Inkscape will load additional fonts from Inkscape's share folder (<code>/share/inkscape/fonts</code>) and the user's configuration folder (<code>~/.config/inkscape/fonts</code>). Custom folders can be set in preferences (see <code>Tools → Text → Additional font directories</code>).


<gallery>
File:Custom font folders.png|''Set custom font folders''|alt=Set custom font folders
</gallery>

=== Keyboard shortcuts === 


* Allow to use "Super", "Hyper" and "Meta" modifier keys
* Improve shortcut handling code. This should fix a lot of issues and allow the use of many shortcuts which were inaccessible before, especially on non-English keyboard layouts.
* The Keyboard shortcut editor now issues a warning when the entered shortcut is already in use.
* It is now possible to assign keyboard shortcuts that align an object to the top-left, top-right, bottom-left or bottom-right corners of the anchor (determined via the 'relative to:' field), or to align the objects' top-left, top-right, bottom-left or bottom-right corners with the opposite corner of the anchor.

=== User interface customization === 


* Inkscape is starting to use glade files for its dialogues, so they can be reconfigured by users. Only one is currently supported (filter editor).
* The contents of the menus can be configured by customising the <code>menus.xml</code> file.
* Toolbar contents for the command bar (<code>commands-toolbar.ui</code>), the snap bar (<code>snap-toolbar.ui</code>), the tool controls bars for each tool (<code>select-toolbar.ui</code>), the toolbox (<code>tool-toolbar.ui</code>) is now configurable.
* The interface colors and some more UI styles can be customized in <code><preferences folder>/ui/style.css</code> (very raw theming support).

=== Theme selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, users can set a custom GTK3 theme for Inkscape. If the theme comes with a dark variant, activating the 'Use dark theme' checkbox will result in the dark variant being used. The new theme will be applied immediately.


New themes can be installed on your system to be made available in the list to choose from. A large selection of (more or less current) GTK3 themes are available for download at [https://www.gnome-look.org/browse/cat/135/ord/top/ gnome-look.org] . On Windows, the new themes can be placed in <code><var>%AppData%</var>\Local\themes\</code>, so that the full path to the theme's CSS files will be <code><var>%AppData%</var>\Local\themes\<theme name>\gtk-3.0\</code>.

=== Icon set selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, the icon set to use can be selected. By default, Inkscape comes with 'hicolor', 'Tango', and the new 'Multicolor' icons. In addition to this, it offers to use the system's icons.


The symbolic icon set that is part of the 'hicolor' icon set as well as the new Multicolor icons can be colorized with custom colors.


<gallery>
File:Tango icons.png|''Light theme with Tango icon set''|alt=Light theme and Tango icon set
File:Hicolor icons.png|''Light theme with hicolor icon set''|alt=Light theme and hicolor icon set
File:Dark with symbolic icons.png|''Dark theme with symbolic icon set''|alt=Dark theme and symbolic icon set
File:Dark symbolic custom color.png|''Dark theme with symbolic icon set and a custom icon color''|alt=Dark theme with custom colored symbolic icon set
File:Multicolor icon set.png|''New Multicolor icon set on dark theme''|alt=New Multicolor icon set on dark theme

</gallery>

=== Saving the current file as template === 


A new entry for saving the current file as a template has been added to the 'File' menu. You need to specify a name for it, and optionally, you can add the template's author, a description and some keywords. A checkbox allows you to set the new template as the default template.


<gallery>
File:Save as templage.png|''Save current file as a template''|alt=Save current file as a template
</gallery>

=== Custom page sizes in Document Properties === 


Inkscape now creates a CSV file (comma separated values) called <code>pages.csv</code>. It is located in your Inkscape user preferences folder, next to your <code>preferences.xml</code> file. This file contains the default page sizes that you can choose from in the 'Page' tab of the 'Document properties' dialog. You can edit the <code>pages.csv</code> file to remove the page sizes you won't use, or to add new ones.

== Command Line == 


The Inkscape command line has undergone a major overhaul with the goal of making it more powerful and flexible for the user and easier to enhance for the developer. The most important changes are:


* Each command-line argument can now be used only once. To specify multiple ''actions'' (''verbs''), use semicolons (e.g. <code>--actions='ObjectFlipVertically;FileSave;FileClose'</code>).
* Many ''actions'' can now take arguments (separated from the ''action'' name by a colon.
* [[Using xverbs|xverbs]] have been removed from Inkscape (command line commands that take parameters from a file, e.g. for saving the selection under a specified filename as SVG file) ([https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/33487d06-e3c1-a4e5-1496-7b370d672d2f%40gmail.com/#msg35392523 mailing list thread]).
* Files can also be saved as Inkscape SVG without calling the GUI save dialog (new command: <code>--export-inkscape-svg</code>)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: <code>--export-id</code>.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: <code>--pdf-page <var>N</var></code>).
* For importing a PDF, the option to import via poppler is now available for the command line as <code>pdf-poppler</code>.
* New verb allows one to swap fill and stroke style from the command line: <code>EditSwapFillStroke</code> (a keyboard shortcut can now be assigned to it) ([https://bugs.launchpad.net/inkscape/+bug/675690 bug 675690])
* The shell mode syntax has changed, too.
* The file name can now be specified with <code>--export-filename</code>
* The command <code>-x</code> / <code>--extension-directory</code> has been removed. Replaced with: <code>--system-data-directory</code> and <code>--user-data-directory</code>.


More information about usage and how to update your commands can be found at [[Using the Command Line]].

== Tutorials / Documentation == 


* Some small updates were made to tutorial texts
* Tutorial files got a new header / footer design, using [https://inkscape.org/~esteban/%E2%98%85inksscreen-10-by-esteban-capella Esteban Capella's entry] for our About Screen Contest.

== Translations [as of 2019-12-18] == 


Translations were updated for:


* Basque
* British English
* Brazilian Portuguese
* Catalan
* Croatian
* Czech
* Dutch
* Finnish
* French
* German
* Greek
* Hindi
* Hungarian
* Icelandic
* Indonesian
* Italian
* Korean
* Latvian
* Norwegian (Bokmål)
* Polish
* Romanian
* Russian
* Slovak
* Spanish
* Swedish
* Turkish
* Ukrainian
* Urdu
* Swedish


Tutorial translations were added for:


* Korean


Translations were dropped for:


* Amharic

== Notable Bugfixes == 


* Symbols: Visio Stencils loaded from <code>.vss</code> files now use their actual name instead of a placeholder derived from the symbol file's name ([https://bugs.launchpad.net/inkscape/+bug/1676144 bug 1676144])
* Shapes on Pen and Pencil tools now retain color and width ([https://bugs.launchpad.net/inkscape/+bug/1707899 bug:1707899]).
* Text and Font dialog: The font selection no longer jumps to the top of the list when clicking Apply.
* Docked dialogs now open on their own when the corresponding functionality is called from a menu or button
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* As of Windows 10 (version 1809) fonts are installed into a new user-specific folder by default. Allow Inkscape to recognize those fonts. ([https://gitlab.com/inkscape/inkscape/issues/50 #50])
* The default Perl interpreter executable on Windows was changed from <code>perl.exe</code> to <code>wperl.exe</code> which should usually avoid flashing a console window. ([https://gitlab.com/inkscape/inkscape/issues/66 #66])
* Some printers who don't correctly recognize the page formats sent by Inkscape, printed only square excerpts of the whole image that was supposed to be printed. Now they print the whole image ([https://gitlab.com/inkscape/inkscape/merge_requests/407 Merge request]).


For an exhaustive list of bugs that have been fixed, please see the [https://launchpad.net/inkscape/1.0.x milestones page for Inkscape 1.0 on Launchpad] and the [https://gitlab.com/inkscape/inkscape/issues?scope=all&utf8=%E2%9C%93&state=closed&milestone_title=Inkscape%201.0 list of milestoned issues on GitLab].

== Breaking changes / Action required == 

=== For users === 

==== Custom Icon Sets ==== 


Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated its own file. The directory structure must follow the [https://developer.gnome.org/icon-theme-spec/ standard structure for Gnome icons].


If you would like to create or convert your own icon set to the new format, please compare the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation's 'share' directory for suitable examples and check out [[Creating a new multicolor icon theme | our guide to making a new multicolor icon theme]].


As a side effect of a bug fix to the icon preview dialog (see below), custom UI icon SVG files need to be updated to have their background color alpha channel set to 0 so that they display correctly (see Bug #[https://bugs.launchpad.net/inkscape/+bug/1661989 1661989]).

==== Third-party extensions <span id="extensions-api"></span>==== 


Most extensions that are maintained by a third-party developer (i.e. that are not an Inkscape stock extension) need to be updated to work with this version of Inkscape. Inkscape contributors have contacted many extension authors already to let them know about the upcoming changes. If your favorite third-party extension still needs to be updated to be compatible with Inkscape 1.0, please point its author to [https://wiki.inkscape.org/wiki/index.php/Release_notes/1.0#For_extension_writers the section about updating one's extension in the Wiki].

==== Dropped / Replaced Extensions ==== 


Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed, as well as some extensions that depended on third-party programs:


'''''Import extensions that have been removed:'''''



* Adobe Illustrator 8.0 and below (UC) (<code>*.ai</code>) (Workaround: rename the file extension to <code>.eps</code>. Newer versions can still be imported if they contain an embedded PDF.)
* Corel DRAW Compressed Exchange files (UC) (<code>*.ccx</code>)
* Corel DRAW 7-X4 files (UC) (<code>*.cdr</code>) (<code>*.cdr</code> in general can still be imported)
* Corel DRAW 7-13 template files (UC) (<code>*.cdt</code>)
* Computer Graphics Metafile files (UC) (<code>*.cgm</code>) 
* Corel DRAW Presentation Exchange files (UC) (<code>*.cmx</code>)
* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 
* Dia Diagram (<code>*.dia</code>) (Workaround: export as a different format from [https://wiki.gnome.org/Apps/Dia/Download Dia]) 


'''''Export extensions that have been removed:'''''


* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 


'''''Extensions that have been replaced:'''''


* <code>Render → LaTeX</code>: The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (<code>Render → LaTeX</code>) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies. It has been replaced by the extension <code>Render → Mathematics → LaTeX (pdflatex)</code> which serves the same purpose.

==== Command line changes ====

The Inkscape command line options [[#Command Line|have changed significantly (see below)]]. Any command line scripts that you have used will need to be updated for Inkscape 1.0.

=== For extension writers === 


Extensions have undergone some fundamental changes.


Inkscape's stock extensions '''have been moved to [https://gitlab.com/inkscape/extensions their own repository]''' and have been updated for compatibility with '''Python 3'''. Internally, extensions have been reorganized, many functions have been deprecated, and new functions have been added.

==== General ==== 


* <span id="python3"></span>Extensions were updated to be compatible with Python 3. While we'll be migrating away from Python 2, extension writers should aim for support of Python 2.7 and Python 3.5+ for maximum compatibility.
* Windows packages now ship with Python 3 (currently Python 3.7). Python 2 is not bundled anymore, so make sure to update your extension to be compatible.
* Inkscape now adds itself to search path on startup, so you should always be able to call it from your extension by simply calling <code>inkscape</code>, without the need to add it to search path manually, or worrying about other potentially incompatible versions of Inkscape being available on search path.
* The folder structure of Windows packages was updated: Binaries were moved from the installation root to <code>bin/</code>, Inkscape's shared files where moved from <code>share/</code> to a <code>share/inkscape</code> subfolder.
* The underscores that were previously necessary to mark elements as translatable are no longer needed. Elements that are usually translated are now by default included in translations. Elements that are usually not translated, are not included. This can be overridden by setting the <code>translatable="yes/no"</code> attribute.
* Extensions (including their <code>.inx</code> files) can now be put into a subdirectory of the <code>extensions/</code> folder to allow for better structuring and separation of extensions.

==== Extension dialogs ==== 


Extension dialogs have some new input types and layout options:


* new multiline text fields
* new file chooser fields
* new <code>appearance="url"</code> for [[INX Parameters]] of type <code>"description"</code>. You can now add clickable links to your extension UI.
* a simpler version of the color chooser field has been added
* new layout options (separator, table-like layouts)
* all [[INX Parameters]] now have the common attribute <code>indent="<var>n</var>"</code> where <code><var>n</var></code> specifies the level of indentation in the extension UI.
* new <code>label</code> parameter
* new option to include an image
* some confusing options have been merged
* new effect extension attribute <code>implements-custom-gui</code> is [http://wiki.inkscape.org/wiki/index.php/INX_extension_descriptor_format#Attributes_description available] to hide the 'Extension is working' dialog.

[needs screenshot]

==== More info ==== 


Please also note the changed [[#Command Line|command line options]], if your extension calls another instance of Inkscape.


More detailed instructions for updating old extensions are available at [[Updating your Extension for 1.0]]. Also check the [https://inkscape.gitlab.io/extensions/documentation/ extension (<code>inkex</code>) API documentation] and the [https://gitlab.com/inkscape/extensions stock extensions repository] for finding comparable extensions. If you have questions about extension development, you can join us in our [https://chat.inkscape.org/channel/inkscape_extensions extension development chat channel].

=== For packagers and those who compile Inkscape === 


* <code>autotools</code> builds have been dropped. Please use <code>CMake</code> for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* <code>libsoup</code> dependency added: we use <code>libsoup</code> for making HTTP requests without a need for <code>dbus</code> and <code>gvfs</code>.
* double-conversion [https://github.com/google/double-conversion] dependency added: <code>lib2geom</code> now depends on an external version of the library.
* Inkscape now uses a git submodule for the <code>extensions/</code> directory. If you have cloned the repository and are not building from the release source code tarball, please note the [https://inkscape.org/en/develop/getting-started/ updated build instructions]
* On Ubuntu 18.04, Gnome's fallback icon set (package 'adwaita-icon-theme-full'), that is needed to display Inkscape's default icons completely, is no longer automatically installed. It has been added as a 'recommends' level dependency.
* lib2geom: [insert up-to-date info here]
* The environment variable <code>INKSCAPE_PORTABLE_PROFILE_DIR</code> has been removed. Please use the equivalent <code>INKSCAPE_PROFILE_DIR</code> instead for changing the location of the profile directory at run time. (see also [https://gitlab.com/inkscape/inkscape/issues/114 #114])
* Inkscape extensions have been updated to work with Python 3, they no longer depend on Python 2 (but still work with it)

== Known Issues== 


[as of Sept. 7th, 2019, "beta0"]


* Various warnings printed to console output
* Slowdown and temporary freezes when opening the font list
* <code>man</code> page not entirely updated yet to account for the changes in the command line interface
* Hatch fill handles are sometimes not shown on the canvas, hatchfill changes are often not displayed (only the first time)
* <code>uniconvertor</code> not available, thus some file formats can no longer be imported
* object transformation handles do not rotate along with the canvas during canvas rotation ([https://gitlab.com/inkscape/inbox/issues/69 inbox#69])


See also: [https://gitlab.com/groups/inkscape/inkscape/issues List of confirmed and ready-to-be-worked-on issues] and [https://gitlab.com/inkscape/inbox/issues List of new user submitted issues, questions and feature requests]

== Inkview == 


'''Inkview''' (a simple SVG viewer) was considerably improved and got some new features:


* Support folders as input (will load all SVG files from the specified folder)<br/>The <code>-r</code> or <code>--recursive</code> option will even allow to search subfolders recursively.
* Implement <code>-t</code> or <code>--timer</code> option which allows to set a time after which the next file will be automatically loaded.
* Add <code>-s</code> or <code>--scale</code> option to set a factor by which to scale the displayed image.
* Add <code>-f</code> or <code>--fullscreen</code> option to launch Inkview in fullscreen mode
* Many smaller fixes and improvements

== Previous releases == 


* [[Release notes/0.92]] ([[Release_notes/0.92.1 |0.92.1]], [[Release_notes/0.92.2 |0.92.2]], [[Release_notes/0.92.3 |0.92.3]], [[Release_notes/0.92.4 |0.92.4]], [[Release_notes/0.92.5 |0.92.5]])
* [[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]]

</translate>

Release notes/1.0

2020-04-15T18:13:31Z

Zearin: Minor corrections to spelling and grammar; minor formatting tweaks

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

<languages />

<translate>

== Inkscape 1.0 == 


'''(definitely not released yet - [[AnnouncePlanning1.0]])'''


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

== Release highlights == 


* [[#customization|Theming support and more new customization options]]
* [[#hidpi|Better HiDPI (high resolution) screen support]]
* [[#macos|Native support for macOS with a signed and notarized .dmg file]]
* [[#origin|Coordinate origin in top left corner by default]]
* [[#canvas|Canvas rotation and mirroring]]
* [[#on-canvas-align|On-Canvas alignment of objects]]
* [[#view-modes|Split view and X-Ray modes]]
* [[#powerpencil|PowerPencil for drawing editable, variable width strokes with a pressure sensitive graphics tablet]]
* [[#png-export|New PNG export options]]
* [[#centerline|Integrated centerline tracing for vectorizing line drawings]]
* [[#symbols|Searchable Symbols dialog]]
* [[#lpe-dialog|New Live Path Effect (LPE) selection dialog]]
* [[#lpes|New Corners (Fillet/chamfer) LPE, (lossless) Boolean Operation LPE, Offset LPE and Measure Segments LPE (and more!)]]
* [[#performance|Path operations, deselection of a large number of paths as well as grouping/ungrouping are much faster now]]
* [[#line-height|Much improved text line-height settings]]
* [[#variable-fonts|Variable fonts support (only if compiled with pango library version >= 1.41.1)]]
* [[#flowed-text|Browser-compatible flowed text]]
* [[#extensions-api|Extensions programming interface updated, with many new options]] - ''Note: this introduces breaking changes, some third-party extensions will have to be updated to work with Inkscape 1.0''
* [[#python3|Python 3 support for extensions]]

== General: Application == 

=== Performance <span id="performance"></span>=== 

Lots of small performance improvements in various areas combine to make Inkscape run smoother than before:

* Accelerated breaking apart of paths and Boolean operations (by disabling intermittent canvas rendering during these operations).
* Accelerated "deselect" speed (by improving internal data structure algorithms).
* Faster grouping and ungrouping of groups with a large number of objects
* Speed boost to operations on large sets of objects in the Objects dialog (Bug [https://gitlab.com/inkscape/inbox/issues/392 #392])
* Faster lookup of attributes (MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448])

=== Mac Application <span id="macos"></span>=== 


Inkscape is now a first-rate native macOS application, and no longer requires XQuartz to operate. The minimum required operating system version is OS X El Capitan 10.11.


It has a standard Mac-style menu bar (rather than a menu bar within the window). Keyboard shortcuts now use the command (<kbd>⌘</kbd>) key rather than the control key. Retina display screen resolution is now supported. The build is now cleanly 64-bit, a prerequisite for macOS Catalina 10.15 and beyond. It comes bundled with Python 3 to power Inkscape extensions.


[[File:Mac_menu_1.0_screenshot.png|665px]]

== General User Interface == 

=== Modernized GUI Toolkit=== 


The user interface has been changed to utilise a more recent version of GTK+ (GTK+ 3). This is a collection of user interface building blocks that Inkscape uses to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI (high resolution) screens.

Bringing the newer GTK+ toolkit to Inkscape has been an eagerly anticipated goal for a long time. It has taken much effort by the Team involved and it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Window position / size / behavior === 


Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
were made. The window manager handles most of the jobs now, which should make it much more robust. If you still encounter problems with this, please report those [https://inkscape.org/report to our bug tracker].

The dialog opacity options have been removed, because they were causing crashes that could not be fixed otherwise.

=== High Resolution Screens <span id="hidpi"></span> === 


Inkscape now supports HiDPI (high resolution) screens natively. This means that icons and node handles will no longer be tiny on monitors with large pixel dimensions, and the canvas will no longer look blurry.

=== Tool box === 

The tools have been reordered and grouped into more logical groups. Zoom and measure tools as well as Spray, Tweak and Eraser are now closer to the bottom. Users can customize the order of the tools by putting a customized version of the file <code>inkscape/share/ui/toolbar-tool.ui</code> into a folder named <code>ui</code> in their Inkscape user configuration folder, if they prefer a different order.

<gallery>
File:Toolbox 1.0.png|''Reordered tools in the tool box''|alt=Reordered tools in the tool box
</gallery>

=== Improved number entry fields === 


Many numeric entry fields no longer change their value when scrolling while the mouse is hovering over them. They now need to be selected (clicked into). Then scrolling will change the value as previously. This change was made, because scrolling docked dialogs easily led to accidental change of values.


Additionally, <kbd>Ctrl+Scroll</kbd> on a selected numeric entry field will now change the value in larger steps.

== Canvas == 

=== Y-Axis Inversion <span id="origin"></span>=== 


During the [https://inkscape.org/en/news/2018/09/20/inkscape-hackfest-kiel-2018-what-happened/ Inkscape Hackfest in Kiel], a significant change by Thomas Holder was integrated into the Inkscape codebase. It sets the origin of the document to the top left corner of the page. This finally makes the coordinates that a user can see in the interface match the ones that are saved in the SVG data (unit conversions/transformations may be required), and makes working in Inkscape more comfortable for people who are used to this more standard behavior. The old behavior can be reactivated in the preferences, at <code>Edit → Preferences → Interface</code> (disable 'Origin in upper left with y-axis pointing down').


<gallery>
File:Origin in upper left.png|''Option in the preferences' 'Interface' section''|alt=Option in the preferences' 'Interface' section
File:Origin in upper left page.png|''Effect of the option (left upper page corner at 0/0)''|alt=Effect of the option (left upper page corner at 0/0)
</gallery>

=== Canvas Rotation <span id="canvas"></span>=== 


With <kbd>Ctrl+Shift+Scroll wheel</kbd> the drawing area can be rotated and viewed from different angles. In the bottom right corner of the window, the viewing angle can be entered manually. Right-click to select between a set of preset values. Keyboard shortcuts for clockwise/counter-clockwise/no rotation can be set in the preferences.


[[File:Canvas rotation.gif]]

=== Canvas Mirroring === 


The canvas can now be flipped, to ensure that the drawing does not lean to one side, and looks good either way.
The vertical/horizontal flipping is available from the menu <code>View → Canvas orientation → Flip horizontally / Flip vertically</code>. Keyboard shortcuts for flipping the canvas can be set in the preferences (<code>Edit → Preferences → Interface → Keyboard shortcuts</code>).


[[File:Flip canvas 300px.gif]]

=== Pinch-to-zoom === 


On supported hardware (trackpad, touchpad, multi-touch screen), the canvas can be zoomed with the two-finger pinch gesture.

=== Duplicate Guides === 


A new option for duplicating guides was added to the 'Guideline' dialog. This new feature, when used in conjunction with the 'relative change' option (dialog needs to be opened twice), makes it easier to create guides that are offset by a certain distance / angle from an existing guide.


[[File:Duplicate guide.png]]

=== Context menu === 


The menu that appears after a right-click on the canvas has been extended with the following items, which makes locking/unlocking and hiding/unhiding individual objects much more comfortable:


* Hide selected objects
* Unhide objects below (the mouse cursor)
* Lock selected objects
* Unlock objects below (the mouse cursor)


<gallery>
File:Context menu.png|''New options in context menu''|alt=New options in context menu
</gallery>

=== Snapping === 


* In <code>Edit → Preferences → Behavior → Snapping</code>, a new option was added to '''disable snapping''' in new documents or files that are opened with Inkscape for the first time.

== View == 

=== Center view on page === 


You can now center the view on the page, without changing the zoom level.


This function is available via:


* <code>View → Zoom</code>
* the Zoom tool's tool controls bar
* Keyboard shortcut <kbd>Ctrl + 4</kbd>

=== Split View Mode <span id="view-modes"></span>=== 

The new Split View Mode features a draggable separator that becomes visible as soon as the Split view mode has been activated. On one side of the separator, the canvas will look just like before, while on the other side, everything will be displayed in outline mode, and objects can more easily be grabbed with the mouse or edited with the node tool.

It can be moved on the canvas by grabbing either the separation line or the central handle. The sides can be switched by clicking on one of the little arrows on the handle.

Activate it with one of:

* <code>View → Split View Mode</code>
* <kbd>Ctrl + 6</kbd>

To deativate the mode, either deactivate the checkbox in the menu again, use the keyboard shortcut a second time, or drag the separator off the canvas.


[[File:Split Screen-smaller.gif]]

=== X-Ray Mode ===

When the X-Ray mode is active, a circular area that shows objects on the canvas in outline mode will follow the mouse pointer. This makes editing complex drawings with many objects layered on top of one another much easier, and is especially useful when used with the node tool.

Activate it with:

* <code>View → XRay Mode</code>
* <kbd>Alt + 6</kbd>

The size of the X-Ray circle can be adjusted in <code>Edit → Preferences → Rendering → Rendering XRay radius</code>.

To deactivate the mode, either deactivate the checkbox in the menu again, or use the keyboard shortcut a second time.

[[File:XRay mode.gif]]

=== Visible Hairlines Display Mode === 


This new display mode is available in the menu under <code>View → Display Mode → Visible Hairlines</code>. It ensures that all lines of nonzero width are visible (with a minimum visible line width), regardless of zoom level, while still drawing everything else normally.


This is especially useful if you need to assign very small line widths for use with CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines. In that case, you will still be able to see the lines, even when zoomed out.


[[File:visible_hairlines.gif]]

== Paths == 

=== Changed behavior of Stroke to Path === 


The 'Stroke to Path' command now not only converts the stroke of a shape to path, but effectively splits it into its components.


In the case of applying it to a path that only has a stroke, the behavior is unchanged.


For paths that don't only have a stroke, but also a fill and/or markers, the result will be a group consisting of:
* Stroke outline turned to path
* Fill (if there was one)
* A group of all markers (if applicable; one group per marker, consisting of its outline and its fill turned into a path)


[[File:Stroke to path.gif]]

=== Unlinking Clones for Path Operations === 


Clones and Symbols are now automatically unlinked, before a Boolean operation (union, difference, etc.), or one of the Path operations 'Combine', 'Break apart', or 'Stroke to Path' is performed.


A setting in the preferences at <code>Behavior → Clones → Unlink Clones</code> allows the User to disable the automatic unlinking.

== Tools == 

=== Bézier Tool === 


The tool mode 'Create sequence of paraxial segments', which previously would only draw lines parallel to the x and y axis of the document, now supports arbitrary starting angles. After the first segment, all further angles will use the current angle ±90°. If you want your first segment to work as in previous versions, you need to press <kbd>Ctrl</kbd> after the first click. This will restrict your options to (by default) 15° steps.


<gallery>
File:Paraxial arbitrary starting angle.gif|''Arbitrary starting angle for paraxial mode''|alt=Arbitrary starting angle for paraxial mode
</gallery>

=== Calligraphy Tool === 


A new option to add dots has been added to the tool. Click in place without moving the mouse to create a dot, Shift+Click to create a larger dot ''[needs documentation in keyboard shortcut list, https://gitlab.com/inkscape/inkscape-docs/documentation/-/issues/1 ]''.

=== Circle Tool === 


The circle tool can now also create closed ("filleted") circle shapes (closed arcs) with the click of a button.


<gallery>
File:Circle chord.png|''Circle tool shapes in this release''|alt=Circle tool shapes in this release
</gallery>

=== Eraser === 


* Added option to control eraser width with a pressure sensitive input device.
* Added thinning, caps, and tremor options (as used for calligraphy tool).
* New option to erase as clip, which allows the User to non-destructively erase (parts of) various types of elements, including raster images and clones.


[[File:Erase with clip.gif]]

=== Measurement Tool === 


Hovering over a path with the tool now displays the length, height, width, and position of the path. If you hover over a group, it will show the width, height, and position of the group. Holding <kbd>Shift</kbd> switches to showing info about the constituents of the group.


The tool also has a new option to only measure selected objects when using click-and-drag.


<gallery>
File:Measure tool info.png|''New info text from measurement tool (for a group)''|alt=New info text from measurement tool (for a group)
File:Measure tool info group shift.png|''Measurement tool info text for a single path (in a group with Shift)''|alt=Measurement tool info text for a single path (in a group with Shift)
File:Measure selected.png|''Measuring only the selected object (the ice cap)''|alt=Measuring only the selected object (the ice cap)
</gallery>

=== Pencil Tool === 

==== PowerPencil <span id="powerpencil"></span>==== 


Pressure sensitivity can now be enabled for the Pencil tool. This feature makes use of the PowerStroke Live Path Effect (LPE).


New settings for the tool are available for tweaking the behavior of the PowerStroke LPE when it is being created with the Pencil tool (and a graphics tablet/stylus):
* '''Use pressure input''' (in the tool controls bar): activates the PowerStroke feature, if a pressure sensitive device is available.
* '''Min/Max''' (in the tool controls bar): determines the minimal and maximal stroke width (0–100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* '''Caps''' (in the tool controls bar): choose between the options 'butt', 'square', 'round', 'peak' and 'zero width' for the end caps of the stroke.
* Additionally, the PowerStroke LPE itself has been improved, to better work when used in this new way, see [[#PowerStroke_LPE_Improvements|the section about LPE updates]].


[[File:PowerPencil-smaller.gif]]

=== Selection Tool === 

==== On-Canvas Alignment <span id="on-canvas-align"></span>==== 


When the option "Enable on-canvas alignment" is active in the "Align and Distribute" dialog, a new set of handles will appear on canvas when an object is clicked three times (first click: scale handles, second click: rotation/skew handles).


The handles can be used to align the selected objects relative to the area of the current selection.


* <kbd>Shift + click</kbd> on the outer handles aligns on the outside of the selection area.
* Clicking on the central handle will align the selected objects on the horizontal axis. On <kbd>Shift + click</kbd> objects will be aligned on the vertical axis.
* With <kbd>Ctrl + Shift </kbd> the whole selection can be aligned to its outer boundaries / corners as a group (i.e. it is moved by its own <code>width</code> and / or <code>height</code>).


[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool === 

==== More Compact Tool Controls Bar ====

* Some control buttons that have been mutually exclusive (e.g. right-aligned, left-aligned, justified) have been combined into drop-down lists, so they now take up less space.
* Removed the 'Show style of outermost text element' button that made settings confusing.

[[File:Text Tool controls1.0.png|800px]]


==== Better Line Height Settings <span id="line-height></span>====

* Line spacing settings got an overhaul and are now much easier to use. Gone is the unwieldy <code>?</code> button; this is now handled by selecting text on canvas.
* Setting line height works like this now:
** For the whole text: click anywhere into the text without selecting anything, then adjust the line height in the tool controls bar.
** For a specific line: select the text in that line, then adjust the line height in the tool controls bar.
** Set the global line height first, and the specific line heights last. Changing global line height later will remove any line-specific line-heights (even just changing the unit will unset those).
** Line heights for single selected lines cannot go below the height set globally.
** If more than one line is selected, the line height in between those lines can go below the line height set for the whole text.
* The line height settings work in all three text types.

==== Improved Text Selection ==== 


When clicking on a text object, any click within the whole area of the text's bounding box now selects the text (with both selection and text tool).

==== Variable Font Support <span id="variable-fonts"></span>==== 


If Inkscape has been compiled with a Pango library version that is at least 1.41.1, it comes with [[Variable Fonts support | support for variable fonts]] ([https://www.patreon.com/posts/font-variations-17644963 more info about how this looks]. These are fonts that do not come with different faces, but often with various sliding scales for different font properties, like 'boldness', or 'condensing', or even playful features.

==== Basic Support for SVG in OpenType ==== 


Some OpenType fonts with glyphs saved as SVG render now in Inkscape.


<gallery>
File:Variable fonts Decovar.png|''Variable font - both texts use the same font (Decovar)''|alt=Variable font - both texts use the same font (Decovar)
File:SVG in OpenType.png|''SVG Color font (Gilbert Color)''|alt=SVG Color font (Gilbert Color)
</gallery>

==== Browser-compatible flowed text <span id="flowed-text"></span>==== 


[needs pictures]


'''Flowed text''' (created by clicking and dragging a text frame) in previous Inkscape versions was not compatible with browsers, and rendered as 'black boxes' in web browsers and other SVG viewers, or was just missing.

The old flowed text can still be enabled by unchecking <code>Edit → Preferences → Tools → Text: Use SVG2 auto-flowed text</code>.


Now, Inkscape offers to use '''two new types of flowed text''', that have a compatible fallback for use with modern web browsers:


# '''SVG 2 text using the CSS <code>shape-inside</code> property:''' This new flowed text automatically '''includes a fallback option''' (in SVG 1.1), and will show up in web browsers and other software. This type of text can be created by '''clicking and dragging a box''' on canvas, '''if the option 'Use SVG 2 auto-flowed text' is enabled''' in the Text tool's preferences. When the option is enabled, it will also be used for <code>Text → Flow into frame</code> [unconfirmed].
# '''SVG 2 text with <code>inline-size</code> property:''' This is the new "Column mode" of the text tool, that can be created by clicking on the canvas, typing, and then dragging the diamond-shaped handle at the end of the text to determine the width of the text. It creates flowed text columns without a predetermined height. These texts include an SVG 1.1 fallback, too. To convert the text back to SVG 1.1 text, <kbd>Ctrl-click</kbd> on the diamond (this will result in all the text being placed on a single line).


The fallback option can be disabled in <code>Edit → Preferences → Input/Output → SVG export: SVG 2: Insert SVG 1.1 fallback in text</code>.

==== SVG 2 Text Support in Detail ==== 


Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating.


There are several types of SVG 2 text:

===== Multi-line text via the CSS 'white-space' property ===== 


The CSS property [https://developer.mozilla.org/en-US/docs/Web/CSS/white-space 'white-space'] controls how white space is handled. By default, SVG collapses all adjacent white-space including newlines into a single space. By setting the <code>white-space</code> value to <code>pre</code>, <code>pre-line</code>, or <code>pre-wrap</code>, Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the <code>white-space</code> property value. (Supported by Firefox. No SVG 1.1 fallback created by Inkscape.)

===== Multi-line text via the CSS 'inline-size' property ===== 


The CSS property <code>inline-size</code> defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. This text type has an SVG 1.1 fallback, that is included by default.

===== Multi-line text via the CSS 'shape-inside' property ===== 


The CSS property <code>shape-inside</code> allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS <code>shape-subtract</code>, <code>shape-margin</code>, and <code>shape-padding</code> properties.


Multi-line text via the <code>shape-inside</code> property is a direct replacement for SVG 1.2 flowed text. SVG 1.2 never became a final W3C standard and only the Batik SVG renderer besides Inkscape provided any support for SVG 1.2 flowed text. SVG 2 is not yet a final W3C standard but SVG 2 flowed text has one very important advantage over SVG 1.2 flowed text in that it is easy to structure the SVG 2 text such that it will be rendered (almost) correctly by an SVG 1.1 renderer. This means that browsers which do not support SVG 2 text will still render the text.

One disadvantage of using SVG 2 text is that it will not be editable as multi-line text in Inkscape 0.92 (it will still be editable as single lines of text).

== Clipping / Masking == 


Clip paths and masks now have an inverse mode in the menu, using the PowerClip and PowerMask LPEs.


[[File:Inverse clip 400.gif]]

== Filters == 


The size of the filter region can now be adjusted by dragging on two new diamond-shaped nodes with the node tool. This is especially useful for blur filters, whose area has been affected by a transformation of the filtered object.


[[File:Filter region.gif]]

== Live Path Effects == 

=== General === 


Live Path Effects received a major overhaul, with lots of improvements and new features. The main changes are:


* '''New LPE selection dialog'''<span id="lpe-dialog"></span>: the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, to switch between list and tile view, to display info about the selected effect and to apply it. Several additional, experimental path effects are available after the corresponding switch has been activated.
* '''Set default parameters''': default values for any LPE can be set in the respective LPE's dialogue, when it is applied to an object
(''Note: we have the 'multiple desktop preferences' problem here: If you have multiple Inkscape windows open, the last one will determine what will be saved to the preferences file, as preferences changes are only saved when Inkscape is closed, and the settings are only loaded from file when a new window is opened.'')
* '''Clip and Mask''': improved handling
* '''Fix multiple LPE BBox''': a problem with the size of the bounding box when applying multiple LPEs to an object has been fixed. Sometimes you need to add a intermediate LPE bounding box between.
* '''Knots on shapes''': show edit knots in LPE shapes
* '''Switch knots''': change the handles to the correct LPE handles when one selects an LPE in the list of active LPEs for the selected object.


<gallery>
File:LPE set defaults.png|''Set default values for Mirror LPE''|alt=Set default values for Mirror LPE
File:Add LPE dialog.png|''New LPE selection dialog''|alt=New LPE selection dialog
</gallery>

=== New Live Path Effects <span id="lpes></span>=== 

==== Boolean Operations LPE ==== 


The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. That way, two paths can be combined to a single shape, and both are still editable:
# Start with two paths. Groups, Rectangles, or other objects are also okay.
# Copy the second path into the clipboard (<code>Edit → Copy</code>).
# Select the first path and add the boolean LPE (<code>Path → Path Effects → Add path effect (Plus) → Boolean</code>).
# Link the second path to the LPE by clicking on <code>Operand Path - Link to path in clipboard</code>.

Available options:


* union
* symmetric difference
* intersection
* division
* difference

* cut


<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

==== Dashed Stroke LPE ==== 


This new LPE creates uniformly dashed paths, optionally by subdividing the path's segments, or including dashes that are symmetrically wrapped around corners.


<gallery>
File:Dash stroke LPE.png|''Rectangles with dashed stroke LPE with various settings''|alt=Rectangles with dash stroke LPE with various settings
</gallery>


[https://archive.org/details/dash-stroke-lpe Demo Video]

==== Ellipse from Points ==== 


This new LPE creates an optimally fitted ellipse from a path's nodes.


In contrast to the already existing LPE "Ellipse by 5 points" this LPE is more flexible (since, depending on the number of points available, it can fit both circles and ellipses) and has more features. Technical illustrators in particular can benefit from these features.


See [[LPE:_Ellipse_from_Points]] for a documentation.


<gallery>
File:Ellipse from points LPE.png|''Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)''|alt=Ellipse (5 nodes), circle (3 nodes), circle segment (3 nodes), isometric circle (3 nodes), isometric circle with frame (3 nodes)
</gallery>


==== Corners (Fillet/Chamfer) LPE ==== 


This new LPE adds fillet and chamfer to paths. Also adds a new internal class that allows to handle extra info per node, the LPE itself is an example of use the new classes.


[https://www.youtube.com/watch?v=wJKzGhJULfc Demo video]


<gallery>
File:Chamfer lpe.png|''Chamfer with LPE''|alt=Chamfer by LPE
File:Chamfer with steps.png|''Chamfer with 2 steps''|alt=Chamfer with 2 steps
File:Inverse chamfer with steps.png|''Inverse Chamfer with 2 steps''|alt=Inverse Chamfer with 2 steps
File:Fillet lpe.png|''Fillet with LPE''|alt=Fillet with LPE
File:Inverse fillet lpe.png|''Inverse fillet with LPE''|alt=Inverse fillet with LPE
</gallery>

==== Measure Segments LPE ==== 


This new path effect adds DIN and custom style measuring lines to "straight" segments in a path.


[https://www.youtube.com/watch?v=ppgt2GPm1IY Demo video]


<gallery>
File:Measure segment LPE.png|''Measure Segments LPE''|alt=Measure Segments LPE
</gallery>

==== Offset ==== 


Use this to add an offset to your paths, shapes and groups. Compared with the 'Dynamic Offset' available from the menu, this allows you to:


* define the offset distance numerically, e.g. to offset an object by 3 mm.
* keep sharp corners sharp (or to make them round, or beveled, if you want to), by using different methods for calculating the corners.

==== Power Clip and Power Mask ==== 


This new LPE adds options to clips and masks.

=== New Experimental LPEs === 

==== Angle Bisector ==== 


Draws a line that halves the angle between the first three nodes of the path.

==== Circle by 3 points ==== 


Draws a circle whose circumference passes through the first three nodes of the path.

==== Circle (by center and radius) ==== 


Draws a circle where the first node of the path is the center, and the last node determines the radius.

==== Extrude ==== 


Extrudes the path, creating a face for each path segment.

==== Line segment ==== 


Draws a straight line that connects the first and last node of the path.

==== Parallel ==== 


Creates a draggable line that will always be parallel to a two-node path.

==== Perpendicular Bisector ==== 


Draws a perpendicular line in the middle of the (imaginary) line that connects the start and end nodes.

==== Tangent to Curve ==== 


Draws a tangent with variable length and an additional angle that can be moved along the path.


<gallery>
File:New experimental lpes.png|''New experimental Live Path Effects (overview)''|alt=New experimental Live Path Effects
</gallery>

=== Improved LPEs === 

==== BSPline and Spiro ==== 


Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

==== Clone Original ==== 


This path effect now allows various objects instead of only paths and is even more powerful.


[https://www.youtube.com/watch?v=JAJAxKNY8lA Demo Video]


[https://ia601501.us.archive.org/34/items/00003303/0000-3303.ogv Demo Video]

==== Fill Between Many / Fill Between Strokes LPE ==== 


New options added:


* Fuse coincident points: [describe]
* Join subpaths: fill each path separately / connect all the fills
* Close: close the fill path that is created, so it can have a stroke on all sides
* LPEs on linked: take the applied live path effects of the filled paths into account (Fill Between Many only)


<gallery>
File:Fill between many new options.png|''New options for the Fill Between Many LPE''|alt=New options for the Fill Between Many LPE
</gallery>

==== Knot LPE ==== 


New options added:


* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Both gaps: interrupt both paths at a crossing

==== Mirror Symmetry and Rotate Copies LPE ==== 


* Split feature: This new feature allows custom styles for each part of the resulting drawing without unlinking the LPE. [https://www.youtube.com/watch?v=mIzrQ2lpzuw Demo Video]
* The LPE display now updates accordingly when there are objects added or removed.


<gallery>
File:Rotate copies LPE with style split.png|''Separate styles for rotated copies''|alt=Separate styles for rotated copies
</gallery>

==== PowerStroke LPE Improvements ==== 


* '''Width scale''' setting added: adjust the overall width of the stroke after it has been drawn.
* '''Closed paths''': PowerStroke now works much better on closed paths.

== Import / Export == 

=== Linking and embedding SVG files === 


On import of an SVG file, there is now a dialog that asks if the user would like to link to the SVG file, to embed it (base64 encoded) into an <code><img></code> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).


The dpi value for displaying embedded SVG files can be set in the import dialog or changed in the object properties dialog.


This makes importing SVG files work (almost) the same as importing raster images.


The 'Embed' and 'Extract' options in the context menu for linked SVG files work the same as they do for raster images. The 'Edit externally' option will open the linked SVG file with Inkscape per default. This setting can be changed in the preferences' 'Imported Images' section.


The displaying of the dialogue can be disabled by checking the 'Don’t ask me again' option.


Linked and embedded SVG images are displayed as their raster representations.

=== Mesh Gradient Polyfill === 


SVG files that include a mesh gradient now automatically include a Javascript polyfill that allows the mesh gradient to display correctly in web browsers.

=== SVG 1.1 compatibility === 


[Fill in: check box in Save as dialog, options in <code>Edit → Preferences → Input/Output → SVG Export</code>]

=== Export PNG images <span id="png-export"></span>=== 


The export dialog has received several new options which are available when you expand the 'Advanced' section.


* Enable interlacing (ADAM7): when loading images, they will be displayed faster
* Bit depth: set the number of bits that code for the color of a pixel, supports grayscale and up to 16-bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of anti-aliasing or disable it
* The option for "Cairo PNG" has been removed from the "Save as" dialog, as it was often confused with the "Export PNG image" option, but only supported a small subset of PNG rendering features.


<gallery>
File:Png-export-options 1.0.png|''PNG export options''|alt=PNG export options
File:Bit depth options 1.0.png|''PNG bit depth options''|alt=PNG bit depth options
File:Compression options 1.0.png|''PNG compression options''|alt=PNG compression options
File:Antialiasing options 1.0.png|''PNG antialiasing options''|alt=PNG antialiasing options
</gallery>

=== PDF Export === 


* External links in the SVG file are now kept when the file is exported to pdf (requires Cairo in version 1.15.4 or higher).
* Some Inkscape file metadata (<code>File → Document properties : Metadata</code>) are now exported to PDF (title, subject, creator, keywords).

=== (E)PS Export === 


* The title and copyright ('rights') info from the document's metadata is now exported to (E)PS.

=== OpenClipart Import === 


The dialog and settings for importing images from OpenClipart have been removed due to openclipart.org being non-functional since mid-April with no information about a return date.

== Extensions == 

=== Extension dialogs === 


Extensions can now have clickable links, images, a better layout with separators and indentation, multiline text fields, file chooser fields and more. For detailed info for development see the [[Release_notes/1.0#For_extension_writers|developer section]] above.

=== Export Layer Slices === 
<code>Extensions → Export → Export Layer Slices</code>


The new 'Export Layer Slices' extension allows you to export PNG "slices" from your image by creating a new layer and drawing rectangles to denote the area of the export.


If you create a layer (default name "slices") with rectangles in it, this extension will export a PNG file for each rectangle into the directory with the name of the {rectangle ID}.png (use Object Properties to set this).


If the export already exists, it will skip it and color the rectangle GREY. If the "Overwrite existing exports" checkbox is selected, and the file was previously generated, it will color the rectangle RED. For new exports that did not previously exist, the rectangle will be GREEN.


If you want to create (square) icons at different sizes, select "Icon mode". Icon mode will create a square export for each dimension in "Sizes".

=== Frame === 
<code>Extensions → Render → Frame</code>


This new extension will add a rectangular frame with a specified stroke width, and specified stroke and fill colors to each object in the selection. Optionally, corners can be rounded, and the frame can be positioned inside or outside the selection. The result can be grouped with the frame, and the object can be clipped to the size of the frame (for further editing).

=== Hershey Text === 
<code>Extensions → Text → Hershey Text</code>


The "Hershey Text" extension, a utility for replacing text by stroke-based paths, has been rewritten.
The most significant improvements are:


* The new version converts all or only the selected text objects in place. This means that it is possible to convert text with paragraphs and to convert multiple text objects at once.
* It now uses '''SVG fonts'''. This means that:
** It is now possible to easily add and use '''custom stroke fonts'''.
** '''Unicode characters''' are now supported.
** Stroke fonts now support '''arbitrary curves''' rather than only straight segments.
* '''Improved font selection''' with basic international characters
* Automated '''font-mapping''': each text will be converted to the available Hershey font with the same font file name (e.g. 'Fancy Font.svg') as the current font (e.g. 'Fancy Font'), if one is available to the extension. The automated mapping overrides any other Hershey font settings.
* An option to '''generate font samples''' in all available SVG fonts is available.
* An '''extensive help text''' is built into the extension.
* Hershey Text is now located in the ''Extensions → Text'' sub-menu.

=== Interactive Mockup === 
<code>Extensions → Web → Interactive Mockup</code>


The new Interactive Mockup extension is intended for use by UI/UX designers. It can help to visualize mockups and create user flows to make interactive demos for approvals.


To use it, select two or more objects: the first one(s) will be the active one (button, area, image, link…), and the last selected will be the element that should be displayed after activation.


Apply the extension, then save as SVG and open it in a browser for demonstrating the mockup to potential users.

=== Meshgradient to Path / Path to Meshgradient === 
<code>Extensions → Modify Path → Mesh → Meshgradient to Path / Path to Meshgradient</code>


A set of two extensions that convert mesh gradient geometry to paths and back.

=== Plot extension === 
<code>Extensions → Export → Plot</code>


The new option 'Convert objects to paths' will take care of converting everything to a path non-destructively before the data is sent to the plotter. [''gives wrong error message, maybe not working? https://gitlab.com/inkscape/inkscape/commit/dd3b6aa099175e2244e1e04dde45bf21a966425e#note_100908512'']

=== QR Code === 
<code>Extensions → Render → Barcode → QR Code</code>


Options for choosing the shape of single QR code dots were added.


<gallery>
File:Barcode extension 1.0.png|''Barcode extension with new options for dot shape at the bottom''|alt=Barcode extension with new options for dot shape at the bottom
File:Hershey font table.png|''Hershey font table (with non-ASCII characters)''|alt=Hershey font table (with non-ASCII characters)
</gallery>

== Palettes == 


* The Munsell palette, the Bootstrap 5 palette and the palette for the new GNOME Human Interface Guidelines (GNOME HIG) have been added to Inkscape's set of stock palettes.
* Users can now also drag the <code>none</code> color field from the palette bar at the bottom onto objects to set their color to <code>none</code>.


<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
File:Bootstrap 5 palette.png|''Bootstrap 5 palette''|Bootstrap 5 palette
File:Gnome HIG palette.png|''GNOME HIG palette''|alt=GNOME HIG palette
</gallery>

== Templates == 


* The '''Desktop''' template has new options for 4k, 5k, and 8k screens.
* Some new page sizes were added to the '''(Blank) Page''' template.
* New: template for an '''A4 3-fold roll flyer'''
* New: template for '''Envelope''' with 2 standard envelope formats


<gallery>
File:Desktop templates.png|''New template options for 'Desktop' template''|alt=New template options for 'Desktop' template
File:A4 3fold roll template.png|''New A4 3-fold roll flyer template''|alt=New A4 3-fold roll flyer template
</gallery>

== SVG and CSS == 


* '''Dashes''': Inkscape can now load and display files with dashes and/or dash offsets defined in units other than the unitless user unit (e.g. <code>%</code>, <code>mm</code>) correctly. There is no user interface for editing these values currently, except for the XML editor. Values for <code>stroke-dasharray</code> that are entered in other units (except for <code>%</code>) will be converted to user units when the new values are set.


* '''Blend modes''' applied via Layers and Objects dialog no longer use SVG filters, but CSS blend modes. These can be exported to PDF without rasterization. An additional option ("Isolate") allows you to <code><span style="color: red;">[... fill me in]</span></code>.


* '''Hairlines''' can now be rendered in Inkscape. There is currently no user interface for adding them yet, though. Hairlines can be specified by adding <code>stroke-width:1px; stroke-width: -ink-hairline; vector-effect:non-scaling-stroke;</code> into the <code><style></code> tag of the object via the XML editor or the Style dialog. Hairlines will be exported to PNG correctly. Export to PDF requires that the Cairo library that your Inkscape program was compiled with contains the additional code from https://gitlab.freedesktop.org/cairo/cairo/merge_requests/21 (as of Oct. 26, 2019, there's no official Cairo version available yet that contains the patch).

== Dialogs == 

=== Arrange === 
<code>Object → Arrange</code>


The 'Polar coordinates' functionality now arranges objects clockwise (in selection order) around the circle/ellipse. This should better correspond to user expectations.

=== Document Properties === 
<code>File → Document Properties</code>


* When resizing the page, the page margin fields can now be '''locked''', so the same value will be used for all margins, but only needs to be entered once.
* The guides panel now has controls to lock or unlock all guides, create guides around the page, and delete all guides. These actions also appear on the Edit menu, making it possible to assign custom keyboard shortcuts.
* '''Grids can now be aligned''' to the corners, edge midpoints, or centre of the page with a button click in the grids panel.
* Checkerboard patterns can now have a color (pending issue with updating the view: https://gitlab.com/inkscape/inkscape/issues/101#note_148034598). This color will also be used as a (non-checkered) background for PNG export.
* A set of new page formats for different Video resolutions (SD/PAL, SD-Widescreen/PAL, SD/NTSC, SD-Widescreen/NTSC, HD 720p, HD 1080p, DCI 2k (Full Frame), UHD 4k, DCI 4k (Full Frame), UHD 8k) has been added.


<gallery>
File:Lock margins doc props.png|''Lock to set same margins for page resizing''|alt=Lock to set same margins for page resizing
File:New guide options doc props.png|''Document properties: Toggle guide lock for document, create page border guides, remove all guides''|alt=Document properties: Toggle guide lock for document, create page border guides, remove all guides
File:Grid alignment doc props.png|''Grid alignment options in document properties''|alt=Grid alignment options in document properties
File:Colorful checkerboard.png|''Checkerboard background with color''|alt=Checkerboard background with color
</gallery>

=== Fill and Stroke === 
<code>Object → Fill and stroke</code>


* The RGBA code entry field now also accepts values like <code>#123</code> and autocompletes them to <code>#112233</code>, automatically removes hash signs in pasted codes, and keeps the old alpha value if the pasted code does not contain any.
* The blur slider is now scaled quadratically as you drag the slider. This makes it easier to apply and adjust smaller blur values.



=== Filter Editor === 
<code>Filters → Filter Editor</code>


The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects === 
<code>Object → Objects</code>


The context (right-click) menu now also contains an entry for '''deleting''' the selected object.

=== Paint Servers === 
<code>Object → Paint Servers</code>


* New dialog that allows you to see a list of patterns and SVG2 hatch fills used in the current document and to assign those to objects. The hatch fills can be modified by their handles on canvas.

=== Preferences === 
<code>Edit → Preferences</code>


* The '''Bitmaps''' subsection has been renamed to '''Imported Images''', as it now applies to both imported (embedded or linked) raster images as well as to imported (embedded or linked) SVG images (i.e. to everything in <code><img></code> tags).
* The '''System''' subsection lists more relevant folders and offers buttons to open those folders with the system's file browser. This makes it easier to find the correct folder, e.g. for resetting the preferences or for adding an extension or a new icon set.
* The '''System''' subsection now has a button for quickly resetting all Inkscape preferences, which also automatically creates a backup of the current preferences.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at <code>Behaviour → Dashes</code>. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in <code>Edit → Preferences → Input/Output → Autosave: Autosave directory</code>).
* The setting for '''Handle size''' has been moved from '''Input devices''' to '''Interface''' to make it more discoverable.


<gallery>
File:Open folders from preferences.png|''Important folders can be opened from the preferences''|alt=Important folders can be opened from the preferences
</gallery>

=== Selection Sets [Hidden]===

[Adjust info according to decision made in https://gitlab.com/inkscape/inkscape/-/merge_requests/1665#note_317458802]

=== Selectors and CSS [Experimental]=== 


* New dialog for adding classes and CSS styles to elements of the drawing
* Currently in experimental status, thus hidden from the menu (<code>Edit → Selectors and CSS</code>)
* Keyboard shortcut <kbd>Ctrl+Shift+Q</kbd> can be used to open the dialog
* Among the [https://gitlab.com/groups/inkscape/-/issues?scope=all&utf8=%E2%9C%93&state=all&search=Selectors known issues], there are a couple crashes, which is the reason why the dialog has been disabled for the 1.0 release.


[Needs screenshot]

=== Symbols <span id="symbols"></span> === 
<code>Object → Symbols</code>


The Symbols dialog can now handle a lot of symbols without delay on startup, and also allows searching. Symbols and symbol sets are now displayed in alphabetical order.


<gallery>
File:Symbols list.png|''Symbol sets ordered alphabetically''|alt=Symbol sets ordered alphabetically
File:Symbols search.png|''Searching for symbols''|alt=Searching for symbols
</gallery>

=== Trace Bitmap <span id="centerline"></span>=== 
<code>Path → Trace Bitmap</code>


A new, unified dialog for vectorizing raster graphics is now available from '''Path → Trace Bitmap'''. It contains the previously separate '''Trace pixelart''' dialog and comes with a new option for centerline tracing.

[needs image]

=== Unicode Characters === 


* The ''''Glyphs' dialog''' has been '''renamed to 'Unicode Characters''''.
* The characters in the dialog's character list now '''use the selected font'''.
* Each character now has a '''tooltip''' that shows a larger version of the character, so one can more easily find the correct character.


<gallery>
File:Unicode character dialog.png|''Unicode characters dialog with large tooltip''|alt=Unicode characters dialog with large tooltip
</gallery>

=== XML Editor === 
<code>Edit → XML Editor</code>


The side of the editor that allows one to set, edit or delete attributes can now be panned both horizontally and vertically, or be hidden entirely. Long items can more easily be edited in a little popup dialog.


<gallery>
File:Xml_editor_popup.png|''XML Editor with editing popup''|alt=XML Editor with editing popup
</gallery>

== Menus == 


* New option to "Unlink clones recursively" added into sub-menu at "Edit → Clone"

== Customization <span id="customization"></span>== 

=== Customize many files in the share folder === 


Many files in <code>/share</code> can be over-ridden by placing files in the user's configuration folder (e.g. <code>~/.config/inkscape</code>).
Configurable contents now includes extensions, filters, fonts, gradients, icons, keyboard shortcuts, [preset markers (not yet: [https://gitlab.com/inkscape/inbox/issues/1400 bug #1400])], [user paint servers (SVG hatches, patterns (currently [https://gitlab.com/inkscape/inbox/issues/1620 crashes paint servers dialog], ...)], palettes, about screen, symbol sets, templates, tutorials and some user interface configuration files. Only the file 'units.xml' cannot be overridden.

=== Fonts === 

==== Load additional fonts ==== 


Inkscape can now load fonts that are not installed on the system. By default Inkscape will load additional fonts from Inkscape's share folder (<code>/share/inkscape/fonts</code>) and the user's configuration folder (<code>~/.config/inkscape/fonts</code>). Custom folders can be set in preferences (see <code>Tools → Text → Additional font directories</code>).


<gallery>
File:Custom font folders.png|''Set custom font folders''|alt=Set custom font folders
</gallery>

=== Keyboard shortcuts === 


* Allow to use "Super", "Hyper" and "Meta" modifier keys
* Improve shortcut handling code. This should fix a lot of issues and allow the use of many shortcuts which were inaccessible before, especially on non-English keyboard layouts.
* The Keyboard shortcut editor now issues a warning when the entered shortcut is already in use.
* It is now possible to assign keyboard shortcuts that align an object to the top-left, top-right, bottom-left or bottom-right corners of the anchor (determined via the 'relative to:' field), or to align the objects' top-left, top-right, bottom-left or bottom-right corners with the opposite corner of the anchor.

=== User interface customization === 


* Inkscape is starting to use glade files for its dialogues, so they can be reconfigured by users. Only one is currently supported (filter editor).
* The contents of the menus can be configured by customising the <code>menus.xml</code> file.
* Toolbar contents for the command bar (<code>commands-toolbar.ui</code>), the snap bar (<code>snap-toolbar.ui</code>), the tool controls bars for each tool (<code>select-toolbar.ui</code>), the toolbox (<code>tool-toolbar.ui</code>) is now configurable.
* The interface colors and some more UI styles can be customized in <code><preferences folder>/ui/style.css</code> (very raw theming support).

=== Theme selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, users can set a custom GTK3 theme for Inkscape. If the theme comes with a dark variant, activating the 'Use dark theme' checkbox will result in the dark variant being used. The new theme will be applied immediately.


New themes can be installed on your system to be made available in the list to choose from. A large selection of (more or less current) GTK3 themes are available for download at [https://www.gnome-look.org/browse/cat/135/ord/top/ gnome-look.org] . On Windows, the new themes can be placed in <code><var>%AppData%</var>\Local\themes\</code>, so that the full path to the theme's CSS files will be <code><var>%AppData%</var>\Local\themes\<theme name>\gtk-3.0\</code>.

=== Icon set selection === 


In <code>Edit → Preferences → User Interface → Theme</code>, the icon set to use can be selected. By default, Inkscape comes with 'hicolor', 'Tango', and the new 'Multicolor' icons. In addition to this, it offers to use the system's icons.


The symbolic icon set that is part of the 'hicolor' icon set as well as the new Multicolor icons can be colorized with custom colors.


<gallery>
File:Tango icons.png|''Light theme with Tango icon set''|alt=Light theme and Tango icon set
File:Hicolor icons.png|''Light theme with hicolor icon set''|alt=Light theme and hicolor icon set
File:Dark with symbolic icons.png|''Dark theme with symbolic icon set''|alt=Dark theme and symbolic icon set
File:Dark symbolic custom color.png|''Dark theme with symbolic icon set and a custom icon color''|alt=Dark theme with custom colored symbolic icon set
File:Multicolor icon set.png|''New Multicolor icon set on dark theme''|alt=New Multicolor icon set on dark theme

</gallery>

=== Saving the current file as template === 


A new entry for saving the current file as a template has been added to the 'File' menu. You need to specify a name for it, and optionally, you can add the template's author, a description and some keywords. A checkbox allows you to set the new template as the default template.


<gallery>
File:Save as templage.png|''Save current file as a template''|alt=Save current file as a template
</gallery>

=== Custom page sizes in Document Properties === 


Inkscape now creates a CSV file (comma separated values) called <code>pages.csv</code>. It is located in your Inkscape user preferences folder, next to your <code>preferences.xml</code> file. This file contains the default page sizes that you can choose from in the 'Page' tab of the 'Document properties' dialog. You can edit the <code>pages.csv</code> file to remove the page sizes you won't use, or to add new ones.

== Command Line == 


The Inkscape command line has undergone a major overhaul with the goal of making it more powerful and flexible for the user and easier to enhance for the developer. The most important changes are:


* Each command-line argument can now be used only once. To specify multiple ''actions'' (''verbs''), use semicolons (e.g. <code>--actions='ObjectFlipVertically;FileSave;FileClose'</code>).
* Many ''actions'' can now take arguments (separated from the ''action'' name by a colon.
* [[Using xverbs|xverbs]] have been removed from Inkscape (command line commands that take parameters from a file, e.g. for saving the selection under a specified filename as SVG file) ([https://sourceforge.net/p/inkscape/mailman/inkscape-devel/thread/33487d06-e3c1-a4e5-1496-7b370d672d2f%40gmail.com/#msg35392523 mailing list thread]).
* Files can also be saved as Inkscape SVG without calling the GUI save dialog (new command: <code>--export-inkscape-svg</code>)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: <code>--export-id</code>.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: <code>--pdf-page <var>N</var></code>).
* For importing a PDF, the option to import via poppler is now available for the command line as <code>pdf-poppler</code>.
* New verb allows one to swap fill and stroke style from the command line: <code>EditSwapFillStroke</code> (a keyboard shortcut can now be assigned to it) ([https://bugs.launchpad.net/inkscape/+bug/675690 bug 675690])
* The shell mode syntax has changed, too.
* The file name can now be specified with <code>--export-filename</code>
* The command <code>-x</code> / <code>--extension-directory</code> has been removed. Replaced with: <code>--system-data-directory</code> and <code>--user-data-directory</code>.


More information about usage and how to update your commands can be found at [[Using the Command Line]].

== Tutorials / Documentation == 


* Some small updates were made to tutorial texts
* Tutorial files got a new header / footer design, using [https://inkscape.org/~esteban/%E2%98%85inksscreen-10-by-esteban-capella Esteban Capella's entry] for our About Screen Contest.

== Translations [as of 2019-12-18] == 


Translations were updated for:


* Basque
* British English
* Brazilian Portuguese
* Catalan
* Croatian
* Czech
* Dutch
* Finnish
* French
* German
* Greek
* Hindi
* Hungarian
* Icelandic
* Indonesian
* Italian
* Korean
* Latvian
* Norwegian (Bokmål)
* Polish
* Romanian
* Russian
* Slovak
* Spanish
* Swedish
* Turkish
* Ukrainian
* Urdu
* Swedish


Tutorial translations were added for:


* Korean


Translations were dropped for:


* Amharic

== Notable Bugfixes == 


* Symbols: Visio Stencils loaded from <code>.vss</code> files now use their actual name instead of a placeholder derived from the symbol file's name ([https://bugs.launchpad.net/inkscape/+bug/1676144 bug 1676144])
* Shapes on Pen and Pencil tools now retain color and width ([https://bugs.launchpad.net/inkscape/+bug/1707899 bug:1707899]).
* Text and Font dialog: The font selection no longer jumps to the top of the list when clicking Apply.
* Docked dialogs now open on their own when the corresponding functionality is called from a menu or button
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* As of Windows 10 (version 1809) fonts are installed into a new user-specific folder by default. Allow Inkscape to recognize those fonts. ([https://gitlab.com/inkscape/inkscape/issues/50 #50])
* The default Perl interpreter executable on Windows was changed from <code>perl.exe</code> to <code>wperl.exe</code> which should usually avoid flashing a console window. ([https://gitlab.com/inkscape/inkscape/issues/66 #66])
* Some printers who don't correctly recognize the page formats sent by Inkscape, printed only square excerpts of the whole image that was supposed to be printed. Now they print the whole image ([https://gitlab.com/inkscape/inkscape/merge_requests/407 Merge request]).


For an exhaustive list of bugs that have been fixed, please see the [https://launchpad.net/inkscape/1.0.x milestones page for Inkscape 1.0 on Launchpad] and the [https://gitlab.com/inkscape/inkscape/issues?scope=all&utf8=%E2%9C%93&state=closed&milestone_title=Inkscape%201.0 list of milestoned issues on GitLab].

== Breaking changes / Action required == 

=== For users === 

==== Custom Icon Sets ==== 


Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated its own file. The directory structure must follow the [https://developer.gnome.org/icon-theme-spec/ standard structure for Gnome icons].


If you would like to create or convert your own icon set to the new format, please compare the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation's 'share' directory for suitable examples and check out [[Creating a new multicolor icon theme | our guide to making a new multicolor icon theme]].


As a side effect of a bug fix to the icon preview dialog (see below), custom UI icon SVG files need to be updated to have their background color alpha channel set to 0 so that they display correctly (see Bug #[https://bugs.launchpad.net/inkscape/+bug/1661989 1661989]).

==== Third-party extensions <span id="extensions-api"></span>==== 


Most extensions that are maintained by a third-party developer (i.e. that are not an Inkscape stock extension) need to be updated to work with this version of Inkscape. Inkscape contributors have contacted many extension authors already to let them know about the upcoming changes. If your favorite third-party extension still needs to be updated to be compatible with Inkscape 1.0, please point its author to [https://wiki.inkscape.org/wiki/index.php/Release_notes/1.0#For_extension_writers the section about updating one's extension in the Wiki].

==== Dropped / Replaced Extensions ==== 


Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed, as well as some extensions that depended on third-party programs:


'''''Import extensions that have been removed:'''''



* Adobe Illustrator 8.0 and below (UC) (<code>*.ai</code>) (Workaround: rename the file extension to <code>.eps</code>. Newer versions can still be imported if they contain an embedded PDF.)
* Corel DRAW Compressed Exchange files (UC) (<code>*.ccx</code>)
* Corel DRAW 7-X4 files (UC) (<code>*.cdr</code>) (<code>*.cdr</code> in general can still be imported)
* Corel DRAW 7-13 template files (UC) (<code>*.cdt</code>)
* Computer Graphics Metafile files (UC) (<code>*.cgm</code>) 
* Corel DRAW Presentation Exchange files (UC) (<code>*.cmx</code>)
* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 
* Dia Diagram (<code>*.dia</code>) (Workaround: export as a different format from [https://wiki.gnome.org/Apps/Dia/Download Dia]) 


'''''Export extensions that have been removed:'''''


* HP Graphics Language Plot file [AutoCAD] (UC) (<code>*.plt</code>) 
* sK1 vector graphics files (UC) (<code>*.sk1</code>) 


'''''Extensions that have been replaced:'''''


* <code>Render → LaTeX</code>: The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (<code>Render → LaTeX</code>) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies. It has been replaced by the extension <code>Render → Mathematics → LaTeX (pdflatex)</code> which serves the same purpose.

==== Command line changes ====

The Inkscape command line options [[#Command Line|have changed significantly (see below)]]. Any command line scripts that you have used will need to be updated for Inkscape 1.0.

=== For extension writers === 


Extensions have undergone some fundamental changes.


Inkscape's stock extensions '''have been moved to [https://gitlab.com/inkscape/extensions their own repository]''' and have been updated for compatibility with '''Python 3'''. Internally, extensions have been reorganized, many functions have been deprecated, and new functions have been added.

==== General ==== 


* <span id="python3"></span>Extensions were updated to be compatible with Python 3. While we'll be migrating away from Python 2, extension writers should aim for support of Python 2.7 and Python 3.5+ for maximum compatibility.
* Windows packages now ship with Python 3 (currently Python 3.7). Python 2 is not bundled anymore, so make sure to update your extension to be compatible.
* Inkscape now adds itself to search path on startup, so you should always be able to call it from your extension by simply calling <code>inkscape</code>, without the need to add it to search path manually, or worrying about other potentially incompatible versions of Inkscape being available on search path.
* The folder structure of Windows packages was updated: Binaries were moved from the installation root to <code>bin/</code>, Inkscape's shared files where moved from <code>share/</code> to a <code>share/inkscape</code> subfolder.
* The underscores that were previously necessary to mark elements as translatable are no longer needed. Elements that are usually translated are now by default included in translations. Elements that are usually not translated, are not included. This can be overridden by setting the <code>translatable="yes/no"</code> attribute.
* Extensions (including their <code>.inx</code> files) can now be put into a subdirectory of the <code>extensions/</code> folder to allow for better structuring and separation of extensions.

==== Extension dialogs ==== 


Extension dialogs have some new input types and layout options:


* new multiline text fields
* new file chooser fields
* new <code>appearance="url"</code> for [[INX Parameters]] of type <code>"description"</code>. You can now add clickable links to your extension UI.
* a simpler version of the color chooser field has been added
* new layout options (separator, table-like layouts)
* all [[INX Parameters]] now have the common attribute <code>indent="<var>n</var>"</code> where <code><var>n</var></code> specifies the level of indentation in the extension UI.
* new <code>label</code> parameter
* new option to include an image
* some confusing options have been merged
* new effect extension attribute <code>implements-custom-gui</code> is [http://wiki.inkscape.org/wiki/index.php/INX_extension_descriptor_format#Attributes_description available] to hide the 'Extension is working' dialog.

[needs screenshot]

==== More info ==== 


Please also note the changed [[#Command Line|command line options]], if your extension calls another instance of Inkscape.


More detailed instructions for updating old extensions are available at [[Updating your Extension for 1.0]]. Also check the [https://inkscape.gitlab.io/extensions/documentation/ extension (<code>inkex</code>) API documentation] and the [https://gitlab.com/inkscape/extensions stock extensions repository] for finding comparable extensions. If you have questions about extension development, you can join us in our [https://chat.inkscape.org/channel/inkscape_extensions extension development chat channel].

=== For packagers and those who compile Inkscape === 


* <code>autotools</code> builds have been dropped. Please use <code>CMake</code> for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* <code>libsoup</code> dependency added: we use <code>libsoup</code> for making HTTP requests without a need for <code>dbus</code> and <code>gvfs</code>.
* double-conversion [https://github.com/google/double-conversion] dependency added: <code>lib2geom</code> now depends on an external version of the library.
* Inkscape now uses a git submodule for the <code>extensions/</code> directory. If you have cloned the repository and are not building from the release source code tarball, please note the [https://inkscape.org/en/develop/getting-started/ updated build instructions]
* On Ubuntu 18.04, Gnome's fallback icon set (package 'adwaita-icon-theme-full'), that is needed to display Inkscape's default icons completely, is no longer automatically installed. It has been added as a 'recommends' level dependency.
* lib2geom: [insert up-to-date info here]
* The environment variable <code>INKSCAPE_PORTABLE_PROFILE_DIR</code> has been removed. Please use the equivalent <code>INKSCAPE_PROFILE_DIR</code> instead for changing the location of the profile directory at run time. (see also [https://gitlab.com/inkscape/inkscape/issues/114 #114])
* Inkscape extensions have been updated to work with Python 3, they no longer depend on Python 2 (but still work with it)

== Known Issues== 


[as of Sept. 7th, 2019, "beta0"]


* Various warnings printed to console output
* Slowdown and temporary freezes when opening the font list
* <code>man</code> page not entirely updated yet to account for the changes in the command line interface
* Hatch fill handles are sometimes not shown on the canvas, hatchfill changes are often not displayed (only the first time)
* <code>uniconvertor</code> not available, thus some file formats can no longer be imported
* object transformation handles do not rotate along with the canvas during canvas rotation ([https://gitlab.com/inkscape/inbox/issues/69 inbox#69])


See also: [https://gitlab.com/groups/inkscape/inkscape/issues List of confirmed and ready-to-be-worked-on issues] and [https://gitlab.com/inkscape/inbox/issues List of new user submitted issues, questions and feature requests]

== Inkview == 


'''Inkview''' (a simple SVG viewer) was considerably improved and got some new features:


* Support folders as input (will load all SVG files from the specified folder)<br/>The <code>-r</code> or <code>--recursive</code> option will even allow to search subfolders recursively.
* Implement <code>-t</code> or <code>--timer</code> option which allows to set a time after which the next file will be automatically loaded.
* Add <code>-s</code> or <code>--scale</code> option to set a factor by which to scale the displayed image.
* Add <code>-f</code> or <code>--fullscreen</code> option to launch Inkview in fullscreen mode
* Many smaller fixes and improvements

== Previous releases == 


* [[Release notes/0.92]] ([[Release_notes/0.92.1 |0.92.1]], [[Release_notes/0.92.2 |0.92.2]], [[Release_notes/0.92.3 |0.92.3]], [[Release_notes/0.92.4 |0.92.4]], [[Release_notes/0.92.5 |0.92.5]])
* [[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]]

</translate>

SymbolsDialog

2017-01-15T17:40:29Z

Zearin: Fix markup ordering from my last edit (pre/code to code/pre)

=Symbols Dialog=

== Features ==

Allows copying and pasting symbols (<code><symbol></code> elements) from both the document being edited and from symbol libraries.

== Use ==

* Open ''Symbol dialog'':
** Object ▶︎ Symbol dialog..., or
** <kbd>Ctrl-Shift-Y</kbd>. (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 (<kbd>Ctrl-V</kbd>) 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 <code><symbol></code> elements defined in the <code><defs></code> section will be picked up. (<code><symbol></code> 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 <code><defs></code> section.)

Note that since 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.

=== Symbols and Styles ===

In order to allow styling of symbols from within Inkscape, styling should be kept out of <code><symbol></code> elements as much as possible. It is then possible for a symbol to inherit the styling of the <code><use></code> element that references it. In order to provide a default style to a <code><symbol></code> 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 <code>inkscape:symbol-style</code> attribute inside the <code><symbol></code> element. When a symbol is selected in the Symbol dialog, the style will be added to the <code><use></code> element in the clipboard.

=== Other Sources of Symbols ===

Visio stencil files (<code>.vss</code>) 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 <code><symbol></code> referenced by the selected <code><use></code> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <code><use></code> 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 <code><use></code> element to inherit it from).

* '''Object ▶︎ Group to Symbol'''

This converts a selected group to a <code><symbol></code> element. No <code><use></code> element is created. Any <code><use></code> 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 straightforward and avoids issues with transforms and styling.

Copying (<kbd>Ctrl-C</kbd>) and then pasting a symbol, or duplicating a symbol creates a new <code><use></code> element (clone) referencing the same symbol.

To copy a <code><symbol></code> for creating a new <code><symbol></code>, 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 useful <code>id</code> and <code>title</code> attributes via 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 <code><g></code> elements as well as <code><symbol></code> elements. A group could be marked as a symbol by adding an <code><inkscape:symbol></code> tag. In this way one can put place holders in for things like text:

<code><pre>
<g role="inkscape:symbol">
<symbol id="wrapperBox">...</symbol>
<text id="label">...</text>
</g>
</pre></code>

* 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

2017-01-15T17:39:37Z

Zearin: Markup and minor text tweaks

=Symbols Dialog=

== Features ==

Allows copying and pasting symbols (<code><symbol></code> elements) from both the document being edited and from symbol libraries.

== Use ==

* Open ''Symbol dialog'':
** Object ▶︎ Symbol dialog..., or
** <kbd>Ctrl-Shift-Y</kbd>. (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 (<kbd>Ctrl-V</kbd>) 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 <code><symbol></code> elements defined in the <code><defs></code> section will be picked up. (<code><symbol></code> 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 <code><defs></code> section.)

Note that since 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.

=== Symbols and Styles ===

In order to allow styling of symbols from within Inkscape, styling should be kept out of <code><symbol></code> elements as much as possible. It is then possible for a symbol to inherit the styling of the <code><use></code> element that references it. In order to provide a default style to a <code><symbol></code> 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 <code>inkscape:symbol-style</code> attribute inside the <code><symbol></code> element. When a symbol is selected in the Symbol dialog, the style will be added to the <code><use></code> element in the clipboard.

=== Other Sources of Symbols ===

Visio stencil files (<code>.vss</code>) 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 <code><symbol></code> referenced by the selected <code><use></code> element to a group located in the untransformed position of the symbol. The new group is left selected. Any <code><use></code> 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 <code><use></code> element to inherit it from).

* '''Object ▶︎ Group to Symbol'''

This converts a selected group to a <code><symbol></code> element. No <code><use></code> element is created. Any <code><use></code> 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 straightforward and avoids issues with transforms and styling.

Copying (<kbd>Ctrl-C</kbd>) and then pasting a symbol, or duplicating a symbol creates a new <code><use></code> element (clone) referencing the same symbol.

To copy a <code><symbol></code> for creating a new <code><symbol></code>, 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 useful <code>id</code> and <code>title</code> attributes via 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 <code><g></code> elements as well as <code><symbol></code> elements. A group could be marked as a symbol by adding an <code><inkscape:symbol></code> tag. In this way one can put place holders in for things like text:

<pre><code>
<g role="inkscape:symbol">
<symbol id="wrapperBox">...</symbol>
<text id="label">...</text>
</g>
</code></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]]

Talk:Inkscape

2014-05-07T14:57:23Z

Zearin: Minor tweaks to markup, phrasing

* The [[Working with SVN]] link must be removed from the front page. Also, consider removing the refereed SVN page from this wiki.
* Can we move the [[INX extension descriptor format]] link to '''Developer tutorials ▶︎ Extensions''', please?

== Links to languages ==

Please replace the following line in the wikitext of the page:

<nowiki>Other languages: [[Inkscape en español|Wiki en español]], [[L'Inkscape en Català|Wiki en Català]], [[Inkscape em Português|Wiki em Português]], [[Startseite|Wiki auf deutsch]]...</nowiki>

with the following line:

<nowiki>{{Main page/Localized versions}}</nowiki>

The page would still render like now, but users would be able
to link more localized versions as they write them. One cannot do that currently, because the main page is protected from editing. I guess that spambots are not clever enough to read the wiki markup and determine they could edit the template to work around protection (it's just a guess though).<br />
--[[User:Marko|Marko]] 13:27, 5 May 2012 (UTC)

Also Main Page include template <nowiki>{{Main Page/Code}}</nowiki> --[[User:아라|아라]]는 다 알아 13:44, 6 May 2012 (UTC)

'''In practice:''' Please replace the current Main Page with [http://wiki.inkscape.org/wiki/index.php?title=User:Marko/sandboxes/1&oldid=83300 this enhanced version]. In other words, copy-and-paste the wikitext that you can read [http://wiki.inkscape.org/wiki/index.php?title=User:Marko/sandboxes/1&oldid=83300&action=edit here]. This new version contains the enhancements by 아라|아라 and me, which ease the task of writing and reporting new localized versions of the main page. --[[User:Marko|Marko]] 15:59, 6 May 2012 (UTC)

== Profession-specific sections? ==

I'm interested in creating a section of this wiki for topology/geometry-oriented mathematicians using Inkscape (a pretty big group of people), where we can share profession-specific solutions, tips, etc. Does this seem appropriate?

If so, I would like to suggest that whoever can edit the main page add a section under '''User documentation''' titled '''Profession-specific documentation''' or something like that. Then I will add '''Geometry and Topology''' as an item on that page.

(I could put it under '''Tricks and Tips''', but this seems like I want to do more than just “miscellaneous advice, may be slightly outdated.” Thanks!) [[User:D.gay|D.gay]]

Architectural overview

2014-05-07T14:47:54Z

Zearin: Minor markup fix (the “tt” element isn’t supported in HTML5)

This is a high-level overview of how Inkscape works.

==Main subsystems==
Inkscape can be roughly subdivided into these subsystems:

;[[Display subsystem]]
:Responsible for rendering graphic primitives, displaying things onscreen, and providing the main canvas widget. Also dispatches events to tools. Contained in the <code>src/display/</code> directory of the source tree.
;[[XML subsystem]]
:Classes to store the parsed XML of an SVG document. Fairly generic, and doesn't contain significant SVG-specific functionality. The main distinguishing features (from something like <code>libxml++</code>) are notifications about XML changes and undo functionality. This subsystem is garbage-collected. Because XML nodes were formerly C structures called <code>SPRepr</code>, the XML tree is sometimes called the "repr tree", and XML nodes "reprs" (short for "representation").
;[[Object tree]]
:This is where the bulk of Inkscape's functionality is contained. Implements an XML-to-display primitive mapping, and provides an object hierarchy that can be modified using the tools. Based on <code>GObject</code>. Each document has an object tree and an XML tree. Changes in the XML tree are automatically propagated to the object tree via observers, but ''not'' the other way around—a function called <code>updateRepr()</code> must be explicitly called.
;[[Tools subsystem]]
:Processes input events on the canvas and translates them into document changes. Tools are called ''event contexts'' internally. This subsystem is based on <code>GObject</code>, dispersed in the <code>src/</code> directory (and several subdirectories). Files with event handling code end with <code>-context.cpp</code>.
;[[Extension subsystem]]
:Allows third-party extensions without modifying Inkscape's code. Currently, extensions may provide additional I/O formats, effects, path effects, and printing backends.
;[[Preferences subsystem]]
:Provides a shared storage for all of Inkscape's user settings. Small but relatively self-contained. Keeps the parsed XML tree of the preferences file (but it's not directly accessible). The intent is to separate preference ''implementation'' (which might not be based on an XML file in the future) from the ''API'' used to access them. Contained in <code>preferences.cpp</code>
;[[User Interface Modules]]
:Dialogs, widgets, tools, and more.

==How Inkscape starts==
# <tt>main()</tt> is called, and determines whether Inkscape was run in graphical mode or command-line mode.
## '''On Windows:''' A <tt>WinMain()</tt> stub calls <tt>main()</tt> so that the command prompt is not displayed.
# Based on the decision, either <tt>sp_main_gui()</tt> or <tt>sp_main_console()</tt>is called.
## Both call <tt>sp_common_main()</tt>, which handles parameter parsing. Parameters are parsed into several global variables. (Yes, this needs to be heavily refactored!)
# An instance of <tt>Inkscape::NSApplication::Application</tt> is created.
## This object is an unfinished attempt at converting top-level Inkscape structures to C++ classes. It creates the legacy <tt>Inkscape::Application</tt> structure and creates an instance of <tt>SPDesktop</tt> for each open document. (<tt>SPDesktop</tt> is a window used to edit a document—the main window you see when you start Inkscape. Sometimes simply called “desktop” for short.)
# The created desktops are shown.

Ta-Da!

==Historical note==
Inkscape is derived from an earlier vector drawing program called Sodipodi.

Sodipodi was written entirely in plain C using <code>GObject</code>. GObject is the C object system used by GTK+.

Writing and maintaining <code>GObject</code> code is cumbersome, because C lacks any syntax support for this system. There are still many places that use old <code>GObject</code>-based code (notably the tools and the <code>SPObject</code> tree).

An important long-term goal is to convert all <code>GObject</code> code to regular C++ objects. For the present, however, some knowledge of <code>GObject</code> is needed to develop Inkscape.

Architectural overview

2014-05-07T14:45:50Z

Zearin: Minor tweaks to markup

This is a high-level overview of how Inkscape works.

==Main subsystems==
Inkscape can be roughly subdivided into these subsystems:

;[[Display subsystem]]
:Responsible for rendering graphic primitives, displaying things onscreen, and providing the main canvas widget. Also dispatches events to tools. Contained in the <tt>src/display/</tt> directory of the source tree.
;[[XML subsystem]]
:Classes to store the parsed XML of an SVG document. Fairly generic, and doesn't contain significant SVG-specific functionality. The main distinguishing features (from something like <tt>libxml++</tt>) are notifications about XML changes and undo functionality. This subsystem is garbage-collected. Because XML nodes were formerly C structures called <tt>SPRepr</tt>, the XML tree is sometimes called the "repr tree", and XML nodes "reprs" (short for "representation").
;[[Object tree]]
:This is where the bulk of Inkscape's functionality is contained. Implements an XML-to-display primitive mapping, and provides an object hierarchy that can be modified using the tools. Based on <code>GObject</code>. Each document has an object tree and an XML tree. Changes in the XML tree are automatically propagated to the object tree via observers, but ''not'' the other way around—a function called <tt>updateRepr()</tt> must be explicitly called.
;[[Tools subsystem]]
:Processes input events on the canvas and translates them into document changes. Tools are called ''event contexts'' internally. This subsystem is based on <code>GObject</code>, dispersed in the <tt>src/</tt> directory (and several subdirectories). Files with event handling code end with <tt>-context.cpp</tt>.
;[[Extension subsystem]]
:Allows third-party extensions without modifying Inkscape's code. Currently, extensions may provide additional I/O formats, effects, path effects, and printing backends.
;[[Preferences subsystem]]
:Provides a shared storage for all of Inkscape's user settings. Small but relatively self-contained. Keeps the parsed XML tree of the preferences file (but it's not directly accessible). The intent is to separate preference ''implementation'' (which might not be based on an XML file in the future) from the ''API'' used to access them. Contained in <tt>preferences.cpp</tt>
;[[User Interface Modules]]
:Dialogs, widgets, tools, and more.

==How Inkscape starts==
# <tt>main()</tt> is called, and determines whether Inkscape was run in graphical mode or command-line mode.
## '''On Windows:''' A <tt>WinMain()</tt> stub calls <tt>main()</tt> so that the command prompt is not displayed.
# Based on the decision, either <tt>sp_main_gui()</tt> or <tt>sp_main_console()</tt>is called.
## Both call <tt>sp_common_main()</tt>, which handles parameter parsing. Parameters are parsed into several global variables. (Yes, this needs to be heavily refactored!)
# An instance of <tt>Inkscape::NSApplication::Application</tt> is created.
## This object is an unfinished attempt at converting top-level Inkscape structures to C++ classes. It creates the legacy <tt>Inkscape::Application</tt> structure and creates an instance of <tt>SPDesktop</tt> for each open document. (<tt>SPDesktop</tt> is a window used to edit a document—the main window you see when you start Inkscape. Sometimes simply called “desktop” for short.)
# The created desktops are shown.

Ta-Da!

==Historical note==
Inkscape is derived from an earlier vector drawing program called Sodipodi.

Sodipodi was written entirely in plain C using <code>GObject</code>. GObject is the C object system used by GTK+.

Writing and maintaining <code>GObject</code> code is cumbersome, because C lacks any syntax support for this system. There are still many places that use old <code>GObject</code>-based code (notably the tools and the <code>SPObject</code> tree).

An important long-term goal is to convert all <code>GObject</code> code to regular C++ objects. For the present, however, some knowledge of <code>GObject</code> is needed to develop Inkscape.

Architectural overview

2014-05-07T14:44:36Z

Zearin: Minor tweaks to markup

This is a high-level overview of how Inkscape works.

==Main subsystems==
Inkscape can be roughly subdivided into these subsystems:

;[[Display subsystem]]
:Responsible for rendering graphic primitives, displaying things onscreen, and providing the main canvas widget. Also dispatches events to tools. Contained in the <tt>src/display/</tt> directory of the source tree.
;[[XML subsystem]]
:Classes to store the parsed XML of an SVG document. Fairly generic, and doesn't contain significant SVG-specific functionality. The main distinguishing features (from something like <tt>libxml++</tt>) are notifications about XML changes and undo functionality. This subsystem is garbage-collected. Because XML nodes were formerly C structures called <tt>SPRepr</tt>, the XML tree is sometimes called the "repr tree", and XML nodes "reprs" (short for "representation").
;[[Object tree]]
:This is where the bulk of Inkscape's functionality is contained. Implements an XML-to-display primitive mapping, and provides an object hierarchy that can be modified using the tools. Based on GObject. Each document has an object tree and an XML tree. Changes in the XML tree are automatically propagated to the object tree via observers, but ''not'' the other way around—a function called <tt>updateRepr()</tt> must be explicitly called.
;[[Tools subsystem]]
:Processes input events on the canvas and translates them into document changes. Tools are called ''event contexts'' internally. This subsystem is based on GObject, dispersed in the <tt>src/</tt> directory (and several subdirectories). Files with event handling code end with <tt>-context.cpp</tt>.
;[[Extension subsystem]]
:Allows third-party extensions without modifying Inkscape's code. Currently, extensions may provide additional I/O formats, effects, path effects, and printing backends.
;[[Preferences subsystem]]
:Provides a shared storage for all of Inkscape's user settings. Small but relatively self-contained. Keeps the parsed XML tree of the preferences file (but it's not directly accessible). The intent is to separate preference ''implementation'' (which might not be based on an XML file in the future) from the ''API'' used to access them. Contained in <tt>preferences.cpp</tt>
;[[User Interface Modules]]
:Dialogs, widgets, tools, and more.

==How Inkscape starts==
# <tt>main()</tt> is called, and determines whether Inkscape was run in graphical mode or command-line mode.
## '''On Windows:''' A <tt>WinMain()</tt> stub calls <tt>main()</tt> so that the command prompt is not displayed.
# Based on the decision, either <tt>sp_main_gui()</tt> or <tt>sp_main_console()</tt>is called.
## Both call <tt>sp_common_main()</tt>, which handles parameter parsing. Parameters are parsed into several global variables. (Yes, this needs to be heavily refactored!)
# An instance of <tt>Inkscape::NSApplication::Application</tt> is created.
## This object is an unfinished attempt at converting top-level Inkscape structures to C++ classes. It creates the legacy <tt>Inkscape::Application</tt> structure and creates an instance of <tt>SPDesktop</tt> for each open document. (<tt>SPDesktop</tt> is a window used to edit a document—the main window you see when you start Inkscape. Sometimes simply called “desktop” for short.)
# The created desktops are shown.

Ta-Da!

==Historical note==
Inkscape is derived from an earlier vector drawing program called Sodipodi.

Sodipodi was written entirely in plain C using <code>GObject</code>. GObject is the C object system used by GTK+.

Writing and maintaining <code>GObject</code> code is cumbersome, because C lacks any syntax support for this system. There are still many places that use old <code>GObject</code>-based code (notably the tools and the <code>SPObject</code> tree).

An important long-term goal is to convert all <code>GObject</code> code to regular C++ objects. For the present, however, some knowledge of <code>GObject</code> is needed to develop Inkscape.

Lib2geom

2014-05-07T14:41:02Z

Zearin: Minor markup tweaks

I’ve started this page on the Inkscape Wiki to help the <code>lib2geom</code> team with some developer documentation. As this material matures it can be moved to the “Developer Documentation” section of the wiki instead of where it currently resides. (2006-09-01 Scott Huey)

[[lib2geom Goals]]

[[lib2geom FAQ]]

[[WorkingWith2GeomFAQ]]: real-life questions answered about using <code>2Geom</code> in real code

[[lib2geom SVN Repository Guide]]

[[lib2geom py2geom]]: Python bindings to <code>2geom</code>. With this you can use the power of <code>2geom</code> in Python scripts.

Release notes/0.91

2014-05-07T14:36:00Z

Zearin: Fixed list markup

{{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, typography extensions
* Measure tool
* Type design features
* 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 [http://partha.com/ Partha]
* Native Mac OS X build? (Valerio Aimale?) [http://inkscape.13.x6.nabble.com/Mac-OS-X-Mountain-Lion-x86-64-packaging-of-0-48-4-td4965851i20.html Mailing List discussion]
* 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 two example libraries, one for logic symbols and another for AIGA/DOT transportation symbols. 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).

=== 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 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.
* 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>).

===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.

===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==

* The <code>clip-rule</code> property is now supported. No UI to set it exists at the moment, other than the XML editor.
* The <code>color-interpolation-filters</code> property is now supported meaning that non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. No UI is yet available to set the property. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.

== 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.

==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 with an out-of-tree patch to Cairo. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]

==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.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

2014-05-07T14:35:25Z

Zearin: Fixed a markup SNAFU from my last edit :)

{{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, typography extensions
* Measure tool
* Type design features
* 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 [http://partha.com/ Partha]
* Native Mac OS X build? (Valerio Aimale?) [http://inkscape.13.x6.nabble.com/Mac-OS-X-Mountain-Lion-x86-64-packaging-of-0-48-4-td4965851i20.html Mailing List discussion]
* 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 two example libraries, one for logic symbols and another for AIGA/DOT transportation symbols. 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).

=== 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 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.
* 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>).

===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.

===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==

* The <code>clip-rule</code> property is now supported. No UI to set it exists at the moment, other than the XML editor.
* The <code>color-interpolation-filters</code> property is now supported meaning that non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. No UI is yet available to set the property. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.

== 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.

==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 with an out-of-tree patch to Cairo. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]

==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.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

2014-05-07T14:33:58Z

Zearin: Lots and lots of small tweaks to markup, formatting, and phrasing (no major content edits)

{{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, typography extensions
* Measure tool
* Type design features
* 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 [http://partha.com/ Partha]
* Native Mac OS X build? (Valerio Aimale?) [http://inkscape.13.x6.nabble.com/Mac-OS-X-Mountain-Lion-x86-64-packaging-of-0-48-4-td4965851i20.html Mailing List discussion]
* 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 two example libraries, one for logic symbols and another for AIGA/DOT transportation symbols. 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 <pre class="file">symbols</pre> directory in your configuration directory (typically <pre class="file">share/inkscape</pre>). 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 <pre class="file">symbols</pre> 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).

=== 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 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.
* 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>).

===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.

===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==

* The <code>clip-rule</code> property is now supported. No UI to set it exists at the moment, other than the XML editor.
* The <code>color-interpolation-filters</code> property is now supported meaning that non-Inkscape filters that specify <code>linearRGB</code> color interpolation will render properly. No UI is yet available to set the property. Filters created inside Inkscape will still use <code>sRGB</code> color interpolation by default.

== 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.

==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 with an out-of-tree patch to Cairo. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]

==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.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

2014-05-07T13:55:23Z

Zearin: Tweaked markup

{{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, typography extensions
* Measure tool
* Type design features
* 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 [http://partha.com/ Partha]
* Native Mac OS X build? (Valerio Aimale?) [http://inkscape.13.x6.nabble.com/Mac-OS-X-Mountain-Lion-x86-64-packaging-of-0-48-4-td4965851i20.html Mailing List discussion]
* 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. '''Shift+numpad5''' 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 (pt) and is customizable (px,pt,pc,mm,cm,in,em)
* Text toolbar shows full list of font style variants for that font
* Files with text in em 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. There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (z-index) order, or just exchange them clockwise based on the object's position on the page.
[[File:Swap-objects.gif]]

* Keyboard shortcuts (Ctrl+Alt+Keypad numbers) 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 Alt+mouse wheel scroll to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use Shift+Alt+mouse wheel 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 All / 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 two example libraries, one for logic symbols and another for AIGA/DOT transportation symbols. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <symbol> 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 ''symbols'' directory in your configuration directory (typically ''share/inkscape''). 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 (.vss) can also be used by dropping them in the same "symbols" 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 one at start, one at end, one somewhere in the middle along the path.
* adding nodes: Ctrl+click purple knot
* deleting nodes: Ctrl+Alt+click 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 Shift+D, 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 (libdepixelize) ===
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).

=== 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 ALT+key 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 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.
* Compressed SVG and media export extension improvements. New options: set an image directory in the zip file, and 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 --export-text-to-path 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 label attribute or, if not set, the id 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 'calc' package must be included in the preamble. Then the image can be scaled by defining '\svgscale' instead of '\svgwidth'.
* The font shape is now also exported. '\textit{}' for italic text, '\textbf{}' for bold text, and '\textsl{}' (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape and not '''italic''', so 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 inkex.unittouu and inkex.uutounit had to be modified and moved to the inkex.Effect class. The unit conversion calls should be replaced with inkex.Effect.unittouu and inkex.Effect.uutounit calls (usually "self.unittouu" and "self.uutounit").

===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 the text elements of the document 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.

===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 float and int extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with msgctxt).
* New sub-menus in the Render menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

* The <tt>clip-rule</tt> property is now supported. No UI to set it exists at the moment, other than the XML editor.
* The <tt>color-interpolation-filters</tt> property is now supported meaning that non-Inkscape filters that specify "linearRGB" color interpolation will render properly. No UI is yet available to set the property. Filters created inside Inkscape will still use "sRGB" color interpolation by default.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked, both in the underlying code as well as in the GUI. This should make the snapping preferences easier to understand, easier to maintain, and make it easier to 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 (X/Y/width/height) are much more accurately applied.

==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 with an out-of-tree patch to Cairo. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]

==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.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

2014-05-07T13:53:26Z

Zearin: Unicode is your friend

{{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, typography extensions
* Measure tool
* Type design features
* 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 [http://partha.com/ Partha]
* Native Mac OS X build? (Valerio Aimale?) [http://inkscape.13.x6.nabble.com/Mac-OS-X-Mountain-Lion-x86-64-packaging-of-0-48-4-td4965851i20.html Mailing List discussion]
* 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. '''Shift+numpad5''' 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 (pt) and is customizable (px,pt,pc,mm,cm,in,em)
* Text toolbar shows full list of font style variants for that font
* Files with text in em 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. There are also two other new buttons in the dialog that allow the artist to exchange the selected objects based on the stacking (z-index) order, or just exchange them clockwise based on the object's position on the page.
[[File:Swap-objects.gif]]

* Keyboard shortcuts (Ctrl+Alt+Keypad numbers) 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 Alt+mouse wheel scroll to cycle through all items that are stacked on top of each other at the location of the mouse pointer (use Shift+Alt+mouse wheel 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 All / 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 two example libraries, one for logic symbols and another for AIGA/DOT transportation symbols. The dialog will also create a pseudo-library of all existing symbols in the current Inkscape drawing.
(A symbol is defined by an SVG <symbol> 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 ''symbols'' directory in your configuration directory (typically ''share/inkscape''). 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 (.vss) can also be used by dropping them in the same "symbols" 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 one at start, one at end, one somewhere in the middle along the path.
* adding nodes: Ctrl+click purple knot
* deleting nodes: Ctrl+Alt+click 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 Shift+D, 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 (libdepixelize) ===
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).

=== 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 ALT+key 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. For example: "2 * 3", "50 + 100", or "((12 + 34) * (5 + 5) - 2) / 2".
Moreover, you can use units in entering values, like "2 + 2 cm". 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 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.
* Compressed SVG and media export extension improvements. New options: set an image directory in the zip file, and 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 --export-text-to-path 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 label attribute or, if not set, the id 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 'calc' package must be included in the preamble. Then the image can be scaled by defining '\svgscale' instead of '\svgwidth'.
* The font shape is now also exported. '\textit{}' for italic text, '\textbf{}' for bold text, and '\textsl{}' (slanted) for oblique text. It is important to note that '''Arial''' has an '''oblique''' font shape and not '''italic''', so 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 inkex.unittouu and inkex.uutounit had to be modified and moved to the inkex.Effect class. The unit conversion calls should be replaced with inkex.Effect.unittouu and inkex.Effect.uutounit calls (usually "self.unittouu" and "self.uutounit").

===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 the text elements of the document 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.

===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 float and int extension parameters (full and minimal modes).
* Extension parameters values (''except attributes!'') can now be contextualized for translation (with msgctxt).
* New sub-menus in the Render menu, grouping the bar-codes, grids and layout extensions.

==SVG Support==

* The <tt>clip-rule</tt> property is now supported. No UI to set it exists at the moment, other than the XML editor.
* The <tt>color-interpolation-filters</tt> property is now supported meaning that non-Inkscape filters that specify "linearRGB" color interpolation will render properly. No UI is yet available to set the property. Filters created inside Inkscape will still use "sRGB" color interpolation by default.

== Snapping ==
* The snapping preferences and the snap toolbar have been reworked, both in the underlying code as well as in the GUI. This should make the snapping preferences easier to understand, easier to maintain, and make it easier to 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 (X/Y/width/height) are much more accurately applied.

==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 with an out-of-tree patch to Cairo. [https://bugs.freedesktop.org/show_bug.cgi?id=41745]

==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.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]]

Developer manual

2012-03-05T16:52:31Z

Zearin: Tweaked markup, some formatting, and a little phrasing.

= Inkscape Developer’s Manual =

== Introduction ==

For those of you just joining us, or who have been with us but are just
now getting the itch to work on Inkscape, I thought I’d give some tips
for how to get started working in the codebase based on our own
experiences.

One of the first things most people wonder is “What should I work on?”.
As you may have already noticed, we generally don’t “assign” projects.
We figure there’s plenty more work to do than people to do it, so you
may as well work on something that you’re either interested in or that
adds something of benefit to you; that’s extra motivation to get your
own itches scratched.

If you’re really stumped though, we keep a detailed [[Roadmap]] in wiki that
you’re welcome to browse through to look for ideas of things to work
on. Tasks that do not have names beside them are open for anyone to
take; if you want to take ownership of a task, just put your name beside
it. Feel free to add or reword tasks as needed, although try not to
load up the current milestone with tasks that aren’t critical for the
release. Feel free to work on stuff that is several milestones down the
road; there’s rarely any problem with getting stuff done sooner than
planned. ;-)

We have a process for gaining SVN commit access. The reason is that
while it is important that we keep access to the codebase open, we don’t
want to be crazy and leave it wide open to any random passer-by. The
process is that we require that the person make two contributions
(patches, documentation, web collateral, etc.) and then make a request
to get account access.

In general you won’t need SVN commit access in order to start doing
development, because you can work from an anonymous checkout and create
patches. If you’ve not done this before, you’ll need to learn this
skill first (basically see docs for `svn diff`).

When you first start hacking on Inkscape code, I wouldn’t recommend
taking an objective of implementing a specific feature, because you will
need some time to familiarize yourself with the codebase, and because
you won’t really know what features are going to be straightforward to
implement and which will be highly challenging. Of course, if you have
the time and love adventures, this might be a fun way to go.

There are four approaches that I’ve seen people effectively use in
getting into the codebase:

<ul>
<li><strong>Write code documentation.</strong> Some people who don’t mind adding
comments to code or writing docs find it useful to just go through
code they’re interested in working on and writing up what it does.
The codebase is in dire need of better docs, so this approach pays
dividends well into the future.
</li>

<li><strong>Fix bugs.</strong> Tracing down the cause of reported bugs is an effective
way to gain understanding of the codebase in small chunks. Many
common bugs can be traced down and fixed in a matter of hours, and
often will identify some bit of code in need of refactoring or
extension. Note that some of our older bugs are in the system
because they’re hard to fix, so you’ll want to work on the more
recent ones.
</li>

<li><strong>Chip in on a group effort.</strong> Occasionally we identify a major
refactoring effort (such as when we converted from C to C++), that
we encourage lots of people to help on, in the philosophy that many
hands makes short work. This work tends to be pretty rote so is
not hard for new folks to get involved with; it just takes time. We
generally have one of these kinds of efforts per release. It
usually isn’t glamorous work, but in aggregate moves the codebase
forward in a major way.
</li>

<li><strong>Subsystem/module work.</strong> Some people want to get their hands in the
details quick, so take the approach of developing new code separate
from the codebase, to be integrated in later. This generally tends
to take a larger time commitment than the other approaches, but can be
an effective approach in some circumstances. We have a SVN module
called <code>experimental</code> that you’re welcome to house your work until
it’s ready for prime time.
</li>
</ul>

Beyond that, you’re going to find the documentation for the Inkscape
code is pretty scarce. We’ve worked on bits and pieces but
unfortunately the vast majority of the code is undocumented. On the
plus side, often you can implement the stuff you care about after
learning only a limited portion of the codebase.

I think you’d find Inkscape an enjoyable Open Source project to work on.
There’s a huge range of interesting and useful skills that can be
learned from it, plus the developers are great guys to participate with.
The project itself runs smoothly and puts a premium on keeping things
friendly and low-stress, so heated arguments are rare. The users have
been great to work with and very appreciative of even small new features
and fixes. Plus, since Inkscape is so visual in nature, it’s very cool
to see how your little changes make noticeable improvements to the app
overall.

== C++ Reference ==
* FAQ (with answers) sheet. We strongly recommend that everyone read this site comprehensively. You should not need to bookmark it, it should be the first of the sites on your autocomplete list for <code>par</code>!

http://www.parashift.com/c++-faq-lite/

It is actually more in-depth than the name FAQ suggests. Many experienced C++ programmers would benefit from it.

* List of <s>[http://www.cs.helsinki.fi/u/vkarvone/2004s/cplusplus/errors.html schoolboy errors] (Broken Link)</s>. None of these should appear in [http://en.wikipedia.org/wiki/Free/Libre/Open-Source_Software FLOSS] code.

== Strings ==
Please make sure any user-visible strings are localizable. This requires wrapping them with "_(" and ")", like so:

<code>"Select object"</code>
becomes
<code>_("Select object")</code>

In case the interpretation of the string may be ambiguous or may differ according to context, you can add a context prefix (that won't be displayed) in order to eliminate the ambiguity.
<code>"Ambiguous string"</code>
can then become
<code>C_("Context", "Ambiguous string")</code>

For more complex things, please check the gettext/localization documentation.
See also http://library.gnome.org/devel/glib/unstable/glib-I18N.html

== Implementing User Interface Changes ==

[[UI improvements]] are enjoyable to work on because they produce visible changes in how Inkscape works. These improvements are one of the most tangible ways to help improve how Inkscape works; thus, we strongly support new developers wishing to work in these areas.

It is also very important to us that Inkscape presents an organized, productive, and easily discoverable interface to users. Because of this it is important that new Inkscape UI developers work to ensure changes make Inkscape’s UI *more* consistent, *more* flexible, *more* cohesive, and so on. We don’t have firm rules about what can and cannot done, in order to ensure plenty of freedom for innovation. However, we can outline some general principles and guidelines that are important to keep in mind:

<strong>Don’t please the artist—BE the artist.</strong> Many times UI is designed and created by programmers who “understand what the user wants”. But in Inkscape we believe that the best requirements list is the list inside the user’s head. Requirements docs, usability studies, and so on are very indirect ways of transferring this gut-level understanding from user to programmer. We believe the best way to ensure this information is communicated clearly is for the user to BE the programmer. Or, alternatively, for the programmer to BECOME a user.

This is why we so strongly encourage users to get involved in coding, and why we so strongly encourage programmers to focus on the features that are most important to them personally. This is also why it is absolutely critical to pay close attention to what users report when using a new feature—often they can tip you off to alternate designs that achieve the same result in a better way.

<strong>Eliminate limitations.</strong> Commercial software is often developed to fulfill feature requirement lists from a marketing department. As such, it’s common to see the feature implemented to meet the requirement exactly, and no more. However, especially with artistic software, art is often found outside what seems reasonable. So when putting in a new feature, avoid the temptation to limit it to what you expect people to use it for—instead generalize it and open as many parameters as possible for tweaking, and let the artist decide what is reasonable. That’s their job.

As an example, a drawing program might want to support the features “feather” and “drop shadow”. Obviously, users need these important features. Commercial software may well implement these as distinct features, each with their own UI controls. However, these features are just special cases of the more general gaussian blur, and in Inkscape we implemented *that*. With that in place, artists can do feathering and blur, <em>and</em> a variety of other effects.

It is interesting to note that, as an open collaborative standard, SVG
necessarily has the same goals as Inkscape: a minimum set of
universal, well thought-out building blocks that can accommodate the
widest possible range of graphics and applications. Thus, simply by
following the SVG philosophy, Inkscape scores quite a few important
points over commercial software. Live clones, patterns that can be contain any
objects, layers that are essentially groups and can be easily
converted to/from groups. These are all examples where the underlying
universality of SVG directly translates into extremely valuable user
features.

== Implementing New SVG Features ==

The most important way to help Inkscape is to implement a new SVG feature in it. Our hope is to eventually support ALL SVG features, so if you can help check one off the list, it brings us close to the nirvana of 100% SVG compliance. :-)

Generally we find that implementation of an SVG feature goes through three discrete stages:

<ol>
<li>Find the appropriate tags and attributes in the SVG spec</li>
<li>Implement support for rendering files with these tags</li>
<li>Implement support for UI controls to edit the tags</li>
</ol>

Step 1 is mostly a research project. Start by reading the SVG spec so you
can learn about the tag, the attributes that go with it, and so forth.
It is good practice to set up a page in the Wiki for storing your notes
as you do this process, so that in case you don’t make it to steps 2 and
3, then maybe someone else can benefit from your research.

Step 2 is the fun part. It helps to be comfortable with Inkscape internals
for this part. Depending on the feature, it may require advanced
knowledge of transformation, rendering, document management, and so on.
For this part, just hand-edit an SVG file to put the tags in that you
found in step #1, and keep plugging away at the code until Inkscape
displays things as the specification dictates. It can help to compare
your work with Batik, as we use that program as our reference
implementation.

Step 3 is the most important stage. It is the point at which the
feature becomes available for users. This step often requires knowledge
of Gtk+, for creating dialogs, widgets, menus, etc. for allowing the
user to edit the characteristics of the feature. Be sure to listen to
feedback from other developers and users—especially if there are
different opinions. It is hard to come up with UI that everyone can
agree on, but it is worth the work to achieve this—the more critique
your UI survives, the better loved the feature will be for future users.

Looking through Inkscape’s history, these stages are often done by different people. If you’re new to Inkscape, you may find working on stages 1 and 3 easiest, but there are many developers who can answer questions when you’re ready to dig into the internals, so don’t be afraid to ask questions!

== Standards Compliance - Extension Namespaces ==

* Only elements and attributes from our extension namespaces that ''do not affect rendering'' may be saved in SVG documents.
* Generally, this means that extension elements and attributes should only be used to provide UI hints.
* Extension elements and attributes should ''only'' be used where an existing facility provided by XML or SVG is not sufficient.

== Global Verbs ==

Here’s a readers’ digest summary of how Inkscape accelerators work:

A global mapping between key combinations and integer verb IDs
(<code>sp_verb_t</code>) is maintained in <code>shortcuts.cpp</code>; these are registered using
<code>sp_shortcut_set()</code>.

Given an <code>sp_verb_t</code> and an <code>SPView</code>, you can get an SPAction which
represents that action in that view. These mappings are currently
hard-coded in <code>verbs.cpp</code>.

<code>SPActions</code> derive from <code>NRActiveObject</code>, which putatively provides a
“lightweight” method of doing callbacks (vs <code>GObject</code> signals). I
don’t completely understand how it works.

<code>SPActions</code> also contain the label, image, etc, used for buttons and
menuitems.

<code>sp_shortcut_invoke()</code> looks up the <code>SPAction</code> for a keypress and <code>SPView</code> and
invokes it automatically. <code>SPEventContexts</code> call it for keypresses that they do not handle themselves.

== Garbage collection ==

As you know, many automatic garbage collectors (like <code>libgc</code>) only
free and recycle memory periodically. This means you may have some
extra slush that could be freed, but hasn’t yet.

There are other forces at work, though...

Pretty much all allocators, whether automatic or not, whether the
system <code>malloc()</code> or some custom allocator like <code>libgc</code>’s, work the
same way: they request large blocks of memory from the operating
system, then divvy those blocks into smaller ones internally to
satisfy application allocation requests.

When an application frees memory, that memory is usually recycled
internally rather than returned to the OS immediately. The reason
for this is that the large memory blocks acquired from the OS must
be completely unused before they can actually be freed.

For example, let’s say an allocator acquires 16 8MB blocks from
the OS in response to 32768 4k application allocations...

In a worst-case scenario, it’s possible that the application could
free 32752 of those 4k blocks but the remaining 16 4k just happen
to be distributed across the 16 8MB blocks requested from the OS.

If that happens, from the application’s point of view it may only
have 64k allocated, but as far as the OS is concerned, it’s still
using 128MB!

Note that this applies to nearly all allocators in common use.

While it’s unusual for things to get quite that bad, memory
fragmentation is common enough that many popular allocators (for
example Perl’s) simply don’t bother trying to return memory to the
OS at all (the memory will still get forcibly reclaimed by the OS
when the process exits).

[ FWIW, <code>libgc</code>’s allocator is one of the ones that _does_ make an
effort to release memory to the OS, but it is limited by
fragmentation like any other ]

Also note that for various reasons, the statistics you get from the
OS aren’t going to directly reflect the amount of heap-allocated
memory. Be careful drawing conclusions from only looking at e.g.
the output of <code>top(1)</code>...

(The worst thing is, due to the modern practice of
overcommitting memory, the OS may literally lie to an application
about the amount of memory it is being given, hoping the
application won’t really try to use it all.)

The best approach to evaluating memory usage is if you can ask the
allocator for information on memory usage directly, as that matches
the world from the point of view of the application.

leftover gradients/markers/patterns will get automatically cleaned up when the objects that use them are deleted.

Caveats:

* this only applies to such objects created with a build of Inkscape which post-dates this commit (June 7 2004) 

* not all automatically-created objects will necessarily be collected; the code that creates them needs to be updated to set the correct collection policy

* paint objects won’t get collected until another editing operation takes place, since <code>NRArenaShape</code> currently holds onto an <code>SPStyle</code> for too long

Technical details:

Assuming its collection policy permits it, an object will be collected
if neither it nor its descendants have any outstanding inter-document
URI references (nonzero <code>SPObject::hrefcount</code>).

There are two “policies” for collecting orphans:

* “with-parent” - the object will only be collected if one of its ancestors is collected

* “always” - the object is always collected if unused

(a third policy might be “never”, which would necessarily also prevent
that object’s ancestors from ever being collected; I do not plan on
implementing it)

The policy in effect is determined by the inkscape:collect attribute.

Be careful with the “always” policy; it really only makes sense for
“private” objects that are indirectly created behind the scenes (e.g. by
selecting a fill or marker option in the GUI).

<code>SPDocument</code> manages a queue of objects to collect; <code>SPObject</code> handles the machinery for actually queueing them when their <code>hrefcount</code> falls (based on policy), and performing the actual collection (<code>delete</code>).
<code>SPDocument::collectObjects()</code> performs a collection pass. It’s currently only called from <code>sp_document_maybe_done()</code>.

== Inkscape Experimental SVN ==

The <code>experimental</code> module in Inkscape SVN is provided as a kind of “scratchpad” for
working up new ideas that aren’t quite ready for folding into the main codebase.
This includes architectural sketches, examples, experimental patchsets, tools & utilities, or
whatever else strikes the developer’s fancy.

Please create a subdirectory within <code>experimental/</code> for your work. You’re welcome to either post
the stuff at the top level or create a subdirectory for yourself. Things linked in at the top level
should be considered fair game for other developers to collaborate on; items posted under
a developer’s username should be considered ask-first. Same sort of idea as wiki.

One of the principles behind this module is the idea of a shared working space. Other developers
working in experimental can fairly easily see what others are working on in the tree, and perhaps
borrow or contribute ideas back and forth. Since it is by definition not ‘production’ code, the
work may be incomplete or in a non-compileable state...and that’s okay.

When an experiment has matured to the point of being actually useful, please move it out of
the experimental module to someplace more appropriate. Alternatively, if the experimental work has become obsolete or irrelevant, please remove it so we can avoid having the experimental tree get too bulky.

== Directory Organization ==

=== Distribution / Packaging Files ===

Files related to generation of distribution packages should go under inkscape/packaging, as follows:

inkscape/packaging/
common/
debian/
fedora/
fink/
mandrake/
suse/

=== "Share" Collateral ===

A variety of items are installed in addition to the program itself, and placed into a <code>share</code> directory structured as follows:

AUTHORS
NEWS
clipart/
examples/
extensions/
fonts/
gradients/
icons/
keyboards/
markers/
palettes/
patterns/
screens/
about.svg
templates/
tutorials/

In the SVN codebase, all of these are placed in <code>inkscape/share/</code> (except <code>AUTHORS</code> and <code>NEWS</code> which will be copied to share during installation. The idea is that in theory, this entire tree structure can be copied into place on the user’s machine.

However, we need to provide the user some level of control over the installation. They may wish to exclude some items, or may wish to augment the default install with some items external to the Inkscape package. For example, they may wish to incorporate external clipart collections. One approach would be to install symlinks in the given component directory to the external collection. For example, if the flags package were to install into <code>/usr/share/flags-svg/</code>, we’d just symlink there.

=== Code modules ===
Several parts of the code were written in a modular way, and they have been
accordingly placed in subdirectories of <code>src/</code>, while the main src directory
still contains the biggest part. To get a first overview of the modules, you
might want to have a look at these dependency graphs before you read deeper
into the source code (outside at the moment):

[http://www.ark.in-berlin.de/gri-debug.svgz]
[http://www.ark.in-berlin.de/gri-dialogs.svgz]
[http://www.ark.in-berlin.de/gri-display.svgz]
[http://www.ark.in-berlin.de/gri-io.svgz]
[http://www.ark.in-berlin.de/gri-libcroco.svgz]
[http://www.ark.in-berlin.de/gri-libnr.svgz]
[http://www.ark.in-berlin.de/gri-libnrtype.svgz]
[http://www.ark.in-berlin.de/gri-livarot.svgz]
[http://www.ark.in-berlin.de/gri-widgets.svgz]
[http://www.ark.in-berlin.de/gri-xml.svgz]

These are not all modules! For questions about how to generate these graphs
with graph-includes, please [mailto:rwst@users.sf.net].

Question on <code>.svgz</code> files: Is the server sending the right <code>Content-Encoding:</code> header?
This matters to Mozilla browsers in standards compliance mode! http://jwatt.org/svg/authoring/#server-configuration

= See Also =
* [[DirectoryReorgProposal]]
* [[InkscapeJanitors]]
* [[CompilingInkscape]]

= Links =
[http://advogato.org/article/51.html Software Quality]

[[Category:Developer Documentation]]

INX extension descriptor format

2010-07-21T15:27:02Z

Zearin: Tweaked markup for code examples (and made smaller to reduce vertical scrolling; these examples are obviously intended for copy-pasting :)

== Introduction ==

In order for Inkscape to make use of an external script or program, you must describe that script to inkscape using an INX file. See the inkscape share directory for examples. The INX file allows the author to:
* label strings for translation
* define parameters
* chain extensions
* etc
Be sure to read through the INX files that come with Inkscape. Nothing beats a working example.

== Localisation of extensions ==

To allow localisation of strings in extension for Inkscape, some xml tags have to be adapted to variant readable by intltool. It means that tags or parameters has to have "_" prepended to their name, e.g. <tt><_name>name of extension</_name></tt>

Also the path to the extension has to be included in POTFILES.in file to tell intltool where to look for translatable content.

Useful information, before this section gets fully updated, can be found at [http://gould.cx/ted/blog/Translating_Custom_XML Ted's blog].

== Example ==
More example INX files are available in the Inkscape distribution or in the Inkscape [http://inkscape.svn.sourceforge.net/viewvc/inkscape/inkscape/trunk/share/extensions/ SVN repository].

<small><code><pre>
<inkscape-extension>
<_name>{Friendly Extension Name}</_name>
<id>{org.domain.sub-domain.extension-name}</id>
<dependency type="executable" location="[extensions|path|plugins|{location}]">program.ext</dependency>
<param name="tab" type="notebook">
<page name="controls" _gui-text="Controls">
<param name="{argumentName}" type="[int|float|string|boolean|description]" min="{number}" max="{number}"
_gui-text="{Friendly Argument Name}">{default value}</param>
</page>
<page name="help" _gui-text="Help">
<param name="help_text" type="description">{Friendly Extension Help}</param>
</page>
</param>
<effect>
<object-type>[all|{element type}]</object-type>
<effects-menu>
<submenu _name="{Extension Group Name}"/>
</effects-menu>
</effect>
<script>
<command reldir="extensions" interpreter="[python|perl|ruby|bash|{some other}]">program.ext</command>
</script>
</inkscape-extension>
</pre></code></small>

== DTD ==
<small><code><pre>
<!ELEMENT inkscape-extension (name, id, dependency*, param*,(input|output|effect),(script|plugin))>
<!ELEMENT input (extension, mimetype, filetype, filetypetooltip, output_extension?)>
<!ELEMENT output (extension, mimetype, filetype, filetypetooltip, dataloss?)>
<!ELEMENT effect (object-type|submenu?)>
<!ELEMENT script (command, helper_extension*, check*)>
<!ELEMENT plugin (name)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT id (#PCDATA)>
<!ELEMENT item (#PCDATA)>
<!ELEMENT option (#PCDATA)>
<!ELEMENT dependency (#PCDATA)>
<!ELEMENT param (#PCDATA|page|item|option)*>
<!ELEMENT page (#PCDATA, param*)>
<!ELEMENT extension (#PCDATA)>
<!ELEMENT mimetype (#PCDATA)>
<!ELEMENT filetype (#PCDATA)>
<!ELEMENT filetooltip (#PCDATA)>
<!ELEMENT object-type (#PCDATA)>
<!ELEMENT command (#PCDATA)>
<!ELEMENT check (#PCDATA)>
<!ELEMENT dataloss (#PCDATA)>
<!ELEMENT helper_extension (#PCDATA)>
<!ELEMENT output_extension (#PCDATA)>

<!ATTLIST check reldir (absolute|path|extensions|plugins) #REQUIRED>
<!ATTLIST command reldir (absolute|path|extensions|plugins) #REQUIRED>
<!ATTLIST command interpreter CDATA #REQUIRED>
<!ATTLIST dependency type (executable|extension) #REQUIRED>
<!ATTLIST dependency location (absolute|path|extensions|plugins) #IMPLIED>
<!ATTLIST dependency description CDATA #IMPLIED>
<!ATTLIST effect needs-live-preview (true|false) #REQUIRED>
<!ATTLIST page name CDATA #REQUIRED>
<!ATTLIST page gui-text CDATA #IMPLIED>
<!ATTLIST param name CDATA #REQUIRED>
<!ATTLIST param type (int|float|string|boolean|enum|notebook|description|optiongroup|color) #REQUIRED>
<!ATTLIST param min CDATA #IMPLIED>
<!ATTLIST param max CDATA #IMPLIED>
<!ATTLIST param max_length CDATA #IMPLIED>
<!ATTLIST param precision CDATA #IMPLIED>
<!ATTLIST param gui-text CDATA #IMPLIED>
<!ATTLIST param gui-tip CDATA #IMPLIED>
<!ATTLIST param gui-description CDATA #IMPLIED>
<!ATTLIST param scope CDATA #IMPLIED>
<!ATTLIST param gui-hidden CDATA #IMPLIED>
<!ATTLIST param appearance (minimal|) "">
<!ATTLIST submenu name CDATA #REQUIRED>
</pre></code></small>

== Relax NG Compact (RNC) ==
<small><code><pre>
datatypes xs = 'http://www.w3.org/2001/XMLSchema-datatypes'
namespace inkscape = 'http://www.inkscape.org/namespaces/inkscape'
default namespace local = ''

# Initially created from a Trang conversion.
# Edited for readability.
#
# @author Zearin
# @date 2010-07-21T11:02:00

start = inkscape-extension

#-------------------------------------------------------------------------------
# ELEMENTS
#===============================================================================
inkscape-extension =
element inkscape-extension
{
name,
id,
dependency*,
param*,
(input | output | effect),
(script | plugin)
}

input =
element input
{
extension,
mimetype,
filetype,
filetypetooltip,
output_extension?
}

output =
element output
{
extension,
mimetype,
filetype,
filetypetooltip,
dataloss?
}

effect = element effect { attlist.effect, (object-type | submenu?) }
script = element script { command, helper_extension*, check* }
plugin = element plugin { name }
name = element name { text }
id = element id { text }
item = element item { text }
option = element option { text }
dependency = element dependency { attlist.dependency, text }
param = element param { attlist.param, (text | page | item | option)* }
page = element page {text, param*}
extension = element extension { text }
mimetype = element mimetype { text }
filetype = element filetype { text }
filetooltip = element filetooltip { text }
object-type = element object-type { text }
command = element command { attlist.command, text }
check = element check { attlist.check, text }
dataloss = element dataloss { text }
helper_extension = element helper_extension { text }
output_extension = element output_extension { text }

#-------------------------------------------------------------------------------
# ATTRIBUTE LISTS
#===============================================================================
attlist.check =
attribute reldir { "absolute" | "path" | "extensions" | "plugins" }

attlist.command =
(
attribute reldir { "absolute" | "path" | "extensions" | "plugins" },
attribute interpreter { text }
)

attlist.dependency =
(
attribute type { "executable" | "extension" },
attribute location { "absolute" | "path" | "extensions" | "plugins" }?,
attribute description { text }?
)

attlist.effect =
attribute needs-live-preview { "true" | "false" }

attlist.page =
(
attribute name { text },
attribute gui-text { text }?
)

attlist.param =
(
attribute name { text },
attribute type {
"int"
| "float"
| "string"
| "boolean"
| "enum"
| "notebook"
| "description"
| "optiongroup"
| "color"
},
attribute min { text }?,
attribute max { text }?,
attribute max_length { text }?,
attribute precision { text }?,
attribute gui-text { text }?,
attribute gui-tip { text }?,
attribute gui-description { text }?,
attribute scope { text }?,
attribute gui-hidden { text }?,
attribute appearance {'minimal'|''}
)

attlist.submenu = attribute name { text }

#-------------------------------------------------------------------------------
# MISC
#===============================================================================
filetypetooltip |= notAllowed
page |= notAllowed
submenu |= notAllowed
</pre></code></small>

== See Also ==
*[[INX Parameters]]
*[[ScriptingHOWTO]]

[[Category:Developer Documentation]]
[[Category:Help Wanted]]
[[Category:Extensions]]

INX extension descriptor format

2010-07-21T15:24:43Z

Zearin: Created a Relax NG-Compact example from the DTD. Used Trang for initial conversion, then edited to enhance readability and leverage RNC syntax.

== Introduction ==

In order for Inkscape to make use of an external script or program, you must describe that script to inkscape using an INX file. See the inkscape share directory for examples. The INX file allows the author to:
* label strings for translation
* define parameters
* chain extensions
* etc
Be sure to read through the INX files that come with Inkscape. Nothing beats a working example.

== Localisation of extensions ==

To allow localisation of strings in extension for Inkscape, some xml tags have to be adapted to variant readable by intltool. It means that tags or parameters has to have "_" prepended to their name, e.g. <tt><_name>name of extension</_name></tt>

Also the path to the extension has to be included in POTFILES.in file to tell intltool where to look for translatable content.

Useful information, before this section gets fully updated, can be found at [http://gould.cx/ted/blog/Translating_Custom_XML Ted's blog].

== Example ==
More example INX files are available in the Inkscape distribution or in the Inkscape [http://inkscape.svn.sourceforge.net/viewvc/inkscape/inkscape/trunk/share/extensions/ SVN repository].

<pre>
<inkscape-extension>
<_name>{Friendly Extension Name}</_name>
<id>{org.domain.sub-domain.extension-name}</id>
<dependency type="executable" location="[extensions|path|plugins|{location}]">program.ext</dependency>
<param name="tab" type="notebook">
<page name="controls" _gui-text="Controls">
<param name="{argumentName}" type="[int|float|string|boolean|description]" min="{number}" max="{number}"
_gui-text="{Friendly Argument Name}">{default value}</param>
</page>
<page name="help" _gui-text="Help">
<param name="help_text" type="description">{Friendly Extension Help}</param>
</page>
</param>
<effect>
<object-type>[all|{element type}]</object-type>
<effects-menu>
<submenu _name="{Extension Group Name}"/>
</effects-menu>
</effect>
<script>
<command reldir="extensions" interpreter="[python|perl|ruby|bash|{some other}]">program.ext</command>
</script>
</inkscape-extension>
</pre>

== DTD ==

<!ELEMENT inkscape-extension (name, id, dependency*, param*,(input|output|effect),(script|plugin))>
<!ELEMENT input (extension, mimetype, filetype, filetypetooltip, output_extension?)>
<!ELEMENT output (extension, mimetype, filetype, filetypetooltip, dataloss?)>
<!ELEMENT effect (object-type|submenu?)>
<!ELEMENT script (command, helper_extension*, check*)>
<!ELEMENT plugin (name)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT id (#PCDATA)>
<!ELEMENT item (#PCDATA)>
<!ELEMENT option (#PCDATA)>
<!ELEMENT dependency (#PCDATA)>
<!ELEMENT param (#PCDATA|page|item|option)*>
<!ELEMENT page (#PCDATA, param*)>
<!ELEMENT extension (#PCDATA)>
<!ELEMENT mimetype (#PCDATA)>
<!ELEMENT filetype (#PCDATA)>
<!ELEMENT filetooltip (#PCDATA)>
<!ELEMENT object-type (#PCDATA)>
<!ELEMENT command (#PCDATA)>
<!ELEMENT check (#PCDATA)>
<!ELEMENT dataloss (#PCDATA)>
<!ELEMENT helper_extension (#PCDATA)>
<!ELEMENT output_extension (#PCDATA)>

<!ATTLIST check reldir (absolute|path|extensions|plugins) #REQUIRED>
<!ATTLIST command reldir (absolute|path|extensions|plugins) #REQUIRED>
<!ATTLIST command interpreter CDATA #REQUIRED>
<!ATTLIST dependency type (executable|extension) #REQUIRED>
<!ATTLIST dependency location (absolute|path|extensions|plugins) #IMPLIED>
<!ATTLIST dependency description CDATA #IMPLIED>
<!ATTLIST effect needs-live-preview (true|false) #REQUIRED>
<!ATTLIST page name CDATA #REQUIRED>
<!ATTLIST page gui-text CDATA #IMPLIED>
<!ATTLIST param name CDATA #REQUIRED>
<!ATTLIST param type (int|float|string|boolean|enum|notebook|description|optiongroup|color) #REQUIRED>
<!ATTLIST param min CDATA #IMPLIED>
<!ATTLIST param max CDATA #IMPLIED>
<!ATTLIST param max_length CDATA #IMPLIED>
<!ATTLIST param precision CDATA #IMPLIED>
<!ATTLIST param gui-text CDATA #IMPLIED>
<!ATTLIST param gui-tip CDATA #IMPLIED>
<!ATTLIST param gui-description CDATA #IMPLIED>
<!ATTLIST param scope CDATA #IMPLIED>
<!ATTLIST param gui-hidden CDATA #IMPLIED>
<!ATTLIST param appearance (minimal|) "">
<!ATTLIST submenu name CDATA #REQUIRED>

== Relax NG Compact (RNC) ==
<code><pre>
datatypes xs = 'http://www.w3.org/2001/XMLSchema-datatypes'
namespace inkscape = 'http://www.inkscape.org/namespaces/inkscape'
default namespace local = ''

# Initially created from a Trang conversion.
# Edited for readability.
#
# @author Zearin
# @date 2010-07-21T11:02:00

start = inkscape-extension

#-------------------------------------------------------------------------------
# ELEMENTS
#===============================================================================
inkscape-extension =
element inkscape-extension
{
name,
id,
dependency*,
param*,
(input | output | effect),
(script | plugin)
}

input =
element input
{
extension,
mimetype,
filetype,
filetypetooltip,
output_extension?
}

output =
element output
{
extension,
mimetype,
filetype,
filetypetooltip,
dataloss?
}

effect = element effect { attlist.effect, (object-type | submenu?) }
script = element script { command, helper_extension*, check* }
plugin = element plugin { name }
name = element name { text }
id = element id { text }
item = element item { text }
option = element option { text }
dependency = element dependency { attlist.dependency, text }
param = element param { attlist.param, (text | page | item | option)* }
page = element page {text, param*}
extension = element extension { text }
mimetype = element mimetype { text }
filetype = element filetype { text }
filetooltip = element filetooltip { text }
object-type = element object-type { text }
command = element command { attlist.command, text }
check = element check { attlist.check, text }
dataloss = element dataloss { text }
helper_extension = element helper_extension { text }
output_extension = element output_extension { text }

#-------------------------------------------------------------------------------
# ATTRIBUTE LISTS
#===============================================================================
attlist.check =
attribute reldir { "absolute" | "path" | "extensions" | "plugins" }

attlist.command =
(
attribute reldir { "absolute" | "path" | "extensions" | "plugins" },
attribute interpreter { text }
)

attlist.dependency =
(
attribute type { "executable" | "extension" },
attribute location { "absolute" | "path" | "extensions" | "plugins" }?,
attribute description { text }?
)

attlist.effect =
attribute needs-live-preview { "true" | "false" }

attlist.page =
(
attribute name { text },
attribute gui-text { text }?
)

attlist.param =
(
attribute name { text },
attribute type {
"int"
| "float"
| "string"
| "boolean"
| "enum"
| "notebook"
| "description"
| "optiongroup"
| "color"
},
attribute min { text }?,
attribute max { text }?,
attribute max_length { text }?,
attribute precision { text }?,
attribute gui-text { text }?,
attribute gui-tip { text }?,
attribute gui-description { text }?,
attribute scope { text }?,
attribute gui-hidden { text }?,
attribute appearance {'minimal'|''}
)

attlist.submenu = attribute name { text }

#-------------------------------------------------------------------------------
# MISC
#===============================================================================
filetypetooltip |= notAllowed
page |= notAllowed
submenu |= notAllowed
</pre></code>

== See Also ==
*[[INX Parameters]]
*[[ScriptingHOWTO]]

[[Category:Developer Documentation]]
[[Category:Help Wanted]]
[[Category:Extensions]]

2010-03-15T13:38:02Z

Zearin: Undo my own revision…my fault for not using preview! Sorry. (Stupid page title appears BELOW the Contents.)

=== SVG Validator ===
A [http://jiggles.w3.org/svgvalidator/ validator service] (and downloadable tool) is provided by the [[W3C]]. It will complain about sodipodi or inkscape namespaced items in the document, unless you've exported to plain SVG.

=== SVG::Metadata ===
[http://search.cpan.org/CPAN/authors/id/B/BR/BRYCE/SVG-Metadata-0.10.tar.gz Perl module and set of scripts] to help in adding and processing metadata in SVG files.

== Vectorize/trace ==
=== Potrace ===
[[Potrace]] is now embedded into Inkscape. You don't need to run it separately.
*[[Potrace|Using Potrace through Inkscape]]
*[http://potrace.sourceforge.net/ Potrace page at Sourceforge]

=== Alternatives to Potrace (Autotrace and Frontline) ===
;'''Autotrace'''
: An open source vectorization program by Martin Weber. That means you can convert bitmap images (like scans) to vector graphics. While not optimal for photos, it does good job on line art and poster-like images. Doesn't do too well with color.
: Autotrace has some features not available in the embedded [[Potrace]] dialog in Inkscape. For example, there is a ''centerline'' switch that is especially usefull for tracing roads (in maps) or font characters.
; '''Frontline'''
: A GUI frontend to Autotrace by Masatake Yamato. Frontline can be run as standalone aplication, but it can also be directly accessed from Inkscape and GIMP.

If you want to have tracing option, you have to install both Autotrace and Frontline before compiling Inkscape. Inkscape automatically detects these programs, and adds inline raster to vector conversion option to image menu.

Both Autotrace and Frontline can be downloaded from [http://autotrace.sourceforge.net/ Sourceforge]. Binaries are available for windows and linux.

=== Delineate ===
Front end written in java that does interesting things with color images.
*[http://delineate.sourceforge.net/ Delineate at Sourceforge]

== Convert to SVG ==
=== svg2pdf ===

This simple but useful application is kindly provided by Carl Worth ([http://cairographics.org/ cairo]).
==== How to obtain it: ====
git clone git://people.freedesktop.org/~cworth/svg2pdf
And to update it dive into newly created directory called '''''svg2pdf''''' and type this in console:
git pull
(You must of course have '''git''' package installed)

==== Building ====
If build-time dependencies are satisfied
librsvg and cairo
you only need to type
make

==== Usage ====
./svg2pdf input_file.svg output_file.pdf

Note: from version 0.46 Inkscape can both read and write PDFs directly from the open/save dialogs. These tools however allow this conversion where 0.46 is not available, and also provide a means of validating if bugs encountered are Inkscape related.

=== [[uniconvertor]] ===
UniConvertor is an universal vector graphics translator. The project uses sK1 engine to convert one format to another. Project has following import filters: CDR, CMX, AI, CGM, WMF, XFIG, SVG, SK, SK1, AFF and export filters: AI, SVG, SK, SK1, CGM, WMF.
*[http://sourceforge.net/projects/uniconvertor/ Uniconvertor]

=== ill2svg ===
ill2svg (Illustrator to SVG) is a small script that helps turn Adobe
Illustrator .ai files into SVG. While it doesn't always do a perfect job,
it can sometimes be of great help.

To use the program, just type:

<pre>ill2svg.pl [-l "string" -h] infile > outfile.svg

options:
-l specify the file's line-ending convention: dos, mac,
or unix; the default is unix

-h print this message and exit
</pre>

=== ai2svg.py ===
ai2svg (Illustrator to SVG, recoded in python) is as well a small script that helps turn Adobe Illustrator .ai files into SVG. The Python recode aims to help developers more familiar to python than perl, as well fixing some lacks from ill2svg.pl - supports dashes, layers, textboxes (ascii-latin), and joined pathes.

To use the program, just type:

<pre>python ai2svg.py drawing.ai

the result will appear as neighbour, named drawing.ai.svg

options:
--help print this message and exit
</pre>

available at http://www.xs4all.nl/~hanwen/public/software/ai2svg.py

=== fig2vect ===
fig2vector (fig vector format to other vector formats, including SVG) is a converter from 'Fig format' long time used (at least since 1998) unix vector format ([http://epb.lbl.gov/xfig/ Xfig], figurine, jfig, winfig...), large kind of application output on this format in unix, mostly scientific applications.

* [http://fig2vect.sourceforge.net/ fig2vect]

=== gimp2sodipodi ===
Shandy Brown has assembled a somewhat obscure but useful set of tools to get from GIMP to Sodipodi (and thus to Inkscape). That is, convert raster to vector.
*[http://sjbrown.users.geeky.net/gimp2sodi/HOWTO.html gimp2sodipodi instructions]

=== GIMP ===
GIMP is a bitmap graphics tool in the first place, but:
* it imports SVG (with help of librsvg) into bitmap or vector path, exports SVG.
* GIMP's selection can be converted to a vector path, and paths can be exported/imported as SVG.

GIMP can be used to create nice textures to use in Inkscape or shapes that can be vectorized in Inkscape. Importing SVG drawings from Inkscape to GIMP allows you to do several effects by filling and stroking shapes.

There is a limited support for drag'n'drop between GIMP and Inkscape:
* path, can be drag'n'dropped from Gimp path dialog to Inkscape
* pictures can be drag'n'dropped from Gimp document history to Inkscape if it's in a file format that Inkscape understands.
(Drag and Drop does not appear to work in windows.)

*[http://www.gimp.org gimp.org]

=== ConversionSVG ===

ConversionSVG is a GUI that send command line to Inkscape to export in batch SVG to PNG, PS, PDF or EPS. It features a Wizard to help novice to use it. You can choose a size in pixels for your export and give some others parameters.

*http://sourceforge.net/projects/conversionsvg/

=== Kig ===
Kig is a geometry educational tool, it can import from most of the free geom softwares format : kig (own format), kigz (own format compresed), kgeo, seg (Kseg), fgeo (Dr Geo) anf fig, and can export them to SVG, xfig, latex, and image. This can be useful to integrate a geometry activity in a more complet document realized in Inkscape for web reading or printing for schools.

*http://edu.kde.org/kig

=== svg_stack ===
svg_stack combines multiple SVG elements into a single SVG element. It can be called from the command line (less flexible) or called from the Python interface (more flexible).

This tool exists primarily exists to automatically composite SVG files into a single SVG file that remains compatible with Inkscape. If compatibility with Inkscape is not required, one can create an svg file with multiple, nested <svg> elements. Inkscape, however, doesn't seem to handle nested <svg> elements particularly well. Thus, this tool was born.

*http://github.com/astraw/svg_stack

== Color scheme & palettes ==
=== Agave ===
Agave is a color scheme tool allowing to create palettes based on standard color composition rules, it export it's palettes in the format managed by Gimp and Inkscape.

*[http://home.gna.org/colorscheme/ Agave]

== Video editing, for building animation ==
=== Linux Video Editing System ===
LIVES is the Linux Video Editing System that permits editing and
making video without worries about formats, frame sizes, or frame
rates. It doesn't support SVG directly yet, but you can create animated
works by moving your shapes in Inkscape and exporting as numbered
png's.

*[http://www.xs4all.nl/%7Esalsaman/lives/ LIVES]

=== Kdenlive ===
Kdenlive is a non-linear video editor for Linux, that allow editing, mixing several video and audio using several timelines with previews, add audio/video effects using effects stacks, add text for title or subtitle. It support SVG (but not svgz, at least in svn 20070410).

*[http://kdenlive.org/ Kdenlive]

=== Open Movie Editor ===
Open Movie Editor is a non linear video editor, allowing editing, mixing several audio and vido, don't know if it supports svg, but as LIVES it can be used for work with png frames to build animation

*[http://openmovieeditor.sourceforge.net Open Movie Editor]

== Multipage presentation or book ==

=== Inkscape Slide ===

[http://projects.abourget.net/inkscapeslide Inkscape Slide] is a simple tool to generate multi-pages PDF from a single multi-layered Inkscape SVG file.

It allows incremental display, as you specify the layers you want on each page, in a simple text box in your document.

Any feedback is welcome.

=== [[InkSlide]] ===

[[InkSlide]] is a presentation creation tool (a small python program) that uses an Inkscape SVG file as a template for rapidly producing slides with text, bulleted lists, images and slide specific SVG content.

* [[InkSlide]]

=== [[svgslides]] ===

Svgslides is a command-line unix utility that can do various things.

* Create a PDF slide show. For example, make a PDF slideshow from a number of SVG files you have made with inkscape. Just put the files in a text file, each SVG filename on one line, and then run "svgslides", and a PDF file will be created

* Create a picture perfect PDF from one svg file. Just use the utility svgslides-svg2pdf

* Create "incremental" slides. Just give SVG objects special lables (e.g., "part1", "part2"), and svgslides will make a show in which these parts of an svg file will be displayed in a sequence.

* Written as bash shell script and uses common packages. Easy to install.

* Download and Online help on: http://volition.leeds.ac.uk/svgslides/

=== Scribus ===

Scribus is a publishing software supporting SVG, allowing to organise Inkscape documents as a full featured pre-press tool. It doesn't support SVG filters (blur/blend modes...), but manage most of other features.

*[http://www.scribus.net/ Scribus]

=== JessyInk ===

JessyInk is a JavaScript that can be incorporated into an Inkscape SVG file. It turns every layer of the image into a frame of a slide show. The slide shows can be viewed in any browser supporting SVG and JavaScript. Current features include: different transitions between slides, automatic slide numbering and an index sheet view.

*[http://code.google.com/p/jessyink/ JessyInk project page]

[[Category:About Inkscape]]

== Charts & Graphs ==
=== Gnuplot ===
Gnuplot, the command line (with several frontends) driven interactive data and function plotting tool has SVG output for graphs & charts.
* Input can be functions or datasets
* Output in 2D, 3D...
* http://www.gnuplot.info/

=== matplotlib ===
Matplotlib is a python plotting library and can also output SVG.
* http://matplotlib.sourceforge.net/

=== Gnumeric ===
Gnumeric, the Gnome spreadsheet output a variety of graphs/charts in SVG format.
* http://www.gnome.org/projects/gnumeric/

=== SVG Charter ===
SVG charter is a perl script dedicated to generate SVG charts on web servers.
* http://charter.sourceforge.net/

=== JSpecView ===
JSpecView is a Java project with application and applet designed to display spectra in the JCAMP-DX format. It can export the display as standard SVG or as an Inkscape SVG document for import by Blender as a path.
* http://jspecview.sourceforge.net/

== Diagrams ==
=== Graphviz ===
Graphviz is a tool for automatic graph drawing, it produces structural information as diagrams of abstract graphs and networks in SVG and other vector formats. Several diagrams softwares use this tool or dot file managed by this tool in variety application domains including:
* UML
* databases
* networks
* source code analysers objects/functions relations
* code profiling analalysis
* web server log analyser
* packages dependencies
* ...

*[http://www.graphviz.org/ graphviz]
*[http://freshmeat.net/search/?q=graphviz Some free software using graphviz to output diagrams]

Tools

2010-03-15T13:37:05Z

Zearin: Added page title.

= Tools =

=== SVG Validator ===
A [http://jiggles.w3.org/svgvalidator/ validator service] (and downloadable tool) is provided by the [[W3C]]. It will complain about sodipodi or inkscape namespaced items in the document, unless you've exported to plain SVG.

=== SVG::Metadata ===
[http://search.cpan.org/CPAN/authors/id/B/BR/BRYCE/SVG-Metadata-0.10.tar.gz Perl module and set of scripts] to help in adding and processing metadata in SVG files.

== Vectorize/trace ==
=== Potrace ===
[[Potrace]] is now embedded into Inkscape. You don't need to run it separately.
*[[Potrace|Using Potrace through Inkscape]]
*[http://potrace.sourceforge.net/ Potrace page at Sourceforge]

=== Alternatives to Potrace (Autotrace and Frontline) ===
;'''Autotrace'''
: An open source vectorization program by Martin Weber. That means you can convert bitmap images (like scans) to vector graphics. While not optimal for photos, it does good job on line art and poster-like images. Doesn't do too well with color.
: Autotrace has some features not available in the embedded [[Potrace]] dialog in Inkscape. For example, there is a ''centerline'' switch that is especially usefull for tracing roads (in maps) or font characters.
; '''Frontline'''
: A GUI frontend to Autotrace by Masatake Yamato. Frontline can be run as standalone aplication, but it can also be directly accessed from Inkscape and GIMP.

If you want to have tracing option, you have to install both Autotrace and Frontline before compiling Inkscape. Inkscape automatically detects these programs, and adds inline raster to vector conversion option to image menu.

Both Autotrace and Frontline can be downloaded from [http://autotrace.sourceforge.net/ Sourceforge]. Binaries are available for windows and linux.

=== Delineate ===
Front end written in java that does interesting things with color images.
*[http://delineate.sourceforge.net/ Delineate at Sourceforge]

== Convert to SVG ==
=== svg2pdf ===

This simple but useful application is kindly provided by Carl Worth ([http://cairographics.org/ cairo]).
==== How to obtain it: ====
git clone git://people.freedesktop.org/~cworth/svg2pdf
And to update it dive into newly created directory called '''''svg2pdf''''' and type this in console:
git pull
(You must of course have '''git''' package installed)

==== Building ====
If build-time dependencies are satisfied
librsvg and cairo
you only need to type
make

==== Usage ====
./svg2pdf input_file.svg output_file.pdf

Note: from version 0.46 Inkscape can both read and write PDFs directly from the open/save dialogs. These tools however allow this conversion where 0.46 is not available, and also provide a means of validating if bugs encountered are Inkscape related.

=== [[uniconvertor]] ===
UniConvertor is an universal vector graphics translator. The project uses sK1 engine to convert one format to another. Project has following import filters: CDR, CMX, AI, CGM, WMF, XFIG, SVG, SK, SK1, AFF and export filters: AI, SVG, SK, SK1, CGM, WMF.
*[http://sourceforge.net/projects/uniconvertor/ Uniconvertor]

=== ill2svg ===
ill2svg (Illustrator to SVG) is a small script that helps turn Adobe
Illustrator .ai files into SVG. While it doesn't always do a perfect job,
it can sometimes be of great help.

To use the program, just type:

<pre>ill2svg.pl [-l "string" -h] infile > outfile.svg

options:
-l specify the file's line-ending convention: dos, mac,
or unix; the default is unix

-h print this message and exit
</pre>

=== ai2svg.py ===
ai2svg (Illustrator to SVG, recoded in python) is as well a small script that helps turn Adobe Illustrator .ai files into SVG. The Python recode aims to help developers more familiar to python than perl, as well fixing some lacks from ill2svg.pl - supports dashes, layers, textboxes (ascii-latin), and joined pathes.

To use the program, just type:

<pre>python ai2svg.py drawing.ai

the result will appear as neighbour, named drawing.ai.svg

options:
--help print this message and exit
</pre>

available at http://www.xs4all.nl/~hanwen/public/software/ai2svg.py

=== fig2vect ===
fig2vector (fig vector format to other vector formats, including SVG) is a converter from 'Fig format' long time used (at least since 1998) unix vector format ([http://epb.lbl.gov/xfig/ Xfig], figurine, jfig, winfig...), large kind of application output on this format in unix, mostly scientific applications.

* [http://fig2vect.sourceforge.net/ fig2vect]

=== gimp2sodipodi ===
Shandy Brown has assembled a somewhat obscure but useful set of tools to get from GIMP to Sodipodi (and thus to Inkscape). That is, convert raster to vector.
*[http://sjbrown.users.geeky.net/gimp2sodi/HOWTO.html gimp2sodipodi instructions]

=== GIMP ===
GIMP is a bitmap graphics tool in the first place, but:
* it imports SVG (with help of librsvg) into bitmap or vector path, exports SVG.
* GIMP's selection can be converted to a vector path, and paths can be exported/imported as SVG.

GIMP can be used to create nice textures to use in Inkscape or shapes that can be vectorized in Inkscape. Importing SVG drawings from Inkscape to GIMP allows you to do several effects by filling and stroking shapes.

There is a limited support for drag'n'drop between GIMP and Inkscape:
* path, can be drag'n'dropped from Gimp path dialog to Inkscape
* pictures can be drag'n'dropped from Gimp document history to Inkscape if it's in a file format that Inkscape understands.
(Drag and Drop does not appear to work in windows.)

*[http://www.gimp.org gimp.org]

=== ConversionSVG ===

ConversionSVG is a GUI that send command line to Inkscape to export in batch SVG to PNG, PS, PDF or EPS. It features a Wizard to help novice to use it. You can choose a size in pixels for your export and give some others parameters.

*http://sourceforge.net/projects/conversionsvg/

=== Kig ===
Kig is a geometry educational tool, it can import from most of the free geom softwares format : kig (own format), kigz (own format compresed), kgeo, seg (Kseg), fgeo (Dr Geo) anf fig, and can export them to SVG, xfig, latex, and image. This can be useful to integrate a geometry activity in a more complet document realized in Inkscape for web reading or printing for schools.

*http://edu.kde.org/kig

=== svg_stack ===
svg_stack combines multiple SVG elements into a single SVG element. It can be called from the command line (less flexible) or called from the Python interface (more flexible).

This tool exists primarily exists to automatically composite SVG files into a single SVG file that remains compatible with Inkscape. If compatibility with Inkscape is not required, one can create an svg file with multiple, nested <svg> elements. Inkscape, however, doesn't seem to handle nested <svg> elements particularly well. Thus, this tool was born.

*http://github.com/astraw/svg_stack

== Color scheme & palettes ==
=== Agave ===
Agave is a color scheme tool allowing to create palettes based on standard color composition rules, it export it's palettes in the format managed by Gimp and Inkscape.

*[http://home.gna.org/colorscheme/ Agave]

== Video editing, for building animation ==
=== Linux Video Editing System ===
LIVES is the Linux Video Editing System that permits editing and
making video without worries about formats, frame sizes, or frame
rates. It doesn't support SVG directly yet, but you can create animated
works by moving your shapes in Inkscape and exporting as numbered
png's.

*[http://www.xs4all.nl/%7Esalsaman/lives/ LIVES]

=== Kdenlive ===
Kdenlive is a non-linear video editor for Linux, that allow editing, mixing several video and audio using several timelines with previews, add audio/video effects using effects stacks, add text for title or subtitle. It support SVG (but not svgz, at least in svn 20070410).

*[http://kdenlive.org/ Kdenlive]

=== Open Movie Editor ===
Open Movie Editor is a non linear video editor, allowing editing, mixing several audio and vido, don't know if it supports svg, but as LIVES it can be used for work with png frames to build animation

*[http://openmovieeditor.sourceforge.net Open Movie Editor]

== Multipage presentation or book ==

=== Inkscape Slide ===

[http://projects.abourget.net/inkscapeslide Inkscape Slide] is a simple tool to generate multi-pages PDF from a single multi-layered Inkscape SVG file.

It allows incremental display, as you specify the layers you want on each page, in a simple text box in your document.

Any feedback is welcome.

=== [[InkSlide]] ===

[[InkSlide]] is a presentation creation tool (a small python program) that uses an Inkscape SVG file as a template for rapidly producing slides with text, bulleted lists, images and slide specific SVG content.

* [[InkSlide]]

=== [[svgslides]] ===

Svgslides is a command-line unix utility that can do various things.

* Create a PDF slide show. For example, make a PDF slideshow from a number of SVG files you have made with inkscape. Just put the files in a text file, each SVG filename on one line, and then run "svgslides", and a PDF file will be created

* Create a picture perfect PDF from one svg file. Just use the utility svgslides-svg2pdf

* Create "incremental" slides. Just give SVG objects special lables (e.g., "part1", "part2"), and svgslides will make a show in which these parts of an svg file will be displayed in a sequence.

* Written as bash shell script and uses common packages. Easy to install.

* Download and Online help on: http://volition.leeds.ac.uk/svgslides/

=== Scribus ===

Scribus is a publishing software supporting SVG, allowing to organise Inkscape documents as a full featured pre-press tool. It doesn't support SVG filters (blur/blend modes...), but manage most of other features.

*[http://www.scribus.net/ Scribus]

=== JessyInk ===

JessyInk is a JavaScript that can be incorporated into an Inkscape SVG file. It turns every layer of the image into a frame of a slide show. The slide shows can be viewed in any browser supporting SVG and JavaScript. Current features include: different transitions between slides, automatic slide numbering and an index sheet view.

*[http://code.google.com/p/jessyink/ JessyInk project page]

[[Category:About Inkscape]]

== Charts & Graphs ==
=== Gnuplot ===
Gnuplot, the command line (with several frontends) driven interactive data and function plotting tool has SVG output for graphs & charts.
* Input can be functions or datasets
* Output in 2D, 3D...
* http://www.gnuplot.info/

=== matplotlib ===
Matplotlib is a python plotting library and can also output SVG.
* http://matplotlib.sourceforge.net/

=== Gnumeric ===
Gnumeric, the Gnome spreadsheet output a variety of graphs/charts in SVG format.
* http://www.gnome.org/projects/gnumeric/

=== SVG Charter ===
SVG charter is a perl script dedicated to generate SVG charts on web servers.
* http://charter.sourceforge.net/

=== JSpecView ===
JSpecView is a Java project with application and applet designed to display spectra in the JCAMP-DX format. It can export the display as standard SVG or as an Inkscape SVG document for import by Blender as a path.
* http://jspecview.sourceforge.net/

== Diagrams ==
=== Graphviz ===
Graphviz is a tool for automatic graph drawing, it produces structural information as diagrams of abstract graphs and networks in SVG and other vector formats. Several diagrams softwares use this tool or dot file managed by this tool in variety application domains including:
* UML
* databases
* networks
* source code analysers objects/functions relations
* code profiling analalysis
* web server log analyser
* packages dependencies
* ...

*[http://www.graphviz.org/ graphviz]
*[http://freshmeat.net/search/?q=graphviz Some free software using graphviz to output diagrams]

Tools

2010-03-15T13:35:59Z

Zearin: Formatting tweak.