1<?xml version="1.0" encoding="UTF-8"?>
2<inkscape-extension xmlns="http://www.inkscape.org/namespace/inkscape/extension">
3    <name>Pattern along Path</name>
4    <id>org.inkscape.generate.path_along_path</id>
5    <dependency type="file" location="inx">pathmodifier.py</dependency>
6    <param name="tab" type="notebook">
7        <page name="Options" gui-text="Options">
8        <param name="copymode" type="optiongroup" appearance="combo" gui-text="Copies of the pattern:">
9            <option value="Single">Single</option>
10            <option value="Single, stretched">Single, stretched</option>
11            <option value="Repeated">Repeated</option>
12            <option value="Repeated, stretched">Repeated, stretched</option>
13        </param>
14        <param name="kind" type="optiongroup" appearance="combo" gui-text="Deformation type:">
15            <option value="Snake">Snake</option>
16            <option value="Ribbon">Ribbon</option>
17        </param>
18        <param name="space" type="float" gui-text="Space between copies:" min="-10000.0" max="10000.0">0.0</param>
19        <param name="noffset" type="float" gui-text="Normal offset:" min="-10000.0" max="10000.0">0.0</param>
20        <param name="toffset" type="float" gui-text="Tangential offset:" min="-10000.0" max="10000.0">0.0</param>
21        <param name="vertical" type="bool" gui-text="Pattern is vertical">false</param>
22        <param name="duplicate" type="bool" gui-text="Duplicate the pattern before deformation">true</param>
23        </page>
24        <page name="Help" gui-text="Help">
25            <label>This effect bends a pattern along arbitrary "skeleton" paths. The pattern is the topmost object in the selection, groups of paths, shapes or clones are allowed.
26            Text can also be used as pattern, but has to be converted to path first. The other selected items are skeleton paths, and the pattern is applied to each of them</label>
27
28            <label>There are two different deformation modes. With "Snake", vertical lines will be perpendicular to the skeleton and horizontal lines will be parallel
29            (angles are preserved before stretching for paths with high node density). With "Ribbon", vertical
30            lines will remain vertical (lengths are preserved).</label>
31
32            <label>The "vertical" option switches the role of horizontal and vertical lines in the deformation mode. </label>
33
34            <label>Note that the extension does not add additional nodes to the pattern paths. For high curvature, the result in
35            may therefore look aesthetically unpleasing. To avoid this, either add addition nodes manually, or convert all segments to curves beforehand.</label>
36        </page>
37    </param>
38    <effect>
39    <object-type>all</object-type>
40        <effects-menu>
41            <submenu name="Generate from Path"/>
42        </effects-menu>
43    </effect>
44    <script>
45        <command location="inx" interpreter="python">pathalongpath.py</command>
46    </script>
47</inkscape-extension>
48