Inkscape Wiki - User contributions [en]

Release notes/1.2

2022-05-11T16:04:50Z

Oskay: Link directly to the documentation resource, rather than to a wiki-based redirect to that resource.

{{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.'''

* Inkscape documents can now hold '''multiple pages''', which are managed by the new '''[[#Page_tool|Page tool]]'''
* '''Editable [[#Markers|markers]]''' and [[#Custom_Dash_patterns|'''dash patterns''']]
* '''[[#Layers_and_Objects_dialog|Layers and objects dialog merged]]'''
* '''[[#Alignment_and_Distribution_snapping|On-canvas alignment snapping]]''' and '''[[#Snapping|Snap settings redesign]]'''
* '''[[#Tiling|New 'Tiling' Live Path Effect]]'''
* [[#Export Dialog|'''Redesigned Export dialog''']] with preview and ability to select objects/layers/pages and even multiple file formats to export to
* [[#New_Extensions|'''Import SVG images from Open Clipart, Wikimedia Commons and other online sources''']]
* [[#Selector_Tool|'''Selectable object origin''' for numerical scaling and moving]]
* '''[[#Align_and_distribute|All alignment options in a single dialog]]'''
* '''[[#Gradient_Editor_is_back|Gradient editing in the Fill and Stroke dialog]]'''
* '''[[#Dithering|Gradient dithering]]'''
* [[#SVG Font Editor|'''SVG Font Editor''' updated]]
* '''[[#Text_Tool|Flowing text around shapes and text padding]]'''
* '''[[#Path_Operations|Convenience Boolean operation for splitting paths]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and many more new customization options]]
* '''Performance gains''' for many parts of the interface and many different functions
* '''Lots of improvements to the user interface'''
* '''Numerous crash & bug fixes''' in [[#Notable_bugfixes|the main Inkscape program]] and in [[#Bugs_fixed|in the stock extensions]]

== General user interface ==

=== Color palette ===

The overall look and options of the Color palette and the Swatches dialog got a massive overhaul ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2881 MR #2881]):

* When switching the color palette, the switcher shows a '''colorful preview line''' for each palette
* Between 1 and 5 '''palette rows''' that can be displayed all at once, or scrolled through vertically / using the arrow buttons
* Improved and reliably working settings for '''padding, tile size and tile shape / auto-stretching'''

[[File:Color pallet demo.gif|frame|center|Color palette layout options]]

=== Status Bar ===

* The layer selection drop-down has been replaced by a '''layer indicator'''. Clicking on the indicator opens the new [[#Layers_and_Objects_dialog|Layers and object dialog]]. This change improves Inkscape's performance for documents with many layers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3648 MR #3648]).
* The '''layer lock and hide icons''' now come after the layer indicator, which is more logical ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3856 MR #3856], [https://gitlab.com/inkscape/inkscape/-/issues/3104 Bug #3104])
* The status bar '''contents are now configurable''' from <code>Edit → Preferences → Interface: Status bar</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3445 MR #3445])
* When your document has more than one page, the status bar shows the '''page navigation''' to the right of the message area, allowing you to leaf through the pages or to select a specific page directly

<gallery mode="packed" heights=350px>
File:Page navigation.png|Page navigation in status bar
File:Status bar items toggle.gif|Toggling visibility of items in the status bar (click to see animation)
</gallery>

=== Tool Bar ===

* The Tool bar '''width can now be adjusted''' by dragging its edge. The tool icons will wrap into '''multiple columns''', depending upon the width.
* You can now '''hide tools''' from the tool bar at <code>Edit → Preferences → Interface → Toolbars: Toolbars</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3515 MR #3515])

[[File:X5pWfteMzW.gif|frame|center|Toggling tool visibility for the tool bar]]

=== Context menus ===

* Context menus '''no longer contain functionality that is not available''' for the selected object (no greyed-out items anymore), making it easier to find what you're looking for. This also helps find objects you've hidden, as the option to unhide objects under the cursor only appears if there are hidden objects in that location ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3800 MR #3800]).
* The '''Extract image''' command has been improved and works with multiple images now. You can now enter a base filename; if none is entered, the ids of the selected images are used as filename. You can also choose whether the embedded image data should be replaced by a link to the exported file ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461], [https://gitlab.com/inkscape/extensions/-/issues/167 Bug extensions#167]).

=== Dithering ===

Inkscape's gradients sometimes suffered from visible steps between colors, a phenomenon also known as '''gradient banding'''. Gradient banding is caused by the difference between how many different colors are available for the selected image file format and how many colors a human eye can discern. The effect becomes especially prominent when exporting a gradient that only spans a small color range to a high-resolution image. There just aren't enough colors available for a smooth transition.

'''Dithering''' softens these steps '''by scattering pixels''' of the different adjacent colors along the gradient, a little bit like a blur.

Dithering is now used both for '''Export of raster images''' as well as for '''displaying gradients on canvas''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812]). This functionality requires a special version of Cairo, our rendering engine. This means that it will '''only be available in the pre-packaged builds''' (for '''macOS''', '''Windows''' and for the '''Linux AppImage''').

Dithering can be turned off (better performance / smaller exported file size for raster images) in <code>Preferences → Rendering → Use dithering</code>.

'''Note:'''
* ''Dithering does not work for mesh gradients!''
* ''For standard Linux package formats (deb, rpm, …), it depends upon your Linux distribution maintainers whether they will patch up the version of Cairo they want to distribute. We hope that this change will one day also be included in the official Cairo packages ([https://gitlab.freedesktop.org/cairo/cairo/-/merge_requests/24 Link to ongoing discussion]).''

[[File:Dithering_comparison.png|frame|center|Top: Gradient banding, bottom: dithered, smooth gradient]]

=== Performance ===

* Various performance improvements for rendering while panning and zooming ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3838 MR 3838])
* Improved performance on macOS

== Canvas ==

=== Page ===

* Inkscape documents can now hold '''multiple pages'''! Learn more in the [[#Page_tool|'''section about the new Page tool''']].
* '''Page shadows''' now have a '''more realistic''', blurry, fade-out look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3128 MR #3128]).
* '''Settings for the page background / decoration''' (shadow, border) were refactored, see [[#Document_Properties|section about Document properties dialog]].
* The page's '''default color''' is white, and the default desk color is set to light gray. This way, it is easier to differentiate what is '''on''' the page(s) and what is '''outside''' of the page(s).

[[File:Page shadow.png|center|thumb|800x400px|Page shadow comparison. Left: Inkscape 1.1, right: Inkscape 1.2]]

=== Snapping ===

[[File:Snapping popover .gif|frame|right|New snap settings layout]]

==== Snap popover ====

The snap bar has been replaced with a new ''''popover'-type dialog''', which will '''unfold''' when you click on the little arrow symbol in the top right corner, next to the snap symbol.
Snap options now have '''always-visible descriptions''', to make them easier to understand ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3323 MR #3323]).

To activate / deactivate snapping globally, click on the snap symbol in the top right corner or press '''<kbd>%</kbd>'''.

The popover dialog has two different modes:
* '''Simple''': Only 3 options: snap bounding boxes and paths, activate / deactivate the new alignment snapping). This provides simple presets for many use cases.
* '''Advanced''': Gives the familiar granular control over every snapping option.

'''''Note:''' Switching from 'Advanced' back to 'Simple' is not merely a visual change, but will reset snap settings to defaults.''

==== Alignment and Distribution snapping ====

During Google Summer of Code 2021, GSOC student '''[https://gitlab.com/ParthPant Parth Pant]''' worked on adding '''on-canvas alignment and distribution snapping''', with the support of his mentors Thomas Holder and Marc Jeanmougin.
As a result, '''two new modes of on-canvas snapping''' have been added. These new modes make aligning and distributing objects a '''very easy drag-and-drop operation''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3294 MR #3294])..

* When '''on-canvas alignment''' is active (option '''Alignment'''), Inkscape will display horizontal or vertical temporary guide lines that indicate when the selected object can be aligned relative to another object on the canvas. It connects the points of the objects that are in alignment. With the option '''Nodes in same path''', alignment snapping is also available for nodes while editing a path with the node tool.
* With '''distribution snapping''' (option '''Same distances'''), multiple objects close by are taken into account, making it possible to align objects in a grid with very little effort.

The '''temporary guide lines''' only appear while editing / moving objects on the canvas. Once a guide shows up, the movement of the selection is loosely constrained in the direction of the guide.

Alignment and Distribution snapping guide lines can '''display the distance(s)''' between objects as a little label. This can be enabled from <code>Edit → Preferences → Snapping: Show snap distance in case of alignment or distribution snap</code>.

The 'Simple' mode of the snapping popover dialog allows you to simply activate or deactivate Alignment snapping.
The 'Advanced' mode gives you additional control by allowing you to en-/disable:

==== Other Changes to Snapping ====

* Snap settings are '''no longer saved with the document''', but are set '''globally for all documents''' in the preferences and in the snap popover dialog.
* The option for '''enabling snapping in new documents''' has been '''removed''', as it no longer makes sense.
* The options for '''snapping perpendicularly''' and '''tangentially''' to paths or guide lines have been '''moved''' from the document preferences to the snap popover to make them more discoverable.
* The options to '''configure snap tolerances''' per snap target type that previously could be set in the document preferences have been '''removed''' to simplify snapping for users.

<gallery mode="packed" heights="350px">
File:Self snapping.gif|Snapping nodes in the same path
File:Aligment and distribution snapping exemple.gif|Demo of alignment and distribution snapping
</gallery>

=== Guides and Grids ===

* The '''size of the guide handles''' is now '''adjustable''' via the existing setting <code>Edit → Preferences → Interface → Handle size</code>. Nonetheless, the guide handles react to this setting at half the rate of other handles; at large settings, the effective size of a guide handle is about half the size of an auto-smooth node. At the same time, a minimum size is enforced, equal to the previously hard-coded size. As a result of this mechanism, the handle is only enlarged when the <code>Handle size</code> preference is set to a value of 7 or larger. Since the default value is 3, the size of guide handles does not change on new installs or for users on default settings ([https://gitlab.com/inkscape/inkscape/-/issues/3111 Bug #3111], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 MR #3870])
* Larger '''handles can now easily be grabbed''' with the mouse, because the handles themselves are now 'grabb-able', not only the guide lines below ([https://gitlab.com/inkscape/inkscape/-/issues/3111 Bug #3111], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 MR #3870])
* Handles '''now take on the guide's color'''. Only when the guide is locked, its handle turns grey (and changes the shape to an "x", as before) ([https://gitlab.com/inkscape/inkscape/-/issues/3111 Bug #3111], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 MR #3870])
* The '''default color''' of guides and grids was changed to a '''softer shade of blue''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4012 MR #4012])

[[File:Guide changes.png|frame|center|New guide appearance (enlarged for better visibility, and thus pixelated)]]

== Tools ==

=== Gradient Tool ===

To allow you to keep gradients, even when the last object that was using it has been deleted, we added a setting for '''automatically removing unused gradients''' at <code>Preferences → Gradient Tool → Auto delete gradients that are not used</code>. This is turned on by default, which corresponds to the behavior of the previous Inkscape version, but you can now turn it off ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3897 MR #3897]).

=== Node tool ===

The box (lasso) selection mode gained two new features: '''node deselection''' and '''inverted node selection'''.

* to '''deselect''' some of the selected nodes, drag a box around those nodes while holding <kbd>Shift + Ctrl</kbd>.
* to '''select all nodes but those that end up within the box''', hold <kbd>Ctrl</kbd> while dragging the box around the nodes.

[[File:Node deselection lasso.gif|frame|center|Deselecting nodes / selecting all other nodes by dragging the mouse and using Ctrl and Shift]]

=== Page tool ===
[[File:Page tool context menu.png|frame|right|Context menu for the Page tool]]
The new Page tool (lowest button in the tool bar) allows you to create multi-page Inkscape documents, and to import as well as export multi-page PDF documents. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3486 MR #3486], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3785 MR #3785], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3821 MR #3821]). It supports overlapping pages and pages of different sizes in a single document.

'''Tool usage:'''
* To '''create a new page''' either:
** click-and-drag on the canvas
** or click on the 'Create a new page' button in the tool controls
* To '''delete a page''', click on the page to select it, then click on the button <code>Delete selected page</code> or use the <code>Del</code> or <code>Backspace</code> keys.
* To '''move a page''' on the canvas, click-and-drag it to the desired new position. If the option to <code>Move overlapping objects</code> is active, this will also move any objects that touch the page along with it.
* To '''change a page's size''':
** click on a page whose size you want to change to select it, then drag the square-shaped handle in its bottom right corner
** click on the page, and then choose one of the predefined sizes in the page size dropdown, or enter your size values for the 'Custom' option, by typing them into the field in the form of <code>10cm x 15cm</code>
* To '''fit a page''' to:
** the size of '''the drawing''': make sure to have no object selected before you switch to the Page tool. Then select a page by clicking on it, then click on the button 'Fit page to drawing or selection' in the tool controls
** '''a selected object''': first select the object(s) with the selection tool, then switch to the Page tool, click on a page to select it, then press the the button 'Fit page to drawing or selection' in the tool controls
* To '''add a label''' to your page, select the page by clicking on it, then enter a name or label for it into the text field in the page tool's tool controls. Labels are always visible, no matter which tool is currently selected.
* To '''export a multi-page PDF''' file, use <code>File → Save a copy … → PDF</code>. This will automatically include all pages. If you only want to export a certain page, or a selection of pages, the updated [[#Export_Dialog|<code>File → Export</code> dialog]]'s batch export tab can help you get that done (one file per page).
* To '''open or import a multi-page PDF or AI (pdf-based)''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]
*You can navigate pages with page navigator on that will show up in right down corner of status bar

''Note: Multi-page SVG files are an Inkscape-specific concept. Web browsers will only display the first page of your document, which corresponds to the 'viewbox' area of the SVG file.''

<gallery mode="packed" heights=450px>
File:Page Tool-New Pages.gif|Creating a page using the tool controls
File:Page Tool-Navigate-Pages-from-Status-bar.gif|Navigating pages from the status bar
File:Page Tool-Moving-Objects-with-Pages.gif|Moving objects along with the page
File:Page Tool-Label Pages.gif|Labelling pages
File:Page Tool-Delete Pages.gif|Deleting pages and their contents
</gallery>

=== Selector Tool ===

The tool now allows to '''set the origin of the selection''' for precise numerical positioning to one out of 8 possible positions:

# If no handle is selected, the '''default origin is the top left corner''' of the bounding box.
# To change, '''click''' on '''one of the other 7 outside object handles''' to select your desired origin for the scaling.
# The selected handle is now highlighted in blue and the '''x/y position''' in the tool controls will adjust to the new origin.
# Now '''edit the x, y, width or height values''' to move and scale your object using the new origin ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2700 MR #2700])
# To '''reset''' the transformation origin, <kbd>Shift + Click</kbd> on the highlighted handle.

[TODO: needs new gifs, center movable handle has been removed]

<gallery style="border: 1px solid #c8ccd1;padding: 3px;background-color: #f8f9fa;" mode="packed" heights=350px>
File:Change origin of selection.gif|Changing the origin for scaling numerically
File:Change origin to TOP right.gif|Changing the origin to move one corner to a specified coordinate
</gallery>

=== Text Tool ===
[[File:Kerning popover.png|frame|right|Text spacing/kerning options in a popover dialog]]
* '''Kerning options''' are now symbolized by a '''button''' between the subscript and text direction selectors. Clicking on it will open a so-called pop-over, where all previously available options can be found. This change saves space in the Text tool's toolbar.
* '''Negative kerning''' values can now take on values as small as <code>-1000</code> (previously -100), making them symmetrical to their positive counterparts ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2569 MR #2569], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3434 MR #3434])
* '''Padding''': Text that is flowed into a shape and standard flowed text now has an '''additional square-shaped handle''' in the top right corner. Move the handle to adjust the text padding inside the frame ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2769 MR #2769])
* '''Exclusion zones''': Text can now '''flow around one or more movable objects''':
*# Select all object(s) (use only shapes and paths on the same object hierarchy level as the text; no groups / clones / images supported) and the text.
*# Set the exclusion zone by going to <code>Text → Set subtraction frames</code>.
*# Now you can move the exclusion objects around or edit their shape, and the text will adjust automatically.
*# If you want to change the exclusion zones again at a later point, repeat the process with all objects that the text should flow around.<br/>''Background info:''<br/>''SVG 2.0 flowed text allows for <code>shape-padding</code> and <code>shape-subtract</code> attributes. <code>shape-padding</code> lets the text flow into a shape and leave some space between its edges and w where the text will start to flow. <code>shape-subtract</code> subtracts shapes with margin, so text can flow around other objects in the scene. These attributes were supported in Inkscape 1.0, but not exposed to the user. This version of Inkscape includes both an adjustable on-canvas knot for changing the padding as well as a Text menu item for setting text subtraction properties with a further knot to adjust it's margins.''

[[File:Text-subtract opt.gif|frame|center|Text flowing around a shape and then text padding being adjusted]]

== Path Operations ==

With <code>'''Path → Split path'''</code>, Inkscape now has functionality to separate a path object that consists of multiple subpaths into a set of path objects that 'belong together'. This means that parts of a path that have holes in them are kept as whole objects. The function works by splitting up a path into non-intersecting bits, keeping intersecting bits together.

''Example'': A path that consists of a word, like 'Inkscape' will be split into 8 parts, one for each letter. With the familiar 'Break apart' function, there would be 12 parts, because of the holes in the letters that would be split off as their own objects, too ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3738 MR #3738]).

[[File:Split.gif|center|frame|Top: Break path function separates all subpaths into single objects (not new)<br/>Bottom: Splitting a text into letters with the new 'Split path' operation]]

== Dialogs ==

[[File:Inkscape PyFNUY7fCi.gif|frame|right|Close current tab or open any dialog directly from a dialog dock/window]]

=== General Dialog Changes ===

* A mini-menu (downward pointing arrow symbol) was added into the title bar of every multi-dialog panel (also called 'notebook'). You can use it to close the current tab, to undock it, or to close the whole panel. It also shows a list of available dialogs, sorted by purpose, allowing you to open them with a click (([https://gitlab.com/inkscape/inkscape/-/merge_requests/3728 MR #3728])
* Open dialogs are now less costly for performance, because they do not update when it's not needed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3369 MR #3369]), or when they are hidden ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3761 MR #3761])
* Docking zones now expand and flash slowly when a dialog is dragged close to them. This makes it easier to see where docking is possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3729 MR #3729])
* The text labels of docked dialogs are now more responsive to the width of dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3627 MR #3627])

=== About Screen ===

The 'About Inkscape' dialog uses [https://inkscape.org/news/2022/03/22/new-discoveries-await-upcoming-inkscape-12-about/ the winner art from our Inkscape 1.2 About Screen Contest], '''"New discoveries await..." by Chris Hildenbrand'''.

=== Align and Distribute ===

* The formerly separate <code>Arrange</code> dialog is now '''integrated''' with the <code>Align and Distribute</code> dialog. With its '''three tabs''', more '''user-friendly names''' and some '''small visual tweaks''', the dialog now holds everything that is needed for aligning, distributing and arranging objects in your drawing ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3382 MR #3382], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3667 MR #3667]).
* The icons inside this dialog are now smaller.
[[File:Inkscape R6cB6sFN07.gif|center|frame|All alignment and distribution options in a single dialog]]

=== Document Properties ===

[[File:Document Properties.png|alt=Document Properties|thumb|right|First tab of the Document Properties dialog]]

The ''''Snapping' tab was removed''' in favor of a global snapping preference, see [[#Snapping|Snapping section]].

The '''first tab''' of the Document properties dialog was '''refactored''' thoroughly to make it easier to use ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3700 MR #3700]):

* It's now labelled 'Display' instead of 'Page'.
* The long list of different document formats is now available from a dropdown.
* There is a preview available of the page format and colors.
* The '''page area(s)''' in a document can now have a '''different color''' than the underlying ''''desk' area'''.
* The other options have been rearranged to look tidier.
* ''Note: The option to '''add margins''' to a document when resizing it is '''currently unavailable'''''

<div style="clear:both;"> </div>

=== Export ===

The former <code>Export PNG image</code> dialog was updated to a general <code>Export</code> dialog by '''[https://gist.github.com/SlayerAnsh/bc932d86c8f846b9c2042a0255231563 2021 GSOC student Anshudhar Kumar Singh]''' with the mentors Michael Kowalski, Ted Gould and Tavmjong Bah, and finished by Martin Owens ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3825 MR #3825]).

The new name reflects the increased range of functionality of the dialog.

==== General Export Dialog Changes ====

* the '''confusing number entry fields''' for export area coordinates have been '''hidden from all but the 'Custom' tab'''
* the dialog now features a '''preview''' that allows you to see what is going to be in the exported file(s). The preview can also be turned off when you do not need one, or in case performance suffers.

==== Available Export File Formats ====

* by default, the dialog allows you to export images to multiple raster and vector formats: – '''PNG, Optimized PNG, JPEG, WebP, Tiff, SVG, Inkscape SVG, PDF'''
* by activating <code>Edit → Preferences → Input/Output → Show all outputs in Export dialog</code>, even '''more export formats''', provided by Inkscape extensions, will become accessible from the dialog. By default, this includes a long list almost as high as your Inkscape window - ranging from 'Compressed Inkscape SVG with media' and .dxf to 'Scribus CMYK pdf' and 'Windows Metafile (.wmf)'.
* '''third-party Inkscape Python extensions''' can be added to '''extend the dialog's functionality''' even further

==== Batch Export ====

In addition to exporting single images, one at a time, or simple batch export of objects in the selection to separate files, the dialog has gained the ability to:

* also batch export '''top level layers''' and '''pages'''
* to export to '''multiple image resolutions at once''', by setting a different DPI value for each export format/size
* to export to '''multiple file formats at once'''
* to '''select''' objects, pages or top level layers to export (with preview)
* '''file names''' are constructed as <code><filename>_<object id>_<suffix>.<extension></code>, where each export file format/size can have '''its own suffix'''

This functionality lives in the dialog's '''new second tab'''. To add another export file format or size, click on <code>'''Add export'''</code>, and a new line with selectable suffix, file format and dpi value settings becomes available. Layer export will include '''all objects in the layer''' (i.e. crop to content).

''Hint: If you need a background for export that is the same over all layers (e.g. for a presentation or slideshow, or for an animation), you can move that background object into the root of the SVG file, by dragging it out of a layer and placing it below all layers with the Layers/Objects dialog in Objects mode. To have all layers exported at the same size, you'd still need an (invisible) object in each layer with the desired size.''

[TODO: Add images / gifs / video link]

=== Fill and Stroke dialog ===
==== Color selector ====

[[File:HSLuv_color_picker.png|thumb|200px|HSLuv color picker mode with color wheel]]

* The more intuitive '''HSL mode''' (hue, saturation, lightness) is now the '''default mode''' of the color selector.
* All color selection modes (e.g. HSL, HSV, RGB, CMYK, CMS, HSLuv) have been moved into a '''drop-down menu''', with icons. You can get the old, tabbed look back by disabling the option in <code>Edit → Preferences → Interface: Use compact color selector mode switch</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3443 MR #3443]).
* New: '''HSLuv mode''' added for color picker. This mode lets you more intuitively select optically similar saturation of different hues ([https://en.wikipedia.org/wiki/HSLuv Wikipedia]).
* A '''color wheel''' can now be used for '''HSL, HSV and HSLuv''' color selection modes (in previous Inkscape versions, it was its own mode). Activate it by clicking on 'Color Wheel' above the color sliders area.

==== Gradient Editor is back ====

A replacement for the [https://wiki.inkscape.org/wiki/index.php?title=Release_notes/1.1#Legacy_Gradient_Editor_dialog_removed|lost gradient editor] was added to the 'Fill and Stroke' dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2688 MR #2688], [https://gitlab.com/inkscape/ux/-/issues/67 Bug UX#67]).

This allows you to add, edit and delete gradient stops directly in the 'Fill and Stroke' dialog again:

* to '''add''' a new stop, '''double click''' on the gradient preview
* to '''move''' a stop, '''click and drag''' it along the gradient preview or '''enter the stop offset value numerically''' for more precision after selecting one stop
* to '''remove''' a stop, click on it to '''select it, then press the <code>Del</code> or <code>Backspace</code> key'''
* The Gradient tool's options `repeat mode`, `reverse gradient direction`, a '''gradient selection library''' and a '''list of all stops''' have been added here, too, so all the options pertaining to gradients are in easy reach.

<div><ul>
<li style="display: inline-block;">[[File:Gradient editor adding stops.gif|frame|Changing gradient stop color, moving it, adding a new stop]]</li>
<li style="display: inline-block;">[[File:Gradient editor - repete.gif|frame|Inverting the gradient's direction and changing its repeat mode]]</li>
<li style="display: inline-block;">[[File:Adding and removing stops in to list.gif|frame|Another way to add, edit and delete single stops is to use the list of gradient stops. Users can add stops by clicking on the <code>+</code> button, and can delete them by clicking on the <code>-</code> button.]]</li>
<li style="display: inline-block;">[[File:Gradients Library.gif|frame|With the new gradient selection dropdown, users can duplicate gradients by clicking on the <code>+</code> button.]]</li>
<li style="display: inline-block;">[[File:First and last node offset.gif|frame|Users can offset (move) the first and last stops of a gradient. The color beyond the last/first gradient stop is uniformly that of the last/first stop.]]</li>
</ul></div>

[TODO: would be cool if all recordings could be resized to same height. This looks very confusing.]

==== Markers ====

[[File:Fun markers.png|thumb|right|Some new markers to play with – the pencil automatically takes on the stroke color]]

The markers drop down list has been replaced by a little dialog that displays '''all available markers in a grid''', and even allows you to '''edit the selected marker's size, distance from the line and orientation'''! This project was undertaken by '''[https://gitlab.com/inkscape/devel/mentoring/-/issues/2 GSOC student Rachana Podaralla]''' with the mentors Michael Kowalski, Marc Jeanmougin and Martin Owens ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3394 MR #3394], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3420 MR #3420]).

When clicking on the drop down for choosing the start, middle or end markers, you will see the following:
* a '''list of markers''' used in the current document at the top
* below that, a '''list of all default markers''', which also contains some '''fun new markers'''!
* at the bottom, the ''''Edit' section''', with:
** A '''preview''' of how the marker will look
** some '''number fields''' to change the '''size''' of the marker (keep the lock on to scale proportionally)
** an option to '''scale the markers when the stroke width is changed'''
** options for '''switching the marker direction'''
** the option to '''change the marker's angle and to have that angle fixed'''
** marker '''offsetting options'''
** a button to '''enable editing of markers''' (rotate, scale, move) '''on the canvas'''

[[File:Working with new markers.gif|center|frame|Adding and editing markers with the new dialog]]
[[File:Edit markers on canvas.gif|center|frame|Editing markers directly on the canvas]]

[TODO: record new animation where rotation is also presented]

==== Custom Dash patterns ====

Inkscape comes with a big choice of dash patterns by default - from tightly spaced dots to widely spaced lines, and many options and combinations in between.
Now it includes an option to '''make your own dash pattern''', in addition to the stock patterns.

To create one:

* Select '''Custom''' in the dash pattern drop-down menu. This will make '''a new text field''' show up where you can add your new custom dash pattern.
* The field accepts '''numbers and spaces'''. Each number corresponds to the length of a dash or a gap. It always starts with a dash, and when it reaches the end, it will continue with the first number again, for the next gap or dash. So if you enter an even number of numbers, e.g. '1 1 4.5 4.5' the pattern will be 'dot - short gap - dash - long gap' and then repeat again, and for an uneven number of numbers, the pattern will be inverted when the first 'set' ends.

On the canvas, you can watch how your object changes while you change the custom dash pattern numbers.

[[File:Inkscape yrHv1frJlF.gif|center|frame|Adjusting the dash pattern in a drawing]]

==== Other small changes ====

Line cap and line join order buttons have been reordered, so they match vertically ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3402 MR #3402]).
[[File:Before after caps.png|frame|left|339x339px|New, more logical ordering of line cap and line join buttons]]
<div style="clear:both;"> </div>

=== Layers and Objects dialog ===

A new dialog was created that '''merges the functionality of the familiar 'Layers' and 'Objects' dialogs''', with better performance ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3635 MR #3635], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3741 MR #3741], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3597 MR #3597], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3645 MR #3645]).

It is available from both the 'Layers' and the 'Objects' menu and offers the following functionality:

* a button to '''toggle between 'Layers' and 'Objects' view'''
* buttons to move objects '''up and down in the stack'''.
* a '''list of all layers and objects''' in the drawing, featuring new icons for the different object types
* '''8 alternating default colors''' for layers and the objects in them:
** these colors are '''used for drawing the paths''' in the respective layers
** the colors '''can be set''' (in case they clash with your theme, or you cannot see the paths that you draw) in the file <code>share/inkscape/ui/highlight-colors.css</code> in your Inkscape directory
* layer and object '''colors can be customized for each layer/object on its own''', by clicking on the vertical color bar at the end of each line
* tiny '''mask and scissor symbols''' indicate that a clip or mask is applied to an object
* object and layer '''names''' (label, not id) can be changed after a '''double-click on the current name'''
* icons for '''locking and hiding''' a layer/object light up when you hover over the layer's row (when not locked or hidden):
** <kbd>click</kbd> to '''hide/unhide''' or '''lock/unlock''', <kbd>Shift+click</kbd> to '''hide/lock other items'''
* holding <kbd>Alt</kbd> while '''hovering over an object in the dialog''' will '''highlight that object on canvas'''
* layers as well as objects can be '''multi-selected'''
* the '''context (right-click) menu for layers''' provides options '''to move, delete, rename the current layer, to lock/hide all/other/the current layers, to add a new layer and to convert a layer to a group'''
* the '''context menu for objects''' provides the same options as it would when you right-click on the object on canvas directly

''Note:''

* ''the (hidden) setting for path colors in the preferences file and the path outline color (available in Node tool preferences section) are no longer respected. If you used those previously, adjust the style.css file as a workaround (see above).''
* ''the dialog no longer offers the options to change opacity, blur or blend mode. Use the Fill and Stroke dialog as a workaround.''
* ''the type-forward search to filter for objects is no longer available. For objects, use the Search and Replace dialog as a workaround, for layers there is currently no replacement.''
* ''the buttons to move objects or layers to the bottom or to the top have been removed to improve the user interface. For both objects and layers, as a workaround you can use the buttons in the selector tool's tool controls. <kbd>Home</kbd> and <kbd>End</kbd> navigate in the dialog instead of changing positions, if the dialog has focus.''

[TODO: needs a picture]

=== Preferences ===
[[File:Require restart.png|frame|Restart Inkscape when you changed an option with this icon]]

* The preferences '''zoom ruler now respects your theme's look''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it '''selects objects only in the current layer or in all layers''' was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])
* Preferences options that '''require restarting Inkscape''' to take effect now '''display an icon''' next to them
* A set of options to '''tweak rendering performance''' and to '''test run different render settings''' has been added to the <code>Rendering</code> section. It becomes visible when you activate <code>Enable developer mode</code>

=== SVG Font Editor ===

With lots of user feedback, the '''Font Editor workflow has been updated''' with '''better previews''', '''better performance''' and a '''higher degree of organization''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3381 MR #3381], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3396 MR #3396], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3552 MR #3552], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3628 MR #3628] [https://gitlab.com/inkscape/inkscape/-/merge_requests/3916 3916]).

These changes result in a new recommended workflow:

# Open the '''SVG Font Editor dialog'''
# '''Select a name''' for your new font, using the <code>+</code> icon in the top right corner of the dialog
# Adjust the '''horizontal advance''' and the major '''font metrics''' to your liking
# '''Click on''' <code>Setup Canvas</code> to change the document format to the font size and get some guides that help you draw your letters
# Switch to the <code>Glyphs</code> tab of the dialog
# Click <code>+</code> to '''add your first letter/glyph/character''' to the list. You can also '''click the button repeatedly to automatically create a list of commonly used font characters''', from <code>Space</code> to common special characters, numbers and then upper case and lower case letters A to Z, and then even more special characters after that.
# If you like to, '''switch from list preview to grid preview''' in the bottom right corner.
# '''Select one''' of the lines / blocks in the glyphs list.
# Click on <code>Edit</code>. This will:
#* '''Create a new layer''' for the selected glyph (if there isn't one yet) and activate that layer.
#* '''Hide all other layers'''
# Now '''draw''' your letter/number/… in the new layer
# Make sure it's '''a single path''' (e.g. do <code>Path > Union</code>)
# Keep it selected, and '''click on''' <code>Get curves</code>.
# '''Continue''' selecting glyphs from the list, adding / editing them and turning them into SVG font characters until your font is complete.
# In the last tab, <code>Kerning</code>, you can select two different glyphs from the two dropdown lists, to '''adjust the default distance''' between them.
## After you've selected them, '''click on''' <code>Add pair</code>.
## Now '''adjust the distance''' between them. In addition to the preview that shows just these two glyphs, you can also make use of the '''sample text''' to see how it will look in a sentence.
## '''Continue''' adjusting letter distances until you're happy with the result.
# Save your file as '''Inkscape SVG''', and open it with another program (e.g. FontForge) to be able to '''convert that SVG font into a ttf or otf font'''.

The workflow is based upon the following SVG Font Editor dialog improvements:

* '''speed improvements''': Inkscape can now handle fonts with thousands of glyphs!
* '''automatic glyph generation''': adding a new glyph creates a new entry and populates its unicode string, based upon the previously defined glyph (next in unicode order)
* '''glyph management''': glyph editing action creates glyph-specific layers to keep glyphs organized
* '''grid glyph view''': offers a larger preview than a list

[TODO: needs screenshot]

=== Swatches ===

The '''Swatches dialog''' (<code>View → Swatches</code>) uses the same improved settings as [[#Color_palette|the color palette]] (without the 'rows' setting).
[[File:Inkscape GK3kLW1E2O.gif|none|frame|Updated Swatches dialog settings]]

=== Text and Font dialog ===

The dialog's '''width has been reduced''', so it won't take up excessive amounts of space when docked ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3314 MR #3314]).

=== Trace Bitmap ===

The '''Trace Bitmap''' dialog received a new, shiny interface ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3405 MR #3405]):

* The tabs list and options have been detangled a bit, so you now have the following three tabs: '''Single scan, Multicolor, Pixel art'''
* The '''preview auto-updates''' more reliably and shows a better preview image.
* The '''preview location''' now adjusts to the dialog's format: if it is wider than tall, it moves to the right side, and if it is taller than wide, the preview appears at the bottom of the dialog.
* The number entry fields are now accompanied by '''draggable sliders''' for easier tweaking of values.
[[File:Inkscape haeFSZbdHk.gif|center|frame|Draggable sliders]]
[[File:Ezgif.com-gif-maker (24).gif|center|frame|Self-adjusting preview location]]

=== Transform dialog ===

The buttons for applying or resetting the transformation have been moved to the center, the dialog's width has been reduced, and a small visual explanation for matrix transformations has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3363 MR #3363]).

=== Welcome dialog ===

* The images have been updated with '''images from the [https://inkscape.org/gallery/=about-screen-contest/contest-for-12/ About Screen Contest for Inkscape 1.2]'''.
* A set of '''new icons for the web links''' in the second tab will hopefully help encourage user contributions to the project ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4309 MR #4309])
* There is a ''''Close' button''' now in the top right corner of the dialog.
* An option to 'Browse for other files' has been added to the dialog, so you can finally '''open any file''' (not just templates and recent files) from the dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4112 MR #4112])

== Filters ==

[TODO: Any changes here?]

== Live path effects ==
[[File:Select satelit.png|right|Select path with LPE that is responsible for the existence of this object|thumb|333x333px]]

=== Select Path Effect Parent Object ===

If you have an object selected that was created by the Live Path Effect of another object, you can now quickly '''find the responsible LPE object''' by clicking on '''the new button''' at the bottom of the 'Path Effects' dialog. This is very useful for all Live Path effects that create dependent objects which can be selected independently, like the new <code>Copies LPE</code>, the <code>Boolean Operations LPE</code>, the <code>Rotate Copies LPE</code> and many more ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479]).

=== Tiling ===

[[File:Copie LPE.gif|frame|right|The new Tiling LPE]]

Internally, we call this the ''\'Tiled Clones dialog on steroids\'''. This new LPE allows for interactive tiling, using a '''huge range of different tiling types''', setting the '''distance''' between objects numerically, changing '''scale''', '''location''', '''rotation''' per row / column or '''adding more rows and columns''' on the fly. This can be used to '''quickly copy large numbers of objects''' non-destructively and to '''create interesting grids and patterns''' and variations quickly ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3814 MR #3814]).

Features:

* Create '''identical copies of objects in a grid''' by indicating the number of rows and columns
* '''Change the horizontal and vertical spacing''' between copies by mouse or numerically, and choose the unit of those distances
* The '''gap size''' can also be '''randomized'''
* '''Offset every other row or column''' by a specified percentage of object width / height
* '''16 different mirroring modes''' (requires the setting <code>Edit → Preferences → Behavior → Live Path Effects (LPE) → Tiling → Add advanced tiling options</code> to be active!)
* '''Scale interpolation''' (5 modes):
** '''Uniform''' scaling (no interpolation)
** Blend size from '''top to bottom'''
** Blend size from '''left to right'''
** Blend size '''diagonally''' (top left: original size – bottom right: new size)
** '''Random scaling'''
* '''Rotation interpolation''' with the same 5 modes
* Option to '''automatically minimize gaps''' between copies of different sizes (does not work with rotation or diagonal mode)
* Option to allow for '''independently styling and moving''' each copy ('Split elements', moving works when the object is grouped as a 1 object group)
* Option to '''link styles''' for the case when you want '''a gradient or a pattern extend over all objects'''

=== Rotate copies ===

* New option to '''link styles''' for the case when you want a gradient or a pattern extend over all objects

=== Offset ===

* '''Improved performance''' while editing an offset by mouse

== Import / Export ==

=== SVG Import ===

When importing an SVG document, you can now also choose to open it in a new window ('Open SVG image directly using its path'). This option makes sense when using drag and drop to get Inkscape to open a new file ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4034 MR #4034])

=== Import Formats ===

* The '''DXF Import''' now supports '''more DXF features''' ([https://gitlab.com/inkscape/extensions/-/merge_requests/357 MR extensions#357]).

=== Export Formats ===

* The file format of the '''Synfig Export''' has been '''updated to > 1.4.0''' ([https://gitlab.com/inkscape/extensions/-/merge_requests/299 MR extensions#299]).

== Customization / Theming ==

=== Customizing the User Interface ===

* The '''overall font size''' of the user interface can be adjusted at <code>Edit → Preferences → Interface → Theming: Font scale</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3690 MR #3690])
* The <code>+</code>/<code>-</code> '''buttons for number entry fields''' are now '''smaller'''. If you prefer the old, wider buttons, they can be turned on again by disabling <code>Preferences → Interface : Use narrow number entry boxes</code>. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3358 MR #3358])
* Tool bar '''icon sizes''' can now be scaled on a '''continuous scale''' from 100% to 300% size in <code>Edit → Preferences → Interface → Toolbars: Toolbox icon size / Control bar icon size</code>. Changing the size '''no longer requires a restart'''.

=== Cursors ===

* The '''drop shadow is now optional''' for mouse cursors. You can turn it off in <code>Edit → Preferences → Interface → Mouse cursors: Show drop shadow</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3352 MR #3352]).

=== Icon Sets ===

* Multiple icons in the '''Multicolor icons set''' were tweaked to improve readability or contrast, e.g. the green color is now a little brighter when using a dark theme.
* '''Cursors and tool bar icons''' for the Bézier tool and the Calligraphy tool in the Multicolor icon theme '''now use the same imagery'''.

=== Themes ===

* The suggested '''default theme''' is now using the multicolor icons set ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4043 MR #4043])
* A '''contrast slider''' was added for fine tuning the selected theme's colors at <code>Edit → Preferences → Interface → Theming: Contrast</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/906 MR #906])

<gallery mode=packed heights=550px>
File:Contrast slider.gif|The contrast slider allows to fine-tune the theme's colors
</gallery>

== macOS-specific Changes ==

* The '''minimum operating system version''' supported is now '''macOS 10.13'''. (The prior version, Inkscape 1.1.x, supported macOS 10.11 and newer.)
* All '''special menu items''' in the application menu have been enabled and hidden from other menus, so Inkscape '''feels more integrated''' with macOS ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3767 MR #3767])
* Inkscape now provides a '''.dmg file for arm64''' (M1) Apple computers

''Tip: Inkscape performance is better on macOS with a theme other than 'Adwaita' - e.g. 'Minwaita' and others.''

== Windows-specific Changes ==

* Modifier keys now work with graphics tablet stylus input ([https://gitlab.com/freedesktop-sdk/mirrors/gnome/gtk/-/commit/46c12b2c922d5592cedd29624cbf3be6b4411084 Commit #46c12b])

== Extensions ==

=== Features ===

==== General Extension Changes ====

* Extensions now better support documents with CSS styles and inherited styles.

==== New Extensions ====

* The '''Clipart Importer''' extension allows to search and download SVG resources from the Wikimedia, OpenClipart & other online sources. It is available from <code>File → Import Web Image</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/441 MR extensions#441]).
* The <code>Document → Process Illustrator SVG...</code> extension assists with '''importing Adobe Illustrator documents with layers and the correct scale''' ([https://gitlab.com/inkscape/extensions/-/merge_requests/351 MR extensions#351], [https://gitlab.com/inkscape/extensions/-/merge_requests/414 MR extensions#414]).

[TODO: Clipart importer needs image, is greyed out for some reason?]

==== Particular extensions ====

[[File:Modes of the Extrude extension.png|right|thumb|400x400px|The modes of the Extrude extension. A new mode, "Snug", has been added for Inkscape 1.2.]]

* In the '''Add nodes''' extension, you can now choose the unit of the segment length ([https://gitlab.com/inkscape/extensions/-/merge_requests/346 MR extensions#346], [https://gitlab.com/inkscape/extensions/-/issues/127 Issue extensions#127]).
* The Color tab of the '''Calendar''' now uses a color chooser widget instead of asking for Hex values ([https://gitlab.com/inkscape/extensions/-/merge_requests/355 MR extensions#355], [https://gitlab.com/inkscape/extensions/-/issues/396 Issue extensions#396]).
* The '''Extrude''' extension has been rewritten ([https://gitlab.com/inkscape/extensions/-/merge_requests/386 MR extensions#386]). It includes a new mode, "Snug", where the boundary of the extruded rectangle follows the source paths. 'Extrude' now handles paths with multiple subpaths and doesn't require conversion of rectangles or circles to path anymore ([https://gitlab.com/inkscape/extensions/-/issues/190 Issue extensions#190]). The extruded shapes are inserted in between the two selected elements in stacking order, which is more useful than the previous behavior (inserting after the first selected element).
* The '''Formula (pdflatex)''' equation has been made more user-friendly. It now features a font size selector, a field to specify preamble contents, better support for scaled documents and better error messages on compile errors ([https://gitlab.com/inkscape/extensions/-/merge_requests/453 MR extensions#453]).
* The '''Frame''' extension has been rewritten and now supports additional options, such as elliptical frames, offset frame and putting the fill below the object ([https://gitlab.com/inkscape/extensions/-/merge_requests/430 MR extensions#430], [https://gitlab.com/inkscape/extensions/-/issues/214 Issue extensions#214]).
* The '''Motion''' extension now has an option to take the extrusion color and opacity from the selected path ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
* Document Info ([https://gitlab.com/inkscape/extensions/-/merge_requests/401 MR extensions#401]) and Guides creator ([https://gitlab.com/inkscape/extensions/-/merge_requests/424 MR extensions#424]) extensions were adjusted to work with '''multi-page documents'''
* The '''Guides Creator''' extension, now also features an option that avoids creating duplicate guides, and an option for alternating margins for even and odd pages ([https://gitlab.com/inkscape/extensions/-/merge_requests/424 MR extensions#424]) .
* The '''Split text''' extension has been rewritten and now supports manual kerning ([https://gitlab.com/inkscape/extensions/-/issues/142 Issue extensions#142]) and SVG2 flowed text ([https://gitlab.com/inkscape/extensions/-/issues/257 Issue extensions#257]) ([https://gitlab.com/inkscape/extensions/-/merge_requests/326 MR extensions#326]).
* '''QRCodes''' with a maximum size of 177x177 can now be created, which allows to encode up to about 2 standard pages of text. Instead of the well-known black rectangular tiles, the extension can now also tile clones of a selected object ([https://gitlab.com/inkscape/extensions/-/merge_requests/394 MR extensions#394], [https://gitlab.com/inkscape/extensions/-/issues/150 Issue extensions#150]).

=== Bugs fixed ===

==== All extensions ====

* Unit conversions are more consistent now ([https://gitlab.com/inkscape/extensions/-/merge_requests/329 MR extensions#329]), and several bugs pertaining to misinterpretation of units have been fixed.
* Extensions that query properties of paths with multiple subpaths now get more correct results if that path uses relative path commands ([https://gitlab.com/inkscape/extensions/-/merge_requests/438 MR extensions#438], [https://gitlab.com/inkscape/extensions/-/issues/450 Issue extensions#450]).
* When extensions set an element to "insensitive" (locked), this change is honored by Inkscape ([https://gitlab.com/inkscape/extensions/-/commit/d5282bd2341d24bc53cec02aed81e2f3ee6c6050 commit extensions#d5282bd2])
* The defaults of parameters are now identical in inx files and in the command line interface of the extensions ([https://gitlab.com/inkscape/extensions/-/merge_requests/325 MR extensions#325])
* Gradients whose stop positions are given in percentages are now handled ([https://gitlab.com/inkscape/extensions/-/merge_requests/374 MR extensions#374])
* Hide the console window on Windows when calling external utilities ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407], [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])
* The <code>BaseElement.duplicate()</code> function now makes sure that the duplicated element and its children have unique IDs ([https://gitlab.com/inkscape/extensions/-/merge_requests/426 MR extensions#426], [https://gitlab.com/inkscape/extensions/-/issues/379 Issue extensions#379]).
* The "Reverse Path" method now returns correct results for paths with multiple subpaths ([https://gitlab.com/inkscape/extensions/-/merge_requests/427 MR extension#427], [https://gitlab.com/inkscape/extensions/-/issues/445 Issue extensions#445]).
* A bug parsing color components of 1 (1.0, 100%) has been fixed. <code>"1.0"</code>, <code>1.0</code> and <code>"100%"</code> are treated as <code>255</code>, while <code>"1"</code> and <code>1</code> are treated as <code>1</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/456 MR extensions#456], [https://gitlab.com/inkscape/extensions/-/issues/402 Issue extensions#402]).
* Several small fixes that make working with paths and clones more predictable and robust ([https://gitlab.com/inkscape/extensions/-/merge_requests/433 MR extensions#433])
* Small changes improving parameter description ([https://gitlab.com/inkscape/extensions/-/merge_requests/452 MR extensions#452], [https://gitlab.com/inkscape/extensions/-/issues/452 Issue extensions#452])

==== Particular extensions ====

* In the '''Add nodes''' extension, closed paths were previously changed to open paths, and an erroneous node was added. Other and third-party extension will probably profit from the underlying bugfix as well ([https://gitlab.com/inkscape/extensions/-/merge_requests/336 MR extensions#336], [https://gitlab.com/inkscape/extensions/-/issues/209 Issue extensions#209]).
* The live preview of the '''Calendar''' extension now works ([https://gitlab.com/inkscape/extensions/-/merge_requests/394 MR extensions#394]).
* Multiple bugs in the '''DXF import''' extension were fixed, such as a loss of layering information ([https://gitlab.com/inkscape/extensions/-/merge_requests/410 MR extensions#410], [https://gitlab.com/inkscape/extensions/-/issues/377 Issue extensions#377]), and import of inserted blocks that have been rotated and flipped ([https://gitlab.com/inkscape/extensions/-/merge_requests/411 MR extensions#411]), extruded elements and multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/432 MR extension#432], [https://gitlab.com/inkscape/extensions/-/issues/286 Issue extensions#286]). An incorrect unit in the documentation has been exchanged ([https://gitlab.com/inkscape/extensions/-/merge_requests/358 MR extensions #358]).
* When using the '''DXF Outline (R12)''' export, elements in nested groups are now exported correctly ([https://gitlab.com/inkscape/extensions/-/merge_requests/347/ MR extensions#347], [https://gitlab.com/inkscape/extensions/-/issues/382 Issue extensions#382]). It also doesn't include (invisible) paths contained in clips and masks anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/440 MR extensions#440], [https://gitlab.com/inkscape/extensions/-/issues/381 Issue extensions#381]) and documents are exported with the correct scale when scale is different than 1 ([https://gitlab.com/inkscape/extensions/-/merge_requests/466 MR extensions#466], [https://gitlab.com/inkscape/extensions/-/issues/443 Issue extensions#443])
* The '''DXF14 export''' now shows a better error message in case of a very, very deeply nested SVG document ([https://gitlab.com/inkscape/extensions/-/merge_requests/442 MR extensions#442], [https://gitlab.com/inkscape/extensions/-/issues/360 Issue extensions#360]). Also a warning message regarding the Robo-Master spline option has been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/439 MR extensions#439], [https://gitlab.com/inkscape/extensions/-/issues/225 Issue extensions#225]).
* A crash in the '''Embed image''' extension has been fixed, in which images were erroneously determined as missing by the extension ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461], [https://gitlab.com/inkscape/extensions/-/issues/441 Issue extensions#441]).
* The '''Extensions Manager''' is now shipped with Inkscape and doesn't download itself automatically anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
* On Windows, the '''Extract image''' extension now correctly links the extracted files ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461]).
* The slicing positions in the '''Guillotine''' extension are now correct, they were previously off following the flip of the y axis in Inkscape 1.0 ([https://gitlab.com/inkscape/extensions/-/merge_requests/334 MR extensions#334], [https://gitlab.com/inkscape/extensions/-/issues/269 Issue extensions#269]).
* In '''GCodetools''', multiple crashes have been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/335 MR extensions#335], [https://gitlab.com/inkscape/extensions/-/issues/312 Issue extensions#312]; [https://gitlab.com/inkscape/extensions/-/merge_requests/307 MR extensions#307], [https://gitlab.com/inkscape/extensions/-/issues/322 Issue extensions#322]; [https://gitlab.com/inkscape/extensions/-/merge_requests/388 MR extensions#388], [https://gitlab.com/inkscape/extensions/-/issues/276 Issue extensions#276]), however this module is currently unmaintained and in need of attention. '''Contributions are highly welcome!''' For this reason, the module has been given it's own repository ([https://gitlab.com/inkscape/extensions/-/merge_requests/402 MR extensions#402]).
* The Hue Level in the '''HSL Adjust''' extension now has a range of 360 ([https://gitlab.com/inkscape/extensions/-/merge_requests/400 MR extensions#400])
* The '''HTML5 canvas export''' now works better with non-Inkscape SVG documents ([https://gitlab.com/inkscape/extensions/-/merge_requests/467 MR extensions#467]). Exported files also now have correct output for closed paths and objects with transparency ([https://gitlab.com/inkscape/extensions/-/merge_requests/345 MR extensions#345], [https://gitlab.com/inkscape/extensions/-/issues/332 Issue extensions#332]).
* The '''Interpolate extensions''' (Interpolate and interpolate attribute) have been completely rewritten and multiple issues have been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/240 MR extensions#240]).
* The '''JPEG export''' previously converted a transparent background to black ([https://gitlab.com/inkscape/extensions/-/issues/366 Issue extensions#366]). Now, the document background color is used ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3994 MR #3994]). This also affects the other Raster export extensions. Additionally, the JPEG export now works with even larger resolutions ([https://gitlab.com/inkscape/inbox/-/issues/6522 Issue inbox#6522], [https://gitlab.com/inkscape/extensions/-/merge_requests/445 MR extensions#445]).
* Several bugs in the '''Formula (pdflatex)''' extension have been fixed, such as incorrect insertion position ([https://gitlab.com/inkscape/extensions/-/issues/339 Issue extensions#339]) and random character substitution in documents with many formulae ([https://gitlab.com/inkscape/extensions/-/merge_requests/453 MR extensions#453]). The extension now also works on Windows if the user name is longer than 8 characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/448 MR extensions#448], [https://gitlab.com/inkscape/extensions/-/issues/287 Issue extensions#287]).
* A bug in the rotation sense of the '''Lindenmayer''' extension has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/437 MR extensions#437], [https://bugs.launchpad.net/inkscape/+bug/1094627 LP issue 1094627])
* The '''Motion''' extension now gives better results for paths with multiple closed subpaths ([https://gitlab.com/inkscape/extensions/-/issues/266 Issue extensions#266]) and when the selected element is part of a transformed group. ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
* The '''Optimized PNG export''' doesn't crash anymore when running it with default parameters ([https://gitlab.com/inkscape/extensions/-/merge_requests/463 MR extensions#463], [https://gitlab.com/inkscape/extensions/-/issues/395 Issue extensions#395])
* A useless warning message when using '''Optimized SVG''' output was removed ([https://gitlab.com/inkscape/extensions/-/merge_requests/368 MR extensions#368] , [https://gitlab.com/inkscape/extensions/-/issues/428 Issue extensions#428])
* The '''Pixel snap''' extension now aligns objects to the coordinate system starting at the top left of the page. The previous behavior, snapping them to a grid aligned with the page bottom, can be activated in the settings ([https://gitlab.com/inkscape/extensions/-/merge_requests/429 MR extensions#429], [https://gitlab.com/inkscape/extensions/-/issues/264 Issue extensions#264]). A bug related to inconsistent unit conversion has been fixed as well.
* Several bugs in the '''PostScript (PS) / EPS import''' have been adressed: It now handles file names with non-latin characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/408 MR extensions#408], [https://gitlab.com/inkscape/extensions/-/issues/281 Issue extensions#281]) on Windows and doesn't rotate the image anymore if the majority of the text is not oriented left-to-right ([https://gitlab.com/inkscape/extensions/-/merge_requests/457 MR extensions#457] and [https://gitlab.com/inkscape/extensions/-/issues/258 Issue extensions#258]). Also a clearer error message is shown for invalid PS/EPS files ([https://gitlab.com/inkscape/extensions/-/merge_requests/454 MR extensions#454], [https://gitlab.com/inkscape/extensions/-/issues/404 Issue extensions#404])
* In the '''Randomize Colors''' extension, shapes with unset opacity are not ignored anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/331 MR extensions#331] [https://gitlab.com/inkscape/extensions/-/issues/236 Issue extensions#236]).
* A crash in the '''Render Polyhedron''' extension when attempting to render a custom object defined by its edges has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/390 MR extensions#390] , [https://gitlab.com/inkscape/extensions/-/issues/408 Issue extensions#408]).
* The '''Replace Color''' extension now processes colors in RGBA space ([https://gitlab.com/inkscape/extensions/-/merge_requests/392 Issue extensions#392], [https://gitlab.com/inkscape/extensions/-/issues/419 Issue extensions#419]).
* The "Tangential Offset" parameter of the '''Scatter''' extension is now a percentage of the pattern width, and an issue with nested groups has been resolved ([https://gitlab.com/inkscape/extensions/-/merge_requests/327 MR extensions#327]). Another issue where the spacing was off when using the "stretch" mode has also been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/327 MR extensions#327]).
* The '''Synfig export''' now exports objects that are not paths (such as rectangles, texts, circles) correctly again ([https://gitlab.com/inkscape/extensions/-/issues/198 Issue extensions#198]); and paths with multiple subpaths are converted correctly ([https://gitlab.com/inkscape/extensions/-/issues/197 Issue extensions#197]) ([https://gitlab.com/inkscape/extensions/-/merge_requests/462 MR extensions#462]).
* The '''TIFF export''' now also works on Linux ([https://gitlab.com/inkscape/extensions/-/merge_requests/458 MR extensions#458], [https://gitlab.com/inkscape/extensions/-/issues/422 Issue extensions#422])
* In the '''Visualize Path''' extensions '''Measure Path''' and '''Number Nodes''', the results are now correct also when the parent of the selected object is transformed ([https://gitlab.com/inkscape/extensions/-/merge_requests/314 MR extensions#314], [https://gitlab.com/inkscape/extensions/-/issues/171 Issue extensions#171]).
* A crash in the '''Voronoi Diagram''' extension when applied to non-Inkscape documents has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/313 MR extensions#313], [https://gitlab.com/inkscape/extensions/-/issues/222 Issue extensions#222]), and the output is now correct independent of the document unit ([https://gitlab.com/inkscape/extensions/-/issues/403 Issue extensions#403], [https://gitlab.com/inkscape/extensions/-/merge_requests/382 MR extensions#382]).
* The '''Webslicer''' extension now correctly cleans up its temporary files ([https://gitlab.com/inkscape/extensions/-/merge_requests/436 MR extensions#436])

=== Extension Development ===

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

''Main Article: [https://inkscape.gitlab.io/extensions/documentation/authors/update1.2.html Updating your Extension for 1.2]''

A lot of additional features have been added to inkex, including a new Style API, a new Units API, support for multipage documents and more.
Although there are no breaking changes in this release, some methods have been deprecated.

* The improved CSS style and style inheritance handling is enabled for all bundled extensions. If you want to use this functionality in an extension you maintain, see [https://inkscape.gitlab.io/extensions/documentation/authors/update1.2.html#new-style-api New Style API].
* A GUI API (based on [https://pypi.org/project/gtkme/ gtkme]) has been added, so extensions can now ship GTK-based user interfaces ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421], [https://gitlab.com/inkscape/extensions/-/merge_requests/450 MR extensions#450], [https://gitlab.com/inkscape/extensions/-/merge_requests/465 MR extensions#465]).
* Export extensions can specify that they are only to be listed in "Export as" ([https://gitlab.com/inkscape/extensions/-/merge_requests/371 MR extensions#371], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3600 MR#3600]).
* Color extensions can now process in RGBA space, previously only separate processing of color and opacity was possible (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/392 extensions#392]).
* The path conversion for arcs and stars have been added, so when extensions create these objects, they are rendered in a browser as well and can be processed further by the same extension. ([https://gitlab.com/inkscape/extensions/-/merge_requests/387 MR extensions#387], [https://gitlab.com/inkscape/extensions/-/issues/240 Issue extensions#240]).
* API functions for the new [[Release notes/1.2#Page tool|multipage feature]] have been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/399 MR extensions#499]).

==== Extension Development Documentation ====

* All the documentation from the Wiki and the Gitlab project wiki has been '''[https://inkscape.gitlab.io/extensions/documentation/ compiled in a single place]'''. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443], [https://gitlab.com/inkscape/extensions/-/merge_requests/451 MR extensions#451])
* The '''tutorials for extension authors''' have been improved. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443])
* '''Versioning information''' is now contained in the documentation. This shows extensions authors in which Inkscape version new API functionality was added or deprecated. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443])
* The API documentation has been updated into the familiar ReadTheDocs layout ([https://gitlab.com/inkscape/extensions/-/merge_requests/310 MR extensions#310]) and is now generated with a newer version of Sphinx ([https://gitlab.com/inkscape/extensions/-/commit/edf232209494107c9f33ccc6f101726a7fd73adb Commit extensions#edf23220]).
* Fix some small mistakes in the documentation ([https://gitlab.com/inkscape/extensions/-/merge_requests/324 MR extensions#324])

==== Under the hood ====

* Various upgrades to the testing library [https://gitlab.com/inkscape/extensions/-/merge_requests/332 MR extensions#332], [https://gitlab.com/inkscape/extensions/-/merge_requests/383 MR extensions#383] now make it easier to test extensions automatically. Our test suite is now continuously running on Python 3.7-3.10 ([https://gitlab.com/inkscape/extensions/-/merge_requests/370 MR extensions#370]) on Linux as well as Python 3.8 on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/404 MR extensions#404]).
* Added issue template ([https://gitlab.com/inkscape/extensions/-/merge_requests/377 MR extensions#377]) and merge request template ([https://gitlab.com/inkscape/extensions/-/merge_requests/416 MR extensions#416]) to communicate more effectively.
* inkex can be installed via <code>pip</code> by providing the url of a pipeline artifact, even in forks ([https://gitlab.com/inkscape/extensions/-/merge_requests/353 MR extensions#353]).
* The code formatting of the extensions repository has been made consistent ([https://gitlab.com/inkscape/extensions/-/merge_requests/418 MR extensions#418]). This enables contributors to think less about formatting and more about what matters.
* Improvements to code quality ([https://gitlab.com/inkscape/extensions/-/merge_requests/419 MR extensions#419], [https://gitlab.com/inkscape/extensions/-/merge_requests/422 MR extensions#422], [https://gitlab.com/inkscape/extensions/-/merge_requests/423 MR extensions#423], [https://gitlab.com/inkscape/extensions/-/merge_requests/428 MR extensions#428]) and clearer communication of it ([https://gitlab.com/inkscape/extensions/-/merge_requests/420 MR extensions#420]).
* A dependency management system, [https://python-poetry.org/ poetry], has been introduced ([https://gitlab.com/inkscape/extensions/-/merge_requests/446 MR extensions#446]). This provides packagers with the necessary information which versions of python modules the extensions are currently tested against.
* The deprecated <code>inkex.py</code> file has been removed ([https://gitlab.com/inkscape/extensions/-/merge_requests/460 MR extensions#460]) since it's interfering with the new dependency manager.
* The localization of the extensions has been improved ([https://gitlab.com/inkscape/extensions/-/merge_requests/425 MR extensions#425]).
* It is now possible to use ngettext and pgettext in extensions for better translations ([https://gitlab.com/inkscape/extensions/-/merge_requests/459 MR extensions#459]).

== Command line ==

* ''''verbs' have been removed'''. All verbs are available as 'actions' now (see [[#Behind_the_curtains|below]] for more context) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3884 MR #3884], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3874 MR #3874]).
* A new action for '''scaling by a factor''' has been added, it replaces the previous one, which is now called 'grow' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880]).

== Behind the curtains ==

* '''Gio::Actions''': The old 'verbs' were converted to 'actions'. This work was done to prepare for migrating to Gtk4. It also makes it possible to reach them all '''from the commands palette''', to assign keyboard shortcuts them and to use them on the command line. A big part of this work was done by '''[https://wiki.inkscape.org/wiki/index.php?title=GSoC_2021_Verbs_to_Gio::Actions Google Summer of Code student SUSHANT A.A.]''' with the mentors Alexander Valavanis, Ted Gould and Tavmjong Bah.
* Support for x, y, width and height SVG2 attributes on <code><symbol></code> has been added. It follows the logic of the <svg> element, which already supported these attributes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3828 MR #3828])
* '''Continuous integration''' has been improved and maintained
* A whole lot of '''code cleanup and refactoring''' has been done to improve maintainability
* Many '''new tests''' were written to be able to detect breakages early

== Notable bugfixes ==

=== Crash fixes ===

Fixed a crash that occurred …

* when closing Inkscape while drawing a '''3D box''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4018 MR #4018], [https://gitlab.com/inkscape/inkscape/-/issues/2390 Bug #2390])
* when flipping a grouped '''3D box''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3698 MR #3698])
* when using Undo after switching from the '''3D box''' tool to another tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4192 MR #4192], [https://gitlab.com/inkscape/inkscape/-/issues/2854 Bug #2854])
* when pressing <kbd>Backspace</kbd> while using the '''Bézier tool''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3715 MR #3715], [https://gitlab.com/inkscape/inkscape/-/issues/2764 But #2764])
* when hatching with the '''Calligraphy tool''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3927 MR #3972], [https://gitlab.com/inkscape/inkscape/-/issues/3173 Bug #3173])
* using '''Document Properties''' dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3400/ MR #3400])
* when '''dragging and dropping''' SVG files from klatexformula into Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3710 MR #3710])
* when using the '''Eraser tool''' (five different crashes fixed) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4079 MR #4079], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4008 MR #4008])
* when drawing a rectangle after closing the '''Icon Preview dialog''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3439 MR #3439])
* when copying/cutting/stamping various '''Live Path Effects''' (multiple crash and bug fixes) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479])
* when copying a path with the 'Attach path' '''Live Path Effect''' ([https://gitlab.com/nathanal/inkscape/-/commit/8fd705fbc3ec31bffd51ffaa7e3a8a1efcf49a36 Commit 8fd705], [https://gitlab.com/inkscape/inkscape/-/issues/626 Bug #626])
* when selecting an object with the 'Power Stroke' '''Live Path Effect''' after reopening a file ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3546 MR #3546], [https://gitlab.com/inkscape/inkscape/-/issues/2716 Bug #2716])
* when editing a shape with an inverse mask applied to it with the '''Node tool''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4080 MR #4080], [https://gitlab.com/inkscape/inkscape/-/issues/3286 Bug #3286])
* when trying to '''open''' an SVG file with invalid CSS pseudoclasses ([https://gitlab.com/inkscape/inkscape/-/issues/3358 Bug #3358], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4219 MR #4219])
* when changing the pattern back in the '''Paint Servers dialog''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4139], [https://gitlab.com/inkscape/inkscape/-/issues/3327 Bug #3327])
* when '''quitting''' Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3681 MR #3681])
* when using the '''Spray tool''' to spray multiple items in single path mode ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3470 MR #3470])
* when clicking on a color after reopening the '''Swatches dialog''' ([https://gitlab.com/inkscape/inkscape/-/issues/3221 Bug #3221], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3991 MR #3991])
* when trying to add a Live Path Effect to a '''symbol''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3520 MR #3520])
* when scrolling quickly through line height units in the the '''Text tool''''s tool controls bar ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3541 MR #3541])

=== Other bug fixes ===

* The '''Align and Distribute dialog''' no longer starts out with node alignment options, this is strictly limited to when the Node tool is in use.
* Improved '''Boolean Operation''' algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3724 MR #3724])
* The '''Calligraphy tool''' no longer inverts the tilt direction ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3782 MR #3782], [https://gitlab.com/inkscape/inkscape/-/issues/1692 Bug #1692])
* the '''Calligraphy tool''' no longer leaves any blots on locked layers when trying to draw on them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3882 MR #3882], [https://gitlab.com/inkscape/inkscape/-/issues/3154 Bug #3154])
* macOS users can now '''close''' Inkscape from the Welcome screen ([https://gitlab.com/inkscape/inkscape/-/issues/2762 MR #2762])
* The Zoom buttons are back in the '''Commands bar''': <code>Zoom to fit selection in window</code>, <code>Zoom to fit drawing in window</code>, <code>Zoom to fit page in window</code> and <code>Center page in window</code> ([https://gitlab.com/inkscape/inkscape/-/issues/1910 Bug #1910], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3638 MR #3638])
* The search results in the '''Commands palette''' are now ordered in a more helpful way ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2834])
* '''Copy-pasting''' groups using CSS classes for objects inside them no longer turns them all black ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3656 MR #3656])
* '''Dialogs''' that have just been opened receive focus again, so they can be used with a keyboard, too ([https://gitlab.com/inkscape/inkscape/-/issues/3482 Bug #3482], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4381 MR #4381])
* When the canvas has the focus, open '''dialogs''' do not steal keyboard shortcuts from it anymore ([https://gitlab.com/inkscape/inkscape/-/issues/2409 Bug #2409], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3176 MR #3176])
* '''Document properties dialog and menu''' agree about whether guides are visible and/or locked now ([https://gitlab.com/inkscape/inkscape/-/issues/663 Bug #663], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4346 MR #4346])
* Inkscape no longer slows down when '''using grids and having the Document Properties dialog open''' on macOS
* Units in the '''Document Properties dialog''' now adjust properly when scaling the document ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3403 MR #3403])
* For files without a viewbox, the '''Document properties dialog''' no longer refuses to change the Display unit ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3866 MR #3866], [https://gitlab.com/inkscape/inkscape/-/issues/872 Bug #872])
* The '''Eraser tool''' no longer leaves red traces when it cannot erase ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4079 MR #4079], [https://gitlab.com/inkscape/inkscape/-/issues/540 Bug #540])
* The '''Eraser tool''' now even cuts paths with only two nodes or arcs and clones (unlinking them) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4079], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4008 MR #4008])
* '''Export file names''' are now saved relative to the file's location (previously, we were saving absolute paths in the SVG document) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4166 MR #4166], [https://gitlab.com/inkscape/inkscape/-/issues/804 Bug #804])
* '''Exported raster images''' without alpha layer (no transparency) such as RGB and Greyscale PNGs, or JPG now use the page background color for export instead of black ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3994 MR #3994], [https://gitlab.com/inkscape/inkscape/-/issues/1357 Bug #1357])
* running '''extensions''' no longer fails when you've run them many times already ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3871 MR #3871], [https://gitlab.com/inkscape/inkscape/-/issues/2861 Bug #2861])
* Scaling a stroke by percentage in the '''Fill and Stroke dialog''' no longer changes the stroke pattern and no longer shrinks instead of growing ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4198 MR #4189], [https://gitlab.com/inkscape/inkscape/-/issues/792 Bugs #792], [https://gitlab.com/inkscape/inkscape/-/issues/793 #793], [https://gitlab.com/inkscape/inkscape/-/issues/1238 #1238])
* The default value for 'saturate' in the color matrix '''filter''' has been fixed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3626 MR #3626])
* '''Find and Replace''' now works better if a text has a description and nested tspans ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3551 MR #3551])
* Editing fonts with the '''Font Editor dialog''' now also works for SVG fonts without a label (as created by FontForge)
* '''Guides''' do not move around anymore when resizing the document ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4127 MR #4127], [https://gitlab.com/inkscape/inkscape/-/issues/1230 Bug #1230])
* '''Guide handles''' are always correctly centered on the guide line. This change also fixes a similar positioning error that affected node handles ([https://gitlab.com/inkscape/inkscape/-/issues/2022 Bug #2022], [https://gitlab.com/inkscape/inkscape/-/issues/2604 Bug #2604], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 MR #3870]).
* When a linked '''image''' can not be found, Inkscape now no longer uses (and saves the file with) altered image sizes ([https://gitlab.com/inkscape/inkscape/-/issues/3115 Bug #3115], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3842 MR #3842])
* '''Imported''' .cdr files will now use correct measurements ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3879 MR #3879], [https://gitlab.com/inkscape/inkscape/-/issues/2983 Bug #2983])
* '''Node tool''' handles for smooth and symmetrical nodes now scale along with the other handles, according to the preferences setting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3679 MR #3679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3699 MR #3699])
* '''Perspective/envelope LPE''' now works on objects with 0 width or height . (edge cases for single line stroke) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2712 MR #2712])
* The '''Preferences''' option to 'enable dynamic relayout for incomplete sections' has been removed, because it has started to break the interface ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3887 MR #3887])
* '''Saving to .odg''' format works again ([https://gitlab.com/inkscape/inkscape/-/issues/3385 Bug #3385], [https://gitlab.com/inkscape/inkscape/-/merge_requests/4316 MR #4316])
* When scaling and snapping with the '''Selector tool''', the snapping now uses the correct location when geometrical bounding box is being used ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3990 MR #3990], [https://gitlab.com/inkscape/inkscape/-/issues/2212 Bug #2212])
* When clicking and dragging an object with the '''Selector tool''', the correct object is now always dragged (affected Windows) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3735 MR #3735])
* Improvements to snapping with the node tool (performance, add useful snap targets, remove useless snap targets) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3890 MR #3890], more info in [https://gitlab.com/inkscape/inkscape/-/merge_requests/3889 MR #3889])
* Text tool is more verbose again in the '''status bar''' when editing flowed texts ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4201 MR #4201], [https://gitlab.com/inkscape/inbox/-/issues/4449 Bug inbox#4449])
* Transform handle keyboard shortcuts are now displayed in the '''status bar''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3809 MR #3809])
* A small margin was added on the right end of the '''status bar''', to prevent canvas rotation when the user's intention was to resize the Inkscape window ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3824 MR #3824], [https://gitlab.com/inkscape/inkscape/-/issues/918 Bug #918])
* '''Symbols''' from custom symbol libraries created with Inkscape are now inserted in the correct size ([https://gitlab.com/inkscape/inkscape/-/merge_requests/4228 MR #4228], [https://gitlab.com/inkscape/inkscape/-/issues/1319 Bug #1319])
* The last line in a flowed '''text''' paragraph is not justified anymore ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3780 MR #3780])
* When moving a flowed '''text''' and its flow shape together, the flowed text now stays where it belongs ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3695 MR #3695])
* Multiline vertical '''texts''' in legacy Inkscape documents that have been edited in current Inkscape now are placed correctly in browsers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3537 MR #3537])
* '''Zoom''' shortcuts from the numpad work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3773 MR #3773])

* Multiple '''memory leak''' fixes and reductions ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3508 MR #3508], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3058 MR #3058], [https://gitlab.com/inkscape/inkscape/-/commit/51f3bb43774e2a208bfb3b80c62621bc58de8855 Commit 51f3bb4], [https://gitlab.com/inkscape/inkscape/-/commit/74bfe1555d3f9d4ed97c2e58f96d5f5b4eca303d Commit 74bfe1], and many more)
* Lots of '''spelling, phrasing and translatability''' fixes
* Lots of large or small '''performance improvements''' (e.g. [https://gitlab.com/inkscape/inkscape/-/merge_requests/3838 MR #3838])

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small portion 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.2 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.2.x commit history].

== Translations ==

The following UI translations received updates (as of May 6 2022):

* Brazilian Portuguese
* Catalan
* Czech
* Dutch
* Farsi
* French
* German
* Hebrew
* Hungarian
* Icelandic
* Irish
* Italian
* Japanese
* Korean
* Polish
* Portuguese
* Russian
* Simplified Chinese
* Slovenian
* Spanish
* Traditional Chinese
* Turkish
* Ukrainian



The following documentation translations received updates:

* Simplified Chinese

=== Contributing to interface translations ===

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

== Documentation ==

* Adjusted font sizes for Eastern languages ([https://gitlab.com/inkscape/inkscape-docs/documentation/-/merge_requests/269 MR docs#269], [https://gitlab.com/inkscape/inkscape-docs/documentation/-/issues/59 Bug docs#59])

=== 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 ==

The inkscape.org website was updated from Django 1.1 to Django 2.x by '''[https://pulsar17.me/2021/08/gsoc-work Google Summer of Code student Ishaan Arora]''' with the mentors Thomas Holder and Martin Owens. This was in preparation for the goal of updating Django to 3.x, which Ishaan Arora is currently working on.

== Important changes for packagers ==

* Dithering for gradients (see [[#Dithering|Dithering section]]) is available with a build flag (<code>-DWITH_INTERNAL_CAIRO=ON</code>), which causes Cairo to be patched for dithering during the build process. Please find more information in [https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812].
* New dependency on <code>python-cssselect</code> added which is required for usage of Inkscape extensions ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3239 MR #3239])
* Added Python <code>appdirs</code> dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568])
* As Python <code>distutils</code> are now deprecated, they have been replaced by <code>python3-packaging</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/368 MR extensions#368])
* The extension that imports images from the internet requires the Python <code>cachecontrol</code> module
* gcodetools (<code>gcodetools</code>), extension manager (<code>inkman</code>) and clipart importer (<code>clipart</code>) are now all submodules of the extensions submodule. Make sure to update submodules recursively with <code>--recurse-submodules</code> when updating your git branches!

== Known issues [as of 2022-05-10] ==

* Gradient editing:
** If you convert your gradient to swatch, the gradient editor cannot be used for editing it anymore.
** Canvas stops and gradient editor stops highlighting will stop working in some cases.
* If you want to '''print a specific range of pages / a specific page''', you can select page numbers in the print dialog. However, this only prints the first page currently.
* The option to specify a margin when resizing the page to the selection is currently not available (formerly available in Document Properties dialog, in the future planned for the Page tool).
* Spellchecking is not available on macOS
* Menus on M1 (ARM) architecture Apple computers do not display arrows for expandable menu items

== Other releases ==

{{:Release notes}}

Release notes/1.2

2022-02-03T17:42:08Z

Oskay: Update macOS minimum version

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

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.'''

* Inkscape documents can now hold '''multiple pages''', which are managed by the new '''[[#Page_tool|Page tool]]'''
* '''Editable [[#Markers|markers]] and [[#Custom_Dash_patterns|dash patterns]]'''
* '''[[#Layers_and_Objects_dialog|Layers and objects dialog merged]]'''
*'''[[#Alignment_and_Distribution_snapping|On-canvas alignment snapping]]'''
* '''[[#Selector_Tool|Selectable origin for numerical scaling and moving]]'''
* '''[[#Align_and_distribute|All alignment options in a single dialog]]'''
* '''[[#Gradient_Editor_is_back|Gradient editing in the Fill and Stroke dialog]]'''
* [[Release notes/1.2#Export Dialog|Export dialog can export Multiple files simultaneously]]
* '''[[#Snapping|Snap settings refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

The overall look and options of the Color palette and the Swatches dialog got a massive overhaul ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2881 MR #2881]):

* When switching the color palette, the switcher shows a colorful preview line for each palette
* Between 1 and 5 palette rows that can be displayed all at once, or scrolled through vertically / using the arrow buttons
* Improved and reliably working settings for padding, tile size and tile shape / auto-stretching

[[File:Color pallet demo.gif|frame|center|Color palette layout options]]

[TODO: add autostretch to demo animation?]

=== Status Bar ===

* The layer selection dropdown has been replaced by a layer indicator. Clicking on the indicator opens the new [[#Layers_and_Objects_dialog|Layers and object dialog]]. This change improves Inkscape's performance for documents with many layers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3648 MR #3648]).
* The status bar contents is now configurable, see [[#Bars_.2F_Toolbars|Customization section]].

=== Tool bar ===

* The tool bar width can now be resized and also wraps into multiple columns automatically if the screen height is too small for all icons to fit.
* You can customize which tools will be part of the tool bar in the preferences, see [[#Bars_.2F_Toolbars|Customization section]]

=== Dithering ===

[REVIEW before release with regards to available formats]
[TODO: add nicer/more obvious comparison image]

Inkscape's gradients sometimes suffered from visible steps between colors, a phenomenon also known as '''gradient banding'''. Gradient banding is caused by the difference between how many different colors are available for the selected image file format and how many colors a human eye can discern. The effect becomes especially prominent when exporting a gradient that only spans a small color range to a high-resolution image. There just aren't enough colors available for a smooth transition.

'''Dithering''' softens these steps '''by scattering pixels''' of the different adjacent colors along the gradient, a little bit like a blur.

Dithering is now used both for '''Export of raster images''' as well as for '''displaying gradients on canvas'''([https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812]). This functionality requires a special version of Cairo, our rendering engine. This means that it will '''only be available in the pre-packaged builds''' (for '''macOS''', '''Windows''' and for the '''Linux AppImage''').

For standard Linux package formats (deb, rpm, …), it depends upon your Linux distribution maintainers whether they will patch up the version of Cairo they want to distribute. We hope that this change will one day also be included in the official Cairo packages ([https://gitlab.freedesktop.org/cairo/cairo/-/merge_requests/24 Link to ongoing discussion]).

[[File:Dithering_comparison.png|frame|center|Top: Gradient banding, bottom: dithered, smooth gradient]]

== Canvas ==

[[File:Page shadow.png|thumb|666x666px|Page shadow ]]

=== Page ===

* The page shadow now has a more realistic, blurry, fade-out look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3128 MR #3128]).
* Settings for the page background / decoration were refactored, see [[#Document_Properties|section about Document properties dialog]].
* Inkscape documents can now hold multiple pages! Learn more in the [[#Page_tool|section about the new Page tool]].

=== Snapping ===

==== Snap bar is now Snap popover ====

[[File:Snapping popover .gif|frame|right|New snap settings layout]]

The snap bar has been replaced with a new 'popover'-type dialog, which will unfold when you click on the little arrow symbol in the top right corner, next to the snap symbol.
Snap options now have always-visible descriptions, to make them easier to understand ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3323 MR #3323]).

To activate / deactivate snapping globally, click on the snap symbol in the top right corner or press '''<kbd>%</kbd>'''.

The popover dialog has two different modes:
* Simple: Only 3 options: snap bounding boxes and paths, activate / deactivate the new alignment snapping). This provides a simple preset for many use cases.
* Advanced: Gives the familiar granular control over every snapping option. Switching from 'Advanced' back to 'Simple' is not merely a visual change, but will reset snap settings to defaults.

==== Snapping preferences globalized ====

Snap settings are no longer saved with the document, but are set globally for all documents in the preferences and in the snap popover dialog.
The option for enabling snapping in new documents has been removed, as it no longer makes sense.

The options for snapping perpendicularly and tangentially to paths or guide lines have been moved from the document preferences to the snap popover to make them more discoverable.
The other snap options from the document settings dialog were removed. [TODO: check whether this is still true at the time of release]

==== Alignment and Distribution snapping ====

[[File:Snap-toolbar.png|frame|right|New alignment snapping options]]

During Google Summer of Code 2021, GSOC student Parth Pant worked on adding on-canvas alignment and distribution snapping, with support of the mentors Thomas Holder and Marc Jeanmougin.
As a result, three new modes of on-canvas snapping have been added. These new modes make aligning and distributing objects a very easy drag-and-drop operation ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3294 MR #3294])..

When on-canvas alignment is active, Inkscape will display horizontal or vertical temporary guide lines that indicate when the selected object can be aligned relative to another object on the canvas. It connects the points of the objects that are in alignment.
With distribution snapping, multiple objects close by are taken into account, making it possible to align objects in a grid, with very little effort.

The temporary guide lines only appear while editing / moving objects on the canvas. Once a guide shows up, the movement of the selection is loosely constrained in the direction of the guide.


Alignment and Distribution snapping guide lines display the distance(s) between objects as a little label per default. This can be disabled from <code>Edit → Preferences → Snapping: Show snap distance in case of alignment or distribution snap</code>.

The 'Simple' mode of the snapping popover dialog allows you to simply activate or deactivate Alignment snapping.
The 'Advanced' mode gives you additional control by allowing you to en-/disable:

'''Available additional options:'''
* '''Alignment Snapping''': Tools and objects snap to position of other objects
*'''Self snapping''': Alignment snapping for nodes in the same path while editing nodes or node handles.
* '''Distribution snapping''': Objects snap to same gap size as their neighbours
[[File:Self snapping.gif|frame|center|Snapping nodes in the same path]]
[[File:Aligment and distribution snapping exemple.gif|frame|center|Demo of alignment and distribution snapping]]

=== Guides ===

* The size of the handles is now adjustable in the Preferences via the existing setting <code>Interface → Handle size</code>. Nonetheless, the guide handles react to this setting at half the rate of other handles; at large settings, the effective size of a guide handle is about half the size of an auto-smooth node. At the same time, a minimum size is enforced, equal to the previously hard-coded size. As a result of this mechanism, the handle is only enlarged when the <code>Handle size</code> preference is set to a value of 7 or larger. Since the default value is 3, the size of guide handles does not change on new installs or for users on default settings.
* The handle now has a hitbox and reacts to mouse events in the same way as the guide line itself. This makes it easier to interact with the guide. Taken together, these two changes address [[/inkscape/inkscape/-/issues/3111|#3111 (closed)]].
* The colour of the handle is now the same as the colour of the guide, except when the guide is locked.
* When a guide is locked, its handle turns gray (and changes the shape to an "x", as before).
* The handle is always correctly centered on the guide line. This change also fixes a similar positioning error that affected node handles.

Fixes [[/inkscape/inkscape/-/issues/2022|#2022 (closed)]]; Fixes [[/inkscape/inkscape/-/issues/2604|#2604 (closed)]]; Fixes [[/inkscape/inkscape/-/issues/3111|#3111 (closed)]];

MR #[https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 3870]

== Tools ==

=== Page tool ===

The new Page tool (lowest button in the tool bar) allows you to create multi-page Inkscape documents, and to import as well as export multi-page PDF documents. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3486 MR #3486], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3785 MR #3785], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3821 MR #3821]). It supports overlapping pages and pages of different sizes in a single document.

'''Tool usage:'''
* To '''create a new page''' either:
** click-and-drag on the canvas
** or click on the 'Create a new page' button in the tool controls
* To '''delete a page''', click on the page to select it, then click on the button <code>Delete selected page</code> or use the <code>Del</code> or <code>Backspace</code> keys.
* To '''move a page''' on the canvas, click-and-drag it to the desired new position. If the option to <code>Move overlapping objects</code> is active, this will also move any objects that touch the page along with it.
* To '''change a page's size''':
** click on a page whose size you want to change to select it, then drag the square-shaped handle in its bottom right corner
** click on the page, and then choose one of the predefined sizes in the page size dropdown, or enter your size values for the 'Custom' option, by typing them into the field in the form of <code>10cm x 15cm</code>
* To '''fit a page''' to:
** the size of '''the drawing''': make sure to have no object selected before you switch to the Page tool. Then select a page by clicking on it, then click on the button 'Fit page to drawing or selection' in the tool controls
** '''a selected object''': first select the object(s) with the selection tool, then switch to the Page tool, click on a page to select it, then press the the button 'Fit page to drawing or selection' in the tool controls
* To '''add a label''' to your page, select the page by clicking on it, then enter a name or label for it into the text field in the page tool's tool controls. Labels are always visible, no matter which tool is currently selected.
* To '''export a multi-page PDF''' file, use <code>File → Save a copy … → PDF</code>. This will automatically include all pages.
* To '''open or import a multi-page PDF or (pdf-based) AI''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]

''Note: Multi-page SVG files are an Inkscape-specific concept. Web browsers will only display the first page of your document, which corresponds to the 'viewbox' area of the SVG file.''

[TODO: needs gif!]

=== Selector Tool ===

The tool now allows to '''set the origin of the selection''' for precise numerical positioning:

# '''Click''' on one of the 9 object handles to select your desired origin for the scaling, '''or select and then drag''' the middle handle to the desired position
# A '''small red circle with lines''' now indicates the new origin and the '''x/y position''' in the tool controls will adjust to the new origin.
# Now '''edit the x, y, width or height values''' to move and scale your object using the new origin ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2700 MR #2700])
#Shift click on origin reset original position of origin

<gallery style="border: 1px solid #c8ccd1;padding: 3px;background-color: #f8f9fa;" mode="packed" heights=350px>
File:Change origin of selection.gif|Changing the origin for scaling numerically
File:Change origin to TOP right.gif|Changing the origin to move one corner to a specified coordinate
</gallery>

=== Text Tool ===

* '''Kerning options''' are now symbolized by a '''button''' between the subscript and text direction selectors. Clicking on it will open a so-called pop-over, where all previously available options can be found. This change saves space in the Text tool's toolbar.
* '''Negative kerning''' values can now be as little as <code>-1000</code> (previously -100), making them symmetrical to their positive counterparts ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2569 MR #2569], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3434 MR #3434])
* '''Padding''': Text that is flowed into a shape and standard flowed text now have an '''additional square-shaped handle''' in the top right corner. Move the handle to adjust the text padding inside the frame ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2769 MR #2769]) <span style="color:red;">'''[Currently broken]'''</span>
* '''Exclusion zones''': Text can now '''flow around one or more movable objects''' <span style="color:red;">'''[Currently broken]'''</span>:
*# Select all object(s) (use only shapes and paths on the same object hierarchy level as the text; no groups / clones / images supported) and the text.
*# Set the exclusion zone by going to <code>Text → Set subtraction frames</code>.
*# Now you can move the exclusion objects around or edit their shape, and the text will adjust automatically.
*# If you want to change the exclusion zones again at a later point, repeat the process with all objects that the text should flow around.
Background info:
''SVG 2.0 flowed text allows for <code>shape-padding</code> and <code>shape-subtract</code> attributes. <code>shape-padding</code> lets the text flow into a shape and leave some space between its edges and w where the text will start to flow. <code>shape-subtract</code> subtracts shapes with margin, so text can flow around other objects in the scene. These attributes were supported in Inkscape 1.0, but not exposed to the user. This version of Inkscape includes both an adjustable on-canvas knot for changing the padding as well as a Text menu item for setting text subtraction properties with a further knot to adjust it's margins.''

[See merge request for animated gifs to add here]

=== Gradient Tool ===
We Added New control in to <code>'''Preferences → Gradient Tool'''</code>. <code>Auto delete gradients that are not used</code> This is turned on my default. This setting prevents gradients that are not used on any object to stay in gradient library and this prevents gradients to fill up library. This is not a new behavior we just added ability to turn it off .

== Path Operations ==

* New '''Split path''' operation, available from <code>'''Path → Split path'''</code>:<br />The function separates a path object that consists of multiple subpaths into a set of path objects that 'belong together'. This means that parts of a path that have holes in them are kept as whole objects. The function works by splitting up a path into non-intersecting bits, keeping intersecting bits together.<br />''Example'': A path that consists of a word, like 'Inkscape' will be split into 8 parts, one for each letter. With the familiar 'Break apart' function, there would be 12 parts, because of the holes in the letters that would be split off as their own objects, too ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3738 MR #3738]).[TODO: add animation]


== Dialogs ==

[[File:Inkscape PyFNUY7fCi.gif|thumb|511x511px]]

=== General ===

* A mini-menu (downward pointing arrow symbol) was added into the title bar of every multi-dialog panel (also called 'notebook'). You can use it to close the current tab, to undock it, or to close the whole panel. It also shows a list of available dialogs, sorted by purpose, allowing you to open them with a click (([https://gitlab.com/inkscape/inkscape/-/merge_requests/3728 MR #3728]) [TODO: screenshot ]
* Open dialogs are now less costly for performance, because they do not update when it's not needed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3369 MR #3369]), or when they are hidden ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3761 MR #3761])
* Docking zones now expand and flash slowly when a dialog is dragged close to them. This makes it easier to see where docking is possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3729 MR #3729])
* The text labels of docked dialogs are now more responsive to the width of dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3627 MR #3627])

=== Align and distribute ===

* The formerly separate <code>Arrange</code> dialog is now '''integrated''' with the <code>Align and Distribute</code> dialog. With its '''three tabs''', more '''user-friendly names''' and some '''small visual tweaks''', the dialog now holds everything that is needed for aligning, distributing and arranging objects in your drawing ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3382 MR #3382], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3667 MR #3667]).
* The icons inside this dialog are now smaller.
* Node alignment and distribution is no longer shown on first run Just when you use node editing tool

[[File:Align and distribute dialog with 3 tabs.gif|frame|center|All alignment and distribution options in a single dialog]]
[TODO: needs re record with small icons]

=== Document Properties ===

The 'Snapping' tab was removed in favor of a global snapping preference, see [[#Snapping|Snapping section]].

The first tab of the Document properties dialog was refactored thoroughly to make it easier to use:

* It's now labelled 'Display' instead of 'Page'
* The long list of different document formats is now available from a dropdown
* There is a preview available of the page format and colors [TODO: needs screenshot]
* The page area(s) in a document can now have a different color than the underlying 'desk' area [TODO: mention in highlights?]
* The other options have been rearranged to look tidier
* The option to add margins to a document when resizing it is currently unavailable [TODO: hopefully get that back before the release]

([https://gitlab.com/inkscape/inkscape/-/merge_requests/3700 MR #3700]).

([https://gitlab.com/inkscape/inkscape/-/merge_requests/3400/ MR #3400], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3403 MR #3403])

=== Fill and Stroke dialog ===

==== Color selector ====

[[File:HSLuv_color_picker.png|thumb|200px|HSLuv color picker mode]]
* The more intuitive HSL mode (hue, saturation, lightness) is now the default mode of the color selector.
* All color selection modes (e.g. HSL, HSV, RGB, CMYK, color wheel, CMS) have been moved into drop-down menu, with icons. You can get the old, tabbed look back by disabling the option in <code>Edit → Preferences → Interface: Use compact color selector mode switch</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3443 MR #3443]).
* New: '''HSLuv mode''' added for color picker. This mode lets you more intuitively select optically similar saturation of different hues ([https://en.wikipedia.org/wiki/HSLuv Wikipedia]).

==== Gradient Editor is back ====

A replacement for the [https://wiki.inkscape.org/wiki/index.php?title=Release_notes/1.1#Legacy_Gradient_Editor_dialog_removed|lost gradient editor] was added to the Fill and Stroke dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2688 MR #2688], [https://gitlab.com/inkscape/ux/-/issues/67 Bug ux#67]).

This allows you to add, edit and delete gradient stops directly in the 'Fill and Stroke' dialog again:

* to '''add''' a new stop, '''double click''' on the gradient preview
* to '''move''' a stop, '''click and drag''' it along the gradient preview or enter the stop offset numerically for more precision
* to '''remove''' a stop, click on it to '''select it, then press the <code>Del</code> or <code>Backspace</code> key'''
* The Gradient tool toolbar options `repeat mode`, `reverse gradient direction`, a gradient selection library and a list of all stops have been added here, too, so all the options pertaining to gradients are in easy reach.
*we added a preference to auto delete non used gradients. previously, inkscape deletes the non used gradients automatically. now, we made this optional so that, users can preserve those gradients in SVG file. https://gitlab.com/inkscape/inkscape/-/merge_requests/3897

<div><ul>
<li style="display: inline-block;">[[File:Gradient editor adding stops.gif|frame|Changing gradient stop color, moving it, adding a new stop]]</li>
<li style="display: inline-block;">[[File:Gradient editor - repete.gif|frame|Inverting the gradient's direction and changing its repeat mode]]</li>
<li style="display: inline-block;">[[File:Adding and removing stops in to list.gif|frame|Another way to add, edit and delete single stops is to use the list of gradient stops. Users can add stops by clicking on the <code>+</code> button, and can delete them by clicking on the <code>-</code> button.]]</li>
<li style="display: inline-block;">[[File:Gradients Library.gif|frame|With the new gradient selection dropdown, users can duplicate gradients by clicking on the <code>+</code> button.]]</li>
<li style="display: inline-block;">[[File:First and last node offset.gif|frame|Users can offset (move) the first and last stops of a gradient. The color beyond the last/first gradient stop is uniformly that of the last/first stop.]]</li>
</ul></div>

==== Markers ====

The markers drop down list has been replaced by a little dialog that displays all available markers in a grid, and even allows you to edit the selected marker! This project was undertaken by GSOC student Rachana Podaralla with the mentors Michael Kowalski, Marc Jeanmougin and Martin Owens ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3394 MR #3394], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3420 MR #3420]).

When clicking on the drop down for the start, middle or end markers, you will see the following:
* a list of markers used in the current document at the top
* below that, a list of all available markers, which also contains some fun new markers!
* at the bottom, the 'Edit' section, with:
** a preview of how the marker will look
** some number fields to change the size of the marker (keep the lock on to scale proportionally)
** an option to scale the markers when the stroke width is changed
** options for changing the marker direction
** the option to change the marker's angle and to have that angle fixed
** marker offsetting options
** a button to enable editing of markers (rotate, scale, move) on the canvas

<div><ul>
<li style="display: inline-block;">[[File:Working with new markers.gif|frame|Adding and editing markers with the new dialog]]</li>
<li style="display: inline-block;">[[File:Edit markers on canvas.gif|frame|Editing markers directly on the canvas]]</li>

TODO: record new animation where rotation is also presented
</ul></div>

==== Custom Dash patterns ====

To '''choose your own dash pattern''', select '''Custom''' in the dash pattern drop-down menu. This will make '''a new text field''' show up where you can add your new custom dash pattern '''by typing in numbers'''. Each number corresponds to the length of a dash or a gap. It always starts with a dash, and when it reaches the end, it will continue with the first number again, for the next gap or dash. So if you enter an even number of numbers, e.g. '1 1 4.5 4.5' the pattern will be 'dot - short gap - dash - long gap' and then repeat again, and for an uneven number of numbers, the pattern will be inverted when the first 'set' ends.

On the canvas, you can watch how your object changes when you change the custom dash pattern numbers.

[TODO: needs gif]

==== Other small changes ====

Line cap and line join order buttons have been reordered, so they match vertically ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3402 MR #3402]).

=== Layers and Objects dialog ===

A new dialog was created that merges the functionality of the familiar 'Layers' and 'Objects' dialogs, with better performance ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3635 MR #3635], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3741 MR #3741], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3597 MR #3597], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3645 MR #3645]).

It is available from both the 'Layers' and the 'Objects' menu and offers the following functionality:

* a button to toggle between 'Layers' and 'Objects' view
* a list of all layers and objects in the drawing, featuring new icons for the different object types
* 8 alternating default colors for layers and the objects in them:
** these colors are used for drawing the paths in the respective layers
** the colors can be set (in case they clash with your theme, or you cannot see the paths that you draw) in the file <code>style.css</code> in your Inkscape preferences directory
* layer and object colors can be customized for each layer/object on its own, by clicking on the vertical color bar at the end of each line
* tiny mask and scissor symbols indicate that a clip or mask is applied to an object
* object and layer names (label, not id) can be changed after a double-click on the current name
* icons for locking and hiding a layer/object light up when you hover over the layer's row:
** click to hide/unhide, lock/unlock, Shift+click to hide/lock other items [TODO: check whether 'on same level' would apply, doesn't work currently]
* holding Alt while hovering over an object in the dialog will highlight that object on canvas
* layers as well as objects can be multi-selected
* the context (right-click) menu for layers provides options to move, delete, rename the current layer, to lock/hide all/other/the current layers, to add a new layer and to convert a layer to a group
* the context menu for objects provides the same options as it would when you right-click on the object on canvas

Note:

* the (partially hidden) setting for path colors in the preferences file is no longer respected. Adjust the style.css file as a workaround.
* the dialog no longer offers the options to change opacity, blur or blend mode. Use the Fill and Stroke dialog as a workaround.
* the type-forward search to filter for objects is no longer available. For objects, use the Search and Replace dialog as a workaround, for layers there is currently no replacement.

[TODO: needs a picture]

=== Preferences ===

* The preferences zoom ruler now respects your theme's look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it selects objects only in the current layer or in all layers was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])

=== SVG Font Editor ===

With lots of user feedback, the Font Editor workflow has been updated with better previews, better performance and a higher degree of organization.

These changes result in a new recommended workflow:

# Open the typography template from <code>File > New from Template</code> or use <code>Extensions > Typography > 1 - Setup Typography canvas</code> to load a suitable template into Inkscape.
# Open the SVG Font Editor dialog
# Select a name for your new font, using the + icon in the top right corner of the dialog
# Adjust the horizontal advance and the major font metrics to your liking
# Switch to the <code>Glyphs</code> tab of the dialog
# Click <code>+</code> to add your first letter/glyph/character to the list. You can also click the button repeatedly to automatically create a list of commonly used font characters, from <code>Space</code> to common special characters, numbers and then upper case and lower case letters A to Z, and then even more special characters after that.
# If you like to, switch from list preview to grid preview in the bottom right corner.
# Select one of the lines / blocks in the glyphs list.
# Click on <code>Edit</code>. This will:
#* Create a new layer for the selected glyph (if there isn't one yet) and activate that layer.
#* Hide all other layers
# Now draw your letter/number/… in the new layer
# Make sure it's a single path (e.g. do <code>Path > Union</code>)
# Keep it selected, and click on <code>Get curves</code>.
# Continue selecting glyphs from the list, adding / editing them and turning them into SVG font characters until your font is complete.
# In the last tab, <code>Kerning</code>, you can select two different glyphs from the two dropdown lists, to adjust the default distance between them.
## After you've selected them, click on <code>Add pair</code>.
## Now adjust the distance between them. In addition to the preview that shows just these two glyphs, you can also make use of the sample text to see how it will look in a sentence.
## Continue adjusting letter distances until you're happy with the result.
# Save your file as Inkscape SVG, and open it with another program (e.g. FontForge) to be able to convert that SVG font into a ttf or otf font.

The workflow is based upon the following SVG Font Editor dialog improvements:

* '''speed improvements''': Inkscape can now handle fonts with thousands of glyphs!
* '''automatic glyph generation''': adding a new glyph creates a new entry and populates its unicode string, based upon the previously defined glyph (next in unicode order)
* '''glyph management''': glyph editing action creates glyph-specific layers to keep glyphs organized
* '''grid glyph view''': offers a larger preview than a list

[TODO: needs screenshot]
([https://gitlab.com/inkscape/inkscape/-/merge_requests/3396 MR #3396], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3552 MR #3552], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3628 MR #3628])

=== Swatches ===

The Swatches dialog uses the same improved settings as [[#Color_palette|the color palette]].

=== Text and Font dialog ===

The dialog's width has been reduced, so it won't take up excessive amounts of space when docked ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3314 MR #3314]).

=== Trace Bitmap ===

The '''Trace Bitmap''' dialog received a few updates and some more polish ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3405 MR #3405]):

* The '''preview auto-updates''' more reliably and shows a better preview image.
* The '''preview location''' now adjusts to the dialog's format: if it is wider than tall, it moves to the right side, and if it is taller than wide, the preview appears at the bottom of the dialog.
* The number entry fields are now accompanied by '''draggable sliders'''.

=== Transform dialog ===

We cleaned up this dialog, reduced width and added explanation for metric transformations ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3381 MR #3381])

== Filters ==

== Live path effects ==

[[File:Select satelit.png|frame|right|Select path with LPE that is responsible for the existence of this object]]
If you have an object selected that was created by the Live Path Effect of another object, you can now quickly '''find the responsible LPE object''' by clicking on '''the new button''' at the bottom of the Live Path Effects dialog. This is very useful for all Live Path effects that create dependent objects which can be selected independently, like the new <code>Copies LPE</code>, the <code>Boolean Operations LPE</code>, the <code>Rotate Copies LPE</code> and many more ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479]).

=== Copies LPE ===

[[File:Copie LPE.gif|frame|right|The new Copies LPE]]

Internally, we call this the ''\'Tiled Clones dialog on steroids\''' - interactive tiling, using a huge range of different tiling types, setting the distance between objects numerically, changing scale, location, rotation per row / column, add more rows and columns on the fly. This can be used to quickly copy large numbers of objects non destructively and to create interesting grids and patterns and variations quickly ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3814 MR #3814]).

Features:

* Cloning of objects in rows and columns
* Offset of rows and columns
* 16 different mirroring modes
* Linear scaling (4 modes + mirroring)
* Linear rotation change (4 modes + mirroring)
* Custom gap controls, with units
* Custom styling of clones

== Import / Export ==

=== Export Dialog ===
[TODO:fill in ]

Anshudhar Kumar Singh with mentors Michael Kowalski, Ted Gould, Tavmjong Bah and finished By Martin Owens

We re-named This dialog from <code>Export PNG image</code> to <code>'''Export'''</code> to reflect new abilities of this dialog.

Features:

* Ability to export images in to multiple Raster formats: '''PNG, Jpeg, WebP, Tiff''' but also Vector formates:'''Svg, Inkscape SVG, PDF'''
* The export dialog can export to *'''any'''* raster extension marked as a raster extension in it's INX file. THEN if you check the extra setting in the preferences <code>Edit → Preferences → Input/Output → show all outputs in Export dialog</code> , It will show all extensions, raster and not. So you may export to DXF, LaTex or whatever else you have available.
* Single Image has 4 modes:
# '''Document''' - will export all objects in the documents (basically ignores page)
# '''Page''' - will export what is exactly in a active page (with exact size of page)
# '''Selection''' - will export area of objects that are selected (use checkbox export selection only if you wan just selected objects)
# '''Custom''' - You can manually define are you want to export from top left corner to bottom right corner
* Bach export that allows you to export parts of the document in to separate files formats and sizes
* Bach export will use names of the objects as a names of files
* Bach export has 4 modes:
# '''Selection''' - will export objects (pro tip: group object that belong in to single file)
# '''Layers''' - will export all layers
# '''Pages''' - will export content o pages (new feature )
* You can add multiple formats/ versions by clicking button <code>'''Add export'''</code>. this is useful because you can export many files with single click.
* Changing '''DPI''' control size of images (pixel resolution) (90 is default if you want 2x resolution set it to 180 etc)
* '''Suffix''' adds text at the end of the file name
*You can remove objects from selection you un-checking the object in a preview list
* Checkbox <code>'''export selection only'''</code> if you want export just selected objects (ei: not object under or over objects). This is useful for exporting game assets or parts of the designs for website
* Interactive Preview of export
* Cleaned UP and simplified UI
[TODO: Add images / Videos]

MR [https://gitlab.com/inkscape/inkscape/-/merge_requests/3825 3825]

== Customization / Theming ==

=== General User Interface ===

* The font size in the user interface can be adjusted at <code>Edit → Preferences → Interface → Theming: Font scale</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3690 MR #3690])
* The <code>+</code>/<code>-</code> buttons for number entry fields are now smaller. If you prefer the old, wider buttons, they can be turned on again by disabling <code>'''Preferences → Interface : Use narrow number entry boxes''' </code>. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3358 MR #3358])

=== Bars / Toolbars ===

* You can now hide elements from the status bar (style indicator, layer indicator, mouse coordinates, canvas rotation) at <code>Edit → Preferences → Interface: Status bar</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3445 MR #3445])
* You can now hide tools from the tool bar at <code>Edit → Preferences → Interface → Toolbars: Toolbars</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3515 MR #3515])
[[File:X5pWfteMzW.gif|border]]

=== Cursors ===

* The drop shadow is now optional for mouse cursors. You can turn it off in <code>Edit → Preferences → Interface → Mouse cursors: Show drop shadow</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3352 MR #3352]).

=== Icons ===

* Multiple icons in the Multicolor icons set got small retouches and other improvements to readability or contrast, e.g. the green color is now a little brighter when using a dark theme, to improve contrast.
* Cursors and icons in Multicolor icon theme for the Bézier tool and the Calligraphy tool in the tool bar now use the same imagery [to be confirmed]
* <code>Align and distribute</code> icons are now smaller, some were redesigned to fit in to 16x16 grid.
* The icon sizes for the tool bar and the control / tool controls bar can now be adjusted smoothly on a continuous scale from from 100% to 300% in <code>Edit → Preferences → Interface → Toolbars: Toolbox icon size / Control bar icon size</code>. Changing the size no longer requires a restart.

=== Themes ===

* A contrast slider was added for fine tuning the selected theme's colors at <code>Edit → Preferences → Interface → Theming: Contrast</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/906 MR #906])

<gallery mode=packed heights=550px>
File:Contrast slider.gif|The contrast slider allows to fine-tune the theme's colors
</gallery>

== macOS-specific Changes ==

The minimum operating system version supported is now macOS 10.13. (The prior version, Inkscape 1.1.x, supported macOS 10.11 and newer.)

On macOS, enable all special menu items in the application menu and hide them from other menus ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3767 MR #3767])

== Windows-specific Changes ==

Modifier keys now work with pen input ([https://gitlab.com/freedesktop-sdk/mirrors/gnome/gtk/-/commit/46c12b2c922d5592cedd29624cbf3be6b4411084 Commit #46c12b])

== Extensions ==

=== Features added ===
* Add new '''Document > Process Illustrator SVG...''' extension to assist with importing Adobe Illustrator documents with layers and the correct scale
* Add option to limit output extension to save copy ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3600 MR #3600])
* Added Python app dirs dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568]) [Is this a bug fix?]

=== Bugs ===

== Command line ==

* 'verbs' have been removed. All verbs are available as 'actions' now (see [[#Behind_the_curtains|below]] for more context)([https://gitlab.com/inkscape/inkscape/-/merge_requests/3884 MR #3884], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3874 MR #3874]).
* A new action for scaling by a factor has been added, it replaces the previous one, which is now called 'grow' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880]).

== Behind the curtains ==

* '''Gio::Actions''': The old 'verbs' were converted to 'actions'. This work was done to prepare for migrating to Gtk4. It also makes it possible to reach them all '''from the commands palette''', to assign keyboard shortcuts them and to use them on the command line. A big part of this work was done by Google Summer of Code student SUSHANT A.A. with the mentors Alexander Valavanis, Ted Gould and Tavmjong Bah.

=== Symbols ===
Add support for x, y, width and height SVG2 attributes on <symbol>.
Follows logic of <svg> element, which already supported these attributes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3828 MR #3828])

== Notable bugfixes ==

=== Crash fixes ===

* Check knot still exists before updating ([https://gitlab.com/inkscape/inkscape/-/merge_requests/717 MR #717])
* Masive collection of crash fixes related to number of LPE (copy, stampe, duplicate) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479])
* Action after grouping 3D boxes crash Fix ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3698 MR #3698])
* Fix for crashing of inkscape while Quitting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3681 MR #3681])
* Fix crash due to invalid or malformed direct-action string ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3663 MR #3663])
* Bezier curve tool Backspace crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3715 MR #3715])
* Fix crash scrolling across line height units ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3541 MR #3541])
* Fix adding a path effect to symbol causes crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3520 MR #3520])
* Fix drag-and-drop svgs, stops crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3710 MR #3710])
* Handle two items in spray tool's single path mode ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3470 MR #3470])
* Icon preview crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3439 MR #3439])
* Prevents crashing during 3D box import ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3592 MR #3592])
* Fill between Paths LPE crash on selecting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3801 MR #3801])

=== Other bug fixes ===

* Inkscape no longer slows down when using grids and havign the Document Properties dialog open on macOS
* Calligraphy tool: use correct tool tilt direction ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3782 MR #3782], [https://gitlab.com/inkscape/inkscape/-/issues/1692 Bug #1692])
* duplicated gradeint does not get deleted ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3361 MR #3361])
* Last line in paragraph is not justified anymore ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3780 MR #3780])
* Fix #1034 - Recursively flatten css style when copying ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3656 MR #3656])
* new boolean operation algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3724 MR #3724])
* Respect mouse down before mouse move coordinates (WIN) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3735 MR #3735])
* Remove mandatory break from end of paragraphs, added in Pango 1.49 ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3630 MR #3630])
* Fix: Subsequent font changes to words in the same textbox now apply ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3631 MR #3631])
* Fix numpad input for unimode in text tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3689 MR #3689])
* Restore refresh of units trackers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3665 MR #3665])
* Fix find and replace if text has description, nested tspans ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3551 MR #3551])
* all canvas knots should have same size and be controlled form preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3679 MR #3679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3699 MR #3699])
* Fix multiline vertical text positioning in browsers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3537 MR #3537])
* Stop changing line height when units change ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3544 MR #3544])
* Fix Clone Tiler menu item, action mismatch ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3650 MR #3650])
* fix: Cannot quit Inkscape on macOS Big Sur from welcome screen (MAC) ([https://gitlab.com/inkscape/inkscape/-/issues/2762 MR #2762])
* Fix: Position of flowed text no longer applies extra transforms on text ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3695 MR #3695])
* Fix default value for saturate in color matrix filter ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3626 MR #3626])
* nodes widget no longer appears on startup in align and distribute dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3677 MR #3677])
* fixes #2621. Clicking on fill/stroke in the status bar now reopens the dialog if it is hidden ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3754 MR #3754])
* Fix KP_2,4,6,8 shortcuts for rect tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3773 MR #3773])
* Transform handle modifiers are now displayed on status bar ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3809 MR #3809])
* Perspective/envelope LPE now works on objects with 0 width or height . (edge cases for single line stroke) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2712 MR #2712])

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small portion 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.2 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.2.x commit history].

== Translations ==

The following UI translations received updates:

* …

The Windows installer translation was updated for [2021-03-03]:

* …

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 ==

[TODO: update if merged]
Ishaan Arora with mentors Thomas Holder, Martin Owens

== Important changes for packagers ==

* New dependency on <code>python-cssselect</code> added which is required for usage of Inkscape extensions ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3239 MR #3239])
* As Python <code>distutils</code> are now deprecated, they have been replaced by <code>python3-packaging</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/368 MR extensions#368])
* [NOT MERGED YET] Dithering for gradients (see [[#Dithering|Dithering section]]) is available with a build flag (<code>-DWITH_INTERNAL_CAIRO=ON</code>), which causes Cairo to be patched for dithering during the build process. Please find more information in [https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812].

== Known issues ==

* Gradient editing [as of 2022-01-24]:
** If you convert your gradient to swatch, the gradient editor cannot be used for editing it anymore.
** Canvas stops and gradient editor stops highlighting will stop working in some cases.

== Other releases ==

{{:Release notes}}

Release notes/1.2

2022-02-03T17:37:40Z

Oskay: Add note about Process Illustrator SVG extension

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

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.'''

* Inkscape documents can now hold '''multiple pages''', which are managed by the new '''[[#Page_tool|Page tool]]'''
* '''Editable [[#Markers|markers]] and [[#Custom_Dash_patterns|dash patterns]]'''
* '''[[#Layers_and_Objects_dialog|Layers and objects dialog merged]]'''
*'''[[#Alignment_and_Distribution_snapping|On-canvas alignment snapping]]'''
* '''[[#Selector_Tool|Selectable origin for numerical scaling and moving]]'''
* '''[[#Align_and_distribute|All alignment options in a single dialog]]'''
* '''[[#Gradient_Editor_is_back|Gradient editing in the Fill and Stroke dialog]]'''
* [[Release notes/1.2#Export Dialog|Export dialog can export Multiple files simultaneously]]
* '''[[#Snapping|Snap settings refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

The overall look and options of the Color palette and the Swatches dialog got a massive overhaul ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2881 MR #2881]):

* When switching the color palette, the switcher shows a colorful preview line for each palette
* Between 1 and 5 palette rows that can be displayed all at once, or scrolled through vertically / using the arrow buttons
* Improved and reliably working settings for padding, tile size and tile shape / auto-stretching

[[File:Color pallet demo.gif|frame|center|Color palette layout options]]

[TODO: add autostretch to demo animation?]

=== Status Bar ===

* The layer selection dropdown has been replaced by a layer indicator. Clicking on the indicator opens the new [[#Layers_and_Objects_dialog|Layers and object dialog]]. This change improves Inkscape's performance for documents with many layers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3648 MR #3648]).
* The status bar contents is now configurable, see [[#Bars_.2F_Toolbars|Customization section]].

=== Tool bar ===

* The tool bar width can now be resized and also wraps into multiple columns automatically if the screen height is too small for all icons to fit.
* You can customize which tools will be part of the tool bar in the preferences, see [[#Bars_.2F_Toolbars|Customization section]]

=== Dithering ===

[REVIEW before release with regards to available formats]
[TODO: add nicer/more obvious comparison image]

Inkscape's gradients sometimes suffered from visible steps between colors, a phenomenon also known as '''gradient banding'''. Gradient banding is caused by the difference between how many different colors are available for the selected image file format and how many colors a human eye can discern. The effect becomes especially prominent when exporting a gradient that only spans a small color range to a high-resolution image. There just aren't enough colors available for a smooth transition.

'''Dithering''' softens these steps '''by scattering pixels''' of the different adjacent colors along the gradient, a little bit like a blur.

Dithering is now used both for '''Export of raster images''' as well as for '''displaying gradients on canvas'''([https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812]). This functionality requires a special version of Cairo, our rendering engine. This means that it will '''only be available in the pre-packaged builds''' (for '''macOS''', '''Windows''' and for the '''Linux AppImage''').

For standard Linux package formats (deb, rpm, …), it depends upon your Linux distribution maintainers whether they will patch up the version of Cairo they want to distribute. We hope that this change will one day also be included in the official Cairo packages ([https://gitlab.freedesktop.org/cairo/cairo/-/merge_requests/24 Link to ongoing discussion]).

[[File:Dithering_comparison.png|frame|center|Top: Gradient banding, bottom: dithered, smooth gradient]]

== Canvas ==

[[File:Page shadow.png|thumb|666x666px|Page shadow ]]

=== Page ===

* The page shadow now has a more realistic, blurry, fade-out look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3128 MR #3128]).
* Settings for the page background / decoration were refactored, see [[#Document_Properties|section about Document properties dialog]].
* Inkscape documents can now hold multiple pages! Learn more in the [[#Page_tool|section about the new Page tool]].

=== Snapping ===

==== Snap bar is now Snap popover ====

[[File:Snapping popover .gif|frame|right|New snap settings layout]]

The snap bar has been replaced with a new 'popover'-type dialog, which will unfold when you click on the little arrow symbol in the top right corner, next to the snap symbol.
Snap options now have always-visible descriptions, to make them easier to understand ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3323 MR #3323]).

To activate / deactivate snapping globally, click on the snap symbol in the top right corner or press '''<kbd>%</kbd>'''.

The popover dialog has two different modes:
* Simple: Only 3 options: snap bounding boxes and paths, activate / deactivate the new alignment snapping). This provides a simple preset for many use cases.
* Advanced: Gives the familiar granular control over every snapping option. Switching from 'Advanced' back to 'Simple' is not merely a visual change, but will reset snap settings to defaults.

==== Snapping preferences globalized ====

Snap settings are no longer saved with the document, but are set globally for all documents in the preferences and in the snap popover dialog.
The option for enabling snapping in new documents has been removed, as it no longer makes sense.

The options for snapping perpendicularly and tangentially to paths or guide lines have been moved from the document preferences to the snap popover to make them more discoverable.
The other snap options from the document settings dialog were removed. [TODO: check whether this is still true at the time of release]

==== Alignment and Distribution snapping ====

[[File:Snap-toolbar.png|frame|right|New alignment snapping options]]

During Google Summer of Code 2021, GSOC student Parth Pant worked on adding on-canvas alignment and distribution snapping, with support of the mentors Thomas Holder and Marc Jeanmougin.
As a result, three new modes of on-canvas snapping have been added. These new modes make aligning and distributing objects a very easy drag-and-drop operation ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3294 MR #3294])..

When on-canvas alignment is active, Inkscape will display horizontal or vertical temporary guide lines that indicate when the selected object can be aligned relative to another object on the canvas. It connects the points of the objects that are in alignment.
With distribution snapping, multiple objects close by are taken into account, making it possible to align objects in a grid, with very little effort.

The temporary guide lines only appear while editing / moving objects on the canvas. Once a guide shows up, the movement of the selection is loosely constrained in the direction of the guide.


Alignment and Distribution snapping guide lines display the distance(s) between objects as a little label per default. This can be disabled from <code>Edit → Preferences → Snapping: Show snap distance in case of alignment or distribution snap</code>.

The 'Simple' mode of the snapping popover dialog allows you to simply activate or deactivate Alignment snapping.
The 'Advanced' mode gives you additional control by allowing you to en-/disable:

'''Available additional options:'''
* '''Alignment Snapping''': Tools and objects snap to position of other objects
*'''Self snapping''': Alignment snapping for nodes in the same path while editing nodes or node handles.
* '''Distribution snapping''': Objects snap to same gap size as their neighbours
[[File:Self snapping.gif|frame|center|Snapping nodes in the same path]]
[[File:Aligment and distribution snapping exemple.gif|frame|center|Demo of alignment and distribution snapping]]

=== Guides ===

* The size of the handles is now adjustable in the Preferences via the existing setting <code>Interface → Handle size</code>. Nonetheless, the guide handles react to this setting at half the rate of other handles; at large settings, the effective size of a guide handle is about half the size of an auto-smooth node. At the same time, a minimum size is enforced, equal to the previously hard-coded size. As a result of this mechanism, the handle is only enlarged when the <code>Handle size</code> preference is set to a value of 7 or larger. Since the default value is 3, the size of guide handles does not change on new installs or for users on default settings.
* The handle now has a hitbox and reacts to mouse events in the same way as the guide line itself. This makes it easier to interact with the guide. Taken together, these two changes address [[/inkscape/inkscape/-/issues/3111|#3111 (closed)]].
* The colour of the handle is now the same as the colour of the guide, except when the guide is locked.
* When a guide is locked, its handle turns gray (and changes the shape to an "x", as before).
* The handle is always correctly centered on the guide line. This change also fixes a similar positioning error that affected node handles.

Fixes [[/inkscape/inkscape/-/issues/2022|#2022 (closed)]]; Fixes [[/inkscape/inkscape/-/issues/2604|#2604 (closed)]]; Fixes [[/inkscape/inkscape/-/issues/3111|#3111 (closed)]];

MR #[https://gitlab.com/inkscape/inkscape/-/merge_requests/3870 3870]

== Tools ==

=== Page tool ===

The new Page tool (lowest button in the tool bar) allows you to create multi-page Inkscape documents, and to import as well as export multi-page PDF documents. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3486 MR #3486], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3785 MR #3785], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3821 MR #3821]). It supports overlapping pages and pages of different sizes in a single document.

'''Tool usage:'''
* To '''create a new page''' either:
** click-and-drag on the canvas
** or click on the 'Create a new page' button in the tool controls
* To '''delete a page''', click on the page to select it, then click on the button <code>Delete selected page</code> or use the <code>Del</code> or <code>Backspace</code> keys.
* To '''move a page''' on the canvas, click-and-drag it to the desired new position. If the option to <code>Move overlapping objects</code> is active, this will also move any objects that touch the page along with it.
* To '''change a page's size''':
** click on a page whose size you want to change to select it, then drag the square-shaped handle in its bottom right corner
** click on the page, and then choose one of the predefined sizes in the page size dropdown, or enter your size values for the 'Custom' option, by typing them into the field in the form of <code>10cm x 15cm</code>
* To '''fit a page''' to:
** the size of '''the drawing''': make sure to have no object selected before you switch to the Page tool. Then select a page by clicking on it, then click on the button 'Fit page to drawing or selection' in the tool controls
** '''a selected object''': first select the object(s) with the selection tool, then switch to the Page tool, click on a page to select it, then press the the button 'Fit page to drawing or selection' in the tool controls
* To '''add a label''' to your page, select the page by clicking on it, then enter a name or label for it into the text field in the page tool's tool controls. Labels are always visible, no matter which tool is currently selected.
* To '''export a multi-page PDF''' file, use <code>File → Save a copy … → PDF</code>. This will automatically include all pages.
* To '''open or import a multi-page PDF or (pdf-based) AI''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]

''Note: Multi-page SVG files are an Inkscape-specific concept. Web browsers will only display the first page of your document, which corresponds to the 'viewbox' area of the SVG file.''

[TODO: needs gif!]

=== Selector Tool ===

The tool now allows to '''set the origin of the selection''' for precise numerical positioning:

# '''Click''' on one of the 9 object handles to select your desired origin for the scaling, '''or select and then drag''' the middle handle to the desired position
# A '''small red circle with lines''' now indicates the new origin and the '''x/y position''' in the tool controls will adjust to the new origin.
# Now '''edit the x, y, width or height values''' to move and scale your object using the new origin ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2700 MR #2700])
#Shift click on origin reset original position of origin

<gallery style="border: 1px solid #c8ccd1;padding: 3px;background-color: #f8f9fa;" mode="packed" heights=350px>
File:Change origin of selection.gif|Changing the origin for scaling numerically
File:Change origin to TOP right.gif|Changing the origin to move one corner to a specified coordinate
</gallery>

=== Text Tool ===

* '''Kerning options''' are now symbolized by a '''button''' between the subscript and text direction selectors. Clicking on it will open a so-called pop-over, where all previously available options can be found. This change saves space in the Text tool's toolbar.
* '''Negative kerning''' values can now be as little as <code>-1000</code> (previously -100), making them symmetrical to their positive counterparts ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2569 MR #2569], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3434 MR #3434])
* '''Padding''': Text that is flowed into a shape and standard flowed text now have an '''additional square-shaped handle''' in the top right corner. Move the handle to adjust the text padding inside the frame ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2769 MR #2769]) <span style="color:red;">'''[Currently broken]'''</span>
* '''Exclusion zones''': Text can now '''flow around one or more movable objects''' <span style="color:red;">'''[Currently broken]'''</span>:
*# Select all object(s) (use only shapes and paths on the same object hierarchy level as the text; no groups / clones / images supported) and the text.
*# Set the exclusion zone by going to <code>Text → Set subtraction frames</code>.
*# Now you can move the exclusion objects around or edit their shape, and the text will adjust automatically.
*# If you want to change the exclusion zones again at a later point, repeat the process with all objects that the text should flow around.
Background info:
''SVG 2.0 flowed text allows for <code>shape-padding</code> and <code>shape-subtract</code> attributes. <code>shape-padding</code> lets the text flow into a shape and leave some space between its edges and w where the text will start to flow. <code>shape-subtract</code> subtracts shapes with margin, so text can flow around other objects in the scene. These attributes were supported in Inkscape 1.0, but not exposed to the user. This version of Inkscape includes both an adjustable on-canvas knot for changing the padding as well as a Text menu item for setting text subtraction properties with a further knot to adjust it's margins.''

[See merge request for animated gifs to add here]

=== Gradient Tool ===
We Added New control in to <code>'''Preferences → Gradient Tool'''</code>. <code>Auto delete gradients that are not used</code> This is turned on my default. This setting prevents gradients that are not used on any object to stay in gradient library and this prevents gradients to fill up library. This is not a new behavior we just added ability to turn it off .

== Path Operations ==

* New '''Split path''' operation, available from <code>'''Path → Split path'''</code>:<br />The function separates a path object that consists of multiple subpaths into a set of path objects that 'belong together'. This means that parts of a path that have holes in them are kept as whole objects. The function works by splitting up a path into non-intersecting bits, keeping intersecting bits together.<br />''Example'': A path that consists of a word, like 'Inkscape' will be split into 8 parts, one for each letter. With the familiar 'Break apart' function, there would be 12 parts, because of the holes in the letters that would be split off as their own objects, too ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3738 MR #3738]).[TODO: add animation]


== Dialogs ==

[[File:Inkscape PyFNUY7fCi.gif|thumb|511x511px]]

=== General ===

* A mini-menu (downward pointing arrow symbol) was added into the title bar of every multi-dialog panel (also called 'notebook'). You can use it to close the current tab, to undock it, or to close the whole panel. It also shows a list of available dialogs, sorted by purpose, allowing you to open them with a click (([https://gitlab.com/inkscape/inkscape/-/merge_requests/3728 MR #3728]) [TODO: screenshot ]
* Open dialogs are now less costly for performance, because they do not update when it's not needed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3369 MR #3369]), or when they are hidden ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3761 MR #3761])
* Docking zones now expand and flash slowly when a dialog is dragged close to them. This makes it easier to see where docking is possible ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3729 MR #3729])
* The text labels of docked dialogs are now more responsive to the width of dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3627 MR #3627])

=== Align and distribute ===

* The formerly separate <code>Arrange</code> dialog is now '''integrated''' with the <code>Align and Distribute</code> dialog. With its '''three tabs''', more '''user-friendly names''' and some '''small visual tweaks''', the dialog now holds everything that is needed for aligning, distributing and arranging objects in your drawing ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3382 MR #3382], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3667 MR #3667]).
* The icons inside this dialog are now smaller.
* Node alignment and distribution is no longer shown on first run Just when you use node editing tool

[[File:Align and distribute dialog with 3 tabs.gif|frame|center|All alignment and distribution options in a single dialog]]
[TODO: needs re record with small icons]

=== Document Properties ===

The 'Snapping' tab was removed in favor of a global snapping preference, see [[#Snapping|Snapping section]].

The first tab of the Document properties dialog was refactored thoroughly to make it easier to use:

* It's now labelled 'Display' instead of 'Page'
* The long list of different document formats is now available from a dropdown
* There is a preview available of the page format and colors [TODO: needs screenshot]
* The page area(s) in a document can now have a different color than the underlying 'desk' area [TODO: mention in highlights?]
* The other options have been rearranged to look tidier
* The option to add margins to a document when resizing it is currently unavailable [TODO: hopefully get that back before the release]

([https://gitlab.com/inkscape/inkscape/-/merge_requests/3700 MR #3700]).

([https://gitlab.com/inkscape/inkscape/-/merge_requests/3400/ MR #3400], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3403 MR #3403])

=== Fill and Stroke dialog ===

==== Color selector ====

[[File:HSLuv_color_picker.png|thumb|200px|HSLuv color picker mode]]
* The more intuitive HSL mode (hue, saturation, lightness) is now the default mode of the color selector.
* All color selection modes (e.g. HSL, HSV, RGB, CMYK, color wheel, CMS) have been moved into drop-down menu, with icons. You can get the old, tabbed look back by disabling the option in <code>Edit → Preferences → Interface: Use compact color selector mode switch</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3443 MR #3443]).
* New: '''HSLuv mode''' added for color picker. This mode lets you more intuitively select optically similar saturation of different hues ([https://en.wikipedia.org/wiki/HSLuv Wikipedia]).

==== Gradient Editor is back ====

A replacement for the [https://wiki.inkscape.org/wiki/index.php?title=Release_notes/1.1#Legacy_Gradient_Editor_dialog_removed|lost gradient editor] was added to the Fill and Stroke dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2688 MR #2688], [https://gitlab.com/inkscape/ux/-/issues/67 Bug ux#67]).

This allows you to add, edit and delete gradient stops directly in the 'Fill and Stroke' dialog again:

* to '''add''' a new stop, '''double click''' on the gradient preview
* to '''move''' a stop, '''click and drag''' it along the gradient preview or enter the stop offset numerically for more precision
* to '''remove''' a stop, click on it to '''select it, then press the <code>Del</code> or <code>Backspace</code> key'''
* The Gradient tool toolbar options `repeat mode`, `reverse gradient direction`, a gradient selection library and a list of all stops have been added here, too, so all the options pertaining to gradients are in easy reach.
*we added a preference to auto delete non used gradients. previously, inkscape deletes the non used gradients automatically. now, we made this optional so that, users can preserve those gradients in SVG file. https://gitlab.com/inkscape/inkscape/-/merge_requests/3897

<div><ul>
<li style="display: inline-block;">[[File:Gradient editor adding stops.gif|frame|Changing gradient stop color, moving it, adding a new stop]]</li>
<li style="display: inline-block;">[[File:Gradient editor - repete.gif|frame|Inverting the gradient's direction and changing its repeat mode]]</li>
<li style="display: inline-block;">[[File:Adding and removing stops in to list.gif|frame|Another way to add, edit and delete single stops is to use the list of gradient stops. Users can add stops by clicking on the <code>+</code> button, and can delete them by clicking on the <code>-</code> button.]]</li>
<li style="display: inline-block;">[[File:Gradients Library.gif|frame|With the new gradient selection dropdown, users can duplicate gradients by clicking on the <code>+</code> button.]]</li>
<li style="display: inline-block;">[[File:First and last node offset.gif|frame|Users can offset (move) the first and last stops of a gradient. The color beyond the last/first gradient stop is uniformly that of the last/first stop.]]</li>
</ul></div>

==== Markers ====

The markers drop down list has been replaced by a little dialog that displays all available markers in a grid, and even allows you to edit the selected marker! This project was undertaken by GSOC student Rachana Podaralla with the mentors Michael Kowalski, Marc Jeanmougin and Martin Owens ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3394 MR #3394], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3420 MR #3420]).

When clicking on the drop down for the start, middle or end markers, you will see the following:
* a list of markers used in the current document at the top
* below that, a list of all available markers, which also contains some fun new markers!
* at the bottom, the 'Edit' section, with:
** a preview of how the marker will look
** some number fields to change the size of the marker (keep the lock on to scale proportionally)
** an option to scale the markers when the stroke width is changed
** options for changing the marker direction
** the option to change the marker's angle and to have that angle fixed
** marker offsetting options
** a button to enable editing of markers (rotate, scale, move) on the canvas

<div><ul>
<li style="display: inline-block;">[[File:Working with new markers.gif|frame|Adding and editing markers with the new dialog]]</li>
<li style="display: inline-block;">[[File:Edit markers on canvas.gif|frame|Editing markers directly on the canvas]]</li>

TODO: record new animation where rotation is also presented
</ul></div>

==== Custom Dash patterns ====

To '''choose your own dash pattern''', select '''Custom''' in the dash pattern drop-down menu. This will make '''a new text field''' show up where you can add your new custom dash pattern '''by typing in numbers'''. Each number corresponds to the length of a dash or a gap. It always starts with a dash, and when it reaches the end, it will continue with the first number again, for the next gap or dash. So if you enter an even number of numbers, e.g. '1 1 4.5 4.5' the pattern will be 'dot - short gap - dash - long gap' and then repeat again, and for an uneven number of numbers, the pattern will be inverted when the first 'set' ends.

On the canvas, you can watch how your object changes when you change the custom dash pattern numbers.

[TODO: needs gif]

==== Other small changes ====

Line cap and line join order buttons have been reordered, so they match vertically ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3402 MR #3402]).

=== Layers and Objects dialog ===

A new dialog was created that merges the functionality of the familiar 'Layers' and 'Objects' dialogs, with better performance ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3635 MR #3635], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2466 MR #2466], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3741 MR #3741], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3597 MR #3597], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3645 MR #3645]).

It is available from both the 'Layers' and the 'Objects' menu and offers the following functionality:

* a button to toggle between 'Layers' and 'Objects' view
* a list of all layers and objects in the drawing, featuring new icons for the different object types
* 8 alternating default colors for layers and the objects in them:
** these colors are used for drawing the paths in the respective layers
** the colors can be set (in case they clash with your theme, or you cannot see the paths that you draw) in the file <code>style.css</code> in your Inkscape preferences directory
* layer and object colors can be customized for each layer/object on its own, by clicking on the vertical color bar at the end of each line
* tiny mask and scissor symbols indicate that a clip or mask is applied to an object
* object and layer names (label, not id) can be changed after a double-click on the current name
* icons for locking and hiding a layer/object light up when you hover over the layer's row:
** click to hide/unhide, lock/unlock, Shift+click to hide/lock other items [TODO: check whether 'on same level' would apply, doesn't work currently]
* holding Alt while hovering over an object in the dialog will highlight that object on canvas
* layers as well as objects can be multi-selected
* the context (right-click) menu for layers provides options to move, delete, rename the current layer, to lock/hide all/other/the current layers, to add a new layer and to convert a layer to a group
* the context menu for objects provides the same options as it would when you right-click on the object on canvas

Note:

* the (partially hidden) setting for path colors in the preferences file is no longer respected. Adjust the style.css file as a workaround.
* the dialog no longer offers the options to change opacity, blur or blend mode. Use the Fill and Stroke dialog as a workaround.
* the type-forward search to filter for objects is no longer available. For objects, use the Search and Replace dialog as a workaround, for layers there is currently no replacement.

[TODO: needs a picture]

=== Preferences ===

* The preferences zoom ruler now respects your theme's look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it selects objects only in the current layer or in all layers was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])

=== SVG Font Editor ===

With lots of user feedback, the Font Editor workflow has been updated with better previews, better performance and a higher degree of organization.

These changes result in a new recommended workflow:

# Open the typography template from <code>File > New from Template</code> or use <code>Extensions > Typography > 1 - Setup Typography canvas</code> to load a suitable template into Inkscape.
# Open the SVG Font Editor dialog
# Select a name for your new font, using the + icon in the top right corner of the dialog
# Adjust the horizontal advance and the major font metrics to your liking
# Switch to the <code>Glyphs</code> tab of the dialog
# Click <code>+</code> to add your first letter/glyph/character to the list. You can also click the button repeatedly to automatically create a list of commonly used font characters, from <code>Space</code> to common special characters, numbers and then upper case and lower case letters A to Z, and then even more special characters after that.
# If you like to, switch from list preview to grid preview in the bottom right corner.
# Select one of the lines / blocks in the glyphs list.
# Click on <code>Edit</code>. This will:
#* Create a new layer for the selected glyph (if there isn't one yet) and activate that layer.
#* Hide all other layers
# Now draw your letter/number/… in the new layer
# Make sure it's a single path (e.g. do <code>Path > Union</code>)
# Keep it selected, and click on <code>Get curves</code>.
# Continue selecting glyphs from the list, adding / editing them and turning them into SVG font characters until your font is complete.
# In the last tab, <code>Kerning</code>, you can select two different glyphs from the two dropdown lists, to adjust the default distance between them.
## After you've selected them, click on <code>Add pair</code>.
## Now adjust the distance between them. In addition to the preview that shows just these two glyphs, you can also make use of the sample text to see how it will look in a sentence.
## Continue adjusting letter distances until you're happy with the result.
# Save your file as Inkscape SVG, and open it with another program (e.g. FontForge) to be able to convert that SVG font into a ttf or otf font.

The workflow is based upon the following SVG Font Editor dialog improvements:

* '''speed improvements''': Inkscape can now handle fonts with thousands of glyphs!
* '''automatic glyph generation''': adding a new glyph creates a new entry and populates its unicode string, based upon the previously defined glyph (next in unicode order)
* '''glyph management''': glyph editing action creates glyph-specific layers to keep glyphs organized
* '''grid glyph view''': offers a larger preview than a list

[TODO: needs screenshot]
([https://gitlab.com/inkscape/inkscape/-/merge_requests/3396 MR #3396], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3552 MR #3552], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3628 MR #3628])

=== Swatches ===

The Swatches dialog uses the same improved settings as [[#Color_palette|the color palette]].

=== Text and Font dialog ===

The dialog's width has been reduced, so it won't take up excessive amounts of space when docked ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3314 MR #3314]).

=== Trace Bitmap ===

The '''Trace Bitmap''' dialog received a few updates and some more polish ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3405 MR #3405]):

* The '''preview auto-updates''' more reliably and shows a better preview image.
* The '''preview location''' now adjusts to the dialog's format: if it is wider than tall, it moves to the right side, and if it is taller than wide, the preview appears at the bottom of the dialog.
* The number entry fields are now accompanied by '''draggable sliders'''.

=== Transform dialog ===

We cleaned up this dialog, reduced width and added explanation for metric transformations ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3381 MR #3381])

== Filters ==

== Live path effects ==

[[File:Select satelit.png|frame|right|Select path with LPE that is responsible for the existence of this object]]
If you have an object selected that was created by the Live Path Effect of another object, you can now quickly '''find the responsible LPE object''' by clicking on '''the new button''' at the bottom of the Live Path Effects dialog. This is very useful for all Live Path effects that create dependent objects which can be selected independently, like the new <code>Copies LPE</code>, the <code>Boolean Operations LPE</code>, the <code>Rotate Copies LPE</code> and many more ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479]).

=== Copies LPE ===

[[File:Copie LPE.gif|frame|right|The new Copies LPE]]

Internally, we call this the ''\'Tiled Clones dialog on steroids\''' - interactive tiling, using a huge range of different tiling types, setting the distance between objects numerically, changing scale, location, rotation per row / column, add more rows and columns on the fly. This can be used to quickly copy large numbers of objects non destructively and to create interesting grids and patterns and variations quickly ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3814 MR #3814]).

Features:

* Cloning of objects in rows and columns
* Offset of rows and columns
* 16 different mirroring modes
* Linear scaling (4 modes + mirroring)
* Linear rotation change (4 modes + mirroring)
* Custom gap controls, with units
* Custom styling of clones

== Import / Export ==

=== Export Dialog ===
[TODO:fill in ]

Anshudhar Kumar Singh with mentors Michael Kowalski, Ted Gould, Tavmjong Bah and finished By Martin Owens

We re-named This dialog from <code>Export PNG image</code> to <code>'''Export'''</code> to reflect new abilities of this dialog.

Features:

* Ability to export images in to multiple Raster formats: '''PNG, Jpeg, WebP, Tiff''' but also Vector formates:'''Svg, Inkscape SVG, PDF'''
* The export dialog can export to *'''any'''* raster extension marked as a raster extension in it's INX file. THEN if you check the extra setting in the preferences <code>Edit → Preferences → Input/Output → show all outputs in Export dialog</code> , It will show all extensions, raster and not. So you may export to DXF, LaTex or whatever else you have available.
* Single Image has 4 modes:
# '''Document''' - will export all objects in the documents (basically ignores page)
# '''Page''' - will export what is exactly in a active page (with exact size of page)
# '''Selection''' - will export area of objects that are selected (use checkbox export selection only if you wan just selected objects)
# '''Custom''' - You can manually define are you want to export from top left corner to bottom right corner
* Bach export that allows you to export parts of the document in to separate files formats and sizes
* Bach export will use names of the objects as a names of files
* Bach export has 4 modes:
# '''Selection''' - will export objects (pro tip: group object that belong in to single file)
# '''Layers''' - will export all layers
# '''Pages''' - will export content o pages (new feature )
* You can add multiple formats/ versions by clicking button <code>'''Add export'''</code>. this is useful because you can export many files with single click.
* Changing '''DPI''' control size of images (pixel resolution) (90 is default if you want 2x resolution set it to 180 etc)
* '''Suffix''' adds text at the end of the file name
*You can remove objects from selection you un-checking the object in a preview list
* Checkbox <code>'''export selection only'''</code> if you want export just selected objects (ei: not object under or over objects). This is useful for exporting game assets or parts of the designs for website
* Interactive Preview of export
* Cleaned UP and simplified UI
[TODO: Add images / Videos]

MR [https://gitlab.com/inkscape/inkscape/-/merge_requests/3825 3825]

== Customization / Theming ==

=== General User Interface ===

* The font size in the user interface can be adjusted at <code>Edit → Preferences → Interface → Theming: Font scale</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3690 MR #3690])
* The <code>+</code>/<code>-</code> buttons for number entry fields are now smaller. If you prefer the old, wider buttons, they can be turned on again by disabling <code>'''Preferences → Interface : Use narrow number entry boxes''' </code>. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3358 MR #3358])

=== Bars / Toolbars ===

* You can now hide elements from the status bar (style indicator, layer indicator, mouse coordinates, canvas rotation) at <code>Edit → Preferences → Interface: Status bar</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3445 MR #3445])
* You can now hide tools from the tool bar at <code>Edit → Preferences → Interface → Toolbars: Toolbars</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3515 MR #3515])
[[File:X5pWfteMzW.gif|border]]

=== Cursors ===

* The drop shadow is now optional for mouse cursors. You can turn it off in <code>Edit → Preferences → Interface → Mouse cursors: Show drop shadow</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3352 MR #3352]).

=== Icons ===

* Multiple icons in the Multicolor icons set got small retouches and other improvements to readability or contrast, e.g. the green color is now a little brighter when using a dark theme, to improve contrast.
* Cursors and icons in Multicolor icon theme for the Bézier tool and the Calligraphy tool in the tool bar now use the same imagery [to be confirmed]
* <code>Align and distribute</code> icons are now smaller, some were redesigned to fit in to 16x16 grid.
* The icon sizes for the tool bar and the control / tool controls bar can now be adjusted smoothly on a continuous scale from from 100% to 300% in <code>Edit → Preferences → Interface → Toolbars: Toolbox icon size / Control bar icon size</code>. Changing the size no longer requires a restart.

=== Themes ===

* A contrast slider was added for fine tuning the selected theme's colors at <code>Edit → Preferences → Interface → Theming: Contrast</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/906 MR #906])

<gallery mode=packed heights=550px>
File:Contrast slider.gif|The contrast slider allows to fine-tune the theme's colors
</gallery>

== macOS-specific Changes ==

On macOS, enable all special menu items in the application menu and hide them from other menus ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3767 MR #3767])

== Windows-specific Changes ==

Modifier keys now work with pen input ([https://gitlab.com/freedesktop-sdk/mirrors/gnome/gtk/-/commit/46c12b2c922d5592cedd29624cbf3be6b4411084 Commit #46c12b])

== Extensions ==

=== Features added ===
* Add new '''Document > Process Illustrator SVG...''' extension to assist with importing Adobe Illustrator documents with layers and the correct scale
* Add option to limit output extension to save copy ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3600 MR #3600])
* Added Python app dirs dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568]) [Is this a bug fix?]

=== Bugs ===

== Command line ==

* 'verbs' have been removed. All verbs are available as 'actions' now (see [[#Behind_the_curtains|below]] for more context)([https://gitlab.com/inkscape/inkscape/-/merge_requests/3884 MR #3884], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3874 MR #3874]).
* A new action for scaling by a factor has been added, it replaces the previous one, which is now called 'grow' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3880 MR #3880]).

== Behind the curtains ==

* '''Gio::Actions''': The old 'verbs' were converted to 'actions'. This work was done to prepare for migrating to Gtk4. It also makes it possible to reach them all '''from the commands palette''', to assign keyboard shortcuts them and to use them on the command line. A big part of this work was done by Google Summer of Code student SUSHANT A.A. with the mentors Alexander Valavanis, Ted Gould and Tavmjong Bah.

=== Symbols ===
Add support for x, y, width and height SVG2 attributes on <symbol>.
Follows logic of <svg> element, which already supported these attributes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3828 MR #3828])

== Notable bugfixes ==

=== Crash fixes ===

* Check knot still exists before updating ([https://gitlab.com/inkscape/inkscape/-/merge_requests/717 MR #717])
* Masive collection of crash fixes related to number of LPE (copy, stampe, duplicate) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3479 MR #3479])
* Action after grouping 3D boxes crash Fix ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3698 MR #3698])
* Fix for crashing of inkscape while Quitting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3681 MR #3681])
* Fix crash due to invalid or malformed direct-action string ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3663 MR #3663])
* Bezier curve tool Backspace crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3715 MR #3715])
* Fix crash scrolling across line height units ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3541 MR #3541])
* Fix adding a path effect to symbol causes crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3520 MR #3520])
* Fix drag-and-drop svgs, stops crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3710 MR #3710])
* Handle two items in spray tool's single path mode ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3470 MR #3470])
* Icon preview crash ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3439 MR #3439])
* Prevents crashing during 3D box import ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3592 MR #3592])
* Fill between Paths LPE crash on selecting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3801 MR #3801])

=== Other bug fixes ===

* Inkscape no longer slows down when using grids and havign the Document Properties dialog open on macOS
* Calligraphy tool: use correct tool tilt direction ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3782 MR #3782], [https://gitlab.com/inkscape/inkscape/-/issues/1692 Bug #1692])
* duplicated gradeint does not get deleted ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3361 MR #3361])
* Last line in paragraph is not justified anymore ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3780 MR #3780])
* Fix #1034 - Recursively flatten css style when copying ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3656 MR #3656])
* new boolean operation algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3724 MR #3724])
* Respect mouse down before mouse move coordinates (WIN) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3735 MR #3735])
* Remove mandatory break from end of paragraphs, added in Pango 1.49 ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3630 MR #3630])
* Fix: Subsequent font changes to words in the same textbox now apply ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3631 MR #3631])
* Fix numpad input for unimode in text tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3689 MR #3689])
* Restore refresh of units trackers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3665 MR #3665])
* Fix find and replace if text has description, nested tspans ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3551 MR #3551])
* all canvas knots should have same size and be controlled form preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3679 MR #3679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3699 MR #3699])
* Fix multiline vertical text positioning in browsers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3537 MR #3537])
* Stop changing line height when units change ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3544 MR #3544])
* Fix Clone Tiler menu item, action mismatch ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3650 MR #3650])
* fix: Cannot quit Inkscape on macOS Big Sur from welcome screen (MAC) ([https://gitlab.com/inkscape/inkscape/-/issues/2762 MR #2762])
* Fix: Position of flowed text no longer applies extra transforms on text ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3695 MR #3695])
* Fix default value for saturate in color matrix filter ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3626 MR #3626])
* nodes widget no longer appears on startup in align and distribute dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3677 MR #3677])
* fixes #2621. Clicking on fill/stroke in the status bar now reopens the dialog if it is hidden ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3754 MR #3754])
* Fix KP_2,4,6,8 shortcuts for rect tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3773 MR #3773])
* Transform handle modifiers are now displayed on status bar ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3809 MR #3809])
* Perspective/envelope LPE now works on objects with 0 width or height . (edge cases for single line stroke) ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2712 MR #2712])

=== Even more bug fixes ===

There were even more issues fixed than those listed above, but these probably only affect a small portion 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.2 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.2.x commit history].

== Translations ==

The following UI translations received updates:

* …

The Windows installer translation was updated for [2021-03-03]:

* …

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 ==

[TODO: update if merged]
Ishaan Arora with mentors Thomas Holder, Martin Owens

== Important changes for packagers ==

* New dependency on <code>python-cssselect</code> added which is required for usage of Inkscape extensions ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3239 MR #3239])
* As Python <code>distutils</code> are now deprecated, they have been replaced by <code>python3-packaging</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/368 MR extensions#368])
* [NOT MERGED YET] Dithering for gradients (see [[#Dithering|Dithering section]]) is available with a build flag (<code>-DWITH_INTERNAL_CAIRO=ON</code>), which causes Cairo to be patched for dithering during the build process. Please find more information in [https://gitlab.com/inkscape/inkscape/-/merge_requests/3812 MR #3812].

== Known issues ==

* Gradient editing [as of 2022-01-24]:
** If you convert your gradient to swatch, the gradient editor cannot be used for editing it anymore.
** Canvas stops and gradient editor stops highlighting will stop working in some cases.

== Other releases ==

{{:Release notes}}

INX extension descriptor format

2021-11-18T21:31:30Z

Oskay: fix link

== 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. The INX file is an XML file with Inkscape-specific content that can be edited in a plain-text editor.

The INX file allows the author to:
* Specify what type of extension it is, for example input, output, or effect
* Identify [[Extension_Interpreters|which interpreter]] should be used to run the extension
* List dependencies; files or other extensions required for operation
* Define parameters that can be set in the extension
* Create [[Extensions:_INX_widgets_and_parameters|a GUI with control widgets]] for those parameters
* Add a submenu to the Extensions menu for the extension to reside in
* Label strings for translation
* Chain extensions
* Etc

Nothing beats a working example, and Inkscape includes a great number of extensions with INX files that you can read. To find the location of your Inkscape extensions directory, where included extensions and their INX files are located, look in the System pane of Inkscape Preferences, under "Inkscape extensions".

== Translation of extensions ==

Extension dialog windows, described in INX files, can be prepared for translation or localisation by adding an <code>_</code> (underscore) to the XML tags or attributes. Only add underscores when text needs to be translated (not numeric values, for example!).

Example:
<pre>
<_name>Some translatable extension name</_name>
</pre>

Or:
<pre>
<param name="..." type="..." _gui-text="Some translatable label text">
</pre>

When extensions are included in the [https://gitlab.com/inkscape/extensions Inkscape Extensions Repository], various scripts will scan each INX file for translatable text and prepare [https://gitlab.com/inkscape/inkscape/-/tree/master/po translation files] for others to translate.

See also: [http://gould.cx/ted/blog/Translating_Custom_XML Ted's blog].

== Attributes description ==

{| class="wikitable"
|-
! Attribute name
! Allowed values
! Comment
|-
| <code>implements-custom-gui</code> (''new in 1.0'')
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> ''(default)''
| If set to <code>true</code> '''requires''' an effect extension to implement custom GUI.<br>''Implementation detail: The "extension is working" window is not shown for this kind of extensions. This means user interaction with the Inkscape interface is blocked until the extension returns, with no way for the user to abort the running extension! It is therefore '''absolutely essential''' that your extension provides the necessary visual feedback for the user and has proper error handling, to rule out any dead-locking behavior.''
|-
| <code>needs-document</code>
| <code>"true"</code> ''(default)'' <nowiki>|</nowiki> <code>"false"</code>
| If set to <code>false</code> an effect extension will not be passed a document nor will a document be read back ("no-op" effect). This is currently a hack to make extension manager work and will likely be removed/replaced in future, so use at your '''own risk'''!
|-
| <code>needs-live-preview</code>
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> (default)
| If set to <code>true</code> in an effect extension, it will offer a "Live preview" checkbox in its GUI. When the user checks that box, it will run the extension in a "preview mode", visually showing the effect of the extension, but not making any changes to the SVG document, unless the user clicks the Apply button. While "Live preview" is checked in the GUI, any changes that the user makes to parameters accessible in the GUI will generate an updated preview.
|-
| <code>savecopyonly</code> (''new in 1.2'')
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> (default)
| If set to <code>true</code> in an '''output''' extension, it will limit the extension to being available only in the "Save a Copy" menu.
|-
|}

== Example ==
More example INX files are available in the Inkscape distribution, which takes its files from the [https://gitlab.com/inkscape/extensions Inkscape Extensions Repository].

<small><pre>
<?xml version="1.0" encoding="UTF-8"?>
<inkscape-extension xmlns="http://www.inkscape.org/namespace/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|bool]" 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></small>

For a full list of currently supported interpreters, please see [[Extension Interpreters]].

== DTD XML schema==
The following XML schema may not fully describe the current INX file structure. The actual XML schema used is described in the [[INX extension descriptor format#RELAX NG XML schema|next paragraph]].
<small><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)>
<!ELEMENT menu-tip (#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 effect implements-custom-gui (true|false) #IMPLIED>
<!ATTLIST effect needs-document (true|false) #IMPLIED>
<!ATTLIST page name CDATA #REQUIRED>
<!ATTLIST page gui-text CDATA #IMPLIED>
<!ATTLIST param name CDATA #REQUIRED>
<!ATTLIST param type (int|float|string|bool|notebook|path|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></small>

== RELAX NG XML schema ==
The XML schema for INX files is available in the [https://gitlab.com/inkscape/extensions/-/blob/master/inkscape.extension.rng Inkscape extensions Git repository]. This is a [http://www.relaxng.org/ RELAX NG schema].

== See Also ==
*[[Extensions:_INX_widgets_and_parameters|INX Parameters]]
*[[ScriptingHOWTO]]

[[Category:Developer Documentation]]
[[Category:Help Wanted]]
[[Category:Extensions]]

INX extension descriptor format

2021-11-18T21:01:26Z

Oskay: Add savecopyonly attribute, remove some deprecated items, improve descriptions, clean up a bit

== 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. The INX file is an XML file with Inkscape-specific content that can be edited in a plain-text editor.

The INX file allows the author to:
* Specify what type of extension it is, for example input, output, or effect
* Identify [[Extension_Interpreters|which interpreter]] should be used to run the extension
* List dependencies; files or other extensions required for operation
* Define parameters that can be set in the extension
* Create [[Extensions:_INX_widgets_and_parameters|a GUI with control widgets]] for those parameters
* Add a submenu to the Extensions menu for the extension to reside in
* Label strings for translation
* Chain extensions
* Etc

Nothing beats a working example, and Inkscape includes a great number of extensions with INX files that you can read. To find the location of your Inkscape extensions directory, where included extensions and their INX files are located, look in the System pane of Inkscape Preferences, under "Inkscape extensions".

== Translation of extensions ==

Extension dialog windows, described in INX files, can be prepared for translation or localisation by adding an <code>_</code> (underscore) to the XML tags or attributes. Only add underscores when text needs to be translated (not numeric values, for example!).

Example:
<pre>
<_name>Some translatable extension name</_name>
</pre>

Or:
<pre>
<param name="..." type="..." _gui-text="Some translatable label text">
</pre>

When extensions are included in the [https://gitlab.com/inkscape/extensions Inkscape Extensions Repository], various scripts will scan each INX file for translatable text and prepare [https://gitlab.com/inkscape/inkscape/-/tree/master/po translation files] for others to translate.

See also: [http://gould.cx/ted/blog/Translating_Custom_XML Ted's blog].

== Attributes description ==

{| class="wikitable"
|-
! Attribute name
! Allowed values
! Comment
|-
| <code>implements-custom-gui</code> (''new in 1.0'')
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> ''(default)''
| If set to <code>true</code> '''requires''' an effect extension to implement custom GUI.<br>''Implementation detail: The "extension is working" window is not shown for this kind of extensions. This means user interaction with the Inkscape interface is blocked until the extension returns, with no way for the user to abort the running extension! It is therefore '''absolutely essential''' that your extension provides the necessary visual feedback for the user and has proper error handling, to rule out any dead-locking behavior.''
|-
| <code>needs-document</code>
| <code>"true"</code> ''(default)'' <nowiki>|</nowiki> <code>"false"</code>
| If set to <code>false</code> an effect extension will not be passed a document nor will a document be read back ("no-op" effect). This is currently a hack to make extension manager work and will likely be removed/replaced in future, so use at your '''own risk'''!
|-
| <code>needs-live-preview</code>
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> (default)
| If set to <code>true</code> in an effect extension, it will offer a "Live preview" checkbox in its GUI. When the user checks that box, it will run the extension in a "preview mode", visually showing the effect of the extension, but not making any changes to the SVG document, unless the user clicks the Apply button. While "Live preview" is checked in the GUI, any changes that the user makes to parameters accessible in the GUI will generate an updated preview.
|-
| <code>savecopyonly</code> (''new in 1.2'')
| <code>"true"</code> <nowiki>|</nowiki> <code>"false"</code> (default)
| If set to <code>true</code> in an '''output''' extension, it will limit the extension to being available only in the "Save a Copy" menu.
|-
|}

== Example ==
More example INX files are available in the Inkscape distribution, which takes its files from the [https://gitlab.com/inkscape/extensions Inkscape Extensions Repository].

<small><pre>
<?xml version="1.0" encoding="UTF-8"?>
<inkscape-extension xmlns="http://www.inkscape.org/namespace/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|bool]" 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></small>

For a full list of currently supported interpreters, please see [[Extension Interpreters]].

== DTD XML schema==
The following XML schema may not fully describe the current INX file structure. The actual XML schema used is described in the [[INX extension descriptor format#RELAX NG XML schema|next paragraph]].
<small><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)>
<!ELEMENT menu-tip (#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 effect implements-custom-gui (true|false) #IMPLIED>
<!ATTLIST effect needs-document (true|false) #IMPLIED>
<!ATTLIST page name CDATA #REQUIRED>
<!ATTLIST page gui-text CDATA #IMPLIED>
<!ATTLIST param name CDATA #REQUIRED>
<!ATTLIST param type (int|float|string|bool|notebook|path|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></small>

== RELAX NG XML schema ==
The XML schema for INX files is available in the [https://gitlab.com/inkscape/extensions/-/blob/master/inkscape.extension.rng Inkscape extensions Git repository]. This is a [http://www.relaxng.org/ RELAX NG schema].

== See Also ==
*[[INX Parameters]]
*[[ScriptingHOWTO]]

[[Category:Developer Documentation]]
[[Category:Help Wanted]]
[[Category:Extensions]]

Leadership Committee Status Updates

2021-02-05T17:21:07Z

Oskay: 2020->2021

== Place and Time ==

We meet in #inkscape-devel on [https://freenode.net/ freenode]. You can also join the [https://chat.inkscape.org/channel/team_devel #team-devel discussion channel on chat.inkscape.org] to partake in the meeting.

Board meetings are typically the first Friday of each month.

<em>Everybody in the Inkscape community is invited to participate.</em>

Next meeting: [https://www.timeanddate.com/worldclock/fixedtime.html?iso=20210205T10&p1=202 10:00 PST/18:00 UTC/19:00 CET, (click for world clock)], Fri., Feb. 5, 2021. (Time is fixed to 10 AM Pacific Time.)

Meetings should be announced in advance on [https://lists.inkscape.org/hyperkitty/list/inkscape-devel@lists.inkscape.org inkscape-devel] and [https://lists.inkscape.org/hyperkitty/list/inkscape-board@lists.inkscape.org inkscape-board] mailing lists.

== Agenda ==

* GSoC application and planning

* Voting member changes (Mc)

* Board elections schedule

* Apple developer membership status update (RdH)

* Developer meeting update (Mc / Tav)
** [[Inkscape 1.1 Release Planning|Release schedule for 1.1]]

* Community and developer development. (Tav)

* Vectors update (ryangorley)

* Board documents update (ted)

* Budget and Financial Report (ted)

== Deferred Agenda ==

* Next Hackfest
* Need someone to handle escalated complaints re CoC, since Krzysztof Kosiński has resigned. Hopefully someone with training or experience with conflict resolution or mediation. Not much time needed, probably would never happen, but need to be ready just in case. Currently it's vacant.

== Board Meeting Transcripts ==

=== 2020 ===
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-11-06.log.html 2020-11-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-10-02.log.html 2020-10-02]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-03-06.log.html 2020-03-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-02-07.log.html 2020-02-07]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-01-03.log.html 2020-01-03]

=== 2019 ===

* [https://alpha.inkscape.org/board/meetings/transcripts/2019-12-06.log.html 2019-12-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-11-01.log.html 2019-11-01]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-10-04.log.html 2019-10-04]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-09-06.log.html 2019-09-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-08-03.log.html 2019-08-03]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-07-26.log.html 2019-07-26]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-07-12.log.html 2019-07-12]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-06-07.log.html 2019-06-07]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-05-03.log.html 2019-05-03]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-04-05.log.html 2019-04-05]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-03-01.log.html 2019-03-01]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-02-01.log.html 2019-02-01]
* [https://alpha.inkscape.org/board/meetings/transcripts/2019-01-04.log.html 2019-01-04]

=== 2018 ===

* [https://alpha.inkscape.org/board/meetings/transcripts/2018-12-07.log.html 2018-12-07]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-11-02.log.html 2018-11-02]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-10-05.log.html 2018-10-05]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-09-07.log.html 2018-09-07]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-08-03.log.html 2018-08-03]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-07-06.log.html 2018-07-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-06-01.log.html 2018-06-01]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-05-04.log.html 2018-05-04]
* [https://alpha.inkscape.org/board/meetings/transcripts/2018-04-06.log.html 2018-04-06]
* [https://alpha.inkscape.org/board/meetings/transcripts/board_meeting_2018-03-02.html 2018-03-02]
* [https://inkscape.org/gallery/item/12009/ 2018-02-02]
* [https://inkscape.org/gallery/item/11875/ 2018-01-05]

=== 2017 ===

* [https://inkscape.org/paste/11743/ 2017-12-01]
* [https://inkscape.org/paste/11651/ 2017-11-03]
* [https://inkscape.org/gallery/item/11517/ 2017-10-06]
* [https://inkscape.org/gallery/item/11377/ 2017-09-01]
* [https://inkscape.org/gallery/item/11250/ 2017-08-04]
* [https://inkscape.org/gallery/item/11176/ 2017-07-07]
* [https://inkscape.org/gallery/item/11064/ 2017-06-02]
* [https://inkscape.org/gallery/item/10844/ 2017-04-07]
* [https://inkscape.org/gallery/item/10740/ 2017-03-03]
* [https://inkscape.org/gallery/item/10651/ 2017-02-03]
* [https://inkscape.org/gallery/item/10582/ 2017-01-06]

=== 2016 ===

* [https://inkscape.org/gallery/item/10484/ 2016-12-02]
* [https://inkscape.org/gallery/item/10241/ 2016-11-04]
* [https://inkscape.org/gallery/item/9971/ 2016-09-02]
* [https://inkscape.org/gallery/item/9864/ 2016-08-05]
* [https://inkscape.org/gallery/item/9766/ 2016-07-08]
* [https://inkscape.org/gallery/item/9667/ 2016-06-03]
* [https://inkscape.org/gallery/item/9563/ 2016-05-06]
* [https://inkscape.org/gallery/item/9565/ 2016-04-01]

* [https://inkscape.org/gallery/item/7276/ 2016-01-08]

=== 2015 ===

* [https://inkscape.org/gallery/item/7056/ 2015-12-04]
* [https://inkscape.org/gallery/item/6886/ 2015-11-06]
* [https://inkscape.org/gallery/item/6701/ 2015-10-02]

=== 2014 ===

* [https://inkscape.org/gallery/item/2498/ 2014-11-26]
* [https://inkscape.org/gallery/item/2216/ 2014-11-19]
* [https://inkscape.org/gallery/item/2210/ 2014-11-12]
* [https://inkscape.org/gallery/item/2204/ 2014-11-05]
* [https://inkscape.org/gallery/item/1436/ 2014-10-15]
* [https://inkscape.org/gallery/item/950/ 2014-10-08]
* [https://inkscape.org/gallery/item/854/ 2014-09-29]
* [https://inkscape.org/gallery/item/392/ 2014-09-15]

'''[https://inkscape.org/en/gallery/=pastebin/?q=meeting&order=-edited Website search for all transcripts]'''

Extensions: INX widgets and parameters

2020-07-18T00:44:46Z

Oskay: typo

This page documents how to design GUIs for [[Extension subsystem|Inkscape Extensions]] using the built-in [[INX extension descriptor format]].

== Introduction ==

Extension GUIs consists of an arbitrary number of GUI elements, so-called '''[[#Widgets|Widgets]]'''. These can be simple text labels, boxes and spacers to control layout or more complex UI elements like images.

A special class of Widgets are '''[[#Parameters|Parameters]]'''. They differ from other Widgets in that they have a user-settable value, for example a boolean (implemented as checkbox) or integer (implemented as number entry). The value of each Parameter is passed to the extension on execution and can be used to control its behavior.

All Widgets are described using an easy-to-learn XML schema with predefined tags and attributes which are described in detail below.



=== Available Widgets ===

A general Widget takes the form

<source lang="xml">
<widget_name attribute1="value1" atribute2="value2" …>value</widget_name>
</source>

where <code>widget_name</code> specifies the name of the widget and is one of the following:

* <code>label</code>
* <code>hbox</code>/<code>vbox</code>
* <code>separator</code>/<code>spacer</code>
* <code>image</code>
* <code>param</code> (for all Parameter types)

=== Available Parameter types ===

A general Parameter takes the form

<source lang="xml">
<param type="parameter_type" attribute1="value1" atribute2="value2" …>value</param >
</source>

where <code>parameter_type</code> specifies the type of the parameter and is one of the following:

* <code>bool</code>
* <code>int</code>
* <code>float</code>
* <code>string</code>
* <code>path</code>
* <code>optiongroup</code>
* <code>notebook</code>
* <code>color</code>

== Common attributes ==

{| class="wikitable" style="vertical-align:top;" valign="top"
|-
!colspan="5"|For all Widgets
|-
! Attribute name
! Allowed value(s)
! Default value
! Required?
! Description
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>gui-hidden</code>
| <code>true</code>,<code>false</code>
| <code>false</code>
| optional
| If set to <code>true</code> the Widget is hidden from the GUI (primarily used to add hidden parameters that are passed to the extension but are not supposed to be editable by the user.)

''Note: If there are '''no''' visible parameters defined in a GUI, the extension is executed immediately without showing a dialog.''
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>indent</code>
| <code>0,1,2,...</code>
| <code>0</code>
| optional
| Sets indentation level of the parameter. Increasing indentation adds padding to the start of the line.|-
|- style="border:none;background:none"
!colspan="5" style="border:none;background:none"| 
|-
!colspan="5"|Only for Parameters
|-
! Attribute name
! Allowed value(s)
! Default value
! Required?
! Description
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>name</code>
| ''(text)''
| -
| required
| Used as an identifier of the parameter. It has to be unique since the value of this attribute is used to save and transmit parameter values internally!
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>type</code>
| (see [[#Available Parameter types|above]])
| -
| required
| Determines the type of the parameter, see the extensive description of [[#Available Parameter types|available types]] below.
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>gui-text</code>
| ''(text)''
| -
| required ''(visible parameters)'',<br/>optional ''(hidden parameters)''
| Label shown for the parameter in the GUI.
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>gui-description</code>
| ''(text)''
| -
| optional
| Tooltip shown for the parameter when the user hovers the mouse cursor over the active area of the parameter in question.
|-
|}



== Available Parameter types ==

{| class="wikitable" style="width:100%"

|-
! Type
! Description / Code
! Result

|-
! boolean
|Creates a checkbox input to set a '''boolean value'''. Set the default value to <code>true</code> or <code>1</code>, <code>false</code> or <code>0</code>.

<pre>
<param name="name" type="boolean" gui-text="Some label text">false</param>
</pre>
|[[File:INX_sample-boolean.png]]

|-
! color
|Creates a control to select a '''color value'''.
The '''returned value''' is an RGBA-value.

<pre>
<param name="name" type="color"></param>
</pre>
|[[File:INX_sample-color.png]]

|-
! description
|Creates a text element. Specifying the attribute <code>xml:space="preserve"</code> preserves whitespace in the text content of the description and enables multiline text.

<pre>
<param name="name" type="description">Some text here.</param>
</pre>

When additionally setting the attribute <code>appearance="header"</code> the text is styled as a heading and can be used as another possibility to group parameters.
<pre><param name="name" type="description" appearance="header">Header</param></pre>

All <code>description</code> type parameters are purely informational (they do not return any value). They are intended to be used to provide additional information / help on other parameters (Consider using the <code>gui-description</code> attribute for short help texts that are specific to a single parameter, though).

|[[File:INX_sample-description.png]]<br><small>default appearance</small><br><br><br><br>
[[File:INX_sample-description_header.png]]<br><small>with <code>appearance="header"</code></small><br><br><br> 

|-
! enum
|Creates a drop-down list from which '''one predefined value''' can be chosen. The different choices are created with <code><item></code> elements. The first <code><item></code> is selected by default.
The '''returned value''' for <code>enum</code> type parameters is the value of the <code>value</code> attribute of the selected <code><item></code>.

<pre>
<param name="name" type="enum" gui-text="Some label text">
<item value="1">First option</item>
<item value="2">Second option</item>
</param>
</pre>
|[[File:INX_sample-enum.png]]

|-
! float
|Creates a textbox input to enter a '''floating point number'''. Limit the input range with the <code>min</code> and <code>max</code> attributes; set the number of decimal places with the <code>precision</code> attribute. (Default: <code>min="0"</code>, <code>max="10"</code> and <code>precision="1"</code>)

<pre>
<param name="name" type="float" precision="3" min="0" max="9999"
gui-text="Some label text">1.234</param>
</pre>

Use the attribute <code>appearance="full"</code> to create a slider with which the floating point value can be adjusted dynamically over the full range.
|[[File:INX_sample-float.png]]<br><br>[[File:INX_sample-float_full.png|240px]]

|-
! int
|Creates a textbox input to enter an '''integer number'''. Limit the input range with the <code>min</code> and <code>max</code> attributes. (Default: <code>min="0"</code> and <code>max="10"</code>)

<pre>
<param name="name" type="int" min="1" max="100" gui-text="Some label text">1</param>
</pre>

Use the attribute <code>appearance="full"</code> to create a slider with which the integer value can be adjusted dynamically over the full range.
|[[File:INX_sample-int.png]]<br><br>[[File:INX_sample-int_full.png|240px]]

|-
! notebook
|Creates a set of pages (aka tab control). The user can switch between individual pages, each page can contain an arbitrary set of other parameters. Individual pages are created with the <code><page></code> element.
The '''returned value''' for <code>notebook</code> type parameters is the value of the <code>name</code> attribute of the selected <code><page></code>.

<pre>
<param name="name" type="notebook">
<page name="page_1" gui-text="First page">
<param>...</param>
</page>
<page name="page_2" gui-text="Second page">
<param>...</param>
</page>
</param>
</pre>
|[[File:INX_sample-notebook.png]]

|-
! optiongroup
|Creates a set of radio buttons from which '''one predefined value''' can be chosen. The different choices are created with <code><option></code> elements. The first <code><option></code> is selected by default.
The '''returned value''' for <code>optiongroup</code> type parameters is the value of the <code>value</code> attribute of the selected <code><option></code>.

<pre>
<param name="name" type="optiongroup"
gui-text="Some label text">
<option value="1">First option</option>
<option value="2">Second option</option>
</param>
</pre>

Set the attribute <code>appearance="minimal"</code> to display a drop-down list instead of radio buttons.<br>
<small>''The option group will occupy the minimum space on the right hand side of the dialog. Versus the Enum, which expands to fill available space.''</small>
|[[File:INX_sample-optiongroup.png]]<br><br><br><br><br>[[File:INX_sample-optiongroup-minimal.png]]

|-
! string
|Creates a textbox input to enter a '''character string'''. Limit the number of characters the user is allowed to enter with the <code>max_length</code> attribute. (Default: no limit)

<pre>
<param name="name" type="string" gui-text="Some text label">Some default text</param>
</pre>
|[[File:INX_sample-string.png]]

|}

== Localization of parameters ==

To mark parameters to be included into the translation files (this is done automatically during the build process) there exist special variants of all relevant attributes and tag names that start with an underscore.

* Labels and tooltips can be marked for translation by simply using the attribute names <code>_gui-text</code> and <code>_gui-description</code> instead of their counterparts without underscore.
* For <code><item></code>s and <code><option></code>s (both of which do not use the attributes just explained) add an underscore to the tag name itself:<br><code><_item value="1">Localized item name</_item></code> and<br><code><_option value="1">Localized option name</_option></code> respectively.
* Also for <code>description</code> type (and ''only'' for <code>description</code> type!) parameters an underscore is added to the tag name itself:<br><code><_param type="description">Localized text here.</_param></code>

= Editing INX Parameters in 1.0 =

In this section:
* When an attribute is in square brackets (<code>[name="value"]</code>), it means that <code>name</code> is optional.
* The 1 in <code>indent="1"</code> is the indentation level that you want.

== Tags for the layout ==

<source lang="xml">
<label [indent="1"] [appearance="header"]>Some text</label>
<label [indent="1"] [appearance="url"]>http://some/url</label>
<image>some/inx/relative/path/to/img.svg</image>
<spacer/>
<separator [indent="1"]/>
<hbox [indent="1"]></hbox>
<vbox [indent="1"]></vbox>
</source>

== Tags for the parameters ==

* The <code>name</code> attribute of tag <code><param></code> means the name of the argument (<code>--name=</code>) your command will get.
* Parameter values (when opening the dialog) are set to the last used value, which is saved in the user's preferences file (e.g. ~/.config/inkscape/preferences.xml on GNU/Linux systems):
<source lang="xml">
<inkscape>
<group id="extensions" com.attrib.id.param_name="param value"/>
</inkscape>
</source>
The (default) values in the inx file are visible only when the user first uses the extension.

=== Notebook ===
{| class="wikitable"
|+ Multiple views/options in the same dialog window.
|-
| colspan="2" | It helps with layouting, and allows you to retrieve the active page (tab) name.
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-notebook.png|border]]
| It defaults to the first page.
|-
| colspan="2" | <source lang="xml">
<param type="notebook" name="varname" [indent="1"]>
<page name="value" gui-text="label">

</page>

</param>
</source>
|}
*The value of the selected <code><page name></code> attribute will be passed as an argument to your extension.
**The default value is the name of the first page.
*If the same <code><param name></code> is used in multiple tabs, its value will be taken from the last <code><page></code> it appears on.
**This means that it's best to use different names if the same parameter is used on multiple pages.

=== Checkbox ===

{| class="wikitable"
|+ To get a boolean value
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-boolean.png]]
| The default value is <code>true</code>
|-
| colspan="2" |
<source lang="xml">
<param type="bool" name="varname" gui-text="label" [indent="1"]>false</param>
</source>
|}
=== Numeric spinner ===

{| class="wikitable"
|+ To get numbers, int or float
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-float.png]]
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-int.png]]
| The default value is 0
|-
| colspan="3" |
{| style="margin: auto;"
|+ With <code>appearance="full"</code>, you get a full width slider.
|-
| scope="col" style="border: 1px solid #a2a9b1; background-color:#f0f0f0;" | [[File:INX_sample-float_full.png|center]]
|}
|-
| colspan="3" |
<source lang="xml">
<param type="int" name="varname" gui-text="labal" [min="1"] [max="10"] [appearance="full"] [indent="1"]/>
<param type="float" name="varname" gui-text="label" [min="0.5"] [max="5.0"] [appearance="full"] [indent="1"]/>
</source>
|}
* The widget has a precision of 0.1 for float.
* The default <code>min</code> value is "0".
* The default <code>max</code> value is "10".

=== Text fields ===

{| class="wikitable"
|+ Get text input
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-string.png]]
| The default value is the empty string and with such a value, the parameter is omitted.
|-
| colspan="2" |
<source lang="xml">
<param type="string" name="varname" gui-text="label" [indent="1"] [max-length="5" | appearance="multiline"]>some text</param>
</source>
|}

You can provide an integer to the attribute <code>max-length</code> to limit the number of characters you can get.

=== File chooser ===

{| class="wikitable"
|+ Get a path, either a file or a directory
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX path.png|none]] || Default's to the path of the folder containing the script
|-
| colspan="2" | Use one of:
<source lang="xml">
<param type="path" name="varname" gui-text="label" [indent="1"] mode="file" filetypes="svg,png"/>
<param type="path" name="varname" gui-text="label" [indent="1"] mode="files" filetypes="svg,png"/>
<param type="path" name="varname" gui-text="label" [indent="1"] mode="file_new" filetypes="svg,png"/>
<param type="path" name="varname" gui-text="label" [indent="1"] mode="folder"/>
<param type="path" name="varname" gui-text="label" [indent="1"] mode="folders"/>
<param type="path" name="varname" gui-text="label" [indent="1"] mode="folder_new"/>
</source>
|}
* The attribute <code>mode</code> with a value of:
** <code>"file"</code> or <code>"folder"</code> (without <code>s</code>) open a file browser for selecting 1 object.
** The versions ending with a <code>s</code> open a file browser for selecting multiple objects.
** And the ones ending with <code>_new</code> are for creating new objects.
* The <code>filetype</code> attribute contains a list of file extensions to look for. In this example only svg or png files will be displayed.

=== A combobox or radio buttons ===

{| class="wikitable"
|+ To get a choice of predefined values
|-
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-optiongroup-minimal.png]]
| scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-optiongroup.png]]
| Default value is the first item
|-
| colspan="3" |
<source lang="xml">
<param type="optiongroup" name="varname" gui-text="label" [appearance="combo"|appearance="radio"] [indent="1"]>
<item value="value">Some text</item>

</param>
</source>
|}
* The default <code>appearance</code> is <code>"radio"</code>. The appearance <code>"combo"</code> is also valid.

=== Color ===
{| class="wikitable"
|+ Get a hex color value
|-
| rowspan="2" scope="col" style="width: 240px; background-color:#f0f0f0;" | [[File:INX_sample-color.png]]
| scope="col" style="width: 240px; height: 35px; background-color:#f0f0f0;" | [[File:INX color-btn.png]]
| Default value is <code>#000000FF</code>
|-
| colspan="2" style="vertical-align: top;" |
{|
| style="padding-left: 6em;" | <b style="font-size:18px;">↑</b>With<b style="font-size:18px;">↑</b> the attribute <code>appearance="colorbutton"</code>
|-
| style="height: 100px;" | <b style="font-size:18px;">⇇</b> Without <code>appearance="colorbutton"</code>
|}
|-
| colspan=3 |
<source lang="xml">
<param type="color" name="varname" [appearance="colorbutton" gui-text="label"] [indent="1"]/>
</source>
|}

The parameter value is an RGBA value in hexadecimal notation.

To document:

* Multiline text fields: appearance="multiline"
* type "description"
* translatable="no"
* implements-custom-gui

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

Updating your Extension for 1.0

2019-08-16T16:13:45Z

Oskay: Add note about new parameter changes

This is a preliminary and incomplete list of actions to take for updating Python extensions for Inkscape 1.0:

== Updating *.inx files ==

=== Remove dependency listings ===

Remove the dependency listings for the following modules:

* bezmisc.py
* coloreffect.py
* cspsubdiv.py
* cubicsuperpath.py
* ffgeom.py
* inkex.py (removal not strictly required)
* pathmodifier.py
* simplepath.py
* simplestyle.py
* simpletransform.py
* more?

This change is backwards compatible (as long as the user has a fully functioning Inkscape installation).
Not removing these will result in the extension not being available in Inkscape 1.0 or higher.

=== Changes to parameter definitions ===

There are also some updates to the parameter definitions. While these are intended to be backwards compatible to 0.92, you may wish to review the changes as documented in [https://gitlab.com/inkscape/inkscape/merge_requests/808 MR#808].

== Updating *.py files ==

=== Collecting the options of the extension ===

# Instead of <code>inkex.Effect.OptionParser.add_option</code>, your extension should now use <code>inkex.Effect.arg_parser.add_argument</code>.
# The 'type' option now works with variables instead of strings. Use <code>int</code> instead of <code>"int"</code> (same for float,...).
# The 'inkbool' type is now <code>inkex.inkbool</code>.
# <code>action="store"</code> can be removed.

These changes are not backwards compatible. The old options will still work, but are deprecated and should no longer be used when you develop your extension for Inkscape 1.0 or higher.

=== Replace specific functions ===

# <code>pathmodifier.zsort()</code> is now <code>inkex.zsort()</code> (more info: https://gitlab.com/inkscape/extensions/issues/24).

Lots more, someone needs to flesh this out.

=== Test run your extension ===

Many functions, when run, will still work, but they will give you a deprecation warning, with instructions what to replace them by.

E.g. <code>inkex.Effect.selected</code> is replaced by <code>inkex.Effect.svg.selected</code> - however, most replacements do not follow this naming scheme translation.

These changes are not backwards compatible.

=== Python 3 / Python 2 compatibility ===

Test your extension with both Python 2 and Python 3. With the updated extensions, Inkscape does no longer require Python 2, so some users will probably be using Python 3, and may no longer have Python 2 installed on their system. See [[Extension_Interpreters]] for how to set the Python version for your extension (for testing).

== Getting your extension added to Inkscape's stock extensions ==

Inkscape now has a [https://gitlab.com/inkscape/extensions separate repository for its Python extensions], which is included into Inkscape proper by using a Git submodule.

=== Writing tests ===

Previously Inkscape didn't require any unit testing for code. You should now write test code, if you expect your module to be included into the Inkscape extensions repository and included in the shipped Inkscape release. In this case, a test suite file should be made in the tests directory for your extension. It should test each aspect of your extension and exercise all assumptions.

If you are writing a standalone extension that users will install themselves, there is no strict requirement for tests. But having them will greatly improve your code and your ability to upgrade the code later. You can have tests in your own folders and use the extension's setup.py as a harness to run them (a setup.py file is also useful for installing your python code as a non-inkscape related python module, which might be useful too). See Python documentation for creating packages.

=== Documenting your extension ===

TODO

=== Submitting your extension for inclusion ===

Visit https://gitlab.com/inkscape/extensions, fork the repository, and create a merge request on GitLab.

[[Category:Extensions]]

Release notes/1.0

2019-06-03T21:31:04Z

Oskay: MacOS edits + image

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

== Inkscape 1.0 ==

'''(definitely not released yet - [[AnnouncePlanning1.0]])'''

== Release highlights ==

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

[Please fill in]

* Theming support
* Origin in top left corner (optional)
* Canvas rotation and mirroring
* On-Canvas alignment of objects
* Better HiDPI screen support
* Control width of PowerStroke with pressure sensitive graphics tablet
* Fillet/chamfer LPE and (lossless) Boolean Operation LPE
* New PNG export options
* Path operations and deselection of a large number of paths are much faster now
* Variable fonts (only if compiled with pango library version >= 1.41.1)

== Important changes ==

=== For users ===

==== Custom Icon Sets ====

Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated it's own file. The directory structure must follow the standard structure for Gnome icons.

If you would like to create or convert your own icon set to the new format, please see the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation 'share' directory for suitable examples.

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 ====

Third-party extensions need to be updated to work with this version of Inkscape.

==== Import/Export via UniConvertor dropped ====

Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed:

Import formats that have been removed:

* Adobe Illustrator 8.0 and below (UC) (*.ai)
* Corel DRAW Compressed Exchange files (UC) (*.ccx)
* Corel DRAW 7-X4 files (UC) (*.cdr) [cdr imports, but this specific version?]
* Corel DRAW 7-13 template files (UC) (*.cdt)
* Computer Graphics Metafile files (UC) (*.cgm)
* Corel DRAW Presentation Exchange files (UC) (*.cmx)
* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

Export formats that have been removed:

* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

==== Inline LaTeX formula conversion dropped ====

The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (Render > LaTeX) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies.

=== For extension writers ===

''[TBC - not final]''
Extensions have undergone some fundamental changes.
Inkscape's stock extensions have been moved to [https://gitlab.com/inkscape/extensions their own repository] and were updated for compatibility with Python 3. Internally, extensions have been reorganized and many functions have been deprecated.

''[Extension manager? How-to-guide for updating? New API elements? Documentation?]''

Instructions for updating old extensions are available at [[Updating your Extension for 1.0]]

Also note the changed [[#Command Line|command line options]].

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.

=== For packagers and those who compile Inkscape ===

* autotools builds have been dropped. Please use CMake for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* libsoup dependency added: we use libsoup for making http requests without a need for dbus and gvfs.
* double-conversion [https://github.com/google/double-conversion] dependency added: lib2geom now depends on an external version of the library.
* Inkscape now uses a git submodule for the extensions 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])

== General: Application ==

Several small performance improvements in various areas combine to make Inkscape run smoother than before (e.g. MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448]).

=== General User Interface ===

The user interface has been changed to utilise a more recent version of GTK+. This is the widget toolkit that Inkscape makes use of to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI 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, it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Mac Application ===

Inkscape is now a first-rate native MacOS application, and no longer requires XQuartz to operate.

It has a standard Mac-style menu bar (rather than a menu bar within the window). Keyboard shortcuts now use the command (⌘) key rather than the control key. Retina display screen resolution is now supported. The build is now cleanly 64-bit, a prerequisite for MacOS 10.15 Catalina and beyond.

[[File:Mac_menu_1.0_screenshot.png|665px]]

=== Window position / size ===

Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
. 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 to our bug tracker.

=== HiDPI ===

Inkscape now supports HiDPI screens.

=== Icons ===
[Please fill in]

=== Y Axis Inversion ===

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 allows the User to optionally set the origin of their 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.

<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 ==

=== Canvas Rotation ===

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 View > Canvas orientation > Flip horizontally / Flip vertically. Keyboard shortcuts for flipping the canvas can be set in the preferences (Edit > Preferences > Interface > Keyboard shortcuts).

[[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]]

== View ==

=== Visible Hairlines Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Visible Hairlines". 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 for some CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines.

[[File:visible_hairlines.gif]]

=== Outline Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Outline". It hides fills and shows only the outlines of objects, with a consistent-width black line that is visible at any level of zoom.

This is especially useful when using Inkscape for CAD purposes.

=== Center view on page ===

You can now center the view on the page, without changing the zoom level.

This function is available via:

* ''View → Zoom''
* Zoom tool tool controls
* Keyboard shortcut <kbd>[TBD]</kbd>

=== Split View Mode ===

[needs images + text]

== 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 ''Behavior → Clones → Unlink Clones'' allows the User to disable the automatic unlinking.

== Tools ==

=== 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]''.

=== 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 ===

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 Shift 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 ====

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 to 100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* 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]].
* '''Pressure change for new knot''' (in the global Inkscape preferences, Edit > Preferences > Tools > Pencil): adds a PowerStroke Knot when the stylus pressure changes by this percentage.

''[needs video/gif]''

=== Selection Tool ===

==== On-Canvas Alignment ====

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.

* Shift + click 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 Shift + click objects will be aligned on the vertical axis.
* [Ctrl (+ Shift )... 'treat objects as group' - Fixme]

[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool ===

* [describe new line-height settings]
* [describe new text column mode]
* [describe new flowed text compatibility with other viewers and fallbacks]

==== Variable Font Support ====

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>

==== Support for SVG 2 Text ====

Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating. When creating SVG 2 text, Inkscape will (by default) add fallback support for rendering the text in SVG 1.1 renderers (important as no browsers currently fully support SVG 2 text).

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 'white-space' value to 'pre', 'pre-line', or 'pre-wrap', Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the 'white-space' property value. (Supported by Firefox.)

===== Multi-line text via the CSS 'inline-size' property =====

The CSS property 'inline-size' defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. To set the inline-size one drags the diamond-shaped handle that is located on the text baseline at the end of a line of text. To convert the text back to SVG 1.1 text, Ctrl-click on the diamond (this will result in all the text being placed on a single line).

===== Multi-line text via the CSS 'shape-inside' property =====

The CSS property 'shape-inside' allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS 'shape-subtract', 'shape-margin', and 'shape-padding' properties. To put text inside a shape, select the shape(s) and the text and use the 'Text > Flow into frame' menu entry (after enabling ''Use SVG 2 auto-flowed text'' under the "Tools > Text" section of the Inkscape Preferences dialog). Inkscape will (optionally) insert SVG 1.1 fallback attributes on saving the file.

Multi-line text via the 'shape-inside' 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:

* '''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
* '''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.

In addition to this, the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, display info about the selected effect and to apply it.

<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>

=== Boolean Operations LPE ===

''[The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. It works by adding the LPE to a path, then linking a copied path to it by clicking on the 'link to path' button. That way, two [more?] paths can be combined to a single shape, and both are still editable. Available options:

* union
* symmetric difference
* intersection
* division
* difference
* cut outside
* cut inside
* cut
''] functionality incomplete currently, does not hide linked operand, see https://gitlab.com/inkscape/inkscape/merge_requests/20#note_100799480''

<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

=== BSPline and Spiro ===

Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

=== 'Clone Original' Improvements ===

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]

=== Dash 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 dash 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. Especially technical illustrators 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>

=== Embroidery Stitch LPE ===

This new LPE can add nodes to your paths and create jump stitches, to create data that can be converted for use with a stitching machine.
To view the stitches that you added, activate the 'Show stitches' checkbox, and, if necessary, adjust the 'Show stitch gap' value, so you can see the single stitches.

There are various options for calculating the order of the stitching, for connecting the parts of the drawing and 3 different stitch patterns available. It is suggested to play around with these until you like the result.

For exporting your data, you can, for example, use the HPGL file format and go from there.

<gallery>
File:Embroidery stitch lpe.png|''Inkscape Logo with Embroidery LPE (stitches made visible)''|alt=Inkscape Logo with Embroidery LPE (stitches made visible)
File:Embroidery stitch lpe options.png|''Available options: left: methods to order subpaths, right: methods to connect end points of subpaths''|alt=Options: left: methods to order subpaths, right: methods to connect end points of subpaths
</gallery>

=== 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>

=== 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>

=== Knot LPE ===

New options added:

* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Add stroke width: make the gap wider by adding the width of the stroke to the value for the gap length
* Add bottom (other?) stroke width: make the gap wider by adding the width of the bottom (other?) stroke to the value for the gap length
* Crossing signs: [not final]

=== 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>

=== 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>

=== Path Length LPE ===

This path effect displays the length of the path it is applied to in the selected unit and scale.

=== Power Clip and Power Mask LPE ===

This new LPE adds options to clips and masks.

=== 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 <img> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).

''[ TBC: The dpi value for displaying embedded SVG files can be set in the import 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.

The resolution used for displaying them ''[TBC: can be set per image? can be set in the xxx dialog for the selected image]'' is the default image import resolution set in the preferences' 'Imported Images' section. A change in this option will take effect upon closing and reopening the file, and will affect all linked SVG images in the file.

=== Export PNG images ===

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 16bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of antialiasing 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>

== Extensions ==

=== Extension development ===

* All [[INX Parameters]] now have the common attribute <code>indent="n"</code> where <code>n</code> specifies the level of indentation in the extension UI.

* 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.

* Add <code>appearance="url"</code> for [[INX Parameters]] of type "description". You can now add clickable links to your extension UI.

=== Plot extension ===

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'']

=== Interactive Mockup extension ===

[Please fill in]

=== Hershey Text extension ===

Hershey Text, a utility for replacing text into stroke-based paths, has been rewritten and has several significant changes:

1. Previous versions of Hershey Text provided an input window to type a single line of text, which would be rendered onto your page. The new version instead converts in place all or selected text objects in your document. This means that it is possible to render full paragraphs of text, and to render multiple text objects at one time.

2. Rather than using a fixed historical-format data file for its source fonts, it now uses SVG fonts. This means that:
* It is now possible to add new fonts, and to load them without scripting or changes to the extension.
* Unicode characters are now supported, making it possible to render international and other characters outside of the old ASCII limits.
* Stroke fonts now support arbitrary curves rather than only straight segments.

3. The set of included fonts has been carefully curated. Basic international characters have been added to included fonts.

4. A font-mapping method has been added, such that text objects that have different fonts can be rendered automatically into different stroke fonts, based on their names.

5. A feature has been added to generate font samples in all available SVG fonts

6. An extensive help text file is built into the extension.

7. Hershey Text is now located in the Extensions > Text submenu.

== Palettes ==

* The Munsell palette has been added to Inkscape's set of stock palettes.
* Users can now also drag the 'none' color field from the palette bar at the bottom onto objects to set their color to 'none'.

<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
</gallery>

== Templates ==

* The '''Desktop''' template has new options for 4k, 5k and 8k screens.
* A new template for an A4 3-fold roll flyer was added.

<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. %, mm) 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 %) will be converted to user units when the new values are set.

* [Please fill in]

== Dialogs ==

=== Document Properties ===

* 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.

<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>

=== Filter Editor ===

* The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects ===

The context (right-click) menu now also contains an entry for deleting the selected object.

=== Preferences ===

* 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 <img> 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.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at ''Behaviour → Dashes''. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in Edit > Preferences > Input/Output > Autosave: Autosave directory).
* The '''Keyboard shortcut editor''' now issues a warning when the entered shortcut is already in use.

<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>

=== Symbols ===

* 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>

== Customization ==

=== Customize all files in the share folder ===

All 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, palettes, patterns, 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 ''Tools → Text → Additional font directories'').

<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.

=== 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 file <code>keybindings.rc</code> allows you to... '''(TODO: do what? What does it do in comparison to keys.xml? Seems to not work at all... seems to be ancient. Can be deleted?)'''
* The interface colors and some more UI styles can be customized in <code>style.css</code> (very raw themeing support).

=== Theme selection ===

In 'Edit > Preferences > User Interface > Theme', 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 theme folders can be added to the directory indicated in Edit > Preferences > System : User themes. 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]

=== Icon set selection ===

In 'Edit > Preferences > User Interface > Theme', the icon set to use can be selected. By default, Inkscape comes with 'hicolor' and 'Tango' icons. In addition to this, it offers to use the system icons.

Inkscape also comes with a default symbolic icon set as part of the 'hicolor' icon set. These icons can be colorised with a custom colour.

Changes to the icon set take effect when Inkscape is restarted, or when the entire user interface is reloaded by clicking on the 'Reload icons' button. This rebuilds all Inkscape windows. Rebuild takes a couple of seconds, during which the Inkscape interface will be invisible.

<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
</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 "pages.csv". It is located in your Inkscape user preferences folder, next to your 'preferences.xml' 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 pages.csv file to remove the page sizes you won't use, or to add new ones.

== 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

== 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: --export-inkscape-svg)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: --export-id.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: --pdf-page N).
* For importing a pdf, the option to import via poppler is now available for the command line as 'pdf-poppler'.
* 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])

More information can be found at [[Using the Command Line]].

== Translations [as of 2019-01-08] ==

Translations were updated for:

* Basque
* British English
* Catalan
* Croatian
* Czech
* French
* German
* Hindi
* Hungarian
* Icelandic
* Italian
* Latvian
* Romanian
* Russian
* Slovak
* Spanish
* Turkish
* Ukrainian
* Swedish

The installer was translated to:

* Korean

Tutorial translations were added for:

* Korean

Translations were dropped for:

* Amharic

== Notable Bugfixes ==

* Symbols: Visio Stencils loaded from .vss 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 [TBC: Bug: if minimized, this requires a second click]
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* Improved UI performance of handling large paths and selections:
** Accelerated path break-apart and Boolean operations by disabling intermittent canvas rendering during these operations.
** Accelerated "deselect" speed by improving internal data structure algorithms.
* 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 "perl.exe" to "wperl.exe" 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].

== Known Issues ==

[Please fill in]

== 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.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]]

File:Mac menu 1.0 screenshot.png

2019-06-03T21:29:25Z

Oskay: Screenshot of Inkscape 1.0 (alpha) for MacOS

Screenshot of Inkscape 1.0 (alpha) for MacOS

Release notes/1.0

2019-06-03T21:27:12Z

Oskay: Add description of Mac changes for 1.0

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

== Inkscape 1.0 ==

'''(definitely not released yet - [[AnnouncePlanning1.0]])'''

== Release highlights ==

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

[Please fill in]

* Theming support
* Origin in top left corner (optional)
* Canvas rotation and mirroring
* On-Canvas alignment of objects
* Better HiDPI screen support
* Control width of PowerStroke with pressure sensitive graphics tablet
* Fillet/chamfer LPE and (lossless) Boolean Operation LPE
* New PNG export options
* Path operations and deselection of a large number of paths are much faster now
* Variable fonts (only if compiled with pango library version >= 1.41.1)

== Important changes ==

=== For users ===

==== Custom Icon Sets ====

Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated it's own file. The directory structure must follow the standard structure for Gnome icons.

If you would like to create or convert your own icon set to the new format, please see the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation 'share' directory for suitable examples.

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 ====

Third-party extensions need to be updated to work with this version of Inkscape.

==== Import/Export via UniConvertor dropped ====

Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed:

Import formats that have been removed:

* Adobe Illustrator 8.0 and below (UC) (*.ai)
* Corel DRAW Compressed Exchange files (UC) (*.ccx)
* Corel DRAW 7-X4 files (UC) (*.cdr) [cdr imports, but this specific version?]
* Corel DRAW 7-13 template files (UC) (*.cdt)
* Computer Graphics Metafile files (UC) (*.cgm)
* Corel DRAW Presentation Exchange files (UC) (*.cmx)
* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

Export formats that have been removed:

* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

==== Inline LaTeX formula conversion dropped ====

The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (Render > LaTeX) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies.

=== For extension writers ===

''[TBC - not final]''
Extensions have undergone some fundamental changes.
Inkscape's stock extensions have been moved to [https://gitlab.com/inkscape/extensions their own repository] and were updated for compatibility with Python 3. Internally, extensions have been reorganized and many functions have been deprecated.

''[Extension manager? How-to-guide for updating? New API elements? Documentation?]''

Instructions for updating old extensions are available at [[Updating your Extension for 1.0]]

Also note the changed [[#Command Line|command line options]].

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.

=== For packagers and those who compile Inkscape ===

* autotools builds have been dropped. Please use CMake for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* libsoup dependency added: we use libsoup for making http requests without a need for dbus and gvfs.
* double-conversion [https://github.com/google/double-conversion] dependency added: lib2geom now depends on an external version of the library.
* Inkscape now uses a git submodule for the extensions 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])

== General: Application ==

Several small performance improvements in various areas combine to make Inkscape run smoother than before (e.g. MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448]).

=== General User Interface ===

The user interface has been changed to utilise a more recent version of GTK+. This is the widget toolkit that Inkscape makes use of to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI 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, it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Mac Application ===

Inkscape is now a first-rate native MacOS application, and no longer requires XQuartz to operate. It has a standard Mac-style menu bar (rather than a menu bar within the window), and shortcuts now use the command (⌘) key rather than the control key. Retina display screen resolution is now supported. The build is now cleanly 64-bit, a prerequisite for MacOS 10.15 Catalina and beyond.

=== Window position / size ===

Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
. 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 to our bug tracker.

=== HiDPI ===

Inkscape now supports HiDPI screens.

=== Icons ===
[Please fill in]

=== Y Axis Inversion ===

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 allows the User to optionally set the origin of their 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.

<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 ==

=== Canvas Rotation ===

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 View > Canvas orientation > Flip horizontally / Flip vertically. Keyboard shortcuts for flipping the canvas can be set in the preferences (Edit > Preferences > Interface > Keyboard shortcuts).

[[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]]

== View ==

=== Visible Hairlines Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Visible Hairlines". 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 for some CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines.

[[File:visible_hairlines.gif]]

=== Outline Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Outline". It hides fills and shows only the outlines of objects, with a consistent-width black line that is visible at any level of zoom.

This is especially useful when using Inkscape for CAD purposes.

=== Center view on page ===

You can now center the view on the page, without changing the zoom level.

This function is available via:

* ''View → Zoom''
* Zoom tool tool controls
* Keyboard shortcut <kbd>[TBD]</kbd>

=== Split View Mode ===

[needs images + text]

== 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 ''Behavior → Clones → Unlink Clones'' allows the User to disable the automatic unlinking.

== Tools ==

=== 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]''.

=== 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 ===

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 Shift 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 ====

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 to 100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* 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]].
* '''Pressure change for new knot''' (in the global Inkscape preferences, Edit > Preferences > Tools > Pencil): adds a PowerStroke Knot when the stylus pressure changes by this percentage.

''[needs video/gif]''

=== Selection Tool ===

==== On-Canvas Alignment ====

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.

* Shift + click 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 Shift + click objects will be aligned on the vertical axis.
* [Ctrl (+ Shift )... 'treat objects as group' - Fixme]

[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool ===

* [describe new line-height settings]
* [describe new text column mode]
* [describe new flowed text compatibility with other viewers and fallbacks]

==== Variable Font Support ====

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>

==== Support for SVG 2 Text ====

Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating. When creating SVG 2 text, Inkscape will (by default) add fallback support for rendering the text in SVG 1.1 renderers (important as no browsers currently fully support SVG 2 text).

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 'white-space' value to 'pre', 'pre-line', or 'pre-wrap', Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the 'white-space' property value. (Supported by Firefox.)

===== Multi-line text via the CSS 'inline-size' property =====

The CSS property 'inline-size' defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. To set the inline-size one drags the diamond-shaped handle that is located on the text baseline at the end of a line of text. To convert the text back to SVG 1.1 text, Ctrl-click on the diamond (this will result in all the text being placed on a single line).

===== Multi-line text via the CSS 'shape-inside' property =====

The CSS property 'shape-inside' allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS 'shape-subtract', 'shape-margin', and 'shape-padding' properties. To put text inside a shape, select the shape(s) and the text and use the 'Text > Flow into frame' menu entry (after enabling ''Use SVG 2 auto-flowed text'' under the "Tools > Text" section of the Inkscape Preferences dialog). Inkscape will (optionally) insert SVG 1.1 fallback attributes on saving the file.

Multi-line text via the 'shape-inside' 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:

* '''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
* '''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.

In addition to this, the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, display info about the selected effect and to apply it.

<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>

=== Boolean Operations LPE ===

''[The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. It works by adding the LPE to a path, then linking a copied path to it by clicking on the 'link to path' button. That way, two [more?] paths can be combined to a single shape, and both are still editable. Available options:

* union
* symmetric difference
* intersection
* division
* difference
* cut outside
* cut inside
* cut
''] functionality incomplete currently, does not hide linked operand, see https://gitlab.com/inkscape/inkscape/merge_requests/20#note_100799480''

<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

=== BSPline and Spiro ===

Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

=== 'Clone Original' Improvements ===

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]

=== Dash 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 dash 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. Especially technical illustrators 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>

=== Embroidery Stitch LPE ===

This new LPE can add nodes to your paths and create jump stitches, to create data that can be converted for use with a stitching machine.
To view the stitches that you added, activate the 'Show stitches' checkbox, and, if necessary, adjust the 'Show stitch gap' value, so you can see the single stitches.

There are various options for calculating the order of the stitching, for connecting the parts of the drawing and 3 different stitch patterns available. It is suggested to play around with these until you like the result.

For exporting your data, you can, for example, use the HPGL file format and go from there.

<gallery>
File:Embroidery stitch lpe.png|''Inkscape Logo with Embroidery LPE (stitches made visible)''|alt=Inkscape Logo with Embroidery LPE (stitches made visible)
File:Embroidery stitch lpe options.png|''Available options: left: methods to order subpaths, right: methods to connect end points of subpaths''|alt=Options: left: methods to order subpaths, right: methods to connect end points of subpaths
</gallery>

=== 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>

=== 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>

=== Knot LPE ===

New options added:

* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Add stroke width: make the gap wider by adding the width of the stroke to the value for the gap length
* Add bottom (other?) stroke width: make the gap wider by adding the width of the bottom (other?) stroke to the value for the gap length
* Crossing signs: [not final]

=== 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>

=== 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>

=== Path Length LPE ===

This path effect displays the length of the path it is applied to in the selected unit and scale.

=== Power Clip and Power Mask LPE ===

This new LPE adds options to clips and masks.

=== 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 <img> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).

''[ TBC: The dpi value for displaying embedded SVG files can be set in the import 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.

The resolution used for displaying them ''[TBC: can be set per image? can be set in the xxx dialog for the selected image]'' is the default image import resolution set in the preferences' 'Imported Images' section. A change in this option will take effect upon closing and reopening the file, and will affect all linked SVG images in the file.

=== Export PNG images ===

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 16bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of antialiasing 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>

== Extensions ==

=== Extension development ===

* All [[INX Parameters]] now have the common attribute <code>indent="n"</code> where <code>n</code> specifies the level of indentation in the extension UI.

* 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.

* Add <code>appearance="url"</code> for [[INX Parameters]] of type "description". You can now add clickable links to your extension UI.

=== Plot extension ===

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'']

=== Interactive Mockup extension ===

[Please fill in]

=== Hershey Text extension ===

Hershey Text, a utility for replacing text into stroke-based paths, has been rewritten and has several significant changes:

1. Previous versions of Hershey Text provided an input window to type a single line of text, which would be rendered onto your page. The new version instead converts in place all or selected text objects in your document. This means that it is possible to render full paragraphs of text, and to render multiple text objects at one time.

2. Rather than using a fixed historical-format data file for its source fonts, it now uses SVG fonts. This means that:
* It is now possible to add new fonts, and to load them without scripting or changes to the extension.
* Unicode characters are now supported, making it possible to render international and other characters outside of the old ASCII limits.
* Stroke fonts now support arbitrary curves rather than only straight segments.

3. The set of included fonts has been carefully curated. Basic international characters have been added to included fonts.

4. A font-mapping method has been added, such that text objects that have different fonts can be rendered automatically into different stroke fonts, based on their names.

5. A feature has been added to generate font samples in all available SVG fonts

6. An extensive help text file is built into the extension.

7. Hershey Text is now located in the Extensions > Text submenu.

== Palettes ==

* The Munsell palette has been added to Inkscape's set of stock palettes.
* Users can now also drag the 'none' color field from the palette bar at the bottom onto objects to set their color to 'none'.

<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
</gallery>

== Templates ==

* The '''Desktop''' template has new options for 4k, 5k and 8k screens.
* A new template for an A4 3-fold roll flyer was added.

<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. %, mm) 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 %) will be converted to user units when the new values are set.

* [Please fill in]

== Dialogs ==

=== Document Properties ===

* 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.

<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>

=== Filter Editor ===

* The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects ===

The context (right-click) menu now also contains an entry for deleting the selected object.

=== Preferences ===

* 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 <img> 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.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at ''Behaviour → Dashes''. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in Edit > Preferences > Input/Output > Autosave: Autosave directory).
* The '''Keyboard shortcut editor''' now issues a warning when the entered shortcut is already in use.

<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>

=== Symbols ===

* 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>

== Customization ==

=== Customize all files in the share folder ===

All 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, palettes, patterns, 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 ''Tools → Text → Additional font directories'').

<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.

=== 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 file <code>keybindings.rc</code> allows you to... '''(TODO: do what? What does it do in comparison to keys.xml? Seems to not work at all... seems to be ancient. Can be deleted?)'''
* The interface colors and some more UI styles can be customized in <code>style.css</code> (very raw themeing support).

=== Theme selection ===

In 'Edit > Preferences > User Interface > Theme', 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 theme folders can be added to the directory indicated in Edit > Preferences > System : User themes. 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]

=== Icon set selection ===

In 'Edit > Preferences > User Interface > Theme', the icon set to use can be selected. By default, Inkscape comes with 'hicolor' and 'Tango' icons. In addition to this, it offers to use the system icons.

Inkscape also comes with a default symbolic icon set as part of the 'hicolor' icon set. These icons can be colorised with a custom colour.

Changes to the icon set take effect when Inkscape is restarted, or when the entire user interface is reloaded by clicking on the 'Reload icons' button. This rebuilds all Inkscape windows. Rebuild takes a couple of seconds, during which the Inkscape interface will be invisible.

<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
</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 "pages.csv". It is located in your Inkscape user preferences folder, next to your 'preferences.xml' 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 pages.csv file to remove the page sizes you won't use, or to add new ones.

== 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

== 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: --export-inkscape-svg)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: --export-id.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: --pdf-page N).
* For importing a pdf, the option to import via poppler is now available for the command line as 'pdf-poppler'.
* 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])

More information can be found at [[Using the Command Line]].

== Translations [as of 2019-01-08] ==

Translations were updated for:

* Basque
* British English
* Catalan
* Croatian
* Czech
* French
* German
* Hindi
* Hungarian
* Icelandic
* Italian
* Latvian
* Romanian
* Russian
* Slovak
* Spanish
* Turkish
* Ukrainian
* Swedish

The installer was translated to:

* Korean

Tutorial translations were added for:

* Korean

Translations were dropped for:

* Amharic

== Notable Bugfixes ==

* Symbols: Visio Stencils loaded from .vss 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 [TBC: Bug: if minimized, this requires a second click]
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* Improved UI performance of handling large paths and selections:
** Accelerated path break-apart and Boolean operations by disabling intermittent canvas rendering during these operations.
** Accelerated "deselect" speed by improving internal data structure algorithms.
* 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 "perl.exe" to "wperl.exe" 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].

== Known Issues ==

[Please fill in]

== 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.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Release notes/1.0

2019-06-03T20:06:56Z

Oskay: Add Outline Display Mode, update Hairlines too

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

== Inkscape 1.0 ==

'''(definitely not released yet - [[AnnouncePlanning1.0]])'''

== Release highlights ==

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

[Please fill in]

* Theming support
* Origin in top left corner (optional)
* Canvas rotation and mirroring
* On-Canvas alignment of objects
* Better HiDPI screen support
* Control width of PowerStroke with pressure sensitive graphics tablet
* Fillet/chamfer LPE and (lossless) Boolean Operation LPE
* New PNG export options
* Path operations and deselection of a large number of paths are much faster now
* Variable fonts (only if compiled with pango library version >= 1.41.1)

== Important changes ==

=== For users ===

==== Custom Icon Sets ====

Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated it's own file. The directory structure must follow the standard structure for Gnome icons.

If you would like to create or convert your own icon set to the new format, please see the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation 'share' directory for suitable examples.

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 ====

Third-party extensions need to be updated to work with this version of Inkscape.

==== Import/Export via UniConvertor dropped ====

Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed:

Import formats that have been removed:

* Adobe Illustrator 8.0 and below (UC) (*.ai)
* Corel DRAW Compressed Exchange files (UC) (*.ccx)
* Corel DRAW 7-X4 files (UC) (*.cdr) [cdr imports, but this specific version?]
* Corel DRAW 7-13 template files (UC) (*.cdt)
* Computer Graphics Metafile files (UC) (*.cgm)
* Corel DRAW Presentation Exchange files (UC) (*.cmx)
* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

Export formats that have been removed:

* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

==== Inline LaTeX formula conversion dropped ====

The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (Render > LaTeX) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies.

=== For extension writers ===

''[TBC - not final]''
Extensions have undergone some fundamental changes.
Inkscape's stock extensions have been moved to [https://gitlab.com/inkscape/extensions their own repository] and were updated for compatibility with Python 3. Internally, extensions have been reorganized and many functions have been deprecated.

''[Extension manager? How-to-guide for updating? New API elements? Documentation?]''

Instructions for updating old extensions are available at [[Updating your Extension for 1.0]]

Also note the changed [[#Command Line|command line options]].

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.

=== For packagers and those who compile Inkscape ===

* autotools builds have been dropped. Please use CMake for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* libsoup dependency added: we use libsoup for making http requests without a need for dbus and gvfs.
* double-conversion [https://github.com/google/double-conversion] dependency added: lib2geom now depends on an external version of the library.
* Inkscape now uses a git submodule for the extensions 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])

== General: Application ==

Several small performance improvements in various areas combine to make Inkscape run smoother than before (e.g. MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448]).

== General User Interface ==

The user interface has been changed to utilise a more recent version of GTK+. This is the widget toolkit that Inkscape makes use of to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI 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, it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Window position / size ===

Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
. 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 to our bug tracker.

=== HiDPI ===

Inkscape now supports HiDPI screens.

=== Icons ===
[Please fill in]

=== Y Axis Inversion ===

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 allows the User to optionally set the origin of their 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.

<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 ==

=== Canvas Rotation ===

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 View > Canvas orientation > Flip horizontally / Flip vertically. Keyboard shortcuts for flipping the canvas can be set in the preferences (Edit > Preferences > Interface > Keyboard shortcuts).

[[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]]

== View ==

=== Visible Hairlines Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Visible Hairlines". 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 for some CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines.

[[File:visible_hairlines.gif]]

=== Outline Display Mode ===

This new display mode is available in the menu under "View > Display Mode > Outline". It hides fills and shows only the outlines of objects, with a consistent-width black line that is visible at any level of zoom.

This is especially useful when using Inkscape for CAD purposes.

=== Center view on page ===

You can now center the view on the page, without changing the zoom level.

This function is available via:

* ''View → Zoom''
* Zoom tool tool controls
* Keyboard shortcut <kbd>[TBD]</kbd>

=== Split View Mode ===

[needs images + text]

== 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 ''Behavior → Clones → Unlink Clones'' allows the User to disable the automatic unlinking.

== Tools ==

=== 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]''.

=== 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 ===

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 Shift 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 ====

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 to 100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* 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]].
* '''Pressure change for new knot''' (in the global Inkscape preferences, Edit > Preferences > Tools > Pencil): adds a PowerStroke Knot when the stylus pressure changes by this percentage.

''[needs video/gif]''

=== Selection Tool ===

==== On-Canvas Alignment ====

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.

* Shift + click 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 Shift + click objects will be aligned on the vertical axis.
* [Ctrl (+ Shift )... 'treat objects as group' - Fixme]

[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool ===

* [describe new line-height settings]
* [describe new text column mode]
* [describe new flowed text compatibility with other viewers and fallbacks]

==== Variable Font Support ====

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>

==== Support for SVG 2 Text ====

Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating. When creating SVG 2 text, Inkscape will (by default) add fallback support for rendering the text in SVG 1.1 renderers (important as no browsers currently fully support SVG 2 text).

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 'white-space' value to 'pre', 'pre-line', or 'pre-wrap', Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the 'white-space' property value. (Supported by Firefox.)

===== Multi-line text via the CSS 'inline-size' property =====

The CSS property 'inline-size' defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. To set the inline-size one drags the diamond-shaped handle that is located on the text baseline at the end of a line of text. To convert the text back to SVG 1.1 text, Ctrl-click on the diamond (this will result in all the text being placed on a single line).

===== Multi-line text via the CSS 'shape-inside' property =====

The CSS property 'shape-inside' allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS 'shape-subtract', 'shape-margin', and 'shape-padding' properties. To put text inside a shape, select the shape(s) and the text and use the 'Text > Flow into frame' menu entry (after enabling ''Use SVG 2 auto-flowed text'' under the "Tools > Text" section of the Inkscape Preferences dialog). Inkscape will (optionally) insert SVG 1.1 fallback attributes on saving the file.

Multi-line text via the 'shape-inside' 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:

* '''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
* '''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.

In addition to this, the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, display info about the selected effect and to apply it.

<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>

=== Boolean Operations LPE ===

''[The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. It works by adding the LPE to a path, then linking a copied path to it by clicking on the 'link to path' button. That way, two [more?] paths can be combined to a single shape, and both are still editable. Available options:

* union
* symmetric difference
* intersection
* division
* difference
* cut outside
* cut inside
* cut
''] functionality incomplete currently, does not hide linked operand, see https://gitlab.com/inkscape/inkscape/merge_requests/20#note_100799480''

<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

=== BSPline and Spiro ===

Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

=== 'Clone Original' Improvements ===

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]

=== Dash 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 dash 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. Especially technical illustrators 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>

=== Embroidery Stitch LPE ===

This new LPE can add nodes to your paths and create jump stitches, to create data that can be converted for use with a stitching machine.
To view the stitches that you added, activate the 'Show stitches' checkbox, and, if necessary, adjust the 'Show stitch gap' value, so you can see the single stitches.

There are various options for calculating the order of the stitching, for connecting the parts of the drawing and 3 different stitch patterns available. It is suggested to play around with these until you like the result.

For exporting your data, you can, for example, use the HPGL file format and go from there.

<gallery>
File:Embroidery stitch lpe.png|''Inkscape Logo with Embroidery LPE (stitches made visible)''|alt=Inkscape Logo with Embroidery LPE (stitches made visible)
File:Embroidery stitch lpe options.png|''Available options: left: methods to order subpaths, right: methods to connect end points of subpaths''|alt=Options: left: methods to order subpaths, right: methods to connect end points of subpaths
</gallery>

=== 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>

=== 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>

=== Knot LPE ===

New options added:

* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Add stroke width: make the gap wider by adding the width of the stroke to the value for the gap length
* Add bottom (other?) stroke width: make the gap wider by adding the width of the bottom (other?) stroke to the value for the gap length
* Crossing signs: [not final]

=== 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>

=== 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>

=== Path Length LPE ===

This path effect displays the length of the path it is applied to in the selected unit and scale.

=== Power Clip and Power Mask LPE ===

This new LPE adds options to clips and masks.

=== 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 <img> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).

''[ TBC: The dpi value for displaying embedded SVG files can be set in the import 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.

The resolution used for displaying them ''[TBC: can be set per image? can be set in the xxx dialog for the selected image]'' is the default image import resolution set in the preferences' 'Imported Images' section. A change in this option will take effect upon closing and reopening the file, and will affect all linked SVG images in the file.

=== Export PNG images ===

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 16bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of antialiasing 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>

== Extensions ==

=== Extension development ===

* All [[INX Parameters]] now have the common attribute <code>indent="n"</code> where <code>n</code> specifies the level of indentation in the extension UI.

* 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.

* Add <code>appearance="url"</code> for [[INX Parameters]] of type "description". You can now add clickable links to your extension UI.

=== Plot extension ===

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'']

=== Interactive Mockup extension ===

[Please fill in]

=== Hershey Text extension ===

Hershey Text, a utility for replacing text into stroke-based paths, has been rewritten and has several significant changes:

1. Previous versions of Hershey Text provided an input window to type a single line of text, which would be rendered onto your page. The new version instead converts in place all or selected text objects in your document. This means that it is possible to render full paragraphs of text, and to render multiple text objects at one time.

2. Rather than using a fixed historical-format data file for its source fonts, it now uses SVG fonts. This means that:
* It is now possible to add new fonts, and to load them without scripting or changes to the extension.
* Unicode characters are now supported, making it possible to render international and other characters outside of the old ASCII limits.
* Stroke fonts now support arbitrary curves rather than only straight segments.

3. The set of included fonts has been carefully curated. Basic international characters have been added to included fonts.

4. A font-mapping method has been added, such that text objects that have different fonts can be rendered automatically into different stroke fonts, based on their names.

5. A feature has been added to generate font samples in all available SVG fonts

6. An extensive help text file is built into the extension.

7. Hershey Text is now located in the Extensions > Text submenu.

== Palettes ==

* The Munsell palette has been added to Inkscape's set of stock palettes.
* Users can now also drag the 'none' color field from the palette bar at the bottom onto objects to set their color to 'none'.

<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
</gallery>

== Templates ==

* The '''Desktop''' template has new options for 4k, 5k and 8k screens.
* A new template for an A4 3-fold roll flyer was added.

<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. %, mm) 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 %) will be converted to user units when the new values are set.

* [Please fill in]

== Dialogs ==

=== Document Properties ===

* 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.

<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>

=== Filter Editor ===

* The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects ===

The context (right-click) menu now also contains an entry for deleting the selected object.

=== Preferences ===

* 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 <img> 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.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at ''Behaviour → Dashes''. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in Edit > Preferences > Input/Output > Autosave: Autosave directory).
* The '''Keyboard shortcut editor''' now issues a warning when the entered shortcut is already in use.

<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>

=== Symbols ===

* 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>

== Customization ==

=== Customize all files in the share folder ===

All 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, palettes, patterns, 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 ''Tools → Text → Additional font directories'').

<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.

=== 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 file <code>keybindings.rc</code> allows you to... '''(TODO: do what? What does it do in comparison to keys.xml? Seems to not work at all... seems to be ancient. Can be deleted?)'''
* The interface colors and some more UI styles can be customized in <code>style.css</code> (very raw themeing support).

=== Theme selection ===

In 'Edit > Preferences > User Interface > Theme', 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 theme folders can be added to the directory indicated in Edit > Preferences > System : User themes. 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]

=== Icon set selection ===

In 'Edit > Preferences > User Interface > Theme', the icon set to use can be selected. By default, Inkscape comes with 'hicolor' and 'Tango' icons. In addition to this, it offers to use the system icons.

Inkscape also comes with a default symbolic icon set as part of the 'hicolor' icon set. These icons can be colorised with a custom colour.

Changes to the icon set take effect when Inkscape is restarted, or when the entire user interface is reloaded by clicking on the 'Reload icons' button. This rebuilds all Inkscape windows. Rebuild takes a couple of seconds, during which the Inkscape interface will be invisible.

<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
</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 "pages.csv". It is located in your Inkscape user preferences folder, next to your 'preferences.xml' 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 pages.csv file to remove the page sizes you won't use, or to add new ones.

== 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

== 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: --export-inkscape-svg)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: --export-id.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: --pdf-page N).
* For importing a pdf, the option to import via poppler is now available for the command line as 'pdf-poppler'.
* 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])

More information can be found at [[Using the Command Line]].

== Translations [as of 2019-01-08] ==

Translations were updated for:

* Basque
* British English
* Catalan
* Croatian
* Czech
* French
* German
* Hindi
* Hungarian
* Icelandic
* Italian
* Latvian
* Romanian
* Russian
* Slovak
* Spanish
* Turkish
* Ukrainian
* Swedish

The installer was translated to:

* Korean

Tutorial translations were added for:

* Korean

Translations were dropped for:

* Amharic

== Notable Bugfixes ==

* Symbols: Visio Stencils loaded from .vss 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 [TBC: Bug: if minimized, this requires a second click]
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* Improved UI performance of handling large paths and selections:
** Accelerated path break-apart and Boolean operations by disabling intermittent canvas rendering during these operations.
** Accelerated "deselect" speed by improving internal data structure algorithms.
* 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 "perl.exe" to "wperl.exe" 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].

== Known Issues ==

[Please fill in]

== 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.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

Release notes/1.0

2019-06-03T19:38:20Z

Oskay: Add description of new Hershey Text

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

== Inkscape 1.0 ==

'''(definitely not released yet - [[AnnouncePlanning1.0]])'''

== Release highlights ==

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

[Please fill in]

* Theming support
* Origin in top left corner (optional)
* Canvas rotation and mirroring
* On-Canvas alignment of objects
* Better HiDPI screen support
* Control width of PowerStroke with pressure sensitive graphics tablet
* Fillet/chamfer LPE and (lossless) Boolean Operation LPE
* New PNG export options
* Path operations and deselection of a large number of paths are much faster now
* Variable fonts (only if compiled with pango library version >= 1.41.1)

== Important changes ==

=== For users ===

==== Custom Icon Sets ====

Icon sets no longer consist of a single file containing all icons. Instead each icon is allocated it's own file. The directory structure must follow the standard structure for Gnome icons.

If you would like to create or convert your own icon set to the new format, please see the 'hicolor' and 'Tango' icon theme folders, in your Inkscape installation 'share' directory for suitable examples.

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 ====

Third-party extensions need to be updated to work with this version of Inkscape.

==== Import/Export via UniConvertor dropped ====

Extensions that previously used the UniConvertor library for saving/opening various file formats have been removed:

Import formats that have been removed:

* Adobe Illustrator 8.0 and below (UC) (*.ai)
* Corel DRAW Compressed Exchange files (UC) (*.ccx)
* Corel DRAW 7-X4 files (UC) (*.cdr) [cdr imports, but this specific version?]
* Corel DRAW 7-13 template files (UC) (*.cdt)
* Computer Graphics Metafile files (UC) (*.cgm)
* Corel DRAW Presentation Exchange files (UC) (*.cmx)
* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

Export formats that have been removed:

* HP Graphics Language Plot file [AutoCAD] (UC) (*.plt)
* sK1 vector graphics files (UC) (*.sk1)

==== Inline LaTeX formula conversion dropped ====

The [https://www.julienvitard.eu/en/eqtexsvg_en.html EQTeXSVG extension] (Render > LaTeX) that could be used to convert an inline LaTeX equation into SVG paths using Python was dropped, due to its external dependencies.

=== For extension writers ===

''[TBC - not final]''
Extensions have undergone some fundamental changes.
Inkscape's stock extensions have been moved to [https://gitlab.com/inkscape/extensions their own repository] and were updated for compatibility with Python 3. Internally, extensions have been reorganized and many functions have been deprecated.

''[Extension manager? How-to-guide for updating? New API elements? Documentation?]''

Instructions for updating old extensions are available at [[Updating your Extension for 1.0]]

Also note the changed [[#Command Line|command line options]].

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.

=== For packagers and those who compile Inkscape ===

* autotools builds have been dropped. Please use CMake for building Inkscape from now on. More info is available [https://inkscape.org/develop/getting-started/#092-onwards on our website].
* libsoup dependency added: we use libsoup for making http requests without a need for dbus and gvfs.
* double-conversion [https://github.com/google/double-conversion] dependency added: lib2geom now depends on an external version of the library.
* Inkscape now uses a git submodule for the extensions 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])

== General: Application ==

Several small performance improvements in various areas combine to make Inkscape run smoother than before (e.g. MR [https://gitlab.com/inkscape/inkscape/merge_requests/448 #448]).

== General User Interface ==

The user interface has been changed to utilise a more recent version of GTK+. This is the widget toolkit that Inkscape makes use of to draw the user interface on the screen. This new version brings many improvements, especially for users of HiDPI 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, it was a focus point of the [https://inkscape.org/en/news/2018/05/22/2018-boston-inkscape-hackfest/ Boston Hackfest].

=== Window position / size ===

Improvements and fixes to the code for handling/restoring window size and position [https://gitlab.com/inkscape/inkscape/merge_requests/180]
. 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 to our bug tracker.

=== HiDPI ===

Inkscape now supports HiDPI screens.

=== Icons ===
[Please fill in]

=== Y Axis Inversion ===

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 allows the User to optionally set the origin of their 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.

<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 ==

=== Canvas Rotation ===

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 View > Canvas orientation > Flip horizontally / Flip vertically. Keyboard shortcuts for flipping the canvas can be set in the preferences (Edit > Preferences > Interface > Keyboard shortcuts).

[[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]]

== View ==

=== Visible Hairlines Display Mode ===

This new display mode is available under the "View->Display mode" menu. It ensures that all lines are visible, regardless of zoom level, while still drawing everything else normally.

This is especially useful for some CNC machines like laser cutters and vinyl cutters which use hairlines to denote cut lines.

[[File:visible_hairlines.gif]]

=== Center view on page ===

You can now center the view on the page, without changing the zoom level.

This function is available via:

* ''View → Zoom''
* Zoom tool tool controls
* Keyboard shortcut <kbd>[TBD]</kbd>

=== Split View Mode ===

[needs images + text]

== 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 ''Behavior → Clones → Unlink Clones'' allows the User to disable the automatic unlinking.

== Tools ==

=== 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]''.

=== 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 ===

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 Shift 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 ====

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 to 100%). This does not change the number of available pressure levels, but spreads them out in the available line width interval.
* 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]].
* '''Pressure change for new knot''' (in the global Inkscape preferences, Edit > Preferences > Tools > Pencil): adds a PowerStroke Knot when the stylus pressure changes by this percentage.

''[needs video/gif]''

=== Selection Tool ===

==== On-Canvas Alignment ====

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.

* Shift + click 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 Shift + click objects will be aligned on the vertical axis.
* [Ctrl (+ Shift )... 'treat objects as group' - Fixme]

[[File:Align-handles opt.gif|''On-canvas alignment''|alt=On-canvas alignment]]

=== Text Tool ===

* [describe new line-height settings]
* [describe new text column mode]
* [describe new flowed text compatibility with other viewers and fallbacks]

==== Variable Font Support ====

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>

==== Support for SVG 2 Text ====

Inkscape supports SVG 2 text (multi-line and text in a shape), both rendering and creating. When creating SVG 2 text, Inkscape will (by default) add fallback support for rendering the text in SVG 1.1 renderers (important as no browsers currently fully support SVG 2 text).

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 'white-space' value to 'pre', 'pre-line', or 'pre-wrap', Inkscape will respect newlines and generate multi-line text. At the moment, one must use the XML Editor dialog to change the 'white-space' property value. (Supported by Firefox.)

===== Multi-line text via the CSS 'inline-size' property =====

The CSS property 'inline-size' defines the width (height) of a block of horizontal (vertical) text.
Inkscape supports both rendering and generating multi-line text via this property. To set the inline-size one drags the diamond-shaped handle that is located on the text baseline at the end of a line of text. To convert the text back to SVG 1.1 text, Ctrl-click on the diamond (this will result in all the text being placed on a single line).

===== Multi-line text via the CSS 'shape-inside' property =====

The CSS property 'shape-inside' allows placing text inside a shape. Inkscape supports this property in both rendering and creating. Inkscape also supports in rendering the CSS 'shape-subtract', 'shape-margin', and 'shape-padding' properties. To put text inside a shape, select the shape(s) and the text and use the 'Text->Flow into frame' menu entry (after enabling ''Use SVG 2 auto-flowed text'' under the "Tools->Text" section of the Inkscape Preferences dialog). Inkscape will (optionally) insert SVG 1.1 fallback attributes on saving the file.

Multi-line text via the 'shape-inside' 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:

* '''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
* '''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.

In addition to this, the LPE list is now made available as a searchable dialog with an icon for each path effect, and options to favorite, display info about the selected effect and to apply it.

<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>

=== Boolean Operations LPE ===

''[The Boolean Operations LPE finally makes non-destructive boolean operations available in Inkscape. It works by adding the LPE to a path, then linking a copied path to it by clicking on the 'link to path' button. That way, two [more?] paths can be combined to a single shape, and both are still editable. Available options:

* union
* symmetric difference
* intersection
* division
* difference
* cut outside
* cut inside
* cut
''] functionality incomplete currently, does not hide linked operand, see https://gitlab.com/inkscape/inkscape/merge_requests/20#note_100799480''

<gallery>
File:Boolops LPE.png|''Boolean Operations LPE''|alt=Boolean Operations LPE
</gallery>

=== BSPline and Spiro ===

Improvements in Pen/Pencil mode. With "Alt", you can move the previous node.

=== 'Clone Original' Improvements ===

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]

=== Dash 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 dash 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. Especially technical illustrators 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>

=== Embroidery Stitch LPE ===

This new LPE can add nodes to your paths and create jump stitches, to create data that can be converted for use with a stitching machine.
To view the stitches that you added, activate the 'Show stitches' checkbox, and, if necessary, adjust the 'Show stitch gap' value, so you can see the single stitches.

There are various options for calculating the order of the stitching, for connecting the parts of the drawing and 3 different stitch patterns available. It is suggested to play around with these until you like the result.

For exporting your data, you can, for example, use the HPGL file format and go from there.

<gallery>
File:Embroidery stitch lpe.png|''Inkscape Logo with Embroidery LPE (stitches made visible)''|alt=Inkscape Logo with Embroidery LPE (stitches made visible)
File:Embroidery stitch lpe options.png|''Available options: left: methods to order subpaths, right: methods to connect end points of subpaths''|alt=Options: left: methods to order subpaths, right: methods to connect end points of subpaths
</gallery>

=== 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>

=== 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>

=== Knot LPE ===

New options added:

* Inverse: use the stroke width of the other path as basis for calculating the gap length
* Add stroke width: make the gap wider by adding the width of the stroke to the value for the gap length
* Add bottom (other?) stroke width: make the gap wider by adding the width of the bottom (other?) stroke to the value for the gap length
* Crossing signs: [not final]

=== 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>

=== 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>

=== Path Length LPE ===

This path effect displays the length of the path it is applied to in the selected unit and scale.

=== Power Clip and Power Mask LPE ===

This new LPE adds options to clips and masks.

=== 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 <img> tag, or if the objects in the SVG file should be imported into the document (which was how Inkscape handled importing SVG files previously).

''[ TBC: The dpi value for displaying embedded SVG files can be set in the import 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.

The resolution used for displaying them ''[TBC: can be set per image? can be set in the xxx dialog for the selected image]'' is the default image import resolution set in the preferences' 'Imported Images' section. A change in this option will take effect upon closing and reopening the file, and will affect all linked SVG images in the file.

=== Export PNG images ===

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 16bit
* Compression type: choose strength of lossless compression
* pHYs dpi: force-set a dpi value for the image
* Antialiasing: choose type of antialiasing 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>

== Extensions ==

=== Extension development ===

* All [[INX Parameters]] now have the common attribute <code>indent="n"</code> where <code>n</code> specifies the level of indentation in the extension UI.

* 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.

* Add <code>appearance="url"</code> for [[INX Parameters]] of type "description". You can now add clickable links to your extension UI.

=== Plot extension ===

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'']

=== Interactive Mockup extension ===

[Please fill in]

=== Hershey Text extension ===

Hershey Text, a utility for replacing text into stroke-based paths, has been rewritten and has several significant changes:

1. Previous versions of Hershey Text provided an input window to type a single line of text, which would be rendered onto your page. The new version instead converts in place all or selected text objects in your document. This means that it is possible to render full paragraphs of text, and to render multiple text objects at one time.

2. Rather than using a fixed historical-format data file for its source fonts, it now uses SVG fonts. This means that:
* It is now possible to add new fonts, and to load them without scripting or changes to the extension.
* Unicode characters are now supported, making it possible to render international and other characters outside of the old ASCII limits.
* Stroke fonts now support arbitrary curves rather than only straight segments.

3. The set of included fonts has been carefully curated. Basic international characters have been added to included fonts.

4. A font-mapping method has been added, such that text objects that have different fonts can be rendered automatically into different stroke fonts, based on their names.

5. A feature has been added to generate font samples in all available SVG fonts

6. An extensive help text file is built into the extension.

7. Hershey Text is now located in the Extensions > Text submenu.

== Palettes ==

* The Munsell palette has been added to Inkscape's set of stock palettes.
* Users can now also drag the 'none' color field from the palette bar at the bottom onto objects to set their color to 'none'.

<gallery>
File:Munsell palette.png|''Munsell palette''|alt=Munsell palette
</gallery>

== Templates ==

* The '''Desktop''' template has new options for 4k, 5k and 8k screens.
* A new template for an A4 3-fold roll flyer was added.

<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. %, mm) 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 %) will be converted to user units when the new values are set.

* [Please fill in]

== Dialogs ==

=== Document Properties ===

* 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.

<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>

=== Filter Editor ===

* The filter primitives now have a symbolic icon (one whose color can be changed).

=== Objects ===

The context (right-click) menu now also contains an entry for deleting the selected object.

=== Preferences ===

* 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 <img> 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.
* An option for '''scaling a stroke's dash pattern when scaling the stroke width''' has been added and can be found at ''Behaviour → Dashes''. It is activated by default.
* '''Autosave''' is now enabled by default. The default directory has changed (the path is displayed in Edit > Preferences > Input/Output > Autosave: Autosave directory).
* The '''Keyboard shortcut editor''' now issues a warning when the entered shortcut is already in use.

<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>

=== Symbols ===

* 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>

== Customization ==

=== Customize all files in the share folder ===

All 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, palettes, patterns, 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 ''Tools → Text → Additional font directories'').

<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.

=== 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 file <code>keybindings.rc</code> allows you to... '''(TODO: do what? What does it do in comparison to keys.xml? Seems to not work at all... seems to be ancient. Can be deleted?)'''
* The interface colors and some more UI styles can be customized in <code>style.css</code> (very raw themeing support).

=== Theme selection ===

In 'Edit > Preferences > User Interface > Theme', 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 theme folders can be added to the directory indicated in Edit > Preferences > System : User themes. 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]

=== Icon set selection ===

In 'Edit > Preferences > User Interface > Theme', the icon set to use can be selected. By default, Inkscape comes with 'hicolor' and 'Tango' icons. In addition to this, it offers to use the system icons.

Inkscape also comes with a default symbolic icon set as part of the 'hicolor' icon set. These icons can be colorised with a custom colour.

Changes to the icon set take effect when Inkscape is restarted, or when the entire user interface is reloaded by clicking on the 'Reload icons' button. This rebuilds all Inkscape windows. Rebuild takes a couple of seconds, during which the Inkscape interface will be invisible.

<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
</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 "pages.csv". It is located in your Inkscape user preferences folder, next to your 'preferences.xml' 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 pages.csv file to remove the page sizes you won't use, or to add new ones.

== 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

== 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: --export-inkscape-svg)
* Multiple objects in single file can be saved into individual files by giving a comma separated list of objects to the command: --export-id.
* Inkscape can now import a specific page of a PDF file from the command line, for batch processing (new option: --pdf-page N).
* For importing a pdf, the option to import via poppler is now available for the command line as 'pdf-poppler'.
* 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])

More information can be found at [[Using the Command Line]].

== Translations [as of 2019-01-08] ==

Translations were updated for:

* Basque
* British English
* Catalan
* Croatian
* Czech
* French
* German
* Hindi
* Hungarian
* Icelandic
* Italian
* Latvian
* Romanian
* Russian
* Slovak
* Spanish
* Turkish
* Ukrainian
* Swedish

The installer was translated to:

* Korean

Tutorial translations were added for:

* Korean

Translations were dropped for:

* Amharic

== Notable Bugfixes ==

* Symbols: Visio Stencils loaded from .vss 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 [TBC: Bug: if minimized, this requires a second click]
* The icon preview dialog now correctly shows the page background (Bug #[https://bugs.launchpad.net/inkscape/+bug/1537497 1537497]).
* Improved UI performance of handling large paths and selections:
** Accelerated path break-apart and Boolean operations by disabling intermittent canvas rendering during these operations.
** Accelerated "deselect" speed by improving internal data structure algorithms.
* 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 "perl.exe" to "wperl.exe" 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].

== Known Issues ==

[Please fill in]

== 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.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]]