Difference between revisions of "Python modules for extensions"

From Inkscape Wiki
Jump to navigation Jump to search
(Providing more detail on inkex.py)
m
Line 1: Line 1:
[[Category:Extensions]]
[[Category:Extensions]]


These modules are provided as part of Inkscape and can be found in /usr/share/inkscape/extentions on GNU/Linux, ... on Windows, and ... on Mac OS X along with the extensions bundled with Inkscape. They can be <code>import</code>ed from an extension as any other python module.
These modules are provided as part of Inkscape and can be found in /usr/share/inkscape/extensions on GNU/Linux, ... on Windows, and ... on Mac OS X along with the extensions bundled with Inkscape. They can be <code>import</code>ed from an extension just like any other python module.


== inkex.py ==
== inkex.py ==
Line 16: Line 16:
=== The <code>Effect</code> class ===
=== The <code>Effect</code> class ===


The most important part of inkex.py is the <code>Effect</code> class. To implement an effect type extension in python see [[PythonEffectTutorial]]
The most important part of inkex.py is the <code>Effect</code> class. To implement an effect type extension in Python see [[PythonEffectTutorial]]


==== Methods ====
==== Methods ====
;<code>effect()</code>
;<code>effect()</code>
: You should overwrite this method with your own, as show in [[PythonEffectTutorial#Effect Extension Script]]
: You should overwrite this method with your own, as shown in [[PythonEffectTutorial#Effect Extension Script]]
;<code>getElementById( id )</code>
;<code>getElementById( id )</code>
: Returns the firs found element with given id, as a <code>lxml</code> element.
: Returns the firs found element with given id, as a <code>lxml</code> element.
;<code>getParentNode( node )</code>
;<code>getParentNode( node )</code>
: Returns the parent of <code>node</code>. Probably the same as <code>node.getparent()</code> from <code>lxml</code>?
: Returns the parent of <code>node</code>. Probably the same as <code>node.getparent()</code> from <code>lxml</code>?
;<code>createGuid( x, y, angle )</code>
;<code>createGuide( x, y, angle )</code>
: Creates guide at position (<code>x</code>,<code>y</code>), with angle <code>angle</code>.
: Creates guide at position (<code>x</code>,<code>y</code>), with angle <code>angle</code>.
;<code>affect()</code>
;<code>affect()</code>

Revision as of 14:42, 1 November 2017


These modules are provided as part of Inkscape and can be found in /usr/share/inkscape/extensions on GNU/Linux, ... on Windows, and ... on Mac OS X along with the extensions bundled with Inkscape. They can be imported from an extension just like any other python module.

inkex.py

This module encapsulates the basic behavior of a script extension, allowing the author to concentrate on manipulating the SVG data. It relies on lxml.etree to work with the XML tree. inkex.py was originally designed to provide the Effect (filter) extension type, but has been used for Input/Output extensions simply by overriding additional class methods.

Functions

inkex.py provides the following functions:

errormsg( msg )
End-user visible error message, it should always be used with translation: inkex.errormsg(_("This extension requires two selected paths"))
addNS( tag, ns=None )
Returns the selected tag, with the namespace applied. The namespace is selected from a list supplied with the module.

The Effect class

The most important part of inkex.py is the Effect class. To implement an effect type extension in Python see PythonEffectTutorial

Methods

effect()
You should overwrite this method with your own, as shown in PythonEffectTutorial#Effect Extension Script
getElementById( id )
Returns the firs found element with given id, as a lxml element.
getParentNode( node )
Returns the parent of node. Probably the same as node.getparent() from lxml?
createGuide( x, y, angle )
Creates guide at position (x,y), with angle angle.
affect()
Actuate the script.
xpathSingle( path )
An xpath wrapper to return a single node.
uniqueId( old_id )
Return an id that is unique in the document given a proposed id, by appending random alphanumeric characters to it.
getDocumentWidth()
Return width of document, as a string.
getDocumentHeight()
Return height of document, as a string.
getDocumentUnit()
Return a string representing the default unit for the document. Full list of possible units is defined in the module.
unittouu( string )
Convert given value (as a string, e.g: "4px") to units used by the document. Returns float.
uutounit( value, unit )
Convert a value (float) in document default units to given units.

Properties

document
DOM document, as a lxml.etree.
selected
A dict mapping ids to nodes, for all nodes selected in Inkscape.
doc_ids
A dict mapping ids to the constant 1, for all of the ids used in the original document. Does not get automatically updated when adding elements.
options
Options passed to the script.

simplestyle.py

Provides methods for dealing with css data embeded in SVG's style="" atribute

  • parseStyle(string): Create a dictionary from the value of an inline style attribute
  • formatStyle(dict): Format an inline style attribute from a dictionary
  • isColor(c): Determine if its a color we can use. If not, leave it unchanged.
  • parseColor(c): Creates a rgb int array
  • formatColoria(a): int array to #rrggbb
  • formatColorfa(a): float array to #rrggbb
  • formatColor3i(r,g,b): 3 ints to #rrggbb
  • formatColor3f(r,g,b): 3 floats to #rrggbb
  • svgcolors: a dictionary defining legal color names and corresponding color values

simplepath.py

Provides functions to round trip svg path d="" attribute data and a simple path format mimicing that datastructure. additional functions for scaling translating and rotating path data.

cubicsuperpath.py

An alternative path representation. access both handles of a node at once. loses a paths open/closed identity.

simpletransform.py

Provides code to easily transform objects.

  • parseTransform
Takes a string such as rotate(10) and produces a transformation matrix. If you also supply an initial matrix, the new one will be composed with the old one.
Available commands: translate, scale, rotate, skewX, skewY, matrix. Other examples:
matrix = parseTransform('rotate(10)')
matrix = parseTransform('skewY(10)')
matrix = parseTransform('translate(10 10)')
matrix = parseTransform(' rotate(10)')
matrix = parseTransform('translate(700,210) rotate(-30)')

pturtle.py

Provides turtle graphics primitives with svg path data output

beziermisc.py

Utility functions for working with bezier curves

cspsubdiv.py

Decompose a path into polylines

ff*.py

an obscure set of tools for dealing with musical scales.