manual/ghostscript/original/man1/ps2epsi.1

   1 .TH PS2EPSI 1 "29 March 2022" 9.56.0 "Ghostscript Tools" \" -*- nroff -*-
   2 .SH NAME
   3 ps2epsi \- generate conforming Encapsulated PostScript
   4 .SH SYNOPSIS
   5 \fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epsi\fR ] \fB(Unix)\fR
   6 .br
   7 \fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epi\fR ] \fB(DOS)\fR
   8 .SH DESCRIPTION
   9 \fBps2epsi\fR uses \fBgs\fR(1) to process a \fBPostScript\fR(tm) file and
  10 generate as output a new file which conforms to Adobe's \fBEncapsulated
  11 PostScript Interchange\fR (EPSI) format.  EPSI is a special form of
  12 encapsulated PostScript (EPS) which adds to the beginning of the file in
  13 the form of PostScript comments a bitmapped version of the final displayed
  14 page.  Programs which understand EPSI (usually word processors or DTP
  15 programs) can use this bitmap to give a preview version on screen of the
  16 PostScript.  The displayed quality is often not very good (e.g., low
  17 resolution, no colours), but the final printed version uses the real
  18 PostScript, and thus has the normal PostScript quality.
  19 .SH USAGE
  20 On Unix systems invoke \fBps2epsi\fR like this:
  21 .PP
  22 .br
  23         \fBps2epsi\fR \fIinfile.ps\fR [ \fIoutfile.epsi\fR ]
  24 .PP
  25 where "infile.ps" is the input file and "outfile.epsi" is the resulting
  26 EPSI file.  If the output filename is omitted, it is generated from the
  27 input filename.  When a standard extension (".ps", ".cps", ".eps" or
  28 ".epsf") is used, it is replaced with the output extension ".epsi".  On
  29 DOS systems the command is:
  30 .PP
  31 .br
  32         \fBps2epsi\fR \fIinfile.ps outfile.epi\fR
  33 .PP
  34 where "infile.ps" is the original PostScript file, and "outfile.epi"
  35 is the name of the output file.
  36 .SH LIMITATIONS
  37 Not every PostScript file can be encapsulated successfully, because there
  38 are restrictions on what PostScript constructs a correct encapsulated file
  39 may contain.  \fBps2epsi\fR does a little extra work to try to help
  40 encapsulation, and it automatically calculates the bounding box required
  41 for all encapsulated PostScript files, so most of the time it does a pretty
  42 good job. There are certain to be cases, however, where the encapsulation
  43 does not work because of the content of the original PostScript file.
  44 .SH COMPATIBILITY
  45 The \fBFramemaker\fR DTP system is one application which understands EPSI
  46 files, and \fBps2epsi\fR has been tested on a number of PostScript diagrams
  47 from a variety of sources, using Framemaker 3.0 on a Sun workstation.
  48 Framemaker on other platforms should be able to use these files, although I
  49 have not been able to test this.
  50 .SH FILES
  51 .TS
  52 tab(>);
  53 l l.
  54 ps2epsi>Unix shell script
  55 ps2epsi.bat>DOS batch file
  56 ps2epsi.ps>the Ghostscript program which does the work
  57 .TE
  58 .fi
  59 .SH SEE ALSO
  60 gs (1)
  61 .SH VERSION
  62 This document was last revised for Ghostscript version 9.56.0.
  63 However, the content may be obsolete, or inconsistent with ps2epsi.txt.
  64 .SH AUTHOR
  65 George Cameron