Editing Making your first plot

So now you have your EggBot assembled and connected, and you've installed Inkscape and the EggBot extension (and any necessary USB drivers).  How do you get set up to draw with the Eggbot?  This page has the essential details that you need to get started, along with a video that walks you through most of it.


= Using the Inkscape EggBot Control Extension =

The Inkscape EggBot Control Extension is the tool that you will use to help you test and align the EggBot, as well as transfer your drawings to an egg.  First you'll need to start Inkscape.  Once Inkscape is running, you'll have an '''Extensions''' menu, and on that menu will be a submenu labeled '''Eggbot'''.  In that submenu are several different extensions that perform various Eggbot-related tasks.  By far the most important of these is the '''Eggbot Control...''' extension, which is the program that actually communicates with the Eggbot.


The [[Eggbot Control]] dialog has eight tabs.  The first two tabs, "'''Plot'''" and "'''Setup'''" provide the basic controls to set up and use the Eggbot.  The other six tabs provide a variety of advanced options and information.

* '''Plot''' -- This tab is used to transfer (plot) a drawing from Inkscape to the egg.
* '''Setup''' -- Use this tab to set the pen's up and down positions, or to enter into alignment mode (where the motors are off and the pen is up).
* '''Timing''' -- This tab will allow you to tweak some of the timing values for EggBot actions.
* '''Options''' -- This tab will allow you to configure some of the EggBot's behavior.
* '''Manual''' -- This tab will allow you to control the EggBot itself (turning motors, lifting/dropping the pen, etc.)
* '''Resume''' -- This tab describes how to pause a plot, and how to resume plotting.
* '''Layers''' -- This tab will give you control over which drawing layers to plot (for multi-color drawings).
* '''`*`''' -- This tab will display version information about the Eggbot extension and (sometimes) release notes.

= Prepare your EggBot for drawing on eggs =

Your first instinct will be to put a pen in the pen arm, put an egg in the egg cups, and start drawing.  '''This is an excellent way to frustrate yourself and ruin an egg.'''  Instead, you want to be able to place an egg in the egg cups such that the egg is evenly aligned, and the pen arm will have firm contact with the egg as it rotates.  

To do that, follow these steps:

1. '''Calibrate the pen up/pen down positions'''.  

{{sized-external-image|470px|https://cdn.evilmadscientist.com/wiki/eggbot/extensiontut/ext3_setup.jpg}}

:* This is part of the initial setup; you won't have to do this every time.   
:* From the '''Setup''' tab, select "Toggle pen up/down".  Then, click apply several times.  As you do so, the servo motor should move up and down between two different positions.  
::  If your servo motor does not move, check that it's connected to the right location and that the EBB has both power (from the plug in power supply) and the USB connection to your computer.  
:* Adjust the two percentage values for the pen up position and pen down positions such that:
::* The pen arm is roughly horizontal, or very slightly below, when "down" 
::* The pen arm is very slightly above horizontal when in the "up" position
:* Typically you want about 5 mm (a little under 1/4") of total travel between the two positions.  
:* This amount of range may correspond to only a few percent difference between the up and down positions.

2. '''Set the motors'''.  From the '''Setup''' tab, select '''Raise pen, turn off motors''', then click '''Apply'''. This will unlock the motors, leaving them free to rotate, with the pen arm in the right position to put a pen over the egg.

3.  '''Set the pen arm arc depth'''.  That is to say, a different setup is needed if you're printing on a sphere (like a golf ball) than if you're printing on an egg-shaped object.  
The pen motor mounts with screws through slots, so that the depth of its drawing arc can be changed.  On the inside of the chassis sidewall, there's a gauge and some simple illustrations indicating rough positions for the motor.  A chicken egg will typically use the center position; a round glass bulb (such as a lightbulb or decorative ball) will use the top position; a duck or goose egg may need the bottom position.  Gently loosen the screws, slide the motor to the correct height, and then gently tighten the screws.

4. '''Align the headstock'''.  The headstock (containing the egg motor) is connected to each of the sidewalls with 3 screws.  Gently loosen the screws on each side until the headstock barely slides.  You'll want to slide the headstock until the equator of an egg placed against the headstock (south pole towards the headstock)  is directly beneath the pen arm.  Once you like the position of the headstock, set the egg aside and tighten the headstock screws on each sidewall, taking care to ensure that headstock meets each sidewall at the same place on the gauges.

5. '''Align the tailstock'''.  The tailstock (containing the spring-loaded plunger) is connected to the sidewalls with screws, just like the headstock.  Gently loosen the screws on each side until the tailstock barely slides.  With an egg placed against the headstock egg cup, set the egg's north pole in the plunger egg cup, and then slide the tail stock until the plunger O-ring (between the two sides of the tailstock) is roughly in the middle.  Once you like the position of the tailstock, tighten the tailstock screws on each sidewall, taking care to ensure that tailstock meets each sidewall at the same place on the side scales.

6. '''Place a pen in the pen arm'''.  Uncapped, point down, (of course) so you can judge how it will align with the egg.  Tighten the thumbscrew to fix the pen position.  Rotate the pen arm until it is vertical.

7.  '''Set the pen arm height'''.  Place an egg between the egg cups, and a pen in the pen arm such that the pen is a few millimeters above the surface of the egg when it is in the "up" position.  You may need to raise or lower the pen arm, by loosening the thumbscrew that holds the proximal pen arm to the pen arm backer.  Tighten the screw when the pen is just above (several millimeters above) the egg surface. Swivel the pen arm over the egg to check clearance.


= Mount An Egg in the EggBot =

# Remove pen (if any) from the pen arm.
# Start with a clean, dry, room-temperature, raw egg.   (If it's not an egg, it's likely to already be room temperature, dry and raw. Make sure that it's clean, too!)
#* Dry, so your marker will adhere.
#* Room-temperature, so that your egg will stay dry.
#* Raw, so that you can empty it out afterwards, in the event that you get a good one.  (Yes, you could hard-boil your eggs, but then you'll have to break them to get the centers out. Or you could empty them first, but that's an awful lot of effort if an egg doesn't turn out right.)
#* Clean, so that ink flow is not affected by grease on the surface. You may even want to use rubber gloves for handling your eggs to keep greasy finger prints off (especially important if using technical pens with very fine nibs.)
# Pull back the plunger and roughly center the end of the egg on the headstock.  Gently return the plunger to the other end of the egg. Spin the egg to see if it is centered, and adjust its position in the two egg cups as necessary.  (You want as little wobble as you turn your egg as possible -- more wobble will leave to uneven drawings.)


= Preparing your drawing =

It's best to start with a document that's 800 pixels tall by 3200 pixels wide -- you can use the Eggbot Template from the set of example files as a good starting point.  Eggbot draws paths -- continuous lines -- not bitmap images, and not solid filled regions.    Certain object types are automatically treated as paths, for example circles and rectangles.  Other types of objects that are made of lines -- like outlined text -- may need to be converted to paths (Path menu > Object to path) before plotting.  A good first plot might be the "Hello world" example file.  

(If you have not already, you may also want to download the set of example files from the [http://code.google.com/p/eggbotcode/downloads/list?q=label:Featured EggBotCode Google Code site].)


= Drawing on your Egg =

# From the '''Manual''' tab, select '''Enable Motors''', then click '''Apply'''.  Then select '''Raise Pen''' then click '''Apply'''.  
# Put a pen in the pen arm. 
# Begin with vector art in inkscape. 
# From the '''Plot''' tab, press apply, and the EggBot should print the entire drawing.

For multiple color printing, keep different color information in separate layers of your Inkscape document named with an initial number. (e.g. 1-red, 2-black). Use the '''Layers''' tab to plot layer by layer, changing the pen between layer plots.


= Setup video =

We've put together a 15-minute video walking you through the process of setting up the servo motor positions, aligning an object in the bot, and making your first plot.  You can [http://www.youtube.com/watch?v=3zsbW9qmZk4 watch it on YouTube here].