TRAINING BASED ESCREENING ALGORITHM
Hasib Siddiqui
October 1, 2008
------------------------------------------------
This package contains the following directory:
1) descreen/

The code and script files in the "descreen" directory
are for the actual descreening. The tool uses the default 
parameters (in filters/ directory) which were trained using 
images scanned with an HP Scanjet 8250. This descreening tool 
is quite robust for other scanned images but if you want to 
retrain the RS-based classification and re-create filter files for 
your own scanner, please use the "training" package, available
from the same location.

------------------------------------------------
Directories and Files
------------------------------------------------
This package contains the following directories.

- documentation/
      A command manual, a journal paper and other detailed description 
      about the algorithm 
- source_code/
      ANSI-C source code
- imgs/
      Test input and output images are here
- filters/
      Trained filter parameters. These files are used by the 
      programs in the source_code/ directory. 

This package contains the following files.

- run_descreen1
      You may test descreen tool using this script
- README
      Explanation about directories, how-to-compile and 
      how to test the program
- VERSION_INFO
      Version information


------------------------------------------------
How to compile?
------------------------------------------------

Please go to source_code/ directory and compile the files.
You may use "make" command on a Unix/Linux machine. 
If you want to clean all of the object files and executable
files, please use "make clean" command.

------------------------------------------------
How to test the commands?
------------------------------------------------
After you finish compiling the programs, 
please try the linux shell script "run_descreen1" to test the tool. 
The test input image is located in imgs/low/ directory and 
the output image will be created in imgs/high/ directory. 

------------------------------------------------
Command manual
------------------------------------------------
Please see the command manual in documentation/ directory. 

------------------------------------------------
Note
------------------------------------------------
The code has been tested on Windows XP, Linux, and Mac
Operating Systems, however the binary filter files
provided in the dirctory "descreen/filters" for RS-
based descreening will work only on Windows and Linux
machines. They will NOT work on a Mac because of the
different byte order issue.

