READ ME FOR FRAMES
R.F. Gildner
6 August 2003

INCLUDED IN THIS ARCHIVE ARE:

1. code - directory containing the Java source files for this program (.java extension)

2. classes - directory containg the Java class files for this program (.class extension)

5. README.txt - this file

DESCRIPTION OF PROGRAM:

Frames is a VERY crude program to digitize JPEG images of suture patterns. It allows the user to define a vertical direction in the image, and manually digitize points. It was created for the purpose of manually collecting data off published figures from the literature (per GILDNER, 2003. A FOURIER METHOD TO DESCRIBE AND COMPARE SUTURE PATTERNS. Palaeontologia Electronica). 

Input is expected to be JPEG image file.

The output files created is a text file (extension .dat) containing theta and h coordinates, one line for each point. The digitized data is rotated to the angle registered by the user, and the data is normalized such that the first point has coordinates 0,0 and the last point has theta=pi. An example line would be:
   3, 0.123. 0.456
The first number is the index of the point (first point is at index=0). Second number is the theta-coordinate. The third number is the h-coordinate.

PROGRAM CONTROLS AND EXECUTION

OPEN button: Clicking this button opens the standard dialog for opening files. Select the file in the manner normal for this dialog.
===============
IMPORTANT NOTE: The image file MUST be in the same directory as the class files!!
===============

ORIENT button: Before you can start to digitize the image, you MUST orient it. That is, you must click on two points of a vertical line in the image. Until you do so, you will not record any data. There is no user-feedback given during orientation.

Once you have oriented the image, further mouse-clicks in the image will digitize the points. The location of the point digitized will be displayed by a small white circle with a black border. Adjacent points are displayed with a line connecting them.

DELETE LAST POINT button: Clicking this button will delete the last point digitized. It and the line connecting it to the previous point will no longer appear on the image, and the point will not be recorded in the data saved. Any number of points may be deleted.

v, ^, <, and > buttons: This buttons "nudge" the last digitized point 1 pixel down, up, left or right, respectively. The movement of the point is reflected in the image displayed.

SAVE button: Clicking this button presents the standard dialog for saving a file. The name of the file is "Output.dat" by default. Format of the output file is described above.

IMPORTANT NOTE: Saving the data takes a few seconds. No signal is given that the save is complete. It is all too possible to close the program before the data is saved. The result is an incomplete output file.

CLOSE button: Clicking this button terminates the program.

IMPORTANT NOTE: Saving the data takes a few seconds. No signal is given that the save is complete. It is all too possible to close the program before the data is saved. The result is an incomplete output file.