		
                       PREPIPS (alpha release)
		     ==========================
		           Suhail A Islam

PREPIPS is the postscript renderer which produces high quality
postscript output suitable for publication.     This directory
contains example files (actually created by PREPI). Input files
can be created by user or dumped from PREPI for convenience. It
then only remains for the user to "smarten-up" the image by
editing the input file to obtain suitable colours, degree of
smoothness etc.

After creating a postscript file YOU SHOULD ALWAYS VIEW IT ON
THE SCREEN prior to send it to a printer (as a postscript error
in the file can lead a printer to print the file as an ordinary
ascii file i.e. you will end up with 100's of pages of text - sad
for trees !).

It is strongly recomended that you try the examples in this
directory to see PREPIPS capabilities.


USING PREPIPS
--------------

To use PREPIPS

	% PREPIPS input_file output_postscript_file [-eps] [-pov]

where

	-eps	adds a encapsulated postscript header
		into the output file

	-pov	creates an input file suitable for the
		POV ray tracer. THIS OPTION IS NOT FULLY
		DEVELOPED AS YET. The output POV file is
		called fort.21

To view the output file on a silicon graphics use xpsview i.e.

	% xpsview output_postscript_file &



TO PRODUCE BLACK & WHITE
------------------------

Any input file for PREPIPS can be made to produce a BLACK & WHITE output
postscript file by:

Uncommenting* the "GLOBAL BlackAndWhite" line (this will replace any
non-grey (i.e. r=g=b colour components) by white
			OR
Explicitly setting colours of objects to black, white or grey's

* a line in the input file is ignored is it begins with a "!" or "%"



EXAMPLES IN THIS DIRECTORY
--------------------------

1gox.inp	Shows HELICES (CYLINDERS), STRANDS, COIL (SIMPLE). Also
		SECONDARY STRUCTURE PROFILE. Example of use is

		% prepips 1gox_0.inp output.ps
		% xpsview output.ps &

2hla.inp	Shows HELICES (RIBBON), STRANDS, COIL (SHADED)

5pti.inp	Shows FOUR PICTURES IN ONE using different types of
		displays to show the same view & data

5pti_0.inp	Shows COIL, SPECIFIC RESIDUE COLOURING, DEPTHCUE

5pti_1.inp	Shows CALPHA (LINES), SIDE-CHAINS, HETATM SPHERE, DEPTHCUE

1cyc.inp	Shows HELICES (CYLINDERS), COIL, HETATM BALL & STICK
		Picture is Black & White.

3fab.inp	Shows HELICES (RIBBON), STRANDS, COIL (SIMPLE-BLACK),
		SECONDARY STRUCTURE PROFILE & ELLIPSOID to show
		domains. Picture is Black & White.

hem.inp		HEM residue as ball & stick. The atom colours are
		defined by the "ELEMTYPE  O  red..." lines. To show
		simply BLACK & WHITE either set the colours in the
		ELEMTYPE lines to black,white & grey's or uncomment
		the "GLOBAL BlackAndWhite" line (this will replace
		any non-grey (i.e. r=g=b colour components) by white

shadow.inp	Shows a STRAND & TEXT with a backdrop shadow plane.
		Just for fun at present untill shadowing is developed
		properly	
