CalligraphedOutlineFill - Revision history

Moini at 19:50, 3 February 2023

2023-02-03T19:50:58Z

← Older revision		Revision as of 19:50, 3 February 2023
Line 2:		Line 2:

	''Info: This idea has been superseded by the PowerStroke Live Path Effect.''		''Info: This idea has been superseded by the PowerStroke Live Path Effect.''

			----

	== Introduction ==		== Introduction ==

Moini at 19:37, 3 February 2023

2023-02-03T19:37:35Z

← Older revision		Revision as of 19:37, 3 February 2023
Line 1:		Line 1:
			{{Template:MovedToOtherSite\|topic=Extension development\|new_url=https://inkscape.gitlab.io/extensions/documentation/\|new_site=GitLab}}

			''Info: This idea has been superseded by the PowerStroke Live Path Effect.''

	== Introduction ==		== Introduction ==
	Graphic Tablet users using the Calligraphy tool can easily draw sketches with variable width outlines. However, filling the interior area of such a calligraphed outline is not so easy: if you try to apply the Fill tool to the path you just created, you are actually changing the style of the outline stroke itself - not that of the area it encloses...		Graphic Tablet users using the Calligraphy tool can easily draw sketches with variable width outlines. However, filling the interior area of such a calligraphed outline is not so easy: if you try to apply the Fill tool to the path you just created, you are actually changing the style of the outline stroke itself - not that of the area it encloses...

Dch: /* Expected Issues */

2007-05-10T18:55:58Z

Expected Issues

← Older revision		Revision as of 18:55, 10 May 2007
Line 22:		Line 22:
	* In case the observation about "just two L commands being present inside a Calligraphy-tool generated path" is wrong, the extension will not produce the expected result		* In case the observation about "just two L commands being present inside a Calligraphy-tool generated path" is wrong, the extension will not produce the expected result
	* If the extension is applied to anything else but a path just created with the Calligraphy tool, its behaviour will probably not be what you would like		* If the extension is applied to anything else but a path just created with the Calligraphy tool, its behaviour will probably not be what you would like
	* Especially: if you edit a path generated with the Calligraphy tool, the L position of the L commands inside the "d" attribute is not necessarily maintained		* Especially: if you edit a path generated with the Calligraphy tool, the L position of the L commands inside the "d" attribute is not necessarily maintained. This will definitely make the results of subsequently using this extension unpredictable.
	* Even if you do take the points above into account, it is most likely that small corrections will need to be ~~appied~~ to the dots corresponding to the very first and last ones in the original path. This is due to the "L" commands sometimes esthetically belonging to the shape you want to fill, sometimes not...		* Even if you do take the points above into account, it is most likely that small corrections will need to be applied to the dots corresponding to the very first and last ones in the original path. This is due to the "L" commands sometimes esthetically belonging to the shape you want to fill, sometimes not...
	* Of course, using this extension makes most sense on a path that was meant to be a more or less closed area.		* Of course, using this extension makes most sense on a path that was meant to be a more or less closed area.

TomK32: added category

2007-05-07T19:00:59Z

added category

← Older revision		Revision as of 19:00, 7 May 2007
Line 139:		Line 139:
	== Conclusion ==		== Conclusion ==
	I'm routinely using this extension for my own drawing purposes. Suggestions to improve the functionality, the quality of the code etc are quite welcome !		I'm routinely using this extension for my own drawing purposes. Suggestions to improve the functionality, the quality of the code etc are quite welcome !

			[[Category:Extensions]]

Dch: Extension to fill calligraphed outlines

2007-05-07T18:10:11Z

Extension to fill calligraphed outlines

New page

== Introduction ==
Graphic Tablet users using the Calligraphy tool can easily draw sketches with variable width outlines. However, filling the interior area of such a calligraphed outline is not so easy: if you try to apply the Fill tool to the path you just created, you are actually changing the style of the outline stroke itself - not that of the area it encloses...

You can manually copy the calligraphed outline and edit the dots it is made of to just remove the inner dots to obtain a path covering the area you are interested in, then apply the Fill tool to that new path...
or you can try using the Python extension with source code below.

== Method ==
This extension was built on the observation that the Calligraphy tool creates a path that starts at the point where you started to draw, and is apparently completely made of curves (C commands in the "d" attribute of the created path element) - except for two lines (L commands in the "d" attribute): one marking the end of the stroke you drew (about mid way through the "d" element"), and one at the beginning of the stroke (last command in the "d" element before the final "z" command).

The proposed extension will:
# loop through each of the paths you selected before calling the extension
# for each such path:
## create a copy of the current "path" element
## in the "d" attribute of that copied path: truncate away everything happening after the first "L" command encountered inside that attribute
## give a default style of "fill navy blue - no line" to that new path
## create a "g" element in the document, just before the presently selected path
## first put the duplicate path in that group
## put a copy of the original path inside the group (so that the original path is displayed in front of the created "fill" area)
## delete the original path from the document

== Expected Issues ==
* In case the observation about "just two L commands being present inside a Calligraphy-tool generated path" is wrong, the extension will not produce the expected result
* If the extension is applied to anything else but a path just created with the Calligraphy tool, its behaviour will probably not be what you would like
* Especially: if you edit a path generated with the Calligraphy tool, the L position of the L commands inside the "d" attribute is not necessarily maintained
* Even if you do take the points above into account, it is most likely that small corrections will need to be appied to the dots corresponding to the very first and last ones in the original path. This is due to the "L" commands sometimes esthetically belonging to the shape you want to fill, sometimes not...
* Of course, using this extension makes most sense on a path that was meant to be a more or less closed area.

== How to best use the extension ==
# draw your sketch with the Calligraphy tool (many separate strokes are OK)
# select all the strokes, the inside of which you would like to see filled in
# apply the extension
# fine-tune the start and end dots of the generated fill areas
# change the default fill color to the one you wish
# apply transforms to the generated groups of "original stroke + fill area" if you wish to alter their shapes

== Source code ==
Two files to be created in the "extensions" folder of Inkscape

=== File: fillstroke.inx ===
<pre>
<inkscape-extension>
<_name>FillStroke</_name>
<id>org.dch.fillstroke</id>
<dependency type="executable" location="extensions">fillstroke.py</dependency>
<dependency type="executable" location="extensions">inkex.py</dependency>
<effect>
<object-type>path</object-type>
<effects-menu>
<submenu _name="Stroke"/>
</effects-menu>
</effect>
<script>
<command reldir="extensions" interpreter="python">fillstroke.py</command>
</script>
</inkscape-extension>
</pre>

=== File: fillstroke.py ===
<pre>
#!/usr/bin/env python
'''
Copyright (C) 2007 Didier Chalon, chalondidier@skynet.be

version 2.2
1.0: first working version - just connecting the average dots
1.1: also average the tangents
2.0: keep stroke outline by pruning before first L
2.1: insert filled area before parent stroke
2.2: group parent stroke and filled area

From selected stroke:
* assume the stroke "end point" is the first L command in the d attribute
* prune before first L

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
'''
import inkex, simplepath

class FillStroke(inkex.Effect):
def __init__(self):
inkex.Effect.__init__(self)

def effect(self):

for id in self.options.ids:

# just keep selected paths
node = self.selected[id]
if node.tagName =='path':
d = node.attributes.getNamedItem('d').value
#inkex.debug(d)
else:
self.options.ids.remove(id)

#find first L
dEnd = d.find("L") - 1
#inkex.debug(d[:dEnd])

#create group to hold parent stroke and filled area
newGroup = self.document.createElement('svg:g')
newGroup.setAttribute('inkscape:groupmode','layer')

#append group before parent stroke
node.parentNode.insertBefore(newGroup,node)

#create filled area as stripped path
newPath = self.document.createElement('svg:path')
newPath.setAttribute('d',d[:dEnd])
newPath.setAttribute('style','display:inline;fill:#00004a;stroke:none;stroke-opacity:1;fill-opacity:1')

#append stripped path to group
newGroup.appendChild(newPath)

#copy parent stroke
copyStroke = node.cloneNode(1)

#append copy of parent stroke to group
newGroup.appendChild(copyStroke)

#remove original stroke
node.parentNode.removeChild(node)

e = FillStroke()
e.affect()
</pre>

== Conclusion ==
I'm routinely using this extension for my own drawing purposes. Suggestions to improve the functionality, the quality of the code etc are quite welcome !