home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / POSTSCPT / GSVIEW / EPSTOOL / EPSTOOL.DOC < prev    next >
Encoding:
Text File  |  1995-10-23  |  5.8 KB  |  158 lines
  1. /* Copyright (C) 1995, Russell Lang.  All rights reserved.
  2.   
  3.   This file is part of GSview.
  4.   
  5.   This program is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the GSview Free Public Licence 
  9.   (the "Licence") for full details.
  10.   
  11.   Every copy of GSview must include a copy of the Licence, normally in a 
  12.   plain ASCII text file named LICENCE.  The Licence grants you the right 
  13.   to copy, modify and redistribute GSview, but only under certain conditions 
  14.   described in the Licence.  Among other things, the Licence requires that 
  15.   the copyright notice and this notice be preserved on all copies.
  16. */
  17.  
  18. /* epstool.doc */
  19.  
  20. 1995-10-20
  21.  
  22. EPSTOOL - Create or extract preview bitmaps in EPS files.
  23.  
  24. epstool is not yet finished.
  25. The documentation below is not complete and may be incorrect.
  26.  
  27. EPSTOOL.EXE is a combined OS/2 and MS-DOS executable.
  28. For OS/2 or MS-DOS you will need
  29.     ftp://ftp-os2.nmsu.edu/os2/unix/emx09a/emxrt.zip
  30. For a DOS Window under Windows 3.1 you will need
  31.     ftp://ftp-os2.nmsu.edu/os2/unix/emx09a/rsxwin2a.zip
  32.  
  33. Features:
  34. - Add EPSI or DOS EPS previews.
  35. - Extract postscript from DOS EPS files.
  36. - Uses Ghostscript to create preview bitmaps.
  37. - Scan a bitmap created by Ghostscript to find bounding box.
  38. - Create TIFF or Interchange from part of a bitmap created by Ghostscript.
  39. - output to stdout or file.
  40. - input must be from a file.
  41. - works under OS/2, Unix and MS-DOS.
  42. - works on little-endian machines (Intel) or big endian 
  43.   (Sun Sparc, Motorola) machines.
  44. - Options:
  45.    input file,                 (on command line)
  46.    output file,                -ofilename
  47.    page number,                -npagenumber
  48.    resolution,                 -rdpi  (default 72)
  49.    calculate bounding box,     -b
  50.    gs command,                 -gcommand
  51.    debug mode,                 -d  (leaves temporary files)
  52.    non verbose mode,           -q  (no messages unlesss error occurs)
  53.  
  54. - Operations:  
  55.    Add TIFF 4,                  -t4 or -t
  56.    Add TIFF 5,                  -t5
  57.    Add TIFF using GS device     -tdevice
  58.    Add Interchange,             -i
  59.    Add user supplied preview,    -ufilename
  60.    Extract PostScript,          -p
  61.    Extract Preview,             -v
  62.  
  63. On-line help says:
  64. Usage:  epstool [option] operation filename
  65.   Options:
  66.      -b             Calculate BoundingBox from image
  67.      -gcommand      Ghostscript command
  68.      -nnumber       Page number to extract
  69.      -ofilename     Output filename
  70.      -q             Quiet (no messages)
  71.      -rnumber       Preview resolution in dpi
  72.   Operations: (one only)
  73.      -i             Add Interchange preview   (EPSI)
  74.      -t4            Add TIFF4 preview         (DOS EPS)
  75.      -t5            Add TIFF5 preview         (DOS EPS)
  76.      -ttiffg3       Add GS TIFF preview       (DOS EPS)
  77.      -ufilename     Add user supplied preview (DOS EPS)
  78.      -p             Extract PostScript        (DOS EPS)
  79.      -v             Extract Preview           (DOS EPS)
  80.  
  81.  
  82. =========
  83. Examples:
  84. =========
  85.  
  86. Create EPS file tiger.eps with TIFF (G3 Fax) preview
  87.   epstool -ttiffg3 -g"gsos2 -Id:\gs;d:\psfonts" -otiger.eps tiger.ps
  88. Any GS TIFF device can be used, e.g. -ttiffg4, -ttiffpack
  89.  
  90. Extract TIFF preview from tiger.eps
  91.   epstool -v -otiger.tif tiger.eps
  92.  
  93. EPS file has incorrect %%BoundingBox.
  94. Add TIFF4 preview and calculate %%BoundingBox from bitmap.
  95.   epstool -b -t4 -g"gsos2 -Id:\gs;d:\psfonts" -ogolfer.eps golfer.ps
  96.  
  97. Adjust the BoundingBox of an existing EPS file, but don't add a preview:
  98.   epstool -b -t4 -otemp.eps existing.eps
  99.   epstool -p -oexisting.eps temp.eps
  100.   del temp.eps
  101.  
  102. Add user supplied Windows Metafile to EPS file.
  103. Typically used when an application can export EPS and WMF separately
  104. but can't export EPS with WMF preview.
  105.   epstool -ulogo.wmf -ologo2.eps logo.eps
  106.  
  107.  
  108. =====
  109. Notes
  110. =====
  111. Under OS/2 or MS-DOS, epstool requires Ghostscript 3.51 or later.
  112. If you have command line length problems, try setting the Ghostscript
  113. include path using the GS_LIB environment variable instead of using
  114. -g"c:\gs3.51\gsos2.exe -Ic:\gs3.51;c:\gs3.51\fonts;c:\psfonts"
  115.  
  116. If running under MS-DOS, you can use gsos2.exe provided you don't
  117. use the os2pm device.
  118.  
  119. The "-b   Calculate BoundingBox from image" option works by scanning
  120. a bitmap returned by Ghostscript.  This will only work for the
  121. operations -i, -t4 and -t5.  It does not work with -ttiffg3 or 
  122. -ufilename. -ttiff3 does not return a bitmap in a format understood
  123. by epstool.  -ufilename does not even use Ghostscript.
  124.  
  125. When adding a WMF preview to an EPS file using -ufilename, the
  126. placeable metafile header is removed from the metafile as it is put 
  127. into the EPS file.
  128. When extracting a WMF preview from an EPS file, a placeable metafile
  129. header is created from the EPS BoundingBox information.  
  130. This placeable metafile header assumes that the WMF has it's origin 
  131. at (0,0), which might not be correct.
  132.  
  133. ================
  134. Revision History
  135. ================
  136. 0.7 alpha 1995-10-20
  137.   Fixed a few error messages.
  138.   Use @file to reduce Ghostscript command line length under MS-DOS and OS/2.
  139.   Added -q option to GSview and -dQUIET option to Ghostscript command line 
  140.   to allow EPS files to be written to stdout.
  141.  
  142. 0.6 alpha 1995-10-12
  143.   Delete temporary bmp file.
  144.   Add user supplied preview to a DOS EPS file (which already had a
  145.   preview) was wrong.
  146.  
  147. 0.5 alpha 1995-09-27
  148.   Put stdout into binary mode.
  149.   Write placeable WMF header correctly on 32bit and big-endian machines.
  150.  
  151. 0.4 alpha 1995-09-15
  152.   Remove placeable WMF header when adding to EPS file, add placeable
  153.   WMF header when extracting from EPS file.
  154.  
  155. 0.3 alpha 1995-09-14
  156.   First release separate from GSview.
  157.  
  158.