Editing RoboPaint RT

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 4: Line 4:
 
== Overview ==
 
== Overview ==
  
RoboPaint RT is the "Real Time" Painting Software that allows you to paint with the [[WaterColorBot]].  It runs under Mac, Windows, and Linux.   
+
RoboPaint RT is the "Real Time" Painting Software that allows you to paint with the [http://watercolorbot.com WaterColorBot].  It runs under Mac, Windows, and Linux.   
  
 
RoboPaint RT is straightforward and manual: Click on a color in the paint palette to change to that color, click on the water to dip the brush in the water, and drag the brush to paint on your paper.  
 
RoboPaint RT is straightforward and manual: Click on a color in the paint palette to change to that color, click on the water to dip the brush in the water, and drag the brush to paint on your paper.  
Line 13: Line 13:
 
== Getting RoboPaint RT ==
 
== Getting RoboPaint RT ==
  
RoboPaint RT is a Java application, and requires that you download and install Java on your computer running it.
+
=== Running Within Processing ===
 +
 
 +
We currently recommend all users to download and install Processing to run RoboPaint RT; we will be streamlining this process over the next week or so, and we apologize for the rough process.  (There are reliability issues with the stand-alone applications, and we are providing this rougher but more robust alternative method until those are sorted out.)
 +
 
  
 
* First, install the [http://java.com/en/ latest version of Java] on your computer.  
 
* First, install the [http://java.com/en/ latest version of Java] on your computer.  
* Then, download RoboPaint RT for your platform, from  [https://github.com/evil-mad/robopaint-rt/releases our releases page].     
+
* Download and install [https://processing.org/download/ Processing 2.1] for your operating system.
 +
* Download the Ani library from [http://www.looksgood.de/libraries/Ani/ this site], and install it in your Processing libraries folder.
 +
* Finally, download and unzip the RoboPaint RT ZIP file [https://github.com/evil-mad/robopaint-rt/archive/master.zip from our github account].     
  
 +
From within Processing, open up the RoboPaint RT Sketch.  You can find it at:  robopaint-rt-master>processing>RoboPaint_RT>RoboPaint_RT.pde
  
Important note for Windows users:  The WaterColorBot requires a USB driver as well (on Windows only). The installer for this driver is included with the RoboPaint installer (available [https://github.com/evil-mad/robopaint/releases here]).
 
  
 +
=== "Stand-Alone" executables ===
  
 +
''Ready-to-use executable versions are in progress, expected to be posted the week of November 10, 2013.''
  
 
== Using RoboPaint RT ==
 
== Using RoboPaint RT ==
 +
 +
'''''Additional information coming week of November 10, 2013.'''''
  
 
=== Overview ===
 
=== Overview ===
Line 33: Line 42:
 
* Raise and lower the brush holder, and insert your brush at an appropriate height
 
* Raise and lower the brush holder, and insert your brush at an appropriate height
 
* Begin painting!
 
* Begin painting!
 
 
<img src="http://evilmadscience.s3.amazonaws.com/wiki/watercolor/robopaint-rt/robopaint_rt.jpg">
 
 
In basic usage, click the paint pans to change color, click the water dishes to dip, and drag on the paper to paint.
 
  
  
Line 52: Line 56:
 
RoboPaint RT works by recording user gestures in real time while making a painting.  The literal record of gestures that it replays can be saved as a RoboPaint RT file (.rrt file format), to be opened later and continued or painted.  Use the Open File and Save File buttons in the program to open or save a file, respectively.  
 
RoboPaint RT works by recording user gestures in real time while making a painting.  The literal record of gestures that it replays can be saved as a RoboPaint RT file (.rrt file format), to be opened later and continued or painted.  Use the Open File and Save File buttons in the program to open or save a file, respectively.  
  
RoboPaint RT gesture recordings are not drawings in the traditional sense; .rrt files cannot be opened or generated by any other drawing or painting program.
+
RoboPaint RT gesture recordings are not drawings in the traditional sense; .rrt files cannot be opened or generated by any other drawing or painting program.
 +
 
  
 
== Troubleshooting ==
 
== Troubleshooting ==
Line 61: Line 66:
 
Make sure that both the USB cable and the power supply are plugged in.  If the USB cable is plugged in but power is not, the WaterColorBot will be responsive to your computer, but the motors will not move.  
 
Make sure that both the USB cable and the power supply are plugged in.  If the USB cable is plugged in but power is not, the WaterColorBot will be responsive to your computer, but the motors will not move.  
  
=== Cannot find WaterColorBot ===
+
=== Cannot connect to WaterColorBot ===
  
 
If the USB cable is not connected, or if the WaterColorBot is already on use on your computer, you may get a message telling you that the program could not find the WaterColorBot: "WaterColorBot not found.  Entering Simulation Mode."
 
If the USB cable is not connected, or if the WaterColorBot is already on use on your computer, you may get a message telling you that the program could not find the WaterColorBot: "WaterColorBot not found.  Entering Simulation Mode."
 
In this case, you can play with RoboPaint RT-- even create and save files without the WaterColorBot present --but no further attempt will be made to communicate with the WaterColorBot.  Quit and relaunch the program to try connecting again, once you have checked your cables.
 
 
 
For additional hints, please see [[WaterColorBot_Troubleshooting#Computer_cannot_find_WaterColorBot|our troubleshooting page]].
 
  
  
Line 75: Line 75:
  
 
If you are certain that Java *is* installed, you may need to manually add Java to the PATH in your system preferences.
 
If you are certain that Java *is* installed, you may need to manually add Java to the PATH in your system preferences.
 
  
 
=== Motion is jerky/stutters ===
 
=== Motion is jerky/stutters ===
Line 85: Line 84:
  
 
== For Developers ==
 
== For Developers ==
 
=== Repository ===
 
RoboPaint RT is maintained at [https://github.com/evil-mad/robopaint-rt/ our github repository]. 
 
 
=== Bugs and feature requests ===
 
 
Please use the [https://github.com/evil-mad/robopaint-rt/issues issues page] at our repository to report bugs and request new features for RoboPaint RT.
 
  
 
=== Running RoboPaint RT within Processing ===
 
=== Running RoboPaint RT within Processing ===
* Download and Install Processing, from [http://processing.org processing.org].  We recommend Processing version 2.0.3, NOT version 2.1 (which has known serial issues).  Windows users: Please install the 32-bit version, not the 64 bit version (again, known serial issues).
+
* Install Processing, from processing.org  
  
 
* Download and install ani library, from  http://www.looksgood.de/libraries/Ani/
 
* Download and install ani library, from  http://www.looksgood.de/libraries/Ani/

Please note that all contributions to Evil Mad Scientist Wiki are considered to be released under the GNU Free Documentation License 1.3 (see Evil Mad Scientist Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)

Template used on this page: