📄 epstool.htm
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>epstool</title>
<link rel="stylesheet" type="text/css" href="gsview.css" title="GSview Style">
</head>
<body>
<h1>
epstool
</h1>
<p>
EPSTOOL - Create or extract preview bitmaps in EPS files.
<br>
Release date: 2003-04-04
</p>
<p>
<b>This is an obsolete branch of epstool. See
<a href="http://www.cs.wisc.edu/~ghost/gsview/epstool.htm">epstool 3.0</a>.
</b>
</p>
<h2>
Table of contents
</h2>
<ul>
<li><a href="#Overview">Overview</a>
<li><a href="#Examples">Examples</a>
<li><a href="#Notes">Notes</a>
<li><a href="#Copyright">Copyright</a>
<li><a href="#Other">Other tools</a>
<li><a href="#Revision">Revision History</a>
</ul>
<h2>
<a name="Overview"></a>
Overview
</h2>
<p>
Epstool is a utility to create or extract preview images in
EPS files.
</p>
<p>
If you have precompiled executables, epstool.exe is a Win32 console EXE,
epstool2.exe is an OS/2 console EXE.
</p>
<p>
<b>
Features:
</b>
</p>
<ul>
<li> Add EPSI or DOS EPS previews.
<li> Extract PostScript from DOS EPS files.
<li> Uses Ghostscript to create preview bitmaps.
<li> Scan a bitmap created by Ghostscript to find bounding box.
<li> Create a TIFF, WMF or Interchange preview from part of a
bitmap created by Ghostscript.
<li> output to stdout or file.
<li> input must be from a file.
<li> works under Win32, MS-DOS, OS/2 and Unix.
<li> works on little-endian machines (Intel) or big endian
(Sun Sparc, Motorola) machines.
</ul>
<p>
Usage: epstool [option] operation filename
</p>
<table>
<tr>
<td><b>Options:</b></td><td></td>
</tr>
<tr>
<td> -a<i>arg</i> </td><td>Ghostscript argument</td>
</tr>
<tr>
<td> -b </td><td>Calculate BoundingBox from image</td>
</tr>
<tr>
<td> -e </td><td>Ignore DSC warnings (dangerous)</td>
</tr>
<tr>
<td> -e2 </td><td>Ignore DSC errors (very dangerous)</td>
</tr>
<tr>
<td> -g<i>command</i> </td><td>Ghostscript command</td>
</tr>
<tr>
<td> -n<i>number</i> </td><td>Page number to extract</td>
</tr>
<tr>
<td> -o<i>filename</i> </td><td>Output filename</td>
</tr>
<tr>
<td> -q </td><td>Quiet (no messages)</td>
</tr>
<tr>
<td> -r<i>number</i> </td><td>Preview resolution in dpi</td>
</tr>
<tr>
<td> -s<i>WIDTHxHEIGHT</i> </td><td>Size of page used with -b</td>
</tr>
<tr>
<td> -z<i>device</i> </td><td>Ghostscript device name (for -t6u, -t6p, -tg, -w)</td>
</tr>
<tr>
<td> -d </td><td>Debug mode (leave temporary files)</td>
</tr>
<tr>
<td><b>Operations: (one only)</b></td><td></td>
</tr>
<tr>
<td> -i </td><td>Add Interchange preview (EPSI)</td>
</tr>
<tr>
<td> -t4 </td><td>Add TIFF4 preview (DOS EPS)</td>
</tr>
<tr>
<td> -t6u </td><td>Add TIFF6 uncompressed (DOS EPS)</td>
</tr>
<tr>
<td> -t6p </td><td>Add TIFF6 packbits (DOS EPS)</td>
</tr>
<tr>
<td> -tg </td><td>Add GS TIFF preview (DOS EPS)</td>
</tr>
<tr>
<td> -w </td><td>Add WMF preview (DOS EPS)</td>
</tr>
<tr>
<td> -u<i>filename</i> </td><td>Add user supplied preview (DOS EPS)</td>
</tr>
<tr>
<td> -p </td><td>Extract PostScript (DOS EPS)</td>
</tr>
<tr>
<td> -v </td><td>Extract Preview (DOS EPS)</td>
</tr>
<tr>
<td> -c </td><td>Copy without preview (use with -b)</td>
</tr>
<tr>
<td> -k </td><td>Convert to bitmap</td>
</tr>
</table>
<h2>
<a name="Examples"></a>
Examples
</h2>
<p>
Create EPS file tiger.eps with TIFF (G3 Fax) preview
<br><tt>
epstool -tg -ztiffg3 -g"gswin32c" -a"-Id:\gs;d:\psfonts" -otiger.eps tiger.ps
</tt><br>
Any GS TIFF device can be used, e.g. -ztiffg4, -ztiffpack
</p>
<p>
Add colour preview (8bit/pixel) to EPS file
<br><tt>
epstool -t6p -zbmp256 -g"gswin32c" -a"-Id:\gs;d:\psfonts" -otiger.eps tiger.ps
</tt>
</p>
<p>
Extract TIFF preview from tiger.eps
<br><tt>
epstool -v -otiger.tif tiger.eps
</tt>
</p>
<p>
EPS file has incorrect %%BoundingBox.
Add TIFF4 preview and calculate %%BoundingBox from bitmap.
<br><tt>
epstool -b -t4 -ogolfer.eps golfer.ps
</tt>
</p>
<p>
Adjust the BoundingBox of an existing EPS file, but don't add a preview:
<br><tt>
epstool -b -t4 -otemp.eps existing.eps
<br>
epstool -p -oexisting.eps temp.eps
<br>
del temp.eps
</tt><br>
or
<br><tt>
epstool -b -c -otemp.eps existing.eps
<br>
del existing.eps
<br>
rename temp.eps existing.eps
</tt>
</p>
<p>
Add user supplied Windows Metafile to EPS file.
Typically used when an application can export EPS and WMF separately
but can't export EPS with WMF preview.
<br><tt>
epstool -ulogo.wmf -ologo2.eps logo.eps
</tt>
</p>
<h2>
<a name="Notes"></a>
Notes
</h2>
<p>
When extracting a page number with "-n", it is your responsibility
to make sure that the PostScript file does not use any operators
that are forbidden in EPS files.
This can be tested with GSview "EPS Warn".
</p>
<p>
Under OS/2 or MS-DOS, epstool requires Ghostscript 3.51 or later.
If you have command line length problems, try setting the Ghostscript
include path using the GS_LIB environment variable instead of using
-a"-Ic:\gs3.51;c:\gs3.51\fonts;c:\psfonts"
</p>
<p>
For Windows 95 or Windows NT, use gswin32c.exe. If you installed
Aladdin Ghostscript using the self installer, epstool should
automatically find the latest Ghostscript command line executable.
For OS/2, use gsos2.exe.
For MS-DOS, use gs386.exe.
</p>
<p>
The "-b Calculate BoundingBox from image" option works by scanning
a bitmap returned by Ghostscript. This will only work for the
operations -i, -t4, -t6u, -t6p, -w and -c. It does not work with -tg
or -ufilename. -tg does not return a bitmap in a format understood
by epstool. -ufilename does not even use Ghostscript.
The bitmap size normally used is 216mm wide (letter width) by
297mm high (A4 height). If the DSC comments specify a default
page size using %%DocumentMedia or %%PaperSize,
then this page size will be used instead.
Any marks made outside this area will be ignored when calculating
the bounding box.
To use a different bitmap size, specify the size in pts (1/72")
using -sWIDTHxHEIGHT. For example, A3 is -s1190x842.
</p>
<p>
The "-zdevice" should only be used with -tg, -t6u, -t6p and -w.
</p>
<p>
For -tg, the -zdevice may be any TIFF device.
</p>
<p>
For -t6u, -t6p and -w:
Under OS/2 or MS-DOS, -zdevice can be one of the following:
bmpmono, bmp16, bmp256, bmp16m, pbmraw, pgmraw, ppmraw
Under Unix, -zdevice can be one of the following:
pbmraw, pgmraw, ppmraw
</p>
<p>
To get a colour preview, you must use -zdevice.
The default device used by epstool is monochrome (bmpmono or pbmraw).
</p>
<p>
When adding a WMF preview using -w, the preview contains a bitmap,
not a vector representation. If -zdevice is not used, the
Ghostscript device bmpmono or pbmraw will be used to create the bitmap.
The bitmap in the metafile will be 1bit/pixel black and white.
<br><tt>
epstool -b -w -onew.eps old.eps
</tt><br>
If you want a colour bitmap in the metafile, specify a bitmap device
which supports colour.
<br><tt>
epstool -b -w -zbmp256 -onew.eps old.eps
</tt>
</p>
<p>
When adding a WMF preview to an EPS file using -ufilename, the
placeable metafile header is removed from the metafile as it is put
into the EPS file.
When extracting a WMF preview from an EPS file, a placeable metafile
header is created from the EPS BoundingBox information.
This placeable metafile header assumes that the WMF has it's origin
at (0,0), which might not be correct.
</p>
<p>
The environment variable TEMP should point to a writeable directory
for temporary files. If not defined, /tmp will be used for Unix
and the current directory will be used for other platforms.
</p>
<h2>
<a name="Copyright"></a>
Copyright
</h2>
<p>
Copyright (C) 1995-2002, Ghostgum Software Pty Ltd. All rights reserved.
</p>
<p>
This file is part of GSview.
</p>
<p>
This program is distributed with NO WARRANTY OF ANY KIND. No author
or distributor accepts any responsibility for the consequences of using it,
or for whether it serves any particular purpose or works at all, unless he
or she says so in writing. Refer to the GSview Free Public Licence
(the "Licence") for full details.
</p>
<p>
Every copy of GSview must include a copy of the Licence, normally in a
plain ASCII text file named LICENCE. The Licence grants you the right
to copy, modify and redistribute GSview, but only under certain conditions
described in the Licence. Among other things, the Licence requires that
the copyright notice and this notice be preserved on all copies.
</p>
<p>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -