Inkscape Wiki - User contributions [en]

Inkscape

2024-04-24T09:04:28Z

Pulsar17: Replace C++11 link with C++20

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:
** past events:
::: [[Hackfest2023_Bensberg|2023 Bensberg]]
::: [[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.4|Inkscape 1.4]]'' — ''development branch''
** '''[[Release notes/1.3|Inkscape 1.3]]''' ([[Release notes/1.3.1|1.3.1]]) — ''current stable release branch''
** [[Release notes/1.2|Inkscape 1.2]] ([[Release notes/1.2.1|1.2.1]], [[Release notes/1.2.2|1.2.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++20]] — Which C++20 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]]

C++20

2024-04-23T18:19:44Z

Pulsar17: Add back consteval static

See also [[C++11]], [[C++17]], [[C++23]].

Some things that will be interesting to use once C++20 is common:

{| class="wikitable"
|-
! Feature !! Since !! Can use? !! GCC !! Apple Clang !! Comment
|-
| <code>std::span</code> || C++20 || style="background: lightgreen;" | from 1.4 || 10 || 11.0.3 || Handle buffers like standard library containers without risk of overflow.
|-
| <code>std::format</code> || C++20 || style="background: pink;" | not yet || 13 || 15.3 || Better and more efficient formatting of strings. [https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0645r10.html Text Formatting]
|-
| <code>std::lerp</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9 || 11.0.3 || Linear interpolation. (ui/tools/pencil-tool.cpp)
|-
| <code>std::bit_floor</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9/10 || 11.0.3/13.0.0 || Compute <code>floor(log2(x))</code>. (helper/mathfns.h)
|-
| Concepts || C++20 || from 1.4? || 6/10 || 12.0.0 Partial || Safer templating. (ui/controller.h)
|-
| Coroutines || C++20 || style="background: pink;" | not yet || 10 || 10.0.1 Partial,<br/> 15.3 Full || Simpler asynchronous code. (trace/trace.cpp)
|-
| <code>std::make_unique_for_overwrite</code>
|| C++20 || style="background: pink;" | not yet || 11 || 15.0.0 || Don't zero arrays allocated using std::make_unique. (util/pool.cpp)
|-
| Ranges || C++20 || style="background: pink;" | not yet || || ? || (ui/dialog/swatches.cpp)
|-
| [https://stackoverflow.com/a/60244416/5075760 Structural templates]
|| C++20 || from 1.4? || || Partial || Allow instances of arbitrary literal classes as template parameters. (display/drawing.cpp)
|-
| Mathematical Constants || C++20 || || 10 || 12.0.5 || Constants like <code>std::numbers::pi</code>.
|-
| Heterogenous lookup in <code>std::unordered_map</code>
|| C++20 || style="background: pink;" | not yet || || || Faster lookup, use of smart pointers as keys.
|-
|<code>consteval static</code> member functions
|C++20
| style="background: pink;" | not yet
|
|
|Guaranteed compile time evaluation of member functions (stronger than <code>constexpr</code>)
|}

References:

* General: https://en.cppreference.com/w/Template:cpp/compiler_support/20
* Apple Clang: https://developer.apple.com/documentation/xcode-release-notes

As of 27 March 2024, the CI runners for the various supported platforms are
* Linux:
** appimage:linux: GNU 13.2.0 (building on Ubuntu 23.10)
** inkscape:linux: Same as above
* Windows
** inkscape:windows:build: GNU 13.2.0
** inkscape:windows:dist: Same as above
* macOS:
** inkscape::macos:arm: Apple Clang 15.0.0
** inkscape:macos:x64: Apple Clang 13.0.0 (temporarily disabled since GTK4 port)

We strive to support latest Debian stable and latest Ubuntu LTS. However, we had to break that promise since the GTK4 port, which requires gtkmm4 >= 4.14:
{| class="wikitable"
|-
! Distro || gcc || clang || gtkmm4
|-
| Debian 12 (Bookworm, stable) || 12.2.0 || 15.0.6 || 4.8.3
|-
| Ubuntu 22.04 (Jammy Jellyfish) || 12.3.0 || 15.0.7 || Not packaged!
|-
| Ubuntu 23.04 (Lunar) || 13.1.0 || 16.0.0 || 4.10.1
|-
| Ubuntu 24.04 (Noble) || 13.2.0 || 18.1.0 || 4.10.1 (???)
|}

Ubuntu users therefore have the following options:

* Wait for Ubuntu 24.04, expected around 25 April 2024.
* Upgrade to Ubuntu 24.04 now.
* Upgrade to Ubuntu 23.10 and build gtkmm4 from source, as is currently done by CI.
* ???

Deprecated items that we still use:
* warning: implicit capture of ‘this’ via ‘[=]’ is deprecated in C++20 [-Wdeprecated] https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0806r2.html
* warning: bitwise operation between different enumeration types ‘Box3D::Axis’ and ‘Box3D::FrontOrRear’ is deprecated [-Wdeprecated-enum-enum-conversion]

C++20

2024-04-23T18:15:32Z

Pulsar17: Undo revision 122768 by Pulsar17 (talk)

See also [[C++11]], [[C++17]], [[C++23]].

Some things that will be interesting to use once C++20 is common:

{| class="wikitable"
|-
! Feature !! Since !! Can use? !! GCC !! Apple Clang !! Comment
|-
| <code>std::span</code> || C++20 || style="background: lightgreen;" | from 1.4 || 10 || 11.0.3 || Handle buffers like standard library containers without risk of overflow.
|-
| <code>std::format</code> || C++20 || style="background: pink;" | not yet || 13 || 15.3 || Better and more efficient formatting of strings. [https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0645r10.html Text Formatting]
|-
| <code>std::lerp</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9 || 11.0.3 || Linear interpolation. (ui/tools/pencil-tool.cpp)
|-
| <code>std::bit_floor</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9/10 || 11.0.3/13.0.0 || Compute <code>floor(log2(x))</code>. (helper/mathfns.h)
|-
| Concepts || C++20 || from 1.4? || 6/10 || 12.0.0 Partial || Safer templating. (ui/controller.h)
|-
| Coroutines || C++20 || style="background: pink;" | not yet || 10 || 10.0.1 Partial,<br/> 15.3 Full || Simpler asynchronous code. (trace/trace.cpp)
|-
| <code>std::make_unique_for_overwrite</code>
|| C++20 || style="background: pink;" | not yet || 11 || 15.0.0 || Don't zero arrays allocated using std::make_unique. (util/pool.cpp)
|-
| Ranges || C++20 || style="background: pink;" | not yet || || ? || (ui/dialog/swatches.cpp)
|-
| [https://stackoverflow.com/a/60244416/5075760 Structural templates]
|| C++20 || from 1.4? || || Partial || Allow instances of arbitrary literal classes as template parameters. (display/drawing.cpp)
|-
| Mathematical Constants || C++20 || || 10 || 12.0.5 || Constants like <code>std::numbers::pi</code>.
|-
| Heterogenous lookup in <code>std::unordered_map</code>
|| C++20 || style="background: pink;" | not yet || || || Faster lookup, use of smart pointers as keys.
|}

References:

* General: https://en.cppreference.com/w/Template:cpp/compiler_support/20
* Apple Clang: https://developer.apple.com/documentation/xcode-release-notes

As of 27 March 2024, the CI runners for the various supported platforms are
* Linux:
** appimage:linux: GNU 13.2.0 (building on Ubuntu 23.10)
** inkscape:linux: Same as above
* Windows
** inkscape:windows:build: GNU 13.2.0
** inkscape:windows:dist: Same as above
* macOS:
** inkscape::macos:arm: Apple Clang 15.0.0
** inkscape:macos:x64: Apple Clang 13.0.0 (temporarily disabled since GTK4 port)

We strive to support latest Debian stable and latest Ubuntu LTS. However, we had to break that promise since the GTK4 port, which requires gtkmm4 >= 4.14:
{| class="wikitable"
|-
! Distro || gcc || clang || gtkmm4
|-
| Debian 12 (Bookworm, stable) || 12.2.0 || 15.0.6 || 4.8.3
|-
| Ubuntu 22.04 (Jammy Jellyfish) || 12.3.0 || 15.0.7 || Not packaged!
|-
| Ubuntu 23.04 (Lunar) || 13.1.0 || 16.0.0 || 4.10.1
|-
| Ubuntu 24.04 (Noble) || 13.2.0 || 18.1.0 || 4.10.1 (???)
|}

Ubuntu users therefore have the following options:

* Wait for Ubuntu 24.04, expected around 25 April 2024.
* Upgrade to Ubuntu 24.04 now.
* Upgrade to Ubuntu 23.10 and build gtkmm4 from source, as is currently done by CI.
* ???

Deprecated items that we still use:
* warning: implicit capture of ‘this’ via ‘[=]’ is deprecated in C++20 [-Wdeprecated] https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0806r2.html
* warning: bitwise operation between different enumeration types ‘Box3D::Axis’ and ‘Box3D::FrontOrRear’ is deprecated [-Wdeprecated-enum-enum-conversion]

C++20

2024-04-23T18:11:58Z

Pulsar17: Add consteval static as an entry

See also [[C++11]], [[C++17]], [[C++23]].

Some things that will be interesting to use once C++20 is common:

{| class="wikitable"
|-
! Feature !! Since !! Can use? !! GCC !! Apple Clang !! Comment
|-
| <code>std::span</code> || C++20 || style="background: lightgreen;" | from 1.4 || 10 || 11.0.3 || Handle buffers like standard library containers without risk of overflow.
|-
| <code>std::format</code> || C++20 || style="background: pink;" | not yet || 13 || 15.3 || Better and more efficient formatting of strings. [https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p0645r10.html Text Formatting]
|-
| <code>std::lerp</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9 || 11.0.3 || Linear interpolation. (ui/tools/pencil-tool.cpp)
|-
| <code>std::bit_floor</code> || C++20 || style="background: lightgreen;" | from 1.4 || 9/10 || 11.0.3/13.0.0 || Compute <code>floor(log2(x))</code>. (helper/mathfns.h)
|-
| Concepts || C++20 || from 1.4? || 6/10 || 12.0.0 Partial || Safer templating. (ui/controller.h)
|-
| Coroutines || C++20 || style="background: pink;" | not yet || 10 || 10.0.1 Partial,<br/> 15.3 Full || Simpler asynchronous code. (trace/trace.cpp)
|-
| <code>std::make_unique_for_overwrite</code>
|| C++20 || style="background: pink;" | not yet || 11 || 15.0.0 || Don't zero arrays allocated using std::make_unique. (util/pool.cpp)
|-
| Ranges || C++20 || style="background: pink;" | not yet || || ? || (ui/dialog/swatches.cpp)
|-
| [https://stackoverflow.com/a/60244416/5075760 Structural templates]
|| C++20 || from 1.4? || || Partial || Allow instances of arbitrary literal classes as template parameters. (display/drawing.cpp)
|-
| Mathematical Constants || C++20 || || 10 || 12.0.5 || Constants like <code>std::numbers::pi</code>.
|-
| Heterogenous lookup in <code>std::unordered_map</code>
|| C++20 || style="background: pink;" | not yet || || || Faster lookup, use of smart pointers as keys.|}References:

* General: https://en.cppreference.com/w/Template:cpp/compi|-
|<code>consteval static</code> member functions
|C++20
| style="background: pink;" |not yet
|
|
|Guaranteed compile time evaluation of member functions (stronger than <code>constexpr</code>)
|}

References:

*General: https://en.cppreference.com/w/Template:cpp/compiler_support/20
* Apple Clang: https://developer.apple.com/documentation/xcode-release-notes

As of 27 March 2024, the CI runners for the various supported platforms are
*Linux:
**appimage:linux: GNU 13.2.0 (building on Ubuntu 23.10)
**inkscape:linux: Same as above
*Windows
**inkscape:windows:build: GNU 13.2.0
** inkscape:windows:dist: Same as above
*macOS:
**inkscape::macos:arm: Apple Clang 15.0.0
**inkscape:macos:x64: Apple Clang 13.0.0 (temporarily disabled since GTK4 port)

We strive to support latest Debian stable and latest Ubuntu LTS. However, we had to break that promise since the GTK4 port, which requires gtkmm4 >= 4.14:
{| class="wikitable"
|-
! Distro|| gcc|| clang||gtkmm4
|-
|Debian 12 (Bookworm, stable)||12.2.0||15.0.6||4.8.3
|-
|Ubuntu 22.04 (Jammy Jellyfish) ||12.3.0 ||15.0.7 ||Not packaged!
|-
|Ubuntu 23.04 (Lunar)|| 13.1.0 || 16.0.0 ||4.10.1
|-
|Ubuntu 24.04 (Noble)||13.2.0||18.1.0|| 4.10.1 (???)
|}

Ubuntu users therefore have the following options:

*Wait for Ubuntu 24.04, expected around 25 April 2024.
*Upgrade to Ubuntu 24.04 now.
*Upgrade to Ubuntu 23.10 and build gtkmm4 from source, as is currently done by CI.
* ???

Deprecated items that we still use:
*warning: implicit capture of ‘this’ via ‘[=]’ is deprecated in C++20 [-Wdeprecated] https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0806r2.html
*warning: bitwise operation between different enumeration types ‘Box3D::Axis’ and ‘Box3D::FrontOrRear’ is deprecated [-Wdeprecated-enum-enum-conversion]

Release notes/1.3

2022-08-13T10:56:19Z

Pulsar17: Fix minor grammatical errors

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

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

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

}}

{{Box| Pending questions:

}}

== Release highlights ==




* Pattern editor , Pattern canvas controls, and pattern performance
* '''and so much more!'''

== General user interface ==
[[File:Indicators of used colors.png|thumb|indicators of used colors]]
Color palettes have indicator color of stroke and fill of selected object.
== Canvas ==

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

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

Added display overlay controls in top right corners. You need to have scrollbars enable to see it.

[[File:Canvas overlays.png|399x399px]]

== Tools ==

=== Node tool ===
Pattern editing on canvas is now easier you can click on any part of pattern and it will show you controls on that position. We also outline that shows you edges of pattern.
[[File:Inkscape xfsvsc2oY9.gif|none|thumb|editing pattern on canvas]]

== Path Operations ==

== Masking / Clipping ==

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

== Dialogs ==

=== Fill and stroke Dialog ===
New pattern editor was added in to UI. You can preview patterns change name, size, rotation, offset, gaps and colors for some specific patterns. We also added collections of patterns <code>~paint/pattern.svg</code> so its easier to be organized . Since this allows having much more patterns preset we also added search function .

=== Symbols ===
You can drag and drop symbols on canvas and they are going to be place where you dropped them

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

== Filters ==

== Live path effects ==

== Import / Export ==

== Templates ==

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

== Customization / Theming ==

== Other ==

== macOS-specific Changes ==

== Windows-specific Changes ==

== Extensions ==

=== Features ===

==== General Extension Changes ====

==== New Extensions ====

==== Particular extensions ====

=== Bugs fixed ===

==== All extensions ====

==== Particular extensions ====

=== Extension Development ===

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

==== Extension Development Documentation ====

==== Under the hood ====

== Command line ==

== Behind the curtains ==

== Notable bugfixes ==

=== Crash fixes ===

Fixed a crash that occurred …

* when …

=== Other bug fixes ===

=== 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.3 our GitLab issue tracker] and see the [https://gitlab.com/inkscape/inkscape/-/commits/1.3.x commit history].

== Translations ==

The following UI translations received updates:

* …

The Windows installer translation was updated for:

* …

The following documentation translations received updates:

* …

=== Contributing to interface translations ===

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

== Documentation ==

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

== Website ==

== Important changes for packagers ==

== Known issues ==

== Other releases ==

{{:Release notes}}

Release notes/1.2

2022-04-06T00:20:07Z

Pulsar17: Fix minor grammatical errors

{{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#Tiling|New 'Tiling' Live Path effect 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 drop-down has been replaced by a layer indicator. Clicking on the indicator opens the new [[#Layers_and_Objects_dialog|Layers and object dialog]]. This change improves Inkscape's performance for documents with many layers ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3648 MR #3648]).
* The status bar contents are 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 ===

Performance for canvas rendering and on macOS has been investigated and significantly improved. Inkscape should be faster to render while panning and zooming now.

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

=== Tiling ===

[[File:Copie LPE.gif|frame|right|The new Tiling 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
* Custom gap controls in X and 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/19.

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], [https://gitlab.com/inkscape/extensions/-/merge_requests/465 MR extensions#465]).
*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 '''Extract image''' extension has been improved and works with multiple images now. You can now enter a base filename; if none is entered, the ids of the selected images are used as filename. You can also choose whether the embedded image data should be replaced by a link to the exported file ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461], [https://gitlab.com/inkscape/extensions/-/issues/167 Issue extensions#167]).
*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 '''Formula (pdflatex)''' equation has been made more user-friendly. It now features a font size selector, a field to specify preamble contents, better support for scaled documents and better error messages on compile errors ([https://gitlab.com/inkscape/extensions/-/merge_requests/453 MR extensions#453]).
*The '''Frame''' extension has been rewritten and now supports additional options, such as elliptical frames, offset frame and putting the fill below the object ([https://gitlab.com/inkscape/extensions/-/merge_requests/430 MR extensions#430], [https://gitlab.com/inkscape/extensions/-/issues/214 Issue extensions#214]).
*The '''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]).
*A bug parsing color components of 1 (1.0, 100%) has been fixed. <code>"1.0"</code>, <code>1.0</code> and <code>"100%"</code> are treated as <code>255</code>, while <code>"1"</code> and <code>1</code> are treated as <code>1</code> ([https://gitlab.com/inkscape/extensions/-/merge_requests/456 MR extensions#456], [https://gitlab.com/inkscape/extensions/-/issues/402 Issue extensions#402]).
*Several small fixes that makes working with paths and clones more predictable and robust ([https://gitlab.com/inkscape/extensions/-/merge_requests/433 MR extensions#433])
*Small changes improving parameter description ([https://gitlab.com/inkscape/extensions/-/merge_requests/452 MR extensions#452], [https://gitlab.com/inkscape/extensions/-/issues/452 Issue extensions#452])

==== Particular extensions ====

* In the '''Add nodes''' extension, closed paths were previously changed to open paths, and an erroneous node was added ([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]) and documents are exported with the correct scale when scale is different than 1 ([https://gitlab.com/inkscape/extensions/-/merge_requests/466 MR extensions#466], [https://gitlab.com/inkscape/extensions/-/issues/443 Issue extensions#443])
*The '''DXF14 export''' now shows a better error message in case of a very, very deeply nested SVG document ([https://gitlab.com/inkscape/extensions/-/merge_requests/442 MR extensions#442], [https://gitlab.com/inkscape/extensions/-/issues/360 Issue extensions#360]). Also a warning message regarding the Robo-Master spline option has been added ([https://gitlab.com/inkscape/extensions/-/merge_requests/439 MR extensions#439], [https://gitlab.com/inkscape/extensions/-/issues/225 Issue extensions#225]).
*A crash in the '''Embed image''' extension has been fixed, in which images were erroneously determined as missing by the extension ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461], [https://gitlab.com/inkscape/extensions/-/issues/441 Issue extensions#441]).
*The '''Extensions Manager''' is now shipped with Inkscape and doesn't download itself automatically anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/421 MR extensions#421]).
*On Windows, the '''Extract image''' extension now correctly links the extracted files ([https://gitlab.com/inkscape/extensions/-/merge_requests/461 MR extensions#461]).
*The slicing positions in the '''Guillotine''' extension are now correct, they were previously off following the flip of the y axis in Inkscape 1.0 ([https://gitlab.com/inkscape/extensions/-/merge_requests/334 MR extensions#334], [https://gitlab.com/inkscape/extensions/-/issues/269 Issue extensions#269]).
*In '''GCodetools''', multiple crashes have been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/335 MR extensions#335], [https://gitlab.com/inkscape/extensions/-/issues/312 Issue extensions#312]; [https://gitlab.com/inkscape/extensions/-/merge_requests/307 MR extensions#307], [https://gitlab.com/inkscape/extensions/-/issues/322 Issue extensions#322]; [https://gitlab.com/inkscape/extensions/-/merge_requests/388 MR extensions#388], [https://gitlab.com/inkscape/extensions/-/issues/276 Issue extensions#276]), however this module is currently unmaintained and in need of attention. Contributions are highly welcome! For this reason, the module has been given it's own repository ([https://gitlab.com/inkscape/extensions/-/merge_requests/402 MR extensions#402]).
*The Hue Level in the '''HSL Adjust''' extension how has a range of 360 ([https://gitlab.com/inkscape/extensions/-/merge_requests/400 MR extensions#400])
*The '''HTML5 canvas export''' now works better with non-Inkscape SVG documents ([https://gitlab.com/inkscape/extensions/-/merge_requests/467 MR extensions#467]). Exported files also now have correct output for closed paths and objects with transparency ([https://gitlab.com/inkscape/extensions/-/merge_requests/345 MR extensions#345], [https://gitlab.com/inkscape/extensions/-/issues/332 Issue extensions#332]).
*The '''Interpolate extensions''' (Interpolate and interpolate attribute) have been completely rewritten and multiple issues have been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/240 MR extensions#240]).
*The '''JPEG export''' previously converted a transparent background to black ([https://gitlab.com/inkscape/extensions/-/issues/366 Issue extensions#366]). Now, the document background color is used ([https://gitlab.com/inkscape/inkscape/-/merge_requests/3994 MR #3994]). This also affects the other Raster export extensions. Additionally, the JPEG export now works with even larger resolutions ([https://gitlab.com/inkscape/inbox/-/issues/6522 Issue inbox#6522], [https://gitlab.com/inkscape/extensions/-/merge_requests/445 MR extensions#445]).
*Several bugs in the '''Formula (pdflatex)''' extension have been fixed, such as incorrect insertion position ([https://gitlab.com/inkscape/extensions/-/issues/339 Issue extensions#339]) and random character substitution in documents with many formulae ([https://gitlab.com/inkscape/extensions/-/merge_requests/453 MR extensions#453]). The extension now also works on Windows if the user name is longer than 8 characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/448 MR extensions#448], [https://gitlab.com/inkscape/extensions/-/issues/287 Issue extensions#287]).
*A bug in the rotation sense of the '''Lindenmayer''' extension has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/437 MR extensions#437], [https://bugs.launchpad.net/inkscape/+bug/1094627 LP issue 1094627])
*The '''Motion''' extension now gives better results for paths with multiple closed subpaths ([https://gitlab.com/inkscape/extensions/-/issues/266 Issue extensions#266]) and when the selected element is part of a transformed group. ([https://gitlab.com/inkscape/extensions/-/merge_requests/317 MR extensions#317]).
*The '''Optimized PNG export''' doesn't crash anymore when running it with default parameters ([https://gitlab.com/inkscape/extensions/-/merge_requests/463 MR extensions#463], [https://gitlab.com/inkscape/extensions/-/issues/395 Issue extensions#395])
*A useless warning message when using '''Optimized SVG''' output was removed ([https://gitlab.com/inkscape/extensions/-/merge_requests/368 MR extensions#368] , [https://gitlab.com/inkscape/extensions/-/issues/428 Issue extensions#428])
*The '''Pixel snap''' extension now aligns objects to the coordinate system starting at the top left of the page. The previous behavior, snapping them to a grid aligned with the page bottom, can be activated in the settings ([https://gitlab.com/inkscape/extensions/-/merge_requests/429 MR extensions#429], [https://gitlab.com/inkscape/extensions/-/issues/264 Issue extensions#264]). A bug related to inconsistent unit conversion has been fixed as well.
*Several bugs in the '''PostScript (PS) / EPS import''' have been adressed: It now handles file names with non-latin characters ([https://gitlab.com/inkscape/extensions/-/merge_requests/408 MR extensions#408], [https://gitlab.com/inkscape/extensions/-/issues/281 Issue extensions#281]) on Windows and doesn't rotate the image anymore if the majority of the text is not oriented left-to-right ([https://gitlab.com/inkscape/extensions/-/merge_requests/457 MR extensions#457] and [https://gitlab.com/inkscape/extensions/-/issues/258 Issue extensions#258]). Also a clearer error message is shown for invalid PS/EPS files ([https://gitlab.com/inkscape/extensions/-/merge_requests/454 MR extensions#454], [https://gitlab.com/inkscape/extensions/-/issues/404 Issue extensions#404])
*In the '''Randomize Colors''', shapes with unset opacity are not ignored anymore ([https://gitlab.com/inkscape/extensions/-/merge_requests/331 MR extensions#331] [https://gitlab.com/inkscape/extensions/-/issues/236 Issue extensions#236]).
*A crash in the '''Render Polyhedron''' extension when attempting to render a custom object defined by its edges has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/390 MR extensions#390] , [https://gitlab.com/inkscape/extensions/-/issues/408 Issue extensions#408]).

* The '''Replace Color''' extension now processes colors in RGBA space ([https://gitlab.com/inkscape/extensions/-/merge_requests/392 Issue extensions#392], [https://gitlab.com/inkscape/extensions/-/issues/419 Issue extensions#419]).
*The "Tangential Offset" parameter of the '''Scatter''' extension is now a percentage of the pattern width, and an issue with nested groups has been resolved ([https://gitlab.com/inkscape/extensions/-/merge_requests/327 MR extensions#327]). Another issue where the spacing was off when using the "stretch" mode has also been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/327 MR extensions#327]).
*The '''Synfig export''' now exports objects that are not paths (such as rects, texts, circles) correctly again ([https://gitlab.com/inkscape/extensions/-/issues/198 Issue extensions#198]); and paths with multiple subpaths are converted correctly ([https://gitlab.com/inkscape/extensions/-/issues/197 Issue extensions#197]) ([https://gitlab.com/inkscape/extensions/-/merge_requests/462 MR extensions#462]).
*The '''TIFF export''' now also works on Linux ([https://gitlab.com/inkscape/extensions/-/merge_requests/458 MR extensions#458], [https://gitlab.com/inkscape/extensions/-/issues/422 Issue extensions#422])
*In the '''Visualize Path''' extensions '''Measure Path''' and '''Number Nodes''', the results are now correct also when the parent of the selected object is transformed ([https://gitlab.com/inkscape/extensions/-/merge_requests/314 MR extensions#314], [https://gitlab.com/inkscape/extensions/-/issues/171 Issue extensions#171]).
*A crash in the '''Voronoi Diagram''' extension when applied to non-Inkscape documents has been fixed ([https://gitlab.com/inkscape/extensions/-/merge_requests/313 MR extensions#313], [https://gitlab.com/inkscape/extensions/-/issues/222 Issue extensions#222]), and the output is now correct independent of the document unit ([https://gitlab.com/inkscape/extensions/-/issues/403 Issue extensions#403], [https://gitlab.com/inkscape/extensions/-/merge_requests/382 MR extensions#382]).
*The '''Webslicer''' extension now correctly cleans up its temporary files ([https://gitlab.com/inkscape/extensions/-/merge_requests/436 MR extensions#436])

=== Documentation ===
* All the documentation from the Wiki and the Gitlab project wiki has been '''[https://inkscape.gitlab.io/extensions/documentation/ compiled in a single place]'''. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443], [https://gitlab.com/inkscape/extensions/-/merge_requests/451 MR extensions#451])
* The '''tutorials for extension authors''' have been improved. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443])
* '''Versioning information''' is now contained in the documentation. This shows extensions authors in which Inkscape version new API functionality was added or deprecated. ([https://gitlab.com/inkscape/extensions/-/merge_requests/443 MR extensions#443])
* The API documentation has been updated into the familiar ReadTheDocs layout ([https://gitlab.com/inkscape/extensions/-/merge_requests/310 MR extensions#310]) and is now generated with a newer version of Sphinx ([https://gitlab.com/inkscape/extensions/-/commit/edf232209494107c9f33ccc6f101726a7fd73adb Commit extensions#edf23220]).
*Fix some small mistakes in the documentation ([https://gitlab.com/inkscape/extensions/-/merge_requests/324 MR extensions#324])
=== 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]).
*A dependency management system, [https://python-poetry.org/ poetry], has been introduced ([https://gitlab.com/inkscape/extensions/-/merge_requests/446 MR extensions#446]). This provides packagers with the necessary information which versions of python modules the extensions are currently tested against.
*The deprecated <code>inkex.py</code> file has been removed ([https://gitlab.com/inkscape/extensions/-/merge_requests/460 MR extensions#460]) since it's interfering with the new dependency manager.
*The localization of the extensions has been improved ([https://gitlab.com/inkscape/extensions/-/merge_requests/425 MR extensions#425]).
*It is now possible to use ngettext and pgettext in extensions for better translations ([https://gitlab.com/inkscape/extensions/-/merge_requests/459 MR extensions#459]).
== Command line ==

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

== Behind the curtains ==

* '''Gio::Actions''': The old 'verbs' were converted to 'actions'. This work was done to prepare for migrating to Gtk4. It also makes it possible to reach them all '''from the commands palette''', to assign keyboard shortcuts them and to use them on the command line. A big part of this work was done by 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].
* The extension that imports images from the internet requires the Python cachecontrol module

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

Inkscape Extensions

2022-03-13T16:22:26Z

Pulsar17: Move page to Nextcloud and add relevant links.

This page contained a comprehensive list of all extensions that were known to work around 2018. The list has been archived on Inkscape's Nextcloud instance [https://office.inkscape.org/nextcloud/index.php/s/T8DX6fz2N3BocjF here]. To search for extensions, use the Inkscape website's [https://inkscape.org/gallery/=extension/ Extensions gallery] or the new Extension Manager available in Inkscape 1.2 and later by going to <code>Extensions</code> > <code>Manage Extensions</code> (internally it uses the gallery to search for extensions). The extensions' documentation itself has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/index.html documentation of the extensions repository.]

[[Category:Extensions]]

Python modules for extensions

2022-03-10T22:06:59Z

Pulsar17: Use better language

[[Category:Extensions]]

This page contained API documentation for various modules in inkex. A more complete API documentation is available in the [https://inkscape.gitlab.io/extensions/documentation/source/index.html documentation of the extensions repository.]

ZINK Filetype

2022-03-10T21:50:07Z

Pulsar17: Mark page as outdated.

{{outdated}}

== ZINK Filetype ==
=== Documentation and specs ===

==== About ====
The ZINK filetype is currently implemented as input and output extensions for Inkscape. When these extensions are installed the user is able save and open .zink files. A Zink file contains a normal Inkskape svg-file including all linked images. This makes it possible to easily share/publish Inkcape documents with NO BROKEN IMAGES.

The zink filetype is packed using the zlib modules from python, so it is actually just a zip archive with the extension .zink. If you rename is you can open it with any zip extracter.

At this moment a zink file contains the following:
* content.svg
* images in gif, png or jpg

The first addition will be a version file so we can garantee backwards compatibility in the future. In the future there maybe some other additions like a manifest file or some directory lay-out.

==== TODO ====
# Make the current extension work on Inkscape CVS in mac os x and windows
# Add file containing zink version number for future backwards compatibility.
# Write documentation and specs at this page and keep up to date.
# Implement a proper temp directory solution with the help of other inkscape programmers
# Investigate howto reinplement all functionallity in c++ using the existing inkjar code.
==== Download ====
As these extensions are not (yet) in CVS i've put them on our webserver. Download them here:
http://facility.lingewoud.nl/hacks/inkscape_save_and_open_as_zink/

==== Install ====
If you have inkscape 0.43 or lower you must also install a newer version of inkex.py in your extension folder. Get this from the same download location or from inkscape CVS.

If you want to install the extensions in your home directory (~/.inkscape/extensions/) also place a copy of inkex.py here

==== Problems on windows ====
On windows its not possible yet to open zink files. Saving to a zink file works. I'm trying to fix this but help is welcome

==== Problems on Mac OS X ====
The extensions do not work yet on the Mac OS X version. I don't exactly know why. Help is welcome.

==== Problems on other platforms ====
Please inform me about it.

==== Suggestions ====
If you have suggestions please mail them to the inkscape dev-mailing list.

ExtensionPackageHOWTO

2022-03-10T21:39:09Z

Pulsar17:

{{outdated}}

== Packages as Extensions: a HOWTO ==

This page will teach you how to create and distribute one or more extensions that rely on a package.

Start by creating a root folder to contain your package and extensions i.e. play-svg

You must make a package out of any modules you have. Add all of the modules into one folder inside the root directory i.e. play-svg/playsvg and create a package from those modules. If you do not know how to create a python package, follow the instrctions here: [http://www.network-theory.co.uk/docs/pytut/Packages.html].

Secondly, you must create the necessary .inx descriptor and .py Effect object that use your package. Make sure to use the full path name when importing into your Effect object file i.e. Place the .inx and .py files for the extensions in a folder inside the root folder

<pre>
import playsvg.path
OR
from playsvg import path
OR
from playsvg.path import *
</pre>

Use python distutils to create a setup.py script that will install your package onto the users system so that the libraries will always be available to python regardless of your current working directory. The setup script should reside in the root folder, in this case play-svg/ The user documentation of python distutils [http://docs.python.org/dist/ here].

An example of a setup.py script here
<pre>
#!/usr/bin/env python
from distutils.core import setup
import os
import glob
dataFiles = []
if os.name == "posix":
print "Inkscape extensions will be automatically installed on this Linux-based system"
dataFiles.append(("/usr/share/inkscape/extensions/", [i for i in glob.glob(os.path.join("inkex", "*.*"))] ))
else:
print "You are not running Linux, therefore you must install Inkscape extensions manually by copying files in the inkex directory to the Inkscape extensions directory on your system"
setup(name='playsvg',
version='0.2',
description='playsvg: making graphical programming as easy as py',
author='playful_geometr',
author_email='justinbarca@gmail.com',
url='http://sourceforge.net/projects/play-svg/',
packages=['playsvg'],
data_files=dataFiles
)
</pre>

This setup script will install the python libraries onto your system. It will also install the Inkscape extensions, but only for Linux systems. Help is needed to figure out how to discover where the extensions reside in other operating systems, particularly Windows and MacOSX. Users of Windows and MacOSX will have to manually move .inx and .py extensions files to the required directory.

An example of a MANIFEST.in file here:
<pre>
include *.txt
recursive-include inkex *.inx *.py
recursive-include scripts *.py
</pre>

Editing this file is required to ensure that all of the files that are not a part of the package you create will be copied into your distribution. In this case, the scripts folder contains a set of example scripts that use the package modules, extraneous to the installation of the extension(s) but useful to developers that might use the libraries in their own python coding.

These examples for creating a sdist of your python code were taken from [http://sourceforge.net/projects/play-svg pLAySVG], a set of libraries for the generation and manipulation of SVG in a simple Object-Oriented fashion. You can take a look at the code for a full example of a distributed Inkscape extension based on a package.

To create a distribution, a compressed file containing all of the files for your extension, including the setup script, go to a terminal, change the working directory to be the root folder, and then type:
<pre>python setup.py sdist --formats zip,gztar</pre>

This will create both a .zip and .gz file containing all of the code needed to install your extensions.

From there, the user needs to extract the files in the archive, run the setup script in the root directory like such
<pre>python setup.py install</pre>
and, if they're not using Linux, move all of the files in the inkex directory to the necessary Inkscape extensions folder.

Voila, there you have it, distributing Inkscape extensions as packages is as easy as py...

Generating objects from extensions

2022-03-10T21:33:38Z

Pulsar17: Mark page as outdated.

{{outdated}}
If you need an extension to generate an object in Inkscape, there are many tools that already exist to help you. <tt>inkex.py</tt> is the most notable, as this provides the routines to insert the SVG element into the XML tree of the SVG document, for more info on these is available at [[Python modules for extensions]].

There is currently no universal set of tools to allow a single function to be called, because different extension have different attibutes for thir objects. For example, the barcode extension merely needs a black rectangle with no stroke, but another may need a way to set the stroke width, dashes and opacity. Thus, it is often best to write your own subroutine for generating your objects.

==A simple example==
Let's look at a simple Python function for drawing a black rectangle:
<pre>
#SVG element generation routine
def draw_SVG_square((w,h), (x,y), parent):

style = { 'stroke' : 'none',
'stroke-width' : '1',
'fill' : '#000000'
}

attribs = {
'style' : simplestyle.formatStyle(style),
'height' : str(h),
'width' : str(w),
'x' : str(x),
'y' : str(y)
}
circ = inkex.etree.SubElement(parent, inkex.addNS('rect','svg'), attribs )
</pre>

The first thing to notice is that all the attributes of the object are stored in a dictionary format, with everything being a string. This means you have to convert all your parameters to strings if appropriate (like the <tt>height</tt> and <tt>width</tt> attributes).

Next, all the style attributes (colours, widths, fonts, etc) are put together in SVG under <tt>style</tt>. To generate this string, there exists a helper function <tt>simplestyle.formatStyle()</tt>. You simply feed this function a dictionary of the styles you want, just like the attributes. You can then use this directly as the style attribute.

The next thing to see is how to add the element to the XML tree. <tt>inkex.py</tt> has the function to do this using the LXML parser. This needs to be given the "parent" of the object (we'll come back to this), the "type" of the object, and the attributes of the object.

The type of the object is in the <tt>svg</tt> namespace, which means it begins <tt>svg:</tt> (for a rectangle, it is <tt>svg:rect</tt>). LXML cannot parse colons, so we use the <tt>inkex.addNS</tt> to prepend the namespace.

The attributes of the object just needs to be passed the dictionary <tt>attribs</tt> we made earlier.

The "parent" of the object is the containing element. This is usually a group or a layer. This will be passed in by the calling function, and we will see it in action later.

When this function is run with the right parameters, the rectangle will be added to the SVG document.

==Getting the parent==

Finding the parent is easy: you can just pass in the current layer from the <tt>self</tt> object if you like:
<pre><nowiki>
parent = self.current_layer
draw_SVG_square((1,1), (0,0), parent)
</nowiki></pre>

This will just plonk the rectangle into the document, centred on the origin.

Alternatively, you can create a group much like any other object:
<pre><nowiki>
centre = self.view_center #Put in in the centre of the current view
grp_transform = 'translate' + str( centre )

grp_name = 'Group Name'
grp_attribs = {inkex.addNS('label','inkscape'):grp_name,
'transform':grp_transform }
grp = inkex.etree.SubElement(self.current_layer, 'g', grp_attribs)#the group to put everything in
</nowiki></pre>

By the way, any object can be assigned a name as we did there, which is often helpful when generating many objects:

<pre><nowiki>
inkex.addNS('label','inkscape') : name
</nowiki></pre>

By setting the transform as <tt>self.view_center</tt>, we made sure the origin of the group is in the centre of the current view of the document. We will come back to transforms later.

The <tt>grp</tt> object can now be used as a parent for the rectangle:
<pre><nowiki>
draw_SVG_square((1,1), (0,0), grp)
</nowiki></pre>
This will draw a 1×1 black square in the center of the view.

==Transforms==

It is easy to transform an object: just supply a string like the folllowing as the <tt>transform</tt> attribute of the element:
*<tt>trans = 'translate(10,10)'</tt>
*<tt>trans = 'translate(10,10) rotate(10)'</tt>
*<tt>trans = 'skewX(-1)'</tt>

Available commands: <tt>translate, scale, rotate, skewX, skewY, matrix</tt>. The transforms are composed in left-right order (i.e. the translate comes first in the second example).

==More Examples==

===Ellipses===

Ellipses are actually path elements, but Inkscape generates the nodes automatically if you feed it the correct attributes in the Sodipodi namespace. The vital ones are <tt>rx, ry, cx, cy</tt>.

Ellipses require some attributes in the <tt>sodipodi:</tt> namespace, so we also use the <tt>addNS()</tt> function in the attribute dictionary:

<pre><nowiki>
def draw_SVG_ellipse((rx, ry), (cx, cy), parent, start_end=0,2*pi),transform='' ):

style = { 'stroke' : '#000000',
'stroke-width' : '1',
'fill' : 'none' }
ell_attribs = {'style':simplestyle.formatStyle(style),
inkex.addNS('cx','sodipodi') :str(cx),
inkex.addNS('cy','sodipodi') :str(cy),
inkex.addNS('rx','sodipodi') :str(rx),
inkex.addNS('ry','sodipodi') :str(ry),
inkex.addNS('start','sodipodi') :str(start_end[0]),
inkex.addNS('end','sodipodi') :str(start_end[1]),
inkex.addNS('open','sodipodi') :'true', #all ellipse sectors we will draw are open
inkex.addNS('type','sodipodi') :'arc',
'transform' :transform

}
ell = inkex.etree.SubElement(parent, inkex.addNS('path','svg'), ell_attribs )
</nowiki></pre>

This will draw an open arc, with a black stroke of width 1 and no fill. The transform here can be passed in from outside.

If in doubt about the right attribute name and format, just check a similar object in the XML viewer in Inkscape.

===Line Segment ===

Paths can be quite tricky to get the hang of if you don't know the meaning of the letters. Read the SVG specification for a full list.

Here, the style information has been passed in from outside the function.

<pre><nowiki>
#draw an SVG line segment between the given (raw) points
def draw_SVG_line( (x1, y1), (x2, y2), style, name, parent):
line_style = { 'stroke': style.l_col,
'stroke-width':str(style.l_th),
'fill': style.l_fill
}

line_attribs = {'style' : simplestyle.formatStyle(line_style),
inkex.addNS('label','inkscape') : name,
'd' : 'M '+str(x1)+','+str(y1)+' L '+str(x2)+','+str(y2)}

line = inkex.etree.SubElement(parent, inkex.addNS('path','svg'), line_attribs )
</nowiki></pre>

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

Notes On Units Handling in Extensions in 0.91

2022-03-10T21:19:28Z

Pulsar17: Prevent search engines from indexing this page.

Since the release of Inkscape 0.48.4 there has been a fundamental change made in the scaling of length variables in Inkscape. The [http://www.w3.org/TR/SVG11/coords.html#ViewBoxAttribute <code>viewBox</code>] attribute has been introduced as a standard feature of all files, and its size is determined by the units that are chosen for the variable <code>inkscape:document-units</code> (see dialog ''Document Properties: Default Units''). In the Python extensions this has led to the requirement that units of length variables must be explicitly taken into account, otherwise they will not scale correctly when changing the ''Default Units'' (see [https://bugs.launchpad.net/inkscape/+bug/1240455 Bug 1240455]). Previously this type of scaling was done with a call to <code>inkex.unittouu()</code>, the new syntax for this call is <code>self.unittouu()</code>. Attached is a list of situations in which you may need to do this type of scaling, to convert to document units:

# When reading the document height/width (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/dxf_outlines.py dxf_outlines.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/dxf_outlines.py r12722])
# When reading any .inx file input variable that has units of length (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/grid_cartesian.py grid_cartesian.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13007#share/extensions/grid_cartesian.py r13007])
# When specifying a stroke-width or font-size in a style attribute (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/split.py split.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/split.py r12722]; [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/render_gears.py render_gears.py] [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/render_gears.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13001#share/extensions/render_gears.py r13001], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13036#share/extensions/render_gears.py r13036])
# For multiple items in a group, it may be more efficient to scale the group with a transform, rather than scaling individual objects (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/render_barcode.py render_barcode.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13015#share/extensions/render_barcode.py r13015]).
# Remember that console commands like <code>inkscape --query-all</code>, to query the bbox, return pixels regardless of the document units, so they will need to be converted (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/dimension.py dimension.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13028#share/extensions/dimension.py r13028]).
# Remember that guides, which are in the <code>sodipodi:namedview</code> section, are not affected by document units, so they do not need to be scaled (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/guides_creator.py guides_creator.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/guides_creator.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13007#share/extensions/guides_creator.py r13007]).
# If you are creating new classes unique to your application, you may need to provide a mechanism to allow your new class to continue to access <code>unittouu()</code> (see [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/view/head:/share/extensions/ink2canvas.py ink2canvas.py], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/12722#share/extensions/ink2canvas.py r12722], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/revision/13027#share/extensions/ink2canvas.py r13027]).

----
Original version of the notes by Alvin Penner: [https://bugs.launchpad.net/inkscape/+bug/1240455/+attachment/4041646/+files/scaling.txt scaling.txt] (see comments 31-34 in [https://bugs.launchpad.net/inkscape/+bug/1240455 Bug 1240455])

[[Category:Extensions]]
__NOINDEX__

Python modules for extensions

2022-03-10T20:58:23Z

Pulsar17: Move documentation.

[[Category:Extensions]]

The API documentation for inkex has been moved to the [https://inkscape.gitlab.io/extensions/documentation/source/index.html documentation of the extensions repository.]

Tips For Python Script Extensions

2022-03-10T20:50:35Z

Pulsar17: Move documentation.

The documentation for writing new extensions has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/index.html documentation of the extensions repository.]

Extensions

2022-03-10T20:42:56Z

Pulsar17: Move documentation.

The documentation for writing new extensions has been moved to the [https://inkscape.gitlab.io/extensions/documentation/authors/index.html documentation of the extensions repository.]

Tracking Dependencies

2022-03-09T17:41:31Z

Pulsar17: Clarify the rules regarding distro support and provide an example.

== Compilers ==

Version 1.0 requires a C++11 compiler.
Version 1.1 requires a C++17 compiler.

See [[c++11]] and [[c++17]].

== Libs ==

C++ bindings are not included, since their required versions match those of the C counterparts.

{| class="wikitable"
|-
! Library
! v 0.92
! v 1.0
! v 1.1
! v 1.2
! master
|-
| Boehm-GC
| 7.2
| 7.2
| 7.2
|
|
|-
| Cairo
| 1.14
| 1.14 (1.15.4 required for PDF links)
| 1.16*
| 1.16
| 1.16
|-
| double-conversion [https://github.com/google/double-conversion]<br/>''(lib2geom dependency)''
| ''(not required)''
| any
|
|
|
|-
| FreeType
|
|
| 2.9* (Required for Variable fonts)
| 2.9
| 2.9
|-
| GDL
| N/A<br />(3.4)
| 3.4
| Not Used
| Not Used
|-
| Glib
| 2.28
| 2.48
| 2.56 or 2.62*
| 2.64
| 2.64
|-
| GTK+
| 2.24<br />(3.8)
| 3.22
| 3.24*
| 3.24
| 3.24
|-
| GNU Scientific Library
| ?
| ?
|
|
|
|-
| HarfBuzz
| ?
| ?
| 2.2*
| 2.6
| 2.6
|-
| libsigc++
| ''2.0.12*''
| ''2.0.12*''
| ''2.0.12*''
|
|-
| libSoup
| ''(not required)''
| (any)
|
|
|
|-
| libpotrace
| ''(not required)''
| (any)
|
|
|
|-
| libxml
| ''2.6.11*''
| ''2.6.11*''
|
|
|
|-
| libxslt
| ''1.0.15*''
| ''1.0.15*''
|
|
|
|-
| lcms
| 1.13
| 2.2
| 2.2 (2.9*)
| 2.9*
| 2.9*
|-
| Pango
| 1.24
| 1.24 (1.41.1 required for variable fonts)
| 1.42*
| 1.44
| 1.44 (HarfBuzz shaping)
|-
| Poppler
| 0.20.0
| 0.20.0
| 0.29 (0.71*)
| 0.29 (0.71*)
| 0.71*
|-
| [https://formulae.brew.sh/formula/gtk-mac-integration gtk-mac-integration]<br>[https://www.macports.org/ports.php?by=library&substr=gtk-osx-application-gtk3 gtk-osx-application-gtk3]
| N/A
| 2.0.8 ([[CompilingMacOsX|macOS only]])
|
|
|
|}

''* Tentative dependency''

* Pango 1.42.2 requires Harfbuzz 1.4.2
* Pango 1.44.0 requires Glib 2.59.2 and Harfbuzz 2.0. 1.44 exposes hb_font directly.
* Pango 1.45.1 requires Glib 2.60
* Pango 1.48.4 has vertical upright marks fix.

== Distros ==

Note: This table is not relevant to (non-fink) MacOS X, where we ship the desired version with Inkscape.

"Inkscape" column is default or distro version / oldest that builds - latest that builds. If no latest is given then that means trunk is expected to build on the given platform.

e.g. for a distro that ships with 0.48 but should support building of trunk you might get:
0.48 / 0.47-

'''General rules:'''
* Support latest Debian Stable (as of feature freeze) [https://www.debian.org/distrib/packages Debian packages]
* Support latest Ubuntu LTS (as of feature freeze) [https://packages.ubuntu.com/ Ubuntu packages]
**e.g. Considering Inkscape 1.2, the latest Ubuntu LTS at '''feature freeze time''' (around February 2022) would have been Ubuntu 20.04. The latest LTS at release time (around May 2022), though, will be Ubuntu 22.04. Therefore, according to the rule, we should support Ubuntu 20.04 LTS as the minimum version.
* Support last CentOS/Redhat (as best effort).
* Support last two Fedora releases (as of feature freeze) [https://packages.fedoraproject.org/ Fedora packages]
* Don't break ''point'' releases.

{| class="wikitable"
|-
! Distro
! Inkscape
! gcc
! clang
! cairo
! cairomm
! freetype
! glib
! glibmm
! gtk+
! gtkmm
! harfbuzz
! pango
! poppler
! gdl
! lcms2
! libsigc++
! libgc 
! libsoup
|-
| Windows MSYS2 (2021-04-14)<br/>([https://github.com/Alexpux/MINGW-packages mingw-w64 packages] from MSYS2 project)

| 1.0.2
| 10.2.0
| 11.0.0
| 1.17.4
| 1.12.2
| 2.10.4
| 2.68.1
| 2.66.0
| 3.24.27
| 3.24.3
| 2.8.0
| 1.48.4
| 20.12.1
| 3.34.0
| 2.12
| 2.10.6
| 8.0.4 
| 2.72.0
|-
| Debian 10 (Buster, <i>oldstable</i>) <small>EOL 2024-06</small>
| 0.92.4 (1.0.2)
| 8.3.0
| 7.0
| 1.16
| 1.12.2
| 2.9.1
| 2.58.3
| 2.58.0
| 2.24.32<br />3.24.5
| 2.24.5<br />3.24.0
| 2.3.1
| 1.42.4
| 0.71.0
| 3.28.0
| 2.9
| 2.10.1
| 7.6.4
| 2.64.2
|-
| Debian 11 (Bullseye, stable) <small>EOL 2026</small>
| 1.0.2
| 10.2.1
| 11.0
| 1.16
| 1.12.2
| 2.10.4
| 2.66.8
| 2.64.2
| 3.24.24
| 3.24.2
| 2.7.4
| 1.46.2
| 20.09.0
| 3.34.0
| 2.12
| 2.10.4
| 8.0.4
| 2.72.0
|-
| style="background:Violet;"|(RHEL) / CentOS 8.1 <small>EOFS 2024-05</small><br/>Based on Centros 8.1 package list
| 0.92.3
| 8.3.1
| 8.0.1
| 1.15.12
| 1.12.0
| 2.8.14
| 2.56.4
| 2.56.0
| 2.24.32<br />3.22.30
| 2.24.5<br />3.22.2
| 1.7.5
| 1.42.4
| 0.66.0
| style="background:Violet;"|?
| 2.9
| 2.10.0
| 7.6.4
| 2.62.3
|-
| Ubuntu 20.04 LTS (Focal Fossa) <small>EOL 2025-04</small>
| 0.92.5
| 10
| 10
| 1.16
| 1.12.2
| 2.10.1
| 2.64.1
| 2.64.2
| 2.24.32<br />3.24.17
| 2.24.5<br />3.24.2
| 2.6.4
| 1.44.7
| 0.86.1
| 3.34.0
| 2.9.4
| 2.10.2
| 10
| 2.70.0
|}

{| class="wikitable"
|-
! Legend
|-
| style="background:Orange;"| Inkscape 1.0.x unsupported
|-
| style="background:Violet;"| GTK+ 3 builds unsupported
|}

* Agreed to at Saarbrücken hackfest.

== Getting and Installing Source packages ==

See [https://inkscape.org/develop/getting-started/ Getting Started]

== Optional Dependencies ==

Inkscape will still compile without these, but some features may be missing if they are absent during compilation:

{| class="wikitable"
|-
! scope="col"| Library
! scope="col"| Needed for
! scope="col"| Default
|-
|aspell
|Dictionaries for spell checking
|On
|-
|libcdr
|Open Corel Draw files
|On
|-
|gettext/msgformat
|Translation support
|On
|-
|gtest/gmock
|Automatted testing
|Off
|-
|gspell
|Spell checking
|On
|-
|imagemagick
|Bitmap editing extensions, bitmap import resolution
|On
|-
|jpeg
|jpeg import?
|On
|-
|OpenMP
|Multi-threaded filter rendering
|On
|-
|scour
|Save as Optimized SVG
|(not needed during compiling, Python)
|-
|libvisio
|Open Visio Files, use Visio stencils
|On
|-
|libwpg
|Open WordPerfect Graphics
|On
|-
|}

[[Category:About Inkscape]]
[[Category:Developer Documentation]]