Editing WaterColorBot Software

{{WaterColorBotDocs}}


== WaterColorBot Software ==


There are three main software interfaces for driving the WaterColorBot: [[RoboPaint]], [[RoboPaint RT]], and the [[Inkscape_and_WaterColorBot|Inkscape extensions for WaterColorBot]].  


Briefly, to describe the three interfaces:
* The [[Inkscape_and_WaterColorBot|Inkscape extensions for WaterColorBot]] allow you to create and paint artwork with a very fine level of control, either within Inkscape, or by exporting SVG graphics to RoboPaint.
* [[RoboPaint]] is automatic painting software, which is sometimes your best choice when starting from an existing drawing in SVG format.
* [[RoboPaint RT]] is an independent real-time painting application, in which you paint on your computer, and the robot follows along in real time.


Much more information about these programs are on their respective pages, linked above.


== For Young Programmers  ==

* You can program the WaterColorBot in both [http://scratch.mit.edu Scratch] and [http://snap.berkeley.edu ''Snap!''] Our example code for these projects, "WaterColorBlocks" is available [https://github.com/evil-mad/WaterColorBlocks here]. You will also need to run RoboPaint (0.9.0 or newer) in the background, as an interface to the WaterColorBot.  

Of the two, we have generally found the ''Snap!'' interface to be more enjoyable and reliable.

* An alternative block-based programming interface is [http://beetleblocks.com BeetleBlocks], a Scratch-like programming environment for making 3D creations ("Visual Code for 3D Design"). BeetleBlocks can save its 2D curves as SVG files, which you can open and print from within RoboPaint.


== For Developers  ==

A brief overview of where to get started:
* RoboPaint is written in Javascript.  Its github repository is [https://github.com/evil-mad/robopaint/ here].
* RoboPaint RT is written in Processing/Java Its github repository is [https://github.com/evil-mad/robopaint-rt/ here]
* The Inkscape extensions are written in Python.  Their github repository is [https://github.com/evil-mad/wcb-ink here]
* The RESTful [https://github.com/techninja/cncserver/blob/master/API.md WaterColorBot API] is built into RoboPaint.
* You can also send low-level commands directly to the EBB over USB, from any program that can write to a serial port.  Command documentation for the EBB can be found [http://evil-mad.github.io/EggBot/ebb.html here].