Inkscape Wiki - User contributions [en]

Release notes/1.1

2020-05-10T16:32:29Z

LiamW: /* Automatic fill preservation for LPEs */

{{Other languages | en = {{FULLPAGENAME}}}}

== Release highlights ==

'''Definitely not released yet.'''

Inkscape 1.1 is a stability and bugfix release.

[For changes made even before the 1.0 release that aren't in 1.0, try to find out if the checked and not stroked ones here: https://gitlab.com/inkscape/inkscape/-/issues/1030 have really not been cherrypicked]

The most notable improvements are:

* Fill in

== Important changes ==

* For packagers: we do not depend on GtkSpell and ASpell but on GSpell for spelling checks.

== Improvements ==

* In Edit > Preferences > Imported images : Import, there is a new option that allows you to disable relative paths to linked files ("Store absolute file path for linked images", active by default).
* [https://en.wikipedia.org/wiki/XInclude XInclude] support
* Hidden dialogs stop receiving signals and release resources
* Shell mode: a history of commands is now remembered and can be accessed with the up and down arrow keys. [Tab ... autocompletion?]

=== Rotation lock ===

A new menu item has been added to allow the user to prevent the rotation of the canvas with key bindings commonly associated with zooming in other applications. This setting can be toggled on a per-window basis. In addition, a new preference option has been added to allow users to set the mode to be on when a new window is opened.

<gallery mode="packed" heights=350px>
File:Canvas rotation lock toggle.png|New "Rotation lock" menu item
File:Default rotation lock toggle.png|Configuration option to lock the rotation by default
</gallery>

=== Taper stroke improvements ===

The Taper stroke LPE has been updated to include taper direction options (allowing the taper to run to one side of the path, instead of to the middle) and smoothing options for both ends of the path, allowing more interesting paths to be made in the effect. In addition, using the keybind '''Shift+click''' on the on-canvas knots allows quickly alternating between the different possible taper shapes.

<gallery mode="packed" heights=350px>
File:Taper stroke direction control.png|Direction control options
File:Taper stroke new parameter list.png|New parameter list
</gallery>

=== Automatic fill preservation for LPEs ===

LPEs which render strokes as fills (Join type, Power stroke, and Taper stroke) have been modified to automatically preserve the previous fill by creating a linked path when applied to an object.

<gallery mode="packed" heights=350px>
File:Sadchrys original drawing with fill.png|Original drawing
</gallery>

<gallery mode="packed" heights=350px>
File:Sadchrys after applying LPE previous versions.png|Previous versions of Inkscape would preserve the stroke settings but remove the fill when applied.
</gallery>

<gallery mode="packed" heights=350px>
File:Sadchrys after applying LPE 1.1 original path.png|Now, Inkscape will automatically preserve the fill by creating a linked path underneath.
File:Sadchrys after applying LPE 1.1 linked fill.png|LPE options for the linked fill
</gallery>

=== New shortcut for Fill between many LPE ===

A new shortcut has been added under the Path menu to automatically create a linked fill path using the '''Fill between many''' path effect. The effect is created beneath the selected paths and automatically selected to faciliate moving the path into the correct z-order and styling it as intended. For greater efficiency, the shortcut can also be bound to a hotkey using the '''Preferences''' dialog.

<gallery mode="packed" heights=350px>
File:Fill between many shortcut menuitem.png|Previously, using this effect required tediously copying every path to the clipboard and pasting it into the parameter list of a new path.
File:Fill between many result.png|Now, Inkscape can perform this task automatically, without any tedium.
</gallery>



== Notable bugfixes ==

* Fill in

== Crash fixes ==

Fix a crash …
* … when ... ([https://gitlab.com/inkscape/inkscape/issues/ #number])

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

== Translations ==

The following UI translations received updates:

* Language

The following documentation translations received updates:

* Language

=== Contributing to interface translations ===

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

== Documentation ==

* Some missing options were added to the man page (command line help)
* Some missing keyboard shortcuts were added to the keyboard shortcut reference

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

== Known issues ==

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

== Previous releases ==
* [[Release notes/0.92]]
* [[Release notes/0.92.1]]
* [[Release notes/0.92.2]]
* [[Release notes/0.92.3]]
* [[Release notes/0.92.4]]
* [[Release notes/0.92.5]]
* [[Release notes/1.0]]

File:Sadchrys after applying LPE 1.1 linked fill.png

2020-05-10T16:31:03Z

LiamW:

File:Sadchrys after applying LPE 1.1 original path.png

2020-05-10T16:30:33Z

LiamW:

File:Sadchrys after applying LPE previous versions.png

2020-05-10T16:30:02Z

LiamW:

File:Sadchrys original drawing with fill.png

2020-05-10T16:29:29Z

LiamW:

Release notes/1.1

2020-05-10T16:20:49Z

LiamW: minor correction

{{Other languages | en = {{FULLPAGENAME}}}}

== Release highlights ==

'''Definitely not released yet.'''

Inkscape 1.1 is a stability and bugfix release.

[For changes made even before the 1.0 release that aren't in 1.0, try to find out if the checked and not stroked ones here: https://gitlab.com/inkscape/inkscape/-/issues/1030 have really not been cherrypicked]

The most notable improvements are:

* Fill in

== Important changes ==

* For packagers: we do not depend on GtkSpell and ASpell but on GSpell for spelling checks.

== Improvements ==

* In Edit > Preferences > Imported images : Import, there is a new option that allows you to disable relative paths to linked files ("Store absolute file path for linked images", active by default).
* [https://en.wikipedia.org/wiki/XInclude XInclude] support
* Hidden dialogs stop receiving signals and release resources
* Shell mode: a history of commands is now remembered and can be accessed with the up and down arrow keys. [Tab ... autocompletion?]

=== Rotation lock ===

A new menu item has been added to allow the user to prevent the rotation of the canvas with key bindings commonly associated with zooming in other applications. This setting can be toggled on a per-window basis. In addition, a new preference option has been added to allow users to set the mode to be on when a new window is opened.

<gallery mode="packed" heights=350px>
File:Canvas rotation lock toggle.png|New "Rotation lock" menu item
File:Default rotation lock toggle.png|Configuration option to lock the rotation by default
</gallery>

=== Taper stroke improvements ===

The Taper stroke LPE has been updated to include taper direction options (allowing the taper to run to one side of the path, instead of to the middle) and smoothing options for both ends of the path, allowing more interesting paths to be made in the effect. In addition, using the keybind '''Shift+click''' on the on-canvas knots allows quickly alternating between the different possible taper shapes.

<gallery mode="packed" heights=350px>
File:Taper stroke direction control.png|Direction control options
File:Taper stroke new parameter list.png|New parameter list
</gallery>

=== Automatic fill preservation for LPEs ===

LPEs which render strokes as fills (Join type, Power stroke, and Taper stroke) have been modified to automatically preserve the previous fill by creating a linked path when applied to an object.

<gallery mode="packed" heights=350px>
File:Join type fill removed.png|Previous versions of Inkscape would preserve the stroke settings but remove the fill when applied.
</gallery>

<gallery mode="packed" heights=350px>
File:Join type fill preserved.png|Now, Inkscape will automatically preserve the fill by creating a linked path underneath.
</gallery>

=== New shortcut for Fill between many LPE ===

A new shortcut has been added under the Path menu to automatically create a linked fill path using the '''Fill between many''' path effect. The effect is created beneath the selected paths and automatically selected to faciliate moving the path into the correct z-order and styling it as intended. For greater efficiency, the shortcut can also be bound to a hotkey using the '''Preferences''' dialog.

<gallery mode="packed" heights=350px>
File:Fill between many shortcut menuitem.png|Previously, using this effect required tediously copying every path to the clipboard and pasting it into the parameter list of a new path.
File:Fill between many result.png|Now, Inkscape can perform this task automatically, without any tedium.
</gallery>



== Notable bugfixes ==

* Fill in

== Crash fixes ==

Fix a crash …
* … when ... ([https://gitlab.com/inkscape/inkscape/issues/ #number])

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

== Translations ==

The following UI translations received updates:

* Language

The following documentation translations received updates:

* Language

=== Contributing to interface translations ===

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

== Documentation ==

* Some missing options were added to the man page (command line help)
* Some missing keyboard shortcuts were added to the keyboard shortcut reference

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

== Known issues ==

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

== Previous releases ==
* [[Release notes/0.92]]
* [[Release notes/0.92.1]]
* [[Release notes/0.92.2]]
* [[Release notes/0.92.3]]
* [[Release notes/0.92.4]]
* [[Release notes/0.92.5]]
* [[Release notes/1.0]]

Release notes/1.1

2020-05-10T16:19:56Z

LiamW: Workflow improvements changes

{{Other languages | en = {{FULLPAGENAME}}}}

== Release highlights ==

'''Definitely not released yet.'''

Inkscape 1.1 is a stability and bugfix release.

[For changes made even before the 1.0 release that aren't in 1.0, try to find out if the checked and not stroked ones here: https://gitlab.com/inkscape/inkscape/-/issues/1030 have really not been cherrypicked]

The most notable improvements are:

* Fill in

== Important changes ==

* For packagers: we do not depend on GtkSpell and ASpell but on GSpell for spelling checks.

== Improvements ==

* In Edit > Preferences > Imported images : Import, there is a new option that allows you to disable relative paths to linked files ("Store absolute file path for linked images", active by default).
* [https://en.wikipedia.org/wiki/XInclude XInclude] support
* Hidden dialogs stop receiving signals and release resources
* Shell mode: a history of commands is now remembered and can be accessed with the up and down arrow keys. [Tab ... autocompletion?]

=== Rotation lock ===

A new menu item has been added to allow the user to prevent the rotation of the canvas with key bindings commonly associated with zooming in other applications. This setting can be toggled on a per-window basis. In addition, a new preference option has been added to allow users to set the mode to be on when a new window is opened.

<gallery mode="packed" heights=350px>
File:Canvas rotation lock toggle.png|New "Rotation lock" menu item
File:Default rotation lock toggle.png|Configuration option to lock the rotation by default
</gallery>

=== Taper stroke improvements ===

The Taper stroke LPE has been updated to include taper direction options (allowing the taper to run to one side of the path, instead of to the middle) and smoothing options for both ends of the path, allowing more interesting paths to be made in the effect. In addition, using the keybind '''Shift+click''' on the on-canvas knots allows quickly alternating between the different possible taper shapes.

<gallery mode="packed" heights=350px>
File:Taper stroke direction control.png|Direction control options
File:Taper stroke new parameter list.png|New parameter list
</gallery>

=== Automatic fill preservation for LPEs ===

LPEs which render strokes as fills (Join type, Power stroke, and Taper stroke) have been modified to automatically preserve the previous fill by creating a linked path when applied to an object.

<gallery mode="packed" heights=350px>
File:Join type fill removed.png|Previous versions of Inkscape would preserve the stroke settings but remove the fill when applied.
</gallery>

<gallery mode="packed" heights=350px>
File:Join type fill preserved.png|Now, Inkscape will automatically preserve the fill by creating a linked path underneath.
</gallery>

=== New shortcut for Fill between many LPE ===

A new shortcut has been added under the Path menu to automatically create a linked fill path using the '''Fill between many path''' effect. The effect is created beneath the selected paths and automatically selected to faciliate moving the path into the correct z-order and styling it as intended. For greater efficiency, the shortcut can also be bound to a hotkey using the '''Preferences''' dialog.

<gallery mode="packed" heights=350px>
File:Fill between many shortcut menuitem.png|Previously, using this effect required tediously copying every path to the clipboard and pasting it into the parameter list of a new path.
File:Fill between many result.png|Now, Inkscape can perform this task automatically, without any tedium.
</gallery>



== Notable bugfixes ==

* Fill in

== Crash fixes ==

Fix a crash …
* … when ... ([https://gitlab.com/inkscape/inkscape/issues/ #number])

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

== Translations ==

The following UI translations received updates:

* Language

The following documentation translations received updates:

* Language

=== Contributing to interface translations ===

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

== Documentation ==

* Some missing options were added to the man page (command line help)
* Some missing keyboard shortcuts were added to the keyboard shortcut reference

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

== Known issues ==

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

== Previous releases ==
* [[Release notes/0.92]]
* [[Release notes/0.92.1]]
* [[Release notes/0.92.2]]
* [[Release notes/0.92.3]]
* [[Release notes/0.92.4]]
* [[Release notes/0.92.5]]
* [[Release notes/1.0]]

File:Fill between many result.png

2020-05-10T16:16:16Z

LiamW: Shows the result of applying the Fill between paths menu item to selected paths.

== Summary ==
Shows the result of applying the Fill between paths menu item to selected paths.

File:Fill between many shortcut menuitem.png

2020-05-10T16:15:39Z

LiamW: Shows new fill shortcut in Path menu

== Summary ==
Shows new fill shortcut in Path menu

File:Taper stroke new parameter list.png

2020-05-10T16:05:20Z

LiamW:

File:Default rotation lock toggle.png

2020-05-10T15:59:30Z

LiamW: Shows the default rotation lock toggle in the preferences menu.

== Summary ==
Shows the default rotation lock toggle in the preferences menu.

File:Canvas rotation lock toggle.png

2020-05-10T15:59:04Z

LiamW: Shows the new rotation lock toggle item in the menu.

== Summary ==
Shows the new rotation lock toggle item in the menu.

File:Join type fill preserved.png

2020-05-10T15:55:36Z

LiamW: Inkscape now recognizes and preserves the previous fill by creating a new path using the "Fill between many" path effect when any of the Join Type, Power stroke, and Taper stroke LPEs are applied to an object.

== Summary ==
Inkscape now recognizes and preserves the previous fill by creating a new path using the "Fill between many" path effect when any of the Join Type, Power stroke, and Taper stroke LPEs are applied to an object.

File:Join type fill removed.png

2020-05-10T15:51:48Z

LiamW: Shows how previous versions would remove the fill color of a path if the Join type path effect was applied to it.

== Summary ==
Shows how previous versions would remove the fill color of a path if the Join type path effect was applied to it.

File:Taper stroke direction control.png

2020-05-10T15:40:41Z

LiamW: New direction control of Taper stroke LPE for 1.1

== Summary ==
New direction control of Taper stroke LPE for 1.1

Development Project Ideas

2016-01-27T01:13:21Z

LiamW: Edit out some outdated stuff

==General==

* Improve startup time and initialization performance (i.e. improve font cache).
* Improve icon cache: Convert the icon cache (widgets/icon.cpp) to create the PNGs with a directory structure and index file matching the icon theme specification. Use this to get rid of customized classes InkAction, SPIcon, and so on.
* Continue C++ migration:
** Use Glib::ustring for UTF-8 data and std::string for filenames and raw byte strings instead of C-strings (char*).
** Replace uses of GList and GSList with STL containers.
* Extension system improvements: Refactor the extension API. Clean up the kludgy class hierarchy, possibly using multiple inheritance. Use GInputStream and GOutputStream as parameters instead of file paths, so that things like the clipboard can write data to memory without going through a temporary file.

== XML tree ==

* SAX parser: Convert the current document parser from DOM to SAX, so that it creates our XML tree right away, instead of creating the libxml2 DOM tree, creating our tree to match it, then freeing the libxml2 tree. This should improve performance and allow more robust fixes for some problems.
* Typed XML tree: Improve XML tree so that it can store some attributes in parsed, binary form. The main target of this are the data URIs used to embed images, which could be stored as binary data only. This work should be done after completing the SAX parser, as this will make it easier.

== 2Geom geometry library ==

** Investigate whether it is possible to store subpath data in a more compact way and make the Curve objects only convenience facades. Right now, if the path has only linear segments, every point is stored twice.
** Apply the following renames to match SVG terminology:
*** Path -> Subpath
*** PathVector -> Path
* Remove SPCurve: SPCurve is a thin wrapper around Geom::PathVector which exists for historical reasons. Its functionality should be added to PathVector, and SPCurve should be purged.
* Provide a quick bounding box routine for stroked paths.
* Boolean operations and stroking: Add methods to PathVector objects:
** Set operators (& | - ^), which perform the relevant boolean operation on the paths. Use the algorithm from CGAL or devise a new robust algorithm.
** <tt>stroke(double line_width, LineJoin join, LineCap cap, double miter_limit)</tt>, which performs the stroke-to-path operation.
** <tt>stroke(double line_width, LineJoin join, LineCap cap, double miter_limit, std::vector<double> const &dasharray)</tt>, which performs stroke-to-path with dashing.

== Object tree ==

* Improve the performance of layer visibility: Right now, toggling layer visibility causes massive changes in the display tree, because the entire toggled layer is invalidated at the XML level. This results in very bad performance for an action which should nearly instantaneous. Improve the control flow so that only the visibility of the object representing the layer is turned off, but the remainder of the display and object tree is leaved alone.
* Robust ID handling: Currently ID clash resolution is implemented as a giant switch over object types, listing every possible dependency. Replace this with virtual methods on objects, which provide information on what each object refers to. Improve behavior when a dependency of an object is deleted, and when IDs are changed / deleted from the XML editor.
* Replace the print functions in the SPxxx classes with a generic "Visitor" pattern and port at least one export type (e.g. EMF, PDF, PS) to the new routines.

== User interface ==
* Shape manipulators: The idea here is to rewrite shape tools in the same paradigm as the node tool. Instead of storing all information about the shape in knots which differ only by their callbacks, allow to store information in a higher-level manipulator object. This would enable things like dragging the side of a rectangle, consistent outlining / update preferences for all shapes, and editing more than one shape at once.
* [https://blueprints.launchpad.net/inkscape/+spec/transformation-anchors Transformation Anchors]
* Extend the Symbols dialog to include generic objects.
* [https://blueprints.launchpad.net/inkscape/+spec/inkscape-connectors Connector tool improvements] - Expose new libavoid functionality: orthogonal routing, connector ports, curved connectors. (Mentor: Michael Wybrow)
* [https://blueprints.launchpad.net/inkscape/+spec/fillet-tool Fillet/Chamfer tool]
* Provide more actions in the context menu depending on the content of the selection, e.g. show "Put on Path", "Flow into Frame" etc. when the selection contains the appropriate objects.
* When right-clicking a control point, show a transient dialog which would allow one to key in its coordinates.
* Provide a way to resize the page directly on the canvas, instead of keying in numbers in the Document Properties dialog.

== Project infrastructure and platform support ==

* Migrate argument parsing to GOption and remove the dependency on popt. Update the devlibs version of Glib to one where this bug is fixed: [https://bugzilla.gnome.org/show_bug.cgi?id=522131]. Once this is done, port argument parsing to GOption.
* Common build system for all platforms: Migrate the build system to CMake for all platforms and remove Autotools.
* GTK3 on Windows: Rebuild the Windows devlibs so that they contain GTK3. Make the Windows port work with them, possibly sending the appropriate patches to the GTK maintainers.

== Rendering Improvements ==

* [https://blueprints.launchpad.net/inkscape/+spec/icc-for-cairo ICC Color Management for cairo outputs] - Would allow Inkscape to produce CMYK PDFs and PSs with Cairo. 
* Box blur: Currently we always use a very accurate method to compute the Gaussian blur filter. Add an alternate method which approximates Gaussian blur using three stacked box blurs (simple averages). This is detailed in the SVG 1.1 SE specification.
* Pluggable renderers - allow writing rendering backends which use something other than Cairo, e.g, OpenGL, Skia, Mozilla Azure or GEGL.
* OpenGL renderer - implement an OpenGL 3.x+ canvas which would render Beziers using this method: http://http.developer.nvidia.com/GPUGems3/gpugems3_ch25.html Investigate whether this generalizes to S-basis and circular arcs. Since the described method does not handle stroking, this work depends on implementing boolean operations and stroking. Also check how OpenGL path rendering is implemented in Qt, since apparently the performance there is very good. http://zrusin.blogspot.com/2011/09/nv-path-rendering.html

== Better SVG standard coverage ==

* Full SVG viewbox support
* [[multipage | Multiple Page support]]
* Improve SVG compliance. [http://tavmjong.free.fr/INKSCAPE/W3C_SVG_1.1F2/harness/htmlInkscapeApproved/index.html Current status of W3C test suite compliance].

=== SVG 2 and CSS3 ===

See: [[SVG2]].

This includes providing suitable GUI and SVG 1.1 fallbacks.

* Filling and Stroking
** [http://www.w3.org/Graphics/SVG/WG/wiki/Proposals/Stroke_position Stroke position]
** [http://www.w3.org/Graphics/SVG/WG/wiki/Proposals/Stroke_dash_adjustment Stroke dash adjustment]
** [https://svgwg.org/svg2-draft/painting.html#SpecifyingPaint Multiple fills]
** [https://svgwg.org/svg2-draft/painting.html#PaintOrder Paint order] (Rendering alread implemented, needs GUI and fallback.)
** Marker color matching stroke.
** Vector Effects (non-destructive boolean-ops would be a good start)
** [http://www.w3.org/TR/css3-color/ CSS3 color support]
** [http://dev.w3.org/fxtf/compositing-1/ CSS3 blend modes]

* Paint servers
** [https://svgwg.org/svg2-draft/pservers.html#SolidColors Solid-color support] (Named colors, would deprecate the single-stop gradient approach we currently use)
** [https://svgwg.org/svg2-draft/pservers.html#MeshGradients Mesh gradient] (Basic implementation done, needs refinement and fallback.)
** [https://svgwg.org/svg2-draft/pservers.html#Hatches Hatched patterns]

* Text
** [https://svgwg.org/svg2-draft/text.html CSS based text flow]

* Misc
** [http://www.w3.org/TR/css3-transforms/ CSS3 2d and 3d transforms]

Note: Some of the above items are somewhat low hanging fruit and would need a few of them to make a good proposal, others alone are worthy of a full GSoC project.

=== Improve Inkscape SVG for use on Web ===

A proposal should fix most if not all of these problems:

* Fix "plain" SVG to not remove <script> section, etc.
* Add option to set viewbox attribute to Document Properties.
* Easily add/edit hyperlinks.
* Better CSS support.
* Option to add title to SVG (searchability and accessibility).
* Remove XML prolog/DOCTYPE.
* Move sodipodi namespace items to Inkscape namespace.

== Improved Eraser tool ==
[[File:Cuttool.png|200px|thumb|right|Example of result of the cut/eraser tool]]
The '''Eraser tool''' has some limitations in cut-out from objects mode:

* There is a minimum width of 1 unit in the line to cut, thus the resulting parts don't fit exactly (1 unit gap minimum).
* This mode does not work with groups.
* The cut is not constrained: no straight or parallel modes.

The goal is make an optional to produce a zero width cut that solves the above problems.<br />
There are new Boolean operations, implemented but not used in trunk. We need to switch the division method from Livarot to these new operations.<br />
Another feature interesting is a button to get the guides over the selected item and use it as cut-out.<br />
We can make optional check to convert strokes to path previously to cut to avoid continuing with stroke thought cut-out item fills.<br />

== Live Path Effects related ==

* [https://blueprints.launchpad.net/inkscape/+spec/lpe-blueprint More Live Path Effects] - There is a lengthy list of ideas to choose from here.

== Import/export projects ==

* Importing of 3D scene files in 16 file formats using [http://assimp.sourceforge.net/ Open Asset Import Library]
* [https://blueprints.launchpad.net/inkscape/+spec/xar-to-svg-converter xar-to-svg converter] - Converter for Xara Xtreme to Inkscape
* [https://blueprints.launchpad.net/inkscape/+spec/kml-svg-translation KML SVG translation] - For use of Inkscape with Google Earth or Maps

== Generic ideas ==

* Font editing and creation features, e.g. [https://blueprints.launchpad.net/inkscape/+spec/designing-svg-fonts-using-styles designing SVG fonts using styles]
* [https://blueprints.launchpad.net/inkscape/+spec/kidscape-project kidscape] - Condensed version of Inkscape aimed at young kids and small form factor devices
* [https://blueprints.launchpad.net/inkscape/+spec/cutter-control Cutter control] - Enable Inkscape's use with vinyl cutters.

[[Category:Developer Documentation]]

Release notes/0.92

2014-11-02T20:24:50Z

LiamW: objects dialog

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

==Inkscape 0.92==

'''(definitely not released yet - [[AnnouncePlanning092]])'''

==Release highlights==

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

== Dialogs, etc. ==

=== Objects ===
Hierarchy of document
* Imported from Ponyscape
* Includes individual objects as well as layers
* Allows changing of highlight color of objects
* Drag and drop reordering of objects
* Find, lock, and hide individual items

=== Selection Sets ===
Create selection sets that are not affected document structure
=== Live Path Effects ===
==== Spiro Live ====
----
Extended video: <https://www.youtube.com/watch?v=bFakiI5f0-Y>

Based in Spiro Live Path Effect, now show result while drawing.
* Nodes '''cusp''' (SHIFT) and '''Spiro'''.
* Handle append path on cusp and Spiro mode whith helper preview path.
[[File:Spirolive.gif]]

==== BSpline ====
----
Extended video <https://www.youtube.com/watch?v=vwV0DHvA-OE>
=====Pen & Node mode=====
Use '''BSpline Live Effect''' while creating and editing paths.
* Pen and Pencil use
* Modes '''cusp'''(SHIFT) and '''BSpline''' while drawing.
* Handle append parhs with preview helper path.
* Handle '''weight''' of bspline (node tool) with handle movement. SHIFT key required.
* Handle custom '''weight snaps''' with '''CTRL'''

[[File:Bspline.gif]] [[File:Bspline2.gif]]

=====Live Path Effect mode=====
[[File:Bspline3.gif|170px|right|thumb]]
The options in the Live effect dialog give you control on bspline paths.
* Set to '''Default weight''' (0.3334 time of his curve segment).
* '''Make cusp''' nodes.
* Numeric input for '''weight'''.
* '''Steps with CONTROL''' snaps in node/handle editing.
* '''Ignore cusp nodes''', affect to all other widgets changes and, for example, retain cusp nodes when you change the power.
* '''Change only selected nodes''', affect to all other widgets changes.
* Show a '''helper path''' whith the final shape and the generated new nodes.

 

==== Fillet/Chamfer ====
----
[[File:Fillet-chamfer.png|170px|right|thumb]]
Extended video: https://www.youtube.com/watch?v=wJKzGhJULfc

* '''Four types:''' fillet, inverse fillet, chamfer and double chamfer
* Fillet/Chamfer knots are green diamonds
* '''Change Fillet/Chamfer types:''' <kbd>Ctrl+click</kbd> green knot
* '''Fillet/Chamfer knot dialog:''' <kbd>Shift+click</kbd> green knot
* Handle units
* Methods '''Auto,Force Arcs or Force Bezier'''. Auto use arcs for straight lines and bezier for curves.
* Numeric '''radius input'''.
* Optional helper path with knot direction
* Two kind of radius, '''fixed and flexible'''.
* Optional Knot distance to node instead radius
* Ignore 0 radius knots.
* Change only selected nodes.
* Hide Knots, some times useful. ex: 0 radius knot.
* Type change buttons
[[File:Fillet-chamfer2.gif]]

==== Roughen ====
----
[[File:Roughen.png|170px|right|thumb]]

Extended video: https://www.youtube.com/watch?v=130Dbt0juvY

This filter is a semi-clone of two extensions, ("add nodes" and "jitter nodes") + handle units.

The parameters are similar to both extensions.

* Apply to paths, shapes and groups.
* Apply to clip and masks -if are vectors-

[[File:Roughen.gif]]

==== Simplify ====
----
[[File:Simplify.png|170px|thumb|right]]

Extended video: https://www.youtube.com/watch?v=gaWujN_iTSk

Send the simplify command to a non-destructive live path effect.
* Use on paths, shapes and groups of them.
* Apply to clip and masks -if are vectors-
* User can change modify the threshold -preferences dialog- used by a numeric parameter.
* Apply Simplify on stack.
[[File:Simplify.gif]]

==== Perspective/Envelope ====
----
[[File:Perspective-envelope.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=CjKGatyxTZ8

Apply both deformations by 4 points.
* Two modes, perspective and envelope.
* Apply on paths, shapes and groups.
* Apply on vector clips and mask
[[File:Perspective-envelope.gif]]

==== Lattice Deformation 2 ====
----
[[File:Latice2.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=YlK9L88_tWE

Add deformations by a mesh.
* Apply to paths, shapes and groups.
* Apply to vector clips and mask

[[File:Latice2.gif]]

==== Show Handles ====
----
[[File:ShowHandles.png|170px|thumb|right]]
Extended video: https://www.youtube.com/watch?v=h9ul_PR9XYo

A LPE version of Show Handles extension.

* Work on paths, shapes and groups.
* Work on clones
* Node and Handle shapes resizeables
* If not a clone, is a destructive LPE, dont save styles, work on a copy!
[[File:ShowHandles.gif]]

== Other user interface ==

GTK+ Issues

2014-10-13T02:29:58Z

LiamW: add issue with broadway

A list of GTK issues in Inkscape.

We may have access to Red Hat's GTK experts. This page is an attempt to assemble a list of possible topics to work with them on.

Please add topics to the most suitable subsection.

= General =

Bugs:
* [https://bugs.launchpad.net/inkscape/+bug/1164150 Bug 1164150: Out of control spinners]
* Canvas redraw issues with Mac OS X and Wayland. See:
** https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4
** https://mail.gnome.org/archives/gtk-devel-list/2014-June/msg00047.html
* Font loading time. (already fixed in experimental? see [https://bazaar.launchpad.net/~inkscape.dev/inkscape/experimental/revision/13481 r13481])

= Linux =

* Problems with GTK Theme engines under KDE.
* [https://bugs.launchpad.net/inkscape/+bug/1109812 Guides not accessible in KDE]

= Mac OS X =

* See canvas redrawing problem above.
* [https://bugs.launchpad.net/inkscape/+bug/1116468 Inkscape (GTK+/Quartz): crash in SVG Font Editor (stable & trunk)]

= Windows =

* [https://bugs.launchpad.net/inkscape-devlibs64/+bug/1329994 Bug 1329994: dropdown background doesn't show blue selection]

= GTK3 Migration =

* The canvas can't draw in HiDPI resolutions ([https://bugs.launchpad.net/inkscape/+bug/1285887 Bug 1285887: Drawing canvas is blurry/low-resolution on HiDPI/Retina configuration])
* Crazy flickering of the palette (Adwaita theme) when it doesn't have a scrollbar
** https://bugs.launchpad.net/inkscape/+bug/1201545
** https://dl.dropboxusercontent.com/u/96223438/irc/gtk%2B/palette-flicker.mp4
* Broken GTK+/Broadway backend
** Initially, Inkscape fails to start: https://i.imgur.com/3p7PNSx.png
** https://dl.dropboxusercontent.com/u/96223438/irc/gtk%2B/broadway.mp4

GTK+ Issues

2014-09-30T23:03:01Z

LiamW: OSX ≠ OS X

GTK+ Issues

2014-09-30T22:46:23Z

LiamW: guides not accessible in KDE

A list of GTK issues in Inkscape.

We may have access to Red Hat's GTK experts. This page is an attempt to assemble a list of possible topics to work with them on.

Please add topics to the most suitable subsection.

= General =

Bugs:
* [https://bugs.launchpad.net/inkscape/+bug/1164150 Bug 1164150: Out of control spinners]
* Canvas redraw issues with Mac OSX and Wayland. See:
** https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4
** https://mail.gnome.org/archives/gtk-devel-list/2014-June/msg00047.html
* Font loading time. (already fixed in experimental? see [https://bazaar.launchpad.net/~inkscape.dev/inkscape/experimental/revision/13481 r13481])

= Linux =

* Problems with GTK Theme engines under KDE.
* [https://bugs.launchpad.net/inkscape/+bug/1109812 Guides not accessible in KDE]

= Mac OSX =

* See canvas redrawing problem above.
* [https://bugs.launchpad.net/inkscape/+bug/1116468 Inkscape (GTK+/Quartz): crash in SVG Font Editor (stable & trunk)]

= Windows =

* [https://bugs.launchpad.net/inkscape-devlibs64/+bug/1329994 Bug 1329994: dropdown background doesn't show blue selection]

= GTK3 Migration =

* The canvas can't draw in HiDPI resolutions ([https://bugs.launchpad.net/inkscape/+bug/1285887 Bug 1285887: Drawing canvas is blurry/low-resolution on HiDPI/Retina configuration])
* Crazy flickering of the palette (Adwaita theme) when it doesn't have a scrollbar
** https://bugs.launchpad.net/inkscape/+bug/1201545
** https://dl.dropboxusercontent.com/u/96223438/irc/gtk%2B/palette-flicker.mp4

GTK+ Issues

2014-09-30T22:44:21Z

LiamW:

A list of GTK issues in Inkscape.

We may have access to Red Hat's GTK experts. This page is an attempt to assemble a list of possible topics to work with them on.

Please add topics to the most suitable subsection.

= General =

Bugs:
* [https://bugs.launchpad.net/inkscape/+bug/1164150 Bug 1164150: Out of control spinners]
* Canvas redraw issues with Mac OSX and Wayland. See:
** https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4
** https://mail.gnome.org/archives/gtk-devel-list/2014-June/msg00047.html
* Font loading time. (already fixed in experimental? see [https://bazaar.launchpad.net/~inkscape.dev/inkscape/experimental/revision/13481 r13481])

= Linux =

* Problems with GTK Theme engines under KDE.

= Mac OSX =

* See canvas redrawing problem above.
* [https://bugs.launchpad.net/inkscape/+bug/1116468 Inkscape (GTK+/Quartz): crash in SVG Font Editor (stable & trunk)]

= Windows =

* [https://bugs.launchpad.net/inkscape-devlibs64/+bug/1329994 Bug 1329994: dropdown background doesn't show blue selection]

= GTK3 Migration =

* The canvas can't draw in HiDPI resolutions ([https://bugs.launchpad.net/inkscape/+bug/1285887 Bug 1285887: Drawing canvas is blurry/low-resolution on HiDPI/Retina configuration])
* Crazy flickering of the palette (Adwaita theme) when it doesn't have a scrollbar
** https://bugs.launchpad.net/inkscape/+bug/1201545
** https://dl.dropboxusercontent.com/u/96223438/irc/gtk%2B/palette-flicker.mp4

GTK+ Issues

2014-09-30T22:43:49Z

LiamW: palette flickers

A list of GTK issues in Inkscape.

We may have access to Red Hat's GTK experts. This page is an attempt to assemble a list of possible topics to work with them on.

Please add topics to the most suitable subsection.

= General =

Bugs:
* [https://bugs.launchpad.net/inkscape/+bug/1164150 Bug 1164150: Out of control spinners]
* Canvas redraw issues with Mac OSX and Wayland. See:
** https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4
** https://mail.gnome.org/archives/gtk-devel-list/2014-June/msg00047.html
* Font loading time. (already fixed in experimental? see [https://bazaar.launchpad.net/~inkscape.dev/inkscape/experimental/revision/13481 r13481])

= Linux =

* Problems with GTK Theme engines under KDE.

= Mac OSX =

* See canvas redrawing problem above.
* [https://bugs.launchpad.net/inkscape/+bug/1116468 Inkscape (GTK+/Quartz): crash in SVG Font Editor (stable & trunk)]

= Windows =

* [https://bugs.launchpad.net/inkscape-devlibs64/+bug/1329994 Bug 1329994: dropdown background doesn't show blue selection]

= GTK3 Migration =

* The canvas can't draw in HiDPI resolutions ([https://bugs.launchpad.net/inkscape/+bug/1285887 Bug 1285887: Drawing canvas is blurry/low-resolution on HiDPI/Retina configuration])
* Crazy flickering of the palette when it doesn't have a scrollbar
** https://bugs.launchpad.net/inkscape/+bug/1201545
** https://dl.dropboxusercontent.com/u/96223438/irc/gtk%2B/palette-flicker.mp4

GTK+ Issues

2014-09-30T22:40:54Z

LiamW: Quartz: crash with SVG font editor

A list of GTK issues in Inkscape.

We may have access to Red Hat's GTK experts. This page is an attempt to assemble a list of possible topics to work with them on.

Please add topics to the most suitable subsection.

= General =

Bugs:
* [https://bugs.launchpad.net/inkscape/+bug/1164150 Bug 1164150: Out of control spinners]
* Canvas redraw issues with Mac OSX and Wayland. See:
** https://dl.dropboxusercontent.com/u/65084033/irc/Screen%20Recording%209.mp4
** https://mail.gnome.org/archives/gtk-devel-list/2014-June/msg00047.html
* Font loading time. (already fixed in experimental? see [https://bazaar.launchpad.net/~inkscape.dev/inkscape/experimental/revision/13481 r13481])

= Linux =

* Problems with GTK Theme engines under KDE.

= Mac OSX =

* See canvas redrawing problem above.
* [https://bugs.launchpad.net/inkscape/+bug/1116468 Inkscape (GTK+/Quartz): crash in SVG Font Editor (stable & trunk)]

= Windows =

* [https://bugs.launchpad.net/inkscape-devlibs64/+bug/1329994 Bug 1329994: dropdown background doesn't show blue selection]

= GTK3 Migration =

* The canvas can't draw in HiDPI resolutions ([https://bugs.launchpad.net/inkscape/+bug/1285887 Bug 1285887: Drawing canvas is blurry/low-resolution on HiDPI/Retina configuration])

GTK+ Issues

2014-09-30T22:30:04Z

LiamW: HiDPI screens

GTK+ Issues

2014-09-30T22:26:55Z

LiamW: Font loading time — already fixed?

GTK+ Issues

2014-09-30T22:15:35Z

LiamW: a windows issue

Notes on Packaging for OS X

2014-09-15T00:23:08Z

LiamW: Add stuff for osxmenu too

= Current Status =

; Available download
: Inkscape.0.48.5 [http://sourceforge.net/projects/inkscape/files/inkscape/0.48.5/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (compiled as 32bit app on Mac OS X 10.5.8)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/1132277 Bug #1132277], [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678], [https://bugs.launchpad.net/inkscape/+bug/406662 #406662]
: missing: system fonts (fontconfig) - [https://bugs.launchpad.net/inkscape/+bug/1288672 Bug #1288672]
: <strike>missing: UniConvertor support - [https://bugs.launchpad.net/inkscape/+bug/1216793 Bug #1216793]</strike>
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: <strike>crash on second import from OpenClipArt in same session - [https://bugs.launchpad.net/inkscape/+bug/365567 Bug #365567]</strike>
: crash on launch if incompatible color profiles are present (lcms1, encoding) - [https://bugs.launchpad.net/inkscape/+bug/623640 Bug #623640]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: <strike>Lion, Mountain Lion, Mavericks: extensions don't work out-of-the-box - [https://bugs.launchpad.net/inkscape/+bug/819209 Bug #819209]</strike>
: Mavericks: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_48_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])
: no support for Mac OS X >= 10.6 (can't be used as is to create new packages)
: written for GTK+/X11 based application
: missing: DMG with precompiled python packages (was hosted on modevia)
: no updates for changes in upstream packages
: no updates for known bugs (extensions, locale detection, fonts)
: no options to support GTK+/Quartz

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: re-enable system fonts
: improve language detection
: improve CLI usage

; Extensions
: use Python 2.7 (64bit) (provided by OS X)
: include ps2pdf, UniConvertor
: include dbus (without launchd support) (0.91)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* Uses GTK+/Quartz backend in app bundle
* Supports gtk-mac-integration for integration with OS X global menu bar
* Supports dbus session bus
* New dark theme
* OS X friendly key bindings use Cmd instead of Ctrl
* … (TODO: more changes?)

; Status
: experimental, wip

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 merge proposal]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]

Notes on Packaging for OS X

2014-09-15T00:17:59Z

LiamW: Fill in the osx-packaging-update TODO list a bit

= Current Status =

; Available download
: Inkscape.0.48.5 [http://sourceforge.net/projects/inkscape/files/inkscape/0.48.5/]

; Requirements
: XQuartz >= 2.5.1
: Mac OS X >= 10.5.8 (compiled as 32bit app on Mac OS X 10.5.8)
: Python >= 2.5 (32bit) (provided by OS X) for extensions

; Known issues
: clipboard conflict with XQuartz (pastes as bitmap) - [https://bugs.launchpad.net/inkscape/+bug/307005 Bug #307005]
: language detection is faulty - [https://bugs.launchpad.net/inkscape/+bug/1132277 Bug #1132277], [https://bugs.launchpad.net/inkscape/+bug/617079 #617079], [https://bugs.launchpad.net/inkscape/+bug/476678 #476678], [https://bugs.launchpad.net/inkscape/+bug/406662 #406662]
: missing: system fonts (fontconfig) - [https://bugs.launchpad.net/inkscape/+bug/1288672 Bug #1288672]
: <strike>missing: UniConvertor support - [https://bugs.launchpad.net/inkscape/+bug/1216793 Bug #1216793]</strike>
: missing: ps2pdf for Postscript input - [https://bugs.launchpad.net/inkscape/+bug/642522 Bug #642522](osx, win32)
: partial: spellchecker limited to English dictionary - [https://bugs.launchpad.net/inkscape/+bug/396322 Bug #396322]
: <strike>crash on second import from OpenClipArt in same session - [https://bugs.launchpad.net/inkscape/+bug/365567 Bug #365567]</strike>
: crash on launch if incompatible color profiles are present (lcms1, encoding) - [https://bugs.launchpad.net/inkscape/+bug/623640 Bug #623640]

; Known issues on specific versions of OS X
: Leopard: requires XQuartz >= 2.5.1 - [https://bugs.launchpad.net/inkscape/+bug/878368 Bug #878368]
: <strike>Lion, Mountain Lion, Mavericks: extensions don't work out-of-the-box - [https://bugs.launchpad.net/inkscape/+bug/819209 Bug #819209]</strike>
: Mavericks: XQuartz conflict with multi-monitor setups - [https://bugs.launchpad.net/inkscape/+bug/1244397 Bug #1244397]

; Scripts & Resources in 'packaging/macosx' ([http://bazaar.launchpad.net/~inkscape.dev/inkscape/RELEASE_0_48_BRANCH/files/head:/packaging/macosx/ stable], [http://bazaar.launchpad.net/~inkscape.dev/inkscape/trunk/files/head:/packaging/macosx/ trunk])
: no support for Mac OS X >= 10.6 (can't be used as is to create new packages)
: written for GTK+/X11 based application
: missing: DMG with precompiled python packages (was hosted on modevia)
: no updates for changes in upstream packages
: no updates for known bugs (extensions, locale detection, fonts)
: no options to support GTK+/Quartz

= Roadmap =

; Provide packages built with GTK+/Quartz
: no requirement for X11/XQuartz
: OS integration (menubar, shortcuts, dock menu, proxy icon)
: re-enable system fonts
: improve language detection
: improve CLI usage

; Extensions
: use Python 2.7 (64bit) (provided by OS X)
: include ps2pdf, UniConvertor
: include dbus (without launchd support) (0.91)
: offer packages (installer) for additional extensions and required dependencies

; User data (OS X guidelines <-> XDG spec)
: inkscape profile folder in "$HOME/Library/Application Support/"
: caches in "$HOME/Library/Caches"

= Future =

; Packages based on GTK3/Quartz
: OS X integration based on native GTK3 features
: support for HiDPI resolutions
: multi-threading (OpenMP support in future version of clang)
: 

= Recent efforts =

== 2012: Gellule Xg  ==

* Based on trunk (lp:inkscape r11619)
* dependencies via MacPorts
* ige-mac-integration for osx menubar
* ige-mac-bundler for osx app
* osx-build.sh updated, osx-app.sh obsolete, osx-dmg.sh new

; Status
: experimental, abandoned

; +
: simplified bundle structure
: easier bundling (script is developed & maintained upstream)
; -
: extensions not working in app bundle
: themeing not yet included

; Related blueprint
: [https://blueprints.launchpad.net/inkscape/+spec/inkscape-quartz A quartz version for OS X ]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/dev-osx lp:~inkscape.dev/inkscape/dev-osx]

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/36136 Subject: Some progress on OSX/aqua, and how to go further?]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/38933 Subject: Packaging for OSX]
: [http://inkscape.13.x6.nabble.com/Verbs-SPAction-versus-GtkAction-tt2806978.html Subject: Verbs+SPAction versus GtkAction]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/738973 Bug #738973: Issues with inkscape-quartz blueprint]
: [https://bugs.launchpad.net/inkscape/+bug/1042597 Bug #1042597: gtk-mac-bundler: include python modules (and runtime) for extensions]
: [https://bugs.launchpad.net/inkscape/+bug/1043266 Bug #1043266: gtk-mac-integration support]
: [https://bugs.launchpad.net/inkscape/+bug/1043279 Bug #1043279: gtk-mac-bundler issues]
: [https://bugs.launchpad.net/inkscape/+bug/1045959 Bug #1045959: add DnD, 'Open with…' support for Dock & Finder icon]
: [https://bugs.launchpad.net/inkscape/+bug/1045963 Bug #1045963: add gtk-themes support]

== 2013: Valerio Aimale  ==

* Based on stable (lp:inkscape/0.48.x r9943)
* dependencies via MacPorts
* gtk-mac-integration for osx menubar, shortcuts, callbacks
* osx-build.sh, osx-app.sh updated
* script-based launcher (new)

; Status
: Release Candidate (RC5), abandoned

; +
: feature complete (including extensions, themeing)
: extensions: includes ps2pdf and UniConvertor, uses system Python
; -
: based on stable, not ported to trunk
: no source code available (RC builds cannot be recreated)
: gtk-mac-integration uses Quartz handlers (-> conflicts with keyboard input)
: depends on patched GTK+/Quartz stack for clipboard support
: no pasting of text in GUI widgets (XML Editor crashes on paste)

; Related threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602 Subject: Mac OS X Mountain Lion x86_64 packaging of 0.48.4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39602/focus=39631 Subject: Rejuvenated build system for Mac OS X]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39642 Subject: Inkscape and Mac OSX menu integration]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39644 Subject: Patch that allows use of Meta key on Mac OS X and all platforms]

; Related reports
: [https://bugs.launchpad.net/inkscape/+bug/1096996 Bug #1096996 Refreshed build system for Mac OS X ]
: [https://bugs.launchpad.net/inkscape/+bug/1097009 Bug #1097009 Better integration with Mac OS X OS ]
: [https://bugs.launchpad.net/inkscape/+bug/1097539 Bug #1097539 Actiavte the use of Meta|Command|WinFlag key for Mac Menu Accelerators ]

; RC build threads
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39667 Subject: Mac OS X Build 0.48.4 RC1]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39694 Subject: Mac OSX 0.48.4 RC2]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39707 Subject: Mac OSX 0.48.4 RC3]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39756 Subject: Mac OSX 0.48.4 RC4]
: [http://thread.gmane.org/gmane.comp.graphics.inkscape.devel/39799 Subject: Mac OS X 0.48.4 RC5]

== 2014: osxmenu (~suv)  ==

* Based on (or cherry-picked from) Gellule's and Valerio's work
* … (TODO: summary of changes)

; Status
: experimental, wip

; Related branch
: [https://code.launchpad.net/~suv-lp/inkscape/osxmenu lp:~suv-lp/inkscape/osxmenu]

== 2014: osx-packaging-update (Liam P. White, ~suv)  ==

* Based on current scripts in 'packaging/macosx' (X11-based)
* Works with latest version of dependencies
* Allows creating bundle with quartz
* Supports compiling Platypus launcher on newer versions of OS X
* Uses modern Adwaita theme instead of Clearlooks-Quicksilver theme in stable bundles
* Fixes library rewriting
* Uses Python bundles from MacPorts prefix
* Adds wrapper script for GIMP.app

; Status
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update/+merge/233846 merge proposal]

; Related branch
: [https://code.launchpad.net/~inkscape.dev/inkscape/osx-packaging-update osx-packaging-update]

CrossCompilingOsX

2014-06-05T20:49:47Z

LiamW: build dyld

This is being worked on, please maintain your patience. I have successfully done this before but I don't remember what I did, so I will have to recreate a lot of stuff.

You need:
* a mind so deadset on cross-compiling you won't stop to think
* the Xcode .dmg for your target OS X version
* root access to your build system
* a good processor and a lot of RAM

The following should be done on the ''host'' system first. Download the Xcode DMG, and use dmg2img to convert it to an IMG. Mount the IMG, and put the .pkg files into the chroot somewhere. I'm using /mnt/apple.

= Making the chroot =

I used Ubuntu 14.04 "Trusty Tahr" for doing the initial chroot. The process was as follows:

apt-get install dchroot debootstrap

Then edit /etc/schroot/schroot.conf with your favourite text editor, and add this at the end:
[trusty]
description=Ubuntu Trusty
location=/var/chroot
priority=3
users='''your_username'''
groups=sbuild
root-groups=root

Install a base system:
sudo debootstrap --variant=buildd --arch '''amd64''' trusty /var/chroot/ '''mirror.url.com/ubuntu/'''
where '''mirror.url.com/ubuntu/''' can be any of [https://launchpad.net/ubuntu/+archivemirrors these mirrors].

Now copy your resolv.conf for internet access (required):
sudo cp /etc/resolv.conf /var/chroot/etc/resolv.conf

Bind your procfs into the chroot for gnustep:
sudo mount -o bind /proc /var/chroot/proc

Finally, chroot into your target:
sudo chroot /var/chroot

You should now have a working chroot, free for you to destroy as you see fit.
(from https://help.ubuntu.com/community/BasicChroot)

To avoid pointless warnings about missing locales, do this:
apt-get install language-pack-en

Install some packages to start off with:
apt-get install sudo nano vim bzr subversion groff man-db

Edit your /etc/apt/sources.list to include the universe source and update:
deb mirror.url.com/ubuntu/ trusty main
deb-src mirror.url.com/ubuntu/ trusty main

deb mirror.url.com/ubuntu/ trusty universe
deb-src mirror.url.com/ubuntu/ trusty universe

Now install gnustep:
apt-get install gnustep gnustep-devel

This may take a while.

= Building clang =

'''NOTE:''' There is a [http://llvm.org/bugs/show_bug.cgi?id=19945 bug] with building cross-compilers for OS X.
cd /usr/src
svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
cd llvm/tools
svn co http://llvm.org/svn/llvm-project/cfe/trunk clang
cd ..; mkdir build; cd build
../configure --prefix=/usr/clang_3_4 --enable-optimized --enable-targets='''x86_64,x86''' \
--disable-compiler-version-checks --host=x86_64-unknown-linux-gnu --build=x86_64-unknown-linux-gnu \
--target='''x86_64-apple-darwin11.4.2'''
make -j4
make install

== Getting Headers ==
To tease the headers out of the Xcode so that we can compile anything, we need to install the xar archiver, which is not packaged in Trusty.
wget https://xar.googlecode.com/files/xar-1.5.2.tar.gz
tar -xvf xar-1.5.2.tar.gz
apt-get install libxml2-dev libssl-dev libbz2-dev
cd xar-1.5.2; ./configure
make; make install

Now go to the location of your PKG files. Each one needs to be extracted, and then the payload needs to be extracted too.
cd /mnt/apple
mkdir DeveloperToolsCLI
cd DeveloperToolsCLI
xar -xvf ../DeveloperToolsCLI.pkg
Extract the payload (gzip doesn't really like unnamed files)
mv ./Payload ./Payload.gz
gunzip ./Payload.gz
The resulting file is a compressed CPIO archive. Extract that too:
mkdir Contents; cd Contents
cpio -idv < ../Payload
Okay, finally. Now we can figure out what's going where.

./System and ./Library are fine. We can just copy those over:
cp -R ./System /System
cp -R ./Library /Library
But ./usr is tricky — we might end up overwriting some sort of important file if we try just blatantly overwriting our /usr.
So, what do we do?
Scan the include paths for clang, and see what we can get away with, of course.

Next step: APSL headers for OSX, from Xcode, and then add libc++ compile instructions

= Installing dyld =

dyld is the Mach-O loader for OS X, and will allow you to run many command line tools for OS X. We need to install the GNUStep sources as well as the binaries here, be careful!
apt-get install git cmake clang nasm libxml2-dev libgnutls-dev libicu-dev libcairo-dev libjpeg-dev libpng-dev \
libtiff-dev libbsd-dev libudev-dev liblcms-dev libkqueue-dev libssl-dev libbz2-dev uuid-dev libncurses-dev \
libxrandr-dev libavcodec-dev libavformat-dev autoconf automake autopoint
== Building gnustep-make ==
cd /usr/src
svn co http://svn.gna.org/svn/gnustep/tools/make/trunk/ gnustep-make
cd gnustep-make
CC=clang CXX=clang++ ./configure
make install
== Building gnustep-libobjc2 ==
svn co http://svn.gna.org/svn/gnustep/libs/libobjc2/trunk/ gnustep-libobjc2
cd gnustep-libobjc2
OBJCFLAGS=-fblocks CC=clang CXX=clang++ cmake .
rm GNUmakefile
make; make install
== Building gnustep-base ==
svn co http://svn.gna.org/svn/gnustep/libs/base/trunk/ gnustep-base
cd gnustep-base
OBJCFLAGS=-fblocks CC=clang CXX=clang++ ./configure
make; make install
== Building gnustep-gui ==
svn co http://svn.gna.org/svn/gnustep/libs/gui/trunk/ gnustep-gui
cd gnustep-gui
OBJCFLAGS=-fblocks CC=clang CXX=clang++ ./configure
make; make install
== Building libdispatch ==
git clone git://github.com/nickhutchinson/libdispatch.git libdispatch
cd libdispatch
./configure
make; make install
== Building gnustep-corebase ==
svn co http://svn.gna.org/svn/gnustep/libs/corebase/trunk/ gnustep-corebase
cd gnustep-corebase
'''NOTE: there seems to be a bug in the configure script.'''
To work around this bug, comment out these lines in configure.ac:
# AC_CHECK_LIB(dispatch, dispatch_get_main_queue_eventfd_np)
# AS_IF([test "$ac_cv_lib_dispatch_dispatch_get_main_queue_eventfd_np" = "no"],
# [AC_MSG_ERROR([Compatible libdispatch not found for GCD support! Use --disable-gcd to disable GCD support or install GCD.])])])
Then run:
autoconf configure.ac > configure

OBJCFLAGS=-fblocks CC=clang CXX=clang++ ./configure
make; make install

== Building darling ==
Finally!
git clone https://github.com/LubosD/darling.git
cd darling
CC=clang CXX=clang++ cmake .
There appears to be another bug here, in /usr/local/include/CoreFoundation/CFRunLoop.h:207.
To fix it, just deactivate the code block like this:
#if 0 && OS_API_VERSION(MAC_OS_X_VERSION_10_4, GS_API_LATEST)
DEFINE_BLOCK_TYPE_NO_ARGS(PerformBlockType, void);
CF_EXPORT void
CFRunLoopPerformBlock (CFRunLoopRef rl, CFTypeRef mode, PerformBlockType block);
#endif
Then continue:
make; make install

More coming...

CrossCompilingOsX

2014-06-05T20:30:05Z

LiamW: formatting

CrossCompilingOsX

2014-06-05T02:13:56Z

LiamW:

CrossCompilingOsX

2014-06-04T19:07:30Z

LiamW: whoops

CrossCompilingOsX

2014-06-04T19:06:58Z

LiamW: instructions to decompress a .pkg file

CrossCompilingOsX

2014-06-04T18:33:49Z

LiamW: man-db, groff

CrossCompilingOsX

2014-06-04T15:53:03Z

LiamW: fix a problem with --enable-targets

CrossCompilingOsX

2014-06-04T13:53:46Z

LiamW:

CrossCompilingOsX

2014-06-04T13:38:27Z

LiamW: add gnustep and universe

CrossCompilingOsX

2014-06-04T11:27:59Z

LiamW: Add bit about procfs, links, packages

CrossCompilingOsX

2014-06-03T22:28:22Z

LiamW: fix link

CrossCompilingOsX

2014-06-03T22:00:14Z

LiamW: add info about chroot

CrossCompilingWindows

2014-06-03T21:41:11Z

LiamW: initial commit

Install Wine, and proceed with the Windows compilation method.

Dealing with x86_64-w64-mingw32-gcc/i386-mingw32-gcc is too much of a hassle.

CrossCompilingOsX

2014-06-03T21:38:18Z

LiamW: Created page with "This is being worked on, please maintain your patience. I have successfully done this before but I don't remember what I did, so I will have to recreate a lot of stuff."

This is being worked on, please maintain your patience. I have successfully done this before but I don't remember what I did, so I will have to recreate a lot of stuff.

Compiling Inkscape

2014-06-03T21:37:13Z

LiamW: add cross compile section

Hopefully, Inkscape will compile right out of the box. If it doesn't, well that's what this page is for.

Jot down notes, questions, findings, tips, etc. here on things you run into. It's a good idea to
make mention of what version of the code you're trying to compile, the distribution you're running,
and other such information that might be pertinent.

If legitimate bugs are found or patches developed, please move them to the tracker at Sourceforge
rather than inlining them here.

= Notes =
Inkscape needs automake 1.7, 1.8 or 1.10 and higher. Please consider NOT using automake1.9, because it has a bug ( link: http://sourceforge.net/mailarchive/message.php?msg_id=10288631 ) that prevents compiling of Inkscape. If you have already tried to do a $ make with automake1.9 then $ ./autogen.sh from your inkscape-cvs dir and proceed as normal. (On the other hand, I've repeatedly built it with automake-1.9.4. ralf)

You may want to also [http://wiki.inkscape.org/wiki/index.php/OtherProjects#Inkscape_Plugins.2C_Scripts.2C_and_Templates add plugins] during or after compiling.

= OS & Distribution Specific =
* '''Linux'''
** [[CompilingAutopackage|Autopackage]] (multi-distro)
** [[CompilingFedora|Fedora]]
** [[CompilingGentoo|Gentoo]]
** [[CompilingDebian|Debian]]
** [[CompilingUbuntu|Ubuntu]]
** [[CompilingYellowDog|Yellow Dog]]
** [[CompilingSuse|Suse]]
** [[CompilingSlackware|Slackware]]
** [[CompilingYoper|Yoper]]
** [[CompilingMandrake|Mandrakelinux]]
** [[CompilingRHEL|Red Hat Enterprise Linux Version #4]]
* [[CompilingMacOsX|Mac OS X]]
* [[Compiling Inkscape on Windows|Windows]]
* [[CompilingSPARC|SPARC]]
* [[CompilingSunSolaris|Sun Solaris]]
* [[CompilingStatic|Static Compiles]]
* '''Cross-compiling'''
** [[CrossCompilingOsX|For OS X (from Linux)]]
** [[CrossCompilingWindows|For Windows (from Linux)]]

= Package Config (pkg-config) =

If you must compile and install any of these from source, you may find an error like this when trying to
compile them or Inkscape itself:

checking for gtk+-2.0 >= 2.0.0 libxml-2.0 >= 2-2.4.24 sigc++-1.2 gtkmm-2.0... Package gtkmm-2.0 was not found in the pkg-config search path.
Perhaps you should add the directory containing `gtkmm-2.0.pc'
to the PKG_CONFIG_PATH environment variable
No package 'gtkmm-2.0' found

A solution is to set the PKG_CONFIG_PATH variable as so:

for bash:
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/lib/pkgconfig
for csh:
setenv PKG_CONFIG_PATH /usr/local/lib/pkgconfig:/usr/lib/pkgconfig

A good place to put this line is in your .bashrc or .cshrc file

= Dependencies =

If your distro does not have some packages available (like many don't, ie, Fedora Core 2), you must often download and build source packages and/or install them yourself. See [[Tracking Dependencies]].

= Developer Compilation =

Plain vanilla compilation is done as documented in INSTALL; ./autogen.sh (optionally); ./configure; make; su && make check; make install (optional). See INSTALL for more on that.

But if you're going to be doing a lot of development, there's some tricks and techniques you should know,
to get best results.

# Turn off optimization
# Use ccache for faster compilation
# Set up a separate build directory (nice for testing both gcc and g++, or cross compiling)
# Use the -j N flag to increment the number of threads available to make, with N = 1 + number of processors

Example: Setting up the build environment (in separate tree), and using ccache for faster
compilations on a dual-processor machine, with no optimization and full debug symbols, assuming /bin/bash:

mkdir build
bzr checkout lp:inkscape
cd inkscape
./autogen.sh
cd ../build
export CFLAGS="-g -O0 -Wall" CC="ccache gcc"
export CXXFLAGS="-g -O0 -Wall" CXX="ccache g++"
../inkscape/configure
make -j 3 -k

Turning off just optimization:

export CXXFLAGS="-g -O0 -Wall"
export CFLAGS="-g -O0 -Wall"
./configure

See [[TestingInkscape]] for information on building and executing (unit) tests.

[[Category:Developer Documentation]]

CompilingUbuntu

2014-05-24T20:35:14Z

LiamW: /* Update your version */

== Consider using stable (recommended for production) ==
This is a short how to build the latest svn version. Please note that SVN version may be buggy and crash often. This is released for people who want to help testing or need the very latest features. If you are not of developer kind, you are suggested to install the stable version from the repositories using Synaptic or from command line:

<pre>
sudo apt-get install inkscape
</pre>

== Using prebuilt packages (recommended) ==
For Ubuntu there are nightly builds available.

Get your appropriate repository lines from launchpad (read about [https://help.ubuntu.com/community/Repositories/Ubuntu adding repositories]):

https://launchpad.net/~inkscape-nightly/+archive/ppa

Run following command to update the repository information and install inkscape:
<pre> sudo apt-get update
sudo apt-get install inkscape-devel
</pre>

== Compiling unstable developement version ==
=== Installing dependencies ===
If you are sure you can face Inkscape being unstable, then please continue reading. First you should install all the [[Tracking Dependencies|dependencies]]. This can be done by:

<pre>
sudo apt-get install build-essential autoconf automake autopoint intltool libtool \
libglib2.0-dev libpng12-dev libgc-dev libfreetype6-dev liblcms1-dev \
libgtkmm-2.4-dev libxslt1-dev libboost-dev libpopt-dev libgsl0-dev libaspell-dev
</pre>

Now you should have every dependency you need to build Inkscape.

==== Additional dependencies ====
If you want to have pdf support you need to install poppler:

<pre>
sudo apt-get install libpoppler-dev libpoppler-glib-dev
</pre>

If you want to have optional features you may need to install some more packages:

<pre>
sudo apt-get install libgnome-vfsmm-2.6-dev libssl-dev libmagick++9-dev libwpg-dev libcdr-dev libvisio-dev
</pre>

=== Getting source from Bazaar ===
Inkscape now uses Bazaar, please refer to the [[Working with Bazaar]] page for details on how to get the Inkscape source code.

=== Configuring and Compiling ===
Enter the newly created inkscape directory.

<pre>
cd inkscape
</pre>

As you may have already noticed this folder contains some files with all CAPITAL letters like README, INSTALL, HACKING, COPYING and probably others. These contain the latest information about how to build the program. The README file says that if you have no configure script in the current directory you should run autogen script to create it:

<pre>
NOCONFIGURE=1 && ./autogen.sh
</pre>

Now run configure script which detects your system variables, installed software etc.:

<pre>
./configure
</pre>

or, if you want to make it install to an alternate location so that you can keep the standard version installed and untouched

<code>
./configure --prefix=/home/''yourname''/opt/local
</code>
(replacing "yourname" with your actual directory user name, of course)
''All bug reporting testers may find it useful to install to use --prefix=/home/''yourname''/opt/inkscape-revision-19900 or --prefix=/opt/inkscape-19900 or something similar, replacing the revision number with correct one (this is shown when svn fetching finishes, also can be found in file .svn/entries). This way you can have several versions of inkscape installed at once.''

If the configure script ends with no error messages, you are the lucky one, all system requirements are met. Run make to compile.

<pre>
make
</pre>

This may take some time, probably hours, depending on your machine's speed. On 1,4GHz P3M with 512Mb clean build took 100 minutes.

If you have multiple processing cores on your machine, you can run a parallel build using
<pre>
make -j4
</pre>
The number after "-j" can be set to the number of available processing cores. This is considerably faster than running "make" on a single core.

=== Testing ===

In addition to the instructions above, developers should always run automated tests before committing any changes. This is achieved by using the "make check" command.

=== Installing ===

If you used some --prefix=/... other than /usr, then you may install using usual 'make install' or 'sudo make install', depending on the location.
If the the location prefix was /usr, then "sudo make install" is not recommended, as debian package manager would know nothing about new package. The better alternative is using checkinstall. If checkinstall is not installed, you can install it the usual way "sudo apt-get install checkinstall".

<pre>
sudo checkinstall
</pre>

Happy inkscapeing.

==== Fix no icons problem ====

If you run this and you find that you have no tool icons it's because it's looking in the wrong place for them. To fix that you need to make a symbolic link to the correct location. Here is an example:

<pre>
sudo ln -s /usr/share/inkscape /usr/local/share/inkscape
</pre>

=== Update your version ===

If you want to update your already built inkscape to the very latest version, you need to run following commands in inkscape source directory.

<pre>
bzr up
make
make install
</pre>

[[Category:Developer Documentation]]

CompilingUbuntu

2014-05-24T20:33:48Z

LiamW: make runs configure anyway if it needs to

== Consider using stable (recommended for production) ==
This is a short how to build the latest svn version. Please note that SVN version may be buggy and crash often. This is released for people who want to help testing or need the very latest features. If you are not of developer kind, you are suggested to install the stable version from the repositories using Synaptic or from command line:

<pre>
sudo apt-get install inkscape
</pre>

== Using prebuilt packages (recommended) ==
For Ubuntu there are nightly builds available.

Get your appropriate repository lines from launchpad (read about [https://help.ubuntu.com/community/Repositories/Ubuntu adding repositories]):

https://launchpad.net/~inkscape-nightly/+archive/ppa

Run following command to update the repository information and install inkscape:
<pre> sudo apt-get update
sudo apt-get install inkscape-devel
</pre>

== Compiling unstable developement version ==
=== Installing dependencies ===
If you are sure you can face Inkscape being unstable, then please continue reading. First you should install all the [[Tracking Dependencies|dependencies]]. This can be done by:

<pre>
sudo apt-get install build-essential autoconf automake autopoint intltool libtool \
libglib2.0-dev libpng12-dev libgc-dev libfreetype6-dev liblcms1-dev \
libgtkmm-2.4-dev libxslt1-dev libboost-dev libpopt-dev libgsl0-dev libaspell-dev
</pre>

Now you should have every dependency you need to build Inkscape.

==== Additional dependencies ====
If you want to have pdf support you need to install poppler:

<pre>
sudo apt-get install libpoppler-dev libpoppler-glib-dev
</pre>

If you want to have optional features you may need to install some more packages:

<pre>
sudo apt-get install libgnome-vfsmm-2.6-dev libssl-dev libmagick++9-dev libwpg-dev libcdr-dev libvisio-dev
</pre>

=== Getting source from Bazaar ===
Inkscape now uses Bazaar, please refer to the [[Working with Bazaar]] page for details on how to get the Inkscape source code.

=== Configuring and Compiling ===
Enter the newly created inkscape directory.

<pre>
cd inkscape
</pre>

As you may have already noticed this folder contains some files with all CAPITAL letters like README, INSTALL, HACKING, COPYING and probably others. These contain the latest information about how to build the program. The README file says that if you have no configure script in the current directory you should run autogen script to create it:

<pre>
NOCONFIGURE=1 && ./autogen.sh
</pre>

Now run configure script which detects your system variables, installed software etc.:

<pre>
./configure
</pre>

or, if you want to make it install to an alternate location so that you can keep the standard version installed and untouched

<code>
./configure --prefix=/home/''yourname''/opt/local
</code>
(replacing "yourname" with your actual directory user name, of course)
''All bug reporting testers may find it useful to install to use --prefix=/home/''yourname''/opt/inkscape-revision-19900 or --prefix=/opt/inkscape-19900 or something similar, replacing the revision number with correct one (this is shown when svn fetching finishes, also can be found in file .svn/entries). This way you can have several versions of inkscape installed at once.''

If the configure script ends with no error messages, you are the lucky one, all system requirements are met. Run make to compile.

<pre>
make
</pre>

This may take some time, probably hours, depending on your machine's speed. On 1,4GHz P3M with 512Mb clean build took 100 minutes.

If you have multiple processing cores on your machine, you can run a parallel build using
<pre>
make -j4
</pre>
The number after "-j" can be set to the number of available processing cores. This is considerably faster than running "make" on a single core.

=== Testing ===

In addition to the instructions above, developers should always run automated tests before committing any changes. This is achieved by using the "make check" command.

=== Installing ===

If you used some --prefix=/... other than /usr, then you may install using usual 'make install' or 'sudo make install', depending on the location.
If the the location prefix was /usr, then "sudo make install" is not recommended, as debian package manager would know nothing about new package. The better alternative is using checkinstall. If checkinstall is not installed, you can install it the usual way "sudo apt-get install checkinstall".

<pre>
sudo checkinstall
</pre>

Happy inkscapeing.

==== Fix no icons problem ====

If you run this and you find that you have no tool icons it's because it's looking in the wrong place for them. To fix that you need to make a symbolic link to the correct location. Here is an example:

<pre>
sudo ln -s /usr/share/inkscape /usr/local/share/inkscape
</pre>

=== Update your version ===

If you want to update your already built inkscape to the very latest version, you need to run following commands in inkscape source directory. Please correct the configure line and use the same installation method as on first install.

<pre>
bzr up
make
make install
</pre>

[[Category:Developer Documentation]]

Inkscape Devlibs 64-bit

2014-05-23T20:22:46Z

LiamW: add in info for aspell

Inkscape Devlibs 64-bit are a bundle of libraries and tools used to compile Inkscape. It is hosted in a [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs64/trunk Launchpad project]. They have been compiled with SJLJ exception handling (not SEH), and are significantly newer than the 32-bit version of these libraries.

bin/gdb.exe was cross-compiled from one of [[User:LiamW]]'s machines. The configure line was:

CC="x86_64-w64-mingw32-gcc" LDFLAGS="-L/home/liam/gdb/install/lib -static -lexpat -Wl,-Bdynamic" \
CPPFLAGS="-I/home/liam/gdb/install/include" ./configure --prefix=/home/liam/gdb/install \
--host=x86_64-w64-mingw32 --with-expat

aspell was compiled in a similar manner:

CXX="x86_64-w64-mingw32-g++" CC="x86_64-w64-mingw32-gcc" LDFLAGS="-static-libgcc -static-libstdc++" \
./configure --prefix=/home/liam/mingw-builds/install --build=x86_64-unknown-linux-gnu --host=x86_64-w64-mingw32 \
--disable-shared --enable-static --enable-win32-relocatable

Inkscape Devlibs 64-bit

2014-05-23T00:23:57Z

LiamW: info about gdb.exe

Inkscape Devlibs 64-bit

2014-05-17T19:56:19Z

LiamW: Created page with "Inkscape Devlibs 64-bit are a bundle of libraries and tools used to compile Inkscape. It is hosted in a [https://code.launchpad.net/~inkscape.dev/inkscape-devlibs64/trunk Laun..."

Architectural overview

2014-05-14T21:51:00Z

LiamW: /* Historical note */

This is a high-level overview of how Inkscape works.

==Main subsystems==
Inkscape can be roughly subdivided into these subsystems:

;[[Display subsystem]]
:Responsible for rendering graphic primitives, displaying things onscreen, and providing the main canvas widget. Also dispatches events to tools. Contained in the <code>src/display/</code> directory of the source tree.
;[[XML subsystem]]
:Classes to store the parsed XML of an SVG document. Fairly generic, and doesn't contain significant SVG-specific functionality. The main distinguishing features (from something like <code>libxml++</code>) are notifications about XML changes and undo functionality. This subsystem is garbage-collected. Because XML nodes were formerly C structures called <code>SPRepr</code>, the XML tree is sometimes called the "repr tree", and XML nodes "reprs" (short for "representation").
;[[Object tree]]
:This is where the bulk of Inkscape's functionality is contained. Implements an XML-to-display primitive mapping, and provides an object hierarchy that can be modified using the tools. Based on <code>GObject</code>. Each document has an object tree and an XML tree. Changes in the XML tree are automatically propagated to the object tree via observers, but ''not'' the other way around—a function called <code>updateRepr()</code> must be explicitly called.
;[[Tools subsystem]]
:Processes input events on the canvas and translates them into document changes. Tools are called ''event contexts'' internally. This subsystem is based on <code>GObject</code>, dispersed in the <code>src/</code> directory (and several subdirectories). Files with event handling code end with <code>-context.cpp</code>.
;[[Extension subsystem]]
:Allows third-party extensions without modifying Inkscape's code. Currently, extensions may provide additional I/O formats, effects, path effects, and printing backends.
;[[Preferences subsystem]]
:Provides a shared storage for all of Inkscape's user settings. Small but relatively self-contained. Keeps the parsed XML tree of the preferences file (but it's not directly accessible). The intent is to separate preference ''implementation'' (which might not be based on an XML file in the future) from the ''API'' used to access them. Contained in <code>preferences.cpp</code>
;[[User Interface Modules]]
:Dialogs, widgets, tools, and more.

==How Inkscape starts==
# <tt>main()</tt> is called, and determines whether Inkscape was run in graphical mode or command-line mode.
## '''On Windows:''' A <tt>WinMain()</tt> stub calls <tt>main()</tt> so that the command prompt is not displayed.
# Based on the decision, either <tt>sp_main_gui()</tt> or <tt>sp_main_console()</tt>is called.
## Both call <tt>sp_common_main()</tt>, which handles parameter parsing. Parameters are parsed into several global variables. (Yes, this needs to be heavily refactored!)
# An instance of <tt>Inkscape::NSApplication::Application</tt> is created.
## This object is an unfinished attempt at converting top-level Inkscape structures to C++ classes. It creates the legacy <tt>Inkscape::Application</tt> structure and creates an instance of <tt>SPDesktop</tt> for each open document. (<tt>SPDesktop</tt> is a window used to edit a document—the main window you see when you start Inkscape. Sometimes simply called “desktop” for short.)
# The created desktops are shown.

Ta-Da!

==Historical note==
Inkscape is derived from an earlier vector drawing program called Sodipodi.

Sodipodi was written entirely in plain C using <code>GObject</code>. GObject is the C object system used by GTK+.

Writing and maintaining <code>GObject</code> code is cumbersome, because C lacks any syntax support for this system. There are still many places that use old <code>GObject</code>-based code (notably the tools and the <code>SPObject</code> tree).

An important long-term goal is to convert all <code>GObject</code> code to regular C++ objects. This goal has been addressed for the most part with 0.91.

Creating a new SPObject

2014-05-14T20:40:11Z

LiamW: add changes for c++ified SPObject

Create two new files in your source tree, sp-customobject.cpp and sp-customobject.h.

sp-customobject.h
#ifndef SP_CUSTOMOBJECT_H_SEEN
#define SP_CUSTOMOBJECT_H_SEEN

/** \file
* Your custom object implementation
*
* Authors:
* You
*
* Copyright (C) You 2???
* Released under GNU GPL, read the file 'COPYING' for more information
*/

#include "sp-object.h"

/* Skeleton base class */

#define SP_CUSTOM_OBJECT(o) (dynamic_cast<SPCustomObject*>(o))
#define SP_IS_CUSTOM_OBJECT(o) (dynamic_cast<SPCustomObject*>(o) != NULL)

class SPCustomObject : public SPObject {
public:
SPCustomObject() {}
virtual ~SPCustomObject() {}

// to do anything useful with your new object, you need to override the following methods:
virtual void build(SPDocument * doc, Inkscape::XML::Node *repr);
virtual void set(unsigned key, const gchar* value);
virtual Inkscape::XML::Node* write(Inkscape::XML::Document* doc, Inkscape::XML::Node* repr, guint flags);
};

#endif /* !SP_CUSTOMOBJECT_H_SEEN */

Add this code into your .cpp file, which will register your SP object with the XML tree:
namespace {
SPObject* createCustomObject() {
return new SPCustomObject();
}
bool customObjectsRegistered = SPFactory::instance().registerObject("name_in_svg", createCustomObject);
}
(If your SPObject doesn't have a useful XML representation, you can skip this call.)

When you override build, set, or write, you need to include a call to the base class method:

void
SPCustomObject::build(SPDocument* doc, Inkscape::XML::Node* repr) {
// read in attributes from repr
readAttr( "inkscape:not-an-attribute" ); // this propogates up to SPObject, which calls the virtual set() method, finally calling back here
SPObject::build(doc, repr);

// maybe do some more stuff here
}

Inkscape::XML::Node*
SPCustomObject::write(Inkscape::XML::Document* doc, Inkscape::XML::Node* repr, guint flags) {
// write our attributes to XML

// the repr doesn't exist, we need to create it
if ((flags & SP_OBJECT_WRITE_BUILD) && !repr) {
repr = doc->createElement("name_in_svg");
}

if (flags & SP_OBJECT_WRITE_EXT) {
// write Inkscape-only objects here, not copied to plain SVG dump.
repr->setAttribute("inkscape:not-an-attribute");
}
SPObject::write(doc, repr, flags);
// and possibly do anything else here
return repr;
}

void
SPCustomObject::set(unsigned int key, gchar const* value) {
// set an object from its value
switch (key) {
case SP_ATTR_INKSCAPE_CUSTOM:
if ((value && *value) && !strcmp(value, "true")) {
val = true;
}
break;
default:
SPObject::set(key, value);
break;
}
}