Difference between revisions of "Python modules for extensions"

From Inkscape Wiki
Jump to navigation Jump to search
(added section on simpletransform)
m (Use better language)
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Extensions]]
[[Category:Extensions]]


== inkex.py ==
This page contained API documentation for various modules in inkex. A more complete API documentation is available in the [https://inkscape.gitlab.io/extensions/documentation/source/index.html documentation of the extensions repository.]
 
This module encapsulates the basic behavior of a script extension, allowing the author to concentrate on manipulating the SVG data. The module provides an '''class Effect()'''. 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.
 
=== Methods ===
*effect(): override with document processing code.
*affect(): actuate the script.
*xpathSingle(path): an xpath wrapper to return a single node.
*uniqueId(old_id, make_new_id = True): return an id that is unique in the document given a proposed id.
 
=== Properties ===
 
*document: DOM document
*selected: a list of nodes that were selected in inkscape
*doc_ids: all of the ids used in the document
*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. looses a paths open/closed identity.
 
== simpletransform.py ==
 
Provides code to easily transform objects.
 
*parseTransform
:Takes a string such as <tt>rotate(10)</tt> and produces a transformation matrix. If you also supply an initial matrix, the new one will be composed with the old one.
:Available commands: <tt>translate, scale, rotate, skewX, skewY, matrix</tt>. 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.

Latest revision as of 22:06, 10 March 2022


This page contained API documentation for various modules in inkex. A more complete API documentation is available in the documentation of the extensions repository.