Editing Post process trace bitmap

{{EggBotDocs}}

----

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace09.png

== Introduction ==

The "Post process trace bitmap" extension moves to distinct Inkscape layers each collection of regions of the same color or gray tone which were traced by Inkscape's "Trace Bitmap" tool.  This extension can optionally remove the color fill applied by that tool, add outlines of the regions, or remove from the drawing the original bitmap image which was traced.


'''Important note:''' Post process trace bitmap is no longer included by default with the EggBot extensions for Inkscape. It is still available [https://github.com/evil-mad/EggBot/tree/master/inkscape_contributed in our repository] for manual installation.



In the presentation which follows, Inkscape's Trace Bitmap tool is discussed.  However, this is not a tutorial on the use of that tool.  For tutorials on tracing bitmaps, please see the links cited on the [[Tracing images]] page.

== Using the extension ==

As this extension assumes a specific usage of Inkscape's Trace Bitmap tool, the basic procedure of using that tool is demonstrated.  This demonstration does not concern itself with the tool's "single scan" options nor the options on tabs other than the tool's "Mode" tab.  Consequently, all the nuances of getting nice results from the Trace Bitmap tool are ignored in that which follows: those nuances are not relevant to the discussion at hand.

'''1.''' First, begin with a new Inkscape drawing.  Do not attempt to operate on an existing drawing with other material in it.  When you are done using this extension, you can cut and paste the results to another drawing.

From the "File" menu, use the "New" item to begin a new document.  Into that document, import your bitmap graphic using the "Import..." item under the "File" menu,

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace01.png


'''2.''' After you select the bitmap image file, you will be asked whether to embed the image in the new document or link to it.  Select "embed"  and click "OK",

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace02.png


'''3.''' Once the image is imported, position it somewhere on the drawing page,

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace03.png


'''4.''' With the image selected, choose the "Trace Bitmap..." option from the "Path" menu,

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace04.png


'''5.''' In the Trace Bitmap tool, use either the "Colors" or "Grays" mode of the "Multiple scans: create a group of paths" section.  Uncheck the "Stack scans" box.  The "Smooth" and "Remove background" boxes can be checked. 

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace05.png


'''6.'''  Set the number of scans to the desired number.  Then, click the "Update" button.  Adjust other settings as you see fit, but be sure to use either "Colors" or "Grays".  And be sure to leave "Stack scans" unchecked.

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace06.png


'''7.'''  Once you are satisfied with your results, click the "OK" button.  Then dismiss the Trace Bitmap window.  The result will then appear in your drawing.  The drawing may not  look too different than from before as the image is still embedded in it as well.

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace07.png


'''8.''' Now, from the EggBot category of the "Extensions" menu, select the "Post process trace bitmap" item,

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace08.png


'''Note:''' This extension now appears in the "Eggbot Contributed" submenu of the extensions menu. 


'''9.''' When the extension is launched, you will be given several options.  Check the box to remove the original image from your drawing.  Check or uncheck the other two items according to your needs.  Then click the "Apply" button.

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace09.png


'''10.''' After the extension runs, you will be presented with a window indicating how many layers were created.  Click the "OK" button.  Then, to dismiss the extension window, click its "Close" button.  Within your drawing window, you can examine the various layers with the "Layers..." item under the "Layer" menu.  In the following figure, several layers have been turned off,

http://evilmadscience.s3.amazonaws.com/wiki/eggbot/trace/trace10.png

== Options ==

The extension provides three options:

;Remove original bitmap image?:Checking this box will remove '''all''' images within the current document.  So, the question is a little misleading.  However, the intent is to automatically remove the traced bitmap image, saving you that step.  Check the checkbox if you'd like the images to be removed.

;Fill each traced region with color?:The results of the Trace Bitmap tool will normally have the scanned regions each filled with the ""scanned" color.  Leaving this box checked will preserve those fills.  If you wish the fills turned off, then uncheck this box.

;Outline each traced region?:The Trace Bitmap tool only fills the regions it traces.  It does not outline them.  By checking this box, each traced region will be outlined.  The color of the outline will correspond to the "scanned" color for that region.  Note that the outlines for each region may overlap one another.  This is because SVG does not provide a means of specifying an "inset" outline.  Instead the outline strokes have a non-zero width and half of this width falls outside of the region being outlined.  The other half falls inside the region.

== Using in Inkscape 1.0 ==

This extension doesn't work under Inkscape 1.0 as is in the official repository. An update has been submitted as a PR [https://github.com/evil-mad/EggBot/pull/149/files here] which allows it to work under Inkscape 1.0.