Difference between revisions of "The Eggbot Extensions v2.0"

Latest revision as of 07:45, 16 June 2011

This wiki page is part of the documentation for The Original Egg-Bot. Click here to return to the Egg-Bot overview.

Caution: This page refers to the features of an older version of the Egg-Bot software.

The Eggbot Extensions || Eggbot Control >>>

Note: This page assumes that you are using v2.1.0 or earlier of the Eggbot extensions. For v2.1 and later, see the v2.1 extensions page. You can check which version you are running with the * tab of the Eggbot Control extension.

Inkscape interacts with your Eggbot through a collection of "extensions" [1]. Inkscape extensions are simply pieces of software that extend the capabilities of Inkscape. Extensions have been so successful that Inkscape now ships with over a hundred. Additional extensions can be provided by third-parties. The Eggbot extensions are a case in point: they are Inkscape extensions provided by the Eggbot community. The primary purpose of the Eggbot extensions is to extend Inkscape by allowing it to "print" to your Eggbot.

To see which Eggbot extensions you have installed, launch Inkscape. Once Inkscape is running, pull down the "Extensions" menu. That will show you categories of extensions which are installed. By selecting the "Eggbot" category, you can then see the list of individual Eggbot extensions and select one to use,

If you do not see "Eggbot" listed as an extension category, see the Troubleshooting section below.

In the pages which follow, each of the following Eggbot extensions will be presented in detail,

• Eggbot Control
• Eggmazing
• Post process trace bitmap (experimental; available as a separate install)
• Preset hatch for fills
• Reorder Paths for Speed
• Strip Eggbot Data
• Your extension here?

The truly aswesome thing about Inkscape extensions is that you can write your own and share them with others. The only pre-requisite is learning a language called Python [2, 3]. You can see the source code to the Inkscape extensions by locating the extensions subdirectory in your Inkscape installation directory. Each extension is a file whose name ends with ".py". They are ordinary text files and no special tools are needed to read them. They can be written with a simple text editor.

Troubleshooting[edit]

If you do not see the Eggbot extension category, then you likely have not yet installed the Eggbot software. Please see Installing software for directions. Another possibility is that you have more than one version of Inkscape installed and you are running the wrong copy. Linux systems may come with Inkscape pre-installed. If you upgraded the Inkscape on your system, it is possible that the newer copy did not replace the older copy and you now have two copies installed.

Notes[edit]

[1] Presently, Inkscape only interacts with your Eggbot hardware through a single extension, "Eggbot Control." The other Eggbot extensions are tools which allow you to produce or modify Inkscape documents for use with your Eggbot.
[2] There are many online Python tutorials including the one maintained by the Python organization, The Python Tutorial.
[3] The Inkscape project provides some limited documentation on writing extensions at their wiki site. See the "Extensions" topic under the "Developer tutorials" section at their main wiki page. Studying existing extensions is a good way of supplementing the material found at the Inkscape wiki.

The Eggbot Extensions || Eggbot Control >>>