Inkscape Wiki - User contributions [en]

Leadership Committee Status Updates

2022-05-07T02:53:11Z

Nathanal: /* Place and Time */ Change rocketchat url/channel name to leadership_committee

{{DISPLAYTITLE:Project Leadership Committee Status Updates}}

== What Happens ==

These meetings are used for status updates and information on the project to ensure that everyone knows what is going on the various teams and with leadership committee working items. It does not, and can not by charter, include binding votes as those take place on the [https://lists.inkscape.org/postorius/lists/inkscape-board.lists.inkscape.org/ board mailing list].

== Place and Time ==

We meet in #inkscape-plc on [https://libera.chat libera.chat] (or via [https://matrix.to/#/#inkscape-plc:libera.chat Matrix]). You can also join the [https://chat.inkscape.org/channel/leadership_committee #leadership_committee discussion channel on chat.inkscape.org] to partake in the meeting.

These 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=20220506T10&p1=202 10:00 PDT/17:00 UTC/19:00 CEST, (click for world clock)], Fri., May 6, 2022. (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 ==

* SFC Items (ted)
* Student programs (Outreachy, GSoC, etc) (Tav)
* Developer meeting update (Mc)
* Vectors update (ryangorley)
* Infrastructure update (doctormo)
* Administrator job process status (doctormo)
* Current Votes Status
* Next Meeting: April 1, 2022

== Meeting Transcripts ==

=== 2022 ===
* [https://alpha.inkscape.org/board/meetings/transcripts/2022-04-01.log.html 2022-04-01]
* [https://alpha.inkscape.org/board/meetings/transcripts/2022-03-04.log.html 2022-03-04]
* [https://alpha.inkscape.org/board/meetings/transcripts/2022-02-04.log.html 2022-02-04]
* [https://alpha.inkscape.org/board/meetings/transcripts/2022-01-07.log.html 2022-01-07]

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

=== 2020 ===
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-12-04.log.html 2020-12-04]
* [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-09-04.log.html 2020-09-04]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-08-07.log.html 2020-08-07]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-06-05.log.html 2020-06-05]
* [https://alpha.inkscape.org/board/meetings/transcripts/2020-05-01.log.html 2020-05-01]
* [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]'''

Release notes/1.2

2022-02-15T04:02:56Z

Nathanal: /* Dialogs */ Point to right MR (credit: Gwenaël Q.)

{{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 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]]'''
* '''[[#Export Dialog|Redesigned Export dialog with preview and ability to select objects/layers/pages and even multiple file formats to export to]]'''
* '''[[#Snapping|Snap settings redesign]]'''
*[[Release notes/1.2#SVG Font Editor|SVG Font Editor is easier to use]]
*[[Release notes/1.2#Copies|New Live path effect Copies for easy but powerful interactive pattern making]]
* '''[[#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
*Lots of UI fixies and polish
* '''[[#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]]

=== 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 by dragging edge and wraps into multiple columns
* You can customize which tools will be part of the tool bar in the preferences, see [[#Bars_.2F_Toolbars|Customization section]]

=== Command bar ===
We returned zoom commands back to the command bar

=== Context menus ===
Thanks to Tavs work we have more contextual right click menus for some object. ( example: right clicking bitmap offers tracing bitmap and extracting image)

=== 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|823x823px|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.
*Guids have new color

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]

=== Performance ===
Canvas rendering got significate refracturing and should be faster to render while panning and zooming

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

== 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 ==
[[File:Split.gif|thumb|330x330px]]
* 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 /><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]).


== Dialogs ==

[[File:Inkscape PyFNUY7fCi.gif|thumb|455x455px]]

=== 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:Inkscape R6cB6sFN07.gif|center|frame|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, CMS, HSLuv) 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]).
*Color wheel is not separate mode anymore but dropdown(toggle?) above color sliders (HSL, HSV, HSLuv)

==== 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 default 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.[[File:Inkscape yrHv1frJlF.gif|none|frame]]

[[File:Before after caps.png|thumb|339x339px]]

==== 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/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])

=== Swatches ===

The Swatches dialog uses the same improved settings as [[#Color_palette|the color palette]].
[[File:Inkscape GK3kLW1E2O.gif|none|frame]]

=== 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 UI 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.
*3 tabs ( Single scan (colo), Multicolor , Pixel art)
* 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|none|frame]]
[[File:Ezgif.com-gif-maker (24).gif|none|frame]]

=== Transform dialog ===

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

== Filters ==

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

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

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

New Live path effects. 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
*Custom gap controls in X an Y axis, units control and 2 modes :
**Uniform Gaps
**Random gaps
* Offset of every other rows and columns
* 16 different mirroring modes
* Blending modes of scaling (5 modes + mirroring)
**Blend size from top to bottom
**Blend size from Left to Right
**Blend size in Z pattern (top left original bottom right new size)
**Uniform scaling
**Random Scaling
* Blending modes of change (5 modes + mirroring)
**Blend rotation from top to bottom
**Blend rotation from Left to Right
**Blend rotation in Z pattern (top left original bottom right new size)
**Uniform rotation
**Random rotation
* Shrinking of gaps - Useful for transformation blending and currently does not work with rotation
*Custom styling of clones (splitting elements)
**Linking style - Useful for overlapping stacking of objects, gradients and patterns fills

=== Rotate copies ===
new improvements:
*Custom styling of clones
*Linking style (for making gradients and patterns on fills work)

=== Offset ===
We improved performance while dragging knot on canvas

== 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])
*You can resize toolbar so icons are in more them one column by dragging on edge [ this does not get saved after restart :(]
[[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
* <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 ==
Complete as of 2022/02/10.

TODO: If the renaming of extensions for 1.2 goes through, change the names in the text below.

=== Features added ===

==== All extensions ====

* Extension have now better support for documents with CSS styles and inherited styles. This functionality is enabled for all bundled extensions. If you want to use this functionality in an extension you maintain, see [[Updating your Extension for 1.2#New Style API|New Style API]].
*Allow export extensions to 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]).

==== Particular extensions ====

* 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 the color 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 new '''Document > Process Illustrator SVG...''' 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]).
*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 rects, 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, which is more useful in practice than the previous behavior, i.e. inserting after the first selected element.[[File:Modes of the Extrude extension.png|center|thumb|400x400px|The modes of the Extrude extension. A new mode, "Snug", has been added for Inkscape 1.2.]]
* A large portion of the '''DXF Import''' extension has been rewritten to support more DXF features ([https://gitlab.com/inkscape/extensions/-/merge_requests/357 MR extensions#357]).
*The '''Guides Creator''' extension, apart from supporting multi-page documents, now also features an option that suppresses duplicated guides and alternating margins for even and odd pages ([https://gitlab.com/inkscape/extensions/-/merge_requests/424 MR extensions#424]) .
*The '''Motion''' extension now has an option to take the extrude color and opacity from the selected path ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
*The following extensions now adapt to '''multi-page documents''': Document Info ([https://gitlab.com/inkscape/extensions/-/merge_requests/401 MR extensions#401]), Guides creator ([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]).
*The fileformat of '''Synfig Export''' has been updated to > 1.4.0 ([https://gitlab.com/inkscape/extensions/-/merge_requests/299 MR extensions#299]).
*'''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.
* When extensions set an element to "insensitive", this change is honored by Inkscape (see [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. (see [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]).

==== Particular extensions ====

* In the '''Add nodes''' extension, closed paths were previously changed to open paths, and an erroneous node was added ([https://gitlab.com/inkscape/extensions/-/merge_requests/336 MR extensions#336], [https://gitlab.com/inkscape/extensions/-/issues/209 Issue extensions#209]). Other and third-party extension will probably profit from the underlying bugfix as well.
*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]). 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]).
*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 how has a range of 360 ([https://gitlab.com/inkscape/extensions/-/merge_requests/400 MR extensions#400])
*The '''HTML5 Canvas''' export now has 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.
*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]).
*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.
*On Windows, '''PostScript (PS) / EPS import''' 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]).
*In the '''Randomize Colors''', 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]).
*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]).

=== Documentation ===
* 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 errors in the documentation [https://gitlab.com/inkscape/extensions/-/merge_requests/324 MR extensions#324]
=== Behind the curtains ===
* 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]).
*Added Python <code>appdirs</code> dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568]) [Is this a bug fix?]
*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/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])
*The localization of the extensions has been improved ([https://gitlab.com/inkscape/extensions/-/merge_requests/425 MR extensions#425]).
== 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])
* 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].

== Important changes for extension authors ==
''Main Article: [[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.

== 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.
** Inkscape crashes on close, and creates a backup file. Preferences are saved properly.
** Outline overlay mode does not work within page area.

== Other releases ==

{{:Release notes}}

Release notes/1.2

2021-12-20T10:27:15Z

Nathanal: /* Crash fixes */ Remove fix, only affected dev versions

Release notes/1.1.1

2021-09-17T13:39:17Z

Nathanal: /* Known issues */ Added some frequently reported issues.

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* '''Stroke to Path''' works on text again ([https://gitlab.com/inkscape/inkscape/-/issues/2333 Bug #2333])
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Clicking selects objects again on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working on Windows ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … stroke to path applied on paths with no area, fill, stroke, or markers ([https://gitlab.com/inkscape/inkscape/-/issues/2502 Bug #2502], [https://gitlab.com/inkscape/inkscape/-/issues/2572 Bug 2572])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … multiple objects selected for spray tool in single path mode ([https://gitlab.com/inkscape/inkscape/-/issues/2740 #2740])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==
These issues could not be fixed in time for the 1.1.1 release. They also affect Inkscape 1.1, but not earlier versions.
* There are crashes and freezes if the '''Document Properties''' dialog is left open for too long, particularly on Windows ([https://gitlab.com/inkscape/inkscape/-/issues/2700 Bug #2700], [https://gitlab.com/inkscape/inkscape/-/issues/2107 Bug #2107]).
* The '''Export PNG''' dialog's Export As feature may cause a crash or mangle filenames if non-ASCII characters are used ([https://gitlab.com/inkscape/inkscape/-/issues/2548 Bug #2548], [https://gitlab.com/inkscape/inkscape/-/issues/2587 Bug #2587]). The Export button works.
* Multiple paths sharing a '''marker''' will have the wrong color on '''pdf export''' ([https://gitlab.com/inkscape/inkscape/-/issues/2545 Bug #2545]) unless converted to SVG 1.1 style marker. These options are available in the Preferences dialog in the SVG export tab, and requires selecting export as SVG 1.1 per settings in Preferences Dialog in the GTK save dialog.
* Linux users upgrading from 0.92.5 to 1.1.1 on snap will need to manually uninstall then reinstall Inkscape if open or save dialog causes a crash ([https://gitlab.com/inkscape/inkscape/-/issues/2495 Bug #2495]).

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:27:02Z

Nathanal: /* General */ phrasing

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* '''Stroke to Path''' works on text again ([https://gitlab.com/inkscape/inkscape/-/issues/2333 Bug #2333])
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Clicking selects objects again on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working on Windows ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … stroke to path applied on paths with no area, fill, stroke, or markers ([https://gitlab.com/inkscape/inkscape/-/issues/2502 Bug #2502], [https://gitlab.com/inkscape/inkscape/-/issues/2572 Bug 2572])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … multiple objects selected for spray tool in single path mode ([https://gitlab.com/inkscape/inkscape/-/issues/2740 #2740])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:26:10Z

Nathanal: /* General */ Correction about a fix

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* '''Stroke to Path''' works on text again ([https://gitlab.com/inkscape/inkscape/-/issues/2333 Bug #2333])
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Fix selecting objects by clicking on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working on Windows ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … stroke to path applied on paths with no area, fill, stroke, or markers ([https://gitlab.com/inkscape/inkscape/-/issues/2502 Bug #2502], [https://gitlab.com/inkscape/inkscape/-/issues/2572 Bug 2572])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … multiple objects selected for spray tool in single path mode ([https://gitlab.com/inkscape/inkscape/-/issues/2740 #2740])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:25:15Z

Nathanal: /* General */

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* '''Stroke to Path''' works on text again ([https://gitlab.com/inkscape/inkscape/-/issues/2333 Bug #2333])
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Fix selecting objects by clicking on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … stroke to path applied on paths with no area, fill, stroke, or markers ([https://gitlab.com/inkscape/inkscape/-/issues/2502 Bug #2502], [https://gitlab.com/inkscape/inkscape/-/issues/2572 Bug 2572])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … multiple objects selected for spray tool in single path mode ([https://gitlab.com/inkscape/inkscape/-/issues/2740 #2740])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:23:22Z

Nathanal: /* Crash fixes */

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Fix selecting objects by clicking on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … stroke to path applied on paths with no area, fill, stroke, or markers ([https://gitlab.com/inkscape/inkscape/-/issues/2502 Bug #2502], [https://gitlab.com/inkscape/inkscape/-/issues/2572 Bug 2572])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … multiple objects selected for spray tool in single path mode ([https://gitlab.com/inkscape/inkscape/-/issues/2740 #2740])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:19:00Z

Nathanal: /* General */

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])
* Fix selecting objects by clicking on wmii and some other window managers ([https://gitlab.com/inkscape/inkscape/-/issues/2801 Bug #2801])
* Caps lock no longer stops Delete, Page Down and some other shortcut keys from working ([https://gitlab.com/inkscape/inkscape/-/issues/2496 Bug #2496])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T04:01:12Z

Nathanal: /* Extension bug fixes */ Add from Rhubarb MR !3503

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==
* Fix LaTeX extension on Windows ([https://gitlab.com/inkscape/extensions/-/merge_requests/309 MR #309])
* Add __version__ for inkex ([https://gitlab.com/inkscape/extensions/-/merge_requests/360 MR #360], [https://gitlab.com/inkscape/extensions/-/issues/409 Bug #409])

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T03:57:23Z

Nathanal: /* General */ whitespace

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display ([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T03:57:02Z

Nathanal: /* Dialogs */ Add from Rhubarb MR !3503

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])

=== Dialogs ===

* Clicking the resize separator will toggle visibility of docked dialog ([https://gitlab.com/inkscape/inkscape/-/commit/3c868362c242df805257af4be07583ebc63605c1 Commit 3c8683], [https://gitlab.com/inkscape/inbox/-/issues/4676 Bug #4676], [https://gitlab.com/inkscape/inkscape/-/merge_requests/2969 MR #2969])
* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])
* '''Text and Font dialog:''' Font features load in under a second, instead of minutes for fonts with lots of font features. More font feature glyphs shown too ([https://gitlab.com/inkscape/inkscape/-/commit/0dacc4edd2a9f87364977fdbcfec8aaece1fb885 Commit 0dacc4], [https://gitlab.com/inkscape/inkscape/-/merge_requests/3449 MR #3449])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T03:47:30Z

Nathanal: /* Tools */ Measure tool

<languages />

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

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

}}

{{Box| Pending questions:

* https://gitlab.com/inkscape/inkscape/-/merge_requests/3474#note_666486028
}}

<translate>

== Release highlights ==

'''Definitely not released yet.'''

== New Features ==

=== Menus ===

* We've added a link to our donation page in <code>Help → Donate</code>, to make it easier for users to contribute to the project financially ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

== Bug fixes ==

=== General ===

* Thanks to the upstream fix in gtk3, pressure sensitivity works again with Windows Ink activated ([https://gitlab.com/inkscape/inkscape/-/issues/1437 Bug #1437], https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1563) - '''''needs confirmation!'''''
* Undoing '''Stroke to Path''' no longer loses the object's id ([https://gitlab.com/inkscape/inkscape/-/issues/2759 Bug #2759])
* Undoing '''Object to Path''' for an object with a Live Path Effect is now possible without also undoing the preceding action ([https://gitlab.com/inkscape/inkscape/-/issues/1504 Bug #1504])
* Saving no longer leaks memory ([https://gitlab.com/inkscape/inkscape/-/issues/2800 Bug#2800])
* Startup times improved, 3.3 seconds to 3 seconds on one Windows machine ([https://gitlab.com/inkscape/inkscape/-/commit/228b6aec975a1229bfba418fe94e15113d9a5000 Commit 228b6a])
* Hide unnecessary warnings in terminal about optional font directories not being used ([https://gitlab.com/inkscape/inkscape/-/commit/76fb99c9d898730998ac5f4b83f3782cb7fea73b Commit 76fb99])
* Canvas no longer blurred when moving window from HiDPI to a regular display([https://gitlab.com/inkscape/inkscape/-/commit/f7162ba39145ecd5c7c9f6ee2c677a17a808252f Commit f7162b])

=== Dialogs ===

* '''Welcome dialog:'''
** Fixed a '''paper size''' typo ([https://gitlab.com/inkscape/inkscape/-/issues/2570 Bug #2570])
** Renamed some confusing '''device size names''' ([https://gitlab.com/inkscape/inkscape/-/issues/2514 Bug #2570])
** Removed an '''unnecessary warning''' when choosing the keyboard shortcuts set ([https://gitlab.com/inkscape/inkscape/-/issues/2529 Bug #2529])
* '''Transform dialog:''' Matrix tab no longer stubbornly insists on using display units instead of the units the user selected ([https://gitlab.com/inkscape/inkscape/-/issues/2429 Bug #2429])

=== Filters ===

* '''Fast crop:''' Transparency is now respected when applying the <code>Filters → Fill and Transparency → Fast Crop</code> filter ([https://gitlab.com/inkscape/inkscape/-/issues/2419 Bug #2419])

=== Import ===

* '''EPS:''' Users that have installed Inkscape in the snap packaging format can open EPS files again ([https://gitlab.com/inkscape/inkscape/-/issues/1406 Bug #1406])

=== Export ===

* '''Optimized SVG:''' <code>Save as → Optimized SVG</code> works again in Linux AppImage ([https://gitlab.com/inkscape/inkscape/-/issues/1738 Bug #1738])

=== Markers ===

* '''Start / end markers:''' A bug was fixed where the path tip protruded over the arrow marker's end ([https://gitlab.com/inkscape/inkscape/-/issues/2593 Bug #2593]).

=== Menus ===

* '''Help menu:''' Now using a different set of web links to link to the documentation from the Help menu ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3325 MR #3325])

=== Packaging ===
* '''Snap''' remembers user preferences even when the home directory is not available to the snap. This may occur in LDAP, SSSD, or other set ups where there is a modified nsswitch.conf and NSCD is not acting as a proxy to snaps. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3474 MR #3474])
* '''Build fixes:'''
** Building Inkscape works again on systems with '''musl libc''' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3410 MR #3410])
** Building Inkscape works again on '''NetBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/1029bbe3beadef5176a0226685e66f9f1af03626 Commit 1029bb], [https://gitlab.com/inkscape/inkscape/-/commit/bfb81a613c4b39f6e7b0d0fbb57337fdc61c2451 Commit bfb81a], [https://gitlab.com/inkscape/inkscape/-/commit/160dc740c66c72e8c739f053cc46f438e2109909 Commit 160dc7], [https://gitlab.com/inkscape/inkscape/-/commit/e12966cc7b55451bfc60850288c8e9be1d4c30d1 Commit e12966])
** Building Inkscape works again on '''FreeBSD''' ([https://gitlab.com/inkscape/inkscape/-/commit/06b1437e39fd7855dee1b9fa305f35c39f8ab23a Commit 06b143])
** Building Inkscape works again with '''GCC 7''' ([https://gitlab.com/inkscape/inkscape/-/commit/3d8be5380836d07b047c961b2db8e8d4cde9c1a6 Commit 3d8be5])

=== Templates ===

* All templates generated from the 'Welcome' dialog now use a document scale of 1, making it easier to hand-edit documents created using them ([https://gitlab.com/inkscape/inkscape/-/issues/2728 Bug #2728])

=== Tools ===

* '''Measure tool:'''
** Settings for font size and precision for the Measure tool work again ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3343 MR #3343])
** Position dialog moves handles to the right place again ([https://gitlab.com/inkscape/inkscape/-/commit/1fcc335a93f0a2598494255f4a0a99b8d77b7506 Commit 1fcc33])
** Measurements no longer reset on right click or tool switch ([https://gitlab.com/inkscape/inkscape/-/commit/bd93492913653248609fea3fce00d575a4adcd3c Commit bd9349], [https://gitlab.com/inkscape/inkscape/-/commit/341a0ec6d2ff502724c4ce818a3f6ce36e507ee6 Commit 341a0e])

== Crash fixes ==

Fixed a crash when …

* … using a grid with the Document Properties dialog open on Windows. This also fixes a memory leak on other operating systems, that did not necessarily lead to a crash. ([https://gitlab.com/inkscape/inkscape/-/issues/2585 Bug #2585])
* … trying to copy an object without ID ([https://gitlab.com/inkscape/inkscape/-/issues/2714 Bug #2714])
* … entering a space character in the 'Attributes' field of the 'Clone Original' LPE settings dialog ([https://gitlab.com/inkscape/inkscape/-/issues/1709 Bug #1709])
* … closing a window while the filter editer dialog is floating and a filter is selected ([https://gitlab.com/inkscape/inkscape/-/issues/2753 Bug #2753])
* … pasting 3D boxes when the 3D box tool is active ([https://gitlab.com/inkscape/inkscape/-/issues/2741 Bug #2741])
* … quitting in command line or when opening windows if done before window fully loads ([https://gitlab.com/inkscape/inkscape/-/issues/2776 Bug #2776], [https://gitlab.com/inkscape/inkscape/-/issues/2487 Bug #2487])
* … Homebrew or MacPorts used and XDG_DATA_DIRS is not defined ([https://gitlab.com/inkscape/inkscape/-/commit/1a6c62001881fbbf1a971309433e8f80c48dafc5 Commit 1a6c62])

== Extension bug fixes ==

== Translations ==

The following UI translations received updates:

* Brazilian Portuguese
* Catalan
* Czech
* Polish
* Russian
* Slovenian
* Traditional Chinese
* Simplified Chinese

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

== Known issues ==

== Other releases ==

{{:Release notes}}
</translate>

Release notes/1.1.1

2021-09-15T03:42:02Z

Nathanal: /* General */ Add from Rhubarb MR !3503

Release notes/1.1.1

2021-09-15T03:32:30Z

Nathanal: /* Crash fixes */ add some from rhubarb MR !3503

Release notes/1.1.1

2021-09-15T03:20:42Z

Nathanal: /* Packaging */ Add FreeBSD from Rhubarb

Release notes/1.1.1

2021-09-15T03:16:28Z

Nathanal: /* Packaging */ Add from Rhubarb !3503

Release notes/1.1.1

2021-09-15T03:05:56Z

Nathanal: /* Translations */ Add Simplified Chinese to list

Release notes/1.1.1

2021-09-12T06:10:19Z

Nathanal: /* Packaging */ Snap: add !3474, user preferences always written.

Release notes/1.1.1

2021-09-04T07:37:49Z

Nathanal: /* General */ Minor correction about bug that was fixed

Extensions: INX widgets and parameters

2021-05-08T01:57:10Z

Nathanal: /* Parameters */ Add mandatory attribute to example (gitlab inbox#4614)

This page contains the reference documentation for INX widgets and parameters. Their primary goal is to make it easy to design GUIs for [[Extension subsystem|Inkscape Extensions]] using the built-in [[INX extension descriptor format]], although (invisible) parameters can also be used for extensions that don't need to show a user interface.

== 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>{{added_in|1.0}}
* <code>hbox</code>{{added_in|1.0}}/<code>vbox</code>{{added_in|1.0}}
* <code>separator</code>{{added_in|1.0}}/<code>spacer</code>{{added_in|1.0}}
* <code>image</code>{{added_in|1.0}}
* <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>{{added_in|1.0}}
* <code>int</code>
* <code>float</code>
* <code>string</code>
* <code>path</code>{{added_in|1.0}}
* <code>optiongroup</code>
* <code>notebook</code>
* <code>color</code>

If a parameter is made invisible (see <code>gui-hidden</code> attribute in the [[#Common attributes|next section]]) it will not be shown in the GUI but it's value is still passed to an extension. This is useful if you want to hardcode parameter value the user should not be able to change. If all parameters (and potential widgets) are invisible, Inkscape will not show a GUI and execute the extension immediately instead, but will still pass the values of the invisible parameters.

== 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 [[#Parameters|Parameters]] below.
|- style="vertical-align:top;"
| style="white-space:nowrap" | <code>gui-text</code>
| ''(text)''
| -
| required ''(visible parameters)'',<br/>optional ''(hidden parameters + <code>notebook</code>s)''
| 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.
|-
|}

== Widgets ==

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

|+ Parameter reference

|-
! Type
! Description / Code
! Result

|-
! hbox/vbox
|Creates a container for other widgets. No visual rendering but provides a possibility to align and layout other widgets. Child widgets are either added in horizontal (<code>hbox</code>) or vertical (<code>vbox</code>) direction.

<source lang="xml">
<hbox>…</hbox>
<vbox>…</vbox>
</source>

A box can contain an arbitrary number of other widgets and parameters (including other boxes) to fine-tune the layout of the GUI.

''Note: When you start with an empty extension GUI, you're basically starting with a <code>vbox</code>. Also <code>notebook</code> pages behave like vertically oriented boxes.

|
[[File:INX_sample-separators.png]]

|-
! image
|Creates a widget displaying an image. The content of the <code><image></code> node specifies the path of the image file (ideally specify a path relative to the .inx file itself).

<source lang="xml">
<image>path/to/image.svg</image>
</source>

By default the image will be rendered at it's actual size. Use attributes <code>width/heigth</code> to override the default size (in this case ''both'' attributes need to be supplied; units are pixels).

''Implementation note: Loadable image formats are determined by GdkPixbuf and therefore system-specific. PNG should always work and is the safe choice. SVG should mostly work and is the preferred choice for obvious reasons.''

|
[[File:INX_sample-image.png]]

|-
! label
|Creates a widget showing text. The content of the <code><label></code> node corresponds to the text content that will be rendered.

<source lang="xml">
<label>Some text here.</label>
</source>

''Note: Labels are intended to provide additional information / help. For labeling parameters use the <code>gui-text</code> attribute; for short help texts that are specific to a single parameter prefer <code>gui-description</code> which will render as a tooltip.''

* When setting the attribute <code>appearance="header"</code> the text is styled as a heading and can be used as another possibility to group parameters.
* When setting the attribute <code>appearance="url"</code> the text is rendered as a clickable link.<br/>''Note: The text is escaped and used as the link target as-is. Creating a link text that differs from the URL is prevented for security reasons.''
* When setting the attribute <code>xml:space="preserve"</code> any white-space (spaces, tabs, line-breaks, etc.) in the label will be preserved, allowing to format the label accordingly. By default all leading/tailing and intermediary whitespace is collapsed into a single space character.

|
[[File:INX_sample-labels.png|frame|none|Different label types (in order):<ul><li>default</li><li><code>appearance="header"</code></li><li><code>appearance="url"</code></li><li><code>xml:space="preserve"</code></li></ul>]]

|-
! separator
|Creates a separator for visual separation of other widgets. Renders as a horizontal/vertical line.

<source lang="xml">
<separator />
</source>

The direction of the separator will automatically adjust depending on direction of the current container (vertical for "empty" extension GUIs and <code>notebook</code> pages; vertical/horizontal for <code>vbox</code> and <code>hbox</code> respectively).
|
[[File:INX_sample-separators.png]]

|-
! spacer
|Creates a spacer for visual separation of other widgets. No visual rendering but provides variable spacing.

<source lang="xml">
<spacer />
</source>

The direction of the spacer will automatically adjust depending on direction of the current container (vertical for "empty" extension GUIs and <code>notebook</code> pages; vertical/horizontal for <code>vbox</code> and <code>hbox</code> respectively).

Use the <code>size</code> attribute to set the spacing in pixels (default: <code>size="10"</code>). The special value <code>expand</code> results in a spacer that grows dynamically and always uses up as much space as possible (useful for aligning content).

|
[[File:INX_sample-spacers.png|frame|none|Different spacer types:<ol><li>default</li><li><code>size="20"</code></li><li><code>size="expand"</code></li></ol>]]

|}

== Parameters ==

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

|+ Parameter reference

|-
! Type
! Description / Code
! Result

|-
! bool{{added_in|1.0}}
|Creates a checkbox to set a '''boolean value'''. Allowed values are <code>true</code> or <code>false</code> (default value: <code>true</code>).

<source lang="xml">
<param name="name" type="boolean" gui-text="Some label text">false</param>
</source>

|[[File:INX_sample-boolean.png]]

|-
! color
|Creates a control to select an '''RGBA color value'''. Values should be given in hexadecimal notation, e.g. <code>0xff0000ff</code> for red with full opacity (default value: <code>0x000000ff</code>)

<source lang="xml">
<param name="name" type="color" gui-text="Some label text">0x000000ff</param>
</source>

Use <code>appearance="colorbutton"</code> for a simple button that opens a simplified color picker. Otherwise a full ColorNotebook will be rendered.

''Implementation note: colors values are internally treated as 32-bit unsigned integers (<code>unsigned long</code>). Acceptable default values include everything the standard library function [https://en.cppreference.com/w/cpp/string/byte/strtoul <code>strtoul</code>] understands{{added_in|1.0}}. Earlier Inkscape version only handled decimal numbers. The value passed to the extension script will also be a decimal number.''

|
[[File:INX_sample-color.png|frame|none|default]]

[[File:INX color-btn.png|frame|none|<code>appearance="colorbutton"</code>]]

|-
! float
|Creates a 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. (defaults: <code>min="0"</code>, <code>max="10"</code> and <code>precision="1"</code>; default value: 0)

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

Use the attribute <code>appearance="full"</code> to create a slider with which the value can be adjusted dynamically over the full range.

|
[[File:INX_sample-float.png|frame|none|default]]

[[File:INX_sample-float_full.png|frame|none|<code>appearance="full"</code>]]

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

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

Use the attribute <code>appearance="full"</code> to create a slider with which the value can be adjusted dynamically over the full range.

|
[[File:INX_sample-int.png|frame|none|default]]

[[File:INX_sample-int_full.png|frame|none|<code>appearance="full"</code>]]

|-
! 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 Widgets and Parameters. Individual pages are created with the <code><page></code> element.

The '''returned value''' for <code>notebook</code> parameters is the value of the <code>name</code> attribute of the selected <code><page></code>. By default the first page is selected.

<source lang="xml">
<param name="name" type="notebook">
<page name="page_1" gui-text="First page">
…
</page>
<page name="page_2" gui-text="Second page">
…
</page>
</param>
</source>

|[[File:INX_sample-notebook.png]]

|-
! optiongroup
|Creates a control that allows to select one option '''one option''' from a set of multiple choices. The different choices are created with <code><option></code> elements.

The '''returned value''' for <code>optiongroup</code> type parameters is the value of the <code>value</code> attribute of the selected <code><option></code>. By default the first <code><option></code> is selected.

<source lang="xml">
<param name="name" type="optiongroup" appearance="radio/combo"
gui-text="Some label text">
<option value="1">First option</option>
<option value="2">Second option</option>
</param>
</source>

Set the attribute <code>appearance="radio"</code>{{added_in|1.0}} to render radio buttons (default). Set the attribute <code>appearance="combo"</code>{{added_in|1.0}} to display a drop-down list instead.<br>
|
[[File:INX_sample-optiongroup.png|frame|none|<code>appearance="radio"</code>]]

[[File:INX_sample-optiongroup-minimal.png|frame|none|<code>appearance="combo"</code>]]

|-
! path{{added_in|1.0}}
|Creates a control to choose a '''path'''. Paths can either be entered manually or by using the file chooser that can be opened using the ellipsis button.

The <code>mode</code> attribute allows to set behavior of the file chooser (i.e. if files or folders can be selected, if they need to exist previously and if multiple selections are possible). The <code>filetypes</code> attribute holds a comma-separated list of file extensions and restricts the selectable file types in file picker mode.

<source lang="xml">
<param type="path" name="varname" gui-text="label" mode="$mode" [filetypes="$filetypes"]/>
</source>

Possible values for the <code>mode</code> attribute:
* <code>file</code> - select a single existing file
* <code>files</code> - select multiple existing files
* <code>folder</code> - select a single existing folder
* <code>folders</code> - select multiple existing folders
* <code>file_new</code> - select a single new file name
* <code>file_new</code> - select a single new folder name

''Implementation note: Existence of paths are not checked before passing them to the extension, so extension authors need to implement suitable error handling, especially in case of manual path entry. For multiple selections the individual paths are joined using the pipe character ("|") and passed to the extension as a single string.''

|[[File:INX path.png]]

|-
! string
|Creates a input to enter a '''string'''. Limit the number of characters the user is allowed to enter with the <code>max-length</code> attribute. (defaults: no character limit; default value: empty string)

<source lang="xml">
<param name="name" type="string" gui-text="Some text label">Some default text</param>
</source>

Set the attribute <code>appearance="multiline"</code>{{added_in|1.0}} to render a multi-line input. Line-breaks will be encoded as literal <code>\n</code> in the value passed to the extension.

|
[[File:INX_sample-string.png|frame|none|<ul><li>default (top)</li><li><code>appearance="multiline"</code> (bottom)</li></ul>]]

|}

== Translation of widgets and parameters ==



== Deprecated Functionality ==

These widgets and parameters have been deprecated and should not be used anymore. Extension authors are encouraged to update their existing extensions wherever possible. Documentation is kept for authors that need to make their extensions backwards-compatible but please be aware that deprecated functionality '''''will''''' be removed eventually and without further notice.

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

|+ Deprecated Parameters

|-
! Type
! Description / Code
! Result

|-
! boolean{{deprecated_in|1.0}}
|'''Replace with <code><param type="bool" …/></code> parameter.'''

Creates a checkbox to set a '''boolean value'''. Allowed values are <code>true</code> or <code>false</code> (default value: <code>true</code>).

<source lang="xml">
<param name="name" type="boolean" gui-text="Some label text">false</param>
</source>

|[[File:INX_sample-boolean.png]]

|-
! description{{deprecated_in|1.0}}
|'''Replace with <code><label>…</label></code> widget.'''

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.

<source lang="xml">
<param name="name" type="description">Some text here.</param>
</source>

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.
<source lang="xml"><param name="name" type="description" appearance="header">Header</param></source>

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{{deprecated_in|1.0}}
|'''Replace with <code><optiongroup appearance="combo" …></code> parameter.'''

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

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

|}

=== Other deprecations ===

* Parameters of type <code>optiongroup</code>:
:* <code>appearance="minimal"</code>{{deprecated_in|1.0}}

=== Deprecated localization functionality of parameters{{deprecated_in|1.0}} ===

To mark parameters to be included into the translation files variants of all relevant attributes and tag names existed that started with an underscore.

While the underscored variants are still accepted for backwards-compatibility, translations are handled differently since Inkscape 1.0, which solved a number of limitations of the prior implementation, while also making the INX specification significantly cleaner. See [[Translation of widgets and parameters]] for details.



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

Release notes/1.0.1

2021-02-28T00:26:00Z

Nathanal: Add commit info per gitlab.com/inkscape/inbox/-/issues/3707

<languages />

<translate>

== About this release == 



'''Released on September 7, 2020'''


Inkscape 1.0.1 is mainly a stability and bugfix release. It also comes with a few new features that hadn't been stable enough to make it into Inkscape 1.0.

== New Features == 

=== Color-managed PDF export using Scribus <span id="scribus_pdf"></span>=== 


An experimental Scribus PDF export extension has been added. It is available as one of the many export formats in the 'Save as' and 'Save a Copy' dialogs. ([https://gitlab.com/inkscape/extensions/-/commit/b74fccbc64b4ae6e3b15a840b25e21f5f3aeea31 Commit])


To be able to get a correct and color-managed CMYK PDF file with text converted to curves that corresponds to your drawing in Inkscape, you must:


* have Scribus '''1.5.x''' installed (and the Scribus executable must not be called scribus-ng)
* the <code>scribus</code> command must be available on your command line (on Windows, you need to '''add it to the Path''' in your Windows settings)
* have enabled color management for your document by selecting '''one''' color profile in File > Document settings > Color and clicking on the '''+ (Plus)''' icon.
* assign all colors in the document with the color managed color selector in the Fill and Stroke dialog
* not use filters in your drawing (this includes blur)
* not use any transparency if you're exporting to PDF/X-1, PDF/X-3 or PDF 1.3
* not include any bitmap images
* not use markers
* not use any other SVG features that are not supported by Scribus


The page size corresponds to the document size in Scribus. When you add a bleed, an area of the given width outside the page area in Inkscape will be included in the PDF file.


Please test the extension, and always carefully check the result before you send it to a print service. You can leave your feedback about what works / doesn't work at https://inkscape.org/inbox.

=== Selectors and CSS dialog unhidden === 


<img src="https://media.inkscape.org/media/resources/file/Peek_2020-08-24_23-46.gif" style="width:30%;max-width:400px;float:right;" alt="Selectors and CSS dialog usage example" />

The '''Selectors and CSS dialog''' that had been [[Release notes/1.0#Selectors_and_CSS_.5BExperimental.2C_hidden.5D|hidden and labelled as 'experimental' in Inkscape 1.0]] is now available from the '''Object''' menu.


The dialog makes it possible to add, remove and edit CSS properties that are saved within an element's 'style' attribute, as well as styling objects in the document using CSS classes and other CSS selectors. These additional styles are written into a style tag in the SVG document.


It can also be used to select all objects that belong to a specific class, so users will again be able to create collections of objects that are independend of the document structure (e.g. they belong to different groups in the drawing).


This dialog '''replaces the Selection Sets dialog''' that had been removed for Inkscape 1.0.

=== List all Colors in a document === 


A new extension '''Color > List All''' lists all colors used in a document and indicates how often they are used ([https://gitlab.com/inkscape/extensions/-/commit/a0b150e1ab050dde2fb0ae7dc11c275015dbac36 Commit])

=== Interpolate gradients === 


The '''Interpolate extension''' now also interpolates gradients in fills and in strokes (before, it could only interpolate flat colors) and named colors ([https://gitlab.com/inkscape/extensions/-/commit/7862b2085603054fdfd682ffce9d8467ecec300a Commit]).

=== New preferences option to limit screen tearing while editing === 


In ''Edit > Preferences > Rendering: Redraw while editing'', users can choose between the two options 'Responsive' and 'Conservative' to determine how quickly the canvas display is updated while editing objects. The default value is 'Responsive', which gives rendering a higher priority than it had previously and makes editing objects feel less sluggish ([https://gitlab.com/inkscape/inkscape/-/commit/d5625130f7e0ed0343cdd473829ef46ceeed8e0b Commit])

=== Other small improvements === 


* Users can now define an ID for QR code groups rendered by the '''Render Barcode extension''' ([https://gitlab.com/inkscape/extensions/-/commit/761029d1b8bec4287b052cd5ecdd41bb00c62866 Commit])
* Extensions now understand what to do with the '''CSS unit Q''' (1/40th of a cm) ([https://gitlab.com/inkscape/extensions/-/commit/6c38c129874b98350430c9d4752861361b527e2e Commit])

== Crash fixes == 


Fix a crash …
* … when applying Offset LPE to groups ([https://gitlab.com/inkscape/inkscape/-/commit/fc8557d167454e15c42a1dfbc9edd1088d7ff711 Commit])
* … when closing Inkscape while the filter editor dialog is open ([https://gitlab.com/inkscape/inkscape/-/commit/08c7ad69a7bbf6c9a9b865e5b33b4cf1d6c3dc6f Commit])
* … with some cursor themes that do not contain an upward arrow cursor ([https://gitlab.com/inkscape/inkscape/-/commit/e6d8ec3f2ac6a7d3a6156fb6a7626573ded1c7d4 Commit])
* … when the file to open does not exist ([https://gitlab.com/inkscape/inkscape/-/commit/ddde047e4613f347f521cb7fef8a394118dac541 Commit])
* … when resizing a document with a grid, when the document properties dialog is closed ([https://gitlab.com/inkscape/inkscape/-/commit/d6d20de3afa48401bcd364dcb75a62729ea6775a Commit])
* … when opening a malformed pdf where the selected page does not exist ([https://gitlab.com/inkscape/inkscape/-/commit/6603a35c658c082353803f1bd847132d08abb8b7 Commit])
* … when creating a clone of / opening a file with a symbol from an object with a CSS style ([https://gitlab.com/inkscape/inkscape/-/commit/fbf97ecb4be963f7068533f5e9d5d2e1d4fe68be Commit])
* … when exporting an object identified by its ID to SVG from the command line ([https://gitlab.com/inkscape/inkscape/-/commit/8dfe6ae35fafd1d8e7b6ede85ed27f5bee7cd8b2 Commit])
* … when using the dropper tool a lot ([https://gitlab.com/inkscape/inkscape/-/commit/38d22c431c37ed4cc007ed3e56224bd375066bae Commit])
* … when trying to open Inkscape's stock filters file with the Inkscape flatpak version ([https://gitlab.com/inkscape/inkscape/-/commit/0a2d2ccf9e0b92acde8b6c2f747cbf44d0356c70 Commit])

== Other Bug fixes == 

=== Packaging === 


* '''AppImage''' now comes with '''Python 3.8''' ([https://gitlab.com/inkscape/inkscape/-/commit/30324570d9a1a931595c23b842c5b02b925f6382 Commit])
* '''Snap''' now uses the system's font cache and thus '''finds all installed fonts''' ([https://gitlab.com/inkscape/inkscape/-/commit/cfa4a1c0e6b3342f3db91d2095fa5ff9e510ff09 Commit]). Additionally, it can now make use of '''extensions with custom user interfaces''' (e.g. InkStitch) ([https://gitlab.com/inkscape/inkscape/-/commit/c78d3668209e2f34de2c3090622ab1d026d6724b Commit])

=== Canvas === 


* The '''zoom correction factor''' no longer depends on the display unit, so correction works properly for documents that are not in mm ([https://gitlab.com/inkscape/inkscape/-/commit/4eaebb0e07718776d555d36853ee6172c04f3a45 Commit])

=== Dialogs === 


* The '''document properties dialog''' can now be resized even if one is using display scaling on a hidpi screen on Linux

=== Rendering === 


* '''Zooming''' no longer causes artifacts when there is a path with an arc segment with a radius of 0 in the drawing ([https://gitlab.com/inkscape/inkscape/-/commit/a3831f969bdeb75f4760e7f886600dab8474af81 Commit])

=== Tools === 


* '''3D-box tool:'''
** Keyboard shortcuts for changing angles in the 3D-box tool were adjusted to work as documented, even with the Y-axis inverted ([https://gitlab.com/inkscape/inkscape/-/commit/dfaa5a5516ca222c0a5aedefa3f50e72604693f0 Commit])
* '''Circle tool:'''
** Duplicated circles are now closed properly ([https://gitlab.com/inkscape/inkscape/-/commit/426423ae71a9ff0fc9cb38dbe29c70436f027f76 Commit])
* '''Eraser tool:'''
** The mass value field is no longer greyed out and can be used ([https://gitlab.com/inkscape/inkscape/-/commit/5df58fb0ac0ff0e0c76a131be5d0aecfc6af9dd1 Commit])
* '''Gradient tool:'''
** Simplifying selected gradient stops with Ctrl+L works now ([https://gitlab.com/inkscape/inkscape/-/commit/ccf16d938cfdacabb02fb52312137ef5edf2b66d Commit])
* '''Node tool:'''
** Path > Reverse now works on subpaths again ([https://gitlab.com/inkscape/inkscape/-/commit/3c1c44f1a4ddb5b1bc98e4b9b9997c87a749b1fe Commit])
* '''Pencil tool:'''
** The 'flatten simplify (LPE)' button now only shows up when it can be used ([https://gitlab.com/inkscape/inkscape/-/commit/a98ffa63dd6cec59203ad4fc4481d42f502c915d Commit])
* '''Selector tool:'''
** Keyboard shortcuts with Alt key for rotating objects also work as documented again with the Y-axis inversion ([https://gitlab.com/inkscape/inkscape/-/commit/dfaa5a5516ca222c0a5aedefa3f50e72604693f0 Commit])
** Objects no longer seemingly jump or scale up when moving multiple of them with snapping turned on ([https://gitlab.com/inkscape/inkscape/-/commit/1f3f8bd44a755f2cdba219e124e6d3afe41ed87d Commit])
** Default snap delay was set to 0 so snapping will work more precisely ([https://gitlab.com/inkscape/inkscape/-/commit/7cf01540cb0fe5f31df6c2e4dd33355738fada2a Commit])
* '''Text tool:'''
** Line height doesn't change spontaneously when switching tools while having text selected ([https://gitlab.com/inkscape/inkscape/-/commit/cf1ac8caed1244e59daa8fe54ef70b48f4307b0f Commit])

=== Import / Export / Save === 


* when saving as '''PDF / PS / EPS + LaTeX''', <code>%</code> signs are now properly escaped ([https://gitlab.com/inkscape/inkscape/-/commit/ba98d85aecab6b57a385ea981726415aebad5d47 Commit])
* the dpi value for '''exporting to PNG''' can be specified as a decimal number again
* '''attribute order''' is no longer reversed when saving as SVG, so comparing two SVG files is easier now ([https://gitlab.com/inkscape/inkscape/-/commit/376a40c06f867168ee28ef083e67b8064d792f96 Commit])

=== Masking / Clipping === 


* When '''releasing or undoing a mask''', objects will no longer become unselectable and will use their own bounding box ([https://gitlab.com/inkscape/inkscape/-/commit/5799d73f4421bfa74106d18a2465937c69acb20b Commit])

=== Live Path Effects === 
<img src="https://media.inkscape.org/media/resources/file/Clone_LPE.gif" style="width:30%;max-width:400px;float:right;" alt="Clone Original LPE usage example"/>
* '''LPE selection dialog''' looks better now with some desktop themes ([https://gitlab.com/inkscape/inkscape/-/commit/cf1ac8caed1244e59daa8fe54ef70b48f4307b0f Commit])
*  '''Clone original LPE''' items now get the cloned or linked item's style by default instead of starting with a black fill. A regression that made it impossible to use text elements as source was fixed. Transforms (moving, stretching, shearing) are handled correctly now. ([https://gitlab.com/inkscape/inkscape/-/commit/046ab13d2aef838a4a7ddf4c04408f5ae49c7e8b Commit])
* '''Fill between many''': option 'fuse coincident points' has been replaced with good defaults ([https://gitlab.com/inkscape/inkscape/-/commit/b02872e1324ccf0a2e4b145a87d0e107025e3b63 Commit])
* The '''Knot LPE''' allows to switch the direction of self-crossings ([https://gitlab.com/inkscape/inkscape/-/commit/1881450511cb068cd53f1b02fe3d2e8b8a0defd1 Commit])
* When using the '''PowerStroke LPE''' with the join type 'extrapolated arc', the corners no longer have a dent, but are smooth again ([https://gitlab.com/inkscape/inkscape/-/commit/5933861e52e079dee4efc85531731b0cc4af07d2 Commit])
* '''Roughen LPE''' now works more reliably ([https://gitlab.com/inkscape/inkscape/-/commit/4fa58e650d436e1c98b8b081975ff927db12c732 Commit])
* Inkscape no longer becomes unresponsive when selecting an object that is used for the '''Pattern-Along-Path LPE''' ([https://gitlab.com/inkscape/inkscape/-/commit/fceeb28d06a1e15c0260e8ee89284d1e81136c06 Commit])

=== Performance === 


* Inkscape no longer becomes unresponsive when opening a document '''with lots of style tags''' in it ([https://gitlab.com/inkscape/inkscape/-/commit/078c825d76dee0bffb5619f2ef6384e61801bc20 Commit])

=== Extensions === 

==== General ==== 


* Relative paths to '''linked images''' no longer break when using an extension ([https://gitlab.com/inkscape/inkscape/-/commit/0fee34477bbf248d07c3396fe966fd6334dcca25 Commit])
* Path elements are now '''transformed correctly''' when applying transformation matrices to them ([https://gitlab.com/inkscape/extensions/-/commit/fb416f7c811d19baad3e445d47085516e2e99efa Commit])
* '''Text element coordinates''' are now interpreted correctly, even if they use a different unit than px ([https://gitlab.com/inkscape/extensions/-/commit/5a15053be85a9eafa49bc4c296fa7657409f94c3 Commit]) and their (guessed) bounding boxes now consider transforms
* Extensions that adjust '''colors''' now work on groups again ([https://gitlab.com/inkscape/extensions/-/commit/311b017fe056f948d6da14171092dc14d01a3ce0 Commit])

==== Specific extensions ==== 


* '''Plot extension''' and '''HPGL Output extension''' no longer have an option to automatically convert objects to path, this is now always done (except for texts) ([https://gitlab.com/inkscape/extensions/-/commit/fb10061fa393e18b125f4694204cc3ef05f93a8e Commit]).
* When switching plotter pens using the '''HPGL output extension''', the plotter no longer makes a dot with the new pen at the end of the old pen's line ([https://gitlab.com/inkscape/extensions/-/commit/801867667550083f86acf285e4dfdc153a0a1bc1 Commit]). The extension now works with multiple pens (marked by their layer name in Inkscape) again ([https://gitlab.com/inkscape/extensions/-/commit/60abf8059b18420e3735457af253566688ebb13e Commit]).
* The '''Interpolate extension''' now works with the tutorial files again ([https://gitlab.com/inkscape/extensions/-/commit/5a2fd158e237f3de3cc4ad3b5b02524271127fc2 Commit]).
* The extension '''Render > Barcode > Datamatrix''' now renders 64 x 64 datamatrices correctly ([https://gitlab.com/inkscape/extensions/-/commit/c3f2cd1409e48782961514b2313536634ec33055 Commit]).
* Rendering a '''3D Polyhedron''' no longer gives deprecation warnings ([https://gitlab.com/inkscape/extensions/-/commit/bc7f8779972c599d6f5fa9eba2e160ebfc3b2dfc#3f2b8a83a71ce2e508e1ac143af87e1d498be817 Commit]).
* The '''Measure Path extension''' now also works when the Help tab is open when clicking on Apply ([https://gitlab.com/inkscape/extensions/-/commit/cc7c37b18cf968b7042f97a6d51610a9e6110ef5 Commit]
* '''Color > Randomize extension''' now works correctly for the Hue and Lightness parameters
* The unnecessary Live preview was removed from the '''Interactive Mockup extension''' ([https://gitlab.com/inkscape/extensions/-/commit/1e560830fa8eebc32fbc28d5d5545fde0006c484 Commit])
* The '''Perspective / Envelope''' extension now considers transforms ([https://gitlab.com/inkscape/extensions/-/commit/1d27a0e2e23663973347f6f543ee3f8433fed0fb Commit]).
* The '''Hershey text extension''' fonts now contain letters needed to plot in Danish ([https://gitlab.com/inkscape/extensions/-/commit/f8fbd22819a5d58cb82a82c7f9dff8fc16b7001b Commit]). Additionally, the extension can now better handle line heights ([https://gitlab.com/inkscape/extensions/-/commit/9244cc722fb168351ea01e799b555024644c1164 Commit]).

==== Extension failure fixes ==== 


Fix a failure …


* … when exporting a document with unknown SVG tags to '''HTML5 canvas''' ([https://gitlab.com/inkscape/extensions/-/commit/9d44f6b9ce1cab2250ad854a736dbcfb58046653 Commit])
* … when trying to access a document '''node with an unknown tag''' ([https://gitlab.com/inkscape/extensions/-/commit/05cfe7f2e336a1efb95f77f1db725c6a974d3a8f Commit])
* … when trying to '''import a dxf file''' with a circle / ellipse ([https://gitlab.com/inkscape/extensions/-/commit/958c70509fe5e520aa063d33d28330ea33451ccd Commit])
* … when using the '''Perfect Bound Cover extension''' ([https://gitlab.com/inkscape/extensions/-/commit/d8750d09c454c742a1bb6a5f3470690e544e89c1 Commit])
* … when using the '''Mesh Gradient to Path extension''' ([https://gitlab.com/inkscape/extensions/-/issues/216 Commit])
* … when using the '''JessyInk''' extension ([https://gitlab.com/inkscape/extensions/-/commit/2cba7c3f718133aeb6db14442662a54618d4e835 Commit]).
* … when using the '''DPI Switcher extension''' ([https://gitlab.com/inkscape/extensions/-/commit/ca718bbe91131252cf6a2dccbe2c717e7bdb705a Commit])

==== Extension API changes / Improvements for Extension Developers ==== 


* '''Shape objects''' now have an <code>is_visible</code> method ([https://gitlab.com/inkscape/extensions/-/commit/3e10fece0acc07bc33462ca474f0fc6418c7d552 Commit])
* '''Documentation''' extended and improved ([https://gitlab.com/inkscape/extensions/-/commit/050be97eed47a303cb823f46e2febb7e2196b989 Commit], []https://gitlab.com/inkscape/extensions/-/commit/9b21776f7c3d746911dac7305b8e1f2a08e38b70 Commit], [https://gitlab.com/inkscape/extensions/-/commit/639bb6914c7f44771c33f0031718c777504ca2a1 Commit], [https://gitlab.com/inkscape/extensions/-/commit/fe0efe3f2c3f2dccbbf365ff5f0270d89dc645e3 Commit])
* Use an underscore in front of the <code>name</code> attribute value to mark things that do not need to be available in the .py file ([https://gitlab.com/inkscape/extensions/-/commit/cc7c37b18cf968b7042f97a6d51610a9e6110ef5 Commit])
* '''Shape coordinates''' are now reported in user units ([https://gitlab.com/inkscape/extensions/-/commit/768ba690dd3e3eb303d94cb27874dac60cffb064 Commit])
* <code>inkex.addNS()</code> is no longer required, attributes like <code>inkscape:groupmode</code> can now be used directly, too ([https://gitlab.com/inkscape/extensions/-/commit/6b956b31602f77e9d4be250f4f431c7c264bd21b Commit])
* added method <code>getElementByName()</code> to '''get an object by Inkscape label''' ([https://gitlab.com/inkscape/extensions/-/commit/d45bb4e90071ee89efea84cf683281b5b0e55bcc Commit])
* added method <code>getElementsByClass()</code> to '''get objects by their class name''' ([https://gitlab.com/inkscape/extensions/-/commit/cc0399aad1c0e7916060e9d03f3da39c99688169 Commit])
* added '''method to create Star shapes''' ([https://gitlab.com/inkscape/extensions/-/commit/4af033bd814373d897590b7dc22e0f5f111d7695 Commit])


'''Upcoming deprecations''' (1.1 will issue a warning, while both the old and the new version will just work in 1.0.1):
* See https://gitlab.com/inkscape/extensions/-/commit/4838d285b01106d243399e6bf36e7956a291eb98

=== Filters === 


* Changes to '''filter region handles''' are now saved to the file ([https://gitlab.com/inkscape/inkscape/-/commit/229008a1649745b73c4f7914acd224c4433997d7 Commit])

=== Templates === 


* The same file can now be used to create '''multiple template files''' ([https://gitlab.com/inkscape/inkscape/-/commit/38f1695101cf73205f32d423e0edf139cbfe9895 Commit])

=== Markers === 


* Custom markers are now no longer cut off when viewed in a web browser ([https://gitlab.com/inkscape/inkscape/-/commit/4fa77f4b6592a6026e48242474edc14d4447f8c9 Commit])

=== Color management === 


* When using color management, the '''color selector works again''' ([https://gitlab.com/inkscape/inkscape/-/commit/cc76837b24d518d1dca5822a0921570a9b928a19 Commit])

=== Command line === 


* the pre-1.0 options <code>--export-[type]=</code>, <code>--file=</code> and <code>--without-gui=</code> now have a fallback and print out a warning ([https://gitlab.com/inkscape/inkscape/-/commit/3ca6a4ed08405f2a530a9ed3065f77443f9f7ebe Commit])
* when converting a '''pdf to svg''' on the command line, the poppler text import method no longer changes randomly ([https://gitlab.com/inkscape/inkscape/-/commit/db5145555e343663e706f6006fd46d2fa0917101 Commit])
* opening files with '''Windows drive paths''' (with colons) works again ([https://gitlab.com/inkscape/inkscape/-/commit/fa303fb79ca6e4f6444005f0a4e3b916f3c7503f Commit])
* '''background color''' is now exported to PNG when using <code>--export-background</code> even when <code>--export-background-opacity</code> is not set explicitly ([https://gitlab.com/inkscape/inkscape/-/commit/6e8a6fa690483f5e75efbf9d1b3208524285103b Commit])
* the tab key can now be used to automatically complete Inkscape command line commands in a Linux terminal (bash completion) ([https://gitlab.com/inkscape/inkscape/-/commit/aa96949a632f0cf759be88a3388e4c52b62b1dab Commit])
* in command line arguments, "0" and "1" had been inverted. They now mean the correct thing (0 = False, 1 = True) ([https://gitlab.com/inkscape/inkscape/-/commit/18639f5dede747dd3b08463c935c86db50ad24c5 Commit])

== 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/groups/inkscape/-/milestones/4 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.0.x commit history] (all changes since DATE until release date).

== Translations == 


The following '''user interface translations''' received updates:


* Catalan
* Chinese
* Croatian
* Czech
* Dutch
* German
* Hungarian
* Icelandic
* Italian
* Japanese
* Russian
* Spanish
* Ukrainian


The following '''documentation''' translations received updates:


* Catalan
* Croatian
* French
* German

=== Contributing to translations === 


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

== Documentation == 


* A few keyboard shortcuts and examples were fixed / updated

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

== Known issues == 


* The performance issues on macOS persist.
* Many of Inkscape's old bug reports still need to be [https://alpha.inkscape.org/bug-migration/ tested and migrated to the new bug and feature request reporting page]. While some progress has already been made, we still need your help with that task.
* All (migrated and new) open issues for the project are listed on [https://gitlab.com/groups/inkscape/-/issues GitLab]. If you have some time on your hands and can help fixing them, [https://chat.inkscape.org/channel/team_devel join us in the development chat] and let us tackle them together.

== Previous releases == 


* [[Release notes/1.0]]
* [[Release notes/0.92]] ([[Release_notes/0.92.1 |0.92.1]], [[Release_notes/0.92.2 |0.92.2]], [[Release_notes/0.92.3 |0.92.3]], [[Release_notes/0.92.4 |0.92.4]], [[Release_notes/0.92.5 |0.92.5]])
* [[Release notes/0.91]]
* [[Release notes/0.48]] ([[Release notes/0.48.1 |0.48.1]], [[Release notes/0.48.2 | 0.48.2]], [[Release notes/0.48.3 | 0.48.3]], [[Release notes/0.48.4 | 0.48.4]], [[Release notes/0.48.5 | 0.48.5]])
* [[Release notes/0.47]]
* [[Release notes/0.46]]
* [[Release notes/0.45]]
* [[Release notes/0.44]]
* [[Release notes/0.43]]
* [[Release notes/0.42]]
* [[Release notes/0.41]]
* [[Release notes/0.40]]
* [[Release notes/0.39]]
* [[Release notes/0.38]]
* [[Release notes/0.37]]
* [[Release notes/0.36]]
* [[Release notes/0.35]]

</translate>

SVG with javascript

2021-01-06T08:04:19Z

Nathanal: Fix linkrot pointed out by Yash Pal Goyal

In this tutorial I will explain how you can create SVG files in Inkscape and add javascript code to it so that you can have use it as a vectorial webpage with interactivity. Several browsers support SVG natively (Internet Explorer doesn't).

If you want to see an example of this technology try this: [https://web.archive.org/web/20150604155148/https://felipesanches.googlecode.com/svn/trunk/SVG/minigames/TuxVsMSNbug/minigame.svg TuxVsMSNbug minigame (Web Archive)] I will focus on the techniques I used to develop this game.

First thing you should do is to create the art in Inkscape. In my case, I have drawn the handheld console and all of the sprites that appear in the grey LCD display.

Then you should select portions of the drawing which you want to control using javascript, group it and give it an id attribute. To group you use Ctrl+G (or menu option Object->Group), and to set a value for the id attribute you use ctrl+shift+O, which opens the object properties dialog. This can also be opened by right clicking over the selection and choosing "object properties".

To ungroup you can select Object->ungroup or use shift+ctrl+G

In my handheld game I have flashing lights. These lights are soft grey when off and dark grey when on. I could have used a single drawing and set its fill-color using javascript, but I prefered to have 2 copies of the sprite (one exactly over the other) and then hiding the top one when the sprite is unlit. Changing colour wouldnt be hard in the handheld example, but it definetly would in this other example of flashing lights: http://bighead.poli.usp.br/~juca/code/svg/pinball/PARTY-land.svg where sprites have different colors and even some sprites have more than a single color.

So, I select one sprite, paint it in soft grey, duplicate it with ctrl+D, paint the duplicated sprite in dark grey, set a value to its id attribute with ctrl+shift+O (let's suppose I give it id="my_light") then I group both copies of the sprite so that I can keep stuff organized and easily manageable. I repeat this procedure to all sprites that I have in my SVG.

After that, we need to add javascript code to the SVG. Script code goes in the <script> tag. We open the svg file in a text editor and add:

<script xlink:href="myscript.js" />

and we also need to add onload="on_load(evt);" to the <svg> tag. This means that after the browser loads, it will call a javascript function called on_load.

Then we create the myscript.js file. It will contain the javascript code that will manipulate our SVG drawing in the browser.

I suggest that you use this as an initial javascript code:

var svgDocument;

function on_load(evt){
O=evt.target;
svgDocument=O.ownerDocument;
}

function turn_on(id){
svgDocument.getElementById(id).setAttribute("visibility","visible");
}

function turn_off(id){
svgDocument.getElementById(id).setAttribute("visibility","hidden");
}

in the on_load function you could hook some callbacks to click events so you could do suff like:

//this goes inside on_load(evt) function!
svgDocument.getElementById("button").onclick = user_clicked_my_button;

and declare a function which would be called when the user clicks the svg group which has id="button":

function user_clicked_my_button(){
//when user clicks this button we turn on the light which has id="my_light"
turn_on("my_light");
}

Inkscape for Adobe Illustrator users

2020-09-17T13:58:09Z

Nathanal: /* To Save Files in Inkscape for Use with Adobe Illustrator and vice versa */ Fix broken link anchor

With Inkscape an artist can create most of the same illustrations that can be made with Adobe Illustrator. However, many of the functions and tools that the two applications share are used in different ways, with different names, shortcuts, and approaches. Please add to this document any relevant information on Inkscape/Illustrator parallels, constrasts, hits, and misses.

=Formats=

Illustrator can import Inkscape SVG and export SVG which Inkscape usually opens without problems (there's [https://inkscape.org/learn/faq/#inkscape-edits-svg-file-which-was-originally-created-adobe-illustrator-are-lost-when-importing-back-ai one issue to be aware of]). Conversely, Inkscape opens Adobe's AI (since version 9) and PDF files (with some limitations: gradient meshes are approximated by lattices of small paths, and transparency modes don't work). Inkscape can also export its documents as PDF.

=To Save Files in Inkscape for Use with Adobe Illustrator and vice versa=


Earlier versions of Inkscape (up to 0.46) supported export to the .ai file format. This required the installation of Ghostscript, and didn't always work well. Since version 10, AI can import SVG directly, so this detour is no longer necessary and support for it has been removed from Inkscape.

As Inkscape has one incompatible feature, flowed text, you need to convert all flowed text to normal text using Text -> Convert to text, before you save to SVG (or to 'Plain SVG', if you don't need to edit the file with Inkscape again).

If you export an SVG file from AI, edit it in Inkscape, and then open it again with AI, you may notice that your changes to the file seem lost. This is because AI saves the picture twice inside the SVG file: once as real SVG, for SVG viewers to use, and once in AI's own, binary format, which AI uses when it opens the file. Inkscape only changes the 'real' SVG code, and AI does not notice these changes, as it only looks at the binary contents when that exists. You need to delete that from the file manually, before you use it with AI again, or when exporting from AI, uncheck "Preserve Adobe Illustrator Editing" and "Optimize for Adobe SVG viewer" (see [https://inkscape.org/learn/faq/#inkscape-edits-svg-file-which-was-originally-created-adobe-illustrator-are-lost-when-importing-back-ai FAQ]).

= Terminology =

*'''Anchor Points''': in Inkscape, anchor points are known as "Nodes"
*'''Palettes''': in Inkscape, "palettes" are called "dialogs", such as the Fill and Stroke dialog.
*'''Marquee''': this is called "the rubberband" when selecting
*'''Tools''': see [[AdobeToolMap]] for complete tool equivalency reference.

= Things Illustrator can do that Inkscape cannot do: =

* Gradient meshes
* Multiple strokes and fills for one object
* Color management for print (ICC Profiles, etc.)
* PMS color
* Natively work with graphs based on data
* Free transform and perspective transform (only via extension)
* Blends (only via extension)

= Things Inkscape can do that Illustrator cannot: =

* Edit SVG source directly
* Clones, tiled clones, edit clones on canvas
* Keys to move/rotate/scale by screen pixels
* Shapes as objects
* Edit gradients with handles on-canvas (CS4 added this feature)
* Edit nodes with keyboard
* One-click paint bucket fill
* Color painting over objects (CS4 added this feature with the name ''Blob brush'')

= Hand Tool : Navigating the Canvas =

Instead of using the Spacebar for panning around a document, in Inkscape an artist can press and hold the middle mouse button (or mouse wheel) and drag the canvas in any direction. Alternatively, rotate mouse wheel to pan vertically, rotate with shift to pan horizontally. In Inkscape, the artist can also pan around the canvas by holding the Ctrl and pressing the arrow keys. Holding the arrow key speeds up the pan in that direction.

In 0.46, it is possible to set up Space to work as in Illustrator: even though there's no Hand tool, holding Space and dragging canvas will work if you turn on this mode in Inkscape Preferences (Scrolling tab).

= Zooming : Plus and Minus Keys =

Instead of holding down the Ctrl key and pressing + or - to zoom the canvas, in Inkscape the artist simply presses the + or - key to zoom.

= Selector and Nodes Tool =

In order to select objects with the rubberband in Inkscape, an artist must completely select the entire area of the object, not just select over part of it, to include it in the selection.

Individual nodes of paths can be selected with the Node tool rubberband, the same as in Illustrator; however the object must be selected first, and only the nodes from one object (which may combine several subpaths) can be selected. Unlike Illustrator, nodes from multiple uncombined objects cannot be selected at the same time (as of 0.46).

You can also use touch selection in Selector tool: draw over objects with Alt and, when you release, objects which you touched will be selected.

= Group Select =

In Inkscape there is no special group select tool. To select an individual object in a group of objects, hold the Ctrl key and click on the object with the Selector.

Or you can right-click the group and do "Enter group" after which objects in the group can be selected as if they are not grouped.

Many tools (such as Node tool, Tweak tool, shape tools) simply ignore grouping and allow you to click-select any object regardless of whether it is grouped or not.

= Rotate & Skew : The Second Click =

Inkscape does not have special skew or rotate tools. Instead, with the Selector tool, click on an object to select it, then click on it again to change the handles to Rotate and Skew handles. Dragging the corner handles will rotate and dragging the middle handles will skew.

= Fill and Stroke dialog =

Since fill and stroke are not a tool, they do no appear on the Toolbox, as is the case in Adobe Illustrator. Instead there is a Fill and Stroke window, activated through the Fill and Stroke icon on the Commands bar, or through the Menu, or by Ctrl+Shift+F.

= Styles : Cut and Paste =

There's no palette of stored styles yet. However you can copy style from one object to another: select the source object, do Edit > Copy (Ctrl+C), select the destination object, do Edit > Paste Style (Ctrl+Shift+V). These copied styles are not linked to the original as they are in Illustrator.

= Symbols vs Cloning =

Inkscape is capable of creating "clones" of objects, which are similar to Illustrator's Symbols. When you edit the original, the changes are propagated to all of its clones. Clones can be transformed, but their nodes cannot be edited. Clones can themselves be cloned. You can use the Edit > Tile clones command to create patterns and arrangements of clones.

= Proportional Scaling and Center Point : Shift and Control Keys =

In Inkscape, the keys to maintain proportions while scaling, and to center on point are reversed. To scale objects proportionally in Inkscape, press and hold the Ctrl key, and to use the center point for scaling, hold the Shift key.

= Palettes =

Inkscape calls its palettes "dialogs". They can be called up by various commands through which the artist communicates with the program. Dialogs function similarly to palettes. Dialogs can be free-floating or docked in the document window. You can toggle visibility of all active dialogs with F12 key.

= Working with Nodes (Anchor Points) and Paths =

Editing paths post drawing is done with the Node tool, N key. Selecting nodes is done by clicking on them, by Tab/Shift+Tab keys, or by the rubberband around several nodes. To deselect nodes, press Esc or click in an empty space. While in the node tool, you can also select a different object by clicking on it, after which its nodes become selectable.

To continue a path, select its endnode and duplicate it (Shift+D), then drag the new node. You can break the path at any selected node(s), or join two end nodes, using the correspondint toolbar buttons. You can edit the nodes of only one path object at a time, but that path object may consist of any number of distinct subpaths. Use the Break Apart and Combine commands to break a path into its subpaths and combine separate paths into a single path.

To convert a straight path segment to a curve, select both endnodes of the segment and press the "Make selected segments curves" button on the toolbar. Conversely, you can convert a segment from a curve to a straight line with the "Make selected segments lines" button.

== Inkscape's node editing advantages ==

# The node appearance changes according to the kind of node it is. When a corner node is converted to a smooth node, it changes from a diamond shape to a square. Thus, without a particular node selected it is still possible to tell what kind of node it is.
# Inkscape can restrain node movement to the handle vector or to the adjacent straight line segment (dragging node with Ctrl+Alt).
# Inkscape can lock the handle length (dragging handle with Alt).
# You can move nodes, rotate handles, scale handles, and move selection from one node to the next using keyboard shortcuts. For moves, scales, and rotates, use Alt to move by one screen pixel.

= Editing Shapes =

Shape objects created with the shapes tools (i.e., Rectangle, 3D Box, Ellipse, Star, Spiral) can be immediately edited in the same tool which created them. Each kind of shape has its own handles which you can drag, possibly with keyboard modifiers, to achieve various effects (such as rounding corners of a rectangle). There are also various numeric fields in the controls bars of the shape tools. Consult the Shapes tutorial (in Help menu) for details on Inkscape shapes. Overall, shapes in Inkscape are more rich and flexible than in Illustrator.

You can also convert any shape to path, to be able to edit its nodes freely. Select the object with the Selector or Nodes tool, and then select Path>Object To Path (Shift+Ctrl+C) or if the Nodes Tool Controls bar is visible, click on the Object To Path command icon.

= Pathfinder =

Inkscape calls Pathfinder operations "boolean operations" on paths.

= Layers =

Inkscape's layers are accessible as a drop-down menu in the Status bar, with the lock and visibility toggles beside it affecting the current layer. An artist can select the layer from the list, and then select its visibility and lock status. Alternatively, use the Layers dialog (Ctrl+Shift+L).

Previews are not shown. Objects are moved from one layer to another by means of a key command (Shift+PgUp / Shift+PgDn.)

Layers can nest, and you can enter a group making it a temporary layer.

= Text: Create Outlines =

Converting a text object to outlines (i.e. to path) in Inkscape by Ctrl+Shift+C produces a single path object. If you want to manipulate each letter separately, you can break this path into subpaths (Path>Break Apart, Shift+Ctrl+K) and, for letters with holes, reselect parts of each letter and recombine them (Path>Combine, Ctrl+K) to fix the holes.

= Text Boxes =

In Text tool, when you click on the canvas, you created simple (non-flowed, i.e. not wrapping) text. If you click a drag, you create a text box (called "flowed text") where text will wrap automatically. You can also flow text into an arbitrary shape by the 'Flow into Frame' command under the 'Text' menu.

= Guides =

Guides can be hidden (or shown again) in Inkscape with the Shift+| key combination. The | symbol (called a pipe) is generally paired with the backslash character on the keyboard. Ctrl+; does not do anything in Inkscape.

A guide cannot be selected by drawing a rubberband through it, as is done in Illustrator. Rather, to move or delete a guide the artist must use the Selector to grab the guide and move it to another location or to the ruler.

Guides cannot be locked, and guides are global to the layers instead of bound to individual layers as they are in Illustrator. Double clicking a guide will open a dialog where you can set the guide position precisely.

= Gradients =

Unlike Inkscape, an object with gradient applied always displays the gradient line with all the stops, right on canvas, where you can drag the stops, color them, etc. No need to redraw the gradient anew if you want to slightly change direction.

= Warp, Twirl, Pucker, Bloat, etc. =

These Illustrator tools are analogous to the various modes of Inkscape's Tweak tool.

= Brushes =

There's no brushes palette in Inkscape yet, but you can have an editable path with any brush path applied. Select the brush path (called pattern), copy it to clipboard, then select the path you will apply brush to (called skeleton), open Path Effects (Ctrl+Shift+7), select "Path along path", click Apply, select "Single, stretched", and click the Paste button to apply the pattern.

=See also=

[[IllustratorUsers]] is an old version of this document preserving the discussions

[[Category:User Documentation]]

Inkscape for Adobe Illustrator users

2020-09-17T13:56:28Z

Nathanal: /* Formats */ Update broken link

With Inkscape an artist can create most of the same illustrations that can be made with Adobe Illustrator. However, many of the functions and tools that the two applications share are used in different ways, with different names, shortcuts, and approaches. Please add to this document any relevant information on Inkscape/Illustrator parallels, constrasts, hits, and misses.

=Formats=

Illustrator can import Inkscape SVG and export SVG which Inkscape usually opens without problems (there's [https://inkscape.org/learn/faq/#inkscape-edits-svg-file-which-was-originally-created-adobe-illustrator-are-lost-when-importing-back-ai one issue to be aware of]). Conversely, Inkscape opens Adobe's AI (since version 9) and PDF files (with some limitations: gradient meshes are approximated by lattices of small paths, and transparency modes don't work). Inkscape can also export its documents as PDF.

=To Save Files in Inkscape for Use with Adobe Illustrator and vice versa=


Earlier versions of Inkscape (up to 0.46) supported export to the .ai file format. This required the installation of Ghostscript, and didn't always work well. Since version 10, AI can import SVG directly, so this detour is no longer necessary and support for it has been removed from Inkscape.

As Inkscape has one incompatible feature, flowed text, you need to convert all flowed text to normal text using Text -> Convert to text, before you save to SVG (or to 'Plain SVG', if you don't need to edit the file with Inkscape again).

If you export an SVG file from AI, edit it in Inkscape, and then open it again with AI, you may notice that your changes to the file seem lost. This is because AI saves the picture twice inside the SVG file: once as real SVG, for SVG viewers to use, and once in AI's own, binary format, which AI uses when it opens the file. Inkscape only changes the 'real' SVG code, and AI does not notice these changes, as it only looks at the binary contents when that exists. You need to delete that from the file manually, before you use it with AI again, or when exporting from AI, uncheck "Preserve Adobe Illustrator Editing" and "Optimize for Adobe SVG viewer" (see [https://inkscape.org/en/learn/faq/#Inkscape_edits_to_an_SVG_file,_which_was_originally_created_in_Adobe_Illustrator,_are_lost_when_importing_back_into_AI FAQ]).

= Terminology =

*'''Anchor Points''': in Inkscape, anchor points are known as "Nodes"
*'''Palettes''': in Inkscape, "palettes" are called "dialogs", such as the Fill and Stroke dialog.
*'''Marquee''': this is called "the rubberband" when selecting
*'''Tools''': see [[AdobeToolMap]] for complete tool equivalency reference.

= Things Illustrator can do that Inkscape cannot do: =

* Gradient meshes
* Multiple strokes and fills for one object
* Color management for print (ICC Profiles, etc.)
* PMS color
* Natively work with graphs based on data
* Free transform and perspective transform (only via extension)
* Blends (only via extension)

= Things Inkscape can do that Illustrator cannot: =

* Edit SVG source directly
* Clones, tiled clones, edit clones on canvas
* Keys to move/rotate/scale by screen pixels
* Shapes as objects
* Edit gradients with handles on-canvas (CS4 added this feature)
* Edit nodes with keyboard
* One-click paint bucket fill
* Color painting over objects (CS4 added this feature with the name ''Blob brush'')

= Hand Tool : Navigating the Canvas =

Instead of using the Spacebar for panning around a document, in Inkscape an artist can press and hold the middle mouse button (or mouse wheel) and drag the canvas in any direction. Alternatively, rotate mouse wheel to pan vertically, rotate with shift to pan horizontally. In Inkscape, the artist can also pan around the canvas by holding the Ctrl and pressing the arrow keys. Holding the arrow key speeds up the pan in that direction.

In 0.46, it is possible to set up Space to work as in Illustrator: even though there's no Hand tool, holding Space and dragging canvas will work if you turn on this mode in Inkscape Preferences (Scrolling tab).

= Zooming : Plus and Minus Keys =

Instead of holding down the Ctrl key and pressing + or - to zoom the canvas, in Inkscape the artist simply presses the + or - key to zoom.

= Selector and Nodes Tool =

In order to select objects with the rubberband in Inkscape, an artist must completely select the entire area of the object, not just select over part of it, to include it in the selection.

Individual nodes of paths can be selected with the Node tool rubberband, the same as in Illustrator; however the object must be selected first, and only the nodes from one object (which may combine several subpaths) can be selected. Unlike Illustrator, nodes from multiple uncombined objects cannot be selected at the same time (as of 0.46).

You can also use touch selection in Selector tool: draw over objects with Alt and, when you release, objects which you touched will be selected.

= Group Select =

In Inkscape there is no special group select tool. To select an individual object in a group of objects, hold the Ctrl key and click on the object with the Selector.

Or you can right-click the group and do "Enter group" after which objects in the group can be selected as if they are not grouped.

Many tools (such as Node tool, Tweak tool, shape tools) simply ignore grouping and allow you to click-select any object regardless of whether it is grouped or not.

= Rotate & Skew : The Second Click =

Inkscape does not have special skew or rotate tools. Instead, with the Selector tool, click on an object to select it, then click on it again to change the handles to Rotate and Skew handles. Dragging the corner handles will rotate and dragging the middle handles will skew.

= Fill and Stroke dialog =

Since fill and stroke are not a tool, they do no appear on the Toolbox, as is the case in Adobe Illustrator. Instead there is a Fill and Stroke window, activated through the Fill and Stroke icon on the Commands bar, or through the Menu, or by Ctrl+Shift+F.

= Styles : Cut and Paste =

There's no palette of stored styles yet. However you can copy style from one object to another: select the source object, do Edit > Copy (Ctrl+C), select the destination object, do Edit > Paste Style (Ctrl+Shift+V). These copied styles are not linked to the original as they are in Illustrator.

= Symbols vs Cloning =

Inkscape is capable of creating "clones" of objects, which are similar to Illustrator's Symbols. When you edit the original, the changes are propagated to all of its clones. Clones can be transformed, but their nodes cannot be edited. Clones can themselves be cloned. You can use the Edit > Tile clones command to create patterns and arrangements of clones.

= Proportional Scaling and Center Point : Shift and Control Keys =

In Inkscape, the keys to maintain proportions while scaling, and to center on point are reversed. To scale objects proportionally in Inkscape, press and hold the Ctrl key, and to use the center point for scaling, hold the Shift key.

= Palettes =

Inkscape calls its palettes "dialogs". They can be called up by various commands through which the artist communicates with the program. Dialogs function similarly to palettes. Dialogs can be free-floating or docked in the document window. You can toggle visibility of all active dialogs with F12 key.

= Working with Nodes (Anchor Points) and Paths =

Editing paths post drawing is done with the Node tool, N key. Selecting nodes is done by clicking on them, by Tab/Shift+Tab keys, or by the rubberband around several nodes. To deselect nodes, press Esc or click in an empty space. While in the node tool, you can also select a different object by clicking on it, after which its nodes become selectable.

To continue a path, select its endnode and duplicate it (Shift+D), then drag the new node. You can break the path at any selected node(s), or join two end nodes, using the correspondint toolbar buttons. You can edit the nodes of only one path object at a time, but that path object may consist of any number of distinct subpaths. Use the Break Apart and Combine commands to break a path into its subpaths and combine separate paths into a single path.

To convert a straight path segment to a curve, select both endnodes of the segment and press the "Make selected segments curves" button on the toolbar. Conversely, you can convert a segment from a curve to a straight line with the "Make selected segments lines" button.

== Inkscape's node editing advantages ==

# The node appearance changes according to the kind of node it is. When a corner node is converted to a smooth node, it changes from a diamond shape to a square. Thus, without a particular node selected it is still possible to tell what kind of node it is.
# Inkscape can restrain node movement to the handle vector or to the adjacent straight line segment (dragging node with Ctrl+Alt).
# Inkscape can lock the handle length (dragging handle with Alt).
# You can move nodes, rotate handles, scale handles, and move selection from one node to the next using keyboard shortcuts. For moves, scales, and rotates, use Alt to move by one screen pixel.

= Editing Shapes =

Shape objects created with the shapes tools (i.e., Rectangle, 3D Box, Ellipse, Star, Spiral) can be immediately edited in the same tool which created them. Each kind of shape has its own handles which you can drag, possibly with keyboard modifiers, to achieve various effects (such as rounding corners of a rectangle). There are also various numeric fields in the controls bars of the shape tools. Consult the Shapes tutorial (in Help menu) for details on Inkscape shapes. Overall, shapes in Inkscape are more rich and flexible than in Illustrator.

You can also convert any shape to path, to be able to edit its nodes freely. Select the object with the Selector or Nodes tool, and then select Path>Object To Path (Shift+Ctrl+C) or if the Nodes Tool Controls bar is visible, click on the Object To Path command icon.

= Pathfinder =

Inkscape calls Pathfinder operations "boolean operations" on paths.

= Layers =

Inkscape's layers are accessible as a drop-down menu in the Status bar, with the lock and visibility toggles beside it affecting the current layer. An artist can select the layer from the list, and then select its visibility and lock status. Alternatively, use the Layers dialog (Ctrl+Shift+L).

Previews are not shown. Objects are moved from one layer to another by means of a key command (Shift+PgUp / Shift+PgDn.)

Layers can nest, and you can enter a group making it a temporary layer.

= Text: Create Outlines =

Converting a text object to outlines (i.e. to path) in Inkscape by Ctrl+Shift+C produces a single path object. If you want to manipulate each letter separately, you can break this path into subpaths (Path>Break Apart, Shift+Ctrl+K) and, for letters with holes, reselect parts of each letter and recombine them (Path>Combine, Ctrl+K) to fix the holes.

= Text Boxes =

In Text tool, when you click on the canvas, you created simple (non-flowed, i.e. not wrapping) text. If you click a drag, you create a text box (called "flowed text") where text will wrap automatically. You can also flow text into an arbitrary shape by the 'Flow into Frame' command under the 'Text' menu.

= Guides =

Guides can be hidden (or shown again) in Inkscape with the Shift+| key combination. The | symbol (called a pipe) is generally paired with the backslash character on the keyboard. Ctrl+; does not do anything in Inkscape.

A guide cannot be selected by drawing a rubberband through it, as is done in Illustrator. Rather, to move or delete a guide the artist must use the Selector to grab the guide and move it to another location or to the ruler.

Guides cannot be locked, and guides are global to the layers instead of bound to individual layers as they are in Illustrator. Double clicking a guide will open a dialog where you can set the guide position precisely.

= Gradients =

Unlike Inkscape, an object with gradient applied always displays the gradient line with all the stops, right on canvas, where you can drag the stops, color them, etc. No need to redraw the gradient anew if you want to slightly change direction.

= Warp, Twirl, Pucker, Bloat, etc. =

These Illustrator tools are analogous to the various modes of Inkscape's Tweak tool.

= Brushes =

There's no brushes palette in Inkscape yet, but you can have an editable path with any brush path applied. Select the brush path (called pattern), copy it to clipboard, then select the path you will apply brush to (called skeleton), open Path Effects (Ctrl+Shift+7), select "Path along path", click Apply, select "Single, stretched", and click the Paste button to apply the pattern.

=See also=

[[IllustratorUsers]] is an old version of this document preserving the discussions

[[Category:User Documentation]]

Using the Command Line

2020-07-30T11:25:22Z

Nathanal: /* Via export options */ Add pipe examples from man page

This is a <span style="color:darkred">'''''Work in Progress'''</span>.

For the full and up-to-date command line reference, see <code>man inkscape</code> or the constantly updated online copy of the manual at https://inkscape.org/doc/inkscape-man.html.

=Background=

Starting after the release of the 0.92.x series, Inkscape's code is undergoing a major rewrite with the dual goals of making it more powerful and flexible for the user while making it easier for the developer. This is a long term process and it will be awhile before we see the full benefits.

As a first step, we've started to use the latest Gtk 3 application code for Inkscape 1.0 which has resulted in some changes in how the command line works.

For the command line parameters for Inkscape versions up to 0.92.x, please check the corresponding output of <code>inkscape --help</code> on the command line.

=What can you do with the command line?=

==Print out information==

* Help (list of command line options): '''inkscape --help''' or '''inkscape -?'''
* Inkscape version: '''inkscape --version'''
* Extension directory: '''inkscape --extension-directory''' or '''inkscape -x'''
* List of available verbs (very long): '''inkscape --verb-list'''
* List of available actions: '''inkscape --action-list'''

==Query geometry information==

* Find the x position of a set of objects: '''inkscape --query-id="MyTriangle,MySquare" --query-x my_file.svg
: This will return, for example:
: '''200,300'''
* Query the geometry of all objects: '''inkscape --query-all'''
: This will return, for example (id,x,y,width,height):
: '''MySvg,0,0,600,600'''
: '''MyGroup,100,100,300,300'''
: '''MyTriangle,120,120,100,80'''
: '''MySquare,150,150,50,50'''

==Export files==

=== Via export options ===

Use of export options will suppress the GUI. All files listed on the command line will be opened, processed according to export options. and then be closed.

Some options are exclusive.
* If both '''--export-filename''' and '''--export-type''' are given, the file name extension must match the type.
* Only one of '''--export-area''', '''--export-area-page''', '''-export-area-drawing''', '''--export-use-hints''' will be used to determine the export area. (Which one?)

==== Examples ====
* Simple export of a PNG: '''inkscape --export-type="png" my_file.svg'''
: This will produce a PNG with a name '''my_file.png'''
* Export one object from the file to a PNG: '''inkscape --export-type="png" --export-id="MyTriangle" my_file.svg'''
: This will produce a PNG with a file name '''my_file_MyTriangle.png''' which tightly wraps the object. Objects that extend into the exported area will be shown.
* Export one object from the file to a PNG, hiding all other objects: '''inkscape --export-type="png" --export-id="MyTriangle" --export-id-only my_file.svg'''
: This will produce a PNG with a file name '''my_file_MyTriangle.png''' which tightly wraps the object. Only the triangle is shown.
* Export more than one object at a time to PNG files: '''inkscape --export-type="png" --export-id="MyTriangle;MyRectangle" my_file.svg'''
: This will produce two PNG files, one tightly wrapping the triangle, the other the rectangle.
* Export more than one object to SVG files: '''inkscape --export-type="svg" --export-id="MyTriangle;MyRectangle" --export-id-only my_file.svg''' CRASH: FIXME
: This will produce two SVG files, one with just the triangle, the other with just the rectangle.
* Read an SVG from standard input (stdin) and export it to PDF format: '''cat my_file.svg | inkscape --pipe --export-filename=my_file.pdf'''
* Export an SVG to PNG format and write it to standard output (stdout), then convert it to JPG format with ImageMagick's convert program: '''inkscape --export-type=png --export-filename=- my_file.svg | convert - filename.jpg'''
: If used with file read from standard input (stdin), '''--export-filename''' can be omitted

=== Via actions ===

Use of export options and actions can be mixed. (How?)
All export options have matching actions (remove the '--' in front of the option and replace '=' with ':').
If only actions are used, either '''--without-gui''' or '''--batch-process''' must be used (due to our code structure, most verbs require the GUI to be present even if not used).
All files on the command line will be opened, processed according to actions options, and then closed. Export can be forced at any point with the '''export-do''' action. This allows one to do multiple exports on a single file.

==== Examples ====
* '''inkscape --without-gui --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-filename:triangle_purple.png; export-do; export-background:red; export-filename:triangle_red.png" my_file.svg'''
: This will export the object with the id '''MyTriangle''' with a purple background to the file '''triangle_purple.png''' and with a red background to the file '''triangle_red.png'''. (Note: there is an implicit file export at the end.
* '''inkscape --without-gui --actions="export-id-only; export-id:Triangle; export-filename:action_triangle.png; export-do; export-id:Path; export-filename:action_path.png" export_test.svg'''
: Exports the objects Triangle and Path to different files.

== Modify files ==

* '''inkscape --actions="select:Triangle; ObjectFlipVertically; export-filename:flipped-triangle.svg; export-do; EditUndo; select:Path; ObjectFlipHorizontally; export-filename: flipped-path.svg; export-do; EditUndo; FileClose" export_test.svg
: Flip the triangle, save the result. Undo the flip, then flip the path, save the result. Undo the flip and close the file. (At the moment, one must undo any changes to avoid popping up a dialog warning about unsaved changes.)

== Shell mode ==

To open and edit multiple files after one another without opening a new Inkscape instance for each file, Inkscape offers the shell mode. This mode uses your computer's resources more efficiently, and allows for faster batch processing. The commands are largely identical to those for the 'normal' mode.

You can launch the interactive command line with <code>inkscape --shell</code>.

The main difference to commands in the normal mode is that you need to explicitly indicate when you want to open a file, e.g. <code>file-open:filename.svg; select:flowRootID; query-height</code>.

= Changes from 0.92 =

== General Changes ==
* Each command-line argument can be used only once. The order does not effect processing. Instead, some arguments, e.g. <code>--verbs</code>, can have a semicolon separated list of values:
: <code>inkscape --select=MyStar --verb "ObjectFlipVertically;FileSave;FileClose" MyStar.svg</code>
* <code>xverbs</code> are no longer supported. They are (will be) replaced by <code>actions</code>.
* Inkscape can now take more than one input file, as in <code>inkscape filename1.svg filename2.svg</code>.
* The <code>--export-id</code> argument now supports a semicolon separated list of objects, each one will be exported separately.
* The <code>--query-id</code> argument now supports a comma separated list of objects. Any geometry query (e.g. <code>--query-x</code>) will return a comma separated list of values corresponding to the list of objects in <code>--query-id</code>.
* In export mode, to overwrite a file, one must use <code>--export-overwrite</code>, otherwise a new filename will be generated: file.svg -> file_out.svg
* The option <code>--select</code> now accepts a comma separated list of object IDs instead of only a single ID.
* The shell mode changed. Some information is available [https://gitlab.com/inkscape/inkscape/issues/640#note_268087574 here].

== Deprecations and Replacements ==

* The command-line option <code>--verb</code> is deprecated, use <code>--actions</code> instead:
: <code>inkscape --select=MyStar --actions="ObjectFlipVertically;FileSave;FileClose" MyStar.svg</code>
: Eventually all verbs will be replaced by actions. Temporarily, any <code>verb</code> can be used as an <code>action</code>.
: Note, most verbs require a GUI (even if they don't use it). To close the GUI automatically at the end of processing, use <code>--batch-process</code>.
* <code>--export-png</code>, <code>--export-ps</code>, <code>--export-eps</code>, <code>--export-pdf</code>, <code>--export-emf</code>, <code>--export-wmf</code>, <code>--export-xaml</code> must be replaced by one of:
** <code>--export-filename=MyOutput.xxx</code> to export a single file of type xxx
** <code>--export-type="xxx"</code> to batch export a list of input files to type xxx.
* The <code>--without-gui</code> option has been removed. Most parameters trigger Inkscape to run without GUI by default now. Instead enable GUI mode specifically using <code>--with-gui</code> if needed.
* The <code>--usage</code> option was removed
* The <code>-p</code> option for printing has changed meaning! It now means 'pipe', see below. There is no replacement available for printing.
* The <code>--file<code>/</code>-f</code> options have been dropped. To select a file to open, simply write it as the first argument to the <code>inkscape</code> command.
: You can also specify multiple files to process as a (space-separated) list or by using globs/wildcards like "*.svg" (only in compatible shell environments, ''not'' when using cmd.exe on Windows).
* The <code>--extension-directory</code>/<code>-x</code> options that printed out the system extension directory containing Inkscape's stock extensions have been removed.
: They have been replaced by <code>--system-data-directory</code> and <code>--user-data-directory</code>, which print out the Inkscape installation's data directory and the user's profile directory respectively.

== New options ==

* <code>--export-type="xxx"</code>: Export a single file or a list of input files to type xxx. (output name is derived from input name; multiple export formats for batch export to all of them can specified as a comma-separated list)
* <code>--export-filename=MyOutput.xxx</code>: Export a single file of type xxx (svg, png, ps, eps, pdf, emf, wmf, xaml)
* <code>--actions</code>: chain actions from the action list. Actions can take an argument, like rotation angle, or element type. Conversion of verbs to actions is ongoing.
* <code>--action-list</code>: list available actions
* <code>-p, --pipe</code>: Reads input file from standard input (stdin).
* <code>--pdf-page=PAGE</code>: Imports the given page of a pdf file. Numbering starts with 1.
* <code>--pdf-poppler</code>: Imports a pdf via an external (poppler with cairo backend) library. Text consists of groups containing cloned glyphs where each glyph is a path.
Images are stored internally. Meshes cause entire document to be rendered as a raster image.
* <code>--batch-process</code>: Close GUI when done. Only use this when you actually need a GUI. Otherwise you usually don't need (or want) this option, as it forces the GUI to show (similar to <code>--with-gui</code>).
* <code>--export-ps-level>={2,3}</code>: choose PostScript level

Using the Command Line

2020-06-08T14:00:37Z

Nathanal: export-id uses ; not , to separate ids

This is a <span style="color:darkred">'''''Work in Progress'''</span>.

For the full and up-to-date command line reference, see <code>man inkscape</code> or the constantly updated online copy of the manual at https://inkscape.org/doc/inkscape-man.html.

=Background=

Starting after the release of the 0.92.x series, Inkscape's code is undergoing a major rewrite with the dual goals of making it more powerful and flexible for the user while making it easier for the developer. This is a long term process and it will be awhile before we see the full benefits.

As a first step, we've started to use the latest Gtk 3 application code for Inkscape 1.0 which has resulted in some changes in how the command line works.

For the command line parameters for Inkscape versions up to 0.92.x, please check the corresponding output of <code>inkscape --help</code> on the command line.

=What can you do with the command line?=

==Print out information==

* Help (list of command line options): '''inkscape --help''' or '''inkscape -?'''
* Inkscape version: '''inkscape --version'''
* Extension directory: '''inkscape --extension-directory''' or '''inkscape -x'''
* List of available verbs (very long): '''inkscape --verb-list'''
* List of available actions: '''inkscape --action-list'''

==Query geometry information==

* Find the x position of a set of objects: '''inkscape --query-id="MyTriangle,MySquare" --query-x my_file.svg
: This will return, for example:
: '''200,300'''
* Query the geometry of all objects: '''inkscape --query-all'''
: This will return, for example (id,x,y,width,height):
: '''MySvg,0,0,600,600'''
: '''MyGroup,100,100,300,300'''
: '''MyTriangle,120,120,100,80'''
: '''MySquare,150,150,50,50'''

==Export files==

=== Via export options ===

Use of export options will suppress the GUI. All files listed on the command line will be opened, processed according to export options. and then be closed.

Some options are exclusive.
* If both '''--export-filename''' and '''--export-type''' are given, the file name extension must match the type.
* Only one of '''--export-area''', '''--export-area-page''', '''-export-area-drawing''', '''--export-use-hints''' will be used to determine the export area. (Which one?)

==== Examples ====
* Simple export of a PNG: '''inkscape --export-type="png" my_file.svg'''
: This will produce a PNG with a name '''my_file.png'''
* Export one object from the file to a PNG: '''inkscape --export-type="png" --export-id="MyTriangle" my_file.svg'''
: This will produce a PNG with a file name '''my_file_MyTriangle.png''' which tightly wraps the object. Objects that extend into the exported area will be shown.
* Export one object from the file to a PNG, hiding all other objects: '''inkscape --export-type="png" --export-id="MyTriangle" --export-id-only my_file.svg'''
: This will produce a PNG with a file name '''my_file_MyTriangle.png''' which tightly wraps the object. Only the triangle is shown.
* Export more than one object at a time to PNG files: '''inkscape --export-type="png" --export-id="MyTriangle;MyRectangle" my_file.svg'''
: This will produce two PNG files, one tightly wrapping the triangle, the other the rectangle.
* Export more than one object to SVG files: '''inkscape --export-type="svg" --export-id="MyTriangle;MyRectangle" --export-id-only my_file.svg''' CRASH: FIXME
: This will produce two SVG files, one with just the triangle, the other with just the rectangle.

=== Via actions ===

Use of export options and actions can be mixed. (How?)
All export options have matching actions (remove the '--' in front of the option and replace '=' with ':').
If only actions are used, either '''--without-gui''' or '''--batch-process''' must be used (due to our code structure, most verbs require the GUI to be present even if not used).
All files on the command line will be opened, processed according to actions options, and then closed. Export can be forced at any point with the '''export-do''' action. This allows one to do multiple exports on a single file.

==== Examples ====
* '''inkscape --without-gui --actions="export-id:MyTriangle; export-id-only; export-background:purple; export-filename:triangle_purple.png; export-do; export-background:red; export-filename:triangle_red.png" my_file.svg'''
: This will export the object with the id '''MyTriangle''' with a purple background to the file '''triangle_purple.png''' and with a red background to the file '''triangle_red.png'''. (Note: there is an implicit file export at the end.
* '''inkscape --without-gui --actions="export-id-only; export-id:Triangle; export-filename:action_triangle.png; export-do; export-id:Path; export-filename:action_path.png" export_test.svg'''
: Exports the objects Triangle and Path to different files.

== Modify files ==

* '''inkscape --actions="select:Triangle; ObjectFlipVertically; export-filename:flipped-triangle.svg; export-do; EditUndo; select:Path; ObjectFlipHorizontally; export-filename: flipped-path.svg; export-do; EditUndo; FileClose" export_test.svg
: Flip the triangle, save the result. Undo the flip, then flip the path, save the result. Undo the flip and close the file. (At the moment, one must undo any changes to avoid popping up a dialog warning about unsaved changes.)

== Shell mode ==

To open and edit multiple files after one another without opening a new Inkscape instance for each file, Inkscape offers the shell mode. This mode uses your computer's resources more efficiently, and allows for faster batch processing. The commands are largely identical to those for the 'normal' mode.

You can launch the interactive command line with <code>inkscape --shell</code>.

The main difference to commands in the normal mode is that you need to explicitly indicate when you want to open a file, e.g. <code>file-open:filename.svg; select:flowRootID; query-height</code>.

= Changes from 0.92 =

== General Changes ==
* Each command-line argument can be used only once. The order does not effect processing. Instead, some arguments, e.g. <code>--verbs</code>, can have a semicolon separated list of values:
: <code>inkscape --select=MyStar --verb "ObjectFlipVertically;FileSave;FileClose" MyStar.svg</code>
* <code>xverbs</code> are no longer supported. They are (will be) replaced by <code>actions</code>.
* Inkscape can now take more than one input file, as in <code>inkscape filename1.svg filename2.svg</code>.
* The <code>--export-id</code> argument now supports a semicolon separated list of objects, each one will be exported separately.
* The <code>--query-id</code> argument now supports a comma separated list of objects. Any geometry query (e.g. <code>--query-x</code>) will return a comma separated list of values corresponding to the list of objects in <code>--query-id</code>.
* In export mode, to overwrite a file, one must use <code>--export-overwrite</code>, otherwise a new filename will be generated: file.svg -> file_out.svg
* The option <code>--select</code> now accepts a comma separated list of object IDs instead of only a single ID.
* The shell mode changed. Some information is available [https://gitlab.com/inkscape/inkscape/issues/640#note_268087574 here].

== Deprecations and Replacements ==

* The command-line option <code>--verb</code> is deprecated, use <code>--actions</code> instead:
: <code>inkscape --select=MyStar --actions="ObjectFlipVertically;FileSave;FileClose" MyStar.svg</code>
: Eventually all verbs will be replaced by actions. Temporarily, any <code>verb</code> can be used as an <code>action</code>.
: Note, most verbs require a GUI (even if they don't use it). To close the GUI automatically at the end of processing, use <code>--batch-process</code>.
* <code>--export-png</code>, <code>--export-ps</code>, <code>--export-eps</code>, <code>--export-pdf</code>, <code>--export-emf</code>, <code>--export-wmf</code>, <code>--export-xaml</code> must be replaced by one of:
** <code>--export-filename=MyOutput.xxx</code> to export a single file of type xxx
** <code>--export-type="xxx"</code> to batch export a list of input files to type xxx.
* The <code>--without-gui</code> option has been removed. Most parameters trigger Inkscape to run without GUI by default now. Instead enable GUI mode specifically using <code>--with-gui</code> if needed.
* The <code>--usage</code> option was removed
* The <code>-p</code> option for printing has changed meaning! It now means 'pipe', see below. There is no replacement available for printing.
* The <code>--file<code>/</code>-f</code> options have been dropped. To select a file to open, simply write it as the first argument to the <code>inkscape</code> command.
: You can also specify multiple files to process as a (space-separated) list or by using globs/wildcards like "*.svg" (only in compatible shell environments, ''not'' when using cmd.exe on Windows).
* The <code>--extension-directory</code>/<code>-x</code> options that printed out the system extension directory containing Inkscape's stock extensions have been removed.
: They have been replaced by <code>--system-data-directory</code> and <code>--user-data-directory</code>, which print out the Inkscape installation's data directory and the user's profile directory respectively.

== New options ==

* <code>--export-type="xxx"</code>: Export a single file or a list of input files to type xxx. (output name is derived from input name; multiple export formats for batch export to all of them can specified as a comma-separated list)
* <code>--export-filename=MyOutput.xxx</code>: Export a single file of type xxx (svg, png, ps, eps, pdf, emf, wmf, xaml)
* <code>--actions</code>: chain actions from the action list. Actions can take an argument, like rotation angle, or element type. Conversion of verbs to actions is ongoing.
* <code>--action-list</code>: list available actions
* <code>-p, --pipe</code>: Reads input file from standard input (stdin).
* <code>--pdf-page=PAGE</code>: Imports the given page of a pdf file. Numbering starts with 1.
* <code>--pdf-poppler</code>: Imports a pdf via an external (poppler with cairo backend) library. Text consists of groups containing cloned glyphs where each glyph is a path.
Images are stored internally. Meshes cause entire document to be rendered as a raster image.
* <code>--batch-process</code>: Close GUI when done. Only use this when you actually need a GUI. Otherwise you usually don't need (or want) this option, as it forces the GUI to show (similar to <code>--with-gui</code>).
* <code>--export-ps-level>={2,3}</code>: choose PostScript level