Inkscape Wiki - User contributions [en]

Release notes/1.4.1

2025-03-30T18:27:28Z

Joneuhauser: /* New extensions */

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/1.4.x Commit History Main Program]
* [https://gitlab.com/inkscape/extensions/-/commits/1.4.x Commit History Extensions]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/1.4.x Commit History Documentation]

}}

{{Box| Pending questions:

* …
}}

== Release highlights ==

'''Definitely not released yet.'''

== Changes and Bug Fixes ==

Inkscape 1.4.1 is a '''maintenance and bugfix release''', which brings you fixes for many critical or irritating bugs, and even two new features.

The most important fixes and changes in this release are:

* a new splash screen, providing a visual cue while Inkscape loads in the background
* greatly improved Affinity Designer files (.afdesign) import
* more than '''X crash/freeze fixes''', many of which affected PDF import
* improvements to boolean operations
* and almost '''Y more bug fixes'''

=== General User Interface ===

* Some toolbars now have more collapsible groups, allowing Inkscape to fit on 720p screens ([https://gitlab.com/inkscape/inkscape/-/issues/4987 Bug #4987], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6910 MR #6910], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6707, MR #6707]).
* A new splash screen has been added, letting users know that Inkscape is loading. This can be turned off in ''Preference > Interface > Windows > Miscellaneous''
* Closing the welcome dialog does not create a new Window ([https://gitlab.com/inkscape/inbox/-/issues/6746 Bug #6746],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6584, MR #6584]).
* Status bar hint for guides has been updated to show effect of double clicking on guide ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6772 MR #6772]).
* Moving with arrow keys works as expected for non integer values of nudge ([https://gitlab.com/inkscape/inkscape/-/issues/5308 Bug #5308],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6830 MR #6830]).
* Modular grid now renders with inverted y axis ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6917 MR #6917]).

=== Dialogs ===

==== General ====

==== Align and Distribute Dialog ====

* Irrelevant alignment options are now correctly hidden on opening the Align and Distribute dialog ([https://gitlab.com/inkscape/inkscape/-/issues/5187 Bug #5187], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6730 MR #6730]).

==== Export Dialog ====

* Batch Export: Missing directory prompts creation of directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6882 MR #6882]).

==== Fill and Stroke Dialog ====

* Colors of Asian patterns can now be changed ([https://gitlab.com/inkscape/inbox/-/issues/9089 Bug #9089],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6748 MR #6748])

==== Layers and Objects Dialog ====

* Several crash fixes ([])
* Children of selected groups now show highlights ()

==== Swatches Dialog ====

* .ase color palettes using the LAB color space are imported correctly ([https://gitlab.com/inkscape/inkscape/-/issues/5372 Bug #5372],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6809 MR #6809])
* loading color palettes through the dialog no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5448 Bug #5448], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6895 MR #6895])

=== Tools ===

==== Calligraphy Tool ====

* Missing end-parentheses in tooltips have been restored [https://gitlab.com/inkscape/inkscape/-/merge_requests/6486 MR #6486]

==== Ellipse Tool ====

* SVG attributes of circles are updated correctly ([https://gitlab.com/inkscape/inbox/-/issues/11365 Bug #11365], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6837 MR #6837])

==== Measure Tool ====

* Measure toolbar no longer has multiple 'Options' popovers ([https://gitlab.com/inkscape/inkscape/-/issues/5160 Bug #5160],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6815 MR #6815])

==== Node Tool ====

* Inkscape no longer crashes on undo after node operations ([https://gitlab.com/inkscape/inkscape/-/issues/4447 Bug #4447],[https://gitlab.com/inkscape/inkscape/-/issues/4599 Bug #4599],[https://gitlab.com/inkscape/inkscape/-/issues/4893 Bug #4893],[https://gitlab.com/inkscape/inkscape/-/issues/5028 Bug #5028],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6701 MR #6701])

==== Text Tool ====

* Inkscape no longer freezes when versions of Noto Color Emoji Fonts containing SVG glyphs are used ([https://gitlab.com/inkscape/inkscape/-/issues/5368 Bug #5368],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6827 MR #6827]).

=== Images ===

* Making a bitmap copy now respects antialias setting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6925 MR #6925]).

=== Clipboard ===

* Pasting Mesh Gradient no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5350 Bug #5350] [https://gitlab.com/inkscape/inkscape/-/merge_requests/6865 MR #6865])
* Copying clones pointing to objects in a different open document does not crash anymore ([https://gitlab.com/inkscape/inkscape/-/issues/5282 Bug #5282], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6868 MR #6868]).
* Copy-Pasting clones of groups moved to a different layers now works ([https://gitlab.com/inkscape/inkscape/-/issues/5422 Bug #5422],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6921 MR #6921])
* Pasting doesn't open a new window if SVG import mode is set to 'new' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6929 MR #6929])

=== Import / Export ===

* Inkscape '''no longer crashes''' when '''importing a PDF file''' with '''Type-3/Bitmap Colored fonts''' ([https://gitlab.com/inkscape/inkscape/-/issues/5235 Bug #5235], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6811 MR #6811]).
* PDF import handles consecutive clippings properly ([https://gitlab.com/inkscape/inkscape/-/issues/4135 Bug #4135],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6912 MR #6912]).
* The new PDF importer now handles character and word spacing in text properly ([https://gitlab.com/inkscape/inkscape/-/issues/5367 Bug #5367], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6828 MR #6828]).
* Inkscape now automatically appends the correct extension upon changing file type ([https://gitlab.com/inkscape/inkscape/-/issues/5246 Bug #5246],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6768 MR #6768])
* Links are no longer misplaced when exporting to PDF ([https://gitlab.com/inkscape/inkscape/-/issues/5299 Bug #5299], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6779 MR #6779]).
* Documents with links no longer fail to export under non-English locales ([https://gitlab.com/inkscape/inkscape/-/issues/5354 Bug #5354],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6816 MR #6816]).
* Invalid URIs do not lead to crashes on export ([https://gitlab.com/inkscape/inkscape/-/issues/5249 Bug #5249],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6856 MR #6856]).
* Inkscape defaults to SVG and not WMF if no extension if provided ([https://gitlab.com/inkscape/inkscape/-/issues/5490 Bug #5490],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6952 MR #6952])

=== Path Operations ===

* Boolean operations now respect fill-rule even if it is specified as a separate attribute ([https://gitlab.com/inkscape/inkscape/-/issues/5437 Bug #5437],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6876 MR #6876]).
* Better division for paths containing arcs (circles and ellipses, for example) [https://gitlab.com/inkscape/inkscape/-/issues/2875 Bug #2875],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152].
* Shape builder no longer deforms circles that intersect with other shapes ([https://gitlab.com/inkscape/inkscape/-/issues/4453 Bug #4453],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).
* Intersection on circles produces better result ([https://gitlab.com/inkscape/inkscape/-/issues/3543 Bug #3543],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).

=== Live Path Effects ===

* Boolean LPE: Difference mode can now handle holes properly ([https://gitlab.com/inkscape/inkscape/-/issues/3265 Bug #3265],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152])
* Mirror paths LPE can now handle Multipage documents ([https://gitlab.com/inkscape/inkscape/-/issues/5321 Bug #5321],[https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6817 MR #6817])
* Missing parameters in Perspective LPE have been restored ([https://gitlab.com/inkscape/inkscape/-/issues/5297 Bug #5297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6759 MR #6759])

=== Extensions ===
====New extensions====

* Initial support for import of '''Vectornator / Linearity Curve''' files. The import extensions is under active development. Please report all issues you encounter to [https://gitlab.com/inkscape/extras/extension-curve the repository of the subproject].
* An extension to '''Clean up paths''' was added. The extension removes duplicate nodes and nodes closer than a given threshold. There is also an option to close paths and join subpaths if the nodes are separated by less than given thresholds. The extension can be found in '''Modify Path -> Clean up path'''. Try it out! (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/499 extensions!499])

====Improvements in particular extensions====

* Many new features supported for the import of proprietary '''Affinity Designer''' files, such as:
** more complex vector masks (vector masks of vector masks, vector masks with transparency, multiple vector masks)
** linked and embedded images, including stroke on images
** less nested groups, more natural editing of imported objects
** read additional shapes: Pie, Ring, Polygon (incl. curvature), Cloud, Double star, Square star, Star (rounded tips, curved sides), Crescent, Segment, Heart, Tear
** Invert adjustment
** Symbols
* Various improvements to the '''DXF12 export''': Colors are now included when saving DXF12 files (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/669 extensions!669]) and DXF12 output now supports closed paths (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/673 extensions!673]).
* When loading '''DXF''' files, Inkscape will preserve color in POLYLINE objects. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/672 extensions!672])
* The '''Printing Marks''' extension now supports negative bleed values. It's useful to specify negative bleed when for example importing an image into inkscape that's prepared with some bleed margin in mind, but without printing marks. You can then specify negative bleed margin so it "cuts in" into the imported image, reflecting its intended bleed margin. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/666 extensions!666])

* The '''typst formula''' extension was updated to work better with <code>typst>=0.12</code> (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/659 extensions!659])

====Improvements and fixes for all extensions====

* The <code>text-decoration</code> CSS shorthand is now correctly parsed (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/657 extensions!657])
* Fixed a problem with argument parsing on Python 3.14 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/668 extensions!668])

====Extension Development====

* Added documentation on how to set the icon of an extension in the extension gallery (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/660 extensions!660])
* 3rd-party extension authors can now use inkex's type information more easily (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/674 extensions!674])
* inkex now works with Numpy 2 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/661 extensions!661])

===Command Line===

* Shell --export-page=all now correctly exports all pages ([https://gitlab.com/inkscape/inkscape/-/issues/4850 Bug #4850], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6833 MR #6833])

===Linux-specific Fixes===

*Printing from Snap Package no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/1734 Bug #1734],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6947 MR #6947]).
*Export dialog behaves properly (Snap version) ([https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648], [https://gitlab.com/inkscape/inkscape/-/issues/4015 Bug #4015], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6893 MR #6893]).

=== Windows-specific Fixes===

*Scrolling through fonts with certain fonts installed no longer crashes Inkscape ([https://gitlab.com/inkscape/inkscape/-/issues/4224 Bug inkscape#4224], [https://gitlab.gnome.org/GNOME/pango/-/merge_requests/794 Pango MR #794]).
*The Windows MSI Installer has been upgraded to WiX v4, fixing several issues ([https://gitlab.com/inkscape/inkscape/-/issues/1617 Bug #1617], [https://gitlab.com/inkscape/inkscape/-/issues/1618 Bug #1618], [https://gitlab.com/inkscape/inkscape/-/issues/4679, Bug #4679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6582 MR #6582], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6576 MR #6576]).
*Page size can now be edited without freezes ([https://gitlab.com/inkscape/inkscape/-/issues/5391 Bug #5391],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6824 MR #6824]).

===macOS-specific Fixes===

*UI text is properly rendered (and not replaced with boxes) when fonts are missing ([https://gitlab.com/inkscape/inkscape/-/issues/3532 Bug #3532]).
*Inkscape doesn't crash when preferences is invoked after closing window ([https://gitlab.com/inkscape/inkscape/-/issues/5484 Bug #5484],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6943 MR #6943]).

===Improvements for development / deployment / testing===

*Failing '''snap package''' builds have been fixed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6819 MR #6819])

== Translations ==

Several parts of the UI are now translatable now have better context ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6941 MR #6941], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6950 MR #6950]).

The following UI translations received updates:

*Belarusian
* Chinese - simplified
*German
*Polish

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

==Other releases==

{{:Release notes}}

Release notes/1.4.1

2025-03-30T18:26:42Z

Joneuhauser: /* Extensions */

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/1.4.x Commit History Main Program]
* [https://gitlab.com/inkscape/extensions/-/commits/1.4.x Commit History Extensions]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/1.4.x Commit History Documentation]

}}

{{Box| Pending questions:

* …
}}

== Release highlights ==

'''Definitely not released yet.'''

== Changes and Bug Fixes ==

Inkscape 1.4.1 is a '''maintenance and bugfix release''', which brings you fixes for many critical or irritating bugs, and even two new features.

The most important fixes and changes in this release are:

* a new splash screen, providing a visual cue while Inkscape loads in the background
* greatly improved Affinity Designer files (.afdesign) import
* more than '''X crash/freeze fixes''', many of which affected PDF import
* improvements to boolean operations
* and almost '''Y more bug fixes'''

=== General User Interface ===

* Some toolbars now have more collapsible groups, allowing Inkscape to fit on 720p screens ([https://gitlab.com/inkscape/inkscape/-/issues/4987 Bug #4987], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6910 MR #6910], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6707, MR #6707]).
* A new splash screen has been added, letting users know that Inkscape is loading. This can be turned off in ''Preference > Interface > Windows > Miscellaneous''
* Closing the welcome dialog does not create a new Window ([https://gitlab.com/inkscape/inbox/-/issues/6746 Bug #6746],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6584, MR #6584]).
* Status bar hint for guides has been updated to show effect of double clicking on guide ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6772 MR #6772]).
* Moving with arrow keys works as expected for non integer values of nudge ([https://gitlab.com/inkscape/inkscape/-/issues/5308 Bug #5308],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6830 MR #6830]).
* Modular grid now renders with inverted y axis ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6917 MR #6917]).

=== Dialogs ===

==== General ====

==== Align and Distribute Dialog ====

* Irrelevant alignment options are now correctly hidden on opening the Align and Distribute dialog ([https://gitlab.com/inkscape/inkscape/-/issues/5187 Bug #5187], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6730 MR #6730]).

==== Export Dialog ====

* Batch Export: Missing directory prompts creation of directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6882 MR #6882]).

==== Fill and Stroke Dialog ====

* Colors of Asian patterns can now be changed ([https://gitlab.com/inkscape/inbox/-/issues/9089 Bug #9089],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6748 MR #6748])

==== Layers and Objects Dialog ====

* Several crash fixes ([])
* Children of selected groups now show highlights ()

==== Swatches Dialog ====

* .ase color palettes using the LAB color space are imported correctly ([https://gitlab.com/inkscape/inkscape/-/issues/5372 Bug #5372],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6809 MR #6809])
* loading color palettes through the dialog no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5448 Bug #5448], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6895 MR #6895])

=== Tools ===

==== Calligraphy Tool ====

* Missing end-parentheses in tooltips have been restored [https://gitlab.com/inkscape/inkscape/-/merge_requests/6486 MR #6486]

==== Ellipse Tool ====

* SVG attributes of circles are updated correctly ([https://gitlab.com/inkscape/inbox/-/issues/11365 Bug #11365], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6837 MR #6837])

==== Measure Tool ====

* Measure toolbar no longer has multiple 'Options' popovers ([https://gitlab.com/inkscape/inkscape/-/issues/5160 Bug #5160],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6815 MR #6815])

==== Node Tool ====

* Inkscape no longer crashes on undo after node operations ([https://gitlab.com/inkscape/inkscape/-/issues/4447 Bug #4447],[https://gitlab.com/inkscape/inkscape/-/issues/4599 Bug #4599],[https://gitlab.com/inkscape/inkscape/-/issues/4893 Bug #4893],[https://gitlab.com/inkscape/inkscape/-/issues/5028 Bug #5028],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6701 MR #6701])

==== Text Tool ====

* Inkscape no longer freezes when versions of Noto Color Emoji Fonts containing SVG glyphs are used ([https://gitlab.com/inkscape/inkscape/-/issues/5368 Bug #5368],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6827 MR #6827]).

=== Images ===

* Making a bitmap copy now respects antialias setting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6925 MR #6925]).

=== Clipboard ===

* Pasting Mesh Gradient no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5350 Bug #5350] [https://gitlab.com/inkscape/inkscape/-/merge_requests/6865 MR #6865])
* Copying clones pointing to objects in a different open document does not crash anymore ([https://gitlab.com/inkscape/inkscape/-/issues/5282 Bug #5282], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6868 MR #6868]).
* Copy-Pasting clones of groups moved to a different layers now works ([https://gitlab.com/inkscape/inkscape/-/issues/5422 Bug #5422],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6921 MR #6921])
* Pasting doesn't open a new window if SVG import mode is set to 'new' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6929 MR #6929])

=== Import / Export ===

* Inkscape '''no longer crashes''' when '''importing a PDF file''' with '''Type-3/Bitmap Colored fonts''' ([https://gitlab.com/inkscape/inkscape/-/issues/5235 Bug #5235], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6811 MR #6811]).
* PDF import handles consecutive clippings properly ([https://gitlab.com/inkscape/inkscape/-/issues/4135 Bug #4135],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6912 MR #6912]).
* The new PDF importer now handles character and word spacing in text properly ([https://gitlab.com/inkscape/inkscape/-/issues/5367 Bug #5367], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6828 MR #6828]).
* Inkscape now automatically appends the correct extension upon changing file type ([https://gitlab.com/inkscape/inkscape/-/issues/5246 Bug #5246],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6768 MR #6768])
* Links are no longer misplaced when exporting to PDF ([https://gitlab.com/inkscape/inkscape/-/issues/5299 Bug #5299], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6779 MR #6779]).
* Documents with links no longer fail to export under non-English locales ([https://gitlab.com/inkscape/inkscape/-/issues/5354 Bug #5354],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6816 MR #6816]).
* Invalid URIs do not lead to crashes on export ([https://gitlab.com/inkscape/inkscape/-/issues/5249 Bug #5249],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6856 MR #6856]).
* Inkscape defaults to SVG and not WMF if no extension if provided ([https://gitlab.com/inkscape/inkscape/-/issues/5490 Bug #5490],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6952 MR #6952])

=== Path Operations ===

* Boolean operations now respect fill-rule even if it is specified as a separate attribute ([https://gitlab.com/inkscape/inkscape/-/issues/5437 Bug #5437],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6876 MR #6876]).
* Better division for paths containing arcs (circles and ellipses, for example) [https://gitlab.com/inkscape/inkscape/-/issues/2875 Bug #2875],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152].
* Shape builder no longer deforms circles that intersect with other shapes ([https://gitlab.com/inkscape/inkscape/-/issues/4453 Bug #4453],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).
* Intersection on circles produces better result ([https://gitlab.com/inkscape/inkscape/-/issues/3543 Bug #3543],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).

=== Live Path Effects ===

* Boolean LPE: Difference mode can now handle holes properly ([https://gitlab.com/inkscape/inkscape/-/issues/3265 Bug #3265],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152])
* Mirror paths LPE can now handle Multipage documents ([https://gitlab.com/inkscape/inkscape/-/issues/5321 Bug #5321],[https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6817 MR #6817])
* Missing parameters in Perspective LPE have been restored ([https://gitlab.com/inkscape/inkscape/-/issues/5297 Bug #5297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6759 MR #6759])

=== Extensions ===
====New extensions====

* Initial support for import of '''Vectornator / Linearity Curve''' files. The import extensions is under active development. Please report all issues you encounter to [https://gitlab.com/inkscape/extras/extension-curve the repository of the subproject].
* An extension to '''Clean up paths''' was added. The extension removes duplicate nodes and nodes closer than a given threshold. There is also an option to close paths and join subpaths if the nodes are separated by less than given thresholds. The extension can be found in '''Modify Path -> Clean up path'''. Try it out!

====Improvements in particular extensions====

* Many new features supported for the import of proprietary '''Affinity Designer''' files, such as:
** more complex vector masks (vector masks of vector masks, vector masks with transparency, multiple vector masks)
** linked and embedded images, including stroke on images
** less nested groups, more natural editing of imported objects
** read additional shapes: Pie, Ring, Polygon (incl. curvature), Cloud, Double star, Square star, Star (rounded tips, curved sides), Crescent, Segment, Heart, Tear
** Invert adjustment
** Symbols
* Various improvements to the '''DXF12 export''': Colors are now included when saving DXF12 files (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/669 extensions!669]) and DXF12 output now supports closed paths (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/673 extensions!673]).
* When loading '''DXF''' files, Inkscape will preserve color in POLYLINE objects. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/672 extensions!672])
* The '''Printing Marks''' extension now supports negative bleed values. It's useful to specify negative bleed when for example importing an image into inkscape that's prepared with some bleed margin in mind, but without printing marks. You can then specify negative bleed margin so it "cuts in" into the imported image, reflecting its intended bleed margin. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/666 extensions!666])

* The '''typst formula''' extension was updated to work better with <code>typst>=0.12</code> (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/659 extensions!659])

====Improvements and fixes for all extensions====

* The <code>text-decoration</code> CSS shorthand is now correctly parsed (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/657 extensions!657])
* Fixed a problem with argument parsing on Python 3.14 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/668 extensions!668])

====Extension Development====

* Added documentation on how to set the icon of an extension in the extension gallery (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/660 extensions!660])
* 3rd-party extension authors can now use inkex's type information more easily (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/674 extensions!674])
* inkex now works with Numpy 2 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/661 extensions!661])

===Command Line===

* Shell --export-page=all now correctly exports all pages ([https://gitlab.com/inkscape/inkscape/-/issues/4850 Bug #4850], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6833 MR #6833])

===Linux-specific Fixes===

*Printing from Snap Package no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/1734 Bug #1734],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6947 MR #6947]).
*Export dialog behaves properly (Snap version) ([https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648], [https://gitlab.com/inkscape/inkscape/-/issues/4015 Bug #4015], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6893 MR #6893]).

=== Windows-specific Fixes===

*Scrolling through fonts with certain fonts installed no longer crashes Inkscape ([https://gitlab.com/inkscape/inkscape/-/issues/4224 Bug inkscape#4224], [https://gitlab.gnome.org/GNOME/pango/-/merge_requests/794 Pango MR #794]).
*The Windows MSI Installer has been upgraded to WiX v4, fixing several issues ([https://gitlab.com/inkscape/inkscape/-/issues/1617 Bug #1617], [https://gitlab.com/inkscape/inkscape/-/issues/1618 Bug #1618], [https://gitlab.com/inkscape/inkscape/-/issues/4679, Bug #4679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6582 MR #6582], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6576 MR #6576]).
*Page size can now be edited without freezes ([https://gitlab.com/inkscape/inkscape/-/issues/5391 Bug #5391],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6824 MR #6824]).

===macOS-specific Fixes===

*UI text is properly rendered (and not replaced with boxes) when fonts are missing ([https://gitlab.com/inkscape/inkscape/-/issues/3532 Bug #3532]).
*Inkscape doesn't crash when preferences is invoked after closing window ([https://gitlab.com/inkscape/inkscape/-/issues/5484 Bug #5484],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6943 MR #6943]).

===Improvements for development / deployment / testing===

*Failing '''snap package''' builds have been fixed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6819 MR #6819])

== Translations ==

Several parts of the UI are now translatable now have better context ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6941 MR #6941], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6950 MR #6950]).

The following UI translations received updates:

*Belarusian
* Chinese - simplified
*German
*Polish

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

==Other releases==

{{:Release notes}}

Release notes/1.4.1

2025-03-07T19:17:27Z

Joneuhauser:

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/1.4.x Commit History Main Program]
* [https://gitlab.com/inkscape/extensions/-/commits/1.4.x Commit History Extensions]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/1.4.x Commit History Documentation]

}}

{{Box| Pending questions:

* …
}}

== Release highlights ==

'''Definitely not released yet.'''

== Changes and Bug Fixes ==

Inkscape 1.4.1 is a '''maintenance and bugfix release''', which brings you fixes for many critical or irritating bugs, and even two new features.

The most important fixes and changes in this release are:

* a new splash screen, providing a visual cue while Inkscape loads in the background
* greatly improved Affinity Designer files (.afdesign) import
* more than '''X crash/freeze fixes''', many of which affected PDF import
* improvements to boolean operations
* and almost '''Y more bug fixes'''

=== General User Interface ===

* Some toolbars now have more collapsible groups, allowing Inkscape to fit on 720p screens ([https://gitlab.com/inkscape/inkscape/-/issues/4987 Bug #4987], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6910 MR #6910], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6707, MR #6707]).
* A new splash screen has been added, letting users know that Inkscape is loading. This can be turned off in ''Preference > Interface > Windows > Miscellaneous''
* Closing the welcome dialog does not create a new Window ([https://gitlab.com/inkscape/inbox/-/issues/6746 Bug #6746],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6584, MR #6584]).
* Status bar hint for guides has been updated to show effect of double clicking on guide ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6772 MR #6772]).
* Moving with arrow keys works as expected for non integer values of nudge ([https://gitlab.com/inkscape/inkscape/-/issues/5308 Bug #5308],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6830 MR #6830]).
* Modular grid now renders with inverted y axis ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6917 MR #6917]).

=== Dialogs ===

==== General ====

==== Align and Distribute Dialog ====

* Irrelevant alignment options are now correctly hidden on opening the Align and Distribute dialog ([https://gitlab.com/inkscape/inkscape/-/issues/5187 Bug #5187], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6730 MR #6730]).

==== Export Dialog ====

* Batch Export: Missing directory prompts creation of directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6882 MR #6882]).

==== Fill and Stroke Dialog ====

* Colors of Asian patterns can now be changed ([https://gitlab.com/inkscape/inbox/-/issues/9089 Bug #9089],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6748 MR #6748])

==== Layers and Objects Dialog ====

* Several crash fixes ([])
* Children of selected groups now show highlights ()

==== Swatches Dialog ====

* .ase color palettes using the LAB color space are imported correctly ([https://gitlab.com/inkscape/inkscape/-/issues/5372 Bug #5372],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6809 MR #6809])
* loading color palettes through the dialog no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5448 Bug #5448], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6895 MR #6895])

=== Tools ===

==== Calligraphy Tool ====

* Missing end-parentheses in tooltips have been restored [https://gitlab.com/inkscape/inkscape/-/merge_requests/6486 MR #6486]

==== Ellipse Tool ====

* SVG attributes of circles are updated correctly ([https://gitlab.com/inkscape/inbox/-/issues/11365 Bug #11365], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6837 MR #6837])

==== Measure Tool ====

* Measure toolbar no longer has multiple 'Options' popovers ([https://gitlab.com/inkscape/inkscape/-/issues/5160 Bug #5160],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6815 MR #6815])

==== Node Tool ====

* Inkscape no longer crashes on undo after node operations ([https://gitlab.com/inkscape/inkscape/-/issues/4447 Bug #4447],[https://gitlab.com/inkscape/inkscape/-/issues/4599 Bug #4599],[https://gitlab.com/inkscape/inkscape/-/issues/4893 Bug #4893],[https://gitlab.com/inkscape/inkscape/-/issues/5028 Bug #5028],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6701 MR #6701])

==== Text Tool ====

* Inkscape no longer freezes when versions of Noto Color Emoji Fonts containing SVG glyphs are used ([https://gitlab.com/inkscape/inkscape/-/issues/5368 Bug #5368],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6827 MR #6827]).

=== Images ===

* Making a bitmap copy now respects antialias setting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6925 MR #6925]).

=== Clipboard ===

* Pasting Mesh Gradient no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5350 Bug #5350] [https://gitlab.com/inkscape/inkscape/-/merge_requests/6865 MR #6865])
* Copying clones pointing to objects in a different open document does not crash anymore ([https://gitlab.com/inkscape/inkscape/-/issues/5282 Bug #5282], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6868 MR #6868]).
* Copy-Pasting clones of groups moved to a different layers now works ([https://gitlab.com/inkscape/inkscape/-/issues/5422 Bug #5422],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6921 MR #6921])
* Pasting doesn't open a new window if SVG import mode is set to 'new' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6929 MR #6929])

=== Import / Export ===

* Inkscape '''no longer crashes''' when '''importing a PDF file''' with '''Type-3/Bitmap Colored fonts''' ([https://gitlab.com/inkscape/inkscape/-/issues/5235 Bug #5235], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6811 MR #6811]).
* PDF import handles consecutive clippings properly ([https://gitlab.com/inkscape/inkscape/-/issues/4135 Bug #4135],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6912 MR #6912]).
* The new PDF importer now handles character and word spacing in text properly ([https://gitlab.com/inkscape/inkscape/-/issues/5367 Bug #5367], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6828 MR #6828]).
* Inkscape now automatically appends the correct extension upon changing file type ([https://gitlab.com/inkscape/inkscape/-/issues/5246 Bug #5246],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6768 MR #6768])
* Links are no longer misplaced when exporting to PDF ([https://gitlab.com/inkscape/inkscape/-/issues/5299 Bug #5299], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6779 MR #6779]).
* Documents with links no longer fail to export under non-English locales ([https://gitlab.com/inkscape/inkscape/-/issues/5354 Bug #5354],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6816 MR #6816]).
* Invalid URIs do not lead to crashes on export ([https://gitlab.com/inkscape/inkscape/-/issues/5249 Bug #5249],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6856 MR #6856]).
* Inkscape defaults to SVG and not WMF if no extension if provided ([https://gitlab.com/inkscape/inkscape/-/issues/5490 Bug #5490],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6952 MR #6952])

=== Path Operations ===

* Boolean operations now respect fill-rule even if it is specified as a separate attribute ([https://gitlab.com/inkscape/inkscape/-/issues/5437 Bug #5437],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6876 MR #6876]).
* Better division for paths containing arcs (circles and ellipses, for example) [https://gitlab.com/inkscape/inkscape/-/issues/2875 Bug #2875],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152].
* Shape builder no longer deforms circles that intersect with other shapes ([https://gitlab.com/inkscape/inkscape/-/issues/4453 Bug #4453],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).
* Intersection on circles produces better result ([https://gitlab.com/inkscape/inkscape/-/issues/3543 Bug #3543],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).

=== Live Path Effects ===

* Boolean LPE: Difference mode can now handle holes properly ([https://gitlab.com/inkscape/inkscape/-/issues/3265 Bug #3265],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152])
* Mirror paths LPE can now handle Multipage documents ([https://gitlab.com/inkscape/inkscape/-/issues/5321 Bug #5321],[https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6817 MR #6817])
* Missing parameters in Perspective LPE have been restored ([https://gitlab.com/inkscape/inkscape/-/issues/5297 Bug #5297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6759 MR #6759])

=== Extensions ===

====Improvements in particular extensions====

* Many new features supported for the import of proprietary '''Affinity Designer''' files, such as:
** more complex vector masks (vector masks of vector masks, vector masks with transparency, multiple vector masks)
** linked and embedded images, including stroke on images
** less nested groups, more natural editing of imported objects
** read additional shapes: Pie, Ring, Polygon (incl. curvature), Cloud, Double star, Square star, Star (rounded tips, curved sides), Crescent, Segment, Heart, Tear
** Invert adjustment
** Symbols
* Various improvements to the '''DXF12 export''': Colors are now included when saving DXF12 files (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/669 extensions!669]) and DXF12 output now supports closed paths (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/673 extensions!673]).
* When loading '''DXF''' files, Inkscape will preserve color in POLYLINE objects. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/672 extensions!672])
* The '''Printing Marks''' extension now supports negative bleed values. It's useful to specify negative bleed when for example importing an image into inkscape that's prepared with some bleed margin in mind, but without printing marks. You can then specify negative bleed margin so it "cuts in" into the imported image, reflecting its intended bleed margin. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/666 extensions!666])

* The '''typst formula''' extension was updated to work better with <code>typst>=0.12</code> (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/659 extensions!659])

====Improvements and fixes for all extensions====

* The <code>text-decoration</code> CSS shorthand is now correctly parsed (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/657 extensions!657])
* Fixed a problem with argument parsing on Python 3.14 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/668 extensions!668])

====Extension Development====

* Added documentation on how to set the icon of an extension in the extension gallery (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/660 extensions!660])
* 3rd-party extension authors can now use inkex's type information more easily (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/674 extensions!674])
* inkex now works with Numpy 2 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/661 extensions!661])

===Command Line===

* Shell --export-page=all now correctly exports all pages ([https://gitlab.com/inkscape/inkscape/-/issues/4850 Bug #4850], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6833 MR #6833])

===Linux-specific Fixes===

*Printing from Snap Package no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/1734 Bug #1734],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6947 MR #6947]).
*Export dialog behaves properly (Snap version) ([https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648], [https://gitlab.com/inkscape/inkscape/-/issues/4015 Bug #4015], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6893 MR #6893]).

=== Windows-specific Fixes===

*Scrolling through fonts with certain fonts installed no longer crashes Inkscape ([https://gitlab.com/inkscape/inkscape/-/issues/4224 Bug inkscape#4224], [https://gitlab.gnome.org/GNOME/pango/-/merge_requests/794 Pango MR #794]).
*The Windows MSI Installer has been upgraded to WiX v4, fixing several issues ([https://gitlab.com/inkscape/inkscape/-/issues/1617 Bug #1617], [https://gitlab.com/inkscape/inkscape/-/issues/1618 Bug #1618], [https://gitlab.com/inkscape/inkscape/-/issues/4679, Bug #4679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6582 MR #6582], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6576 MR #6576]).
*Page size can now be edited without freezes ([https://gitlab.com/inkscape/inkscape/-/issues/5391 Bug #5391],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6824 MR #6824]).

===macOS-specific Fixes===

*UI text is properly rendered (and not replaced with boxes) when fonts are missing ([https://gitlab.com/inkscape/inkscape/-/issues/3532 Bug #3532]).
*Inkscape doesn't crash when preferences is invoked after closing window ([https://gitlab.com/inkscape/inkscape/-/issues/5484 Bug #5484],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6943 MR #6943]).

===Improvements for development / deployment / testing===

*Failing '''snap package''' builds have been fixed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6819 MR #6819])

== Translations ==

Several parts of the UI are now translatable now have better context ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6941 MR #6941], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6950 MR #6950]).

The following UI translations received updates:

*Belarusian
* Chinese - simplified
*German
*Polish

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

==Other releases==

{{:Release notes}}

Release notes/1.4.1

2025-03-07T19:17:04Z

Joneuhauser: /* Features */

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/1.4.x Commit History Main Program]
* [https://gitlab.com/inkscape/extensions/-/commits/1.4.x Commit History Extensions]
* [https://gitlab.com/inkscape/inkscape-docs/documentation/-/tree/1.4.x Commit History Documentation]

}}

{{Box| Pending questions:

* …
}}

== Release highlights ==

'''Definitely not released yet.'''

== Changes and Bug Fixes ==

Inkscape 1.4.1 is a '''maintenance and bugfix release''', which brings you fixes for many critical or irritating bugs, and even two new features.

The most important fixes and changes in this release are:

* a new splash screen, providing a visual cue while Inkscape loads in the background
* greatly improved Affinity Designer files (.afdesign) import
* more than '''X crash/freeze fixes''', many of which affected PDF import
* improvements to boolean operations
* and almost '''Y more bug fixes'''

=== General User Interface ===

* Some toolbars now have more collapsible groups, allowing Inkscape to fit on 720p screens ([https://gitlab.com/inkscape/inkscape/-/issues/4987 Bug #4987], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6910 MR #6910], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6707, MR #6707]).
* A new splash screen has been added, letting users know that Inkscape is loading. This can be turned off in ''Preference > Interface > Windows > Miscellaneous''
* Closing the welcome dialog does not create a new Window ([https://gitlab.com/inkscape/inbox/-/issues/6746 Bug #6746],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6584, MR #6584]).
* Status bar hint for guides has been updated to show effect of double clicking on guide ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6772 MR #6772]).
* Moving with arrow keys works as expected for non integer values of nudge ([https://gitlab.com/inkscape/inkscape/-/issues/5308 Bug #5308],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6830 MR #6830]).
* Modular grid now renders with inverted y axis ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6917 MR #6917]).

=== Dialogs ===

==== General ====

==== Align and Distribute Dialog ====

* Irrelevant alignment options are now correctly hidden on opening the Align and Distribute dialog ([https://gitlab.com/inkscape/inkscape/-/issues/5187 Bug #5187], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6730 MR #6730]).

==== Export Dialog ====

* Batch Export: Missing directory prompts creation of directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6882 MR #6882]).

==== Fill and Stroke Dialog ====

* Colors of Asian patterns can now be changed ([https://gitlab.com/inkscape/inbox/-/issues/9089 Bug #9089],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6748 MR #6748])

==== Layers and Objects Dialog ====

* Several crash fixes ([])
* Children of selected groups now show highlights ()

==== Swatches Dialog ====

* .ase color palettes using the LAB color space are imported correctly ([https://gitlab.com/inkscape/inkscape/-/issues/5372 Bug #5372],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6809 MR #6809])
* loading color palettes through the dialog no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5448 Bug #5448], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6895 MR #6895])

=== Tools ===

==== Calligraphy Tool ====

* Missing end-parentheses in tooltips have been restored [https://gitlab.com/inkscape/inkscape/-/merge_requests/6486 MR #6486]

==== Ellipse Tool ====

* SVG attributes of circles are updated correctly ([https://gitlab.com/inkscape/inbox/-/issues/11365 Bug #11365], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6837 MR #6837])

==== Measure Tool ====

* Measure toolbar no longer has multiple 'Options' popovers ([https://gitlab.com/inkscape/inkscape/-/issues/5160 Bug #5160],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6815 MR #6815])

==== Node Tool ====

* Inkscape no longer crashes on undo after node operations ([https://gitlab.com/inkscape/inkscape/-/issues/4447 Bug #4447],[https://gitlab.com/inkscape/inkscape/-/issues/4599 Bug #4599],[https://gitlab.com/inkscape/inkscape/-/issues/4893 Bug #4893],[https://gitlab.com/inkscape/inkscape/-/issues/5028 Bug #5028],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6701 MR #6701])

==== Text Tool ====

* Inkscape no longer freezes when versions of Noto Color Emoji Fonts containing SVG glyphs are used ([https://gitlab.com/inkscape/inkscape/-/issues/5368 Bug #5368],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6827 MR #6827]).

=== Images ===

* Making a bitmap copy now respects antialias setting ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6925 MR #6925]).

=== Clipboard ===

* Pasting Mesh Gradient no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/5350 Bug #5350] [https://gitlab.com/inkscape/inkscape/-/merge_requests/6865 MR #6865])
* Copying clones pointing to objects in a different open document does not crash anymore ([https://gitlab.com/inkscape/inkscape/-/issues/5282 Bug #5282], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6868 MR #6868]).
* Copy-Pasting clones of groups moved to a different layers now works ([https://gitlab.com/inkscape/inkscape/-/issues/5422 Bug #5422],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6921 MR #6921])
* Pasting doesn't open a new window if SVG import mode is set to 'new' ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6929 MR #6929])

=== Import / Export ===

* Inkscape '''no longer crashes''' when '''importing a PDF file''' with '''Type-3/Bitmap Colored fonts''' ([https://gitlab.com/inkscape/inkscape/-/issues/5235 Bug #5235], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6811 MR #6811]).
* PDF import handles consecutive clippings properly ([https://gitlab.com/inkscape/inkscape/-/issues/4135 Bug #4135],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6912 MR #6912]).
* The new PDF importer now handles character and word spacing in text properly ([https://gitlab.com/inkscape/inkscape/-/issues/5367 Bug #5367], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6828 MR #6828]).
* Inkscape now automatically appends the correct extension upon changing file type ([https://gitlab.com/inkscape/inkscape/-/issues/5246 Bug #5246],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6768 MR #6768])
* Links are no longer misplaced when exporting to PDF ([https://gitlab.com/inkscape/inkscape/-/issues/5299 Bug #5299], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6779 MR #6779]).
* Documents with links no longer fail to export under non-English locales ([https://gitlab.com/inkscape/inkscape/-/issues/5354 Bug #5354],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6816 MR #6816]).
* Invalid URIs do not lead to crashes on export ([https://gitlab.com/inkscape/inkscape/-/issues/5249 Bug #5249],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6856 MR #6856]).
* Inkscape defaults to SVG and not WMF if no extension if provided ([https://gitlab.com/inkscape/inkscape/-/issues/5490 Bug #5490],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6952 MR #6952])

=== Path Operations ===

* Boolean operations now respect fill-rule even if it is specified as a separate attribute ([https://gitlab.com/inkscape/inkscape/-/issues/5437 Bug #5437],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6876 MR #6876]).
* Better division for paths containing arcs (circles and ellipses, for example) [https://gitlab.com/inkscape/inkscape/-/issues/2875 Bug #2875],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152].
* Shape builder no longer deforms circles that intersect with other shapes ([https://gitlab.com/inkscape/inkscape/-/issues/4453 Bug #4453],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).
* Intersection on circles produces better result ([https://gitlab.com/inkscape/inkscape/-/issues/3543 Bug #3543],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152]).

=== Live Path Effects ===

* Boolean LPE: Difference mode can now handle holes properly ([https://gitlab.com/inkscape/inkscape/-/issues/3265 Bug #3265],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6152 MR #6152])
* Mirror paths LPE can now handle Multipage documents ([https://gitlab.com/inkscape/inkscape/-/issues/5321 Bug #5321],[https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6817 MR #6817])
* Missing parameters in Perspective LPE have been restored ([https://gitlab.com/inkscape/inkscape/-/issues/5297 Bug #5297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6759 MR #6759])

=== Extensions ===

====Improvements in particular extensions====

* Many new features supported for the import of proprietary '''Affinity Designer''' files, such as:
** more complex vector masks (vector masks of vector masks, vector masks with transparency, multiple vector masks)
** linked and embedded images, including stroke on images
** less nested groups, more natural editing of imported objects
** read additional shapes: Pie, Ring, Polygon (incl. curvature), Cloud, Double star, Square star, Star (rounded tips, curved sides), Crescent, Segment, Heart, Tear
** Invert adjustment
** Symbols
* Various improvements to the '''DXF12 export''': Colors are now included when saving DXF12 files (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/669 extensions!669]) and DXF12 output now supports closed paths (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/673 extensions!673]).
* When loading '''DXF''' files, Inkscape will preserve color in POLYLINE objects. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/672 extensions!672])
* The '''Printing Marks''' extension now supports negative bleed values. It's useful to specify negative bleed when for example importing an image into inkscape that's prepared with some bleed margin in mind, but without printing marks. You can then specify negative bleed margin so it "cuts in" into the imported image, reflecting its intended bleed margin. (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/666 extensions!666])

* The '''typst formula''' extension was updated to work better with <code>typst>=0.12</code> (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/659 extensions!659])

====Improvements and fixes for all extensions====

* The <code>text-decoration</code> CSS shorthand is now correctly parsed (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/657 extensions!657])
* Fixed a problem with argument parsing on Python 3.14 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/668 extensions!668])

===Extension Development===

* Added documentation on how to set the icon of an extension in the extension gallery (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/660 extensions!660])
* 3rd-party extension authors can now use inkex's type information more easily (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/674 extensions!674])
* inkex now works with Numpy 2 (MR [https://gitlab.com/inkscape/extensions/-/merge_requests/661 extensions!661])

===Command Line===

* Shell --export-page=all now correctly exports all pages ([https://gitlab.com/inkscape/inkscape/-/issues/4850 Bug #4850], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6833 MR #6833])

===Linux-specific Fixes===

*Printing from Snap Package no longer crashes ([https://gitlab.com/inkscape/inkscape/-/issues/1734 Bug #1734],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6947 MR #6947]).
*Export dialog behaves properly (Snap version) ([https://gitlab.com/inkscape/inkscape/-/issues/3648 Bug #3648], [https://gitlab.com/inkscape/inkscape/-/issues/4015 Bug #4015], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6893 MR #6893]).

=== Windows-specific Fixes===

*Scrolling through fonts with certain fonts installed no longer crashes Inkscape ([https://gitlab.com/inkscape/inkscape/-/issues/4224 Bug inkscape#4224], [https://gitlab.gnome.org/GNOME/pango/-/merge_requests/794 Pango MR #794]).
*The Windows MSI Installer has been upgraded to WiX v4, fixing several issues ([https://gitlab.com/inkscape/inkscape/-/issues/1617 Bug #1617], [https://gitlab.com/inkscape/inkscape/-/issues/1618 Bug #1618], [https://gitlab.com/inkscape/inkscape/-/issues/4679, Bug #4679], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6582 MR #6582], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6576 MR #6576]).
*Page size can now be edited without freezes ([https://gitlab.com/inkscape/inkscape/-/issues/5391 Bug #5391],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6824 MR #6824]).

===macOS-specific Fixes===

*UI text is properly rendered (and not replaced with boxes) when fonts are missing ([https://gitlab.com/inkscape/inkscape/-/issues/3532 Bug #3532]).
*Inkscape doesn't crash when preferences is invoked after closing window ([https://gitlab.com/inkscape/inkscape/-/issues/5484 Bug #5484],[https://gitlab.com/inkscape/inkscape/-/merge_requests/6943 MR #6943]).

===Improvements for development / deployment / testing===

*Failing '''snap package''' builds have been fixed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6819 MR #6819])

== Translations ==

Several parts of the UI are now translatable now have better context ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6941 MR #6941], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6950 MR #6950]).

The following UI translations received updates:

*Belarusian
* Chinese - simplified
*German
*Polish

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

==Other releases==

{{:Release notes}}

Inkscape Summit 2025 Nuremberg

2025-03-05T19:23:53Z

Joneuhauser: /* Add your ideas here! */

[[File:Inksummit2025.png|left|thumb|150x150px]]
This page details the planning of Inkscape's 2025 summit in Nuremberg, Germany. The hackfest will take place on '''May 24–28, 2025'''. We are looking to bring together a group of '''16 attendees'''. We are fully booked and the number of participants is final now.

This summit takes place directly before the 2025 Libre Graphics Meeting.

Previous events: [[Hackfest2023 Bensberg]], [[Hackfest2019 Saarbrücken]], [[Hackfest2019 SCALE]], [[Hackfest2018 Kiel]], [[Hackfest2018 LGM]], [[Hackfest2018]], [[Hackfest2017]], [[Hackfest2016]], [[Hackfest2015]].
[[Category:Hackfest]]

= Agenda =

=== Add your ideas here! ===

* Bug triaging
** Issue filtering (useful application for AI?)
* Development
** 1.5
*** Selection cues
*** Status bar
* Documentation
** Cleaning up documentation (wiki, dev docs, user docs, extension docs)
* Extensions
** "Using Inkscape to make physical things"
*** Have a look at Hatch Embroidery (paid software that has a cool preview feature and thousands of advanced options that are hard to understand)
** svgpie and inkex
*** Separation of concerns? (svgpie for SVG wrangling, inkex for an API to the Inkscape interface)
* Organization
** Foundation/organization setup (what needs actions/help?)
**Relationship between Inkscape and commercial actors (e.g. advertising companies / developers available for contract work, support contracts)
**Grants program
* UX
** Charter & policy
** Design discussion
*** Object properties (for text, for multi-selection)
*** new settings (we have tools, but need all other categories)
*** LPEs and their panels
*** CMYK export workflow
*** Swatches dialog
* Website
** Infrastructure update (less 502s)
** Library update (django 5)
** Design/UX overhaul
** Separate funding page? (Blender, Krita, Thunderbird and KDE have it)

SOC Application Template

2025-02-13T12:07:40Z

Joneuhauser: Replaced content with "{{Template:MovedToOtherSite|topic=Google Summer of Code|new_url=https://gitlab.com/inkscape/inkscape/-/blob/master/doc/gsoc/summerofcode.md?ref_type=heads|new_site=Git repo}}"

{{Template:MovedToOtherSite|topic=Google Summer of Code|new_url=https://gitlab.com/inkscape/inkscape/-/blob/master/doc/gsoc/summerofcode.md?ref_type=heads|new_site=Git repo}}

Google Summer of Code

2025-02-13T12:06:34Z

Joneuhauser: Replaced content with "Category:Developer Documentation {{Template:MovedToOtherSite|topic=Google Summer of Code|new_url=https://gitlab.com/inkscape/inkscape/-/blob/master/doc/gsoc/summerofco..."

[[Category:Developer Documentation]]
{{Template:MovedToOtherSite|topic=Google Summer of Code|new_url=https://gitlab.com/inkscape/inkscape/-/blob/master/doc/gsoc/summerofcode.md?ref_type=heads|new_site=Git repository}}

Release notes/1.4

2024-09-22T19:44:50Z

Joneuhauser: /* Extensions */

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

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: May 16, 2023)]
* [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:

* https://gitlab.com/inkscape/inbox/-/issues/10309 - spray tool performance drop bug
* https://gitlab.com/inkscape/inbox/-/issues/10110 - extension gallery tooltip bug ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6257 MR])
* https://gitlab.com/inkscape/inbox/-/issues/10308 - export dialog icons bug
* https://gitlab.com/inkscape/inbox/-/issues/10112 - object picker UX bugs
* https://gitlab.com/inkscape/inbox/-/issues/10113 - scale lock bug
* https://gitlab.com/inkscape/inkscape/-/merge_requests/5993#note_1820038476 - scale lock use case required for better explanation
* https://gitlab.com/inkscape/inkscape/-/merge_requests/6199#note_1889273098 - ellipse snapping

}}

== Release highlights ==

* '''Filter Gallery:''' it has never been so easy to find the best filter for your needs! This new dialog features previews, categories and search.
* '''Modular grids & improved axonometric grids:''' set the grid angle by ratio for isometric designs and use modular grids to plan layouts and make icons!
* '''Swatches dialog and palette file handling improved:''' quick access to dialog layout controls, search for colors, and open different palette file formats!
* '''Unified font browser preview:''' when activated in the preferences, use it to quickly browse through your font collection. Try it out and give your feedback!
* '''Customizable handles:''' Power users with CSS knowledge can now customize the styling and basic shape of all the handles!
* '''Fast image clipping with the Shape Builder:''' raster graphics can now be clipped into multiple sections using the Shape Builder.
* '''There's even more:''' new templates for folding booklets, additional options in Ruler and Taper Stroke LPE, preview in Spray tool, many new command line options, updated translations and many bug fixes.

== Canvas ==

=== Guides ===

When creating a new guide, all guides are now unlocked, so the new guide can be moved and adjusted freely ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5814 MR #5814]).

== Tools ==

=== General ===

Toolbars now try to make use of the available space by not hiding options in dropdown menus when there's enough space. Instead, they are sorted into multiple, dropdown menus, when the window is shrunk or there is not enough space.

Previously, any options that did not fit went into the same small arrow dropdown at the end of the toolbar and were hard to discover.

The change also leads to a larger minimal width of the Inkscape window, which is now dependent upon the selected tool with its collapsed toolbar items.

=== Node Tool ===

* The mouse/keyboard shortcut for converting a curved path segment to a straight line has been changed from <kbd>Ctrl+Click</kbd> to <kbd>Alt+Double-click</kbd> as a fix to the double-click action of the 'delete segment' command not being recognized correctly ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6504 MR #6504]).
* Deleting a node now behaves differently again ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6285 MR #6285], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6635 MR #6635]). With the preference option 'Edit > Preferences > Node tool: Deleting node preserves shape' active, Inkscape will use its node sharpness autodetection to decide whether the shape will be kept, or the node will be removed without adjusting the adjacent nodes' handles. With the option inactive, Inkscape will behave like Inkscape 1.2 (no autodetection, shape is kept when pressing Del, straight lines with Ctrl + Del).

{| class="wikitable"
|+ Node deletion behavior
|-
! Keys pressed !! Curve is (almost) cusp !! Curve is smooth
|-
| Del + Preference for keeping shape is active || Adjacent handles will not be adjusted || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|-
| Del + Preference for keeping shape is not active || Adjacent handles will be adjusted to try and keep the shape || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is not active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|}

=== Pen Tool ===

A new option has been added to automatically convert the currently drawn shape to guides, allowing users to 'draw' guides instead of dragging them out of the rulers. It comes without a keyboard shortcut, but you can set one in the preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).

=== Rectangle Tool ===

A new mode to only draw squares with Alt + Ctrl has been added to the tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6199 MR #6199]).

=== Selector Tool & Node Tool ===

* In Edit > Preferences > Behavior > Steps, an option has been added to change how moving selected objects / nodes with the arrow keys works when the canvas is rotated (Arrow keys move object relative to screen). If you're working with a rotated canvas, now, by default, the arrow keys will move the selection horizontally and vertically relative to the screen, not to the rotated document. This allows to work more intuitively while the canvas is rotated. Disabling the option will restore the previous behavior ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5031 MR #5031]).
* In the preferences settings for both tools, options for changing the active layer and active page when using the tool to select an object have been added. The Selector tool will change both active layer and active page, while the Node tool will change neither, by default. Other tools (Text tool, Rectangle tool, …) do not change either layer or page when being used (but they can, if you edit the preferences.xml file in a text editor, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5257 MR #5257]).

=== Shape Builder Tool ===

Several improvements were made to the Shape Builder ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5428 MR #5428]):

* The Shape Builder tool can now make use of raster graphics, too. Any paths selected together with a raster (pixel) graphic will now function as clipping paths, their colors are not preserved - unlike when you have only paths in the selection. The resulting image parts use clipped clones of the image, to keep the file size small and improve performance. If you want to edit them, you need to unlink the clones.
* An option for the transparency level of the original drawing has been added (the eye icon opens a popup slider).
* Optionally, it is now possible to keep a copy of the original objects after the Shape Builder's operation. This option is deactivated by default.

[[File:Inkscape_lgi0590pMq-ezgif.com-optimize_(1).gif|frame|center|Using the Shape Builder Tool to quickly split a raster graphic into multiple parts]]

=== Spray Tool ===

* The Spray Tool now shows an outline preview of the next item that it is going to spray, including its shape, rotation and size. The preview is only visible when the tool is not currently spraying. That way, you can choose where to place the next item (with a single click instead of holding the mouse button down). It is possible to change the previewed (soon-to-be-sprayed) item by right-clicking and then moving the mouse by a tiny amount ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5375 MR #5375]).
* The option to only spray non-overlapping objects now yields faster results through an updated spraying algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5766 MR #5766]).

[[File:Spray tool 1.4.gif|frame|center|Choosing the next item to spray]]

== Import / Export ==

==== PDF Export ====

PDF export now supports internal links (going from one part of the file to another part of the same file, weblinks were supported since Inkscape 1.0). This can be used for creating Tables of Contents, for example ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5237 MR #5237]).

== Dialogs ==

=== About Inkscape ===

* Inkscape's new About Screen is [https://inkscape.org/~Inkonic/%E2%98%85inkscapes-path-artists-blossom Inkonic's "Inkscape's Path–Artist's Blossom"].
* The About Screen dialog now has the ability to display multiple drawings as a slideshow ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5559 MR #5559]).
* The dialog can now be closed by pressing <kbd>Esc</kbd> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5860 MR #5860]).

[[File:Inkscape 1.4 About Screen.png | frame | center| The new About Screen, created by Inkonic for Inkscape 1.4]]

=== Add Layer ===

The 'Add Layer' dialog now shows the three available options all written out directly as radio buttons, instead of hiding them behind a drop-down selection ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]).

[[File:Imageasdasd awdqwdasda.png | frame | center | New layout of 'Add Layer' dialog]]

=== Align and Distribute ===

The alignment options field ''"Relative to"'' now hides irrelevant options when only a single item is selected, with 'Page' being the default ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6510 MR #6510]).

[[File:Inkscape PVs5dVVFsh.gif | frame | center | Better presets in 'Align and Distribute' dialog]]

=== Create Anchor (Hyperlink) / Object Properties ===

To make it easier to select an element in the drawing to link to, a button has been added to the side of the field where the target object's id or the external link must be inserted (Href).

When you click on that button, your mouse cursor will transform into a little hand icon. When the hand hovers over any object or over an empty area of the page, a small indicator text will tell you the id of that object or page. Clicking on the object will automatically insert that object's id into the href field. That way, you do not need to use the Objects or XML dialog to look up the internal identifier of the object you want to link to ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5221 MR #5221])

[[File:Object-picker.gif | frame | center | Creating clickable links from an object to another page / object]]

=== Document properties ===

==== Scale lock ====

A new toggle button that allows you to change the document's viewbox scale without changing the physical size of its contents has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5993 MR #5993]).

[needs image, and a description of why that is useful]

==== Grids ====

The grids subsection in the Document Properties dialog has been overhauled with new grid selector buttons, which automatically add the selected type of grid to the drawing when pressed.

===== Modular Grids =====

A new grid type was added that consists of rectangles with optional gaps in between.

Height, width, horizontal and vertical gap (also negative for overlapping modules) can be adjusted separately. Each grid module (rectangle) can have its own margin set (negative values for inside margin, positive values for outside margin).

[[File:Imageadsa.png|frame|center|Example of a modular grid without gaps]]

===== Axonometric grids =====

The angles of axonometric grids can now also be set by indicating the '''ratio''' between the height and width of the rhombus shape that is formed by it. A common angle for isometric games, for example, is 2:1, corresponding to angles like 26,565051 which are difficult to set exactly without the ratio option ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6132 MR #6132]).

[[File:Inkscape nkL1NDBuw4.gif|frame|center|Automatically setting an angle starting from a ration for axonometric grids]]

=== Export Dialog ===

* If you enter a file system path to a save location that does not exist, Inkscape now tries to create folders instead of warning the user. Only if that fails, it will give a warning now ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5169 MR #5169]).
* Each of the two tabs of the dialog (single file, batch export) now features a little icon in addition to the text ([https://gitlab.com/inkscape/inkscape/-/issues/4338 Bug #4338], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6166 MR #6166]).
* Batch export options have been clarified ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6544 MR #6544]).

[[File:Batch export options 1.4.png|frame|center|Improved batch export options with batch prefix and file type suffix]]

=== Extension Gallery ===

When you want to quickly get an overview which extensions are available to you, you can now browse your Inkscape extensions in a gallery similar to the one for filters.

You can use the search field to quickly find the extension you need. The size of the icons is adjustable. They are currently all still identical placeholders, [https://gitlab.com/inkscape/inbox/-/issues/9907 and we invite you to join us] if you'd like to help. The menu categories can be hidden if you do not need them.

When you hover over an extension, the dialog shows you a small info text with either the menu path to the extension, or a description ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Extension gallery 1.4.gif|frame|center|The new Extension Gallery]]

=== Fill and Stroke ===

==== Gradient Editor ====

It is now possible to control the gradient's angle numerically from the Gradient Editor section of the Fill and Stroke dialog. An additional slider allows for changing the angle by simply dragging. A button to rotate the gradient by 90° completes the new angle controls ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5413 MR #5413]).

[[File:7PviQWIu9r.gif|frame|center|The new gradient angle controls in the 'Fill and Stroke' dialog]]

==== Pattern Editor ====

For users who prefer to have more control when setting the gap between pattern elements, an option has been added to use numerical entry fields (Gap control: precise) instead of the sliders (Gap control: mouse friendly). This allows to add gaps smaller than 20% of the pattern width, in 0.1% steps – and also values larger than 32040%, in case you ever need that pattern rarity! ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5484 MR #5484]).

[[File:Pattern gap control 1.4.gif|frame|center|Controlling the gap between pattern blocks numerically]]

=== Filter Gallery ===

The Filter Gallery can be found in the <code>Filters</code> menu. It shows a scrollable (and hideable) list of all filter categories, and a preview image for each filter, applied to a colorful flower image. Your own filters will appear in the category indicated in your filter file, or, if there isn't any, in the <code>Personal</code> category. Inkscape looks for them in a folder named <code>filters</code> in the folder indicated at <code>Edit ➞ Preferences ➞ System: User config</code>. Some community-contributed files for trying this out can be found [https://inkscape.org/gallery/=inkscape-filter-set/ in our website's gallery] ([https://gitlab.com/inkscape/ux/-/issues/208 Bug UX#208], [https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Inkscape YIRwDrcpcO.gif|frame|center|The Filter Gallery with previews and search]]

=== Layers and Objects ===

When you click on the 'Add' in the Layers and Objects dialog, the 'Add layers' dialog no longer shows up. The button now always adds the new layer above the selected one ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]). To name the layer, double-click on its name. The 'Add Layer' dialog is still available from the Layer menu (or with <kbd>Ctrl+Shift+N</kbd>).

[[File:Inkscape RH105M5BrW.gif|frame|center|Adding new layers faster than ever]]

=== Object Attributes ===

This dialog has been removed. Its contents is now available in the Object Properties dialog.

=== Object Properties ===

This dialog has been merged with the Object Attributes dialog.

It now holds the following information:

* Some properties specific to the selected object type (e.g. rounded corners / width / height for rectangles, number of tips for stars etc.)
** For paths, it now holds editable path data ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6173 MR #6173], like in XML dialog). This is another step toward [https://gitlab.com/inkscape/ux/-/issues/203 ux#203].
** For rectangles, corners can be edited separately by adding the Corners Live Path Effect
** Stars/Polygons can be automatically rotated to their 0° rotation position
* Object ID, label, description, title, highlight color, checkboxes for lock and hide status
* Interactivity (scriptable) properties, such as OnClick, OnMouseOver (input JavaScript)
* When the selected object is enclosed by a hyperlink (added with 'Add hyperlink (anchor)' in right-click menu), the hyperlink's properties (e.g. href, title, role, target) can be edited in this dialog.

[[File:Object properties 1.4.gif|frame|center|The refactored 'Object Properties' dialog]]

=== Path Effects ===

The (optional) button for displaying the older Live Path Effects gallery dialog has been removed along with the dialog. LPEs can now only be selected from the search field / drop down field combination in the Path Effects dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5760 MR #5760]).

=== Preferences ===

==== Snapping ====

More options for finetuning snapping preference between grid and guidelines vs. objects and alignment/distribution have been added at Edit > Preferences > Behavior > Snapping.
These allow you to set grids and / or guidelines as the only available snap target, and to add more snap targets incrementally.

[[File:Snap settings 1.4.png|frame|center|More options for finetuning snapping behavior]]

=== SVG Font Editor ===

The context (right-click) menu entry to 'Sort glyphs' and 'Remove pair' (referring to a kerning pair) have been moved to more discoverable buttons ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5421 MR #5421]).

[[File:Font editor buttons 1.4.png|frame|center|New buttons in 'Font Editor' dialog]]

=== Swatches ===

The Swatches (Palettes) dialog has been overhauled ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5606 MR #5606]).
It now:

* Color palettes are now selected from a dropdown at the top, instead of a small icon at the bottom.
* Colors can be searched by their name.
* Color palettes can be loaded from a file.
* In addition to Gimp Color Palette files, now 'Adobe Color Book' and 'Adobe Swatch Exchange' files are also supported.
* Support for columns: When a palette file defines 'Columns' (in .gpl files, this is indicated by a line like <code>Columns: 9</code> following the name line), the blocks of colors that belong together will stay together (no 'linebreaks' will be added inside any of the blocks), both in the swatches dialog as well as in the palette at the bottom of the Inkscape window.
* A button for accessing the settings, and two buttons for switching between the grid and row view make it easier to adjust the dialog's layout.
* Support for color palettes with CIELAB colors has been added.
* Limited support for color palettes with CMYK colors has been added.
* The transformation from CMYK to RGB has been improved, even without a proper ICC profile. <br />

[[File:Inkscape 8rZ8VQ4Pyn.gif|frame|center|Refactored 'Swatches' dialog with search field]]

=== Text and Font ===

==== General ====

Freshly installed fonts can now be used in Inkscape on Linux, without needing to restart the application. macOS and Windows could not be moved to provide Inkscape with the necessary information ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5240 MR #5240]).

==== Experimental Alternative User Interface ====

An experimental 'Unified font browser' has been added. If it is activated under Edit > Preferences > Interface > Dialogs : Text and Font dialog (requires restart), it will replace the Text and Font dialog with a sortable, filterable, searchable and adjustable list of font previews.

It supports live applying of fonts.That means any font you select will be applied immediately. The 'Font Attributes' tab and 'Text' tab are available, too [https://gitlab.com/inkscape/inkscape/-/merge_requests/4578 MR #4578].

Specifically, these settings are customizable:

* type of preview (rows or grid)
* sort order: alphabetical, font weight, font width (condensed - wide)
* limit list of fonts to selected font collections
* scaling of preview
* preview text (choice between some presets, custom text entry for the long (row view) sample and the short (grid view) sample)
* whether to show the font name below the preview
* in the preferences, the height of the preview lines can be adjusted, as in some cases, fonts look cut off in the list preview

<gallery mode="packed" heights=400px>
File:Unified_font_browser_prefs_1.4.png | Preferences setting for activating and calibrating the experimental Unified Font Browser
File:Unified font browser direct application.gif | Applying a font and changing its size directly without confirmation
File:Unified font browser options gifsicle.gif | Adjusting the dialog by its various options
</gallery>

== Live Path Effects ==

=== Ruler ===

The Ruler Live Path Effect now features several new options:

* Ruler marks can start from the path at an angle (in degrees, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5749 MR #5749]).
* The marks can start at a distance from the path (in percentage of overall mark length, marks are shortened by this amount, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5751 MR #5751]).

[[File:Inkscape Q6nPooVP1O.gif|frame|center|Adjusting the angles of ruler marks and shifting their start in the Ruler Live Path Effect]]

=== Taper Stroke ===

A new option to 'clamp' (cut off) the path's tip instead of tapering it on the selected end of the path has been added. It's available in the 'Start direction' dropdown in the LPE's settings ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5701 MR #5701]).

[[File:Inkscape t6Un74IlV8.gif|frame|center|Clamping the path's tip with the Taper Stroke Live Path Effect]]

== Palettes ==

* Multiple palettes were updated to contain information about the number of columns for optimal display of the palette ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5647 MR #5647]).
* The 'Web Safe' palette has been removed because of the dust that had already settled on it. Its colors were already included with the 'Web Hex' palette, where they now feature an addition ('(Web-safe)') to their label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5653 MR #5653]).
* The 'Windows XP' palette has been removed because of its age ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5645]).
* The default preference for the bottom palette's layout has been adjusted to stretch the tiles and to have them laid out in two rows, so the palette looks nicer when you first install Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6581 MR #6581]).

== Templates ==

* Folding book templates in A4 and Letter format have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).
* Custom templates can now make use of a category and a label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).

[[File:Zine template 1.4.png|frame|center|The Zine Booklet template allows you to quickly generate printable folding booklets.]]

== Customization / Theming ==

=== Customizable Handles ===

The size, color, stroke-width, outline and opacity of on-canvas handles can now be customized, and their shape can be selected from a set of available handle shapes, by copying the CSS file at <code>inkscape/share/ui/node-handles.css</code> into the folder indicated at <code>Edit ➞ Preferences ➞ System: User UI</code> and modifying it. Handles will be updated live in Inkscape as when the file has been saved ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 MR #5624]).

[[File:Inkscape vIWVwzkI0T.gif|frame|center|The new default handles]]

=== Icons ===

A new icon set called is now available for you to select. This new theme, called "Dash" is aimed at covering all of Inkscape's existing features, and reducing complexity on some of the existing icons, while still being explanatory. It also borrows some concepts from industry standard apps. It has 500+ icons, with cursors, scalable and symbolic versions and works on dark and light themes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6115 MR #6115]).

<gallery mode="packed" heights=400px>
File:Dash icons.png|Overview over icons from the new icon set
File:Dash icon theme.png|New icon set in use in the Inkscape interface
</gallery>

=== Keyboard Shortcuts ===

* The shortcuts for "Quick Preview" (<kbd>F</kbd>), "Quick Zoom" (<kbd>Q</kbd>), panning (<kbd>Space</kbd>), "Pen Segment To Line" (<kbd>Shift + L</kbd>), "Pen Segment To Curve" (<kbd>Shift + U</kbd>) and "Pen Segments To Guides" (<kbd>Shift + G</kbd>) are now customizable ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).
* The macOS-specific carbon.xml keyboard shortcuts file has been removed, as it hasn't been kept up to date for years ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6522 MR #6522]).
* Some existing commands that did not have a default shortcut now have one. Note that these will only be available to you if you install Inkscape for the first time, not when upgrading an existing installation. In that case, you can set these manually in <code>Edit > Preferences > Interface > Keyboard</code>, or you can reset your keyboard shortcuts by replacing the file <code>default.xml</code> in your Inkscape user configuration director with a copy of the file <code>inkscape.xml</code> from the <code>keys</code> directory of your Inkscape installation's <code>share</code> directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6462 MR #6462]):
{| class="wikitable"
!Command
!Shortcut
|-
|Apply clipping path
|'''<kbd>Ctrl+M</kbd>'''
|-
|Release clipping path
|'''<kbd>Alt+M</kbd>'''
|-
|Apply inverted clipping path
|'''<kbd>Ctrl+Alt+M</kbd>'''
|-
|Swap fill and stroke colors
|'''<kbd>Shift+X</kbd>'''
|}

== Windows-specific Changes ==

== macOS-specific Changes ==

== Extensions ==

===Features===

==== New extensions====

* An importer for the native file format of '''Affinity Designer (*.afdesign)''' was added as @ManpreetXSingh's Google Summer of Code project ([https://manpreetsingh.hashnode.dev/gsoc-report-inkaf project report]). Since there is no official documentation for this format available, consider this a best-effort implementation. Please [https://inkscape.org/report report] any files that don't import properly.
*An importer for '''CGM (Computer Graphics Metafile)''' was added. Support for this old, but ISO-standardized file format was previously removed with Inkscape 1.0. ([https://gitlab.com/inkscape/extensions/-/merge_requests/638 MR extensions!638])
*The '''Text -> Formula (typst)''' extension converts [https://typst.app typst] math markup into a path, and has a similar function as the LaTeX extension. ([https://gitlab.com/inkscape/extensions/-/merge_requests/606 MR extensions!606])

====Particular extensions ====

* '''Binary DXF''' files (from Autodesk R13 onwards) can now be imported into Inkscape. ([https://gitlab.com/inkscape/extensions/-/merge_requests/629 MR extensions!629], [https://gitlab.com/inkscape/extensions/-/issues/400 extensions#400])
*The '''QR code''' extension now supports multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/595 MR extensions!595]). This can be useful if you want to create a vCard or other multiline formats.
*The '''Printing marks''' extension now adds printing marks to all pages of a document. ([https://gitlab.com/inkscape/extensions/-/merge_requests/634 MR extensions!634])
*The '''Deep Ungroup''' extension now provides an option to preserve groups, which is switched off by default ([https://gitlab.com/inkscape/extensions/-/merge_requests/642 MR extensions!642])

====General Extension Changes====

*Broad range of performance improvements: Usage of more efficient internal Python datatypes speeds up certain extensions by an order of magnitude ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570]). Extensions that rely on <code>CubicSuperPath</code> (e.g. all 'Transform path' extensions) will also notice significant speedups ([https://gitlab.com/inkscape/extensions/-/merge_requests/573 MR extensions!573]). Extensions reading and interpreting CSS rules ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579]) or evaluating the style cascade ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597]) are dramatically faster. These improvements apply to all existing extensions, usually extension authors don't have to modify their code.

===Bugs fixed===

====Particular extensions====

* The '''Add Nodes''' extension now gives symmetric results on arcs, and also splits arcs into smaller arcs. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''Color''' extensions now also work on Mesh gradients ([https://gitlab.com/inkscape/extensions/-/merge_requests/624 MR extensions!624])
*The '''Convert to dashes''' extension is now also more precise for arcs and furthermore doesn't visually change the output for closed subpaths where a dash crosses over the closing position. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''DXF export''' extension no longer draws invisible elements ([https://gitlab.com/inkscape/extensions/-/merge_requests/609 MR extensions!609]) and doesn't trip over SVG comments anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/623 MR extensions!623]).
*A freeze in the details view of the '''Extensions manager''' was fixed ([https://gitlab.com/inkscape/extras/extension-manager/-/issues/19 MR extensions-manager#19])
* The '''Measure''' tool (Length measurement) is now more precise for paths containing arcs, e.g. an arc with radius 50mm now has its length reported as <code>314.1593</code> (correct value: 314.15926...) instead of <code>314.1602</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''N-up layout''' extension could in some cases generate incorrect sizes, which is fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/610 MR extensions!610])
*The '''Plotter''' (HPGL) extension now lifts the pen at the end more reliably ([https://gitlab.com/inkscape/extensions/-/merge_requests/635 MR extensions!635], [https://gitlab.com/inkscape/extensions/-/issues/444 extensions#444], [https://gitlab.com/inkscape/extensions/-/issues/520 extensions#520]), and paths with multiple subpaths are now fully drawn ([https://gitlab.com/inkscape/extensions/-/merge_requests/527 MR extensions!527], [https://gitlab.com/inkscape/extensions/-/issues/522 extensions#522])

====All extensions ====

* Extensions accessing the text of a text element through <code>TextElement.get_text()</code> will now also receive the contents of the nested <code>tspan</code>s. ([https://gitlab.com/inkscape/extensions/-/merge_requests/584 MR extensions!584], [https://gitlab.com/inkscape/extensions/-/merge_requests/617 MR extensions!617], [https://gitlab.com/inkscape/extensions/-/merge_requests/622 MR extensions!622]).
*Fix an issue where <code>duplicate</code> on text elements returned incorrect results. ([https://gitlab.com/inkscape/extensions/-/merge_requests/627 MR extensions!627], [https://gitlab.com/inkscape/extensions/-/issues/480 extensions#480], [https://gitlab.com/inkscape/extensions/-/issues/567 extensions#567])
*Fix for some older extensions: Creating a <code>ffgeom.Segment</code> object no longer results in <code>AttributeError: 'tuple' object has no attribute 'start'</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/636 MR extensions!636])
*Fix a crash when an extension is working with a path containing invalid Arc commands. ([https://gitlab.com/inkscape/extensions/-/merge_requests/640 MR extensions!640], [https://gitlab.com/inkscape/extensions/-/issues/579 extensions#579])
*Some improvements to memory management were made in the extension system ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6109 MR #6109]).

===Extension Development ===

====== Breaking changes / Deprecations ======

* <code>Path.append</code> with list argument has been deprecated, use <code>Path.extend</code> instead. ([https://gitlab.com/inkscape/extensions/-/merge_requests/572 MR extensions!572])
* The ID cache now is kept up-to-date correctly, ensuring that no ID collisions occur accidentally - as a byproduct, style and ID lookups are now constant-time instead of linear-time. If you add <code>etree.ElementBase</code> elements from the SVG namespace manually, the ID caching mechanism will not work correctly, and it's a bad idea anyway. If your extension assigned duplicate IDs, you will need to fix that as it will be an error in 1.4. ([https://gitlab.com/inkscape/extensions/-/merge_requests/581 MR extensions!581])
* <code>group.bounding_box()</code> now excludes invisible objects, and tries to take into account the clip path. <code>group.shape_box()</code> returns a fully unclipped result for all child objects. ([https://gitlab.com/inkscape/extensions/-/merge_requests/618 MR extensions!618])

====== Added / improved functionalities in inkex ======
Path manipulation:
* <code>Vector2d</code> now implements most dunder methods of <code>complex</code>, simplifying the vectorisation of path operations in <code>numpy</code>. Path operations have been sped up by basing their internal computation on complex proper. ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/626 MR extensions!626])
* The <code>transform</code> class is now also based on math on complex numbers. High-level operations that use transforms, such as the transformation of a path, automatically make use of the new API. If you work with transforms manually, you might want to use <code>capply_to_point</code> to get the performance benefits. ([https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570])
*Improvements to the API for working with path segments, such as: length, split at length, gradient/normal, curvature. Accessible through <code>path.proxy_iterator()</code>, the new methods facilitate a lot of what <code>bezier.py</code> is traditionally used for, but without the loss of information that inherently happens when converting to <code>CubicSuperPath</code>. We recommend to avoid <code>CubicSuperPath</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
Style and property access:
* Style evaluations in documents that contain CSS have been sped up dramatically. The API remains unchanged. Also, some complex CSS4 selectors (like <code>:has</code>) are now supported. ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579])
*Styles have been refactored to be faster and more accurate. Use <code>element.get_computed_style(key)</code> to get the computed value for a particular attribute. <code>element.specified_style()(key)</code> will continue to work, but unless you reuse the computed specified_style for many properties, it's less efficient. ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597])
* Attribute access is now more consistent, simplifying the modification of <code>filter</code> and <code>stroke-dasharray</code>. For details, see added [https://inkscape.gitlab.io/extensions/documentation/tutorial/object-editing.html documentation]. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588], [https://gitlab.com/inkscape/extensions/-/merge_requests/632 MR extensions!632]).
* When setting an attribute value to a style attribute, such as <code>element.style["fill"] = LinearGradient.new(...)</code>, the element is automatically inserted into the <code>defs</code> it it hasn't been already. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
Other:
*Simplify reading of RDF meatadata ([https://gitlab.com/inkscape/extensions/-/merge_requests/596 MR extensions!596])
*More filter primitive classes have been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/614 MR extensions!614]).
*Polygon and Polyline can be initialized with a list of points using .new() ([https://gitlab.com/inkscape/extensions/-/merge_requests/592 MR extensions 592])
inx extension descriptor format:
*Extensions that use a custom GUI can now retrieve display error information to the user outside of its own GUI with the attribute <code>show-stderr</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6124 MR #6124]).
*New feature to allow extension authors to pre-process the svg before it's sent to their extension using the new <code><action></code> tag. Additionally there is a pref attribute which controls if the action is run according to an inkscape pref, this isn't expected to be useful to extension authors and is used internally for plain-svg compatibility. ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381])

====Under the hood====

* Allow to skip particularly slow unit tests ([https://gitlab.com/inkscape/extensions/-/merge_requests/571 MR extensions!571]) .
* Improvements to the unit testing framework for stock extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/582 MR extensions!582])
* Improvements for translators ([https://gitlab.com/inkscape/extensions/-/merge_requests/583 MR extensions!583])
*Maintenance work for Python 3.13 ([https://gitlab.com/inkscape/extensions/-/merge_requests/608 MR extensions!608]) and 3.12 ([https://gitlab.com/inkscape/extensions/-/merge_requests/641 MR extensions!641])
*Automated testing form Python 3.12 ([https://gitlab.com/inkscape/extensions/-/merge_requests/615 MR extensions!615])
*Documentation improvements ([https://gitlab.com/inkscape/extensions/-/merge_requests/616 MR extensions!616])
*The shebang at the top of the extension scripts was updated to <code>python3</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/620 MR extensions!620])
*The code formatter was changed from black to ruff ([https://gitlab.com/inkscape/extensions/-/merge_requests/625 MR extensions!625])
== Command line==

*Many new actions have been added to allow editing SVG files and customizing export files ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381]). These are also available from the Command palette:
**Set the document's SVG version to 1.1
**Set the document's SVG version to 2.0
** Remove any Inkscape-specific SVG data
**Remove any known proprietary SVG data
** Remove auto start positions from markers
**Remove all transforms from all shapes
**Remove context paints from markers
**Replace SVG2 text with SVG1.1 text
**Insert JavaScript for rendering meshes (polyfill)
**Insert JavaScript for rendering hatches (polyfill)
**Recursively unlink all clones and symbols
**Turn all shapes recursively into <code>path</code> elements
**Turn all strokes recursively into fill-only paths
**Make all paths absolute and predictable
**Add bounding box information to all shapes: adds <code>inkscape:visualbox</code> and <code>inkscape:geometricbox</code> attributes (only current bounding box, not updated when shape changes)
**Add shape path information to all shapes: adds <code>inkscape:d</code> attribute (only current <code>d</code>, not updated when path is changed)
**Remove unused definitions (gradients, etc.)
*A new option to print a list of all available input file extensions <code>list-input-types</code> has been added. This includes input file names for extensions, and it is also used for filename completion on the command line ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6126 MR #6126]).
*Options for setting the compression (export-png-compression, values 0–9) and antialiasing (export-png-antialias, values 0–3) level have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5167 MR #5167]).
*An option to rotate the page by 90° (page-rotate) has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5594 MR #5594]).
*<nowiki>An action for tracing raster images (object_trace), with expected argument format: {number of scans},{smooth[false|true]},{stack[false|true]},{remove_background[false|true],{speckles},{smooth_corners},{optimize}} (</nowiki>[https://gitlab.com/inkscape/inkscape/-/merge_requests/5842 MR #5842])

==Inkview==

The Inkscape SVG image viewer Inkview now makes use of a (customizable) .ui file instead of a hardcoded GUI ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5899 MR #5899]).

==Bugfixes==

*The snap indicator text no longer flickers when object bounding box and path are in the same location (e.g. borders of a rectangular path) ([https://gitlab.com/inkscape/inkscape/-/issues/4399 Bug #4399], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6157 MR #6157]).
*Clones no longer vanish when their original path is being edited with the Shape Builder Tool ([https://gitlab.com/inkscape/inkscape/-/issues/4682 Bug #4682], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6131 MR #6131]).
* Bump filters and Bevels filters (about 25 different filters) now look again as they were intended, with banding and artifacts much reduced ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6190 MR #6190], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6162 MR #6162]).
*The settings 'Better' and 'Best' for rendering filters now are different again, and 'Better' is a bit faster now ([https://gitlab.com/inkscape/inkscape/-/issues/4722 Bug #4722], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6133 MR #6133]).
*Improvement on internal LPE handling ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6100 MR #6100])
*Stroke to Path no longer results in misplacement of the first node when applied to paths with multiple subpaths ([https://gitlab.com/inkscape/inkscape/-/issues/4709 Bug #4709], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6122 MR #6122]).
*When editing text imported from a PDF, letters before and after your cursor move as expected instead of new text and old text being stacked on top of each other ([https://gitlab.com/inkscape/inkscape/-/issues/297 Bug #297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6414 MR #6414]).
*Right-clicking on selected objects no longer deselects them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6489 MR #6489], [https://gitlab.com/inkscape/inkscape/-/issues/5047 Bug #5047]).
* Pressing the + button to add a new gradient stop now also works when the last gradient stop is selected ([https://gitlab.com/inkscape/inkscape/-/issues/1261 Bug #1261], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6358 MR #6358]).
*Gradient tool regression fixes (since Inkscape 1.0.x, [https://gitlab.com/inkscape/inkscape/-/merge_requests/6361 MR #6361]):
**The tool now again allows to add gradient stops by dragging a color from the palette onto the gradient line ([https://gitlab.com/inkscape/inkscape/-/issues/3472 Bug #3472]).
** Dragging a color from the color palette to a gradient object will now respect all the selected gradient nodes irrespective of the drop location.
**Dropping a color on a gradient object when no gradient nodes are selected will automatically determine the closest gradient node to the mouse and apply the color to it ([https://gitlab.com/inkscape/inkscape/-/issues/4466 Bug #4466]).
**Selecting a color from the color palette when no gradient node of the selected object is selected will automatically apply the color to the first gradient node of the selected object.
*and dozens of other bugs that are too many to list them all out here. You can find a (very incomplete) list of closed bug reports for the 1.4 milestone [https://gitlab.com/inkscape/inkscape/-/issues/?sort=created_date&state=closed&milestone_title=Inkscape%201.4&first_page_size=20 in our bug tracker].

[[File:Inkscape owz9gNDaXy.gif|frame|center|Gradient tool capabilities restored]]

==Behind the Curtains==

These are changes that are not visible to the end user, but make development easier, maintain operating system compatibility and help to future-proof Inkscape:

*Lots and lots of changes have been made to prepare Inkscape for the updated user interface framework GTK 4. Those changes should not be noticeable in Inkscape 1.4, but will help us with fixing bugs in multiple branches of Inkscape simultaneously (Inkscape 1.4.x and master/1.5.x).
*Many parts of the code have been refactored, code has been simplified and modernized.
*The code was adjusted to stay compatible with newer versions of third-party libraries.
*Our automatic builds and dependency lists have been updated and changed many times, continuously adjusting to currently available packages for various operating systems and compilation frameworks.

==Translations==

The following languages have been updated for this version (as of July 26):

*Basque
*Belarusian
*British English
*Catalan
*Croatian
*German
*Hebrew
*Hungarian
*Icelandic
*Italian
*Japanese
*Korean
*Portuguese
* Romanian
*Russian
*Simplified Chinese
*Slovenian
*Spanish
*Traditional Chinese
* Ukrainian

===Contributing to interface translations===

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

==Documentation==

Documentation translations were updated in:

*Hungarian

==Website==

==Important Inkscape Project Milestones==

==Important Changes for Packagers==

*The compile flag <code>WITH_INTERNAL_CAIRO</code> has been removed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6093 MR #6093]).
*tinycss2 is now needed for Inkscape extensions (and export) to work ([https://gitlab.com/inkscape/inkscape/-/issues/5070 Bug #5070]).

==Known issues==

*The background work for moving to GTK4 can potentially reduce Inkscape's performance, most notably on Windows.

==Other releases==

{{:Release notes}}

Release notes/1.4

2024-09-22T18:47:49Z

Joneuhauser: /* Extensions */

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

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: May 16, 2023)]
* [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:

* https://gitlab.com/inkscape/inbox/-/issues/10309 - spray tool performance drop bug
* https://gitlab.com/inkscape/inbox/-/issues/10110 - extension gallery tooltip bug ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6257 MR])
* https://gitlab.com/inkscape/inbox/-/issues/10308 - export dialog icons bug
* https://gitlab.com/inkscape/inbox/-/issues/10112 - object picker UX bugs
* https://gitlab.com/inkscape/inbox/-/issues/10113 - scale lock bug
* https://gitlab.com/inkscape/inkscape/-/merge_requests/5993#note_1820038476 - scale lock use case required for better explanation
* https://gitlab.com/inkscape/inkscape/-/merge_requests/6199#note_1889273098 - ellipse snapping

}}

== Release highlights ==

* '''Filter Gallery:''' it has never been so easy to find the best filter for your needs! This new dialog features previews, categories and search.
* '''Modular grids & improved axonometric grids:''' set the grid angle by ratio for isometric designs and use modular grids to plan layouts and make icons!
* '''Swatches dialog and palette file handling improved:''' quick access to dialog layout controls, search for colors, and open different palette file formats!
* '''Unified font browser preview:''' when activated in the preferences, use it to quickly browse through your font collection. Try it out and give your feedback!
* '''Customizable handles:''' Power users with CSS knowledge can now customize the styling and basic shape of all the handles!
* '''Fast image clipping with the Shape Builder:''' raster graphics can now be clipped into multiple sections using the Shape Builder.
* '''There's even more:''' new templates for folding booklets, additional options in Ruler and Taper Stroke LPE, preview in Spray tool, many new command line options, updated translations and many bug fixes.

== Canvas ==

=== Guides ===

When creating a new guide, all guides are now unlocked, so the new guide can be moved and adjusted freely ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5814 MR #5814]).

== Tools ==

=== General ===

Toolbars now try to make use of the available space by not hiding options in dropdown menus when there's enough space. Instead, they are sorted into multiple, dropdown menus, when the window is shrunk or there is not enough space.

Previously, any options that did not fit went into the same small arrow dropdown at the end of the toolbar and were hard to discover.

The change also leads to a larger minimal width of the Inkscape window, which is now dependent upon the selected tool with its collapsed toolbar items.

=== Node Tool ===

* The mouse/keyboard shortcut for converting a curved path segment to a straight line has been changed from <kbd>Ctrl+Click</kbd> to <kbd>Alt+Double-click</kbd> as a fix to the double-click action of the 'delete segment' command not being recognized correctly ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6504 MR #6504]).
* Deleting a node now behaves differently again ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6285 MR #6285], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6635 MR #6635]). With the preference option 'Edit > Preferences > Node tool: Deleting node preserves shape' active, Inkscape will use its node sharpness autodetection to decide whether the shape will be kept, or the node will be removed without adjusting the adjacent nodes' handles. With the option inactive, Inkscape will behave like Inkscape 1.2 (no autodetection, shape is kept when pressing Del, straight lines with Ctrl + Del).

{| class="wikitable"
|+ Node deletion behavior
|-
! Keys pressed !! Curve is (almost) cusp !! Curve is smooth
|-
| Del + Preference for keeping shape is active || Adjacent handles will not be adjusted || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|-
| Del + Preference for keeping shape is not active || Adjacent handles will be adjusted to try and keep the shape || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is not active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|}

=== Pen Tool ===

A new option has been added to automatically convert the currently drawn shape to guides, allowing users to 'draw' guides instead of dragging them out of the rulers. It comes without a keyboard shortcut, but you can set one in the preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).

=== Rectangle Tool ===

A new mode to only draw squares with Alt + Ctrl has been added to the tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6199 MR #6199]).

=== Selector Tool & Node Tool ===

* In Edit > Preferences > Behavior > Steps, an option has been added to change how moving selected objects / nodes with the arrow keys works when the canvas is rotated (Arrow keys move object relative to screen). If you're working with a rotated canvas, now, by default, the arrow keys will move the selection horizontally and vertically relative to the screen, not to the rotated document. This allows to work more intuitively while the canvas is rotated. Disabling the option will restore the previous behavior ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5031 MR #5031]).
* In the preferences settings for both tools, options for changing the active layer and active page when using the tool to select an object have been added. The Selector tool will change both active layer and active page, while the Node tool will change neither, by default. Other tools (Text tool, Rectangle tool, …) do not change either layer or page when being used (but they can, if you edit the preferences.xml file in a text editor, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5257 MR #5257]).

=== Shape Builder Tool ===

Several improvements were made to the Shape Builder ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5428 MR #5428]):

* The Shape Builder tool can now make use of raster graphics, too. Any paths selected together with a raster (pixel) graphic will now function as clipping paths, their colors are not preserved - unlike when you have only paths in the selection. The resulting image parts use clipped clones of the image, to keep the file size small and improve performance. If you want to edit them, you need to unlink the clones.
* An option for the transparency level of the original drawing has been added (the eye icon opens a popup slider).
* Optionally, it is now possible to keep a copy of the original objects after the Shape Builder's operation. This option is deactivated by default.

[[File:Inkscape_lgi0590pMq-ezgif.com-optimize_(1).gif|frame|center|Using the Shape Builder Tool to quickly split a raster graphic into multiple parts]]

=== Spray Tool ===

* The Spray Tool now shows an outline preview of the next item that it is going to spray, including its shape, rotation and size. The preview is only visible when the tool is not currently spraying. That way, you can choose where to place the next item (with a single click instead of holding the mouse button down). It is possible to change the previewed (soon-to-be-sprayed) item by right-clicking and then moving the mouse by a tiny amount ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5375 MR #5375]).
* The option to only spray non-overlapping objects now yields faster results through an updated spraying algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5766 MR #5766]).

[[File:Spray tool 1.4.gif|frame|center|Choosing the next item to spray]]

== Import / Export ==

==== PDF Export ====

PDF export now supports internal links (going from one part of the file to another part of the same file, weblinks were supported since Inkscape 1.0). This can be used for creating Tables of Contents, for example ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5237 MR #5237]).

== Dialogs ==

=== About Inkscape ===

* Inkscape's new About Screen is [https://inkscape.org/~Inkonic/%E2%98%85inkscapes-path-artists-blossom Inkonic's "Inkscape's Path–Artist's Blossom"].
* The About Screen dialog now has the ability to display multiple drawings as a slideshow ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5559 MR #5559]).
* The dialog can now be closed by pressing <kbd>Esc</kbd> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5860 MR #5860]).

[[File:Inkscape 1.4 About Screen.png | frame | center| The new About Screen, created by Inkonic for Inkscape 1.4]]

=== Add Layer ===

The 'Add Layer' dialog now shows the three available options all written out directly as radio buttons, instead of hiding them behind a drop-down selection ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]).

[[File:Imageasdasd awdqwdasda.png | frame | center | New layout of 'Add Layer' dialog]]

=== Align and Distribute ===

The alignment options field ''"Relative to"'' now hides irrelevant options when only a single item is selected, with 'Page' being the default ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6510 MR #6510]).

[[File:Inkscape PVs5dVVFsh.gif | frame | center | Better presets in 'Align and Distribute' dialog]]

=== Create Anchor (Hyperlink) / Object Properties ===

To make it easier to select an element in the drawing to link to, a button has been added to the side of the field where the target object's id or the external link must be inserted (Href).

When you click on that button, your mouse cursor will transform into a little hand icon. When the hand hovers over any object or over an empty area of the page, a small indicator text will tell you the id of that object or page. Clicking on the object will automatically insert that object's id into the href field. That way, you do not need to use the Objects or XML dialog to look up the internal identifier of the object you want to link to ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5221 MR #5221])

[[File:Object-picker.gif | frame | center | Creating clickable links from an object to another page / object]]

=== Document properties ===

==== Scale lock ====

A new toggle button that allows you to change the document's viewbox scale without changing the physical size of its contents has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5993 MR #5993]).

[needs image, and a description of why that is useful]

==== Grids ====

The grids subsection in the Document Properties dialog has been overhauled with new grid selector buttons, which automatically add the selected type of grid to the drawing when pressed.

===== Modular Grids =====

A new grid type was added that consists of rectangles with optional gaps in between.

Height, width, horizontal and vertical gap (also negative for overlapping modules) can be adjusted separately. Each grid module (rectangle) can have its own margin set (negative values for inside margin, positive values for outside margin).

[[File:Imageadsa.png|frame|center|Example of a modular grid without gaps]]

===== Axonometric grids =====

The angles of axonometric grids can now also be set by indicating the '''ratio''' between the height and width of the rhombus shape that is formed by it. A common angle for isometric games, for example, is 2:1, corresponding to angles like 26,565051 which are difficult to set exactly without the ratio option ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6132 MR #6132]).

[[File:Inkscape nkL1NDBuw4.gif|frame|center|Automatically setting an angle starting from a ration for axonometric grids]]

=== Export Dialog ===

* If you enter a file system path to a save location that does not exist, Inkscape now tries to create folders instead of warning the user. Only if that fails, it will give a warning now ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5169 MR #5169]).
* Each of the two tabs of the dialog (single file, batch export) now features a little icon in addition to the text ([https://gitlab.com/inkscape/inkscape/-/issues/4338 Bug #4338], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6166 MR #6166]).
* Batch export options have been clarified ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6544 MR #6544]).

[[File:Batch export options 1.4.png|frame|center|Improved batch export options with batch prefix and file type suffix]]

=== Extension Gallery ===

When you want to quickly get an overview which extensions are available to you, you can now browse your Inkscape extensions in a gallery similar to the one for filters.

You can use the search field to quickly find the extension you need. The size of the icons is adjustable. They are currently all still identical placeholders, [https://gitlab.com/inkscape/inbox/-/issues/9907 and we invite you to join us] if you'd like to help. The menu categories can be hidden if you do not need them.

When you hover over an extension, the dialog shows you a small info text with either the menu path to the extension, or a description ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Extension gallery 1.4.gif|frame|center|The new Extension Gallery]]

=== Fill and Stroke ===

==== Gradient Editor ====

It is now possible to control the gradient's angle numerically from the Gradient Editor section of the Fill and Stroke dialog. An additional slider allows for changing the angle by simply dragging. A button to rotate the gradient by 90° completes the new angle controls ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5413 MR #5413]).

[[File:7PviQWIu9r.gif|frame|center|The new gradient angle controls in the 'Fill and Stroke' dialog]]

==== Pattern Editor ====

For users who prefer to have more control when setting the gap between pattern elements, an option has been added to use numerical entry fields (Gap control: precise) instead of the sliders (Gap control: mouse friendly). This allows to add gaps smaller than 20% of the pattern width, in 0.1% steps – and also values larger than 32040%, in case you ever need that pattern rarity! ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5484 MR #5484]).

[[File:Pattern gap control 1.4.gif|frame|center|Controlling the gap between pattern blocks numerically]]

=== Filter Gallery ===

The Filter Gallery can be found in the <code>Filters</code> menu. It shows a scrollable (and hideable) list of all filter categories, and a preview image for each filter, applied to a colorful flower image. Your own filters will appear in the category indicated in your filter file, or, if there isn't any, in the <code>Personal</code> category. Inkscape looks for them in a folder named <code>filters</code> in the folder indicated at <code>Edit ➞ Preferences ➞ System: User config</code>. Some community-contributed files for trying this out can be found [https://inkscape.org/gallery/=inkscape-filter-set/ in our website's gallery] ([https://gitlab.com/inkscape/ux/-/issues/208 Bug UX#208], [https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Inkscape YIRwDrcpcO.gif|frame|center|The Filter Gallery with previews and search]]

=== Layers and Objects ===

When you click on the 'Add' in the Layers and Objects dialog, the 'Add layers' dialog no longer shows up. The button now always adds the new layer above the selected one ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]). To name the layer, double-click on its name. The 'Add Layer' dialog is still available from the Layer menu (or with <kbd>Ctrl+Shift+N</kbd>).

[[File:Inkscape RH105M5BrW.gif|frame|center|Adding new layers faster than ever]]

=== Object Attributes ===

This dialog has been removed. Its contents is now available in the Object Properties dialog.

=== Object Properties ===

This dialog has been merged with the Object Attributes dialog.

It now holds the following information:

* Some properties specific to the selected object type (e.g. rounded corners / width / height for rectangles, number of tips for stars etc.)
** For paths, it now holds editable path data ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6173 MR #6173], like in XML dialog). This is another step toward [https://gitlab.com/inkscape/ux/-/issues/203 ux#203].
** For rectangles, corners can be edited separately by adding the Corners Live Path Effect
** Stars/Polygons can be automatically rotated to their 0° rotation position
* Object ID, label, description, title, highlight color, checkboxes for lock and hide status
* Interactivity (scriptable) properties, such as OnClick, OnMouseOver (input JavaScript)
* When the selected object is enclosed by a hyperlink (added with 'Add hyperlink (anchor)' in right-click menu), the hyperlink's properties (e.g. href, title, role, target) can be edited in this dialog.

[[File:Object properties 1.4.gif|frame|center|The refactored 'Object Properties' dialog]]

=== Path Effects ===

The (optional) button for displaying the older Live Path Effects gallery dialog has been removed along with the dialog. LPEs can now only be selected from the search field / drop down field combination in the Path Effects dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5760 MR #5760]).

=== Preferences ===

==== Snapping ====

More options for finetuning snapping preference between grid and guidelines vs. objects and alignment/distribution have been added at Edit > Preferences > Behavior > Snapping.
These allow you to set grids and / or guidelines as the only available snap target, and to add more snap targets incrementally.

[[File:Snap settings 1.4.png|frame|center|More options for finetuning snapping behavior]]

=== SVG Font Editor ===

The context (right-click) menu entry to 'Sort glyphs' and 'Remove pair' (referring to a kerning pair) have been moved to more discoverable buttons ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5421 MR #5421]).

[[File:Font editor buttons 1.4.png|frame|center|New buttons in 'Font Editor' dialog]]

=== Swatches ===

The Swatches (Palettes) dialog has been overhauled ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5606 MR #5606]).
It now:

* Color palettes are now selected from a dropdown at the top, instead of a small icon at the bottom.
* Colors can be searched by their name.
* Color palettes can be loaded from a file.
* In addition to Gimp Color Palette files, now 'Adobe Color Book' and 'Adobe Swatch Exchange' files are also supported.
* Support for columns: When a palette file defines 'Columns' (in .gpl files, this is indicated by a line like <code>Columns: 9</code> following the name line), the blocks of colors that belong together will stay together (no 'linebreaks' will be added inside any of the blocks), both in the swatches dialog as well as in the palette at the bottom of the Inkscape window.
* A button for accessing the settings, and two buttons for switching between the grid and row view make it easier to adjust the dialog's layout.
* Support for color palettes with CIELAB colors has been added.
* Limited support for color palettes with CMYK colors has been added.
* The transformation from CMYK to RGB has been improved, even without a proper ICC profile. <br />

[[File:Inkscape 8rZ8VQ4Pyn.gif|frame|center|Refactored 'Swatches' dialog with search field]]

=== Text and Font ===

==== General ====

Freshly installed fonts can now be used in Inkscape on Linux, without needing to restart the application. macOS and Windows could not be moved to provide Inkscape with the necessary information ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5240 MR #5240]).

==== Experimental Alternative User Interface ====

An experimental 'Unified font browser' has been added. If it is activated under Edit > Preferences > Interface > Dialogs : Text and Font dialog (requires restart), it will replace the Text and Font dialog with a sortable, filterable, searchable and adjustable list of font previews.

It supports live applying of fonts.That means any font you select will be applied immediately. The 'Font Attributes' tab and 'Text' tab are available, too [https://gitlab.com/inkscape/inkscape/-/merge_requests/4578 MR #4578].

Specifically, these settings are customizable:

* type of preview (rows or grid)
* sort order: alphabetical, font weight, font width (condensed - wide)
* limit list of fonts to selected font collections
* scaling of preview
* preview text (choice between some presets, custom text entry for the long (row view) sample and the short (grid view) sample)
* whether to show the font name below the preview
* in the preferences, the height of the preview lines can be adjusted, as in some cases, fonts look cut off in the list preview

<gallery mode="packed" heights=400px>
File:Unified_font_browser_prefs_1.4.png | Preferences setting for activating and calibrating the experimental Unified Font Browser
File:Unified font browser direct application.gif | Applying a font and changing its size directly without confirmation
File:Unified font browser options gifsicle.gif | Adjusting the dialog by its various options
</gallery>

== Live Path Effects ==

=== Ruler ===

The Ruler Live Path Effect now features several new options:

* Ruler marks can start from the path at an angle (in degrees, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5749 MR #5749]).
* The marks can start at a distance from the path (in percentage of overall mark length, marks are shortened by this amount, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5751 MR #5751]).

[[File:Inkscape Q6nPooVP1O.gif|frame|center|Adjusting the angles of ruler marks and shifting their start in the Ruler Live Path Effect]]

=== Taper Stroke ===

A new option to 'clamp' (cut off) the path's tip instead of tapering it on the selected end of the path has been added. It's available in the 'Start direction' dropdown in the LPE's settings ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5701 MR #5701]).

[[File:Inkscape t6Un74IlV8.gif|frame|center|Clamping the path's tip with the Taper Stroke Live Path Effect]]

== Palettes ==

* Multiple palettes were updated to contain information about the number of columns for optimal display of the palette ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5647 MR #5647]).
* The 'Web Safe' palette has been removed because of the dust that had already settled on it. Its colors were already included with the 'Web Hex' palette, where they now feature an addition ('(Web-safe)') to their label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5653 MR #5653]).
* The 'Windows XP' palette has been removed because of its age ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5645]).
* The default preference for the bottom palette's layout has been adjusted to stretch the tiles and to have them laid out in two rows, so the palette looks nicer when you first install Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6581 MR #6581]).

== Templates ==

* Folding book templates in A4 and Letter format have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).
* Custom templates can now make use of a category and a label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).

[[File:Zine template 1.4.png|frame|center|The Zine Booklet template allows you to quickly generate printable folding booklets.]]

== Customization / Theming ==

=== Customizable Handles ===

The size, color, stroke-width, outline and opacity of on-canvas handles can now be customized, and their shape can be selected from a set of available handle shapes, by copying the CSS file at <code>inkscape/share/ui/node-handles.css</code> into the folder indicated at <code>Edit ➞ Preferences ➞ System: User UI</code> and modifying it. Handles will be updated live in Inkscape as when the file has been saved ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 MR #5624]).

[[File:Inkscape vIWVwzkI0T.gif|frame|center|The new default handles]]

=== Icons ===

A new icon set called is now available for you to select. This new theme, called "Dash" is aimed at covering all of Inkscape's existing features, and reducing complexity on some of the existing icons, while still being explanatory. It also borrows some concepts from industry standard apps. It has 500+ icons, with cursors, scalable and symbolic versions and works on dark and light themes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6115 MR #6115]).

<gallery mode="packed" heights=400px>
File:Dash icons.png|Overview over icons from the new icon set
File:Dash icon theme.png|New icon set in use in the Inkscape interface
</gallery>

=== Keyboard Shortcuts ===

* The shortcuts for "Quick Preview" (<kbd>F</kbd>), "Quick Zoom" (<kbd>Q</kbd>), panning (<kbd>Space</kbd>), "Pen Segment To Line" (<kbd>Shift + L</kbd>), "Pen Segment To Curve" (<kbd>Shift + U</kbd>) and "Pen Segments To Guides" (<kbd>Shift + G</kbd>) are now customizable ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).
* The macOS-specific carbon.xml keyboard shortcuts file has been removed, as it hasn't been kept up to date for years ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6522 MR #6522]).
* Some existing commands that did not have a default shortcut now have one. Note that these will only be available to you if you install Inkscape for the first time, not when upgrading an existing installation. In that case, you can set these manually in <code>Edit > Preferences > Interface > Keyboard</code>, or you can reset your keyboard shortcuts by replacing the file <code>default.xml</code> in your Inkscape user configuration director with a copy of the file <code>inkscape.xml</code> from the <code>keys</code> directory of your Inkscape installation's <code>share</code> directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6462 MR #6462]):
{| class="wikitable"
!Command
!Shortcut
|-
|Apply clipping path
|'''<kbd>Ctrl+M</kbd>'''
|-
|Release clipping path
|'''<kbd>Alt+M</kbd>'''
|-
|Apply inverted clipping path
|'''<kbd>Ctrl+Alt+M</kbd>'''
|-
|Swap fill and stroke colors
|'''<kbd>Shift+X</kbd>'''
|}

== Windows-specific Changes ==

== macOS-specific Changes ==

== Extensions ==

===Features===

==== New extensions====

* The '''Text -> Formula (typst)''' extension converts [https://typst.app typst] math markup into a path, and has a similar function as the LaTeX extension. ([https://gitlab.com/inkscape/extensions/-/merge_requests/606 MR extensions!606])

====Particular extensions ====

* The '''QR code''' extension now supports multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/595 MR extensions!595]). This can be useful if you want to create a vCard or other multiline formats.
*'''Binary DXF''' files (from Autodesk R13 onwards) can now be imported into Inkscape. ([https://gitlab.com/inkscape/extensions/-/merge_requests/629 MR extensions!629], [https://gitlab.com/inkscape/extensions/-/issues/400 extensions#400])

====General Extension Changes====

*Focus on performance improvements: Usage of more efficient internal Python datatypes speeds up certain extensions by an order of magnitude ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570]). Extensions that rely on <code>CubicSuperPath</code> (e.g. all 'Transform path' extensions) will also notice significant speedups ([https://gitlab.com/inkscape/extensions/-/merge_requests/573 MR extensions!573]). Extensions reading and interpreting CSS rules ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579]) or evaluating the style cascade ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597]) are dramatically faster. These improvements apply to all existing extensions, usually extension authors don't have to modify their code.

===Bugs fixed===

====Particular extensions====

* The '''Add Nodes''' extension now gives symmetric results on arcs, and also splits arcs into smaller arcs. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Measure''' tool (Length measurement) is now more precise for paths containing arcs, e.g. an arc with radius 50mm now has its length reported as <code>314.1593</code> (correct value: 314.15926...) instead of <code>314.1602</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Convert to dashes''' extension is now also more precise for arcs and furthermore doesn't visually change the output for closed subpaths where a dash crosses over the closing position. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''DXF export''' extension no longer draws invisible elements ([https://gitlab.com/inkscape/extensions/-/merge_requests/609 MR extensions!609]) and doesn't trip over SVG comments anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/623 MR extensions!623]).
*The '''N-up layout''' extension could in some cases generate incorrect sizes, which is fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/610 MR extensions!610])
*The '''Color''' extensions now also work on Mesh gradients ([https://gitlab.com/inkscape/extensions/-/merge_requests/624 MR extensions!624])

====All extensions ====

* Extensions accessing the text of a text element through <code>TextElement.get_text()</code> will now also receive the contents of the nested <code>tspan</code>s. ([https://gitlab.com/inkscape/extensions/-/merge_requests/584 MR extensions!584], [https://gitlab.com/inkscape/extensions/-/merge_requests/617 MR extensions!617], [https://gitlab.com/inkscape/extensions/-/merge_requests/622 MR extensions!622]).
*Fix an issue where <code>duplicate</code> on text elements returned incorrect results. ([https://gitlab.com/inkscape/extensions/-/merge_requests/627 MR extensions!627], [https://gitlab.com/inkscape/extensions/-/issues/480 extensions#480], [https://gitlab.com/inkscape/extensions/-/issues/567 extensions#567])

===Extension Development ===

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

* <code>Vector2d</code> now implements most dunder methods of <code>complex</code>, simplifying the vectorisation of path operations in <code>numpy</code>. Path operations have been sped up by basing their internal computation on complex proper. ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/626 MR extensions!626])
* The <code>transform</code> class is now also based on math on complex numbers. High-level operations that use transforms, such as the transformation of a path, automatically make use of the new API. If you work with transforms manually, you might want to use <code>capply_to_point</code> to get the performance benefits. ([https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570])
* <code>Path.append</code> with list argument has been deprecated, use <code>Path.extend</code> instead. ([https://gitlab.com/inkscape/extensions/-/merge_requests/572 MR extensions!572])
* Style evaluations in documents that contain CSS have been sped up dramatically. The API remains unchanged. Also, some complex CSS4 selectors (like <code>:has</code>) are now supported. ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579])
* The ID cache now is kept up-to-date correctly, ensuring that no ID collisions occur accidentally - as a byproduct, style and ID lookups are now constant-time instead of linear-time. If you add <code>etree.ElementBase</code> elements from the SVG namespace manually, the ID caching mechanism will not work correctly, and it's a bad idea anyway. If your extension assigned duplicate IDs, you will need to fix that as it will be an error in 1.4. ([https://gitlab.com/inkscape/extensions/-/merge_requests/581 MR extensions!581])
* Improvements to the API for working with path segments, such as: length, split at length, gradient/normal, curvature. Accessible through <code>path.proxy_iterator()</code>, the new methods facilitate a lot of what <code>bezier.py</code> is traditionally used for, but without the loss of information that inherently happens when converting to <code>CubicSuperPath</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* Attribute access is now more consistent, simplifying the modification of <code>filter</code> and <code>stroke-dasharray</code>. For details, see added [https://inkscape.gitlab.io/extensions/documentation/tutorial/object-editing.html documentation]. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
* When setting an attribute value to a style attribute, such as <code>element.style["fill"] = LinearGradient.new(...)</code>, the element is automatically inserted into the <code>defs</code> it it hasn't been already. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
*Simplify reading of RDF meatadata ([https://gitlab.com/inkscape/extensions/-/merge_requests/596 MR extensions!596])
*Styles have been refactored to be faster and more accurate. Use <code>element.get_computed_style(key)</code> to get the computed value for a particular attribute. <code>element.specified_style()(key)</code> will continue to work, but unless you reuse the computed specified_style for many properties, it's less efficient. ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597])
*More filter primitive classes have been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/614 MR extensions!614]).
*<code>group.bounding_box()</code> now excludes invisible objects, and tries to take into account the clip path. <code>group.shape_box()</code> returns a fully unclipped result for all child objects. ([https://gitlab.com/inkscape/extensions/-/merge_requests/618 MR extensions!618])

==== Extension Development Documentation====

====Under the hood====

* Allow to skip particularly slow unit tests ([https://gitlab.com/inkscape/extensions/-/merge_requests/571 MR extensions!571]) .
* Improvements to the unit testing framework for stock extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/582 MR extensions!582])
* Improvements for translators ([https://gitlab.com/inkscape/extensions/-/merge_requests/583 MR extensions!583])
*Maintenance work for Python 3.13 ([https://gitlab.com/inkscape/extensions/-/merge_requests/608 MR extensions!608])
*Automated testing form Python 3.12 ([https://gitlab.com/inkscape/extensions/-/merge_requests/615 MR extensions!615])
*Documentation improvements ([https://gitlab.com/inkscape/extensions/-/merge_requests/616 MR extensions!616])
*The shebang at the top of the extension scripts was updated to <code>python3</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/620 MR extensions!620])
*The code formatter was changed from black to ruff ([https://gitlab.com/inkscape/extensions/-/merge_requests/625 MR extensions!625])

*New feature to allow extension authors to pre-process the svg before it's sent to their extension using the new `<action>` tag. Additionally there is a pref attribute which controls if the action is run according to an inkscape pref, this isn't expected to be useful to extension authors and is used internally for plain-svg compatibility.
*Extensions that use a custom GUI can now retrieve information from stderr with the attribute <code>show-stderr</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6124 MR #6124]).
*Some improvements to memory management were made in the extension system ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6109 MR #6109]).
*Extensions manager:
**Fix freeze in Details window (inkscape/extras/extension-manager#19 (closed))
**Maintainance updates
*XAML:
**Fix #552 (closed)
**Maintainance updates
*Afdesign:
**Improvements to path parsing & power stroke.
*Gcodetools:
**Maintainance updates
*New Extension for inserting typst generated formulas

== Command line==

*Many new actions have been added to allow editing SVG files and customizing export files ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381]). These are also available from the Command palette:
**Set the document's SVG version to 1.1
**Set the document's SVG version to 2.0
** Remove any Inkscape-specific SVG data
**Remove any known proprietary SVG data
** Remove auto start positions from markers
**Remove all transforms from all shapes
**Remove context paints from markers
**Replace SVG2 text with SVG1.1 text
**Insert JavaScript for rendering meshes (polyfill)
**Insert JavaScript for rendering hatches (polyfill)
**Recursively unlink all clones and symbols
**Turn all shapes recursively into <code>path</code> elements
**Turn all strokes recursively into fill-only paths
**Make all paths absolute and predictable
**Add bounding box information to all shapes: adds <code>inkscape:visualbox</code> and <code>inkscape:geometricbox</code> attributes (only current bounding box, not updated when shape changes)
**Add shape path information to all shapes: adds <code>inkscape:d</code> attribute (only current <code>d</code>, not updated when path is changed)
**Remove unused definitions (gradients, etc.)
*A new option to print a list of all available input file extensions <code>list-input-types</code> has been added. This includes input file names for extensions, and it is also used for filename completion on the command line ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6126 MR #6126]).
*Options for setting the compression (export-png-compression, values 0–9) and antialiasing (export-png-antialias, values 0–3) level have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5167 MR #5167]).
*An option to rotate the page by 90° (page-rotate) has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5594 MR #5594]).
*<nowiki>An action for tracing raster images (object_trace), with expected argument format: {number of scans},{smooth[false|true]},{stack[false|true]},{remove_background[false|true],{speckles},{smooth_corners},{optimize}} (</nowiki>[https://gitlab.com/inkscape/inkscape/-/merge_requests/5842 MR #5842])

==Inkview==

The Inkscape SVG image viewer Inkview now makes use of a (customizable) .ui file instead of a hardcoded GUI ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5899 MR #5899]).

==Bugfixes==

*The snap indicator text no longer flickers when object bounding box and path are in the same location (e.g. borders of a rectangular path) ([https://gitlab.com/inkscape/inkscape/-/issues/4399 Bug #4399], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6157 MR #6157]).
*Clones no longer vanish when their original path is being edited with the Shape Builder Tool ([https://gitlab.com/inkscape/inkscape/-/issues/4682 Bug #4682], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6131 MR #6131]).
* Bump filters and Bevels filters (about 25 different filters) now look again as they were intended, with banding and artifacts much reduced ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6190 MR #6190], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6162 MR #6162]).
*The settings 'Better' and 'Best' for rendering filters now are different again, and 'Better' is a bit faster now ([https://gitlab.com/inkscape/inkscape/-/issues/4722 Bug #4722], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6133 MR #6133]).
*Improvement on internal LPE handling ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6100 MR #6100])
*Stroke to Path no longer results in misplacement of the first node when applied to paths with multiple subpaths ([https://gitlab.com/inkscape/inkscape/-/issues/4709 Bug #4709], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6122 MR #6122]).
*When editing text imported from a PDF, letters before and after your cursor move as expected instead of new text and old text being stacked on top of each other ([https://gitlab.com/inkscape/inkscape/-/issues/297 Bug #297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6414 MR #6414]).
*Right-clicking on selected objects no longer deselects them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6489 MR #6489], [https://gitlab.com/inkscape/inkscape/-/issues/5047 Bug #5047]).
* Pressing the + button to add a new gradient stop now also works when the last gradient stop is selected ([https://gitlab.com/inkscape/inkscape/-/issues/1261 Bug #1261], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6358 MR #6358]).
*Gradient tool regression fixes (since Inkscape 1.0.x, [https://gitlab.com/inkscape/inkscape/-/merge_requests/6361 MR #6361]):
**The tool now again allows to add gradient stops by dragging a color from the palette onto the gradient line ([https://gitlab.com/inkscape/inkscape/-/issues/3472 Bug #3472]).
** Dragging a color from the color palette to a gradient object will now respect all the selected gradient nodes irrespective of the drop location.
**Dropping a color on a gradient object when no gradient nodes are selected will automatically determine the closest gradient node to the mouse and apply the color to it ([https://gitlab.com/inkscape/inkscape/-/issues/4466 Bug #4466]).
**Selecting a color from the color palette when no gradient node of the selected object is selected will automatically apply the color to the first gradient node of the selected object.
*and dozens of other bugs that are too many to list them all out here. You can find a (very incomplete) list of closed bug reports for the 1.4 milestone [https://gitlab.com/inkscape/inkscape/-/issues/?sort=created_date&state=closed&milestone_title=Inkscape%201.4&first_page_size=20 in our bug tracker].

[[File:Inkscape owz9gNDaXy.gif|frame|center|Gradient tool capabilities restored]]

==Behind the Curtains==

These are changes that are not visible to the end user, but make development easier, maintain operating system compatibility and help to future-proof Inkscape:

*Lots and lots of changes have been made to prepare Inkscape for the updated user interface framework GTK 4. Those changes should not be noticeable in Inkscape 1.4, but will help us with fixing bugs in multiple branches of Inkscape simultaneously (Inkscape 1.4.x and master/1.5.x).
*Many parts of the code have been refactored, code has been simplified and modernized.
*The code was adjusted to stay compatible with newer versions of third-party libraries.
*Our automatic builds and dependency lists have been updated and changed many times, continuously adjusting to currently available packages for various operating systems and compilation frameworks.

==Translations==

The following languages have been updated for this version (as of July 26):

*Basque
*Belarusian
*British English
*Catalan
*Croatian
*German
*Hebrew
*Hungarian
*Icelandic
*Italian
*Japanese
*Korean
*Portuguese
* Romanian
*Russian
*Simplified Chinese
*Slovenian
*Spanish
*Traditional Chinese
* Ukrainian

===Contributing to interface translations===

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

==Documentation==

Documentation translations were updated in:

*Hungarian

==Website==

==Important Inkscape Project Milestones==

==Important Changes for Packagers==

*The compile flag <code>WITH_INTERNAL_CAIRO</code> has been removed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6093 MR #6093]).
*tinycss2 is now needed for Inkscape extensions (and export) to work ([https://gitlab.com/inkscape/inkscape/-/issues/5070 Bug #5070]).

==Known issues==

*The background work for moving to GTK4 can potentially reduce Inkscape's performance, most notably on Windows.

==Other releases==

{{:Release notes}}

Release notes/1.4

2024-09-22T18:34:23Z

Joneuhauser: /* Extensions */

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

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: May 16, 2023)]
* [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:

* https://gitlab.com/inkscape/inbox/-/issues/10309 - spray tool performance drop bug
* https://gitlab.com/inkscape/inbox/-/issues/10110 - extension gallery tooltip bug ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6257 MR])
* https://gitlab.com/inkscape/inbox/-/issues/10308 - export dialog icons bug
* https://gitlab.com/inkscape/inbox/-/issues/10112 - object picker UX bugs
* https://gitlab.com/inkscape/inbox/-/issues/10113 - scale lock bug
* https://gitlab.com/inkscape/inkscape/-/merge_requests/5993#note_1820038476 - scale lock use case required for better explanation
* https://gitlab.com/inkscape/inkscape/-/merge_requests/6199#note_1889273098 - ellipse snapping

}}

== Release highlights ==

* '''Filter Gallery:''' it has never been so easy to find the best filter for your needs! This new dialog features previews, categories and search.
* '''Modular grids & improved axonometric grids:''' set the grid angle by ratio for isometric designs and use modular grids to plan layouts and make icons!
* '''Swatches dialog and palette file handling improved:''' quick access to dialog layout controls, search for colors, and open different palette file formats!
* '''Unified font browser preview:''' when activated in the preferences, use it to quickly browse through your font collection. Try it out and give your feedback!
* '''Customizable handles:''' Power users with CSS knowledge can now customize the styling and basic shape of all the handles!
* '''Fast image clipping with the Shape Builder:''' raster graphics can now be clipped into multiple sections using the Shape Builder.
* '''There's even more:''' new templates for folding booklets, additional options in Ruler and Taper Stroke LPE, preview in Spray tool, many new command line options, updated translations and many bug fixes.

== Canvas ==

=== Guides ===

When creating a new guide, all guides are now unlocked, so the new guide can be moved and adjusted freely ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5814 MR #5814]).

== Tools ==

=== General ===

Toolbars now try to make use of the available space by not hiding options in dropdown menus when there's enough space. Instead, they are sorted into multiple, dropdown menus, when the window is shrunk or there is not enough space.

Previously, any options that did not fit went into the same small arrow dropdown at the end of the toolbar and were hard to discover.

The change also leads to a larger minimal width of the Inkscape window, which is now dependent upon the selected tool with its collapsed toolbar items.

=== Node Tool ===

* The mouse/keyboard shortcut for converting a curved path segment to a straight line has been changed from <kbd>Ctrl+Click</kbd> to <kbd>Alt+Double-click</kbd> as a fix to the double-click action of the 'delete segment' command not being recognized correctly ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6504 MR #6504]).
* Deleting a node now behaves differently again ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6285 MR #6285], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6635 MR #6635]). With the preference option 'Edit > Preferences > Node tool: Deleting node preserves shape' active, Inkscape will use its node sharpness autodetection to decide whether the shape will be kept, or the node will be removed without adjusting the adjacent nodes' handles. With the option inactive, Inkscape will behave like Inkscape 1.2 (no autodetection, shape is kept when pressing Del, straight lines with Ctrl + Del).

{| class="wikitable"
|+ Node deletion behavior
|-
! Keys pressed !! Curve is (almost) cusp !! Curve is smooth
|-
| Del + Preference for keeping shape is active || Adjacent handles will not be adjusted || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|-
| Del + Preference for keeping shape is not active || Adjacent handles will be adjusted to try and keep the shape || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is not active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|}

=== Pen Tool ===

A new option has been added to automatically convert the currently drawn shape to guides, allowing users to 'draw' guides instead of dragging them out of the rulers. It comes without a keyboard shortcut, but you can set one in the preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).

=== Rectangle Tool ===

A new mode to only draw squares with Alt + Ctrl has been added to the tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6199 MR #6199]).

=== Selector Tool & Node Tool ===

* In Edit > Preferences > Behavior > Steps, an option has been added to change how moving selected objects / nodes with the arrow keys works when the canvas is rotated (Arrow keys move object relative to screen). If you're working with a rotated canvas, now, by default, the arrow keys will move the selection horizontally and vertically relative to the screen, not to the rotated document. This allows to work more intuitively while the canvas is rotated. Disabling the option will restore the previous behavior ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5031 MR #5031]).
* In the preferences settings for both tools, options for changing the active layer and active page when using the tool to select an object have been added. The Selector tool will change both active layer and active page, while the Node tool will change neither, by default. Other tools (Text tool, Rectangle tool, …) do not change either layer or page when being used (but they can, if you edit the preferences.xml file in a text editor, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5257 MR #5257]).

=== Shape Builder Tool ===

Several improvements were made to the Shape Builder ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5428 MR #5428]):

* The Shape Builder tool can now make use of raster graphics, too. Any paths selected together with a raster (pixel) graphic will now function as clipping paths, their colors are not preserved - unlike when you have only paths in the selection. The resulting image parts use clipped clones of the image, to keep the file size small and improve performance. If you want to edit them, you need to unlink the clones.
* An option for the transparency level of the original drawing has been added (the eye icon opens a popup slider).
* Optionally, it is now possible to keep a copy of the original objects after the Shape Builder's operation. This option is deactivated by default.

[[File:Inkscape_lgi0590pMq-ezgif.com-optimize_(1).gif|frame|center|Using the Shape Builder Tool to quickly split a raster graphic into multiple parts]]

=== Spray Tool ===

* The Spray Tool now shows an outline preview of the next item that it is going to spray, including its shape, rotation and size. The preview is only visible when the tool is not currently spraying. That way, you can choose where to place the next item (with a single click instead of holding the mouse button down). It is possible to change the previewed (soon-to-be-sprayed) item by right-clicking and then moving the mouse by a tiny amount ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5375 MR #5375]).
* The option to only spray non-overlapping objects now yields faster results through an updated spraying algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5766 MR #5766]).

[[File:Spray tool 1.4.gif|frame|center|Choosing the next item to spray]]

== Import / Export ==

==== PDF Export ====

PDF export now supports internal links (going from one part of the file to another part of the same file, weblinks were supported since Inkscape 1.0). This can be used for creating Tables of Contents, for example ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5237 MR #5237]).

== Dialogs ==

=== About Inkscape ===

* Inkscape's new About Screen is [https://inkscape.org/~Inkonic/%E2%98%85inkscapes-path-artists-blossom Inkonic's "Inkscape's Path–Artist's Blossom"].
* The About Screen dialog now has the ability to display multiple drawings as a slideshow ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5559 MR #5559]).
* The dialog can now be closed by pressing <kbd>Esc</kbd> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5860 MR #5860]).

[[File:Inkscape 1.4 About Screen.png | frame | center| The new About Screen, created by Inkonic for Inkscape 1.4]]

=== Add Layer ===

The 'Add Layer' dialog now shows the three available options all written out directly as radio buttons, instead of hiding them behind a drop-down selection ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]).

[[File:Imageasdasd awdqwdasda.png | frame | center | New layout of 'Add Layer' dialog]]

=== Align and Distribute ===

The alignment options field ''"Relative to"'' now hides irrelevant options when only a single item is selected, with 'Page' being the default ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6510 MR #6510]).

[[File:Inkscape PVs5dVVFsh.gif | frame | center | Better presets in 'Align and Distribute' dialog]]

=== Create Anchor (Hyperlink) / Object Properties ===

To make it easier to select an element in the drawing to link to, a button has been added to the side of the field where the target object's id or the external link must be inserted (Href).

When you click on that button, your mouse cursor will transform into a little hand icon. When the hand hovers over any object or over an empty area of the page, a small indicator text will tell you the id of that object or page. Clicking on the object will automatically insert that object's id into the href field. That way, you do not need to use the Objects or XML dialog to look up the internal identifier of the object you want to link to ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5221 MR #5221])

[[File:Object-picker.gif | frame | center | Creating clickable links from an object to another page / object]]

=== Document properties ===

==== Scale lock ====

A new toggle button that allows you to change the document's viewbox scale without changing the physical size of its contents has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5993 MR #5993]).

[needs image, and a description of why that is useful]

==== Grids ====

The grids subsection in the Document Properties dialog has been overhauled with new grid selector buttons, which automatically add the selected type of grid to the drawing when pressed.

===== Modular Grids =====

A new grid type was added that consists of rectangles with optional gaps in between.

Height, width, horizontal and vertical gap (also negative for overlapping modules) can be adjusted separately. Each grid module (rectangle) can have its own margin set (negative values for inside margin, positive values for outside margin).

[[File:Imageadsa.png|frame|center|Example of a modular grid without gaps]]

===== Axonometric grids =====

The angles of axonometric grids can now also be set by indicating the '''ratio''' between the height and width of the rhombus shape that is formed by it. A common angle for isometric games, for example, is 2:1, corresponding to angles like 26,565051 which are difficult to set exactly without the ratio option ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6132 MR #6132]).

[[File:Inkscape nkL1NDBuw4.gif|frame|center|Automatically setting an angle starting from a ration for axonometric grids]]

=== Export Dialog ===

* If you enter a file system path to a save location that does not exist, Inkscape now tries to create folders instead of warning the user. Only if that fails, it will give a warning now ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5169 MR #5169]).
* Each of the two tabs of the dialog (single file, batch export) now features a little icon in addition to the text ([https://gitlab.com/inkscape/inkscape/-/issues/4338 Bug #4338], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6166 MR #6166]).
* Batch export options have been clarified ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6544 MR #6544]).

[[File:Batch export options 1.4.png|frame|center|Improved batch export options with batch prefix and file type suffix]]

=== Extension Gallery ===

When you want to quickly get an overview which extensions are available to you, you can now browse your Inkscape extensions in a gallery similar to the one for filters.

You can use the search field to quickly find the extension you need. The size of the icons is adjustable. They are currently all still identical placeholders, [https://gitlab.com/inkscape/inbox/-/issues/9907 and we invite you to join us] if you'd like to help. The menu categories can be hidden if you do not need them.

When you hover over an extension, the dialog shows you a small info text with either the menu path to the extension, or a description ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Extension gallery 1.4.gif|frame|center|The new Extension Gallery]]

=== Fill and Stroke ===

==== Gradient Editor ====

It is now possible to control the gradient's angle numerically from the Gradient Editor section of the Fill and Stroke dialog. An additional slider allows for changing the angle by simply dragging. A button to rotate the gradient by 90° completes the new angle controls ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5413 MR #5413]).

[[File:7PviQWIu9r.gif|frame|center|The new gradient angle controls in the 'Fill and Stroke' dialog]]

==== Pattern Editor ====

For users who prefer to have more control when setting the gap between pattern elements, an option has been added to use numerical entry fields (Gap control: precise) instead of the sliders (Gap control: mouse friendly). This allows to add gaps smaller than 20% of the pattern width, in 0.1% steps – and also values larger than 32040%, in case you ever need that pattern rarity! ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5484 MR #5484]).

[[File:Pattern gap control 1.4.gif|frame|center|Controlling the gap between pattern blocks numerically]]

=== Filter Gallery ===

The Filter Gallery can be found in the <code>Filters</code> menu. It shows a scrollable (and hideable) list of all filter categories, and a preview image for each filter, applied to a colorful flower image. Your own filters will appear in the category indicated in your filter file, or, if there isn't any, in the <code>Personal</code> category. Inkscape looks for them in a folder named <code>filters</code> in the folder indicated at <code>Edit ➞ Preferences ➞ System: User config</code>. Some community-contributed files for trying this out can be found [https://inkscape.org/gallery/=inkscape-filter-set/ in our website's gallery] ([https://gitlab.com/inkscape/ux/-/issues/208 Bug UX#208], [https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Inkscape YIRwDrcpcO.gif|frame|center|The Filter Gallery with previews and search]]

=== Layers and Objects ===

When you click on the 'Add' in the Layers and Objects dialog, the 'Add layers' dialog no longer shows up. The button now always adds the new layer above the selected one ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]). To name the layer, double-click on its name. The 'Add Layer' dialog is still available from the Layer menu (or with <kbd>Ctrl+Shift+N</kbd>).

[[File:Inkscape RH105M5BrW.gif|frame|center|Adding new layers faster than ever]]

=== Object Attributes ===

This dialog has been removed. Its contents is now available in the Object Properties dialog.

=== Object Properties ===

This dialog has been merged with the Object Attributes dialog.

It now holds the following information:

* Some properties specific to the selected object type (e.g. rounded corners / width / height for rectangles, number of tips for stars etc.)
** For paths, it now holds editable path data ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6173 MR #6173], like in XML dialog). This is another step toward [https://gitlab.com/inkscape/ux/-/issues/203 ux#203].
** For rectangles, corners can be edited separately by adding the Corners Live Path Effect
** Stars/Polygons can be automatically rotated to their 0° rotation position
* Object ID, label, description, title, highlight color, checkboxes for lock and hide status
* Interactivity (scriptable) properties, such as OnClick, OnMouseOver (input JavaScript)
* When the selected object is enclosed by a hyperlink (added with 'Add hyperlink (anchor)' in right-click menu), the hyperlink's properties (e.g. href, title, role, target) can be edited in this dialog.

[[File:Object properties 1.4.gif|frame|center|The refactored 'Object Properties' dialog]]

=== Path Effects ===

The (optional) button for displaying the older Live Path Effects gallery dialog has been removed along with the dialog. LPEs can now only be selected from the search field / drop down field combination in the Path Effects dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5760 MR #5760]).

=== Preferences ===

==== Snapping ====

More options for finetuning snapping preference between grid and guidelines vs. objects and alignment/distribution have been added at Edit > Preferences > Behavior > Snapping.
These allow you to set grids and / or guidelines as the only available snap target, and to add more snap targets incrementally.

[[File:Snap settings 1.4.png|frame|center|More options for finetuning snapping behavior]]

=== SVG Font Editor ===

The context (right-click) menu entry to 'Sort glyphs' and 'Remove pair' (referring to a kerning pair) have been moved to more discoverable buttons ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5421 MR #5421]).

[[File:Font editor buttons 1.4.png|frame|center|New buttons in 'Font Editor' dialog]]

=== Swatches ===

The Swatches (Palettes) dialog has been overhauled ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5606 MR #5606]).
It now:

* Color palettes are now selected from a dropdown at the top, instead of a small icon at the bottom.
* Colors can be searched by their name.
* Color palettes can be loaded from a file.
* In addition to Gimp Color Palette files, now 'Adobe Color Book' and 'Adobe Swatch Exchange' files are also supported.
* Support for columns: When a palette file defines 'Columns' (in .gpl files, this is indicated by a line like <code>Columns: 9</code> following the name line), the blocks of colors that belong together will stay together (no 'linebreaks' will be added inside any of the blocks), both in the swatches dialog as well as in the palette at the bottom of the Inkscape window.
* A button for accessing the settings, and two buttons for switching between the grid and row view make it easier to adjust the dialog's layout.
* Support for color palettes with CIELAB colors has been added.
* Limited support for color palettes with CMYK colors has been added.
* The transformation from CMYK to RGB has been improved, even without a proper ICC profile. <br />

[[File:Inkscape 8rZ8VQ4Pyn.gif|frame|center|Refactored 'Swatches' dialog with search field]]

=== Text and Font ===

==== General ====

Freshly installed fonts can now be used in Inkscape on Linux, without needing to restart the application. macOS and Windows could not be moved to provide Inkscape with the necessary information ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5240 MR #5240]).

==== Experimental Alternative User Interface ====

An experimental 'Unified font browser' has been added. If it is activated under Edit > Preferences > Interface > Dialogs : Text and Font dialog (requires restart), it will replace the Text and Font dialog with a sortable, filterable, searchable and adjustable list of font previews.

It supports live applying of fonts.That means any font you select will be applied immediately. The 'Font Attributes' tab and 'Text' tab are available, too [https://gitlab.com/inkscape/inkscape/-/merge_requests/4578 MR #4578].

Specifically, these settings are customizable:

* type of preview (rows or grid)
* sort order: alphabetical, font weight, font width (condensed - wide)
* limit list of fonts to selected font collections
* scaling of preview
* preview text (choice between some presets, custom text entry for the long (row view) sample and the short (grid view) sample)
* whether to show the font name below the preview
* in the preferences, the height of the preview lines can be adjusted, as in some cases, fonts look cut off in the list preview

<gallery mode="packed" heights=400px>
File:Unified_font_browser_prefs_1.4.png | Preferences setting for activating and calibrating the experimental Unified Font Browser
File:Unified font browser direct application.gif | Applying a font and changing its size directly without confirmation
File:Unified font browser options gifsicle.gif | Adjusting the dialog by its various options
</gallery>

== Live Path Effects ==

=== Ruler ===

The Ruler Live Path Effect now features several new options:

* Ruler marks can start from the path at an angle (in degrees, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5749 MR #5749]).
* The marks can start at a distance from the path (in percentage of overall mark length, marks are shortened by this amount, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5751 MR #5751]).

[[File:Inkscape Q6nPooVP1O.gif|frame|center|Adjusting the angles of ruler marks and shifting their start in the Ruler Live Path Effect]]

=== Taper Stroke ===

A new option to 'clamp' (cut off) the path's tip instead of tapering it on the selected end of the path has been added. It's available in the 'Start direction' dropdown in the LPE's settings ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5701 MR #5701]).

[[File:Inkscape t6Un74IlV8.gif|frame|center|Clamping the path's tip with the Taper Stroke Live Path Effect]]

== Palettes ==

* Multiple palettes were updated to contain information about the number of columns for optimal display of the palette ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5647 MR #5647]).
* The 'Web Safe' palette has been removed because of the dust that had already settled on it. Its colors were already included with the 'Web Hex' palette, where they now feature an addition ('(Web-safe)') to their label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5653 MR #5653]).
* The 'Windows XP' palette has been removed because of its age ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5645]).
* The default preference for the bottom palette's layout has been adjusted to stretch the tiles and to have them laid out in two rows, so the palette looks nicer when you first install Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6581 MR #6581]).

== Templates ==

* Folding book templates in A4 and Letter format have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).
* Custom templates can now make use of a category and a label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).

[[File:Zine template 1.4.png|frame|center|The Zine Booklet template allows you to quickly generate printable folding booklets.]]

== Customization / Theming ==

=== Customizable Handles ===

The size, color, stroke-width, outline and opacity of on-canvas handles can now be customized, and their shape can be selected from a set of available handle shapes, by copying the CSS file at <code>inkscape/share/ui/node-handles.css</code> into the folder indicated at <code>Edit ➞ Preferences ➞ System: User UI</code> and modifying it. Handles will be updated live in Inkscape as when the file has been saved ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 MR #5624]).

[[File:Inkscape vIWVwzkI0T.gif|frame|center|The new default handles]]

=== Icons ===

A new icon set called is now available for you to select. This new theme, called "Dash" is aimed at covering all of Inkscape's existing features, and reducing complexity on some of the existing icons, while still being explanatory. It also borrows some concepts from industry standard apps. It has 500+ icons, with cursors, scalable and symbolic versions and works on dark and light themes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6115 MR #6115]).

<gallery mode="packed" heights=400px>
File:Dash icons.png|Overview over icons from the new icon set
File:Dash icon theme.png|New icon set in use in the Inkscape interface
</gallery>

=== Keyboard Shortcuts ===

* The shortcuts for "Quick Preview" (<kbd>F</kbd>), "Quick Zoom" (<kbd>Q</kbd>), panning (<kbd>Space</kbd>), "Pen Segment To Line" (<kbd>Shift + L</kbd>), "Pen Segment To Curve" (<kbd>Shift + U</kbd>) and "Pen Segments To Guides" (<kbd>Shift + G</kbd>) are now customizable ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).
* The macOS-specific carbon.xml keyboard shortcuts file has been removed, as it hasn't been kept up to date for years ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6522 MR #6522]).
* Some existing commands that did not have a default shortcut now have one. Note that these will only be available to you if you install Inkscape for the first time, not when upgrading an existing installation. In that case, you can set these manually in <code>Edit > Preferences > Interface > Keyboard</code>, or you can reset your keyboard shortcuts by replacing the file <code>default.xml</code> in your Inkscape user configuration director with a copy of the file <code>inkscape.xml</code> from the <code>keys</code> directory of your Inkscape installation's <code>share</code> directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6462 MR #6462]):
{| class="wikitable"
!Command
!Shortcut
|-
|Apply clipping path
|'''<kbd>Ctrl+M</kbd>'''
|-
|Release clipping path
|'''<kbd>Alt+M</kbd>'''
|-
|Apply inverted clipping path
|'''<kbd>Ctrl+Alt+M</kbd>'''
|-
|Swap fill and stroke colors
|'''<kbd>Shift+X</kbd>'''
|}

== Windows-specific Changes ==

== macOS-specific Changes ==

== Extensions ==

===Features===

==== New extensions====

* The '''Text -> Formula (typst)''' extension converts [https://typst.app typst] math markup into a path, and has a similar function as the LaTeX extension. ([https://gitlab.com/inkscape/extensions/-/merge_requests/606 MR extensions!606])

====Particular extensions ====

* The QR code extension now supports multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/595 MR extensions!595]). This can be useful if you want to create a vCard or other multiline formats.

====General Extension Changes====

*Focus on performance improvements: Usage of more efficient internal Python datatypes speeds up certain extensions by an order of magnitude ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570]). Extensions that rely on <code>CubicSuperPath</code> (e.g. all 'Transform path' extensions) will also notice significant speedups ([https://gitlab.com/inkscape/extensions/-/merge_requests/573 MR extensions!573]). Extensions reading and interpreting CSS rules ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579]) or evaluating the style cascade ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597]) are dramatically faster. These improvements apply to all existing extensions, usually extension authors don't have to modify their code.

===Bugs fixed===

====Particular extensions====

* The '''Add Nodes''' extension now gives symmetric results on arcs, and also splits arcs into smaller arcs. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Measure''' tool (Length measurement) is now more precise for paths containing arcs, e.g. an arc with radius 50mm now has its length reported as <code>314.1593</code> (correct value: 314.15926...) instead of <code>314.1602</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Convert to dashes''' extension is now also more precise for arcs and furthermore doesn't visually change the output for closed subpaths where a dash crosses over the closing position. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''DXF export''' extension no longer draws invisible elements. ([https://gitlab.com/inkscape/extensions/-/merge_requests/609 MR extensions!609])
*The N-up layout extension could in some cases generate incorrect sizes, which is fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/610 MR extensions!610])

====All extensions ====

* Extensions accessing the text of a text element through <code>TextElement.get_text()</code> will now also receive the contents of the nested <code>tspan</code>s. ([https://gitlab.com/inkscape/extensions/-/merge_requests/584 MR extensions!584], [https://gitlab.com/inkscape/extensions/-/merge_requests/617 MR extensions!617], [https://gitlab.com/inkscape/extensions/-/merge_requests/622 MR extensions!622]).

===Extension Development ===

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

* <code>Vector2d</code> now implements most dunder methods of <code>complex</code>, simplifying the vectorisation of path operations in <code>numpy</code>. The assign method has been removed as <code>complex</code> is immutable. Path operations have been sped up by basing their internal computation on complex proper. ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569])
* The <code>transform</code> class is now also based on math on complex numbers. High-level operations that use transforms, such as the transformation of a path, automatically make use of the new API. If you work with transforms manually, you might want to use <code>capply_to_point</code> to get the performance benefits. ([https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570])
* <code>Path.append</code> with list argument has been deprecated, use <code>Path.extend</code> instead. ([https://gitlab.com/inkscape/extensions/-/merge_requests/572 MR extensions!572])
* Style evaluations in documents that contain CSS have been sped up dramatically. The API remains unchanged. Also, some complex CSS4 selectors (like <code>:has</code>) are now supported. ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579])
* The ID cache now is kept up-to-date correctly, ensuring that no ID collisions occur accidentally - as a byproduct, style and ID lookups are now constant-time instead of linear-time. If you add <code>etree.ElementBase</code> elements from the SVG namespace manually, the ID caching mechanism will not work correctly, and it's a bad idea anyway. If your extension assigned duplicate IDs, you will need to fix that as it will be an error in 1.4. ([https://gitlab.com/inkscape/extensions/-/merge_requests/581 MR extensions!581])
* Improvements to the API for working with path segments, such as: length, split at length, gradient/normal, curvature. Accessible through <code>path.proxy_iterator()</code>, the new methods facilitate a lot of what <code>bezier.py</code> is traditionally used for, but without the loss of information that inherently happens when converting to <code>CubicSuperPath</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* Attribute access is now more consistent, simplifying the modification of <code>filter</code> and <code>stroke-dasharray</code>. For details, see added [https://inkscape.gitlab.io/extensions/documentation/tutorial/object-editing.html documentation]. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
* When setting an attribute value to a style attribute, such as <code>element.style["fill"] = LinearGradient.new(...)</code>, the element is automatically inserted into the <code>defs</code> it it hasn't been already. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
*Simplify reading of RDF meatadata ([https://gitlab.com/inkscape/extensions/-/merge_requests/596 MR extensions!596])
*Styles have been refactored to be faster and more accurate. Use <code>element.get_computed_style(key)</code> to get the computed value for a particular attribute. <code>element.specified_style()(key)</code> will continue to work, but unless you reuse the computed specified_style for many properties, it's less efficient. ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597])
*More filter primitive classes have been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/614 MR extensions!614]).
*<code>group.bounding_box()</code> now excludes invisible objects, and tries to take into account the clip path. <code>group.shape_box()</code> returns a fully unclipped result for all child objects. ([https://gitlab.com/inkscape/extensions/-/merge_requests/618 MR extensions!618])

==== Extension Development Documentation====

====Under the hood====

* Allow to skip particularly slow unit tests ([https://gitlab.com/inkscape/extensions/-/merge_requests/571 MR extensions!571]) .
* Improvements to the unit testing framework for stock extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/582 MR extensions!582])
* Improvements for translators ([https://gitlab.com/inkscape/extensions/-/merge_requests/583 MR extensions!583])
*Maintenance work for Python 3.13 ([https://gitlab.com/inkscape/extensions/-/merge_requests/608 MR extensions!608])
*Automated testing form Python 3.12 ([https://gitlab.com/inkscape/extensions/-/merge_requests/615 MR extensions!615])
*Documentation improvements ([https://gitlab.com/inkscape/extensions/-/merge_requests/616 MR extensions!616])
*The shebang at the top of the extension scripts was updated to <code>python3</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/620 MR extensions!620])

*New feature to allow extension authors to pre-process the svg before it's sent to their extension using the new `<action>` tag. Additionally there is a pref attribute which controls if the action is run according to an inkscape pref, this isn't expected to be useful to extension authors and is used internally for plain-svg compatibility.
*Extensions that use a custom GUI can now retrieve information from stderr with the attribute <code>show-stderr</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6124 MR #6124]).
*Some improvements to memory management were made in the extension system ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6109 MR #6109]).
*Extensions manager:
**Fix freeze in Details window (inkscape/extras/extension-manager#19 (closed))
**Maintainance updates
*XAML:
**Fix #552 (closed)
**Maintainance updates
*Afdesign:
**Improvements to path parsing & power stroke.
*Gcodetools:
**Maintainance updates
*New Extension for inserting typst generated formulas

== Command line==

*Many new actions have been added to allow editing SVG files and customizing export files ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381]). These are also available from the Command palette:
**Set the document's SVG version to 1.1
**Set the document's SVG version to 2.0
** Remove any Inkscape-specific SVG data
**Remove any known proprietary SVG data
** Remove auto start positions from markers
**Remove all transforms from all shapes
**Remove context paints from markers
**Replace SVG2 text with SVG1.1 text
**Insert JavaScript for rendering meshes (polyfill)
**Insert JavaScript for rendering hatches (polyfill)
**Recursively unlink all clones and symbols
**Turn all shapes recursively into <code>path</code> elements
**Turn all strokes recursively into fill-only paths
**Make all paths absolute and predictable
**Add bounding box information to all shapes: adds <code>inkscape:visualbox</code> and <code>inkscape:geometricbox</code> attributes (only current bounding box, not updated when shape changes)
**Add shape path information to all shapes: adds <code>inkscape:d</code> attribute (only current <code>d</code>, not updated when path is changed)
**Remove unused definitions (gradients, etc.)
*A new option to print a list of all available input file extensions <code>list-input-types</code> has been added. This includes input file names for extensions, and it is also used for filename completion on the command line ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6126 MR #6126]).
*Options for setting the compression (export-png-compression, values 0–9) and antialiasing (export-png-antialias, values 0–3) level have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5167 MR #5167]).
*An option to rotate the page by 90° (page-rotate) has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5594 MR #5594]).
*<nowiki>An action for tracing raster images (object_trace), with expected argument format: {number of scans},{smooth[false|true]},{stack[false|true]},{remove_background[false|true],{speckles},{smooth_corners},{optimize}} (</nowiki>[https://gitlab.com/inkscape/inkscape/-/merge_requests/5842 MR #5842])

==Inkview==

The Inkscape SVG image viewer Inkview now makes use of a (customizable) .ui file instead of a hardcoded GUI ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5899 MR #5899]).

==Bugfixes==

*The snap indicator text no longer flickers when object bounding box and path are in the same location (e.g. borders of a rectangular path) ([https://gitlab.com/inkscape/inkscape/-/issues/4399 Bug #4399], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6157 MR #6157]).
*Clones no longer vanish when their original path is being edited with the Shape Builder Tool ([https://gitlab.com/inkscape/inkscape/-/issues/4682 Bug #4682], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6131 MR #6131]).
* Bump filters and Bevels filters (about 25 different filters) now look again as they were intended, with banding and artifacts much reduced ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6190 MR #6190], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6162 MR #6162]).
*The settings 'Better' and 'Best' for rendering filters now are different again, and 'Better' is a bit faster now ([https://gitlab.com/inkscape/inkscape/-/issues/4722 Bug #4722], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6133 MR #6133]).
*Improvement on internal LPE handling ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6100 MR #6100])
*Stroke to Path no longer results in misplacement of the first node when applied to paths with multiple subpaths ([https://gitlab.com/inkscape/inkscape/-/issues/4709 Bug #4709], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6122 MR #6122]).
*When editing text imported from a PDF, letters before and after your cursor move as expected instead of new text and old text being stacked on top of each other ([https://gitlab.com/inkscape/inkscape/-/issues/297 Bug #297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6414 MR #6414]).
*Right-clicking on selected objects no longer deselects them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6489 MR #6489], [https://gitlab.com/inkscape/inkscape/-/issues/5047 Bug #5047]).
* Pressing the + button to add a new gradient stop now also works when the last gradient stop is selected ([https://gitlab.com/inkscape/inkscape/-/issues/1261 Bug #1261], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6358 MR #6358]).
*Gradient tool regression fixes (since Inkscape 1.0.x, [https://gitlab.com/inkscape/inkscape/-/merge_requests/6361 MR #6361]):
**The tool now again allows to add gradient stops by dragging a color from the palette onto the gradient line ([https://gitlab.com/inkscape/inkscape/-/issues/3472 Bug #3472]).
** Dragging a color from the color palette to a gradient object will now respect all the selected gradient nodes irrespective of the drop location.
**Dropping a color on a gradient object when no gradient nodes are selected will automatically determine the closest gradient node to the mouse and apply the color to it ([https://gitlab.com/inkscape/inkscape/-/issues/4466 Bug #4466]).
**Selecting a color from the color palette when no gradient node of the selected object is selected will automatically apply the color to the first gradient node of the selected object.
*and dozens of other bugs that are too many to list them all out here. You can find a (very incomplete) list of closed bug reports for the 1.4 milestone [https://gitlab.com/inkscape/inkscape/-/issues/?sort=created_date&state=closed&milestone_title=Inkscape%201.4&first_page_size=20 in our bug tracker].

[[File:Inkscape owz9gNDaXy.gif|frame|center|Gradient tool capabilities restored]]

==Behind the Curtains==

These are changes that are not visible to the end user, but make development easier, maintain operating system compatibility and help to future-proof Inkscape:

*Lots and lots of changes have been made to prepare Inkscape for the updated user interface framework GTK 4. Those changes should not be noticeable in Inkscape 1.4, but will help us with fixing bugs in multiple branches of Inkscape simultaneously (Inkscape 1.4.x and master/1.5.x).
*Many parts of the code have been refactored, code has been simplified and modernized.
*The code was adjusted to stay compatible with newer versions of third-party libraries.
*Our automatic builds and dependency lists have been updated and changed many times, continuously adjusting to currently available packages for various operating systems and compilation frameworks.

==Translations==

The following languages have been updated for this version (as of July 26):

*Basque
*Belarusian
*British English
*Catalan
*Croatian
*German
*Hebrew
*Hungarian
*Icelandic
*Italian
*Japanese
*Korean
*Portuguese
* Romanian
*Russian
*Simplified Chinese
*Slovenian
*Spanish
*Traditional Chinese
* Ukrainian

===Contributing to interface translations===

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

==Documentation==

Documentation translations were updated in:

*Hungarian

==Website==

==Important Inkscape Project Milestones==

==Important Changes for Packagers==

*The compile flag <code>WITH_INTERNAL_CAIRO</code> has been removed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6093 MR #6093]).
*tinycss2 is now needed for Inkscape extensions (and export) to work ([https://gitlab.com/inkscape/inkscape/-/issues/5070 Bug #5070]).

==Known issues==

*The background work for moving to GTK4 can potentially reduce Inkscape's performance, most notably on Windows.

==Other releases==

{{:Release notes}}

Release notes/1.4

2024-09-22T18:24:59Z

Joneuhauser: /* Extensions */

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

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: May 16, 2023)]
* [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:

* https://gitlab.com/inkscape/inbox/-/issues/10309 - spray tool performance drop bug
* https://gitlab.com/inkscape/inbox/-/issues/10110 - extension gallery tooltip bug ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6257 MR])
* https://gitlab.com/inkscape/inbox/-/issues/10308 - export dialog icons bug
* https://gitlab.com/inkscape/inbox/-/issues/10112 - object picker UX bugs
* https://gitlab.com/inkscape/inbox/-/issues/10113 - scale lock bug
* https://gitlab.com/inkscape/inkscape/-/merge_requests/5993#note_1820038476 - scale lock use case required for better explanation
* https://gitlab.com/inkscape/inkscape/-/merge_requests/6199#note_1889273098 - ellipse snapping

}}

== Release highlights ==

* '''Filter Gallery:''' it has never been so easy to find the best filter for your needs! This new dialog features previews, categories and search.
* '''Modular grids & improved axonometric grids:''' set the grid angle by ratio for isometric designs and use modular grids to plan layouts and make icons!
* '''Swatches dialog and palette file handling improved:''' quick access to dialog layout controls, search for colors, and open different palette file formats!
* '''Unified font browser preview:''' when activated in the preferences, use it to quickly browse through your font collection. Try it out and give your feedback!
* '''Customizable handles:''' Power users with CSS knowledge can now customize the styling and basic shape of all the handles!
* '''Fast image clipping with the Shape Builder:''' raster graphics can now be clipped into multiple sections using the Shape Builder.
* '''There's even more:''' new templates for folding booklets, additional options in Ruler and Taper Stroke LPE, preview in Spray tool, many new command line options, updated translations and many bug fixes.

== Canvas ==

=== Guides ===

When creating a new guide, all guides are now unlocked, so the new guide can be moved and adjusted freely ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5814 MR #5814]).

== Tools ==

=== General ===

Toolbars now try to make use of the available space by not hiding options in dropdown menus when there's enough space. Instead, they are sorted into multiple, dropdown menus, when the window is shrunk or there is not enough space.

Previously, any options that did not fit went into the same small arrow dropdown at the end of the toolbar and were hard to discover.

The change also leads to a larger minimal width of the Inkscape window, which is now dependent upon the selected tool with its collapsed toolbar items.

=== Node Tool ===

* The mouse/keyboard shortcut for converting a curved path segment to a straight line has been changed from <kbd>Ctrl+Click</kbd> to <kbd>Alt+Double-click</kbd> as a fix to the double-click action of the 'delete segment' command not being recognized correctly ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6504 MR #6504]).
* Deleting a node now behaves differently again ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6285 MR #6285], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6635 MR #6635]). With the preference option 'Edit > Preferences > Node tool: Deleting node preserves shape' active, Inkscape will use its node sharpness autodetection to decide whether the shape will be kept, or the node will be removed without adjusting the adjacent nodes' handles. With the option inactive, Inkscape will behave like Inkscape 1.2 (no autodetection, shape is kept when pressing Del, straight lines with Ctrl + Del).

{| class="wikitable"
|+ Node deletion behavior
|-
! Keys pressed !! Curve is (almost) cusp !! Curve is smooth
|-
| Del + Preference for keeping shape is active || Adjacent handles will not be adjusted || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|-
| Del + Preference for keeping shape is not active || Adjacent handles will be adjusted to try and keep the shape || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is not active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|}

=== Pen Tool ===

A new option has been added to automatically convert the currently drawn shape to guides, allowing users to 'draw' guides instead of dragging them out of the rulers. It comes without a keyboard shortcut, but you can set one in the preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).

=== Rectangle Tool ===

A new mode to only draw squares with Alt + Ctrl has been added to the tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6199 MR #6199]).

=== Selector Tool & Node Tool ===

* In Edit > Preferences > Behavior > Steps, an option has been added to change how moving selected objects / nodes with the arrow keys works when the canvas is rotated (Arrow keys move object relative to screen). If you're working with a rotated canvas, now, by default, the arrow keys will move the selection horizontally and vertically relative to the screen, not to the rotated document. This allows to work more intuitively while the canvas is rotated. Disabling the option will restore the previous behavior ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5031 MR #5031]).
* In the preferences settings for both tools, options for changing the active layer and active page when using the tool to select an object have been added. The Selector tool will change both active layer and active page, while the Node tool will change neither, by default. Other tools (Text tool, Rectangle tool, …) do not change either layer or page when being used (but they can, if you edit the preferences.xml file in a text editor, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5257 MR #5257]).

=== Shape Builder Tool ===

Several improvements were made to the Shape Builder ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5428 MR #5428]):

* The Shape Builder tool can now make use of raster graphics, too. Any paths selected together with a raster (pixel) graphic will now function as clipping paths, their colors are not preserved - unlike when you have only paths in the selection. The resulting image parts use clipped clones of the image, to keep the file size small and improve performance. If you want to edit them, you need to unlink the clones.
* An option for the transparency level of the original drawing has been added (the eye icon opens a popup slider).
* Optionally, it is now possible to keep a copy of the original objects after the Shape Builder's operation. This option is deactivated by default.

[[File:Inkscape_lgi0590pMq-ezgif.com-optimize_(1).gif|frame|center|Using the Shape Builder Tool to quickly split a raster graphic into multiple parts]]

=== Spray Tool ===

* The Spray Tool now shows an outline preview of the next item that it is going to spray, including its shape, rotation and size. The preview is only visible when the tool is not currently spraying. That way, you can choose where to place the next item (with a single click instead of holding the mouse button down). It is possible to change the previewed (soon-to-be-sprayed) item by right-clicking and then moving the mouse by a tiny amount ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5375 MR #5375]).
* The option to only spray non-overlapping objects now yields faster results through an updated spraying algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5766 MR #5766]).

[[File:Spray tool 1.4.gif|frame|center|Choosing the next item to spray]]

== Import / Export ==

==== PDF Export ====

PDF export now supports internal links (going from one part of the file to another part of the same file, weblinks were supported since Inkscape 1.0). This can be used for creating Tables of Contents, for example ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5237 MR #5237]).

== Dialogs ==

=== About Inkscape ===

* Inkscape's new About Screen is [https://inkscape.org/~Inkonic/%E2%98%85inkscapes-path-artists-blossom Inkonic's "Inkscape's Path–Artist's Blossom"].
* The About Screen dialog now has the ability to display multiple drawings as a slideshow ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5559 MR #5559]).
* The dialog can now be closed by pressing <kbd>Esc</kbd> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5860 MR #5860]).

[[File:Inkscape 1.4 About Screen.png | frame | center| The new About Screen, created by Inkonic for Inkscape 1.4]]

=== Add Layer ===

The 'Add Layer' dialog now shows the three available options all written out directly as radio buttons, instead of hiding them behind a drop-down selection ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]).

[[File:Imageasdasd awdqwdasda.png | frame | center | New layout of 'Add Layer' dialog]]

=== Align and Distribute ===

The alignment options field ''"Relative to"'' now hides irrelevant options when only a single item is selected, with 'Page' being the default ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6510 MR #6510]).

[[File:Inkscape PVs5dVVFsh.gif | frame | center | Better presets in 'Align and Distribute' dialog]]

=== Create Anchor (Hyperlink) / Object Properties ===

To make it easier to select an element in the drawing to link to, a button has been added to the side of the field where the target object's id or the external link must be inserted (Href).

When you click on that button, your mouse cursor will transform into a little hand icon. When the hand hovers over any object or over an empty area of the page, a small indicator text will tell you the id of that object or page. Clicking on the object will automatically insert that object's id into the href field. That way, you do not need to use the Objects or XML dialog to look up the internal identifier of the object you want to link to ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5221 MR #5221])

[[File:Object-picker.gif | frame | center | Creating clickable links from an object to another page / object]]

=== Document properties ===

==== Scale lock ====

A new toggle button that allows you to change the document's viewbox scale without changing the physical size of its contents has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5993 MR #5993]).

[needs image, and a description of why that is useful]

==== Grids ====

The grids subsection in the Document Properties dialog has been overhauled with new grid selector buttons, which automatically add the selected type of grid to the drawing when pressed.

===== Modular Grids =====

A new grid type was added that consists of rectangles with optional gaps in between.

Height, width, horizontal and vertical gap (also negative for overlapping modules) can be adjusted separately. Each grid module (rectangle) can have its own margin set (negative values for inside margin, positive values for outside margin).

[[File:Imageadsa.png|frame|center|Example of a modular grid without gaps]]

===== Axonometric grids =====

The angles of axonometric grids can now also be set by indicating the '''ratio''' between the height and width of the rhombus shape that is formed by it. A common angle for isometric games, for example, is 2:1, corresponding to angles like 26,565051 which are difficult to set exactly without the ratio option ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6132 MR #6132]).

[[File:Inkscape nkL1NDBuw4.gif|frame|center|Automatically setting an angle starting from a ration for axonometric grids]]

=== Export Dialog ===

* If you enter a file system path to a save location that does not exist, Inkscape now tries to create folders instead of warning the user. Only if that fails, it will give a warning now ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5169 MR #5169]).
* Each of the two tabs of the dialog (single file, batch export) now features a little icon in addition to the text ([https://gitlab.com/inkscape/inkscape/-/issues/4338 Bug #4338], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6166 MR #6166]).
* Batch export options have been clarified ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6544 MR #6544]).

[[File:Batch export options 1.4.png|frame|center|Improved batch export options with batch prefix and file type suffix]]

=== Extension Gallery ===

When you want to quickly get an overview which extensions are available to you, you can now browse your Inkscape extensions in a gallery similar to the one for filters.

You can use the search field to quickly find the extension you need. The size of the icons is adjustable. They are currently all still identical placeholders, [https://gitlab.com/inkscape/inbox/-/issues/9907 and we invite you to join us] if you'd like to help. The menu categories can be hidden if you do not need them.

When you hover over an extension, the dialog shows you a small info text with either the menu path to the extension, or a description ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Extension gallery 1.4.gif|frame|center|The new Extension Gallery]]

=== Fill and Stroke ===

==== Gradient Editor ====

It is now possible to control the gradient's angle numerically from the Gradient Editor section of the Fill and Stroke dialog. An additional slider allows for changing the angle by simply dragging. A button to rotate the gradient by 90° completes the new angle controls ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5413 MR #5413]).

[[File:7PviQWIu9r.gif|frame|center|The new gradient angle controls in the 'Fill and Stroke' dialog]]

==== Pattern Editor ====

For users who prefer to have more control when setting the gap between pattern elements, an option has been added to use numerical entry fields (Gap control: precise) instead of the sliders (Gap control: mouse friendly). This allows to add gaps smaller than 20% of the pattern width, in 0.1% steps – and also values larger than 32040%, in case you ever need that pattern rarity! ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5484 MR #5484]).

[[File:Pattern gap control 1.4.gif|frame|center|Controlling the gap between pattern blocks numerically]]

=== Filter Gallery ===

The Filter Gallery can be found in the <code>Filters</code> menu. It shows a scrollable (and hideable) list of all filter categories, and a preview image for each filter, applied to a colorful flower image. Your own filters will appear in the category indicated in your filter file, or, if there isn't any, in the <code>Personal</code> category. Inkscape looks for them in a folder named <code>filters</code> in the folder indicated at <code>Edit ➞ Preferences ➞ System: User config</code>. Some community-contributed files for trying this out can be found [https://inkscape.org/gallery/=inkscape-filter-set/ in our website's gallery] ([https://gitlab.com/inkscape/ux/-/issues/208 Bug UX#208], [https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Inkscape YIRwDrcpcO.gif|frame|center|The Filter Gallery with previews and search]]

=== Layers and Objects ===

When you click on the 'Add' in the Layers and Objects dialog, the 'Add layers' dialog no longer shows up. The button now always adds the new layer above the selected one ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]). To name the layer, double-click on its name. The 'Add Layer' dialog is still available from the Layer menu (or with <kbd>Ctrl+Shift+N</kbd>).

[[File:Inkscape RH105M5BrW.gif|frame|center|Adding new layers faster than ever]]

=== Object Attributes ===

This dialog has been removed. Its contents is now available in the Object Properties dialog.

=== Object Properties ===

This dialog has been merged with the Object Attributes dialog.

It now holds the following information:

* Some properties specific to the selected object type (e.g. rounded corners / width / height for rectangles, number of tips for stars etc.)
** For paths, it now holds editable path data ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6173 MR #6173], like in XML dialog). This is another step toward [https://gitlab.com/inkscape/ux/-/issues/203 ux#203].
** For rectangles, corners can be edited separately by adding the Corners Live Path Effect
** Stars/Polygons can be automatically rotated to their 0° rotation position
* Object ID, label, description, title, highlight color, checkboxes for lock and hide status
* Interactivity (scriptable) properties, such as OnClick, OnMouseOver (input JavaScript)
* When the selected object is enclosed by a hyperlink (added with 'Add hyperlink (anchor)' in right-click menu), the hyperlink's properties (e.g. href, title, role, target) can be edited in this dialog.

[[File:Object properties 1.4.gif|frame|center|The refactored 'Object Properties' dialog]]

=== Path Effects ===

The (optional) button for displaying the older Live Path Effects gallery dialog has been removed along with the dialog. LPEs can now only be selected from the search field / drop down field combination in the Path Effects dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5760 MR #5760]).

=== Preferences ===

==== Snapping ====

More options for finetuning snapping preference between grid and guidelines vs. objects and alignment/distribution have been added at Edit > Preferences > Behavior > Snapping.
These allow you to set grids and / or guidelines as the only available snap target, and to add more snap targets incrementally.

[[File:Snap settings 1.4.png|frame|center|More options for finetuning snapping behavior]]

=== SVG Font Editor ===

The context (right-click) menu entry to 'Sort glyphs' and 'Remove pair' (referring to a kerning pair) have been moved to more discoverable buttons ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5421 MR #5421]).

[[File:Font editor buttons 1.4.png|frame|center|New buttons in 'Font Editor' dialog]]

=== Swatches ===

The Swatches (Palettes) dialog has been overhauled ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5606 MR #5606]).
It now:

* Color palettes are now selected from a dropdown at the top, instead of a small icon at the bottom.
* Colors can be searched by their name.
* Color palettes can be loaded from a file.
* In addition to Gimp Color Palette files, now 'Adobe Color Book' and 'Adobe Swatch Exchange' files are also supported.
* Support for columns: When a palette file defines 'Columns' (in .gpl files, this is indicated by a line like <code>Columns: 9</code> following the name line), the blocks of colors that belong together will stay together (no 'linebreaks' will be added inside any of the blocks), both in the swatches dialog as well as in the palette at the bottom of the Inkscape window.
* A button for accessing the settings, and two buttons for switching between the grid and row view make it easier to adjust the dialog's layout.
* Support for color palettes with CIELAB colors has been added.
* Limited support for color palettes with CMYK colors has been added.
* The transformation from CMYK to RGB has been improved, even without a proper ICC profile. <br />

[[File:Inkscape 8rZ8VQ4Pyn.gif|frame|center|Refactored 'Swatches' dialog with search field]]

=== Text and Font ===

==== General ====

Freshly installed fonts can now be used in Inkscape on Linux, without needing to restart the application. macOS and Windows could not be moved to provide Inkscape with the necessary information ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5240 MR #5240]).

==== Experimental Alternative User Interface ====

An experimental 'Unified font browser' has been added. If it is activated under Edit > Preferences > Interface > Dialogs : Text and Font dialog (requires restart), it will replace the Text and Font dialog with a sortable, filterable, searchable and adjustable list of font previews.

It supports live applying of fonts.That means any font you select will be applied immediately. The 'Font Attributes' tab and 'Text' tab are available, too [https://gitlab.com/inkscape/inkscape/-/merge_requests/4578 MR #4578].

Specifically, these settings are customizable:

* type of preview (rows or grid)
* sort order: alphabetical, font weight, font width (condensed - wide)
* limit list of fonts to selected font collections
* scaling of preview
* preview text (choice between some presets, custom text entry for the long (row view) sample and the short (grid view) sample)
* whether to show the font name below the preview
* in the preferences, the height of the preview lines can be adjusted, as in some cases, fonts look cut off in the list preview

<gallery mode="packed" heights=400px>
File:Unified_font_browser_prefs_1.4.png | Preferences setting for activating and calibrating the experimental Unified Font Browser
File:Unified font browser direct application.gif | Applying a font and changing its size directly without confirmation
File:Unified font browser options gifsicle.gif | Adjusting the dialog by its various options
</gallery>

== Live Path Effects ==

=== Ruler ===

The Ruler Live Path Effect now features several new options:

* Ruler marks can start from the path at an angle (in degrees, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5749 MR #5749]).
* The marks can start at a distance from the path (in percentage of overall mark length, marks are shortened by this amount, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5751 MR #5751]).

[[File:Inkscape Q6nPooVP1O.gif|frame|center|Adjusting the angles of ruler marks and shifting their start in the Ruler Live Path Effect]]

=== Taper Stroke ===

A new option to 'clamp' (cut off) the path's tip instead of tapering it on the selected end of the path has been added. It's available in the 'Start direction' dropdown in the LPE's settings ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5701 MR #5701]).

[[File:Inkscape t6Un74IlV8.gif|frame|center|Clamping the path's tip with the Taper Stroke Live Path Effect]]

== Palettes ==

* Multiple palettes were updated to contain information about the number of columns for optimal display of the palette ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5647 MR #5647]).
* The 'Web Safe' palette has been removed because of the dust that had already settled on it. Its colors were already included with the 'Web Hex' palette, where they now feature an addition ('(Web-safe)') to their label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5653 MR #5653]).
* The 'Windows XP' palette has been removed because of its age ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5645]).
* The default preference for the bottom palette's layout has been adjusted to stretch the tiles and to have them laid out in two rows, so the palette looks nicer when you first install Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6581 MR #6581]).

== Templates ==

* Folding book templates in A4 and Letter format have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).
* Custom templates can now make use of a category and a label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).

[[File:Zine template 1.4.png|frame|center|The Zine Booklet template allows you to quickly generate printable folding booklets.]]

== Customization / Theming ==

=== Customizable Handles ===

The size, color, stroke-width, outline and opacity of on-canvas handles can now be customized, and their shape can be selected from a set of available handle shapes, by copying the CSS file at <code>inkscape/share/ui/node-handles.css</code> into the folder indicated at <code>Edit ➞ Preferences ➞ System: User UI</code> and modifying it. Handles will be updated live in Inkscape as when the file has been saved ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 MR #5624]).

[[File:Inkscape vIWVwzkI0T.gif|frame|center|The new default handles]]

=== Icons ===

A new icon set called is now available for you to select. This new theme, called "Dash" is aimed at covering all of Inkscape's existing features, and reducing complexity on some of the existing icons, while still being explanatory. It also borrows some concepts from industry standard apps. It has 500+ icons, with cursors, scalable and symbolic versions and works on dark and light themes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6115 MR #6115]).

<gallery mode="packed" heights=400px>
File:Dash icons.png|Overview over icons from the new icon set
File:Dash icon theme.png|New icon set in use in the Inkscape interface
</gallery>

=== Keyboard Shortcuts ===

* The shortcuts for "Quick Preview" (<kbd>F</kbd>), "Quick Zoom" (<kbd>Q</kbd>), panning (<kbd>Space</kbd>), "Pen Segment To Line" (<kbd>Shift + L</kbd>), "Pen Segment To Curve" (<kbd>Shift + U</kbd>) and "Pen Segments To Guides" (<kbd>Shift + G</kbd>) are now customizable ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).
* The macOS-specific carbon.xml keyboard shortcuts file has been removed, as it hasn't been kept up to date for years ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6522 MR #6522]).
* Some existing commands that did not have a default shortcut now have one. Note that these will only be available to you if you install Inkscape for the first time, not when upgrading an existing installation. In that case, you can set these manually in <code>Edit > Preferences > Interface > Keyboard</code>, or you can reset your keyboard shortcuts by replacing the file <code>default.xml</code> in your Inkscape user configuration director with a copy of the file <code>inkscape.xml</code> from the <code>keys</code> directory of your Inkscape installation's <code>share</code> directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6462 MR #6462]):
{| class="wikitable"
!Command
!Shortcut
|-
|Apply clipping path
|'''<kbd>Ctrl+M</kbd>'''
|-
|Release clipping path
|'''<kbd>Alt+M</kbd>'''
|-
|Apply inverted clipping path
|'''<kbd>Ctrl+Alt+M</kbd>'''
|-
|Swap fill and stroke colors
|'''<kbd>Shift+X</kbd>'''
|}

== Windows-specific Changes ==

== macOS-specific Changes ==

== Extensions ==

===Features===

==== New extensions====

* The '''Text -> Formula (typst)''' extension converts [https://typst.app typst] math markup into a path, and has a similar function as the LaTeX extension. ([https://gitlab.com/inkscape/extensions/-/merge_requests/606 MR extensions!606])

====Particular extensions ====

* The QR code extension now supports multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/595 MR extensions!595]). This can be useful if you want to create a vCard or other multiline formats.

====General Extension Changes====

*Focus on performance improvements: Usage of more efficient internal Python datatypes speeds up certain extensions by an order of magnitude ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569], [https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570]). Extensions that rely on <code>CubicSuperPath</code> (e.g. all 'Transform path' extensions) will also notice significant speedups ([https://gitlab.com/inkscape/extensions/-/merge_requests/573 MR extensions!573]). Extensions reading and interpreting CSS rules ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579]) or evaluating the style cascade ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597]) are dramatically faster. These improvements apply to all existing extensions, usually extension authors don't have to modify their code.

===Bugs fixed===

====Particular extensions====

* The '''Add Nodes''' extension now gives symmetric results on arcs, and also splits arcs into smaller arcs. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Measure''' tool (Length measurement) is now more precise for paths containing arcs, e.g. an arc with radius 50mm now has its length reported as <code>314.1593</code> (correct value: 314.15926...) instead of <code>314.1602</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* The '''Convert to dashes''' extension is now also more precise for arcs and furthermore doesn't visually change the output for closed subpaths where a dash crosses over the closing position. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
*The '''DXF export''' extension no longer draws invisible elements. ([https://gitlab.com/inkscape/extensions/-/merge_requests/609 MR extensions!609])
*The N-up layout extension could in some cases generate incorrect sizes, which is fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/610 MR extensions!610])

====All extensions ====

* Extensions accessing the text of a text element through <code>TextElement.get_text()</code> will now also receive the contents of the nested <code>tspan</code>s. ([https://gitlab.com/inkscape/extensions/-/merge_requests/584 MR extensions!584], [https://gitlab.com/inkscape/extensions/-/merge_requests/622 MR extensions!622], [https://gitlab.com/inkscape/extensions/-/merge_requests/617 extensions!617])

===Extension Development ===

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

* <code>Vector2d</code> now implements most dunder methods of <code>complex</code>, simplifying the vectorisation of path operations in <code>numpy</code>. The assign method has been removed as <code>complex</code> is immutable. Path operations have been sped up by basing their internal computation on complex proper. ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions!569])
* The <code>transform</code> class is now also based on math on complex numbers. High-level operations that use transforms, such as the transformation of a path, automatically make use of the new API. If you work with transforms manually, you might want to use <code>capply_to_point</code> to get the performance benefits. ([https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions!570])
* <code>Path.append</code> with list argument has been deprecated, use <code>Path.extend</code> instead. ([https://gitlab.com/inkscape/extensions/-/merge_requests/572 MR extensions!572])
* Style evaluations in documents that contain CSS have been sped up dramatically. The API remains unchanged. Also, some complex CSS4 selectors (like <code>:has</code>) are now supported. ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions!579])
* The ID cache now is kept up-to-date correctly, ensuring that no ID collisions occur accidentally - as a byproduct, style and ID lookups are now constant-time instead of linear-time. If you add <code>etree.ElementBase</code> elements from the SVG namespace manually, the ID caching mechanism will not work correctly, and it's a bad idea anyway. If your extension assigned duplicate IDs, you will need to fix that as it will be an error in 1.4. ([https://gitlab.com/inkscape/extensions/-/merge_requests/581 MR extensions!581])
* Improvements to the API for working with path segments, such as: length, split at length, gradient/normal, curvature. Accessible through <code>path.proxy_iterator()</code>, the new methods facilitate a lot of what <code>bezier.py</code> is traditionally used for, but without the loss of information that inherently happens when converting to <code>CubicSuperPath</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions!585])
* Attribute access is now more consistent, simplifying the modification of <code>filter</code> and <code>stroke-dasharray</code>. For details, see added [https://inkscape.gitlab.io/extensions/documentation/tutorial/object-editing.html documentation]. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
* When setting an attribute value to a style attribute, such as <code>element.style["fill"] = LinearGradient.new(...)</code>, the element is automatically inserted into the <code>defs</code> it it hasn't been already. ([https://gitlab.com/inkscape/extensions/-/merge_requests/588 MR extensions!588])
*Simplify reading of RDF meatadata ([https://gitlab.com/inkscape/extensions/-/merge_requests/596 MR extensions!596])
*Styles have been refactored to be faster and more accurate. Use <code>element.get_computed_style(key)</code> to get the computed value for a particular attribute. <code>element.specified_style()(key)</code> will continue to work, but unless you reuse the computed specified_style for many properties, it's less efficient. ([https://gitlab.com/inkscape/extensions/-/merge_requests/597 MR extensions!597])

==== Extension Development Documentation====

====Under the hood====

* Allow to skip particularly slow unit tests ([https://gitlab.com/inkscape/extensions/-/merge_requests/571 MR extensions!571]) .
* Improvements to the unit testing framework for stock extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/582 MR extensions!582])
* Improvements for translators ([https://gitlab.com/inkscape/extensions/-/merge_requests/583 MR extensions!583])
*Maintainance work for Python 3.13 ([https://gitlab.com/inkscape/extensions/-/merge_requests/608 MR extensions!608])

*New feature to allow extension authors to pre-process the svg before it's sent to their extension using the new `<action>` tag. Additionally there is a pref attribute which controls if the action is run according to an inkscape pref, this isn't expected to be useful to extension authors and is used internally for plain-svg compatibility.
*Extensions that use a custom GUI can now retrieve information from stderr with the attribute <code>show-stderr</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6124 MR #6124]).
*Some improvements to memory management were made in the extension system ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6109 MR #6109]).
*Extensions manager:
**Fix freeze in Details window (inkscape/extras/extension-manager#19 (closed))
**Maintainance updates
*XAML:
**Fix #552 (closed)
**Maintainance updates
*Afdesign:
**Improvements to path parsing & power stroke.
*Gcodetools:
**Maintainance updates
*New Extension for inserting typst generated formulas

== Command line==

*Many new actions have been added to allow editing SVG files and customizing export files ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381]). These are also available from the Command palette:
**Set the document's SVG version to 1.1
**Set the document's SVG version to 2.0
** Remove any Inkscape-specific SVG data
**Remove any known proprietary SVG data
** Remove auto start positions from markers
**Remove all transforms from all shapes
**Remove context paints from markers
**Replace SVG2 text with SVG1.1 text
**Insert JavaScript for rendering meshes (polyfill)
**Insert JavaScript for rendering hatches (polyfill)
**Recursively unlink all clones and symbols
**Turn all shapes recursively into <code>path</code> elements
**Turn all strokes recursively into fill-only paths
**Make all paths absolute and predictable
**Add bounding box information to all shapes: adds <code>inkscape:visualbox</code> and <code>inkscape:geometricbox</code> attributes (only current bounding box, not updated when shape changes)
**Add shape path information to all shapes: adds <code>inkscape:d</code> attribute (only current <code>d</code>, not updated when path is changed)
**Remove unused definitions (gradients, etc.)
*A new option to print a list of all available input file extensions <code>list-input-types</code> has been added. This includes input file names for extensions, and it is also used for filename completion on the command line ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6126 MR #6126]).
*Options for setting the compression (export-png-compression, values 0–9) and antialiasing (export-png-antialias, values 0–3) level have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5167 MR #5167]).
*An option to rotate the page by 90° (page-rotate) has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5594 MR #5594]).
*<nowiki>An action for tracing raster images (object_trace), with expected argument format: {number of scans},{smooth[false|true]},{stack[false|true]},{remove_background[false|true],{speckles},{smooth_corners},{optimize}} (</nowiki>[https://gitlab.com/inkscape/inkscape/-/merge_requests/5842 MR #5842])

==Inkview==

The Inkscape SVG image viewer Inkview now makes use of a (customizable) .ui file instead of a hardcoded GUI ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5899 MR #5899]).

==Bugfixes==

*The snap indicator text no longer flickers when object bounding box and path are in the same location (e.g. borders of a rectangular path) ([https://gitlab.com/inkscape/inkscape/-/issues/4399 Bug #4399], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6157 MR #6157]).
*Clones no longer vanish when their original path is being edited with the Shape Builder Tool ([https://gitlab.com/inkscape/inkscape/-/issues/4682 Bug #4682], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6131 MR #6131]).
* Bump filters and Bevels filters (about 25 different filters) now look again as they were intended, with banding and artifacts much reduced ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6190 MR #6190], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6162 MR #6162]).
*The settings 'Better' and 'Best' for rendering filters now are different again, and 'Better' is a bit faster now ([https://gitlab.com/inkscape/inkscape/-/issues/4722 Bug #4722], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6133 MR #6133]).
*Improvement on internal LPE handling ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6100 MR #6100])
*Stroke to Path no longer results in misplacement of the first node when applied to paths with multiple subpaths ([https://gitlab.com/inkscape/inkscape/-/issues/4709 Bug #4709], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6122 MR #6122]).
*When editing text imported from a PDF, letters before and after your cursor move as expected instead of new text and old text being stacked on top of each other ([https://gitlab.com/inkscape/inkscape/-/issues/297 Bug #297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6414 MR #6414]).
*Right-clicking on selected objects no longer deselects them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6489 MR #6489], [https://gitlab.com/inkscape/inkscape/-/issues/5047 Bug #5047]).
* Pressing the + button to add a new gradient stop now also works when the last gradient stop is selected ([https://gitlab.com/inkscape/inkscape/-/issues/1261 Bug #1261], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6358 MR #6358]).
*Gradient tool regression fixes (since Inkscape 1.0.x, [https://gitlab.com/inkscape/inkscape/-/merge_requests/6361 MR #6361]):
**The tool now again allows to add gradient stops by dragging a color from the palette onto the gradient line ([https://gitlab.com/inkscape/inkscape/-/issues/3472 Bug #3472]).
** Dragging a color from the color palette to a gradient object will now respect all the selected gradient nodes irrespective of the drop location.
**Dropping a color on a gradient object when no gradient nodes are selected will automatically determine the closest gradient node to the mouse and apply the color to it ([https://gitlab.com/inkscape/inkscape/-/issues/4466 Bug #4466]).
**Selecting a color from the color palette when no gradient node of the selected object is selected will automatically apply the color to the first gradient node of the selected object.
*and dozens of other bugs that are too many to list them all out here. You can find a (very incomplete) list of closed bug reports for the 1.4 milestone [https://gitlab.com/inkscape/inkscape/-/issues/?sort=created_date&state=closed&milestone_title=Inkscape%201.4&first_page_size=20 in our bug tracker].

[[File:Inkscape owz9gNDaXy.gif|frame|center|Gradient tool capabilities restored]]

==Behind the Curtains==

These are changes that are not visible to the end user, but make development easier, maintain operating system compatibility and help to future-proof Inkscape:

*Lots and lots of changes have been made to prepare Inkscape for the updated user interface framework GTK 4. Those changes should not be noticeable in Inkscape 1.4, but will help us with fixing bugs in multiple branches of Inkscape simultaneously (Inkscape 1.4.x and master/1.5.x).
*Many parts of the code have been refactored, code has been simplified and modernized.
*The code was adjusted to stay compatible with newer versions of third-party libraries.
*Our automatic builds and dependency lists have been updated and changed many times, continuously adjusting to currently available packages for various operating systems and compilation frameworks.

==Translations==

The following languages have been updated for this version (as of July 26):

*Basque
*Belarusian
*British English
*Catalan
*Croatian
*German
*Hebrew
*Hungarian
*Icelandic
*Italian
*Japanese
*Korean
*Portuguese
* Romanian
*Russian
*Simplified Chinese
*Slovenian
*Spanish
*Traditional Chinese
* Ukrainian

===Contributing to interface translations===

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

==Documentation==

Documentation translations were updated in:

*Hungarian

==Website==

==Important Inkscape Project Milestones==

==Important Changes for Packagers==

*The compile flag <code>WITH_INTERNAL_CAIRO</code> has been removed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6093 MR #6093]).
*tinycss2 is now needed for Inkscape extensions (and export) to work ([https://gitlab.com/inkscape/inkscape/-/issues/5070 Bug #5070]).

==Known issues==

*The background work for moving to GTK4 can potentially reduce Inkscape's performance, most notably on Windows.

==Other releases==

{{:Release notes}}

Release notes/1.4

2024-09-22T17:45:39Z

Joneuhauser: /* Extensions */

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

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

Important Links:
* [https://gitlab.com/inkscape/inkscape/commits/master Commit History Main Program (starting from: May 16, 2023)]
* [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:

* https://gitlab.com/inkscape/inbox/-/issues/10309 - spray tool performance drop bug
* https://gitlab.com/inkscape/inbox/-/issues/10110 - extension gallery tooltip bug ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6257 MR])
* https://gitlab.com/inkscape/inbox/-/issues/10308 - export dialog icons bug
* https://gitlab.com/inkscape/inbox/-/issues/10112 - object picker UX bugs
* https://gitlab.com/inkscape/inbox/-/issues/10113 - scale lock bug
* https://gitlab.com/inkscape/inkscape/-/merge_requests/5993#note_1820038476 - scale lock use case required for better explanation
* https://gitlab.com/inkscape/inkscape/-/merge_requests/6199#note_1889273098 - ellipse snapping

}}

== Release highlights ==

* '''Filter Gallery:''' it has never been so easy to find the best filter for your needs! This new dialog features previews, categories and search.
* '''Modular grids & improved axonometric grids:''' set the grid angle by ratio for isometric designs and use modular grids to plan layouts and make icons!
* '''Swatches dialog and palette file handling improved:''' quick access to dialog layout controls, search for colors, and open different palette file formats!
* '''Unified font browser preview:''' when activated in the preferences, use it to quickly browse through your font collection. Try it out and give your feedback!
* '''Customizable handles:''' Power users with CSS knowledge can now customize the styling and basic shape of all the handles!
* '''Fast image clipping with the Shape Builder:''' raster graphics can now be clipped into multiple sections using the Shape Builder.
* '''There's even more:''' new templates for folding booklets, additional options in Ruler and Taper Stroke LPE, preview in Spray tool, many new command line options, updated translations and many bug fixes.

== Canvas ==

=== Guides ===

When creating a new guide, all guides are now unlocked, so the new guide can be moved and adjusted freely ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5814 MR #5814]).

== Tools ==

=== General ===

Toolbars now try to make use of the available space by not hiding options in dropdown menus when there's enough space. Instead, they are sorted into multiple, dropdown menus, when the window is shrunk or there is not enough space.

Previously, any options that did not fit went into the same small arrow dropdown at the end of the toolbar and were hard to discover.

The change also leads to a larger minimal width of the Inkscape window, which is now dependent upon the selected tool with its collapsed toolbar items.

=== Node Tool ===

* The mouse/keyboard shortcut for converting a curved path segment to a straight line has been changed from <kbd>Ctrl+Click</kbd> to <kbd>Alt+Double-click</kbd> as a fix to the double-click action of the 'delete segment' command not being recognized correctly ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6504 MR #6504]).
* Deleting a node now behaves differently again ([https://gitlab.com/inkscape/inkscape/-/issues/4984 Bug #4984], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6285 MR #6285], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6635 MR #6635]). With the preference option 'Edit > Preferences > Node tool: Deleting node preserves shape' active, Inkscape will use its node sharpness autodetection to decide whether the shape will be kept, or the node will be removed without adjusting the adjacent nodes' handles. With the option inactive, Inkscape will behave like Inkscape 1.2 (no autodetection, shape is kept when pressing Del, straight lines with Ctrl + Del).

{| class="wikitable"
|+ Node deletion behavior
|-
! Keys pressed !! Curve is (almost) cusp !! Curve is smooth
|-
| Del + Preference for keeping shape is active || Adjacent handles will not be adjusted || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|-
| Del + Preference for keeping shape is not active || Adjacent handles will be adjusted to try and keep the shape || Adjacent handles will be adjusted to try and keep the shape
|-
| Ctrl + Del + Preference for keeping shape is not active || Adjacent handles will be retracted, producing a straight line || Adjacent handles will be retracted, producing a straight line
|}

=== Pen Tool ===

A new option has been added to automatically convert the currently drawn shape to guides, allowing users to 'draw' guides instead of dragging them out of the rulers. It comes without a keyboard shortcut, but you can set one in the preferences ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).

=== Rectangle Tool ===

A new mode to only draw squares with Alt + Ctrl has been added to the tool ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6199 MR #6199]).

=== Selector Tool & Node Tool ===

* In Edit > Preferences > Behavior > Steps, an option has been added to change how moving selected objects / nodes with the arrow keys works when the canvas is rotated (Arrow keys move object relative to screen). If you're working with a rotated canvas, now, by default, the arrow keys will move the selection horizontally and vertically relative to the screen, not to the rotated document. This allows to work more intuitively while the canvas is rotated. Disabling the option will restore the previous behavior ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5031 MR #5031]).
* In the preferences settings for both tools, options for changing the active layer and active page when using the tool to select an object have been added. The Selector tool will change both active layer and active page, while the Node tool will change neither, by default. Other tools (Text tool, Rectangle tool, …) do not change either layer or page when being used (but they can, if you edit the preferences.xml file in a text editor, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5257 MR #5257]).

=== Shape Builder Tool ===

Several improvements were made to the Shape Builder ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5428 MR #5428]):

* The Shape Builder tool can now make use of raster graphics, too. Any paths selected together with a raster (pixel) graphic will now function as clipping paths, their colors are not preserved - unlike when you have only paths in the selection. The resulting image parts use clipped clones of the image, to keep the file size small and improve performance. If you want to edit them, you need to unlink the clones.
* An option for the transparency level of the original drawing has been added (the eye icon opens a popup slider).
* Optionally, it is now possible to keep a copy of the original objects after the Shape Builder's operation. This option is deactivated by default.

[[File:Inkscape_lgi0590pMq-ezgif.com-optimize_(1).gif|frame|center|Using the Shape Builder Tool to quickly split a raster graphic into multiple parts]]

=== Spray Tool ===

* The Spray Tool now shows an outline preview of the next item that it is going to spray, including its shape, rotation and size. The preview is only visible when the tool is not currently spraying. That way, you can choose where to place the next item (with a single click instead of holding the mouse button down). It is possible to change the previewed (soon-to-be-sprayed) item by right-clicking and then moving the mouse by a tiny amount ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5375 MR #5375]).
* The option to only spray non-overlapping objects now yields faster results through an updated spraying algorithm ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5766 MR #5766]).

[[File:Spray tool 1.4.gif|frame|center|Choosing the next item to spray]]

== Import / Export ==

==== PDF Export ====

PDF export now supports internal links (going from one part of the file to another part of the same file, weblinks were supported since Inkscape 1.0). This can be used for creating Tables of Contents, for example ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5237 MR #5237]).

== Dialogs ==

=== About Inkscape ===

* Inkscape's new About Screen is [https://inkscape.org/~Inkonic/%E2%98%85inkscapes-path-artists-blossom Inkonic's "Inkscape's Path–Artist's Blossom"].
* The About Screen dialog now has the ability to display multiple drawings as a slideshow ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5559 MR #5559]).
* The dialog can now be closed by pressing <kbd>Esc</kbd> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5860 MR #5860]).

[[File:Inkscape 1.4 About Screen.png | frame | center| The new About Screen, created by Inkonic for Inkscape 1.4]]

=== Add Layer ===

The 'Add Layer' dialog now shows the three available options all written out directly as radio buttons, instead of hiding them behind a drop-down selection ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]).

[[File:Imageasdasd awdqwdasda.png | frame | center | New layout of 'Add Layer' dialog]]

=== Align and Distribute ===

The alignment options field ''"Relative to"'' now hides irrelevant options when only a single item is selected, with 'Page' being the default ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6510 MR #6510]).

[[File:Inkscape PVs5dVVFsh.gif | frame | center | Better presets in 'Align and Distribute' dialog]]

=== Create Anchor (Hyperlink) / Object Properties ===

To make it easier to select an element in the drawing to link to, a button has been added to the side of the field where the target object's id or the external link must be inserted (Href).

When you click on that button, your mouse cursor will transform into a little hand icon. When the hand hovers over any object or over an empty area of the page, a small indicator text will tell you the id of that object or page. Clicking on the object will automatically insert that object's id into the href field. That way, you do not need to use the Objects or XML dialog to look up the internal identifier of the object you want to link to ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5221 MR #5221])

[[File:Object-picker.gif | frame | center | Creating clickable links from an object to another page / object]]

=== Document properties ===

==== Scale lock ====

A new toggle button that allows you to change the document's viewbox scale without changing the physical size of its contents has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5993 MR #5993]).

[needs image, and a description of why that is useful]

==== Grids ====

The grids subsection in the Document Properties dialog has been overhauled with new grid selector buttons, which automatically add the selected type of grid to the drawing when pressed.

===== Modular Grids =====

A new grid type was added that consists of rectangles with optional gaps in between.

Height, width, horizontal and vertical gap (also negative for overlapping modules) can be adjusted separately. Each grid module (rectangle) can have its own margin set (negative values for inside margin, positive values for outside margin).

[[File:Imageadsa.png|frame|center|Example of a modular grid without gaps]]

===== Axonometric grids =====

The angles of axonometric grids can now also be set by indicating the '''ratio''' between the height and width of the rhombus shape that is formed by it. A common angle for isometric games, for example, is 2:1, corresponding to angles like 26,565051 which are difficult to set exactly without the ratio option ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6132 MR #6132]).

[[File:Inkscape nkL1NDBuw4.gif|frame|center|Automatically setting an angle starting from a ration for axonometric grids]]

=== Export Dialog ===

* If you enter a file system path to a save location that does not exist, Inkscape now tries to create folders instead of warning the user. Only if that fails, it will give a warning now ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5169 MR #5169]).
* Each of the two tabs of the dialog (single file, batch export) now features a little icon in addition to the text ([https://gitlab.com/inkscape/inkscape/-/issues/4338 Bug #4338], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6166 MR #6166]).
* Batch export options have been clarified ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6544 MR #6544]).

[[File:Batch export options 1.4.png|frame|center|Improved batch export options with batch prefix and file type suffix]]

=== Extension Gallery ===

When you want to quickly get an overview which extensions are available to you, you can now browse your Inkscape extensions in a gallery similar to the one for filters.

You can use the search field to quickly find the extension you need. The size of the icons is adjustable. They are currently all still identical placeholders, [https://gitlab.com/inkscape/inbox/-/issues/9907 and we invite you to join us] if you'd like to help. The menu categories can be hidden if you do not need them.

When you hover over an extension, the dialog shows you a small info text with either the menu path to the extension, or a description ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Extension gallery 1.4.gif|frame|center|The new Extension Gallery]]

=== Fill and Stroke ===

==== Gradient Editor ====

It is now possible to control the gradient's angle numerically from the Gradient Editor section of the Fill and Stroke dialog. An additional slider allows for changing the angle by simply dragging. A button to rotate the gradient by 90° completes the new angle controls ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5413 MR #5413]).

[[File:7PviQWIu9r.gif|frame|center|The new gradient angle controls in the 'Fill and Stroke' dialog]]

==== Pattern Editor ====

For users who prefer to have more control when setting the gap between pattern elements, an option has been added to use numerical entry fields (Gap control: precise) instead of the sliders (Gap control: mouse friendly). This allows to add gaps smaller than 20% of the pattern width, in 0.1% steps – and also values larger than 32040%, in case you ever need that pattern rarity! ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5484 MR #5484]).

[[File:Pattern gap control 1.4.gif|frame|center|Controlling the gap between pattern blocks numerically]]

=== Filter Gallery ===

The Filter Gallery can be found in the <code>Filters</code> menu. It shows a scrollable (and hideable) list of all filter categories, and a preview image for each filter, applied to a colorful flower image. Your own filters will appear in the category indicated in your filter file, or, if there isn't any, in the <code>Personal</code> category. Inkscape looks for them in a folder named <code>filters</code> in the folder indicated at <code>Edit ➞ Preferences ➞ System: User config</code>. Some community-contributed files for trying this out can be found [https://inkscape.org/gallery/=inkscape-filter-set/ in our website's gallery] ([https://gitlab.com/inkscape/ux/-/issues/208 Bug UX#208], [https://gitlab.com/inkscape/inkscape/-/merge_requests/5448 MR #5448]).

[[File:Inkscape YIRwDrcpcO.gif|frame|center|The Filter Gallery with previews and search]]

=== Layers and Objects ===

When you click on the 'Add' in the Layers and Objects dialog, the 'Add layers' dialog no longer shows up. The button now always adds the new layer above the selected one ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5074 MR #5074]). To name the layer, double-click on its name. The 'Add Layer' dialog is still available from the Layer menu (or with <kbd>Ctrl+Shift+N</kbd>).

[[File:Inkscape RH105M5BrW.gif|frame|center|Adding new layers faster than ever]]

=== Object Attributes ===

This dialog has been removed. Its contents is now available in the Object Properties dialog.

=== Object Properties ===

This dialog has been merged with the Object Attributes dialog.

It now holds the following information:

* Some properties specific to the selected object type (e.g. rounded corners / width / height for rectangles, number of tips for stars etc.)
** For paths, it now holds editable path data ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6173 MR #6173], like in XML dialog). This is another step toward [https://gitlab.com/inkscape/ux/-/issues/203 ux#203].
** For rectangles, corners can be edited separately by adding the Corners Live Path Effect
** Stars/Polygons can be automatically rotated to their 0° rotation position
* Object ID, label, description, title, highlight color, checkboxes for lock and hide status
* Interactivity (scriptable) properties, such as OnClick, OnMouseOver (input JavaScript)
* When the selected object is enclosed by a hyperlink (added with 'Add hyperlink (anchor)' in right-click menu), the hyperlink's properties (e.g. href, title, role, target) can be edited in this dialog.

[[File:Object properties 1.4.gif|frame|center|The refactored 'Object Properties' dialog]]

=== Path Effects ===

The (optional) button for displaying the older Live Path Effects gallery dialog has been removed along with the dialog. LPEs can now only be selected from the search field / drop down field combination in the Path Effects dialog ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5760 MR #5760]).

=== Preferences ===

==== Snapping ====

More options for finetuning snapping preference between grid and guidelines vs. objects and alignment/distribution have been added at Edit > Preferences > Behavior > Snapping.
These allow you to set grids and / or guidelines as the only available snap target, and to add more snap targets incrementally.

[[File:Snap settings 1.4.png|frame|center|More options for finetuning snapping behavior]]

=== SVG Font Editor ===

The context (right-click) menu entry to 'Sort glyphs' and 'Remove pair' (referring to a kerning pair) have been moved to more discoverable buttons ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5421 MR #5421]).

[[File:Font editor buttons 1.4.png|frame|center|New buttons in 'Font Editor' dialog]]

=== Swatches ===

The Swatches (Palettes) dialog has been overhauled ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5606 MR #5606]).
It now:

* Color palettes are now selected from a dropdown at the top, instead of a small icon at the bottom.
* Colors can be searched by their name.
* Color palettes can be loaded from a file.
* In addition to Gimp Color Palette files, now 'Adobe Color Book' and 'Adobe Swatch Exchange' files are also supported.
* Support for columns: When a palette file defines 'Columns' (in .gpl files, this is indicated by a line like <code>Columns: 9</code> following the name line), the blocks of colors that belong together will stay together (no 'linebreaks' will be added inside any of the blocks), both in the swatches dialog as well as in the palette at the bottom of the Inkscape window.
* A button for accessing the settings, and two buttons for switching between the grid and row view make it easier to adjust the dialog's layout.
* Support for color palettes with CIELAB colors has been added.
* Limited support for color palettes with CMYK colors has been added.
* The transformation from CMYK to RGB has been improved, even without a proper ICC profile. <br />

[[File:Inkscape 8rZ8VQ4Pyn.gif|frame|center|Refactored 'Swatches' dialog with search field]]

=== Text and Font ===

==== General ====

Freshly installed fonts can now be used in Inkscape on Linux, without needing to restart the application. macOS and Windows could not be moved to provide Inkscape with the necessary information ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5240 MR #5240]).

==== Experimental Alternative User Interface ====

An experimental 'Unified font browser' has been added. If it is activated under Edit > Preferences > Interface > Dialogs : Text and Font dialog (requires restart), it will replace the Text and Font dialog with a sortable, filterable, searchable and adjustable list of font previews.

It supports live applying of fonts.That means any font you select will be applied immediately. The 'Font Attributes' tab and 'Text' tab are available, too [https://gitlab.com/inkscape/inkscape/-/merge_requests/4578 MR #4578].

Specifically, these settings are customizable:

* type of preview (rows or grid)
* sort order: alphabetical, font weight, font width (condensed - wide)
* limit list of fonts to selected font collections
* scaling of preview
* preview text (choice between some presets, custom text entry for the long (row view) sample and the short (grid view) sample)
* whether to show the font name below the preview
* in the preferences, the height of the preview lines can be adjusted, as in some cases, fonts look cut off in the list preview

<gallery mode="packed" heights=400px>
File:Unified_font_browser_prefs_1.4.png | Preferences setting for activating and calibrating the experimental Unified Font Browser
File:Unified font browser direct application.gif | Applying a font and changing its size directly without confirmation
File:Unified font browser options gifsicle.gif | Adjusting the dialog by its various options
</gallery>

== Live Path Effects ==

=== Ruler ===

The Ruler Live Path Effect now features several new options:

* Ruler marks can start from the path at an angle (in degrees, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5749 MR #5749]).
* The marks can start at a distance from the path (in percentage of overall mark length, marks are shortened by this amount, [https://gitlab.com/inkscape/inkscape/-/merge_requests/5751 MR #5751]).

[[File:Inkscape Q6nPooVP1O.gif|frame|center|Adjusting the angles of ruler marks and shifting their start in the Ruler Live Path Effect]]

=== Taper Stroke ===

A new option to 'clamp' (cut off) the path's tip instead of tapering it on the selected end of the path has been added. It's available in the 'Start direction' dropdown in the LPE's settings ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5701 MR #5701]).

[[File:Inkscape t6Un74IlV8.gif|frame|center|Clamping the path's tip with the Taper Stroke Live Path Effect]]

== Palettes ==

* Multiple palettes were updated to contain information about the number of columns for optimal display of the palette ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5647 MR #5647]).
* The 'Web Safe' palette has been removed because of the dust that had already settled on it. Its colors were already included with the 'Web Hex' palette, where they now feature an addition ('(Web-safe)') to their label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5653 MR #5653]).
* The 'Windows XP' palette has been removed because of its age ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5645]).
* The default preference for the bottom palette's layout has been adjusted to stretch the tiles and to have them laid out in two rows, so the palette looks nicer when you first install Inkscape ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6581 MR #6581]).

== Templates ==

* Folding book templates in A4 and Letter format have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).
* Custom templates can now make use of a category and a label ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5996 MR #5996]).

[[File:Zine template 1.4.png|frame|center|The Zine Booklet template allows you to quickly generate printable folding booklets.]]

== Customization / Theming ==

=== Customizable Handles ===

The size, color, stroke-width, outline and opacity of on-canvas handles can now be customized, and their shape can be selected from a set of available handle shapes, by copying the CSS file at <code>inkscape/share/ui/node-handles.css</code> into the folder indicated at <code>Edit ➞ Preferences ➞ System: User UI</code> and modifying it. Handles will be updated live in Inkscape as when the file has been saved ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 MR #5624]).

[[File:Inkscape vIWVwzkI0T.gif|frame|center|The new default handles]]

=== Icons ===

A new icon set called is now available for you to select. This new theme, called "Dash" is aimed at covering all of Inkscape's existing features, and reducing complexity on some of the existing icons, while still being explanatory. It also borrows some concepts from industry standard apps. It has 500+ icons, with cursors, scalable and symbolic versions and works on dark and light themes ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6115 MR #6115]).

<gallery mode="packed" heights=400px>
File:Dash icons.png|Overview over icons from the new icon set
File:Dash icon theme.png|New icon set in use in the Inkscape interface
</gallery>

=== Keyboard Shortcuts ===

* The shortcuts for "Quick Preview" (<kbd>F</kbd>), "Quick Zoom" (<kbd>Q</kbd>), panning (<kbd>Space</kbd>), "Pen Segment To Line" (<kbd>Shift + L</kbd>), "Pen Segment To Curve" (<kbd>Shift + U</kbd>) and "Pen Segments To Guides" (<kbd>Shift + G</kbd>) are now customizable ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6308 MR #6308]).
* The macOS-specific carbon.xml keyboard shortcuts file has been removed, as it hasn't been kept up to date for years ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6522 MR #6522]).
* Some existing commands that did not have a default shortcut now have one. Note that these will only be available to you if you install Inkscape for the first time, not when upgrading an existing installation. In that case, you can set these manually in <code>Edit > Preferences > Interface > Keyboard</code>, or you can reset your keyboard shortcuts by replacing the file <code>default.xml</code> in your Inkscape user configuration director with a copy of the file <code>inkscape.xml</code> from the <code>keys</code> directory of your Inkscape installation's <code>share</code> directory ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6462 MR #6462]):
{| class="wikitable"
!Command
!Shortcut
|-
|Apply clipping path
|'''<kbd>Ctrl+M</kbd>'''
|-
|Release clipping path
|'''<kbd>Alt+M</kbd>'''
|-
|Apply inverted clipping path
|'''<kbd>Ctrl+Alt+M</kbd>'''
|-
|Swap fill and stroke colors
|'''<kbd>Shift+X</kbd>'''
|}

== Windows-specific Changes ==

== macOS-specific Changes ==

== Extensions ==

===Features===

==== New extensions====

====Particular extensions ====

* The QR code extension now supports multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/595 MR extensions#595])

====General Extension Changes====

*Focus on performance improvements: Usage of more efficient internal Python datatypes speeds up certain extensions by an order of magnitude ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions#569], [https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions#570]). Extensions that rely on <code>CubicSuperPath</code> (e.g. all 'Transform path' extensions) will also notice significant speedups ([https://gitlab.com/inkscape/extensions/-/merge_requests/573 MR extensions#573]). Extensions reading and interpreting CSS rules are dramatically faster ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions#579]).

===Bugs fixed===

====Particular extensions====

* The '''Add Nodes''' extension now gives symmetric results on arcs, and also splits arcs into smaller arcs. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions#585])
* The '''Measure''' tool (Length measurement) is now more precise for paths containing arcs, e.g. an arc with radius 50mm now has its length reported as <code>314.1593</code> (correct value: 314.15926...) instead of <code>314.1602</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions#585])
* The '''Convert to dashes''' extension is now also more precise for arcs and furthermore doesn't visually change the output for closed subpaths where a dash crosses over the closing position. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions#585])

====All extensions ====

* Extensions accessing the text of a text element through <code>TextElement.get_text()</code> will now also receive the contents of the nested <code>tspan</code>s. ([https://gitlab.com/inkscape/extensions/-/merge_requests/584 MR extensions#584], [https://gitlab.com/inkscape/extensions/-/merge_requests/622 MR extensions#622], [https://gitlab.com/inkscape/extensions/-/merge_requests/619 extensions!619])

===Extension Development ===

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

* <code>Vector2d</code> now implements most dunder methods of <code>complex</code>, simplifying the vectorisation of path operations in <code>numpy</code>. The assign method has been removed as <code>complex</code> is immutable. Path operations have been sped up by basing their internal computation on complex proper. ([https://gitlab.com/inkscape/extensions/-/merge_requests/569 MR extensions#569])
* The <code>transform</code> class is now also based on math on complex numbers. High-level operations that use transforms, such as the transformation of a path, automatically make use of the new API. If you work with transforms manually, you might want to use <code>capply_to_point</code> to get the performance benefits. ([https://gitlab.com/inkscape/extensions/-/merge_requests/570 MR extensions#570])
* <code>Path.append</code> with list argument has been deprecated, use <code>Path.extend</code> instead. ([https://gitlab.com/inkscape/extensions/-/merge_requests/572 MR extensions#572])
* Style evaluations in documents that contain CSS have been sped up dramatically. The API remains unchanged. Also, some complex CSS4 selectors (like <code>:has</code>) are now supported. ([https://gitlab.com/inkscape/extensions/-/merge_requests/579 MR extensions#579])
* The ID cache now is kept up-to-date correctly, ensuring that no ID collisions occur accidentally - as a byproduct, style and ID lookups are now constant-time instead of linear-time. If you add <code>etree.ElementBase</code> elements from the SVG namespace manually, the ID caching mechanism will not work correctly, and it's a bad idea anyway. If your extension assigned duplicate IDs, you will need to fix that as it will be an error in 1.4. ([https://gitlab.com/inkscape/extensions/-/merge_requests/581 MR extensions#581])
* Improvements to the API for working with path segments, such as: length, split at length, gradient/normal, curvature. Accessible through <code>path.proxy_iterator()</code>, the new methods facilitate a lot of what <code>bezier.py</code> is traditionally used for, but without the loss of information that inherently happens when converting to <code>CubicSuperPath</code>. ([https://gitlab.com/inkscape/extensions/-/merge_requests/585 MR extensions#585])
* Attribute access is now more consistent, simplifying the modification of <code>filter</code> and <code>stroke-dasharray</code>. For details, see added [https://inkscape.gitlab.io/extensions/documentation/tutorial/object-editing.html documentation].
* When setting an attribute value to a style attribute, such as <code>element.style["fill"] = LinearGradient.new(...)</code>, the element is automatically inserted into the <code>defs</code>.

==== Extension Development Documentation====

====Under the hood====

* Allow to skip particularly slow unit tests ([https://gitlab.com/inkscape/extensions/-/merge_requests/571 MR extensions#571]) .
* Improvements to the unit testing framework for stock extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/582 MR extensions#582])
* Improvements for translators ([https://gitlab.com/inkscape/extensions/-/merge_requests/583 MR extensions#583])

*New feature to allow extension authors to pre-process the svg before it's sent to their extension using the new `<action>` tag. Additionally there is a pref attribute which controls if the action is run according to an inkscape pref, this isn't expected to be useful to extension authors and is used internally for plain-svg compatibility.
*Extensions that use a custom GUI can now retrieve information from stderr with the attribute <code>show-stderr</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6124 MR #6124]).
*Some improvements to memory management were made in the extension system ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6109 MR #6109]).
*Extensions manager:
**Fix freeze in Details window (inkscape/extras/extension-manager#19 (closed))
**Maintainance updates
*XAML:
**Fix #552 (closed)
**Maintainance updates
*Afdesign:
**Improvements to path parsing & power stroke.
*Gcodetools:
**Maintainance updates
*New Extension for inserting typst generated formulas

== Command line==

*Many new actions have been added to allow editing SVG files and customizing export files ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5381 MR #5381]). These are also available from the Command palette:
**Set the document's SVG version to 1.1
**Set the document's SVG version to 2.0
** Remove any Inkscape-specific SVG data
**Remove any known proprietary SVG data
** Remove auto start positions from markers
**Remove all transforms from all shapes
**Remove context paints from markers
**Replace SVG2 text with SVG1.1 text
**Insert JavaScript for rendering meshes (polyfill)
**Insert JavaScript for rendering hatches (polyfill)
**Recursively unlink all clones and symbols
**Turn all shapes recursively into <code>path</code> elements
**Turn all strokes recursively into fill-only paths
**Make all paths absolute and predictable
**Add bounding box information to all shapes: adds <code>inkscape:visualbox</code> and <code>inkscape:geometricbox</code> attributes (only current bounding box, not updated when shape changes)
**Add shape path information to all shapes: adds <code>inkscape:d</code> attribute (only current <code>d</code>, not updated when path is changed)
**Remove unused definitions (gradients, etc.)
*A new option to print a list of all available input file extensions <code>list-input-types</code> has been added. This includes input file names for extensions, and it is also used for filename completion on the command line ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6126 MR #6126]).
*Options for setting the compression (export-png-compression, values 0–9) and antialiasing (export-png-antialias, values 0–3) level have been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5167 MR #5167]).
*An option to rotate the page by 90° (page-rotate) has been added ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5594 MR #5594]).
*<nowiki>An action for tracing raster images (object_trace), with expected argument format: {number of scans},{smooth[false|true]},{stack[false|true]},{remove_background[false|true],{speckles},{smooth_corners},{optimize}} (</nowiki>[https://gitlab.com/inkscape/inkscape/-/merge_requests/5842 MR #5842])

==Inkview==

The Inkscape SVG image viewer Inkview now makes use of a (customizable) .ui file instead of a hardcoded GUI ([https://gitlab.com/inkscape/inkscape/-/merge_requests/5899 MR #5899]).

==Bugfixes==

*The snap indicator text no longer flickers when object bounding box and path are in the same location (e.g. borders of a rectangular path) ([https://gitlab.com/inkscape/inkscape/-/issues/4399 Bug #4399], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6157 MR #6157]).
*Clones no longer vanish when their original path is being edited with the Shape Builder Tool ([https://gitlab.com/inkscape/inkscape/-/issues/4682 Bug #4682], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6131 MR #6131]).
* Bump filters and Bevels filters (about 25 different filters) now look again as they were intended, with banding and artifacts much reduced ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6190 MR #6190], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6162 MR #6162]).
*The settings 'Better' and 'Best' for rendering filters now are different again, and 'Better' is a bit faster now ([https://gitlab.com/inkscape/inkscape/-/issues/4722 Bug #4722], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6133 MR #6133]).
*Improvement on internal LPE handling ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6100 MR #6100])
*Stroke to Path no longer results in misplacement of the first node when applied to paths with multiple subpaths ([https://gitlab.com/inkscape/inkscape/-/issues/4709 Bug #4709], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6122 MR #6122]).
*When editing text imported from a PDF, letters before and after your cursor move as expected instead of new text and old text being stacked on top of each other ([https://gitlab.com/inkscape/inkscape/-/issues/297 Bug #297], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6414 MR #6414]).
*Right-clicking on selected objects no longer deselects them ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6489 MR #6489], [https://gitlab.com/inkscape/inkscape/-/issues/5047 Bug #5047]).
* Pressing the + button to add a new gradient stop now also works when the last gradient stop is selected ([https://gitlab.com/inkscape/inkscape/-/issues/1261 Bug #1261], [https://gitlab.com/inkscape/inkscape/-/merge_requests/6358 MR #6358]).
*Gradient tool regression fixes (since Inkscape 1.0.x, [https://gitlab.com/inkscape/inkscape/-/merge_requests/6361 MR #6361]):
**The tool now again allows to add gradient stops by dragging a color from the palette onto the gradient line ([https://gitlab.com/inkscape/inkscape/-/issues/3472 Bug #3472]).
** Dragging a color from the color palette to a gradient object will now respect all the selected gradient nodes irrespective of the drop location.
**Dropping a color on a gradient object when no gradient nodes are selected will automatically determine the closest gradient node to the mouse and apply the color to it ([https://gitlab.com/inkscape/inkscape/-/issues/4466 Bug #4466]).
**Selecting a color from the color palette when no gradient node of the selected object is selected will automatically apply the color to the first gradient node of the selected object.
*and dozens of other bugs that are too many to list them all out here. You can find a (very incomplete) list of closed bug reports for the 1.4 milestone [https://gitlab.com/inkscape/inkscape/-/issues/?sort=created_date&state=closed&milestone_title=Inkscape%201.4&first_page_size=20 in our bug tracker].

[[File:Inkscape owz9gNDaXy.gif|frame|center|Gradient tool capabilities restored]]

==Behind the Curtains==

These are changes that are not visible to the end user, but make development easier, maintain operating system compatibility and help to future-proof Inkscape:

*Lots and lots of changes have been made to prepare Inkscape for the updated user interface framework GTK 4. Those changes should not be noticeable in Inkscape 1.4, but will help us with fixing bugs in multiple branches of Inkscape simultaneously (Inkscape 1.4.x and master/1.5.x).
*Many parts of the code have been refactored, code has been simplified and modernized.
*The code was adjusted to stay compatible with newer versions of third-party libraries.
*Our automatic builds and dependency lists have been updated and changed many times, continuously adjusting to currently available packages for various operating systems and compilation frameworks.

==Translations==

The following languages have been updated for this version (as of July 26):

*Basque
*Belarusian
*British English
*Catalan
*Croatian
*German
*Hebrew
*Hungarian
*Icelandic
*Italian
*Japanese
*Korean
*Portuguese
* Romanian
*Russian
*Simplified Chinese
*Slovenian
*Spanish
*Traditional Chinese
* Ukrainian

===Contributing to interface translations===

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

==Documentation==

Documentation translations were updated in:

*Hungarian

==Website==

==Important Inkscape Project Milestones==

==Important Changes for Packagers==

*The compile flag <code>WITH_INTERNAL_CAIRO</code> has been removed ([https://gitlab.com/inkscape/inkscape/-/merge_requests/6093 MR #6093]).
*tinycss2 is now needed for Inkscape extensions (and export) to work ([https://gitlab.com/inkscape/inkscape/-/issues/5070 Bug #5070]).

==Known issues==

*The background work for moving to GTK4 can potentially reduce Inkscape's performance, most notably on Windows.

==Other releases==

{{:Release notes}}

SOC Application Template

2024-06-14T12:20:17Z

Joneuhauser: /* Google Summer of Code - Candidate Application Template for Inkscape */

== Google Summer of Code - Candidate Application Template for Inkscape ==

Thanks for considering Inkscape for your SoC project! To help us identifying you as a good candidate, we ask a few questions.

=== Inkscape Questions ===
# When did you first hear about Inkscape?
# What kind of drawings do you create with Inkscape?
# Describe your participation in our community (e.g. uploaded drawings, tutorials, bug reports, communication via mailing lists or IRC).
# Describe your contributions to the Inkscape development (e.g. bug fixes, translations, packaging, testing).
# In exactly '''two''' sentences, why should we pick '''YOU'''?

=== About Yourself ===
# What is your name, email address, and irc nickname?
# Describe any plans you have for the summer in addition to GSoC (classes, thesis, job, vacation, etc.).
# What programming projects have you completed?
# What are your favorite programming tools (editor, etc.)?
# Describe any work on other open-source projects.
# List other GSoC projects you are applying to.

=== Tasks ===
# Submit a drawing you have made with Inkscape. It doesn't have to be professional quality but it should show us that you know how to use Inkscape.
# Introduce yourself on the [https://chat.inkscape.org Inkscape chat], and post your project ideas for feedback, ''before'' submitting your application
# [https://inkscape.org/develop/getting-started/ Checkout] the Inkscape sourcecode through git and review it. Make sure you can compile and build Inkscape on your own PC!
# Find and fix two bugs in the [https://gitlab.com/inkscape/inkscape/issues Inkscape bug tracker]. Create and upload patches for the bugs, and make sure we know to connect those bug fixes and your GSoC application. You can alternatively submit a patch that improves code unrelated to a bug.
# Prepare a detailed plan (with timetable) of the work you want to do.
#Explain any additional costs that the project would have to cover in order for you to perform this work, such as license costs for proprietary tools (when no suitable OSS replacement exists) or hardware costs (e.g. when the target is to support specific hardware). There is no guarantee that these costs can be reimbursed, but we still need to know in advance.

Google Summer of Code

2024-06-14T12:16:55Z

Joneuhauser:

<div style="max-width:70em; margin-left: auto; margin-right: auto">
= Welcome to Inkscape! =

For quite a few years Inkscape has been successfully participating in [http://code.google.com/soc/ Google Summer of Code].

Google has opened up the program to students AND beginners to Open Source who are 18 years are older. Projects can be medium size (~175 hours) or large size (~350 hours). Finish times are flexible, 12 to 22 weeks (with agreement of mentor).

GSoC is a program where Google funds the development of specific features in open source software by university students and other new to open source. You don't need to be a Computer Science student to apply. Features to be developed are picked by Inkscape administrators from the pool of proposals submitted by applicants.

We've mentored about half a dozen students a year since GSoC started. Many students enjoyed their work and continue to be involved; perhaps your mentor will be a past GSoC student! We have a high rate of acceptance of student code into the core codebase. Indeed, GSoC projects have been a key source of some of Inkscape's best features in the past several releases.

If you are interested in joining us this summer, it is time to get your proposal ready. You can choose a proposal from our list of suggestions or come up with one of your own. In either either case, you '''must''' give us a detailed outline of what you plan to do. It is '''highly''' recommended that you discuss your idea as early as possible with Inkscape developers. They not only can give you guidance as you flesh out your proposal but ultimately you must convince them that you can do the work planned in the time allotted. '''If you have not discussed your proposal with Inkscape developers before you apply, your application will be rejected!'''

= Candidate Applications =

* Google program information:
** [https://summerofcode.withgoogle.com/ Home page].
** Summer of Code Application form. Applications open at 18:00 UTC on March 18th, 2024. -> https://developers.google.com/open-source/gsoc/timeline

* Inkscape-specific information:
** [[SOC Application Template]].
** [[Roadmap | Inkscape Roadmap]] - to see our overall objectives.
** [[Projects | Inkscape Development Project Ideas]] - broader list of development ideas.
** [[SOC Writing Project Proposals]] - some guidelines for proposals.
** [[SOC Selection Criteria]] - how we rate applications.

'''Candidate Applications for GSoC 2024 must be submitted to the GSoC site by 18:00 UTC on April 2nd 2024.'''

= The "two patches" rule =

We require two patches from each potential GSoC student, before accepting the student for GSoC participation (it is the same requirement as for obtaining rights to commit changes to the code repository).

The reason for this requirement is that you can show us that you have succeeded in building Inkscape on your PC, and that you have understood a little piece of Inkscape's code and are able to improve it.
Inkscape is a large project, and you really should not try to understand all the code. Many (all?) developers know only parts of the program code!
You can join our [https://inkscape.org/community/discussion/ IRC] channel or [https://chat.inkscape.org/channel/team_devel Rocket Chat] and ask developers for help.

== Suggested "easy" bug fixes or improvements ==

To get you started on Inkscape development, you can find (probably) easy-to-fix bugs or small improvements that require very little knowledge of the whole program by searching our [https://gitlab.com/inkscape/inkscape/issues/ bug-tracker] for bugs tagged with 'easy-fix'.

= Performance Evaluation =

GSoC has two formal evaluation points, at the ''mid-term'' and at the end. These evaluations determine if you receive the stipend from Google. In order to receive a pass for the evaluations you will need to show adequate progress toward your project's goals.

To help you meet your goals and so that your mentor can better evaluate your progress you need to:

* Have frequent, public discussions of your progress. (Don't rely on just your mentor for advice.)
* Have a public Inkscape branch for your code to which you commit regularly.
* Give weekly status reports.

For the final pass, you will normally be required to merge your code into Inkscape trunk.

Remember: ''we want you to succeed!''

= Suggested Project Ideas =

The following is a list of formal project suggestions, but do not feel limited to only these - some of our best contributions have been unique ideas that students had in mind from other sources!

See also [[Development Project Ideas]], [[Refactoring projects]], [[Projects]], and https://blueprints.launchpad.net/inkscape/

==P5. UI-Free Inkscape ==

* Estimation of difficulty: Difficult - Long (350h)
* Potential mentors: Marc Jeanmougin
* Programming skills: C++, CMake
* Prerequisites: Minimal knowledge of build systems. Experience with GtkMM helpful.

<u>Detailed Description</u>
Inkscape currently builds with X11 and gtk and a lot of graphical dependencies. But since it is allowed to run in commandline, and there are controlled environments (servers) that use it to convert svg to png and to perform actions, there should be no need to force it to build with those. The main goal of this project is to add a WITH_GUI compilation flag that when OFF, does *not* link Inkscape with any graphical dependency. While much work has been done towards this goal, much remains to be done. DONE <s>As a next step, Inkscape's "verbs" which are mostly GUI dependent (even if there is no reason to be) need to be converted to Gio::Actions.</s> More work needs to be done to separate out hidden GUI dependencies that remain after the Verb to Action transition.

<u>Use cases</u>
* Server installs, scripts

==P8. Add Text and Image Support to Live Path Effect System ==
* Estimation of difficulty: Hard - Short (175h)
* Potential mentors: Jabier Arraiza (Spanish, English(not native))
* Programming skills: C++
* Prerequisites: Experience managing bitmaps
<u>Detailed Description</u>
Live Path Effects are non destructive effects applied to paths and shapes standalone or inside a group.<br />
This is done keepeng a reference to the original data to reaply when needed.<br />
But ignore text and image elements.<br />
Things to do:
* Study add image, text, both and maybe others SVG elements to the LPE system.
* Create/adapt minimun one LPE for each new type of element acepted as reference. Suggestion Perspective-Envelope.
<u>Use cases</u>
* Apply live effects to images and text based in C++ code in a non destructive way even in groups with mixed elements types.

==P9. Path Library Improvements ==
* Estimation of difficulty: Hard - Long (350h)
* Potential mentors: Tavmjong Bah, KK
* Programming skills: C++
* Prerequisites: Strong math skills, specifically in geometry.
<u>Detailed Description</u>
Inkscape relies on two geometry libraries for path manipulations: lib2geom and livarot. lib2geom is a generic modern library written specifically with Inkscape in mind. lib2geom is missing some functionality that Inkscape requires and that is found in livarot. This project is to move that functionality into lib2geom (or into separate files) using lib2geom path descriptions. A 2020 GSoC student did a significant amount of work understanding and documenting the issues involved. This project would be to build on his work.

Specifically, the functionality needed is
* Path offset/inset functions.
* Path simplify.
* Stroke to path function.
* Line scanning (used for flowing text into a shape).

==P11. Improvements to Paint Server Dialog ==

* Estimation of difficulty: Easy to Medium - Short (175h)
* Potential mentors: Tavmjong
* Programming skills: C++
* Prerequisites: Some knowledge of GTK and CSS.
<u>Detailed Description</u>
The ''Paint Server Dialog'' allows a user to visually select a pattern or hatch to use in painting the ''fill'' or ''stroke'' of an object. This project would be to expand the dialog to cover gradients, meshes, and solid colors as well as make other improvements to the dialog. Interaction with the Inkscape's ''UX'' team will be required.

== P13. Node-based filter editor ==

*Estimation of difficulty: Hard - Long (350h)
* Potential mentors: Mc
* Programming skills: C++
* Prerequisites: Minimal knowledge of build systems

<u>Detailed Description:</u> The filter editor is kind of hard to understand and master based on its current UI. Using a node-based tool for it, such as what can be done with https://notabug.org/grindhold/libgtkflow would help people create and master the filter primitives easier.

[https://gitlab.com/inkscape/ux/-/issues/40 '''Full poposal''']
== P15. Import and Export extensions ==

*Estimation of difficulty: Flexible, usually easy to medium, Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python, Ability to read technical documents, depending on the format: some reverse engineering
* Prerequisites: minimal knowledge of test-driven development

<u>Detailed Description:</u> Inkscape is alway looking to improve compatibility! Some ideas of relevant file formats - each of them more than enough for one GSoC:*Refactor our '''DXF input and output''' extensions, and expand support towards binary DXF
*Write an as-complete-as-possible '''EPS export''', circumventing the internal information loss in ghostscript (EPS is still relevant for scientific papers, but more and more tools are dropping support, so this is a chance to grab market share - the results of Adobe Distiller are much better than ghostscript's...)
*Rewrite the '''XAML importer''' in Python (currenly XSLT) to match the capabilities of the new XAML exporter (i.e. support for different target frameworks, better text support...) - would have to select carefully what to support (drawing primitives) and what not (control elements) - the boundary is not as clear-cut as it seems.
* Update the '''Synfig export''' to support the latest Synfig developments
* '''Import or export of TikZ'''. There are a few abandoned extensions out there (from which we can borrow), but it's very widely used in science - both import and export could serve an important function in the scientific workflow.
*'''Import of the proprietary fileformats''' of Affinity Design, Vectornator, Vectorstyler (especially the last two seem in their infancy and users at some point will sit on a bunch of files that they can't open anymore because their SAAS model wasn't profitable) .
*'''Import of CGM''' - old, but ISO standardized. Was supported once and dropped when the uniconvertor extension was removed for 1.0.
* '''Python based EMF / WMF importer -''' the current (core Inkscape) C extension is unmaintained and Python would probably be the right way to get more collaboration on it. A lot of public archives sit on mountains of EMF files. Note that the Document Foundation recently did a lot of work properly importing those files, so we can learn from them / maybe even join forces...
*your favorite file format? - also have a look here: https://office.inkscape.org/nextcloud/index.php/s/Tq6cdDDGay6taCw
==P16. Gcodetools refactoring and documentation==

*Estimation of difficulty: Easy- Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python
* Prerequisites: Maker background / familiarity with the Maker community

<u>Detailed Description:</u> [https://gitlab.com/inkscape/extras/extensions-gcodetools/ Gcodetools] is a set of Inkscape extensions that deal with reading and creating Gcode files, mostly for use in laser cutters or plotters. For this project, ideally someone with a Makerspace background will
#query maker spaces on their needs regarding gcodetools,
#implement those needs together with unit tests,
# improve the test coverage of Gcodetools,
#write proper documentation for it. (doesn't really exist at the moment).
==P17. Packing / Nesting as an Inkscape extension==

*Estimation of difficulty: Medium, Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python
* Prerequisites: Computational geometry

<u>Detailed Description:</u> In this project, a set of packing / nesting algorithms will be implemented:
*[https://en.wikipedia.org/wiki/Cutting_stock_problem Linear nesting] is not too useful in SVG, but might be a good place to get acquainted with the problem. 2D cutting stock problem would be very interesting to have and would work great with the new multipage functionality.
*For efficient packing of free form objects, we might just re-implement [https://github.com/Jack000/SVGnest SVGNest] in Python. There are probably some more recent research papers which would be interesting to implement as a comparison.

== P18. Improving UX of Node tool and Bezier tool ==
*Estimation of difficulty: Medium - Hard, Short or Long depending on scope (175h or 350h)
*Potential mentors: Tav, ??
* Programming skills: C++,
*Prerequisites: Computational geometry

<u>Detailed Description:</u> This project would improve workflow of editing of geometry of paths. Combining strengths of Pen tool and Node tool with modifiers and new behaviors. This improvement should benefit pro users but also beginners. Good example of this implementation is in blenders new pen tool.

'''[https://gitlab.com/inkscape/ux/-/issues/5 Full Proposal here]'''[[File:Imageasdasd.png|thumb|184x184px]]

== P19. Improving UI of Live path effects ==
*Estimation of difficulty: Medium- Hard, Short or Long depending on scope (175h or 350h)
*Potential mentors: Mike, jabier ,??
* Programming skills: GTK 4, C++
*Prerequisites: Front end UI , familiarity with Live path effects
[[File:Imageasdasda qrq.png|thumb|146x146px]]

<u>Detailed Description:</u> This project Should implement Proposed UI clean up of Controls . LPE controls shoulbe be more user freindly and predictive,

[https://gitlab.com/inkscape/ux/-/issues/?sort=popularity&state=opened&label_name%5B%5D=Dialog%3A%3ALPE&first_page_size=100 '''Full Proposed designs''']

[[File:Imageasd.png|right|frameless|466x466px]]
== P20. Recolor Artwork ==
* Estimation of difficulty: Variable - Short (90h or 175h)
* Potential mentors: Adam Belis ?
* Programming skills: usually C++
* Prerequisites:

<u>Detailed Description</u>
An easy and convenient way how to change any color from the selection. Useful for experimenting and tweaking colors.

[https://gitlab.com/inkscape/inbox/-/issues/6095 '''Full proposal Here''']

<u>Use cases</u>
* fast Editing color in whole project without of need for swatches
*easier work for color harmonies in a project
*Easier iteration and visioning of designs

==Pxx. Your project ==
* Estimation of difficulty: Variable - Short or Long (175h or 350h)
* Potential mentors: Marc Jeanmougin
* Programming skills: usually C++
* Prerequisites: good ideas

<u>Detailed Description</u>
The most successful GSoC we had in the past were students coming with their own past, use cases and ideas for Inkscape. Many basic tools like 3d cubes or connectors you can see in Inkscape now have been brought by brilliant people (like you) with ideas. If we think that your project fits with Inkscape (ie: has its place with a vector graphic editor), we can help you refining your ideas and help bring shiny new stuff to life!

<u>Use cases</u>
* Amaze us!

= Successful SOC Projects from Previous Years =
* 2005
** Connectors
** Inkboard
** [http://www.openclipart.org/ Open Clip Art Library (OCAL)] Interface
** DXF Import / Export
* [[Google Summer of Code 2006|2006]]
** Support for SVG Filters
** Filter Effects
** PDF export
** Inkboard Protocol Spec / Lib Conversion
* [[Google Summer of Code 2007|2007]]
** Text Style Improvements
** PDF import
** Live Path Effects
** 3D Box Tool
** UI for SVG Filter Effects
** Raster Functionality
** Importing from, and Exporting to, a remote ccHost instance
* [[Google Summer of Code 2008|2008]]
** SVG Fonts support
** 2Geom refactoring project - port most geometry code to 2Geom
** lib2geom: interactive applications showing off the power of lib2geom
** Tech drawing abilities
** A test suite
* 2009
** [[GSoC2009 Node Tool Rewrite|Node tool rewrite]]
** D-Bus scripting API
** Connector tool improvements
** ICC/CMYK workflow
* 2010
** Cairo-based rendering
** C++ification of SP Layer
* 2011
** Rendering caching
** Javascript support improvements
** CSS support improvements
* 2012
** Usibility Improvements for Guides
** [[Tiling tool|On-canvas support for Tessellations]]
** Creating python bindings for lib2geom
* [[Google Summer of Code 2013|2013]]
** Recolor Tool
** Improved Units Support
** Electronics CAD Support
** New From Templates Dialog
** New Raster to Vector Algorithm
* 2014
** Better Support for SVG Paints
** Robust Boolean and Stroking Operations for 2Geom
* 2016
** [[GSoC 2016 Better data structure for selections|Better data structure for selections]]
** [[Style Editor|CSS Style Sheet Editor]]
* 2017
** SVG 2 Text Support
** Better CSS Style Sheet Support
* 2019
** Mesh gradient and hatches polyfills. Paint server dialog.
* 2020
** [https://gitlab.com/vanntile/inkscape-gsoc-2020 New dialog system.]
** [https://gitlab.com/rathod-sahaab/gsoc-2020-inkscape Command palette dialog.]
** Path operations.
* 2021
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3420 On canvas marker editing.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3328 Verbs to Gio::Actions.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3294 On canvas alignment snapping.]
* 2022
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4692 Tab Structure.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4694 Font Collections.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4756 Modernizing Memory Management.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4504 OCR Support.]
* 2023
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/5335 GTK4 toolbar port preparation]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 Customizable Appearance of Canvas Controls]

[[Category:Developer Documentation]]
</div>

Google Summer of Code

2024-06-14T12:15:58Z

Joneuhauser:

<div style="max-width:70em; margin-left: auto; margin-right: auto">
= Welcome to Inkscape! =

For quite a few years Inkscape has been successfully participating in [http://code.google.com/soc/ Google Summer of Code].

Google has opened up the program to students AND beginners to Open Source who are 18 years are older. Projects can be medium size (~175 hours) or large size (~350 hours). Finish times are flexible, 12 to 22 weeks (with agreement of mentor).

GSoC is a program where Google funds the development of specific features in open source software by university students and other new to open source. You don't need to be a Computer Science student to apply. Features to be developed are picked by Inkscape administrators from the pool of proposals submitted by applicants.

We've mentored about half a dozen students a year since GSoC started. Many students enjoyed their work and continue to be involved; perhaps your mentor will be a past GSoC student! We have a high rate of acceptance of student code into the core codebase. Indeed, GSoC projects have been a key source of some of Inkscape's best features in the past several releases.

If you are interested in joining us this summer, it is time to get your proposal ready. You can choose a proposal from our list of suggestions or come up with one of your own. In either either case, you '''must''' give us a detailed outline of what you plan to do. It is '''highly''' recommended that you discuss your idea as early as possible with Inkscape developers. They not only can give you guidance as you flesh out your proposal but ultimately you must convince them that you can do the work planned in the time allotted. '''If you have not discussed your proposal with Inkscape developers before you apply, your application will be rejected!'''

= Candidate Applications =

* Google program information:
** [https://summerofcode.withgoogle.com/ Home page].
** Summer of Code Application form. Applications open at 18:00 UTC on March 18th, 2024. -> https://developers.google.com/open-source/gsoc/timeline

* Inkscape-specific information:
** [[SOC Application Template]].
** [[Roadmap | Inkscape Roadmap]] - to see our overall objectives.
** [[Projects | Inkscape Development Project Ideas]] - broader list of development ideas.
** [[SOC Writing Project Proposals]] - some guidelines for proposals.
** [[SOC Selection Criteria]] - how we rate applications.

'''Candidate Applications for GSoC 2024 must be submitted to the GSoC site by 18:00 UTC on April 2nd 2024.'''

= The "two patches" rule =

We require two patches from each potential GSoC student, before accepting the student for GSoC participation (it is the same requirement as for obtaining rights to commit changes to the code repository).

The reason for this requirement is that you can show us that you have succeeded in building Inkscape on your PC, and that you have understood a little piece of Inkscape's code and are able to improve it.
Inkscape is a large project, and you really should not try to understand all the code. Many (all?) developers know only parts of the program code!
You can join our [https://inkscape.org/community/discussion/ IRC] channel or [https://chat.inkscape.org/channel/team_devel Rocket Chat] and ask developers for help.

== Suggested "easy" bug fixes or improvements ==

To get you started on Inkscape development, you can find (probably) easy-to-fix bugs or small improvements that require very little knowledge of the whole program by searching our [https://gitlab.com/inkscape/inkscape/issues/ bug-tracker] for bugs tagged with 'easy-fix'.

= Performance Evaluation =

GSoC has two formal evaluation points, at the ''mid-term'' and at the end. These evaluations determine if you receive the stipend from Google. In order to receive a pass for the evaluations you will need to show adequate progress toward your project's goals.

To help you meet your goals and so that your mentor can better evaluate your progress you need to:

* Have frequent, public discussions of your progress. (Don't rely on just your mentor for advice.)
* Have a public Inkscape branch for your code to which you commit regularly.
* Give weekly status reports.

For the final pass, you will normally be required to merge your code into Inkscape trunk.

Remember: ''we want you to succeed!''

= Suggested Project Ideas =

The following is a list of formal project suggestions, but do not feel limited to only these - some of our best contributions have been unique ideas that students had in mind from other sources!

See also [[Development Project Ideas]], [[Refactoring projects]], [[Projects]], and https://blueprints.launchpad.net/inkscape/

==P5. UI-Free Inkscape ==

* Estimation of difficulty: Difficult - Long (350h)
* Potential mentors: Marc Jeanmougin
* Programming skills: C++, CMake
* Prerequisites: Minimal knowledge of build systems. Experience with GtkMM helpful.

<u>Detailed Description</u>
Inkscape currently builds with X11 and gtk and a lot of graphical dependencies. But since it is allowed to run in commandline, and there are controlled environments (servers) that use it to convert svg to png and to perform actions, there should be no need to force it to build with those. The main goal of this project is to add a WITH_GUI compilation flag that when OFF, does *not* link Inkscape with any graphical dependency. While much work has been done towards this goal, much remains to be done. DONE <s>As a next step, Inkscape's "verbs" which are mostly GUI dependent (even if there is no reason to be) need to be converted to Gio::Actions.</s> More work needs to be done to separate out hidden GUI dependencies that remain after the Verb to Action transition.

<u>Use cases</u>
* Server installs, scripts

==P8. Add Text and Image Support to Live Path Effect System ==
* Estimation of difficulty: Hard - Short (175h)
* Potential mentors: Jabier Arraiza (Spanish, English(not native))
* Programming skills: C++
* Prerequisites: Experience managing bitmaps
<u>Detailed Description</u>
Live Path Effects are non destructive effects applied to paths and shapes standalone or inside a group.<br />
This is done keepeng a reference to the original data to reaply when needed.<br />
But ignore text and image elements.<br />
Things to do:
* Study add image, text, both and maybe others SVG elements to the LPE system.
* Create/adapt minimun one LPE for each new type of element acepted as reference. Suggestion Perspective-Envelope.
<u>Use cases</u>
* Apply live effects to images and text based in C++ code in a non destructive way even in groups with mixed elements types.

==P9. Path Library Improvements ==
* Estimation of difficulty: Hard - Long (350h)
* Potential mentors: Tavmjong Bah, KK
* Programming skills: C++
* Prerequisites: Strong math skills, specifically in geometry.
<u>Detailed Description</u>
Inkscape relies on two geometry libraries for path manipulations: lib2geom and livarot. lib2geom is a generic modern library written specifically with Inkscape in mind. lib2geom is missing some functionality that Inkscape requires and that is found in livarot. This project is to move that functionality into lib2geom (or into separate files) using lib2geom path descriptions. A 2020 GSoC student did a significant amount of work understanding and documenting the issues involved. This project would be to build on his work.

Specifically, the functionality needed is
* Path offset/inset functions.
* Path simplify.
* Stroke to path function.
* Line scanning (used for flowing text into a shape).

==P11. Improvements to Paint Server Dialog ==

* Estimation of difficulty: Easy to Medium - Short (175h)
* Potential mentors: Tavmjong
* Programming skills: C++
* Prerequisites: Some knowledge of GTK and CSS.
<u>Detailed Description</u>
The ''Paint Server Dialog'' allows a user to visually select a pattern or hatch to use in painting the ''fill'' or ''stroke'' of an object. This project would be to expand the dialog to cover gradients, meshes, and solid colors as well as make other improvements to the dialog. Interaction with the Inkscape's ''UX'' team will be required.

== P13. Node-based filter editor ==

*Estimation of difficulty: Hard - Long (350h)
* Potential mentors: Mc
* Programming skills: C++
* Prerequisites: Minimal knowledge of build systems

<u>Detailed Description:</u> The filter editor is kind of hard to understand and master based on its current UI. Using a node-based tool for it, such as what can be done with https://notabug.org/grindhold/libgtkflow would help people create and master the filter primitives easier.

[https://gitlab.com/inkscape/ux/-/issues/40 '''Full poposal''']
==P14. Cached styles for inkex==

*Estimation of difficulty: Medium - Short (175h)
*Potential mentors: Jonathan
* Programming skills: Python, CSS
* Prerequisites: minimal knowledge of test-driven development

<u>Detailed Description:</u> When inkex, the Python library behind Inkscape's extension system, computes styles, this is relatively slow, especially for documents with either many style sheets or documents with many elements / highly nested documents. This is because for each element, the XPATH of each CSS rule is computed, and then it is checked whether the current element is in the XPATH result. Then, the same computation is repeated for the parent. Since Python is not very fast itself, such inefficiencies quickly make style evaluation unusable for big documents.

With this project, we would explore ways to speed up those computations, mainly using caching and more intelligent ways of evaluating CSS rules. Some approaches might be taken from [https://hacks.mozilla.org/2017/08/inside-a-super-fast-css-engine-quantum-css-aka-stylo/ a recent firefox refactoring].

Ideally, the caching will be tuned to support read-only (export), read-heavy (modify path), write-heavy (generate from path) and write-only (import) extensions, which have different caching needs.

The work should be done in a test-driven development approach.

== P15. Import and Export extensions ==

*Estimation of difficulty: Flexible, usually easy to medium, Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python, Ability to read technical documents, depending on the format: some reverse engineering
* Prerequisites: minimal knowledge of test-driven development

<u>Detailed Description:</u> Inkscape is alway looking to improve compatibility! Some ideas of relevant file formats - each of them more than enough for one GSoC:*Refactor our '''DXF input and output''' extensions, and expand support towards binary DXF
*Write an as-complete-as-possible '''EPS export''', circumventing the internal information loss in ghostscript (EPS is still relevant for scientific papers, but more and more tools are dropping support, so this is a chance to grab market share - the results of Adobe Distiller are much better than ghostscript's...)
*Rewrite the '''XAML importer''' in Python (currenly XSLT) to match the capabilities of the new XAML exporter (i.e. support for different target frameworks, better text support...) - would have to select carefully what to support (drawing primitives) and what not (control elements) - the boundary is not as clear-cut as it seems.
* Update the '''Synfig export''' to support the latest Synfig developments
* '''Import or export of TikZ'''. There are a few abandoned extensions out there (from which we can borrow), but it's very widely used in science - both import and export could serve an important function in the scientific workflow.
*'''Import of the proprietary fileformats''' of Affinity Design, Vectornator, Vectorstyler (especially the last two seem in their infancy and users at some point will sit on a bunch of files that they can't open anymore because their SAAS model wasn't profitable) .
*'''Import of CGM''' - old, but ISO standardized. Was supported once and dropped when the uniconvertor extension was removed for 1.0.
* '''Python based EMF / WMF importer -''' the current (core Inkscape) C extension is unmaintained and Python would probably be the right way to get more collaboration on it. A lot of public archives sit on mountains of EMF files. Note that the Document Foundation recently did a lot of work properly importing those files, so we can learn from them / maybe even join forces...
*your favorite file format? - also have a look here: https://office.inkscape.org/nextcloud/index.php/s/Tq6cdDDGay6taCw
==P16. Gcodetools refactoring and documentation==

*Estimation of difficulty: Easy- Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python
* Prerequisites: Maker background / familiarity with the Maker community

<u>Detailed Description:</u> [https://gitlab.com/inkscape/extras/extensions-gcodetools/ Gcodetools] is a set of Inkscape extensions that deal with reading and creating Gcode files, mostly for use in laser cutters or plotters. For this project, ideally someone with a Makerspace background will
#query maker spaces on their needs regarding gcodetools,
#implement those needs together with unit tests,
# improve the test coverage of Gcodetools,
#write proper documentation for it. (doesn't really exist at the moment).
==P17. Packing / Nesting as an Inkscape extension==

*Estimation of difficulty: Medium, Short or Long depending on scope (175h or 350h)
*Potential mentors: Jonathan
* Programming skills: Python
* Prerequisites: Computational geometry

<u>Detailed Description:</u> In this project, a set of packing / nesting algorithms will be implemented:
*[https://en.wikipedia.org/wiki/Cutting_stock_problem Linear nesting] is not too useful in SVG, but might be a good place to get acquainted with the problem. 2D cutting stock problem would be very interesting to have and would work great with the new multipage functionality.
*For efficient packing of free form objects, we might just re-implement [https://github.com/Jack000/SVGnest SVGNest] in Python. There are probably some more recent research papers which would be interesting to implement as a comparison.

== P18. Improving UX of Node tool and Bezier tool ==
*Estimation of difficulty: Medium - Hard, Short or Long depending on scope (175h or 350h)
*Potential mentors: Tav, ??
* Programming skills: C++,
*Prerequisites: Computational geometry

<u>Detailed Description:</u> This project would improve workflow of editing of geometry of paths. Combining strengths of Pen tool and Node tool with modifiers and new behaviors. This improvement should benefit pro users but also beginners. Good example of this implementation is in blenders new pen tool.

'''[https://gitlab.com/inkscape/ux/-/issues/5 Full Proposal here]'''[[File:Imageasdasd.png|thumb|184x184px]]

== P19. Improving UI of Live path effects ==
*Estimation of difficulty: Medium- Hard, Short or Long depending on scope (175h or 350h)
*Potential mentors: Mike, jabier ,??
* Programming skills: GTK 4, C++
*Prerequisites: Front end UI , familiarity with Live path effects
[[File:Imageasdasda qrq.png|thumb|146x146px]]

<u>Detailed Description:</u> This project Should implement Proposed UI clean up of Controls . LPE controls shoulbe be more user freindly and predictive,

[https://gitlab.com/inkscape/ux/-/issues/?sort=popularity&state=opened&label_name%5B%5D=Dialog%3A%3ALPE&first_page_size=100 '''Full Proposed designs''']

[[File:Imageasd.png|right|frameless|466x466px]]
== P20. Recolor Artwork ==
* Estimation of difficulty: Variable - Short (90h or 175h)
* Potential mentors: Adam Belis ?
* Programming skills: usually C++
* Prerequisites:

<u>Detailed Description</u>
An easy and convenient way how to change any color from the selection. Useful for experimenting and tweaking colors.

[https://gitlab.com/inkscape/inbox/-/issues/6095 '''Full proposal Here''']

<u>Use cases</u>
* fast Editing color in whole project without of need for swatches
*easier work for color harmonies in a project
*Easier iteration and visioning of designs

==Pxx. Your project ==
* Estimation of difficulty: Variable - Short or Long (175h or 350h)
* Potential mentors: Marc Jeanmougin
* Programming skills: usually C++
* Prerequisites: good ideas

<u>Detailed Description</u>
The most successful GSoC we had in the past were students coming with their own past, use cases and ideas for Inkscape. Many basic tools like 3d cubes or connectors you can see in Inkscape now have been brought by brilliant people (like you) with ideas. If we think that your project fits with Inkscape (ie: has its place with a vector graphic editor), we can help you refining your ideas and help bring shiny new stuff to life!

<u>Use cases</u>
* Amaze us!

= Successful SOC Projects from Previous Years =
* 2005
** Connectors
** Inkboard
** [http://www.openclipart.org/ Open Clip Art Library (OCAL)] Interface
** DXF Import / Export
* [[Google Summer of Code 2006|2006]]
** Support for SVG Filters
** Filter Effects
** PDF export
** Inkboard Protocol Spec / Lib Conversion
* [[Google Summer of Code 2007|2007]]
** Text Style Improvements
** PDF import
** Live Path Effects
** 3D Box Tool
** UI for SVG Filter Effects
** Raster Functionality
** Importing from, and Exporting to, a remote ccHost instance
* [[Google Summer of Code 2008|2008]]
** SVG Fonts support
** 2Geom refactoring project - port most geometry code to 2Geom
** lib2geom: interactive applications showing off the power of lib2geom
** Tech drawing abilities
** A test suite
* 2009
** [[GSoC2009 Node Tool Rewrite|Node tool rewrite]]
** D-Bus scripting API
** Connector tool improvements
** ICC/CMYK workflow
* 2010
** Cairo-based rendering
** C++ification of SP Layer
* 2011
** Rendering caching
** Javascript support improvements
** CSS support improvements
* 2012
** Usibility Improvements for Guides
** [[Tiling tool|On-canvas support for Tessellations]]
** Creating python bindings for lib2geom
* [[Google Summer of Code 2013|2013]]
** Recolor Tool
** Improved Units Support
** Electronics CAD Support
** New From Templates Dialog
** New Raster to Vector Algorithm
* 2014
** Better Support for SVG Paints
** Robust Boolean and Stroking Operations for 2Geom
* 2016
** [[GSoC 2016 Better data structure for selections|Better data structure for selections]]
** [[Style Editor|CSS Style Sheet Editor]]
* 2017
** SVG 2 Text Support
** Better CSS Style Sheet Support
* 2019
** Mesh gradient and hatches polyfills. Paint server dialog.
* 2020
** [https://gitlab.com/vanntile/inkscape-gsoc-2020 New dialog system.]
** [https://gitlab.com/rathod-sahaab/gsoc-2020-inkscape Command palette dialog.]
** Path operations.
* 2021
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3420 On canvas marker editing.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3328 Verbs to Gio::Actions.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/3294 On canvas alignment snapping.]
* 2022
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4692 Tab Structure.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4694 Font Collections.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4756 Modernizing Memory Management.]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/4504 OCR Support.]
* 2023
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/5335 GTK4 toolbar port preparation]
** [https://gitlab.com/inkscape/inkscape/-/merge_requests/5624 Customizable Appearance of Canvas Controls]

[[Category:Developer Documentation]]
</div>

Google Season of Docs 2024

2024-04-07T11:26:02Z

Joneuhauser: /* For interested technical writers */

GSoD is a Google program to connect professional technical writers with open source projects.

https://developers.google.com/season-of-docs?hl=de

On this page, we can collect ideas for our participation in the 2024 round of GSoD. Add your ideas by creating a new proposal!
==About your organisation==

Inkscape (current version 1.3.2, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. It is available for Linux, Windows and macOS, and is the only major vector graphics software (open-source or proprietary) available on Linux. Our millions of users are scientists, designers, engineers, makers and hobbyists who create scientific publications, web graphics, logos, book illustrations, comics, game assets, or technical drawings and sketches - any type of graphics that requires scalability. Our contributors have a wide range of backgrounds, similar to our users, with a healthy mix of long-term and drive-by contributions.

Inkscape is a member of the Software Freedom Conservancy.
{| class="wikitable"

|}

==About your project: Update Inkscape's Beginners' guide==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)
For this project, we already have a good candidate for the technical writer role. Documentation team lead @Moini and Project Leadership Committee member @joneuhauser are available as mentors.

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 month revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.
==For interested technical writers==
Thanks for considering Inkscape for your GSoD project! We are looking for someone who

# is able to work on this project very independently - no "hand-holding" required,
# knows Inkscape a little bit and can create accompanying graphics,
# can work with CSS and ReStructured Text,
# and works meticulously and diligently.

In order to apply, we ask you to complete a short list of tasks & answer a few questions.

#Introduce yourself on the [https://chat.inkscape.org/channel/documentation Inkscape chat] (Room #documentation), and get in touch with the team.
#Subscribe to the [https://lists.inkscape.org/postorius/lists/inkscape-docs.lists.inkscape.org/ documentation team mailing list] (very low volume). This is needed so you can send your application later on! '''There's no need to create an account there, just subscribe using your email address.'''
#[https://gitlab.com/inkscape/inkscape-docs/manuals/-/tree/master/Inkscape-Beginners-Guide?ref_type=heads Checkout] the source code of the Beginner's guide through git and review it. Make sure you can build the guide on your own PC!
#Try to find a single mistake in the manual you just compiled, and submit a merge request through Gitlab for it. If you need help with that, don't hesitate to ask in the chat. A mistake can be as small as a typo, but maybe also an outdated instruction that doesn't work for you with the latest version of Inkscape. ''With this, we can assert that you are able to work with version control tools.''
#Prepare a detailed plan (with timetable) of the work you want to do. This should roughly follow the items listed above, but feel free to set priorities / a different focus! Discuss changes with the team first via ch

Questions:
# What is your name, email address, and chat nickname?
#What's your availability during the project (in particular, timezone)
#What technical writing projects have you completed?
#Describe any work on other open-source projects.
#Why should we pick you?
All set? Great! Send your application to the documentation team mailing list until '''April 21, 2024, 18:00 UTC.'''

Google Season of Docs 2024 Proposal

2024-04-01T18:28:39Z

Joneuhauser: Created page with "= Update Inkscape's Beginners' guide = ==About your organisation== Inkscape (current version 1.3.2, first released in 2003) is a GPL-licensed program for creating artwork usi..."

= Update Inkscape's Beginners' guide =
==About your organisation==

Inkscape (current version 1.3.2, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. It is available for Linux, Windows and macOS, and is the only major vector graphics software (open-source or proprietary) available on Linux. Our millions of users are scientists, designers, engineers, makers and hobbyists who create scientific publications, web graphics, logos, book illustrations, comics, game assets, or technical drawings and sketches - any type of graphics that requires scalability. Our contributors have a wide range of backgrounds, similar to our users, with a healthy mix of long-term and drive-by contributions.

Inkscape is a member of the Software Freedom Conservancy.

==About your project ==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)
For this project, we already have a good candidate for the technical writer role. Documentation team lead @Moini and Project Leadership Committee member @joneuhauser are available as mentors.

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 month revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.

Google Season of Docs 2024

2024-03-29T19:56:43Z

Joneuhauser:

GSoD is a Google program to connect professional technical writers with open source projects.

https://developers.google.com/season-of-docs?hl=de

On this page, we can collect ideas for our participation in the 2024 round of GSoD. Add your ideas by creating a new proposal!
==About your organisation==

Inkscape (current version 1.3.2, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. It is available for Linux, Windows and macOS, and is the only major vector graphics software (open-source or proprietary) available on Linux. Our millions of users are scientists, designers, engineers, makers and hobbyists who create scientific publications, web graphics, logos, book illustrations, comics, game assets, or technical drawings and sketches - any type of graphics that requires scalability. Our contributors have a wide range of backgrounds, similar to our users, with a healthy mix of long-term and drive-by contributions.

Inkscape is a member of the Software Freedom Conservancy.
==About your project: Update INKSCAPE – Guide to a Vector Drawing Program==
===Your project's problem===
Inkscape is a very large and complex program. Many books, on-line tutorials, and videos are available to help people to learn to use Inkscape. What is missing, though, is an up-to-date, complete manual that covers all parts of Inkscape. The most complete on-line manual, [http://tavmjong.free.fr/INKSCAPE/MANUAL/html/index.html Inkscape: Guide to a Vector Drawing Program] (freely available on the web and linked to from Inkscape itself), is woefully out-of-date. The last complete update of this manual was done in 2011, with a partial update in 2017. Despite that, Inkscape users still find it quite useful (as documented by the number of times users are directed to it on social media).

=== Your project's scope ===
This project will bring the on-line manual up-to-date:
*Update the tutorials.
*Update chapters on each part of Inkscape's interface.
*Create new chapters for new tools (The Shape Builder and Pages).
*Create new sections for new dialogs.
*Move the on-line website from the Author's personal site to Inkscape's official site. (Apart from looking more official, this would enable use of https, making indexing by Google easier, as well as provide more reliable hosting).

Out-of-scope work:
*Update or include tutorials reserved under contract to the publisher of the printed book.
As a side benefit, revising the manual will probably uncover regressions and bugs with newer Inkscape versions, which we can then track and fix.

The author of the original manual is available to write the update with review by volunteers.

===Measuring your project's success===
The number of times that users access the on-line book would be an indication of the success of the project, however, Inkscape's long term commitment to user's privacy makes this difficult. A simpler measure of the success of the project would be the number of sections updated.

===Timeline===
Updating the full manual is a year-long part-time project, however, Inkscape would still benefit greatly if a significant fraction of the manual was updated. The target for this program would be to update half the book, focusing on the most pressing parts.

===Dates===
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Preliminary work (Gitlab site, continue with DocBook or switch to another source format, update tooling, etc.)
|-
|June-July
|Update introductory text and tutorials.
|-
|August
|Create new chapters for Shape tool and Page tool.
|-
|September-November
|Update individual chapters, prioritized by the Inkscape community.
|}

=== Project Budget ===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

=== Additional information ===

* '''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
* '''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.
* '''Disclosure:''' The manual’s author is a long-time Inkscape contributor and is a member of Inkscape's Project Leadership Committee.

{| class="wikitable"
|+
|}

==About your project: Update Inkscape's Beginners' guide==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)
For this project, we already have a good candidate for the technical writer role. Documentation team lead @Moini and Project Leadership Committee member @joneuhauser are available as mentors.

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 month revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.

Google Season of Docs

2024-03-29T08:53:47Z

Joneuhauser: Joneuhauser moved page Google Season of Docs to Google Season of Docs 2024

#REDIRECT [[Google Season of Docs 2024]]

Google Season of Docs 2024

2024-03-29T08:53:47Z

Joneuhauser: Joneuhauser moved page Google Season of Docs to Google Season of Docs 2024

GSoD is a Google program to connect professional technical writers with open source projects.

https://developers.google.com/season-of-docs?hl=de

On this page, we can collect ideas for our participation in the 2024 round of GSoD. Add your ideas by creating a new proposal!
==About your organisation==

Inkscape (current version 1.3, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. Inkscape is widely used to create artwork (web graphics, logos, book illustrations, comics, games, and scientific publications) that require scalability. It is available for Linux, Windows and MacOS with millions of users.

Inkscape is a member of the Software Freedom Conservancy.
==About your project: Update INKSCAPE – Guide to a Vector Drawing Program==
===Your project's problem===
Inkscape is a very large and complex program. Many books, on-line tutorials, and videos are available to help people to learn to use Inkscape. What is missing, though, is an up-to-date, complete manual that covers all parts of Inkscape. The most complete on-line manual, [http://tavmjong.free.fr/INKSCAPE/MANUAL/html/index.html Inkscape: Guide to a Vector Drawing Program] (freely available on the web and linked to from Inkscape itself), is woefully out-of-date. The last complete update of this manual was done in 2011, with a partial update in 2017. Despite that, Inkscape users still find it quite useful (as documented by the number of times users are directed to it on social media).
Your project's scope.

This project will bring the on-line manual up-to-date:
*Update the tutorials.
*Update chapters on each part of Inkscape's interface.
*Create new chapters for new tools (The Shape Builder and Pages).
*Create new sections for new dialogs.
*Move the on-line website from the Author's personal site to Inkscape's official site. (Apart from looking more official, this would enable use of https, making indexing by Google easier, as well as provide more reliable hosting).

Out-of-scope work:
*Update or include tutorials reserved under contract to the publisher of the printed book.
As a side benefit, revising the manual will probably uncover regressions and bugs with newer Inkscape versions, which we can then track and fix.

The author of the original manual is available to write the update with review by volunteers.

===Measuring your project's success===
The number of times that users access the on-line book would be an indication of the success of the project, however, Inkscape's long term commitment to user's privacy makes this difficult. A simpler measure of the success of the project would be the number of sections updated.

===Timeline===
Updating the full manual is a year-long part-time project, however, Inkscape would still benefit greatly if a significant fraction of the manual was updated. The target for this program would be to update half the book, focusing on the most pressing parts.

===Dates===
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Preliminary work (Gitlab site, continue with DocBook or switch to another source format, update tooling, etc.)
|-
|June-July
|Update introductory text and tutorials.
|-
|August
|Create new chapters for Shape tool and Page tool.
|-
|September-November
|Update individual chapters, prioritized by the Inkscape community.
|}

=== Project Budget ===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

=== Additional information ===

* '''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
* '''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.
* '''Disclosure:''' The manual’s author is a long-time Inkscape contributor and is a member of Inkscape's Project Leadership Committee.

{| class="wikitable"
|+
|}

==About your project: Update Inkscape's Beginners' guide==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 months revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.

Google Season of Docs 2024

2024-03-29T08:51:16Z

Joneuhauser:

GSoD is a Google program to connect professional technical writers with open source projects.

https://developers.google.com/season-of-docs?hl=de

On this page, we can collect ideas for our participation in the 2024 round of GSoD. Add your ideas by creating a new proposal!
==About your organisation==

Inkscape (current version 1.3, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. Inkscape is widely used to create artwork (web graphics, logos, book illustrations, comics, games, and scientific publications) that require scalability. It is available for Linux, Windows and MacOS with millions of users.

Inkscape is a member of the Software Freedom Conservancy.
==About your project: Update INKSCAPE – Guide to a Vector Drawing Program==
===Your project's problem===
Inkscape is a very large and complex program. Many books, on-line tutorials, and videos are available to help people to learn to use Inkscape. What is missing, though, is an up-to-date, complete manual that covers all parts of Inkscape. The most complete on-line manual, [http://tavmjong.free.fr/INKSCAPE/MANUAL/html/index.html Inkscape: Guide to a Vector Drawing Program] (freely available on the web and linked to from Inkscape itself), is woefully out-of-date. The last complete update of this manual was done in 2011, with a partial update in 2017. Despite that, Inkscape users still find it quite useful (as documented by the number of times users are directed to it on social media).
Your project's scope.

This project will bring the on-line manual up-to-date:
*Update the tutorials.
*Update chapters on each part of Inkscape's interface.
*Create new chapters for new tools (The Shape Builder and Pages).
*Create new sections for new dialogs.
*Move the on-line website from the Author's personal site to Inkscape's official site. (Apart from looking more official, this would enable use of https, making indexing by Google easier, as well as provide more reliable hosting).

Out-of-scope work:
*Update or include tutorials reserved under contract to the publisher of the printed book.
As a side benefit, revising the manual will probably uncover regressions and bugs with newer Inkscape versions, which we can then track and fix.

The author of the original manual is available to write the update with review by volunteers.

===Measuring your project's success===
The number of times that users access the on-line book would be an indication of the success of the project, however, Inkscape's long term commitment to user's privacy makes this difficult. A simpler measure of the success of the project would be the number of sections updated.

===Timeline===
Updating the full manual is a year-long part-time project, however, Inkscape would still benefit greatly if a significant fraction of the manual was updated. The target for this program would be to update half the book, focusing on the most pressing parts.

===Dates===
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Preliminary work (Gitlab site, continue with DocBook or switch to another source format, update tooling, etc.)
|-
|June-July
|Update introductory text and tutorials.
|-
|August
|Create new chapters for Shape tool and Page tool.
|-
|September-November
|Update individual chapters, prioritized by the Inkscape community.
|}

=== Project Budget ===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

=== Additional information ===

* '''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
* '''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.
* '''Disclosure:''' The manual’s author is a long-time Inkscape contributor and is a member of Inkscape's Project Leadership Committee.

{| class="wikitable"
|+
|}

==About your project: Update Inkscape's Beginners' guide==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 months revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.

Google Season of Docs 2024

2024-03-29T08:50:52Z

Joneuhauser:

GSoD is a Google program to connect professional technical writers with open source projects.

https://developers.google.com/season-of-docs?hl=de

On this page, we can collect ideas for our participation in the 2024 round of GSoD.
==About your organisation==

Inkscape (current version 1.3, first released in 2003) is a GPL-licensed program for creating artwork using SVG as its native format. Inkscape is widely used to create artwork (web graphics, logos, book illustrations, comics, games, and scientific publications) that require scalability. It is available for Linux, Windows and MacOS with millions of users.

Inkscape is a member of the Software Freedom Conservancy.
==About your project: Update INKSCAPE – Guide to a Vector Drawing Program==
===Your project's problem===
Inkscape is a very large and complex program. Many books, on-line tutorials, and videos are available to help people to learn to use Inkscape. What is missing, though, is an up-to-date, complete manual that covers all parts of Inkscape. The most complete on-line manual, [http://tavmjong.free.fr/INKSCAPE/MANUAL/html/index.html Inkscape: Guide to a Vector Drawing Program] (freely available on the web and linked to from Inkscape itself), is woefully out-of-date. The last complete update of this manual was done in 2011, with a partial update in 2017. Despite that, Inkscape users still find it quite useful (as documented by the number of times users are directed to it on social media).
Your project's scope.

This project will bring the on-line manual up-to-date:
*Update the tutorials.
*Update chapters on each part of Inkscape's interface.
*Create new chapters for new tools (The Shape Builder and Pages).
*Create new sections for new dialogs.
*Move the on-line website from the Author's personal site to Inkscape's official site. (Apart from looking more official, this would enable use of https, making indexing by Google easier, as well as provide more reliable hosting).

Out-of-scope work:
*Update or include tutorials reserved under contract to the publisher of the printed book.
As a side benefit, revising the manual will probably uncover regressions and bugs with newer Inkscape versions, which we can then track and fix.

The author of the original manual is available to write the update with review by volunteers.

===Measuring your project's success===
The number of times that users access the on-line book would be an indication of the success of the project, however, Inkscape's long term commitment to user's privacy makes this difficult. A simpler measure of the success of the project would be the number of sections updated.

===Timeline===
Updating the full manual is a year-long part-time project, however, Inkscape would still benefit greatly if a significant fraction of the manual was updated. The target for this program would be to update half the book, focusing on the most pressing parts.

===Dates===
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Preliminary work (Gitlab site, continue with DocBook or switch to another source format, update tooling, etc.)
|-
|June-July
|Update introductory text and tutorials.
|-
|August
|Create new chapters for Shape tool and Page tool.
|-
|September-November
|Update individual chapters, prioritized by the Inkscape community.
|}

=== Project Budget ===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

=== Additional information ===

* '''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
* '''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.
* '''Disclosure:''' The manual’s author is a long-time Inkscape contributor and is a member of Inkscape's Project Leadership Committee.

{| class="wikitable"
|+
|}

==About your project: Update Inkscape's Beginners' guide==
Inkscape has an official user manual hosted at [https://inkscape-manuals.readthedocs.io/en/latest/ ReadTheDocs], which covers basic usage of Inkscape, with guides on drawing tools, colors, text, etc. However the manual is currently targeting Inkscape 1.1, while the latest version is 1.3.2. In between, there are a number of undocumented changes, such as the new Live Path Effects dialog, on-canvas pattern editing, spiro and BSpline path support, multiple pages support, shape builder and more. Other parts of the manual (shortcuts, icons, etc.) also need updating to reflect the current user interface. These missing functionalities and outdated instructions confuse newcomers, which the manual primarily targets. Additionally, the manual lacks consistency in the colors and resolutions used in figures and the comprehensiveness of tool descriptions. The manual also lacks a contribution guide, including how to contribute translations, which makes it difficult for new contributors to help with user-facing documentation.

===Your project's scope===
The Inkscape Beginner’s Guide update project will:

*Review the current guide and mark all places that needs an update within a Gitlab issue (with sub-issues if needed).
*Add pages and paragraphs for new tools in appropriate locations, such as the Pages tool and the Measure tool under 'Useful Techniques', the filter editor dialog in the 'Filters' page, the new color wheel in the 'Fill and Stroke' page, etc.
*Update parts of the guide according to the aforementioned issue.
*Create a 'style guide' in the README documenting the tone of voice of the guide, colors and proportions used for figures. Include information about the translation process in the contributors guide, and document language-specific details (such as the use of “you” and “we” in English).
*Re-capture screenshots of the current interface and redraw figures according to the style guide.
*Edit the guide to make wording and grammar consistent.
*Work with the inkscape-docs team to update the documentation on the ReadTheDocs site.

Work that is out-of-scope for this project:

*This project will not create tutorial pages that incorporates multiple tools. (This comes after the project ends)

===Measuring your project's success===
The Inkscape forum and chatroom currently recieves a number of questions per day, some of which are related to new features, therefore we aren’t able to refer them to the manual. The improved documentation would give people a definitive source to point to when answering questions, and we hope it helps people understand the tools further in addition to solving the problem. We also think that the contribution guide would help aspiring manual writers and translators make their first contribution, which hopefully makes them stick around and contribute further.

We will track the number of total visitors monthly, and the amount of merge requests and issues opened quarterly after the manual is updated.

We will consider the project successful if, after publication of the new manual:

*The number of individual visitors (indicated by ReadTheDocs) increases by 15%
*Translations for at least one additional language is being worked on
*The number of contributors who have made >3 contributions increases by 10% (beginning the quarter after the documentation is published)

===Timeline===
The project will take approximately 6 months to complete. We’ll spend a month creating the style guide and documenting required changes and additions, 4 months editing and creating pages, and 1 months revising all aspects of the manual adhering to the style guide.
{| class="wikitable"
!Dates
!Action Items
|-
|May
|Create style guide and document required changes and additions
|-
|June - September
|Edit and create pages
|-
|October
|Revise the text and figures
|-
|November
|Project completion
|}

===Project Budget===
{| class="wikitable"
!Budget item
!Amount
!Running Total
!Notes/justifications
|-
|Technical writer, manual update.
|12500.00
|12500.00
|
|-
|Volunteer stipends
|500.00
|13500.00
|2 volunteer stipends x 500 each
|-
|Software Freedom Conservancy fee
|1500.00
|15000.00
|Inkscape is a member of SFC (as suggested also on the [https://developers.google.com/season-of-docs/docs/org-payments GSoD documentation]), and due to our fiscal sponsorship agreement, the SFC takes a 10% cut of the gross income of the project.
|-
|TOTAL
|
|15000.00
|
|}

===Additional information===
*'''Previous experience with technical writers or documentation:''' Inkscape maintains a [https://inkscape.org website] with user and developer documentation. Keeping this website current is a one of the most difficult problems we face. All contributions have been made by volunteers.
*'''Previous participation in Google Season of Docs, Google Summer of Code or others:''' Inkscape has participated in Google Summer of Code every year except for one, since its inception. GSoC students have made significant contributions to Inkscape.

Google Season of Docs 2024

2024-03-29T08:43:40Z

Joneuhauser: Created page with "GSoD is a Google program to connect professional technical writers with open source projects. https://developers.google.com/season-of-docs?hl=de On this page, we can collect..."

Release notes/1.3

2023-04-01T18:29:57Z

Joneuhauser: /* Import / Export */

Contracting Process

2023-03-13T14:01:23Z

Joneuhauser:

This page represents the current state of our knowledge on how to propose paid development / contract work for '''outside''' contractors as well as find and hire such contractors. It's mostly based on the experience from the 2022/2023 Import Extension project. The only '''required''' process is to get a PLC vote and work with the SFC but this represents lessons learned on the best way to achieve a successful contracting experience.

For a tender tailored to one or more previously known persons (e.g. internal contractors, highly specialized outside knowledge...) the selection process can be ommitted which speeds up the process considerably, and reduces the amount of work spent on the administrative side by '''a lot'''. However, '''a lot of additional justification''' is needed why the selection process can be ommitted ("we want to hire an internal contributor to fix a lot of bugs in their knowledge domain, fast", "we want to hire a maintainer of an upstream project because we lack the internal resources to tackle a problem" etc.). The SFC is a US non-profit organization that has rather strict rules to ensure that the money isn't used for self-enrichment, which requires open and visible processes on how money is spent. Often that makes having a selection process, though cumbersome, easier to justify a choice.

== General steps ==
{| class="wikitable"
|+
!What?
!Who?
!How long?
|-
|'''Start with an idea''' for a contractor project. The idea should be clearly-limited, in the public interest (i.e. a general consensus that something needs to be done) and it should be obvious that the project lacks volunteer resources to do it internally.
|Initiator
| rowspan="4" |2 weeks
|-
|'''Discuss''' the idea with other people in the project. Places that are great to bring up ideas are: Developer Meeting, Vectors meeting, mailing lists, forums and RocketChat. Seek a consensus that executing the project as contracting work is in the interest of the project, discuss an approximate budget and '''find a project representative.''' The project rep. will play an important role during the candidate selection process as well, and will be the project contact the contractor will report to. A stipend is possible for the project representative. Also try to find people that want to help with the candidate selection process ("hiring team") - the future rep needs to be a member of that hiring team, and the initiator should be as well.
|Initiator
|-
|'''Write a draft proposal''' (template see below). A lot of that proposal can be reused later for the job posting, as well as website or blog articles. Distribute it and incorporate feedback, especially from people familiar with the work that needs to be done, and as if folks '''from at the SFC''' can look at it to ensure it matches all of their requirements.
|Inititator, dev chat, SFC
|-
|Have a present PLC member to trigger a PLC vote (works fastest if you provide them with the ballot).
|
|-
|'''PLC vote'''. If the vote is not in favor of the project, go back to step 3/4 and incorporate the PLC's concerns.
|PLC
|1 week
|-
|Together with the hiring team, transform the proposal into a '''job posting and post it''' on relevant sites (can also be done by the SFC). Coordinate with Vectors whether social posts about it are appropriate; at the very least, create a blog post on the website.
The hiring team needs to decide on the candidate's profile, documents to be submitted and a time schedule for the selection process (should be a part of the job posting).
|Inititator, Vectors,
Hiring team,

SFC

Project Rep
|2 weeks
|-
|Wait for people to apply. This is a good time for the mentor to prepare everything on the technical side, i.e. boilerplate code, gather documentation, logins, etc...
|
|1 month
|-
|'''Selection process'''. A possible process is given below, but can be adapted to the projects' needs.
|SFC, hiring team
|1 month
|-
|'''Hire contractor''' - contract negotiation, payment details and modalities etc.
|SFC
|2 weeks
|}
All in all, it takes about ~3-4 months from an initial idea until work on the project can start.

== Proposal and job offer items ==
A = Proposal for PLC vote, B = job posting, C = website blog post

For reference 2023 Import Extension project:

* Proposal: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.pdf
* Ballot: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.html
* Job posting: https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/
* Website post: https://inkscape.org/news/2022/12/12/hiring-python-developer-import-extension/

{| class="wikitable"
|+
!Title
!Contents
!Documents
|-
|Overview
|Who are we looking for?
What timeframe?

Which kind of work?
|A, B, C
|-
|Detailed description of project
|Scope of the work
more details what will be done, and what the project will build upon

(can be ~ half a page)
|A, B
|-
|Milestones
|Detailed description of the work (think in packages of a week, comparable to GSoC) - no absolute dates yet
Technical information as required

If an extension of the project is up for discussion - when will this be discussed and who decides?
|A
|-
|Duration and schedule
|How much time (full time equivalent)?
Part-time (or less) possible?

Expected start time?
|B
|-
|Financials
|Allocated budget for contractor compensation, including possible extensions
Mentoring stipend? (roughly GSoC equivalent)

Stipend for hiring team?
|A
|-
|Compensation of contractor
|Hourly rate (discuss with SFC), payment terms (net-30)
Formal requirements (i.e. no applicants from US-embargoed countries)
|B
|-
|Hiring team
|Duties: candidate selection, deciding on the decision process (i.e. interviews, coding test)
Specify members in the proposal. Stand-in members?

One SFC member mandatory (might waive once we get more experienced with this)
|A
|-
|Candidate's profile
|Previous experience in: a certain programming language, contribution to FOSS, in a certain domain of knowledge
|B, C
|-
|Required documents
|CV
Link to personal portfolio (Github, GitLab, personal website, self-hosted git...)

Some questions about the candidate's motivation, relevant experience, time zone they're in (to schedule interviews)
|B
|-
|Application and submission
|Submission email (ie. jobs@)
Deadline for submissions
|B, C
|-
|Schedule of the evaluation
process
|Programming exercise? (when?)
Interviews? (when?)

Work will start when?
|B
|}

== Sites to post job posting to ==

* [https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/ https://www.fossjobs.net] (generated a lot of traffic and most our applications come from there)
* https://shecodeafrica.org/jobs/
* https://www.blacksintechnology.net/jobs-board/
* https://www.pocitjobs.com/
* https://careers.aises.org/
* https://www.diversifytech.co/post-a-job/
* https://techfugees.com/jobs/
* https://www.womenwhocode.com/jobs
* Outreachy alumni list

== Selection process ==
Highly depends on the actual project, here's what worked for the 2023 Import project:

* Screen applications and remove obviously unsuitable candidates (e.g. based on experience, past contributions)
* Formulate coding test and send it to the remaining candidates. Give them ~2 weeks time to complete it. The test should not take them more than 2 hours for a simple solution. Expect that quite a few of the solution will be "above and beyond". It's proven beneficial to have them fork a private git repository and invite a hiring team member (e.g. the mentor) when they're done. This also shows that they can work with Gitlab and lets us have a look at their commit hygiene.
* Reduce the list of applicants to ~3-4 based on CV and the solution. Different evaluation criteria for each hiring team members are ok and actually good: for example, the mentor might look more at "do I anticipate that I can work well with this person". It's the discussion and diversity in backgrounds that makes for a good discussion. Send the removed applicants a rejection email, it's nice to include a reason why they were not selected so they can improve their next application.
* Agree upon a list of interview timeslots and create a sign up form where they can sign up (signupgenius works for that, maybe we can incorporate it in the inkscape.org website if we need it more regularly? - NextCloud has a scheduling app which could be used)
* Perform interviews, where the candidates are also encouraged to ask questions.
* Vote on who is selected. The mentor may act as tiebreaker.
* Offer the position to the selected candidate. After they accept, notify the other applicants – thank people for their application and their time. It can be helpful to include a reason why they were not selected so they can improve their next application.
* Contract details are handled by the SFC.

Hackfest2023 Bensberg

2023-03-13T09:36:14Z

Joneuhauser: /* Hackfest Agenda */

[[File:Hackfest bensberg sticker.png|left|thumb|150x150px]]
This page details the planning of Inkscape's 2023 hackfest in Bensberg, Germany. The hackfest will take place on '''March 13-17, 2023'''. We are looking to bring together a group of '''11 attendees'''. <s>but do not let that number discourage you from throwing your hat in the ring in case we reach/go over it.</s> We are fully booked and the number of participants is final now.

This hackfest is a standalone event and not organized around any other event or FOSS conference.

Previous events: [[Hackfest2019 Saarbrücken]], [[Hackfest2019 SCALE]], [[Hackfest2018 Kiel]], [[Hackfest2018 LGM]], [[Hackfest2018]], [[Hackfest2017]], [[Hackfest2016]], [[Hackfest2015]].
[[Category:Hackfest]]

=Description=
It's a hackfest! We will work on Inkscape bugs, new features, packaging, website issues, ... in fact anything that can benefit from us being physically in the same space. And let's not forget about the social component - all work and no play makes Jack a dull boy! We get to hang and talk and laugh in person since we usually only meet virtually :).
==Bensberg==
Bensberg is part of Bergisch Gladbach, a city in the western part of Germany, about 15 km east of Cologne. It is beautifully located in the countryside, surrounded by lush forests slightly elevated to give a great view depending on weather conditions. The nearest airport is Cologne Bonn (CGN) which is an international airport.
*[https://en.wikipedia.org/wiki/Bergisch_Gladbach Bergisch Gladbach on Wikipedia]
[[File:Bensberg.png|none|thumb|Bensberg (range indicated to Cologne's Cathedral). Screenshot from Google Maps.]]

==Venue==
Our host is the [https://www.akademie-generali.de/en/home Generali Akademie], the dedicated education and conference center of the Generali Group in Germany (it's an insurance company). The location's special appeal is its all-inclusive package: conference rooms, hotel rooms and full catering service are conveniently provided on-site.

''(full disclosure: as an employee, RdH has been there multiple times)''
{| class="wikitable"
|+Location, Location, Location!
!official address
!for navigation systems
|-
|Generali Akademie
Am Schloss 1-3

51429 Bergisch-Gladbach

Germany
|Generali Akademie
Jan-Wellem-Straße

51429 Bergisch-Gladbach

Germany
|}

===Catering===
We have full catering on-site, i.e. breakfast, lunch and dinner including non-alcoholic drinks. Our meeting room also comes with coffee and beverages throughout the day.
{| class="wikitable"
|+Don't starve together
!
!time
!comment
|-
|breakfast
|'''7:00 - 9:00'''
|buffet
|-
|lunch
|'''12:00'''
|buffet; vegetarian only
|-
|dinner
|'''18:30'''
|buffet; meat or fish
|}

===Facilities===

* office hours reception: '''8:00 - 16:00'''

* meeting room available '''9:00 - 22:00'''.

*Wireless networking (fast broadband), powered by [https://www.m3connect.de/ m3connect]
* <u>No wired network available</u>
*Europlug type F
** we should bring some power strips
*LCD projector, DVD player, VHS VCR (lol!)
*swimming pool, whirlpool, sauna
=== Vicinity===
Nature. A castle. A small city.

=== Arrival and Departure ===
All times UTC+1.

* earliest arrival on Monday: '''9:00''', RdH is supposed to be the first on site
** hotel rooms available: '''15:00'''
* window of departure on Friday: '''17:00-18:00''' (we need to be gone by '''18:00''')

==Travel information==
Your main destination is Cologne.

=== from Cologne/Bonn airport (CGN) to central station ===
Take the tram [https://ekap-download.vrs.de/downloads/linien/mini-fahrplan/2023_1219_S19.pdf?1671001552 S19] to Cologne central station. Travel time is about 15 minutes. The tram is scheduled every 20 minutes for most of the day.

=== from Cologne central station to Bensberg (public transportation) ===
Take the bus [https://ekap-download.vrs.de/downloads/linien/mini-fahrplan/2023_40_SB40.pdf?1670826858 Schnellbus SB 40] that directly connects Cologne central station to Bensberg (final stop). Travel time is about 30 minutes. This bus is scheduled every half hour between 6am and 8pm.
[[File:Central station.png|none|thumb]]
Once you arrive at the [https://ekap-download.vrs.de/downloads/haltestellen/lageplan/u_Bergisch_Gladbach_Bensberg.pdf?1670243814 bus stop in Bensberg], you can either take a taxi or walk about 900m to our location.
[[File:Bus stop bensberg.png|none|thumb]]

=== from Cologne central station to Bensberg (cab) ===
Our hosts have special conditions with a local cab service (https://www.transfer-nurdogan.de/). I can't tell if that's cheaper compared to the others or just for a classy look:

* 45 € (standard)
* 50 € (large cab, suitable for sharing)

== Hotels ==
Hotel rooms are provided on-site and are part of our conference package, no dedicated booking necessary.

==Cost calculation==

=== per attendee ===

The fee for housing and catering per attendee is 837 € <s>and is due on the last day of the event, payable via debit or credit card (VISA, Mastercard) by each individual themself. A billing address needs to be provided in advance.</s><syntaxhighlight lang="text">
hotel room incl. breakfast 127 € x 4 days = 508 €
catering service (days 1-4) 70 € x 4 days = 280 €
catering service (day 5) 49 € x 1 day = 49 €
-------------------------------------------- 837 €
</syntaxhighlight>

=== joint event ===
The meeting room fee is 900 €. Additionally, we have allocated a budget for alcoholic drinks as those are not included in our otherwise "all inclusive package".<syntaxhighlight lang="text">
meeting room (days 1-5) 180 € x 5 days = 900 €
alcoholic drinks 500 € x 1 = 500 €
-------------------------------------------- 1,400 €
</syntaxhighlight>

=== Total ===
Using the interim results from above, this brings us to a total cost (excl. travel) of up to 9,770 €. The fixed part of the total cost (i.e. everything without alcoholic drinks) is 9,270 € and has been payed in full by the SFC by international wire transfer. The total amount for alcoholic drinks - if any - will have to be payed on-site on the last day of our event (RdH will take care of this and do the reimbursement process later).<syntaxhighlight lang="text">
participants 837 € x 10 = 8,370 €
joint event 1400 € x 1 = 1,400 €
-------------------------------------------- 9,770 €
</syntaxhighlight>
=Attendance =

*Hackfest Bensberg 2023 takes place on '''March 13-17, 2023'''
*deadline to apply for attendance is '''February 01, 2023'''

== preface==
In an initial poll, 8 people expressed their interest/availability for this hackfest. Based on this number we are planning for 10 attendees. Should more people be interested, we'll try our best to expand - the earlier we know, the better! If we don't reach 10, we will try to scale down our booking. If you are interested, don't hold yourself back!

==I want to attend!==
That's great! Be aware of the following:

*You are making a commitment here which will produce expenses for the project. Please make sure that you will be able to honor this commitment! ''(Are you table to take the week off from your day job? Are you able to travel? etc.)''
* Every attendee will have to pay their fee of 837 € on the last day of the hackfest. There is something special about payment methods that we will have to talk about privately, I'll contact everyone. ''(After the hackfest you can follow the reimbursement procedure.)''
*You are eligible to apply no matter if you participated in the initial poll/"call for interest". ''(Only in case we end up being seriously overbooked and cannot accommodate for everybody we will take the initial poll into account.)''

Now go ahead and add yourself to this table (or ask in [https://gitlab.com/inkscape/inbox/-/issues/8109 this issue] and it will be done for you):

Join the Signal phone group to keep in touch with everyone during the event.
{| class="wikitable"
|+
!Name
!GitLab handle
!Inbound
!Outbound
|-
|Martin Owens
|@doctormo
|LH423 13T05:15 FRA
|UA8853 21T10:50 FRA
|-
|Jonathan Neuhauser
|@joneuhauser
|13.03. 9:55 (Bensberg)
|17.03. 16:08 (Bensberg)
|-
|Tavmjong Bah
|@Tavmjong
|13.03 13:15 Cologne
|17.03 18:43 Cologne
|-
|Marc Jeanmougin
|@marcjeanmougin
|12.03 13h15 Cologne Hbf
|19.03 13h42 Cologne Hbf
|-
|Chris Rogers
|@CRogers
|13.03. 12:00 (Bensberg)
|booked - ok!
|-
|René de Hesselle
|@dehesselle
|13.03. 9:00 (Bensberg)
|17.03. 17:00 (Bensberg)
|-
|Jabier Arraiza
|@jabiertxof
|14.03. between 9 and 11 (13.03 22:30 DUS)
|19.03 15:45 DUS
|-
|Thomas Holder
|@speleo3
|13.03. 12:05 Cologne Hbf
|17.03. 17:55 Cologne Hbf
|-
|Ted Gould
|@ted.gould
|booked - ok!
|booked - ok!
|-
|Nicco Kunzmann
|@niccokunzmann
|13.03. between 10 and 12
|Booked
|-
|Pono Takamori
|@pono1
|14.03. ~12:00 (Bensberg)
|tba
|}

== I want SFC to pay for my flight/train ==

* @doctormo
* @jabiertxof
* @niccokunzmann
*@speleo3

== Hackfest Agenda ==

=== Add your ideas here! We'll make a tentative agenda at the start ===

* Organization
** Community: Vectors, Testers, Translators, etc.
*** Social video call with Vectors.
***Is there interest in merging communities? E.g. our user channel and Discord?
** Board election
** Financial status
** Paid development (GTK4 proposal, Release Video proposal)
**Funding paid development
**Retiring the Wiki (sorry for the clickbait title)
* Infrastructure
** Website, social media
** Resources for developers
* GSoC and Outreachy
**rework [[Google Summer of Code]] page to give more guidance for first-timers so that Vectors and others don't have to answer the same questions across dozens of channels every year https://chat.inkscape.org/channel/team_vectors?msg=9TPcKXybuSWZNSndw
**"raising the bar": beginner friendly vs minimum required experience; improving documentation and/or additional offerings
* Development discussions
** Releases
** Dependencies
** Bug fixing
** GTK4
** Refactoring
** etc.
* Hacking
** Code reviews
** Critical bugs for 1.3

Hackfest2023 Bensberg

2023-02-14T17:34:14Z

Joneuhauser: /* I want to attend! */

[[File:Hackfest bensberg sticker.png|left|thumb|150x150px]]
This page '''<big>IS WORK IN PROGRESS</big>''' and details the planning of Inkscape's 2023 hackfest in Bensberg, Germany. The hackfest will take place on '''March 13-17, 2023'''. We are looking to bring together a group of '''10 attendees'''. <s>but do not let that number discourage you from throwing your hat in the ring in case we reach/go over it.</s> We are fully booked and the number of participants is final now.

This hackfest is a standalone event and not organized around any other event or FOSS conference.

Previous events: [[Hackfest2019 Saarbrücken]], [[Hackfest2019 SCALE]], [[Hackfest2018 Kiel]], [[Hackfest2018 LGM]], [[Hackfest2018]], [[Hackfest2017]], [[Hackfest2016]], [[Hackfest2015]].
[[Category:Hackfest]]

=Description=
It's a hackfest! We will work on Inkscape bugs, new features, packaging, website issues, ... in fact anything that can benefit from us being physically in the same space. And let's not forget about the social component - we get to hang and talk and laugh in person since we usually only meet virtually :).
==Bensberg==
Bensberg is part of Bergisch Gladbach, a city in the western part of Germany, about 15 km east of Cologne. It is beautifully located in the countryside, surrounded by lush forests slightly elevated to give a great view depending on weather conditions. The nearest airport is Cologne Bonn (CGN) which is an international airport.
*[https://en.wikipedia.org/wiki/Bergisch_Gladbach Bergisch Gladbach on Wikipedia]
[[File:Bensberg.png|none|thumb|Bensberg (range indicated to Cologne's Cathedral). Screenshot from Google Maps.]]

==Venue==
Our host is the [https://www.akademie-generali.de/en/home Generali Akademie], the dedicated education and conference center of the Generali Group in Germany (it's an insurance company). The location's special appeal is its all-inclusive package: conference rooms, hotel rooms and full catering service are conveniently provided on-site.

''(full disclosure: as an employee, RdH has been there multiple times)''
{| class="wikitable"
|+
!official address
!for navigation systems
|-
|Generali Akademie
Am Schloss 1-3

51429 Bergisch-Gladbach

Germany
|Generali Akademie
Jan-Wellem-Straße

51429 Bergisch-Gladbach

Germany
|}

===Catering===
We have full catering on-site, i.e. breakfast, lunch and dinner including non-alcoholic drinks. Our meeting room also comes with coffee and beverages throughout the day.
===Facilities===
*Wireless networking (fast broadband), powered by [https://www.m3connect.de/ m3connect]
* <u>No wired network available</u>
*Europlug type F
** we should bring some power strips
*LCD projector, DVD player, VHS VCR (lol!)
*swimming pool, whirlpool, sauna
=== Vicinity===
Nature. A castle. A small city.

=== Arrival and Departure ===
All times UTC+1.

* earliest arrival on Monday: 8am
** hotel rooms available: 3pm
* latest departure on Friday: 5pm
** We have some flexibility here, but we need to tell our hosts in advance.

==Travel information==
Your main destination is Cologne.

=== from Cologne/Bonn airport (CGN) to central station ===
Take the tram [https://ekap-download.vrs.de/downloads/linien/mini-fahrplan/2023_1219_S19.pdf?1671001552 S19] to Cologne central station. Travel time is about 15 minutes. The tram is scheduled every 20 minutes for most of the day.

=== from Cologne central station to Bensberg (public transportation) ===
Take the bus [https://ekap-download.vrs.de/downloads/linien/mini-fahrplan/2023_40_SB40.pdf?1670826858 Schnellbus SB 40] that directly connects Cologne central station to Bensberg (final stop). Travel time is about 30 minutes. This bus is scheduled every half hour between 6am and 8pm.
[[File:Central station.png|none|thumb]]
Once you arrive at the [https://ekap-download.vrs.de/downloads/haltestellen/lageplan/u_Bergisch_Gladbach_Bensberg.pdf?1670243814 bus stop in Bensberg], you can either take a taxi or walk about 900m to our location.
[[File:Bus stop bensberg.png|none|thumb]]

=== from Cologne central station to Bensberg (cab) ===
Our hosts have special conditions with a local cab service (https://www.transfer-nurdogan.de/). I can't tell if that's cheaper compared to the others or just for a classy look:

* 45 € (standard)
* 50 € (large cab, suitable for sharing)

== Hotels ==
Hotel rooms are provided on-site and are part of our conference package, no dedicated booking necessary.

==Cost calculation==

=== per attendee ===

The fee for housing and catering per attendee is 837 € and is due on the last day of the event, payable via debit or credit card (VISA, Mastercard) by each individual themself. A billing address needs to be provided in advance.<syntaxhighlight lang="text">
hotel room incl. breakfast 127 € x 4 days = 508 €
catering service (days 1-4) 70 € x 4 days = 280 €
catering service (day 5) 49 € x 1 day = 49 €
-------------------------------------------- 837 €
</syntaxhighlight>

=== joint event ===
One attendee (RdH) needs to pay the additional fees for the joint event. This covers the meeting room (900 €) and all the alcoholic drinks (estimated 500 €) that have been consumed during the event. ''(Alcoholic drinks are not included in our otherwise "all inclusive" package and individual payment is not possible.)''<syntaxhighlight lang="text">
meeting room (days 1-5) 180 € x 5 days = 900 €
alcoholic drinks 500 € x 1 = 500 €
-------------------------------------------- 1,400 €
</syntaxhighlight>

=== Total ===

Using the interim results from above, this brings us to a total cost (excl. travel) of 9,770 €.<syntaxhighlight lang="text">
participants 837 € x 10 = 8,370 €
joint event 1400 € x 1 = 1,400 €
-------------------------------------------- 9,770 €
</syntaxhighlight>
=Attendance =

*Hackfest Bensberg 2023 takes place on '''March 13-17, 2023'''
*deadline to apply for attendance is '''February 01, 2023'''

== preface==
In an initial poll, 8 people expressed their interest/availability for this hackfest. Based on this number we are planning for 10 attendees. Should more people be interested, we'll try our best to expand - the earlier we know, the better! If we don't reach 10, we will try to scale down our booking. If you are interested, don't hold yourself back!

==I want to attend!==
That's great! Be aware of the following:

*You are making a commitment here which will produce expenses for the project. Please make sure that you will be able to honor this commitment! ''(Are you table to take the week off from your day job? Are you able to travel? etc.)''
* Every attendee will have to pay their fee of 837 € on the last day of the hackfest. There is something special about payment methods that we will have to talk about privately, I'll contact everyone. ''(After the hackfest you can follow the reimbursement procedure.)''
*You are eligible to apply no matter if you participated in the initial poll/"call for interest". ''(Only in case we end up being seriously overbooked and cannot accommodate for everybody we will take the initial poll into account.)''

Now go ahead and add yourself to this table (or ask in [https://gitlab.com/inkscape/inbox/-/issues/8109 this issue] and it will be done for you):

Join the Signal phone group to keep in touch with everyone during the event.
{| class="wikitable"
|+
!Name
!GitLab handle
!Inbound
!Outbound
|-
|Martin Owens
|@doctormo
|LH423 13T05:15 FRA
|UA8853 21T10:50 FRA
|-
|Jonathan Neuhauser
|@joneuhauser
|13.03. 9:55 (Bensberg)
|17.03. 16:08 (Bensberg)
|-
|Tavmjong Bah
|@Tavmjong
|
|
|-
|Marc Jeanmougin
|@marcjeanmougin
|
|
|-
|Chris Rogers
|@CRogers
|
|
|-
|René de Hesselle
|@dehesselle
|
|
|-
|Jabier Arraiza
|@jabiertxof
|
|
|-
|Thomas Holder
|@speleo3
|
|
|-
|Ted Gould
|@ted.gould
|
|
|-
|Nicco Kunzmann
|@niccokunzmann
|
|
|}

== I want SFC to pay for my flight/train ==

* @doctormo
* @jabiertxof
* @niccokunzmann

== Hackfest Agenda ==

=== Add your ideas here! We'll make a tentative agenda at the start ===

* Organization
** Community: Vectors, Testers, Translators, etc.
*** Social video call with Vectors.
***Is there interest in merging communities? E.g. our user channel and Discord?
** Board election
** Financial status
** Paid development
* Infrastructure
** Website, social media
** Resources for developers
* GSoC and Outreachy
* Development discussions
** Releases
** Dependencies
** Bug fixing
** GTK4
** Refactoring
**advancing C++ standard (depends on change in macOS pipeline)
***getting rid of boost
***using newer stuff from std
** etc.
* Hacking
** Code reviews
** Critical bugs for 1.3

Inkscape

2023-02-06T18:25:03Z

Joneuhauser: /* Miscellaneous */

This is a freeform area for Inkscape development and discussion. Curious about [[wiki syntax]]?

{| style="width: 100%;"
|- style="vertical-align: top;"
| style="width: 33%; background: #EEE; padding: 1em;" |
== Project Info ==
* [http://www.inkscape.org/ Inkscape Homepage]
* [[About Inkscape]]
* [[Features of Inkscape|Features]]
* [[FAQ]] — Frequently Asked Questions
* [[Supported operating systems]]
* [[Tools]] — Supporting Tools and Applications
* [[Galleries]]
* [[Inkscape coverage|Coverage]] — Awards, articles, presentations, books about Inkscape
* [[Inkscape popularity|Popularity]]
* [[Inkscape invariants|Inkscape's Mission]]
* [https://inkscape.org/en/community/ Communication] — How to reach us
* [[Announcement to Sodipodi]] — This started it all
* [[Branding]]
* [[Travel Reimbursement Policy]]
* [[Funded Project System Development]]
* [[:Category:Hackfest|Hackfests]]
** upcoming/proposed events: [[Hackfest2023_Bensberg|2023 Bensberg]]
** past events:
::: [[Hackfest2019 SCALE|2019 Pasadena (SCALE)]], [[Hackfest2019 Saarbrücken|2019 Saarbrücken (LGM)]]
::: [[Hackfest2018|2018 Boston]], [[Hackfest2018 LGM|2018 Seville (LGM)]], [[Hackfest2018 Kiel|2018 Kiel]]
::: [[Hackfest2017|2017 Paris]]
::: [[Hackfest2016|2016 Leeds (LGM)]]
::: [[Hackfest2015|2015 Toronto (LGM)]]

| style="width: 33%; padding: 1em;" |

== User Documentation ==
* [[Installing Inkscape|Installation]]
* [[International and Local Communities]]
* [[Inkscape glossary]]
* [[User manual information]] — Where to find the free Inkscape manual and how to contribute to it
* [http://inkscape.org/en/learn/tutorials/ Tutorials]
* [[Inkscape SVG vs. plain SVG]]
* [[Output format requirements]] — What's needed to save in some formats
* [[Extension requirements]] — What's needed to use some extensions (slightly outdated)
* [[Extension reference]] — What each extension does (slightly outdated)
* [[Connector tool tutorial]]
* [[Installing fonts]]
* [[Emergency save]] — Recovery in case Inkscape crashed
* [[Release notes]]
** ''[[Release notes/1.3|Inkscape 1.3]]'' — ''development branch''
** '''[[Release notes/1.2|Inkscape 1.2]]''' ([[Release notes/1.2.1|1.2.1]], [[Release_notes/1.2.2|1.2.2]]) — ''current stable release branch''
** [[Release notes/1.1|Inkscape 1.1]] ([[Release notes/1.1.1|1.1.1]], [[Release notes/1.1.2|1.1.2]])
* [[Announcing Releases]] (slightly outdated)
* [[Release Process Debrief]] (slightly outdated)
* [[Tricks and tips]] — Miscellaneous advice, may be slightly outdated

| style="width: 33%; background: #EEE; padding: 1em;" |

== Help Inkscape Without Coding ==
* [[Help wanted]]
* [[Bug management]]
** [[Projects#Bug_Triage]]
* [[Testing]]
** [[macOS alpha]]
* [[Translation information]]
* [[WebSite]]
* [[Inkscape Classes]]
* [[Conferences]]
* [[Fundraising Ideas]]
* [[Creating Inkscape distributions]] — How to build packages
* [[Stable branch updates]]
* [[Updating tracker items]]
* [[Tutorials and help]]
* [[How to start a page]] — How to use the wiki
* [[Creating screencasts]]
* [[About-Screen contest]]
* [[social media|Participate in social media]]
|}

<div style="margin-top: 1em; padding: .5em 1em 1em; border: 1px solid #62C012;">

== Developer Documentation ==
{| style="width: 100%;"
|- style="vertical-align: top;"
| style="width: 50%; padding-right: 1em;" |
=== First Steps ===
* [[Working with Git]] — How to obtain the source code. A quick start on how to use our version control system.
* [[Compiling Inkscape]]
* [[Developer manual]] — Various important information, be sure to read this before coding
* [[Debugging Inkscape|Debugging]] — Random tips to help debug problems
* [[Janitorial tasks]] — Small tasks that need doing
* [[Doxygen documentation]]
* [[Working with CMake]] — Getting started with CMake coding for configuring and building Inkscape

=== Developer tutorials ===
* [[Architectural overview]] — A high-level look at Inkscape
* [[Preferences subsystem]] — Creating and using preference values

* Extensions
** [[Extension subsystem]] — An overview of the functionality provided by extensions and the possible implementations
** [[Script extensions]] — Extend Inkscape easily using scripting languages (Python, Perl, …)
** [[Python modules for extensions]] — Some helpful routines for use in Python script extensions
** [[INX extension descriptor format]]
* [[Creating Live Path Effects]]
* [[Using libsigc++ signals]]
*[[Windows development on Linux]]

=== User Interface Discussion===
*[[Interface translation]]
* [[Adding interface verbs]]
*[[Accessible graphics]]
* [[Object Manager]]
*[[Dialogs reorganization]]
*[[Modal interfaces]]
*[[Text usability]] — Text tool and dialog
*[[KeyboardShortcutsToDo]]
**[[Keyboard profiles]] — How you can help
*[[Statusbar API]]
* [[Animation-(Timeline)]]
*[[Free Desktop Graphic Suite]]
*[[Skeletal Strokes]] — Brushes, Strokes, Pressure Sensibility...

| style="width: 50%;" |

===Development Discussion ===
*[[Roadmap]] — The main todo list
*[[Tracking Dependencies|Dependencies]] — What libs are needed to build Inkscape
*[[C++11]] — Which C++11 features can be used
*[[New feature proposals]]
* [[Extension architecture proposals]]
*[[Coding Style|Coding Style Discussion]]
*[[File types]]
*[[Application icons]] — Application + Interface
*[[Icons]]
*[[Color management]]
*[[Printing subsystem]]
*[[SVG Tiny Compliance]]
* [[SVG Test Suite Compliance]] — [[W3C]] full test suite
*[[CSS Support]]
*[[Google Summer of Code]]
* [[Improved Media Management]]
*[[UI Mockup Screenshots]]
* [[Swatch Book]]
*[[Tablet Dialog]]
*[[ViewBoxToDo]] — View box support info
* [[Caching]]
*[[Canvas Rendering Profiling]]
*[[UI and Document coordinates‎]]
* [[GtkMMification]] — Replace C boilerplate with gtkmm objects
*[[CMake Tasks]] — Converting the Inkscape build system to CMake
*[[Bug Reporting Workflow]] — Options for improving Inkscape bug workflow from user to developer
*[[1.0 Release Bug Fix List]] — List of bugs that need to be fixed for 1.0
*[[1.0 Release Planning]] — Roadmap and planning for 1.0 Release

===Miscellaneous===
*[[Inkscape-specific XML attributes]] — Documentation of attributes from Inkscape's XML namespace
*[[Environment variables]] — Overview of important environment variables that modify the behavior of Inkscape and its dependencies.
*[[Extension repository]] — An Internet central for Inkscape extensions
*[[Related programs]]
*[[Sponsors list]]
*[[Contracting Process]]
*[[Wiki Playground]]

===[[Lib2geom]]===
*[[Lib2geom]]
*[[Working with 2Geom FAQ]] — Real-life questions answered about using 2Geom in real code
*[[Lib2geom py2geom]] — Python bindings to 2geom. With this you can use the power of 2geom in Python scripts.

===Historical pages===
These pages are outdated, but linked here for posterity.

*[[Working with Bazaar]] — Our former control version system, no longer used. See [[Working with Git]] for current instructions.
* [[Creating a new SPObject]]

|}
</div>

==See also==
*
[[:Category:Wiki Attic|Wiki Attic]] — Pages that are no longer relevant but kept for historical value

__NOTOC__

[[Category:Top level categories]]

Contracting Process

2023-02-05T20:21:17Z

Joneuhauser:

This page represents the current state of our knowledge on how to propose paid development / contract work for '''outside''' contractors as well as find and hire such contractors. It's mostly based on the experience from the 2022/2023 Import Extension project. The only *required* process is to get a PLC vote and work with the SFC but this represents lessons learned on the best way to achieve a successful contracting experience.

For a tender tailored to one or more previously known persons (e.g. internal contractors, highly specialized outside knowledge...) the selection process can be ommitted which speeds up the process considerably, and reduces the amount of work spent on the administrative side by '''a lot'''. However, '''a lot of additional justification''' is needed why the selection process can be ommitted ("we want to hire an internal contributor to fix a lot of bugs in their knowledge domain, fast", "we want to hire a maintainer of an upstream project because we lack the internal resources to tackle a problem" etc.). The SFC is a US non-profit organization that has rather strict rules to ensure that the money isn't used for self-enrichment, which requires open and visible processes on how money is spent. Often that makes having a selection process, though cumbersome, easier to justify a choice.

== General steps ==
{| class="wikitable"
|+
!What?
!Who?
!How long?
|-
|'''Start with an idea''' for a contractor project. The idea should be clearly-limited, in the public interest (i.e. a general consensus that something needs to be done) and it should be obvious that the project lacks volunteer resources to do it internally.
|Initiator
| rowspan="4" |2 weeks
|-
|'''Discuss''' the idea with other people in the project. Places that are great to bring up ideas are: Developer Meeting, Vectors meeting, mailing lists, forums and RocketChat. Seek a consensus that executing the project as contracting work is in the interest of the project, discuss an approximate budget and '''find a project representative.''' The project rep. will play an important role during the candidate selection process as well, and will be the project contact the contractor will report to. A stipend is possible for the project representative. Also try to find people that want to help with the candidate selection process ("hiring team") - the future rep needs to be a member of that hiring team, and the initiator should be as well.
|Initiator
|-
|'''Write a draft proposal''' (template see below). A lot of that proposal can be reused later for the job posting, as well as website or blog articles. Distribute it and incorporate feedback, especially from people familiar with the work that needs to be done, and as if folks '''from at the SFC''' can look at it to ensure it matches all of their requirements.
|Inititator, dev chat, SFC
|-
|Have a present PLC member to trigger a PLC vote (works fastest if you provide them with the ballot).
|
|-
|'''PLC vote'''. If the vote is not in favor of the project, go back to step 3/4 and incorporate the PLC's concerns.
|PLC
|1 week
|-
|Together with the hiring team, transform the proposal into a '''job posting and post it''' on relevant sites (can also be done by the SFC). Coordinate with Vectors whether social posts about it are appropriate; at the very least, create a blog post on the website.
The hiring team needs to decide on the candidate's profile, documents to be submitted and a time schedule for the selection process (should be a part of the job posting).
|Inititator, Vectors,
Hiring team,

SFC

Project Rep
|2 weeks
|-
|Wait for people to apply. This is a good time for the mentor to prepare everything on the technical side, i.e. boilerplate code, gather documentation, logins, etc...
|
|1 month
|-
|'''Selection process'''. A possible process is given below, but can be adapted to the projects' needs.
|SFC, hiring team
|1 month
|-
|'''Hire contractor''' - contract negotiation, payment details and modalities etc.
|SFC
|2 weeks
|}
All in all, it takes about ~3-4 months from an initial idea until work on the project can start.

== Proposal and job offer items ==
A = Proposal for PLC vote, B = job posting, C = website blog post

For reference 2023 Import Extension project:

* Proposal: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.pdf
* Ballot: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.html
* Job posting: https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/
* Website post: https://inkscape.org/news/2022/12/12/hiring-python-developer-import-extension/

{| class="wikitable"
|+
!Title
!Contents
!Documents
|-
|Overview
|Who are we looking for?
What timeframe?

Which kind of work?
|A, B, C
|-
|Detailed description of project
|Scope of the work
more details what will be done, and what the project will build upon

(can be ~ half a page)
|A, B
|-
|Milestones
|Detailed description of the work (think in packages of a week, comparable to GSoC) - no absolute dates yet
Technical information as required

If an extension of the project is up for discussion - when will this be discussed and who decides?
|A
|-
|Duration and schedule
|How much time (full time equivalent)?
Part-time (or less) possible?

Expected start time?
|B
|-
|Financials
|Allocated budget for contractor compensation, including possible extensions
Mentoring stipend? (roughly GSoC equivalent)

Stipend for hiring team?
|A
|-
|Compensation of contractor
|Hourly rate (discuss with SFC), payment terms (net-30)
Formal requirements (i.e. no applicants from US-embargoed countries)
|B
|-
|Hiring team
|Duties: candidate selection, deciding on the decision process (i.e. interviews, coding test)
Specify members in the proposal. Stand-in members?

One SFC member mandatory (might waive once we get more experienced with this)
|A
|-
|Candidate's profile
|Previous experience in: a certain programming language, contribution to FOSS, in a certain domain of knowledge
|B, C
|-
|Required documents
|CV
Link to personal portfolio (Github, GitLab, personal website, self-hosted git...)

Some questions about the candidate's motivation, relevant experience, time zone they're in (to schedule interviews)
|B
|-
|Application and submission
|Submission email (ie. jobs@)
Deadline for submissions
|B, C
|-
|Schedule of the evaluation
process
|Programming exercise? (when?)
Interviews? (when?)

Work will start when?
|B
|}

== Sites to post job posting to ==

* [https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/ https://www.fossjobs.net] (generated a lot of traffic and most our applications come from there)
* https://shecodeafrica.org/jobs/
* https://www.blacksintechnology.net/jobs-board/
* https://www.pocitjobs.com/
* https://careers.aises.org/
* https://www.diversifytech.co/post-a-job/
* https://techfugees.com/jobs/
* https://www.womenwhocode.com/jobs
* Outreachy alumni list

== Selection process ==
Highly depends on the actual project, here's what worked for the 2023 Import project:

* Screen applications and remove obviously unsuitable candidates (e.g. based on experience, past contributions)
* Formulate coding test and send it to the remaining candidates. Give them ~2 weeks time to complete it. The test should not take them more than 2 hours for a simple solution. Expect that quite a few of the solution will be "above and beyond". It's proven beneficial to have them fork a private git repository and invite a hiring team member (e.g. the mentor) when they're done. This also shows that they can work with Gitlab and lets us have a look at their commit hygiene.
* Reduce the list of applicants to ~3-4 based on CV and the solution. Different evaluation criteria for each hiring team members are ok and actually good: for example, the mentor might look more at "do I anticipate that I can work well with this person". It's the discussion and diversity in backgrounds that makes for a good discussion. Send the removed applicants a rejection email, it's nice to include a reason why they were not selected so they can improve their next application.
* Agree upon a list of interview timeslots and create a sign up form where they can sign up (signupgenius works for that, maybe we can incorporate it in the inkscape.org website if we need it more regularly? - NextCloud has a scheduling app which could be used)
* Perform interviews, where the candidates are also encouraged to ask questions.
* Vote on who is selected. The mentor may act as tiebreaker.
* Offer the position to the selected candidate, after they accept, send a rejection to the others. Again, it's nice to include a reason why they were not selected so they can improve their next application.
* Contract details are handled by the SFC.

Contracting Process

2023-02-01T21:52:16Z

Joneuhauser: /* Proposal and job offer items */

This page represents the current state of our knowledge on how to propose paid development / contract work for '''outside''' contractors as well as find and hire such contractors. It's mostly based on the experience from the 2022/2023 Import Extension project.

For a tender tailored to one or more previously known persons (e.g. internal contractors, highly specialized outside knowledge...) the selection process can be ommitted which speeds up the process considerably, and reduces the amount of work spent on the administrative side by '''a lot'''. However, '''a lot of additional justification''' is needed why the selection process can be ommitted ("we want to hire an internal contributor to fix a lot of bugs in their knowledge domain, fast", "we want to hire a maintainer of an upstream project because we lack the internal resources to tackle a problem" etc.).

== General steps ==
{| class="wikitable"
|+
!What?
!Who?
!How long?
|-
|'''Start with an idea''' for a conctrator project. The idea should be clearly-limited, in the public interest (i.e. a general consensus that something needs to be done) and it should be obvious that the project lacks volunteer resources to do it internally.
|Initiator
| rowspan="4" |2 weeks
|-
|'''Discuss''' the idea at the '''Developer Meeting''', and seek a consensus that executing the project as contracting work is in the interest of the project, discuss an approximate budget and '''find a mentor.''' The mentor will play an important role during the candidate selection process as well, and will be the technical contact the contractor will report to. A mentoring stipend is possible. Also try to find people that want to help with the candidate selection process ("hiring team") - the future mentor needs to be a member of that hiring team, and the initiator should be as well.
|Initiator, dev meeting
|-
|'''Write a draft proposal''' (template see below). A lot of that proposal can be reused lated for the job posting, as well as website or blog articles. Distribute it in the developer chat and incorporate feedback, especially from people familar with the work that needs to be done, and '''from our contact at the SFC.'''
|Inititator, dev chat, SFC
|-
|Have the '''developer meeting finalize and approve the proposal''' (unanimous works best). Ask a present PLC member to trigger a PLC vote (works fastest if you provide them with the ballot).
|Dev meeting
|-
|'''PLC vote'''. If the vote is not in favor of the project, go back to step 3/4 and incorporate the PLC's concerns.
|PLC
|1 week
|-
|Together with the hiring team, transform the proposal into a '''job posting an post it''' on relevant sites (can also be done by the SFC). Coordinate with Vectors whether social posts about it are appropriate; at the very least, create a blog post on the website.
The hiring team needs to decide on the candidate's profile, documents to be submitted and a time schedule for the selection process (should be a part of the job posting).
|Inititator, Vectors,
Hiring team,

SFC

Mentor
|2 weeks
|-
|Wait for people to apply. This is a good time for the mentor to prepare everything in the technical side, i.e. boilerplate code, gather documentation...
|
|1 month
|-
|'''Selection process'''. A possible process is given below, but can be adapted to the projects' needs.
|SFC, hiring team
|1 month
|-
|'''Hire contractor''' - contract negotiation, payment details and modalities etc.
|SFC
|2 weeks
|}
All in all, it takes about ~3-4 months from an initial idea until work on the project can start.

== Proposal and job offer items ==
A = Proposal for PLC vote, B = job posting, C = website blog post

For reference 2023 Import Extension project:

* Proposal: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.pdf
* Ballot: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.html
* Job posting: https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/
* Website post: https://inkscape.org/news/2022/12/12/hiring-python-developer-import-extension/

{| class="wikitable"
|+
!Title
!Contents
!Documents
|-
|Overview
|Who are we looking for?
What timeframe?

Which kind of work?
|A, B, C
|-
|Detailed description of project
|Scope of the work
more details what will be done, and what the project will build upon

(can be ~ half a page)
|A, B
|-
|Milestones
|Detailed description of the work (think in packages of a week, comparable to GSoC) - no absolute dates yet
Technical information as required

If an extension of the project is up for discussion - when will this be discussed and who decides?
|A
|-
|Duration and schedule
|How much time (full time equivalent)?
Part-time (or less) possible?

Expected start time?
|B
|-
|Financials
|Allocated budget for contractor compensation, including possible extensions
Mentoring stipend? (roughly GSoC equivalent)

Stipend for hiring team?
|A
|-
|Compensation of contractor
|Hourly rate (discuss with SFC), payment terms (net-30)
Formal requirements (i.e. no applicants from US-embargoed countries)
|B
|-
|Hiring team
|Duties: candidate selection, deciding on the decision process (i.e. interviews, coding test)
Specify members in the proposal. Stand-in members?

One SFC member mandatory (might waive once we get more experienced with this)
|A
|-
|Candidate's profile
|Previous experience in: a certain programming language, contribution to FOSS, in a certain domain of knowledge
|B, C
|-
|Required documents
|CV
Link to personal portfolio (Github, GitLab, personal website, self-hosted git...)

Some questions about the candidate's motivation, relevant experience, time zone they're in (to schedule interviews)
|B
|-
|Application and submission
|Submission email (ie. jobs@)
Deadline for submissions
|B, C
|-
|Schedule of the evaluation
process
|Programming exercise? (when?)
Interviews? (when?)

Work will start when?
|B
|}

== Sites to post job posting to ==

* [https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/ https://www.fossjobs.net] (generated a lot of traffic and most our applications come from there)
* https://shecodeafrica.org/jobs/
* https://www.blacksintechnology.net/jobs-board/
* https://www.pocitjobs.com/
* https://careers.aises.org/
* https://www.diversifytech.co/post-a-job/
* https://techfugees.com/jobs/
* https://www.womenwhocode.com/jobs
* Outreachy alumni list

== Selection process ==
Highly depends on the actual project, here's what worked for the 2023 Import project:

* Screen applications and remove obviously unsuitable candidates (e.g. based on experience, past contributions)
* Formulate coding test and send it to the remaining candidates. Give them ~2 weeks time to complete it. The test should not take them more than 2 hours for a simple solution. Expect that quite a few of the solution will be "above and beyond". It's proven beneficial to have them fork a private git repository and invite a hiring team member (e.g. the mentor) when they're done. This also shows that they can work with Gitlab and lets us have a look at their commit hygiene.
* Reduce the list of applicants to ~3-4 based on CV and the solution. Different evaluation criteria for each hiring team members are ok and actually good: for example, the mentor might look more at "do I anticipate that I can work well with this person". It's the discussion and diversity in backgrounds that makes for a good discussion. Send the removed applicants a rejection email, it's nice to include a reason why they were not selected so they can improve their next application.
* Agree upon a list of interview timeslots and create a sign up form where they can sign up (signupgenius works for that, maybe we can incorporate it in the inkscape.org website if we need it more regularly?)
* Perform interviews, where the candidates are also encouraged to ask questions.
* Vote on who is selected. The mentor may act as tiebreaker.
* Offer the position to the selected candidate, after they accept, send a rejection to the others.
* Contract details are handled by the SFC.

Contracting Process

2023-02-01T21:49:48Z

Joneuhauser: Created page with "This page represents the current state of our knowledge on how to propose paid development / contract work for '''outside''' contractors as well as find and hire such contract..."

This page represents the current state of our knowledge on how to propose paid development / contract work for '''outside''' contractors as well as find and hire such contractors. It's mostly based on the experience from the 2022/2023 Import Extension project.

For a tender tailored to one or more previously known persons (e.g. internal contractors, highly specialized outside knowledge...) the selection process can be ommitted which speeds up the process considerably, and reduces the amount of work spent on the administrative side by '''a lot'''. However, '''a lot of additional justification''' is needed why the selection process can be ommitted ("we want to hire an internal contributor to fix a lot of bugs in their knowledge domain, fast", "we want to hire a maintainer of an upstream project because we lack the internal resources to tackle a problem" etc.).

== General steps ==
{| class="wikitable"
|+
!What?
!Who?
!How long?
|-
|'''Start with an idea''' for a conctrator project. The idea should be clearly-limited, in the public interest (i.e. a general consensus that something needs to be done) and it should be obvious that the project lacks volunteer resources to do it internally.
|Initiator
| rowspan="4" |2 weeks
|-
|'''Discuss''' the idea at the '''Developer Meeting''', and seek a consensus that executing the project as contracting work is in the interest of the project, discuss an approximate budget and '''find a mentor.''' The mentor will play an important role during the candidate selection process as well, and will be the technical contact the contractor will report to. A mentoring stipend is possible. Also try to find people that want to help with the candidate selection process ("hiring team") - the future mentor needs to be a member of that hiring team, and the initiator should be as well.
|Initiator, dev meeting
|-
|'''Write a draft proposal''' (template see below). A lot of that proposal can be reused lated for the job posting, as well as website or blog articles. Distribute it in the developer chat and incorporate feedback, especially from people familar with the work that needs to be done, and '''from our contact at the SFC.'''
|Inititator, dev chat, SFC
|-
|Have the '''developer meeting finalize and approve the proposal''' (unanimous works best). Ask a present PLC member to trigger a PLC vote (works fastest if you provide them with the ballot).
|Dev meeting
|-
|'''PLC vote'''. If the vote is not in favor of the project, go back to step 3/4 and incorporate the PLC's concerns.
|PLC
|1 week
|-
|Together with the hiring team, transform the proposal into a '''job posting an post it''' on relevant sites (can also be done by the SFC). Coordinate with Vectors whether social posts about it are appropriate; at the very least, create a blog post on the website.
The hiring team needs to decide on the candidate's profile, documents to be submitted and a time schedule for the selection process (should be a part of the job posting).
|Inititator, Vectors,
Hiring team,

SFC

Mentor
|2 weeks
|-
|Wait for people to apply. This is a good time for the mentor to prepare everything in the technical side, i.e. boilerplate code, gather documentation...
|
|1 month
|-
|'''Selection process'''. A possible process is given below, but can be adapted to the projects' needs.
|SFC, hiring team
|1 month
|-
|'''Hire contractor''' - contract negotiation, payment details and modalities etc.
|SFC
|2 weeks
|}
All in all, it takes about ~3-4 months from an initial idea until work on the project can start.

== Proposal and job offer items ==
A = Proposal for PLC vote, B = job posting, C = website blog post

For reference 2023 AI Import project:

* Proposal: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.pdf
* Ballot: https://alpha.inkscape.org/board/referendums/resolutions/2022_AI_Import.html
* Job posting: https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/
* Website post: https://inkscape.org/news/2022/12/12/hiring-python-developer-import-extension/

{| class="wikitable"
|+
!Title
!Contents
!Documents
|-
|Overview
|Who are we looking for?
What timeframe?

Which kind of work?
|A, B, C
|-
|Detailed description of project
|Scope of the work
more details what will be done, and what the project will build upon

(can be ~ half a page)
|A, B
|-
|Milestones
|Detailed description of the work (think in packages of a week, comparable to GSoC) - no absolute dates yet
Technical information as required

If an extension of the project is up for discussion - when will this be discussed and who decides?
|A
|-
|Duration and schedule
|How much time (full time equivalent)?
Part-time (or less) possible?

Expected start time?
|B
|-
|Financials
|Allocated budget for contractor compensation, including possible extensions
Mentoring stipend? (roughly GSoC equivalent)

Stipend for hiring team?
|A
|-
|Compensation of contractor
|Hourly rate (discuss with SFC), payment terms (net-30)
Formal requirements (i.e. no applicants from US-embargoed countries)
|B
|-
|Hiring team
|Duties: candidate selection, deciding on the decision process (i.e. interviews, coding test)
Specify members in the proposal. Stand-in members?

One SFC member mandatory (might waive once we get more experienced with this)
|A
|-
|Candidate's profile
|Previous experience in: a certain programming language, contribution to FOSS, in a certain domain of knowledge
|B, C
|-
|Required documents
|CV
Link to personal portfolio (Github, GitLab, personal website, self-hosted git...)

Some questions about the candidate's motivation, relevant experience, time zone they're in (to schedule interviews)
|B
|-
|Application and submission
|Submission email (ie. jobs@)
Deadline for submissions
|B, C
|-
|Schedule of the evaluation
process
|Programming exercise? (when?)
Interviews? (when?)

Work will start when?
|B
|}

== Sites to post job posting to ==

* [https://www.fossjobs.net/job/11127/inkscape-short-term-contract-for-python-programming-at-inkscape-project-software-freedom-conservancy/ https://www.fossjobs.net] (generated a lot of traffic and most our applications come from there)
* https://shecodeafrica.org/jobs/
* https://www.blacksintechnology.net/jobs-board/
* https://www.pocitjobs.com/
* https://careers.aises.org/
* https://www.diversifytech.co/post-a-job/
* https://techfugees.com/jobs/
* https://www.womenwhocode.com/jobs
* Outreachy alumni list

== Selection process ==
Highly depends on the actual project, here's what worked for the 2023 Import project:

* Screen applications and remove obviously unsuitable candidates (e.g. based on experience, past contributions)
* Formulate coding test and send it to the remaining candidates. Give them ~2 weeks time to complete it. The test should not take them more than 2 hours for a simple solution. Expect that quite a few of the solution will be "above and beyond". It's proven beneficial to have them fork a private git repository and invite a hiring team member (e.g. the mentor) when they're done. This also shows that they can work with Gitlab and lets us have a look at their commit hygiene.
* Reduce the list of applicants to ~3-4 based on CV and the solution. Different evaluation criteria for each hiring team members are ok and actually good: for example, the mentor might look more at "do I anticipate that I can work well with this person". It's the discussion and diversity in backgrounds that makes for a good discussion. Send the removed applicants a rejection email, it's nice to include a reason why they were not selected so they can improve their next application.
* Agree upon a list of interview timeslots and create a sign up form where they can sign up (signupgenius works for that, maybe we can incorporate it in the inkscape.org website if we need it more regularly?)
* Perform interviews, where the candidates are also encouraged to ask questions.
* Vote on who is selected. The mentor may act as tiebreaker.
* Offer the position to the selected candidate, after they accept, send a rejection to the others.
* Contract details are handled by the SFC.

Hackfest2023 Bensberg

2023-01-15T21:48:12Z

Joneuhauser:

[[Category:Hackfest]]

This page '''<big>IS WORK IN PROGRESS</big>''' and details the planning of Inkscape's 2023 hackfest in Bensberg, Germany. The hackfest will take place on '''March 13-17, 2023'''. We are looking to bring together a group of '''10 attendees''', but do not let that number discourage you from throwing your hat in the ring in case we reach/go over it.

This hackfest is a standalone event and not organized around any other event or FOSS conference.

Previous events: [[Hackfest2019 Saarbrücken]], [[Hackfest2019 SCALE]], [[Hackfest2018 Kiel]], [[Hackfest2018 LGM]], [[Hackfest2018]], [[Hackfest2017]], [[Hackfest2016]], [[Hackfest2015]].
=Description=
It's a hackfest! We will work on Inkscape bugs, new features, packaging, website issues, ... in fact anything that can benefit from us being physically in the same space. And let's not forget about the social component - we get to hang and talk and laugh in person since we usually only meet virtually :).
==Bensberg==
Bensberg is part of Bergisch Gladbach, a city in the western part of Germany, about 15 km east of Cologne. It is beautifully located in the countryside, surrounded by lush forests slightly elevated to give a great view depending on weather conditions. The nearest airport is Cologne Bonn (CGN) which is an international airport.
*[https://en.wikipedia.org/wiki/Bergisch_Gladbach Bergisch Gladbach on Wikipedia]
[[File:Bensberg.png|none|thumb|Bensberg (range indicated to Cologne's Cathedral). Screenshot from Google Maps.]]

==Venue==
Our host is the [https://www.akademie-generali.de/en/home Generali Akademie], the dedicated education and conference center of the Generali Group in Germany (it's an insurance company). The location's special appeal is its all-inclusive package: conference rooms, hotel rooms and full catering service are conveniently provided on-site.

''(full disclosure: as an employee, RdH has been there multiple times)''
{| class="wikitable"
|+
!official address
!for navigation systems
|-
|Generali Akademie
Am Schloss 1-3

51429 Bergisch-Gladbach

Germany
|Generali Akademie
Jan-Wellem-Straße

51429 Bergisch-Gladbach

Germany
|}

===Catering===
We have full catering on-site, i.e. breakfast, lunch and dinner including non-alcoholic drinks. Our meeting room also comes with coffee and beverages throughout the day.
===Facilities===
*Wireless networking (fast broadband), powered by [https://www.m3connect.de/ m3connect]
* <u>No wired network available</u>
*Europlug type F
** we should bring some power strips
*(TODO - not sure if we have that) LCD projector
*flip chart
*(TODO add additional info e.g. pool)
=== Vicinity===
tbd (we're not in a city, we're in the country)

===Travel information===
tbd

===Cost calculation===
The fee per attendee is 837 € and is due on the last day of the event, payable via debit or credit card (VISA, Mastercard). A billing address needs to be provided in advance.<syntaxhighlight lang="text">
hotel room incl. breakfast 127 € x 4 days = 508 €
catering service (days 1-4) 70 € x 4 days = 280 €
catering service (day 5) 49 € x 1 day = 49 €
-------------------------------------------- 837 €
</syntaxhighlight>One attendee (RdH) needs to pay the additional fee for the meeting room.<syntaxhighlight lang="text">
meeting room (days 1-5) 180 € x 5 days = 900 €
</syntaxhighlight>

==Hotels==
Hotel rooms are provided on-site and are part of our conference package, no dedicated booking necessary.

=Attendance =

*Hackfest Bensberg 2023 takes place on '''March 13-17, 2023'''
*deadline to apply for attendance is '''February 01, 2023'''

== preface==
In an initial poll, 8 people expressed their interest/availability for this hackfest. Based on this number we are planning for 10 attendees. Should more people be interested, we'll try our best to expand - the earlier we know, the better! If we don't reach 10, we will try to scale down our booking. If you are interested, don't hold yourself back!

==I want to attend!==
That's great! Be aware of the following:

*You are making a commitment here which will produce expenses for the project. Please make sure that you will be able to honor this commitment! ''(Are you table to take the week off from your day job? Are you able to travel? etc.)''
* Every attendee will have to pay their fee of 837 € on the last day of the hackfest. For our non-German attendees it is paramount that you own either a VISA or Mastercard as those are the only accepted methods of payment. If you don't own one of these we will have to organize for someone else to pay for you. ''(That's why this question is being asked in the table below.)''
*You are eligible to apply no matter if you participated in the initial poll/"call for interest". ''(Only in case we end up being seriously overbooked and cannot accommodate for everybody we will take the initial poll into account.)''

Now go ahead and add yourself to this table (or ask in [https://gitlab.com/inkscape/inbox/-/issues/8109 this issue] and it will be done for you):
{| class="wikitable"
|+
!Name
!GitLab handle
!I own a VISA or
Mastercard
|-
|John Doe
|@johndoe
|yes
|-
|Martin Owens
|@doctormo
|yes
|-
|Jonathan Neuhauser
|@joneuhauser
|yes
|-
|4
|
|
|-
|5
|
|
|-
|6
|
|
|-
|7
|
|
|-
|8
|
|
|-
|9
|
|
|-
|10
|
|
|}

Extensions: INX widgets and parameters

2022-03-10T20:14:39Z

Joneuhauser:

The documentation for INX widgets and parameters has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/inx-widgets.html documentation of the extensions repository].

{| class="wikitable" style="vertical-align:top;" valign="top"
|- style="border:none;background:none"

|}

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

INX extension descriptor format

2022-03-10T20:12:53Z

Joneuhauser: Move documentation

This page previously contained information on the *.inx file format. The information is now found at [https://inkscape.gitlab.io/extensions/documentation/authors/inx-overview.html the extensions documentation].
[[Category:Developer Documentation]]
[[Category:Help Wanted]]
[[Category:Extensions]]

Release notes/1.2

2022-03-09T18:44:27Z

Joneuhauser: /* Documentation */

{{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]].
*After you add more then one page you can switch active page with page navigator on right side of status bar

=== 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 objects on canvas and in Layers dialog. ( 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''').

Dithering on canvas rendering can be turned off (for performance reasons) Preferences > Rendering > use dithering

Dithering does not fork on mesh gradients

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

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

== 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]].
*Default color of page is white and page background is light gray to help better visuals what is page and what is outside of page
* 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.
* Guides have new default 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 AI (pdf-based)''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]
*You can navigate pages with page navigator on that will show up in right down corner of status bar

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

[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>share/inkscape/ui/highlight-colors.css</code> in your Inkscape directory
* layer and object colors can be customized for each layer/object on its own, by clicking on the vertical color bar at the end of each line
* tiny mask and scissor symbols indicate that a clip or mask is applied to an object
* object and layer names (label, not id) can be changed after a double-click on the current name
* icons for locking and hiding a layer/object light up when you hover over the layer's row:
** 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 ===
[[File:Require restart.png|frame]]
* The preferences zoom ruler now respects your theme's look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it selects objects only in the current layer or in all layers was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])
*Preferences that require restarting inkscape to take a effect have a small icon next to it

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

==== anothere small fixes and improvements: ====
*# Edit operation to work for fonts without label (created by FontForge)
*# Add button to set up "typography" canvas taking font dimensions into account

[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] [https://gitlab.com/inkscape/inkscape/-/merge_requests/3916 3916])

=== 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/03/04.

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 [https://inkscape.gitlab.io/extensions/documentation/authors/update1.2.html#new-style-api New Style API].
*A GUI API (based on [https://pypi.org/project/gtkme/ gtkme]) has been added, so extensions can now ship GTK-based user interfaces ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421], [https://gitlab.com/inkscape/extensions/-/merge_requests/450 MR extensions#450]).
*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 '''Clipart Importer''' extension allows to search and download SVG resources from the Internet ([https://gitlab.com/inkscape/extensions/-/merge_requests/441 MR extensions#441]).
*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]).
*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 '''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.]]
* The '''Frame''' extension has been rewritten and now supports additional options, such as elliptical frames, offset frame and putting the fill below the object ([https://gitlab.com/inkscape/extensions/-/merge_requests/430 MR extensions#430], [https://gitlab.com/inkscape/extensions/-/issues/214 Issue extensions#214]).
*The '''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.
*Extensions that query properties of paths with multiple subpaths now get more correct results if that path uses relative path commands ([https://gitlab.com/inkscape/extensions/-/merge_requests/438 MR extensions#438], [https://gitlab.com/inkscape/extensions/-/issues/450 Issue extensions#450]).
* When extensions set an element to "insensitive", this change is honored by Inkscape ([https://gitlab.com/inkscape/extensions/-/commit/d5282bd2341d24bc53cec02aed81e2f3ee6c6050 commit extensions#d5282bd2])
* The defaults of parameters are now identical in inx files and in the command line interface of the extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/325 MR extensions#325])
* Gradients whose stop positions are given in percentages are now handled ([https://gitlab.com/inkscape/extensions/-/merge_requests/374 MR extensions#374])
* Hide the console window on Windows when calling external utilities ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407], [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])
*The <code>BaseElement.duplicate()</code> function now makes sure that the duplicated element and its children have unique IDs ([https://gitlab.com/inkscape/extensions/-/merge_requests/426 MR extensions#426], [https://gitlab.com/inkscape/extensions/-/issues/379 Issue extensions#379]).
*The "Reverse Path" method now returns correct results for paths with multiple subpaths ([https://gitlab.com/inkscape/extensions/-/merge_requests/427 MR extension#427], [https://gitlab.com/inkscape/extensions/-/issues/445 Issue extensions#445]).
*Several small fixes that makes working with paths and clones more predictable and robust ([https://gitlab.com/inkscape/extensions/-/merge_requests/433 MR extensions#433])

==== 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]), extruded elements and multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/432 MR extension#432], [https://gitlab.com/inkscape/extensions/-/issues/286 Issue extensions#286]). An incorrect unit in the documentation has been exchanged ([https://gitlab.com/inkscape/extensions/-/merge_requests/358 MR extensions #358]).
* When using the '''DXF Outline (R12)''' export, elements in nested groups are now exported correctly ([https://gitlab.com/inkscape/extensions/-/merge_requests/347/ MR extensions#347], [https://gitlab.com/inkscape/extensions/-/issues/382 Issue extensions#382]). It also doesn't include (invisible) paths contained in clips and masks anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/440 MR extensions#440], [https://gitlab.com/inkscape/extensions/-/issues/381 Issue extensions#381])
*The '''DXF14 export''' now shows a better error message in case of a very, very deeply nested SVG document ([https://gitlab.com/inkscape/extensions/-/merge_requests/442 MR extensions#442], [https://gitlab.com/inkscape/extensions/-/issues/360 Issue extensions#360]). Also a warning message regarding the Robo-Master spline option has been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/439 MR extensions#439], [https://gitlab.com/inkscape/extensions/-/issues/225 Issue extensions#225]).
*The '''Extensions Manager''' is now shipped with Inkscape and doesn't download itself automatically anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
*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. Additionally, the JPEG export now works with even larger resolutions ([https://gitlab.com/inkscape/inbox/-/issues/6522 Issue inbox#6522], [https://gitlab.com/inkscape/extensions/-/merge_requests/445 MR extensions#445]).
*The '''LaTeX''' extension now also works on Windows if the user name is longer than 8 characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/448 MR extensions#448], [https://gitlab.com/inkscape/extensions/-/issues/287 Issue extensions#287])
*A bug in the rotation sense of the '''Lindenmayer''' extension has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/437 MR extensions#437], [https://bugs.launchpad.net/inkscape/+bug/1094627 LP issue 1094627])
*The '''Motion''' extension now gives better results for paths with multiple closed subpaths ([https://gitlab.com/inkscape/extensions/-/issues/266 Issue extensions#266]) and when the selected element is part of a transformed group. ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
*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]).
*The '''Webslicer''' extension now correctly cleans up its temporary files ([https://gitlab.com/inkscape/extensions/-/merge_requests/436 MR extensions#436])

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

2022-03-04T19:12:46Z

Joneuhauser: /* Extensions */

{{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]].
*After you add more then one page you can switch active page with page navigator on right side of status bar

=== 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 objects on canvas and in Layers dialog. ( 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''').

Dithering on canvas rendering can be turned off (for performance reasons) Preferences > Rendering > use dithering

Dithering does not fork on mesh gradients

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

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

== 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]].
*Default color of page is white and page background is light gray to help better visuals what is page and what is outside of page
* 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.
* Guides have new default 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 AI (pdf-based)''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]
*You can navigate pages with page navigator on that will show up in right down corner of status bar

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

[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>share/inkscape/ui/highlight-colors.css</code> in your Inkscape directory
* layer and object colors can be customized for each layer/object on its own, by clicking on the vertical color bar at the end of each line
* tiny mask and scissor symbols indicate that a clip or mask is applied to an object
* object and layer names (label, not id) can be changed after a double-click on the current name
* icons for locking and hiding a layer/object light up when you hover over the layer's row:
** 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 ===
[[File:Require restart.png|frame]]
* The preferences zoom ruler now respects your theme's look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it selects objects only in the current layer or in all layers was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])
*Preferences that require restarting inkscape to take a effect have a small icon next to it

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

==== anothere small fixes and improvements: ====
*# Edit operation to work for fonts without label (created by FontForge)
*# Add button to set up "typography" canvas taking font dimensions into account

[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] [https://gitlab.com/inkscape/inkscape/-/merge_requests/3916 3916])

=== 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/03/04.

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 [https://inkscape.gitlab.io/extensions/documentation/authors/update1.2.html#new-style-api New Style API].
*A GUI API (based on [https://pypi.org/project/gtkme/ gtkme]) has been added, so extensions can now ship GTK-based user interfaces ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421], [https://gitlab.com/inkscape/extensions/-/merge_requests/450 MR extensions#450]).
*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 '''Clipart Importer''' extension allows to search and download SVG resources from the Internet ([https://gitlab.com/inkscape/extensions/-/merge_requests/441 MR extensions#441]).
*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]).
*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 '''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.]]
* The '''Frame''' extension has been rewritten and now supports additional options, such as elliptical frames, offset frame and putting the fill below the object ([https://gitlab.com/inkscape/extensions/-/merge_requests/430 MR extensions#430], [https://gitlab.com/inkscape/extensions/-/issues/214 Issue extensions#214]).
*The '''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.
*Extensions that query properties of paths with multiple subpaths now get more correct results if that path uses relative path commands ([https://gitlab.com/inkscape/extensions/-/merge_requests/438 MR extensions#438], [https://gitlab.com/inkscape/extensions/-/issues/450 Issue extensions#450]).
* When extensions set an element to "insensitive", this change is honored by Inkscape ([https://gitlab.com/inkscape/extensions/-/commit/d5282bd2341d24bc53cec02aed81e2f3ee6c6050 commit extensions#d5282bd2])
* The defaults of parameters are now identical in inx files and in the command line interface of the extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/325 MR extensions#325])
* Gradients whose stop positions are given in percentages are now handled ([https://gitlab.com/inkscape/extensions/-/merge_requests/374 MR extensions#374])
* Hide the console window on Windows when calling external utilities ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407], [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])
*The <code>BaseElement.duplicate()</code> function now makes sure that the duplicated element and its children have unique IDs ([https://gitlab.com/inkscape/extensions/-/merge_requests/426 MR extensions#426], [https://gitlab.com/inkscape/extensions/-/issues/379 Issue extensions#379]).
*The "Reverse Path" method now returns correct results for paths with multiple subpaths ([https://gitlab.com/inkscape/extensions/-/merge_requests/427 MR extension#427], [https://gitlab.com/inkscape/extensions/-/issues/445 Issue extensions#445]).
*Several small fixes that makes working with paths and clones more predictable and robust ([https://gitlab.com/inkscape/extensions/-/merge_requests/433 MR extensions#433])

==== 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]), extruded elements and multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/432 MR extension#432], [https://gitlab.com/inkscape/extensions/-/issues/286 Issue extensions#286]). An incorrect unit in the documentation has been exchanged ([https://gitlab.com/inkscape/extensions/-/merge_requests/358 MR extensions #358]).
* When using the '''DXF Outline (R12)''' export, elements in nested groups are now exported correctly ([https://gitlab.com/inkscape/extensions/-/merge_requests/347/ MR extensions#347], [https://gitlab.com/inkscape/extensions/-/issues/382 Issue extensions#382]). It also doesn't include (invisible) paths contained in clips and masks anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/440 MR extensions#440], [https://gitlab.com/inkscape/extensions/-/issues/381 Issue extensions#381])
*The '''DXF14 export''' now shows a better error message in case of a very, very deeply nested SVG document ([https://gitlab.com/inkscape/extensions/-/merge_requests/442 MR extensions#442], [https://gitlab.com/inkscape/extensions/-/issues/360 Issue extensions#360]). Also a warning message regarding the Robo-Master spline option has been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/439 MR extensions#439], [https://gitlab.com/inkscape/extensions/-/issues/225 Issue extensions#225]).
*The '''Extensions Manager''' is now shipped with Inkscape and doesn't download itself automatically anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
*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. Additionally, the JPEG export now works with even larger resolutions ([https://gitlab.com/inkscape/inbox/-/issues/6522 Issue inbox#6522], [https://gitlab.com/inkscape/extensions/-/merge_requests/445 MR extensions#445]).
*The '''LaTeX''' extension now also works on Windows if the user name is longer than 8 characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/448 MR extensions#448], [https://gitlab.com/inkscape/extensions/-/issues/287 Issue extensions#287])
*A bug in the rotation sense of the '''Lindenmayer''' extension has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/437 MR extensions#437], [https://bugs.launchpad.net/inkscape/+bug/1094627 LP issue 1094627])
*The '''Motion''' extension now gives better results for paths with multiple closed subpaths ([https://gitlab.com/inkscape/extensions/-/issues/266 Issue extensions#266]) and when the selected element is part of a transformed group. ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
*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]).
*The '''Webslicer''' extension now correctly cleans up its temporary files ([https://gitlab.com/inkscape/extensions/-/merge_requests/436 MR extensions#436])

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

Updating your Extension for 1.2

2022-03-03T19:03:46Z

Joneuhauser: Move documentation

This page was intended for extension authors who want to use the new capabilities of inkex in Inkscape 1.2. It has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/update1.2.html extensions repository documentation].

Updating your Extension for 1.0

2022-03-03T19:02:43Z

Joneuhauser: move documentation

This was a preliminary and incomplete list of actions to take for updating Python extensions for Inkscape 1.0. It has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/update1.0.html extensions repository documentation].
[[Category:Extensions]]

Extension Interpreters

2022-03-03T18:58:33Z

Joneuhauser: Move documentation

This page used to contain information about interpreters for running extensions in Inkscape. It has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/interpreters.html extensions repository documentation].
[[Category:Developer Documentation]]
[[Category:Extensions]]

Extensions: INX widgets and parameters

2022-03-03T18:55:59Z

Joneuhauser: Move documentation.

The documentation for INX widgets and parameters has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/inx.html documentation of the extensions repository].

{| class="wikitable" style="vertical-align:top;" valign="top"
|- style="border:none;background:none"

|}

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

Release notes/1.2

2022-02-26T10:12:52Z

Joneuhauser: /* Particular extensions */

{{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]].
*After you add more then one page you can switch active page with page navigator on right side of status bar

=== 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 objects on canvas and in Layers dialog. ( 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''').

Dithering on canvas rendering can be turned off (for performance reasons) Preferences > Rendering > use dithering

Dithering does not fork on mesh gradients

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

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

== 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]].
*Default color of page is white and page background is light gray to help better visuals what is page and what is outside of page
* 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.
* Guides have new default 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 AI (pdf-based)''' file, use <code>File → Open/Import → select file name → choose to import 'All' pages</code> [Known issue: 'import' moves content of some pages to some far out place in the drawing]
*You can navigate pages with page navigator on that will show up in right down corner of status bar

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

[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>share/inkscape/ui/highlight-colors.css</code> in your Inkscape directory
* layer and object colors can be customized for each layer/object on its own, by clicking on the vertical color bar at the end of each line
* tiny mask and scissor symbols indicate that a clip or mask is applied to an object
* object and layer names (label, not id) can be changed after a double-click on the current name
* icons for locking and hiding a layer/object light up when you hover over the layer's row:
** 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 ===
[[File:Require restart.png|frame]]
* The preferences zoom ruler now respects your theme's look ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3450 MR #3450])
* An option to make '''<code>Select same</code>''' behave like <code>Select all</code> with respect to whether it selects objects only in the current layer or in all layers was added to <code>Edit → Preferences → Behavior → Selecting</code> ([https://gitlab.com/inkscape/inkscape/-/merge_requests/2832 MR #2832])
*Preferences that require restarting inkscape to take a effect have a small icon next to it

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

==== anothere small fixes and improvements: ====
*# Edit operation to work for fonts without label (created by FontForge)
*# Add button to set up "typography" canvas taking font dimensions into account

[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] [https://gitlab.com/inkscape/inkscape/-/merge_requests/3916 3916])

=== 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/25.

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]].
*A GUI API (based on [https://pypi.org/project/gtkme/ gtkme]) has been added, so extensions can now ship GTK-based user interfaces ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
*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 '''Clipart Importer''' extension allows to search and download SVG resources from the Internet ([https://gitlab.com/inkscape/extensions/-/merge_requests/441 MR extensions#441]).
*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]).
*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 '''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.]]
* The '''Frame''' extension has been rewritten and now supports additional options, such as elliptical frames, offset frame and putting the fill below the object ([https://gitlab.com/inkscape/extensions/-/merge_requests/430 MR extensions#430], [https://gitlab.com/inkscape/extensions/-/issues/214 Issue extensions#214]).
*The '''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.
*Extensions that query properties of paths with multiple subpaths now get more correct results if that path uses relative path commands ([https://gitlab.com/inkscape/extensions/-/merge_requests/438 MR extensions#438], [https://gitlab.com/inkscape/extensions/-/issues/450 Issue extensions#450]).
* When extensions set an element to "insensitive", this change is honored by Inkscape ([https://gitlab.com/inkscape/extensions/-/commit/d5282bd2341d24bc53cec02aed81e2f3ee6c6050 commit extensions#d5282bd2])
* The defaults of parameters are now identical in inx files and in the command line interface of the extensions. ([https://gitlab.com/inkscape/extensions/-/merge_requests/325 MR extensions#325])
* Gradients whose stop positions are given in percentages are now handled ([https://gitlab.com/inkscape/extensions/-/merge_requests/374 MR extensions#374])
* Hide the console window on Windows when calling external utilities ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407], [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])
*The <code>BaseElement.duplicate()</code> function now makes sure that the duplicated element and its children have unique IDs ([https://gitlab.com/inkscape/extensions/-/merge_requests/426 MR extensions#426], [https://gitlab.com/inkscape/extensions/-/issues/379 Issue extensions#379]).
*The "Reverse Path" method now returns correct results for paths with multiple subpaths ([https://gitlab.com/inkscape/extensions/-/merge_requests/427 MR extension#427], [https://gitlab.com/inkscape/extensions/-/issues/445 Issue extensions#445]).
*Several small fixes that makes working with paths and clones more predictable and robust ([https://gitlab.com/inkscape/extensions/-/merge_requests/433 MR extensions#433])

==== 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]), extruded elements and multiline text ([https://gitlab.com/inkscape/extensions/-/merge_requests/432 MR extension#432], [https://gitlab.com/inkscape/extensions/-/issues/286 Issue extensions#286]). An incorrect unit in the documentation has been exchanged ([https://gitlab.com/inkscape/extensions/-/merge_requests/358 MR extensions #358]).
* When using the '''DXF Outline (R12)''' export, elements in nested groups are now exported correctly ([https://gitlab.com/inkscape/extensions/-/merge_requests/347/ MR extensions#347], [https://gitlab.com/inkscape/extensions/-/issues/382 Issue extensions#382]). It also doesn't include (invisible) paths contained in clips and masks anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/440 MR extensions#440], [https://gitlab.com/inkscape/extensions/-/issues/381 Issue extensions#381])
*The '''DXF14 export''' now shows a better error message in case of a very, very deeply nested SVG document ([https://gitlab.com/inkscape/extensions/-/merge_requests/442 MR extensions#442], [https://gitlab.com/inkscape/extensions/-/issues/360 Issue extensions#360]). Also a warning message regarding the Robo-Master spline option has been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/439 MR extensions#439], [https://gitlab.com/inkscape/extensions/-/issues/225 Issue extensions#225]).
*The '''Extensions Manager''' is now shipped with Inkscape and doesn't download itself automatically anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
*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.
*A bug in the rotation sense of the '''Lindenmayer''' extension has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/437 MR extensions#437], [https://bugs.launchpad.net/inkscape/+bug/1094627 LP issue 1094627])
*The '''Motion''' extension now gives better results for paths with multiple closed subpaths ([https://gitlab.com/inkscape/extensions/-/issues/266 Issue extensions#266]) and when the selected element is part of a transformed group. ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
*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]).
*The '''Webslicer''' extension now correctly cleans up its temporary files ([https://gitlab.com/inkscape/extensions/-/merge_requests/436 MR extensions#436])

=== 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/422 MR extensions#422], [https://gitlab.com/inkscape/extensions/-/merge_requests/423 MR extensions#423], [https://gitlab.com/inkscape/extensions/-/merge_requests/428 MR extensions#428]) and clearer communication of it ([https://gitlab.com/inkscape/extensions/-/merge_requests/420 MR extensions#420])
*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}}

Updating your Extension for 1.0

2022-02-11T08:55:49Z

Joneuhauser:

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

== Adjusting folder structure ==

For easier extension 'installation' by users and for having a better overview about the installed extensions, you can now put extensions into their own subfolders of the <code>extensions</code> directory. This is optional.

When specifying the command in the .inx file, you can use the new parameter 'location'.

* If you set <code>location="extensions"</code> (de-facto default in 0.92.x), it will assume the path is relative to either user or system extensions folder.
* If it's <code>location="inx"</code> (new and recommended in 1.0), it will assume the path is relative to the .inx file location.

An extension that uses the following snippet:

<source lang="xml">
<script>
<command location="inx" interpreter="python">hello.py</command>
</script>
</source>

can be put into any subfolder in <code>extensions</code> or into the <code>extensions</code> folder itself, as long as the file <code>hello.py</code> is in that same folder, at the same hierarchy level.

The old parameter <code>reldir</code> is deprecated. It is recommended to use Unix style path separators (i.e. <code>/</code>), if your script file is located in a nested subdirectory (should be a very rare case).

== Updating *.inx files ==

=== Remove dependency listings ===

Remove the dependency listings for the following modules:

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

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

=== Changes to parameter definitions ===

There are also some updates to the parameter definitions in .inx files. While these are intended to be backwards compatible to 0.92, you may wish to review the changes below:

* '''Underscores''' in inx parameter tags and attributes for translation '''can be dropped''' entirely. Use <code>translatable="no"</code> to make an item (e.g. a unit name) untranslatable.
* <code>boolean</code> can be renamed to <code>bool</code>
* <code><param type="enum" /></code> is deprecated, instead use optiongroups. Remember to rename <code><item></code> to <code><option></code> when replacing.
* In optiongroups <code>appearance="minimal"</code> is deprecated.
** In optiongroups you can now define dropdown selections (comboboxes) and radio buttons.
** i.e. <code><param type="optiongroup" appearance="combo" /></code>, or <code><param type="optiongroup" appearance="radio" /></code>.
* Choosing files / folders with <code><param type="path" /></code> (these return the path as a string to the Python script):
** Files:
*** Choose a file, with file type restriction (optional): <code><param name="my_file" type="path" mode="file" filetypes="png,jpg" gui-text="A file:">my/path/to/file.png</param></code>
*** Choose multiple files (file type restriction possible, too): <code><param name="my_files" type="path" mode="files" gui-text="Multiple files:">my/path/to/file.png</param></code>
*** Create a new file: <code><param name="my_new_file" type="path" mode="file_new" filetypes="png" gui-text="A new file:">my/path/to/file.png</param></code>
** Folders:
*** Choose a folder: <code><param name="my_folder" type="path" mode="folder" gui-text="A folder:">my/path/</param></code>
*** Choose multiple folders: <code><param name="my_folders" type="path" mode="folders" gui-text="Folders:">my/path/</param></code>
*** Create a new folder: <code><param name="my_new_folder" type="path" mode="folder_new" filetypes="png" gui-text="A new folder:">my/path/</param></code>
* Color choosers: make them more compact with <code>appearance="colorbutton"</code> for parameters of type <code>color</code>
* Multiline text entry fields are available with <code>appearance="multiline"</code> for parameters of type <code>string</code>
* The following new widgets (static, do not need to be read in by the .py file's option parser anymore):
** <code>label</code>: (<code><label>Some text</label></code>), replaces parameters of type <code>description</code> (which never really were parameters in the actual sense), optionally with <code>appearance="header"</code>.
** <code>hbox</code>/<code>vbox</code>: for layouting purposes (allow to pack child widgets into horizontally/vertically oriented boxes)
** <code><spacer/></code>/<code><separator/></code>: which add a variable space or separating line between child widgets.
** <code><image>my_image.svg</image></code>: which allows to display an image in the extension UI

Example file with many of the new features (click on Expand on the right to show, requires an image in the extensions directory with the correct name):

<div class="mw-collapsible mw-collapsed" style="overflow:auto;">

<source lang="xml>
<?xml version="1.0" encoding="UTF-8"?>
<inkscape-extension xmlns="http://www.inkscape.org/namespace/inkscape/extension">
<name>Layout Demo</name>
<id>org.inkscape.test.layout_demo</id>
<dependency type="executable" location="extensions">pathmodifier.py</dependency>

<hbox>
<vbox>
<label appearance="header">Multiple vboxes packed into an hbox</label>
<hbox>
<vbox>
<label>Vertical stack</label>
<param name="param_bool" type="bool" gui-text="Boolean">true</param>
<param name="param_int" type="int" gui-text="Int:" >12345</param>
<param name="param_float" type="float" gui-text="Float:">1.2345</param>
<param name="param_color" type="color" appearance="colorbutton" gui-text="Color:">0x12345678</param>
</vbox>
<spacer />
<vbox>
<label>Vertical stack with separators</label>
<param name="param_string" type="string" gui-text="Single line string:">a string value</param>
<separator></separator>
<param name="param_string_empty" type="string" gui-text="Empty single line:"></param>
<separator></separator>
<param name="param_string_multiline" type="string" appearance="multiline" gui-text="Multiline string:">a\nmultiline\nstring\nvalue</param>
</vbox>
<spacer />
<vbox>
<label>Vertical stack with spacers</label>
<param name="param_file_new" type="path" mode="file_new" filetypes="png" gui-text="A new file:">my/path/to/file.png</param>
<spacer />
<param name="param_file" type="path" mode="file" filetypes="png,jpg" gui-text="A file:">my/path/to/file.png</param>
<spacer />
<param name="param_files" type="path" mode="files" gui-text="Multiple files:">my/path/to/file.png</param>
<spacer />

</vbox>
<spacer />
<vbox>
<label>Vertical stack with expanding spacer</label>
<spacer size="expand"/>
<param name="param_folder" type="path" mode="folder" gui-text="A folder:">my/path/</param>
<param name="param_folders" type="path" mode="folders" gui-text="Folders:">my/path/to/file.png</param>
<param name="param_folder_new" type="path" mode="folder_new" gui-text="A new folder:">my/path/</param>
</vbox>
<spacer />
<vbox>
<label appearance="header">An image!</label>
<image>ink_icon.svg</image>
<spacer />
<label appearance="header" indent="1">Indented header</label>
<spacer />
<label>For details please refer to</label>
<label appearance="url" indent="1">https://clickable.url</label>
</vbox>
</hbox>
</vbox>
</hbox>

<effect needs-live-preview="false">
<object-type>all</object-type>
<effects-menu>
<submenu _name="Test"/>
</effects-menu>
</effect>
<script>
<command reldir="extensions" interpreter="python">do_nothing.py</command>
</script>
</inkscape-extension>
</source>
</div>

== Updating *.py files ==

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

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

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

=== Replace specific functions ===

When the .inx file is valid and not greyed out (meaning: a dependency is missing), you can start building the .py file up again.

In the Inkscape extensions refactoring process for Inkscape 1.0, many inkex functions have been removed, or renamed, or moved, or options have changed. Wherever possible, Inkscape will try to replace the old function by the new one, and will give you a deprecation warning, with instructions what to replace them by.

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

These changes are not backwards compatible.

'''The full Python API documentation is available on [https://inkscape.gitlab.io/extensions/documentation/ GitLab].'''

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

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

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

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

=== Writing tests ===

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

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

=== Documenting your extension ===

== Docstrings ==

Include docstrings in your extension, so documentation can be built from them automatically (see [https://inkscape.gitlab.io/extensions/documentation/ inkex API documentation]) collects the inline documentation comments into a single document.

== Submitting your extension for inclusion ==

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

== External links ==
A script to perform some of the conversion steps automatically has been contributed: https://gitlab.com/inkscape/extensions/-/issues/380
[[Category:Extensions]]

Release notes/1.2

2022-02-10T22:50:39Z

Joneuhauser: /* Extensions */

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

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

2022-02-10T22:33:48Z

Joneuhauser: /* Behind the curtains */

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==
Complete as of 2022/02/09.

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

2022-02-10T22:09:41Z

Joneuhauser: /* Extensions */

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==
Complete as of 2022/02/09.

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

2022-02-10T19:31:22Z

Joneuhauser: /* Extensions */

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==
Complete as of 2022/02/09.

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 honoured 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 extenal 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]).

==== 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])
*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]) and clearer communication of it ([https://gitlab.com/inkscape/extensions/-/merge_requests/420 MR extensions#420])
== 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

2022-02-09T19:45:19Z

Joneuhauser: /* Extensions */ update changelog until Feb 09

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==
Complete as of 2022/02/09.

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 honoured 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 extenal utilities: ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407], [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])

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

2022-02-09T19:11:42Z

Joneuhauser: /* Extensions */ more updates

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==

=== Features added ===

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

* Add option to limit output extension to save copy ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3600 MR #3600])
* Added Python <code>appdirs</code> dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568]) [Is this a bug fix?]
*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]).
*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 '''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 '''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 honoured 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 extenal utilities: ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407] , [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])

==== 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]).
*An incorrect unit in the '''DXF Import''' extension documentation has been fixed ([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 '''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])
*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]).

=== Behind the curtains ===

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

File:Modes of the Extrude extension.png

2022-02-09T19:07:06Z

Joneuhauser:

A new mode "Snug" has been added to the Extrude extension.

Release notes/1.2

2022-02-09T15:03:56Z

Joneuhauser: /* Extensions */ add a few changes

{{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 refactored]]'''
* '''[[#Customization_.2F_Theming|Configurable Tool bar''', '''continuous icon scaling''' and '''many more new customization options]]'''
* '''Performance improvements''' for many parts of the interface and many different functions
* '''[[#Notable_bugfixes|Many crash & bug fixes]]'''

== General user interface ==

=== Color palette ===

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

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

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

[TODO: add autostretch to demo animation?]

=== Status Bar ===

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

=== Tool bar ===

* The tool bar width can now be resized 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]]

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

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

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


== Dialogs ==

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

=== General ===

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

=== Align and distribute ===

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

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

=== Document Properties ===

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

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

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

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

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

=== Fill and Stroke dialog ===

==== Color selector ====

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

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

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

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

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

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

==== Markers ====

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

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

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

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

==== Custom Dash patterns ====

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

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

[TODO: needs gif]

==== Other small changes ====

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

=== Layers and Objects dialog ===

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

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

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

Note:

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

[TODO: needs a picture]

=== Preferences ===

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

=== SVG Font Editor ===

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

These changes result in a new recommended workflow:

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

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

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

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

=== Swatches ===

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

=== Text and Font dialog ===

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

=== Trace Bitmap ===

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

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

=== Transform dialog ===

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

== Filters ==

== Live path effects ==

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

=== Copies LPE ===

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

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

Features:

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

== Import / Export ==

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

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

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

Features:

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

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

== Customization / Theming ==

=== General User Interface ===

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

=== Bars / Toolbars ===

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

=== Cursors ===

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

=== Icons ===

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

=== Themes ===

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

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

== macOS-specific Changes ==

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

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

== Windows-specific Changes ==

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

== Extensions ==

=== Features added ===

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

* Add option to limit output extension to save copy ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3600 MR #3600])
* Added Python <code>appdirs</code> dependency ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3568 MR #3568]) [Is this a bug fix?]
*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 ====

* Add new '''Document > Process Illustrator SVG...''' extension to assist with importing Adobe Illustrator documents with layers and the correct scale ([https://gitlab.com/inkscape/extensions/-/merge_requests/351 MR extensions#351])
* 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])

=== 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 honoured 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 extenal utilities: ([https://gitlab.com/inkscape/extensions/-/merge_requests/407 MR extensions#407] , [https://gitlab.com/inkscape/extensions/-/issues/244 Issue extensions#244])

==== Particular extensions ====

* An incorrect unit in the '''DXF Import''' extension has been fixed ([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 '''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])

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