Applet !EPS (requires Ovation Pro 2.55)
---------------------------------------

This Applet enables Encapsulated PostScript files to be loaded directly into
Ovation Pro. 

Support is provided for RGB EPS files, preseparated CMYK EPS files and CMYK
DCS (desktop colour separation) files. EPS files often contain a bit map
preview. DCS files come in fives, one main file and four files for the C, M,
Y and K planes.

EPS files can be embeded in documents or acessed via a reference just like
any other picture type.

EPS files often contain a bit map preview. This is used and acts in the same
way as a proxy for other picture types. It is not possible to create a new
proxy or remove the proxy. If the EPS file does not have a preview,
it will be represented on screen by a grey shaded rectangle with the same
dimensions as the picture.

EPS can't be rendered direct to the screen or to a non-PostScript printer.
If you print an EPS file to a non-PostScript printer, the preview image will
be used - probably producing poor results.

Typically the four CMYK DCS files will be referenced from the main file,
using name/extension style file names. The EPS applet understands the
usual . goes to / mapping as well as the Impression . goes to  mapping.

If a DCS file is embeded all 5 files will be loaded into memory. If a
reference is used all 5 files will remain on disc. Only the main file should
be dropped into the picture frame (typically the CMYK files will have .C,
.M, .Y or .K extensions).

If you have a PostScript printer the EPS applet will let you do neat tricks
like printing an OvationPro document to a file using the PostScript printer
driver and then loading that file as a picture in another document.

It may be useful to know that David Pilling's scanning software can save bit
map files in EPS format.



Limitations
-----------
The preview is convereted to a sprite, using ChangeFSI. This means only TIFF
previews can be handled. The conversion is done by calling a function in the
file !OEPS.Library.!EPSCode;

int eps_convert(string & from,int ftype,string & to);

The parameters are the source file name and type and the destination to
write the sprite to. The function should return 1 on success. Potentially
previews can also be in Windows Meta file format, so it may be possible to
call other conversion programs.

It is also possible to adjust the command line passed to ChangeFSI by
editing the code in this file.


It is not in general possible to image process EPS files or to produce
colour separations from them. Preseparated files will of course work, but
you can't expect any given RGB EPS file to be separated correctly.




Extensions
----------
You can generate a preview image for an EPS file, for example if an EPS file
does not have a preview built in or if you can do a better job.

This can be done via the function eps_makeproxy() in !OEPS.Library.!EPSCode.
This function should be of the form;

int eps_makeproxy(string & name,string & preview,int x0,int y0,int x1,int y1,string & to);

"name" is the file name of the EPS file 

"preview" is the file name of a file containing the preview image from the EPS
if there is one or a null string.

"x0,y0,x1,y1" are the bounding box of the image

"to" is the file name which a sprite preview image should be written to

The function should return 0 if successful.






Installing Applets
------------------
In order to use this Applet, it must be copied into the !OvnPro.Applets
directory and then Ovation Pro must be re-run.

Applets may be enabled/disabled by double-clicking over them. When disabled,
an Applet's name is suffixed with a '-'.

Ovation Pro must be re-run after enabling/disabling any Applets.
