MAN page from Other ghostscript-docs-8.54-3.i386.rpm

PS2EPSI

Section: Ghostscript Tools (1)
Updated: 17 May 2006
Index

NAME

ps2epsi - generate conforming Encapsulated PostScript

SYNOPSIS

ps2epsi infile.ps [ outfile.epsi ] (Unix)
ps2epsi infile.ps [ outfile.epi ] (DOS)

DESCRIPTION

ps2epsi uses gs(1) to process a PostScript(tm) file andgenerate as output a new file which conforms to Adobe's EncapsulatedPostScript Interchange (EPSI) format. EPSI is a special form ofencapsulated PostScript (EPS) which adds to the beginning of the file inthe form of PostScript comments a bitmapped version of the final displayedpage. Programs which understand EPSI (usually word processors or DTPprograms) can use this bitmap to give a preview version on screen of thePostScript. The displayed quality is often not very good (e.g., lowresolution, no colours), but the final printed version uses the realPostScript, and thus has the normal PostScript quality.

USAGE

On Unix systems invoke ps2epsi like this:

ps2epsi infile.ps [ outfile.epsi ]

where "infile.ps" is the input file and "outfile.epsi" is the resultingEPSI file. If the output filename is omitted, it is generated from theinput filename. When a standard extension (".ps", ".cps", ".eps" or".epsf") is used, it is replaced with the output extension ".epsi". OnDOS systems the command is:

ps2epsi infile.ps outfile.epi

where "infile.ps" is the original PostScript file, and "outfile.epi"is the name of the output file.

LIMITATIONS

Not every PostScript file can be encapsulated successfully, because thereare restrictions on what PostScript constructs a correct encapsulated filemay contain. ps2epsi does a little extra work to try to helpencapsulation, and it automatically calculates the bounding box requiredfor all encapsulated PostScript files, so most of the time it does a prettygood job. There are certain to be cases, however, where the encapsulationdoes not work because of the content of the original PostScript file.

COMPATIBILITY

The Framemaker DTP system is one application which understands EPSIfiles, and ps2epsi has been tested on a number of PostScript diagramsfrom a variety of sources, using Framemaker 3.0 on a Sun workstation.Framemaker on other platforms should be able to use these files, although Ihave not been able to test this.

FILES

ps2epsi	Unix shell script
ps2epsi.bat	DOS batch file
ps2epsi.ps	the Ghostscript program which does the work

VERSION

This document was last revised for Ghostscript version 8.54.However, the content may be obsolete, or inconsistent with ps2epsi.txt.

AUTHOR

George Cameron

This document was created byman2html,using the manual pages.