Stitch'n'Glitch - open-source image corruption and cross stitch pattern software

(www.stitch-n-glitch.com)
version 3 - summer 2014
Designed and coded by Andrew Healy (www.andrewhealy.com, werdnah19@gmail.com)
OVERVIEW:
This program was intended as a combined image-corruption and cross-stitch patter
n generator. Along the way some other functionalities were added but it remains
a simple, small application to preform this very specific task. There are other,
more powerful cross-stitch pattern generators available both online and off as
well as various image-corruption facilities. This application was never intended
as the fastest, most powerful or fullest-featured pattern generator - rather a
product of my personal artistic exploration into the aesthetic possibilities of
mixing the electronic "glitched" image with a hand-crafted cross-stitch.
This is an open-source project in appreciation of textile art's history of shari
ng techniques and patterns. Feel free to modify for your own use in keeping with
the same spirit.
This document just covers the basics. For some useful tips & tricks, videos, faq
s etc., visit stitch-n-glitch.com/docs/
**************************************************************************
System Requirements:
You need to have the Java Runtime installed. It can be downloaded from http://ja
va.com/en/download/index.jsp . Mac users can check if their Java is up to date b
y requesting a software update check.
INSTALLATION: Uncompress the .zip file to a writable location. Make sure the dir
ectory structure of the root folder and the source folder is maintained.
***************************************************************************
BASIC USAGE:
- Double-click the "Stitch_n_Glitch.jar" file to launch the program.
- You will be prompted for an image. It must be an RGB .jpg or .gif file.
- To make utilise all the options, the image must be less than 80kB in file size
and less than 500,000 pixels when measured width x height.
- To just use Stitch'n'Glitch as a glitching/dithering/image export tool, the im
age must be less than 100kB
- Make any adjustments you desire to the Glitch slider, brand check boxes, Dithe
r type, Colour Reduction / Preset Palette, and press either "Glitch" or "Update"
. Note: No glitch will be applied if the Glitch amount slider is set to 0. No co
lour conversion will happen unless at least one of the brand checkboxes id selec
ted.
- If you get the "Broken image" symbol over your image and a message saying "Red
uce Glitch or Try again", don't worry. A broken image can be the result of the r
andom glitching process. As the message advises: "Reduce Glitch or Try again".
- You can do this as may times as you like; your previous 4 successful glitches
are stored in memory.
- When you get one you'd like to stitch, click on the "Export" tab (along the to
p).
- Here select the image you'd like to export by using the buttons on the left or
by clicking directly on the image.
- Make the selections for the files you'd like to export. The options can vary a
ccording to the amount of colours in the image, brand of floss selected and file
size.
- Enter a name for the folder you'd like these files to be written to and press
ENTER. Your files will be written to a folder of that name inside the "exports"
folder (that sits beside the application). If you didn't enter a folder name, th
ey will be written to either the previously entered name or a folder called "def
ault".
- All files are given a timestamp to further distinguish between exports and aid
grouping of xports from the same image.
- Your files will be called (XXX denotes the timestame):
pattern-XXX.pdf (either multipage/single page cross stitch pattern. B&W or col
our symbols)
colorList-XXX.pdf (key for the pattern. Contains colours, brand codes, assigne
d symbols, num. of stitches for each colour)
image-XXX.tiff (bitmap image export. Exported automatically with patterns)
data-XXX.csv (comma separted values for each pixel's hexidecimal notation. For
further data processing perhaps)
vector-XXX.pdf (vector image. Useful for large-scale printing)
This is only a brief run-though (there was no mention of the Palette features, e
ven). For more detail, visit www.stitch-n-glitch.com/docs/
***************************************************************************
COMPILING FROM SOURCE:
- Open Eclipse and create a new Java Project (File -> New -> Java Project)
- Name it whatever you want
- Uncheck "Use default location" and instead select the "source" folder inside t
he download
- Leave the rest as default and click "Finish"
- Open "Sng3.java" in the editor. This is the class containing the "main" method
- Click Run -> Run As -> Java Application
- The first time, you my be prompted for the location of the main method: select
the "Sng3" class
***************************************************************************
ACKNOWLEDGEMENTS
-Coded 2012 (revised 2013, revised again 2014) by Andrew Healy (andrewhealy.com,
cognate.ie)
-Built with Processing (processing.org) and Eclipse using the controlP5 library
(sojamo.de/libraries/controlP5/) for GUI components.
-Image-corruption code adapted from the "Corrupt" project by Benjamin Gaulon (re
cyclism.com).
-DMC floss to RGB/HEX conversion from a document at http://www.radicalcrossstitc
h.com/
-Dithering algorithms ported to Java from the Macro code found at http://fiji.sc
/wiki/index.php/Dithering
-Many thanks to the Processing community for sharing their knowledge.
-Project inspired by the "Lost Threads" research project and blog (lost threads.
tumblr.com)