Difference between revisions of "Stipplegen"

From Evil Mad Scientist Wiki
Jump to: navigation, search
(Download)
(Usage)
Line 23: Line 23:
 
== Usage ==
 
== Usage ==
  
http://evilmadscience.s3.amazonaws.com/wiki/eggbot/stipplegen/v2docs/twain5kw-newframe.png
 
  
 +
http://evilmadscience.s3.amazonaws.com/wiki/eggbot/stipplegen/v2docs/grace2k-newframe.png
  
  
 +
When you first open up StippleGen, you will be presented with this window, which shows the drawing in progress (in the top part) and a set of controls below that.
 +
Rather than present you with a blank screen, StippleGen automatically loads a demo image ([http://commons.wikimedia.org/wiki/File:Kelly,_Grace_(Rear_Window).jpg source]) upon launch, and begins calculating. This way, you can try out the program, even if you don't have a good image of your own to start with. And, you can stop it at any time by loading a new image.
  
 
== Source Code ==
 
== Source Code ==
  
 
The StippleGen source code is available as part of the [http://code.google.com/p/eggbotcode/downloads/list?can=2&q=stipplegen StippleGen .zip file].  To run the code from source, you'll need to download [http://processing.org/ Processing], and install the [http://hg.postspectacular.com/toxiclibs/downloads toxiclibs library] and the [http://www.sojamo.de/libraries/controlP5/ ControlP5 library].
 
The StippleGen source code is available as part of the [http://code.google.com/p/eggbotcode/downloads/list?can=2&q=stipplegen StippleGen .zip file].  To run the code from source, you'll need to download [http://processing.org/ Processing], and install the [http://hg.postspectacular.com/toxiclibs/downloads toxiclibs library] and the [http://www.sojamo.de/libraries/controlP5/ ControlP5 library].

Revision as of 14:55, 31 May 2012


Introduction

graceegg-640.jpg

StippleGen is a free, open source, and cross-platform utility from Evil Mad Scientist Laboratories that can create stipple drawings (using Adrian Secord's algorithm) and TSP art from image files.

StippleGen saves its files as editable, Eggbot-ready Inkscape SVG files, which can in turn be opened by other vector graphics programs, or re-saved as PDF files for use in other contexts. It can also generate a TSP path from the stippled image, and either save that path as an SVG file or simply use that path as the order of plotting for the stipple diagram.

You can read an extended introduction to StippleGen at Evil Mad Scientist Laboratories.


Download

StippleGen is free and open source software, written in the Processing development environment. It comes ready to run on Mac, Windows, and Linux, and it is available for download here.

(StippleGen is hosted as part of the Eggbot project on Google Code.)


The download includes ready-to-run platform-specific versions of StippleGen for Mac, Windows, and Linux, as well as the source code. You will need to have a recent version of Java installed on your computer. (That is to say, if you can't get the version for your platform to run, please install Java and try again.)

Usage

grace2k-newframe.png


When you first open up StippleGen, you will be presented with this window, which shows the drawing in progress (in the top part) and a set of controls below that. Rather than present you with a blank screen, StippleGen automatically loads a demo image (source) upon launch, and begins calculating. This way, you can try out the program, even if you don't have a good image of your own to start with. And, you can stop it at any time by loading a new image.

Source Code

The StippleGen source code is available as part of the StippleGen .zip file. To run the code from source, you'll need to download Processing, and install the toxiclibs library and the ControlP5 library.