This tool was written for my personal use only and therefore is very "quick and dirty" programmed, without fine data structures or an exeptable structure of classes. It was written in about 4-5 hours work just as an aide for myself trying out new patterns. I have no special error resolving parts in the tool (e.g. wrong input file names, mismatching number of cards vs. turns etc.) rather than some text messages so there might be a good chance that Java will thorw some exceptions when not creating the input files correctly. I even do not have any kind of repaint() or update() method so after the pattern is displayed in the Java application window and this window looses focus, the graphics will no longer be visible. Normally I just do a hardcopy after finishing a pattern and copy it to a graphics application, therefore I saw no need to implement any further things to that tool.
To use the tool after compiling go to the directory where the classfiles are located and enter java weave <subdir> (or java weaveo... for the "gridless" version) as a line command. In <subdir>, which is a subdirectory of the classfiles-directory, you have to create the 3 necessary input files:
The file must be named cards.txt and contains threading directions and threading pattern. An example (Ram's horn) looks like:
First line contains threading direction (either S or Z), the next lines (to a maximum of 8) contain the threading. First line is hole A, second line hole B etc. The hole next to the weaver on top of the card in A, then go forth clockwise (hole next to weaver bottom is B etc.). I am not sure now how I implemented S- and Z-twills (because authors have different opinions concerning the definitions of S- and Z-twills), so just try out.
The other letters in this file refer to the color in which the warp has to be threaded. The color is describes in the
The file must be named colors.txt. Every letter used in the threading instructions must be defines by a color here. The colors are defined via their RGB code, every number must have 3 digits. For the example above I used following data:
The file must be named turns.txt and have the same number of rows as cards.txt. In the file use "F" for forward turns, "B" for backward turns. For the example we get:
The threadings are repeated after the last line of this dataset.
This is how the results should look like when using the tool (with/without grid):