[gs-cvs] rev 8385 - trunk/website/gsview
ghostgum at ghostscript.com
ghostgum at ghostscript.com
Mon Nov 19 12:29:20 PST 2007
Author: ghostgum
Date: 2007-11-19 12:29:19 -0800 (Mon, 19 Nov 2007)
New Revision: 8385
Added:
trunk/website/gsview/get49.htm
trunk/website/gsview/gsviewsk.htm
Log:
Website updates for GSview 4.9 release.
Added: trunk/website/gsview/get49.htm
===================================================================
--- trunk/website/gsview/get49.htm 2007-11-19 20:24:07 UTC (rev 8384)
+++ trunk/website/gsview/get49.htm 2007-11-19 20:29:19 UTC (rev 8385)
@@ -0,0 +1,116 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+
+<head>
+<title>Obtaining GSview 4.9</title>
+<link rel="stylesheet" type="text/css" href="../doc/gsweb.css" title="Ghostscript Website Style">
+</head>
+
+<body>
+<h1><img src="../images/gsview2.gif"> GSview 4.9</h1>
+
+<h2>Obtaining GSview</h2>
+<p>
+GSview 4.9 has been released and is
+available from the directory
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/">
+ http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/</a>
+<br>
+Specific files are:
+<ul>
+ <li>
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsv48w32.exe">
+ gsv48w32.exe </a> Win32 self extracting archive
+ <li>
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsv48w64.exe">
+ gsv48w64.exe </a> Win64 (x86_64) self extracting archive
+ <li>
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsv48os2.zip">
+ gsv48os2.zip </a> OS/2 archive
+ <li>
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsv48src.zip">
+ gsv48src.zip </a> Source archive
+ <li>
+ <a href="http://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsview-4.9.tar.gz">
+ gsview-4.9.tar.gz </a> Linux source archive
+</ul>
+<p>
+<b>GSview requires Ghostscript.
+You must download Ghostscript separately.</b>
+See <a href="../doc/GPL/gpl860.htm"> Obtaining AFPL Ghostscript 8.60</a>.
+<br>
+For Windows, obtain and install Ghostscript, then run the GSview
+self extracting archive gsv48w32.exe (or gsv48w64.exe on Win64).
+<br>
+For OS/2, unzip gsv48os2.zip then read the GSview
+<a href="Readme.htm">Readme.htm</a> file.
+<p>
+
+<h2>Features</h2>
+GSview is a graphical interface for Ghostscript under MS-Windows or OS/2.
+Ghostscript is an interpreter for the PostScript page description language
+used by laser printers.
+For documents following the Adobe PostScript Document Structuring
+Conventions, GSview allows selected pages to be viewed or printed.
+GSview requires
+<a href="../doc/AFPL/index.htm"> Ghostscript</a> 7.04-9.19.
+<p>
+Features include:
+</p>
+<ul>
+ <li> Display and print PostScript and PDF files.
+ <li> View pages in arbitrary order (Next, Previous, Goto).
+ <li> Page size and Orientation are automatically selected from
+ DSC comments or can be selected using the menu.
+ <li> Print selected pages using Ghostscript.
+ <li> Convert pages to bitmap, PDF or PostScript.
+ <li> Selectable display resolution, depth, alpha.
+ <li> Single button zoom.
+ <li> Extract selected pages to another file.
+ <li> Copy display bitmap to clipboard.
+ <li> Save clipboard bitmap as BMP file.
+ <li> Add bitmap or user preview to EPS file
+ (Interchange, TIFF or Windows Metafile)
+ <li> Graphically select and show bounding box for EPS file.
+ <li> Extract bitmap preview or PostScript from DOS EPS file.
+ <li> Extract text or search for text.
+ <li> Can read gzip and bzip2 compressed PostScript and PDF files.
+ <li> On-line help.
+ <li> Win32, OS/2 and Linux/X11 executables. Older versions support Win16.
+ <li> Can be run directly off a CD-ROM or USB memory stick (Portable Application).
+ <li> English, Catalan, Dutch, French, German, Greek, Italian, Russian,
+ Slovak, Spanish and Swedish languages.
+ <li> Per user initialisation files for Windows.
+ <li> Includes setup program.
+ <li> Free (Aladdin Free Public Licence).
+ <li> Works with Ghostscript 7.04 - 9.99 (GSview checks the
+ Ghostscript version number). There are older versions of GSview
+ that will work with Ghostscript 4.03 - 7.00.
+</ul>
+<p>
+Changes in version 4.9:
+</p>
+<ul>
+ <li> Minor bug fixes.
+ <li> Use latest version of zlib and bzip2 libraries.
+ <li> Can be run as a portable application from USB flash memory.
+</ul>
+
+<p>
+GSview was written by <a href="rjl.htm">Russell Lang</a>
+at Ghostgum Software Pty Ltd.
+<p>
+GSview 4.9 should be used with Ghostscript 8.60 or later.
+See the <a href="../doc/GPL/gpl860.htm">8.60 release announcement</a>
+<p>
+For post-release notes on GSview, see
+<a href="bugs.htm">known problems and bugs</a>.
+<hr>
+<a href="../index.htm">Home</a>
+<hr>
+Updated 2007-11-19
+by <a href="rjl.htm">Russell Lang</a>
+
+</body>
+
+</html>
Added: trunk/website/gsview/gsviewsk.htm
===================================================================
--- trunk/website/gsview/gsviewsk.htm 2007-11-19 20:24:07 UTC (rev 8384)
+++ trunk/website/gsview/gsviewsk.htm 2007-11-19 20:29:19 UTC (rev 8385)
@@ -0,0 +1,2112 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GSview Help</title>
+</head>
+<body>
+<h1>GSview Help</h1>
+<hr>
+<h1><a name="Overview">Overview</a></h1>
+<b>GSview</b> is a graphical interface for Ghostscript under MS-Windows,
+OS/2 and GNU/Linux.
+Ghostscript is an interpreter for the PostScript page description language
+used by laser printers.
+For documents following the Adobe PostScript Document Structuring
+Conventions, GSview allows selected pages to be viewed or printed.
+GSview 4.8 requires Ghostscript 7.04 - 9.19.
+<p>
+<a href="#Installation">Installation</a><br>
+<a href="#Registration">Registration</a><br>
+<a href="#Document_Structuring_Conventions">Document Structuring Conventions</a><br>
+<a href="#Portable_Document_Format">Portable Document Format</a><br>
+<a href="#Opening_a_Document">Opening a Document</a><br>
+<a href="#Page_Selection">Page Selection</a><br>
+<a href="#Document_Information">Document Information</a><br>
+<a href="#Printing">Printing</a><br>
+<a href="#Conversions">Conversions</a><br>
+<a href="#Measure">Measure</a><br>
+<a href="#Options">Options</a><br>
+<a href="#Page_Orientation">Page Orientation</a><br>
+<a href="#Display_Settings">Display Settings</a><br>
+<a href="#Page_Size">Page Size</a><br>
+<a href="#Keys">Keys</a><br>
+<a href="#Command_line_options">Command line options</a><br>
+<a href="#World_Wide_Web">World Wide Web</a><br>
+<a href="#Copyright">Copyright</a><br>
+<a href="#Common_Problems">Common Problems</a><br>
+<a href="#Other_Useful_Programs">Other Useful Programs</a><br>
+<a href="#Other_Help_Topics">Other Help Topics</a><br>
+<p>
+<hr>
+<h1><a name="Installation">Installation</a></h1>
+It is recommended that you use the installation program <b>setup.exe</b>
+for installing GSview.
+You will need to install Ghostscript separately.
+<p>If you wish to install GSview manually, see the <a href="#Manual_Installation">Manual Installation</a>
+topic.
+<p>Configuration will occur the first time GSview is run.
+If you want to change the configuration later, use
+<a href="#Options">Options</a> | <a href="#Easy_Configure">Easy Configure</a> or
+<a href="#Options">Options</a> | <a href="#Advanced_Configure">Advanced Configure</a>.
+<p>See also <a href="#Options">Options</a> | <a href="#Language">Language</a>.
+<p>
+<a href="#Obtaining_Ghostscript">Obtaining Ghostscript</a><br>
+<a href="#Ghostscript_Installation">Ghostscript Installation</a><br>
+<a href="#Uninstalling_GSview">Uninstalling GSview</a><br>
+<a href="#Manual_Installation">Manual Installation</a><br>
+<a href="#Advanced_Manual_Installation">Advanced Manual Installation</a><br>
+<a href="#Network_Installation">Network Installation</a><br>
+<a href="#Running_GSview_from_the_File_Manager_or_Windows_Explorer">Running GSview from the File Manager or Windows Explorer</a><br>
+<p>
+<hr>
+<h2><a name="Obtaining_Ghostscript">Obtaining Ghostscript</a></h2>
+GSview needs AFPL Ghostscript. GSview and Ghostscript
+are available separately from
+<pre>
+ http://www.cs.wisc.edu/~ghost/
+</pre>
+<p>To configure GSview, obtain and install both Ghostscript
+and GSview, then run GSview.
+<p>
+<p>
+<hr>
+<h2><a name="Ghostscript_Installation">Ghostscript Installation</a></h2>
+AFPL Ghostscript for Win32 is available as a self extracting
+archive which installs itself.
+For details of how to manually install Ghostscript, please read
+the Ghostscript documentation files Install.htm and Use.htm
+<p>
+<p>
+<hr>
+<h2><a name="Uninstalling_GSview">Uninstalling GSview</a></h2>
+To uninstall GSview from Windows 95 or NT 4.0,
+use <b>Add/Remove Programs</b> from the Windows <b>Control Panel</b>.
+<p>
+<a href="#Manual_uninstallation">Manual uninstallation</a><br>
+<p>
+<hr>
+<h3><a name="Manual_uninstallation">Manual uninstallation</a></h3>
+To uninstall GSview, remove the files in the <b>gsview </b> directory.
+Also remove
+<pre>
+ c:\windows\gsview32.ini
+</pre>
+<p>from the appropriate system directory.
+<p>For Windows NT you may also need to remove gsview32.ini
+from user profile directories.
+<p>Remove the <b>Ghostgum</b> group from the Program Manager or Start menu
+<p>If you know how to edit the registry, remove the following keys:
+<pre>
+ HKEY_CLASSES_ROOT\psfile
+ HKEY_CLASSES_ROOT\.eps
+ HKEY_CLASSES_ROOT\.ps
+ HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/postscript
+</pre>
+<p>If you associated PDF with GSview you will also need to remove
+<pre>
+ HKEY_CLASSES_ROOT\pdffile
+ HKEY_CLASSES_ROOT\.pdf
+ HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/pdf
+</pre>
+<p>The preferred method to uninstall Ghostscript is
+using <b>Add/Remove Programs</b> from the Windows <b>Control Panel</b>.
+<p>To manually uninstall Ghostscript, remove the files in the <b>gsN.NN</b>
+directory where N.NN is the version number of Ghostscript.
+<p>
+<p>
+<hr>
+<h2><a name="Manual_Installation">Manual Installation</a></h2>
+It is recommended that you use the installation program for installing
+GSview. The following instructions describe how to install GSview
+without using the installation program.
+<p>Set the environment variable TEMP to point to a directory for
+temporary files. For example:
+<pre>
+ SET TEMP=c:\temp
+</pre>
+<p>The directory must exist and must be writeable.
+<p>First you need to install Ghostscript, plus its library files and fonts.
+You need the Ghostscript version listed in <a href="#Overview">Overview</a>.
+This version of GSview will not work with other versions of Ghostscript.
+Install Ghostscript in a directory c:\gs\gsN.NN
+(Replace N.NN by the Ghostscript version number.)
+<p>Make a directory c:\ghostgum\gsview
+<p>Next install
+GSview for Windows by copying gsview32.exe, gsv16spl.exe, gvwgs32.exe,
+gsvw32de.dll, gsvw32es.dll, gsvw32fr.dll, gsvw32it.dll,
+gsviewen.hlp, gsviewde.hlp, gsviewes.hlp, gsviewfr.hlp, gsviewit.hlp
+and printer.ini
+to the <b>c:\ghostgum\gsview</b> directory.
+<p>Start GSview and select the appropriate version of Ghostscript
+(usually the latest). To change this later, use
+<a href="#Options">Options</a> | <a href="#Easy_Configure">Easy Configure</a>.
+<p>For more control over configuration, see <a href="#Advanced_Manual_Installation">Advanced Manual Installation</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Advanced_Manual_Installation">Advanced Manual Installation</a></h2>
+Instead of using <a href="#Options">Options</a> | <a href="#Easy_Configure">Easy Configure</a>, use
+<a href="#Options">Options</a> | <a href="#Advanced_Configure">Advanced Configure</a>.
+<p>First correctly set the three text fields (see <a href="#Advanced_Configure">Advanced Configure</a>).
+<p>On the <a href="#Advanced_Configure">Advanced Configure</a> dialog, either select the checkboxes
+<b>Copy printer defaults</b>, <b>Associate .ps files with GSview</b> and
+<b>Create Start Menu items</b>, or perform the following three steps.
+<p>1. Exit GSview, then append printer.ini to the GSview INI file
+(c:\windows\gsview32.ini)
+<p>2. Add the .ps and .eps (and optionally the .pdf) file types to
+the <a href="#Running_GSview_from_the_File_Manager_or_Windows_Explorer">Registry</a>.
+<p>3. Create a Program Manager or Start Menu item for GSview.
+<p>If you have some Type 1 fonts on your system, it may be possible to
+tell Ghostscript to use them. See <b>Fontmap.os2</b> and <b>Fontmap.atm</b>
+supplied with Ghostscript for examples. See the <b>Fonts</b> topic.
+<p>If you have problems, try reading the help topic <a href="#Common_Problems">Common Problems</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Network_Installation">Network Installation</a></h2>
+Install GSview to a network directory.
+<p>When a user starts GSview for the first time, or starts GSview
+after the version number has changed, GSview will configure
+the local computer.
+<p>Using a UNC path when installing GSview will not work
+from Windows 3.1, but does work from Windows 95.
+<p>GSview tries to maintain one configuration file for each user.
+If user profiles are being used under Windows 95 or NT,
+GSview will store the INI file in the user profile directory,
+as specified in the registry. If this can't be found,
+and the environment variable USERPROFILE is defined and is
+a directory, GSview will store the INI file in this directory.
+If this fails, GSview will store the INI file in the default
+location, the Windows directory.
+If the user profile directory exists, but is write protected,
+GSview will have trouble.
+<p>If you wish to stop GSview from displaying the <a href="#Easy_Configure">Easy Configure</a>
+when GSview is first run, or whenever GSview is upgraded,
+place an INI file in the GSview directory.
+<b>Remember to remove this file before upgrading GSview in the future.</b>
+This should contain only those entries that you wish to overwrite
+in the users configuration.
+The suggested technique is to install GSview, then configure it.
+Copy gsview32.ini or gvpm.ini from the system directory or your
+user profile directory to the GSview directory, then edit it to
+remove all entries except for:
+<pre>
+ [GSview-4.8]
+ Version=4.8
+ GSversion=853
+ Configured=1
+ GhostscriptDLL=e:\gs\gs8.53\bin\gsdll32.dll
+ GhostscriptInclude=e:\gs\gs8.53\lib;e:\gs\fonts
+ GhostscriptOther=-dNOPLATFONTS -sFONTPATH="c:\psfonts"
+</pre>
+<p>When a user starts GSview, their INI file will normally be used.
+The first time GSview is run, or when the GSview version doesn't
+match the INI file, the following will occur:
+<p>1. The INI file in the GSview directory will be read, overriding
+the users INI file.
+<p>2. The list of printers will be updated from printer.ini in
+the GSview directory.
+<p>3. File associations (.ps, .eps, .pdf) will NOT be made or changed.
+If you wish to change these you must use <a href="#Options">Options</a> | <a href="#Advanced_Configure">Advanced Configure</a>.
+<p>4. Program Manager groups / Start menu items / Program objects
+will NOT be changed.
+If you wish to change these you must use <a href="#Options">Options</a> | <a href="#Advanced_Configure">Advanced Configure</a>.
+<p>If you are installing on Windows NT4/2000, and you select "All Users",
+then the installer will write this gsview32.ini into your GSview
+directory. You must have installed Ghostscript first.
+<p>If a user tries to use the GSview uninstall program, it will
+try to delete the GSview and Ghostscript files on the network.
+Make sure the GSview and Ghostscript directories are not writeable
+by users.
+To be extra safe, you may wish to remove the file <b>uninstal.txt</b> from
+the GSview directory.
+<p>Alternatively, if you want install GSview on each computer without
+any prompting, unzip the self extracting archive then run the setup
+program as follows:
+<pre>
+ setup -name "Your Name" -number XXXXX-XXXXX "c:\ghostgum"
+</pre>
+<p>
+<p>
+<hr>
+<h2><a name="Running_GSview_from_the_File_Manager_or_Windows_Explorer">Running GSview from the File Manager or Windows Explorer</a></h2>
+If you used the GSview setup.exe program and answered <b>yes</b> to
+all the questions, the following configuration has already occurred.
+If you didn't update the registry during GSview installation,
+the following information explains how to do it manually.
+<p>To run GSview when a PostScript file is double clicked in the
+File Manager, the following sequence must be followed to teach
+File Manager about PostScript files.
+<p>From the <b>Program Manager</b>, run the Registration Info Editor using
+<b>File </b>| <b>Run...</b> then type <b>regedit</b>.
+From the <b>Registration Info Editor</b> select <b>Edit </b>| <b>Add File Type...</b>
+then enter the following fields:
+<pre>
+ Identifier = psfile
+ Filetype = PostScript
+ Action = Open
+ Command = c:\ghostgum\gsview\gsview32 %1
+ Uses DDE = unchecked
+ Action = Print
+ Command = c:\ghostgum\gsview\gsview32 /p %1
+ Uses DDE = unchecked
+</pre>
+<p>Then press <b>OK</b>.
+<p>From the <b>File Manager</b>, select <b>File </b>| <b>Associate</b> then
+enter the following fields:
+<pre>
+ Files with Extension = ps
+ Associate With = PostScript (gsview)
+</pre>
+<p>Then press <b>OK</b>.
+<p>That's it! Now when you double click on a PostScript file,
+the <b>File Manager</b> will run GSview. When you drop a PostScript
+file on the <b>Print Manager</b>, GSview will print the file.
+If you have a PostScript printer, this won't be useful.
+In this case you will need to remove the Print action from
+the registry.
+<p>For Windows 95, the configuration is instead made using Windows
+Explorer.
+<p>Start <b>Windows Explorer</b>. Select <b>View </b>| <b>Options </b>. Select the
+<b>File Types</b> tab. Select the <b>New Type</b> button.
+Enter the following fields:
+<pre>
+ Description of type = PostScript
+ Associated Extension = PS EPS
+</pre>
+<p>Press the <b>New</b> button, then enter
+<pre>
+ Action = open
+ Application used to perform action = c:\ghostgum\gsview\gsview32.exe
+</pre>
+<p>Press the <b>OK</b> button
+<p>Press the <b>New</b> button, then enter
+<pre>
+ Action = print
+ Application used to perform action = c:\ghostgum\gsview\gsview32.exe /p
+</pre>
+<p>Press the <b>OK</b> button
+<p>Press the <b>Close </b>button.
+<p>Press the <b>Close </b>button.
+<p>
+<p>
+<hr>
+<h1><a name="Registration">Registration</a></h1>
+If you wish to support the development of GSview or wish
+to disable the GSview nag screen, please consider registering
+GSview. There is no requirement for you to register GSview.
+GSview is made available with the Aladdin Free Public Licence,
+contained in the file <b>LICENCE</b>.
+This allows free use, but restricts commercial distribution.
+<p>The registration fee is currently AUD$40.
+GSview can be registered online at
+<pre>
+ http://www.ghostgum.com.au/
+</pre>
+<p>or by faxing or mailing the
+registration form which can be found in the file <b>regorder.txt</b>
+in the GSview directory.
+Ghostgum Software prefers that you use the online registration.
+<p>
+<p>
+<hr>
+<h1><a name="Document_Structuring_Conventions">Document Structuring Conventions</a></h1>
+Adobe has defined a set of extended comment conventions that provide
+additional information about the page structure and resource
+requirements of a PostScript file.
+If a file contains these Document Structuring Convention (DSC) comments,
+GSview can display pages in random order using <a href="#Page_Selection">Goto Page</a> and display pages
+in reverse order using <a href="#Page_Selection">Previous Page</a>. Selected pages can be extracted to
+another file or printed.
+<p>If a file does not contain DSC comments, GSview can only
+display the pages in the original order.
+<p>DSC conforming files start with the comment line:
+<pre>
+ %!PS-Adobe-3.0
+</pre>
+<p>where the number 3.0 may change and is the DSC version number.
+Some programs write PostScript files with a control-D as the first
+character of the file, followed by the comment line mentioned above.
+GSview will correctly report that these files are not DSC conforming,
+but will still display them with page selection features available.
+Complain to the author of the program that produced the PostScript file.
+To make the file DSC conforming, edit it to remove the control-D character.
+<p>DSC conforming files contain lines such as:
+<pre>
+ %%Pages: 24
+ %%Page: 1 1
+</pre>
+<p>These lines tell GSview how many pages a document contains and
+where they start. GSview uses this information to select
+individual pages.
+<p>Encapsulated PostScript Files (EPSF) are single page documents
+that contain a subset of the <b>DSC</b> comments and PostScript commands.
+EPS files start with the comment line:
+<pre>
+ %!PS-Adobe-3.0 EPSF-3.0
+</pre>
+<p>EPS files are commonly used for inclusion in other documents and
+for this reason require the bounding box comment:
+<pre>
+ %%BoundingBox: llx lly urx ury
+</pre>
+<p>where llx, lly, urx and ury are integers giving the x and y co-ordinates
+of the lower left and upper right corners of a bounding box which encloses
+all marks made on the page.
+<p>Some EPS files contain a preview of the PostScript document.
+This preview can be a Windows Metafile, a TIFF file, or an Interchange
+preview (EPSI format).
+For the Windows Metafile or TIFF file preview, the EPS file under DOS
+contains a binary header which specifies the location and lengths of
+the preview and PostScript language sections of the EPS file.
+For the Interchange format, the preview is contained in DSC comments
+starting with
+<pre>
+ %%BeginPreview: width height depth lines
+</pre>
+<p>An EPS file with a preview can be created from an EPS file without a
+preview using <a href="#EPS_Preview">Add EPS Preview</a>.
+<p>GSview may give warnings when documents contain incorrect DSC
+comments. This can be changed with <a href="#Options">Options</a> | <a href="#DSC_Warnings">DSC Warnings</a>.
+<p>
+<p>
+<hr>
+<h1><a name="Portable_Document_Format">Portable Document Format</a></h1>
+GSview can display and print PDF files, although there are a number
+of limitations with the current method.
+<p>When displaying, GSview ignores the page size on the Media menu,
+and instead uses the /MediaBox from the PDF file.
+If <a href="#Options">Options</a> | <a href="#EPS_Clip">EPS Clip</a> is enabled, GSview will use the /CropBox
+from the PDF file.
+<p>GSview needs to <a href="#Opening_a_Document">Open</a> a PDF file to count the pages. If you
+<b>Select</b> the file, GSview will not be able to <a href="#Text_Extract_and_Find">Text Extract</a>,
+<a href="#Text_Extract_and_Find">Find</a>, <a href="#Page_Selection">Goto Page</a> or do any other operation that needs to know
+how many pages are in the document.
+<p>pdfmark link support is crude.
+<p>To convert a PostScript file to a PDF file, use <a href="#Opening_a_Document">File</a> | <a href="#Convert">Convert</a>,
+then select the <b>pdfwrite</b> device.
+<p>To convert a PDF file to a PostScript file, use <a href="#Opening_a_Document">File</a> | <a href="#Convert">Convert</a>,
+then select the <b>pswrite</b> device.
+<p><a href="#Opening_a_Document">File</a> | <a href="#Extract">Extract</a> does not work for PDF files.
+Extracting PDF pages extracts PostScript rather than PDF.
+<p><p>To batch convert multiple files, look at
+ps2pdf.bat and pdf2ps.bat
+in the Ghostscript directory.
+You will need to use
+gswin32c.exe
+instead of gs.exe. You may also need to set the Ghostscript
+include path using <b>-I</b> or the environment variable <b>GS_LIB</b>.
+<p>
+<p>
+<hr>
+<h1><a name="Opening_a_Document">Opening a Document</a></h1>
+The <b>Open</b> command on the <b>File</b> menu opens a file and displays
+the first page.
+<p>If the file contains <a href="#Document_Structuring_Conventions">DSC</a> comments, pages can be selected using
+<a href="#Page_Selection">Next Page</a>, <a href="#Page_Selection">Previous Page</a> and <a href="#Page_Selection">Goto Page</a>.
+<p>If the file does not contain <a href="#Document_Structuring_Conventions">DSC</a> comments, <a href="#Page_Selection">Previous Page</a> and <a href="#Page_Selection">Goto Page</a>
+will not work. Another file should not be selected until a last page of
+the file has been displayed.
+<p>When a file is open, GSview will display the document filename,
+the current page (if available) and while the cursor is over
+the image, the location of the cursor in co-ordinates specified
+by <a href="#Options">Options</a> | <a href="#Units">Units</a>. The co-ordinate can be PostScript points
+(1/72"), millimetres or inches.
+The cursor location is useful for calculating bounding boxes.
+<p>The <b>Select File</b> command is similar to <b>Open</b> but it does not display
+the document.
+This command is useful for opening a document prior to printing it.
+<p>The <b>Save As</b> command saves a copy of the current document.
+This is useful if GSview is being used as a PostScript viewer by
+another application and you wish to save the currently displayed file.
+<p>The <b>Close</b> command closes the currently open document.
+This should be used before the current file is changed by another
+program.
+If you do not do this and GSview detects that the file length or date
+have changed, it will close Ghostscript and rescan the document.
+<p>See also <a href="#Printing">Print</a>.
+<p>
+<p>
+<hr>
+<h1><a name="Page_Selection">Page Selection</a></h1>
+<b>View</b> | <b>Next Page</b> or the <b>+</b> button moves to the next page of a
+document.
+This works even if the document does not contain <a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p><b>View</b> | <b>Previous Page</b> or the <b>-</b> button moves to the previous page.
+<p><b>View</b> | <b>Redisplay</b> or the <b>F5</b> key redisplays the current page.
+<p><b>View</b> | <b>Goto Page</b> or the <b>pointing hand</b> button shows a dialog box
+which allows selection of the next page number to display.
+The <b>Select Page</b> dialog box shows page labels since these are likely
+to be more useful than a sequential page number.
+<p><b>View</b> | <b>Next Page and Home</b> or the space bar moves to the top of the
+next page of a document.
+<p><b>View</b> | <b>Previous Page and Home</b> or the BackSpace key moves to the
+top of the previous page.
+<p>The <b>Previous Page</b>, <b>Redisplay</b> and <b>Goto Page</b> commands work only if the
+document contains <a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p><b>View</b> | <b>Fit Window</b> or the <b>F6</b> key changes the display resolution
+to fit the entire page within the current window. Repeated use
+causes either the width or height of the page to fit the current
+window.
+<p><b>View</b> | <b>Full Screen</b> or the <b>F4</b> key displays the page full screen
+(without title bar, scroll bars etc.).
+To return to normal display, press the Escape key.
+<p>
+<p>
+<hr>
+<h1><a name="Document_Information">Document Information</a></h1>
+A brief information area at the top of the window is used by
+GSview to display the document filename, the current page number
+and label (if available) and while the cursor is over the image, the
+location of the cursor (relative to the lower left corner of
+the paper) in co-ordinates specified by <a href="#Options">Options</a> | <a href="#Units">Units</a>.
+The cursor location is useful for calculating bounding boxes.
+<p>The <b>Info</b> command on the <b>File </b>menu shows a dialog box with the
+following information about the <a href="#Document_Structuring_Conventions">DSC</a> comments in the current document.
+<p><b>File </b>is the full pathname to the document.
+<p><b>Type</b> is<b> DSC</b>,<b> EPS</b>, <b>No DSC comments</b> or <b>Ignoring DSC Comments</b>.
+<a href="#Document_Structuring_Conventions">EPS</a> is an Encapsulated PostScript File - a single page document
+that contains a subset of the <a href="#Document_Structuring_Conventions">DSC</a> comments and PostScript commands.
+<b>EPS </b>files are commonly used for inclusion in other documents.
+<b>Ignoring DSC Comments</b> is displayed if <a href="#Options">Options</a> | <a href="#Ignore_DSC">Ignore DSC</a>
+is selected.
+These may be prefixed by <b>Ctrl-D followed by</b> or <b>PJL followed by</b>.
+Both of these indicate that the document does not comply with
+the DSC because there is some garbage at the beginning of the
+document. To fix the former, see <a href="#Common_Problems">Common Problems</a>.
+To fix the latter, do not use a HP LaserJet driver when creating
+PostScript documents for distribution to others.
+<p><b>Title</b> is a text title that can be used when printing banner
+pages and for routing or recognising documents.
+<p><b>Date</b> is the time the document was created.
+<p><a href="#PS_to_EPS">BoundingBox</a> specifies a box that encloses all the marks painted
+on the page. The four integer values are the co-ordinates of the
+lower left and upper right corners of the bounding box in default
+user co-ordinates (1/72 inch).
+<p><b>Orientation </b>is the default page orientation and is either
+<b>Portrait </b>or<b> Landscape</b>. See the <a href="#Page_Orientation">Orientation</a> menu.
+<p><b>Page Order</b> is either <b>Ascending</b>, <b>Descending</b> or <b>Special</b>.
+If <b>Page Order</b> is <b>Descending</b>, GSview automatically reverses
+the pages when displaying or printing so they appear in
+ascending order. When extracting or printing, GSview can
+be instructed to print pages in descending (reverse) order.
+<b>Special</b> means that pages should not be reordered.
+<p><b>Default Media</b> gives the media name followed by the width and
+height of that media in default user co-ordinates (1/72 inch).
+<p><b>Pages</b> is the total number of pages in the document.
+<p><b>Page</b> gives the page label and page number.
+<p><b>Bitmap </b>is the size of the display bitmap in pixels which may be
+useful if you are copying the displayed image to the clipboard.
+<p>
+<p>
+<hr>
+<h1><a name="Printing">Printing</a></h1>
+The <b>Print</b> command on the <b>File </b>menu allows printing of the document
+using Ghostscript. There are three methods used by GSview for
+printing: <a href="#Windows_GDI_printer">Windows GDI printer</a>, <a href="#Ghostscript_device">Ghostscript device</a>
+or <a href="#PostScript_printer">PostScript printer</a>.
+<p><a href="#Windows_GDI_printer">Windows GDI printer</a> uses Ghostscript to create bitmaps for
+each page, and prints these using the standard Windows printer
+driver. This is the slowest print method, but should work with
+most printers.
+<p><a href="#Ghostscript_device">Ghostscript device</a> uses the Ghostscript printer drivers.
+This is faster, but you need Ghostscript to have driver for
+your printer and you need to know what it is called.
+For example, the HP LaserJet 4 uses ljet4.
+See the Ghostscript documentation for more details.
+<p><a href="#PostScript_printer">PostScript printer</a> doesn't use Ghostscript for printing
+PostScript files. Instead the file is sent directly to
+the printer.
+<p>There is a significant amount of interaction between settings
+on the print dialog. For example, selecting <a href="#Ghostscript_device">Ghostscript device</a>
+disables the <b>Properties </b>button because this isn't relevant.
+More details are in the following topics.
+<p>See also <a href="#Conversions">Conversions</a> and <a href="#Convert">Convert</a>.
+<p>
+<a href="#Select_Pages">Select Pages</a><br>
+<a href="#Windows_GDI_printer">Windows GDI printer</a><br>
+<a href="#Ghostscript_device">Ghostscript device</a><br>
+<a href="#PostScript_printer">PostScript printer</a><br>
+<a href="#Print_File">Print File</a><br>
+<a href="#Properties">Properties</a><br>
+<a href="#Page_Size_Matching">Page Size Matching</a><br>
+<p>
+<hr>
+<h2><a name="Select_Pages">Select Pages</a></h2>
+When printing, a range of pages can be selected.
+Within this range, you can select all pages, odd pages or even pages.
+If you select odd pages in the range 10 to 20, the first to
+be printed will be 11.
+<p>The <b>Select Pages</b> button may be disabled if it is not supported by
+the print method.
+<p>The <b>Reverse</b> check box causes the pages to be printed in
+descending order. This is enabled only if the document
+contains <a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p>If you wish to print selected pages from a <a href="#Document_Structuring_Conventions">DSC</a> document that
+has special page ordering (i.e. the pages can not be reordered),
+select <a href="#Windows_GDI_printer">Windows GDI printer</a> and<a href="#Ignore_DSC">Ignore DSC</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Windows_GDI_printer">Windows GDI printer</a></h2>
+This uses Ghostscript to create a bitmap for each page, and
+these are printed using the standard Windows printer driver.
+This should work on all printers that support raster graphics.
+<p>By default, a monochrome bitmap is used for maximum speed.
+If you want colour, you will need to enable this using
+the <b>Settings </b>button.
+<p>To control how GSview handles requests by the PostScript or
+PDF documents to change the page size, see the
+<a href="#Page_Size_Matching">Page Size Matching</a> topic.
+<p><b>Options </b>is usually empty, but may contain Ghostscript command
+line options. Use with care!
+<p>This print method allows selected pages to be printed, even if
+a PostScript document does not contain <a href="#Document_Structuring_Conventions">DSC</a> comments. It does
+this by rendering all pages, but only sending the requested ones
+to the printer. This may be very slow.
+<p>
+<p>
+<hr>
+<h2><a name="Ghostscript_device">Ghostscript device</a></h2>
+The <b>Select Ghostscript Device</b> dialog box allows selection of
+the Ghostscript printer device and resolution.
+The default list of available devices and resolutions is stored
+in the [Devices] section of gsview32.ini and is taken from the
+standard distribution version of Ghostscript 6.0.
+You can use other devices or resolutions.
+<p>To control how GSview handles requests by the PostScript or
+PDF documents to change the page size, see the
+<a href="#Page_Size_Matching">Page Size Matching</a> topic.
+<p>Some Ghostscript options may be added using either the<b> Options</b>
+field or the <a href="#Properties">Properties</a> button.
+<p>The <b>uniprint</b> button selects the uniprint device and displays a list
+of available configuration files (*.upp) for the uniprint device.
+If you select one of these configuration files, the configuration file
+name will be placed in the <b>Options </b>field of the Printer Setup.
+See the Ghostscript file <b>Devices.htm</b> for details of how to configure
+the uniprint device.
+<p>
+<p>
+<hr>
+<h2><a name="PostScript_printer">PostScript printer</a></h2>
+If <b>PostScript Printer</b> is selected, the selected pages will be
+sent direct to the printer queue, without using Ghostscript.
+This is similar to <b>File </b>| <a href="#Print_File">Print File</a>, except that you can specify
+which pages to print.
+<p>When a PostScript printer is connected via a serial port, it sometimes
+requires a Ctrl+D character to be sent after the PostScript file,
+and depending on how well behaved other programs are, sometimes before.
+This is part of the serial communications protocol used by these
+printers - it is not part of PostScript.
+The <b>Settings </b>dialog allows you can choose to
+send Ctrl+D before and/or after the PostScript file.
+<p>Some PostScript printers understand multiple languages, and
+require a prolog to enable the PostScript mode.
+For example, HP LaserJet printers (with the PostScript option)
+require the following prolog
+<pre>
+ ^[%-12345X at PJL JOB
+ @PJL ENTER LANGUAGE = POSTSCRIPT
+</pre>
+<p>and the following epilog
+<pre>
+ ^[%-12345X at PJL EOJ
+ ^[%12345X
+</pre>
+<p>The prolog and epilog files allow you to send a file to the
+printer before and after the PostScript file.
+<p>Another use of the prolog might be to invoke duplex printing
+<pre>
+ << /Duplex true /Tumble false >> setpagedevice
+</pre>
+<p>If the document is <a href="#Portable_Document_Format">PDF</a>, Ghostscript will be used to convert
+the document to PostScript which will then be sent to the printer.
+<p>
+<p>
+<hr>
+<h2><a name="Print_File">Print File</a></h2>
+<b>File | Print File</b> sends a file to a local port, bypassing the
+Windows printer drivers.
+This is useful for sending a document to a PostScript printer,
+or for sending an output file produced by Ghostscript to a printer.
+<p>All pages, individual pages or any combination may be printed.
+The <b>All</b>, <b>Odd</b> and <b>Even</b> buttons provide quick selection of pages.
+If a single contiguous block of pages is marked, the <b>Odd</b> and <b>Even</b>
+buttons will select odd or even pages within this range.
+The <b>Reverse</b> check box causes the pages to be printed in
+descending order.
+<p><p>
+<p>
+<hr>
+<h2><a name="Properties">Properties</a></h2>
+The <b>Properties</b> button allows some Ghostcript devices to configure
+extra properties and a page offset to be specified.
+<p>A page offset can be specified for each device.
+The page offset is useful for correcting a mismatch between the page
+origin of a Ghostscript printer device and a particular printer.
+Increasing the X value will translate the image towards the right.
+Increasing the Y value will usually translate the image downwards.
+<p><b>Properties</b> are typically used to set BitsPerPixel for a colour
+printer, or other types of colour or density correction,
+or PDF distiller parameters.
+<p><b>Properties</b> are specific to a particular device. Changing
+the value of the <b>BitsPerPixel</b> property on one device does not
+change it for any other device.
+<p>When you press the <b>OK</b> button in the <b>Properties</b> dialog
+box, the current settings are written to the
+gsview32.ini
+<p>file.
+<p>Some <b>Properties</b> are predefined in GSview, but these may not
+match those available in Ghostscript. The <b>Edit </b>and <b>New</b>
+buttons allow you to modify available <b>Properties</b> for that device.
+See the <a href="#Edit_Properties">Edit Properties</a> topic for more details.
+<p>
+<a href="#Edit_Properties">Edit Properties</a><br>
+<p>
+<hr>
+<h3><a name="Edit_Properties">Edit Properties</a></h3>
+Not every device supports the use of optional <a href="#Properties">Properties</a>. To find
+out which devices support <a href="#Properties">Properties</a> and which <a href="#Properties">Properties</a> are
+recognised by each device, read the Ghostscript
+file Devices.htm or look at the Ghostscript source code.
+<p>There are two ways to add or edit <a href="#Properties">Properties</a>.
+<p>The first method uses the <b>Edit </b>or <b>New</b> button on the <a href="#Properties">Properties</a>
+dialog box.
+<p>Each property must be either a number or a string. Number properties
+are equivalent to the Ghostscript <b>-d</b> command line option. String
+properties are equivalent to the Ghostscript <b>-s</b> command line option.
+Each property consists of a <b>Name</b> and <b>Value</b>. These are used as
+<b>-dNAME=VALUE</b> or <b>-sNAME=VALUE</b>.
+The <b>Value</b> is chosen from the comma separated list of <b>Values</b>
+entered into the <b>Edit Properties</b> dialog box. Spaces must not
+be embedded in the <b>Name</b> or <b>Values</b>.
+<p>To delete a property, select it on the <a href="#Properties">Properties</a> dialog box,
+then press<b> Edit</b>, then press the <b>Delete</b> button on the <b>Edit Properties</b>
+dialog box.
+<p>The second method is to manually edit the GSview INI file.
+<p>For each device, you must add two sections to the
+gsview32.ini
+file.
+The following example shows how to add property information
+for the cdjcolor driver.
+First add a section which gives the current values.
+This section, after the first character is removed, gives the options
+that will appear in the <b>Property</b> list box.
+The first character is <b>s</b> for string or <b>d</b> for number.
+<pre>
+ [cdjcolor]
+ dBitsPerPixel=24
+ dDepletion=1
+ dShingling=2
+ dBlackCorrect=4
+</pre>
+<p>Next add a section which gives the values to display in the
+<b>Value</b> list box.
+<pre>
+ [cdjcolor values]
+ dBitsPerPixel=1,3,8,16,24
+ dDepletion=1,2,3
+ dShingling=0,1,2
+ dBlackCorrect=0,1,2,3,4,5,6,7,8,9
+</pre>
+<p>GSview will also add the value <b>[Not defined]</b> to the listbox.
+<p>When GSview prints a file, it will give Ghostscript the contents
+of the [cdjcolor] section of
+gsview32.ini
+as follows:
+<pre>
+ -dBitsPerPixel=24 -dDepletion=1 -dShingling=2 -dBlackCorrect=4
+</pre>
+<p>If the value of a property is <b>[Not defined]</b>, that property will
+not be sent to Ghostscript.
+<p>
+<p>
+<hr>
+<h2><a name="Page_Size_Matching">Page Size Matching</a></h2>
+If <b>Fixed Page Size</b> is selected (the default), GSview will use the
+page size on the Media menu and will ignore attempts by PostScript
+or PDF documents to change the page size.
+This is useful for PDF files that contain a mix of portrait and
+landscape pages.
+<p>If <b>Shrink to fit Page Size</b> is selected, any page size selected
+by the document that is larger than the selected media will
+be shrunk to fit the page size on the Media menu.
+This is useful if you want to print an A4 sized page on
+letter paper (although a better idea is to buy A4 paper).
+<p>If <b>Variable Page Size</b> GSview will set the default page
+size from the Media menu, but allow the page size to be changed.
+<p>
+<p>
+<hr>
+<h1><a name="Conversions">Conversions</a></h1>
+There are several ways to convert PostScript and PDF files.
+<p><b>File </b>| <a href="#Convert">Convert</a> uses Ghostscript to convert PostScript or
+PDF to bitmaps, PostScript or PDF.
+<p><b>File </b>| <a href="#Extract">Extract</a> allows a range of pages to be copied from
+a PostScript document.
+<p><b>File </b>| <a href="#PS_to_EPS">PS to EPS</a> allows the bounding box to be updated and
+allows the header to be changed from PS to EPS.
+Read the documentation thoroughly before using this.
+<p><b>Edit </b>| <a href="#EPS_Preview">Add EPS Preview</a> adds a bitmap preview to an EPS
+file.
+<p><b>Edit </b>| <a href="#EPS_Preview">Extract EPS</a> extracts the PostScript or Preview
+from a DOS EPS file.
+<p><b>Edit </b>| <a href="#Convert_to_vector_format">Convert to vector format</a> uses pstoedit to convert
+PostScript or PDF to an editable vector format.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Text Extract</a> uses pstotext to extract text from
+a PostScript or PDF document.
+<p><b>Edit </b>| <a href="#Clipboard">Copy</a> copies the display bitmap to the clipboard.
+<b>Edit </b>| <a href="#Clipboard">Paste To</a> copies a clipboard DIB bitmap to a file.
+<b>Edit </b>| <a href="#Clipboard">Convert Bitmap</a> converts a clipboard DIB bitmap
+to a clipboard device dependent bitmap.
+<p>
+<a href="#File_conversions_and_tricks">File conversions and tricks</a><br>
+<a href="#Convert">Convert</a><br>
+<a href="#Extract">Extract</a><br>
+<a href="#PS_to_EPS">PS to EPS</a><br>
+<a href="#EPS_Preview">EPS Preview</a><br>
+<a href="#User_Supplied_Preview">User Supplied Preview</a><br>
+<a href="#Convert_to_vector_format">Convert to vector format</a><br>
+<a href="#Text_Extract_and_Find">Text Extract and Find</a><br>
+<a href="#Clipboard">Clipboard</a><br>
+<p>
+<hr>
+<h2><a name="File_conversions_and_tricks">File conversions and tricks</a></h2>
+Some common file conversions that can be performed
+using GSview and Ghostscript are:
+<p>Convert PostScript to PDF.
+File | <a href="#Convert">Convert</a>, select pdfwrite, 300dpi,
+With Ghostscript 5.50, fonts with non-standard encodings
+will be included as bitmaps. If you choose 72dpi, fonts
+will look rough. Ghostscript 6.0 will embed fonts.
+<p>Convert PDF to PostScript.
+File | <a href="#Convert">Convert</a>, select pswrite, 300dpi.
+<p>Convert Level 2 PostScript to Level 1 PostScript.
+File | <a href="#Convert">Convert</a>, select psmono, 300dpi,
+Instead of 300dpi, you should use the resolution of your
+printer.
+<p>Convert to a bitmap.
+File | <a href="#Convert">Convert</a>, select bmp16m, 72dpi.
+<p>Convert to an editable vector format (pstoedit).
+Edit | <a href="#Convert_to_vector_format">Convert to vector format</a> OR convert to PDF
+using the method above.
+<p>Extract text (pstotext).
+Edit | <a href="#Text_Extract_and_Find">Text Extract</a>
+<p>Add a preview to an EPS file.
+Edit | <a href="#EPS_Preview">Add EPS Preview</a>. See <a href="#EPS_Preview">Add EPS Preview</a> for
+more details.
+<p>Remove preview from an EPS file.
+Edit | <a href="#EPS_Preview">Extract EPS</a> | PostScript
+<p>Display with smooth edges.
+Media | <a href="#Display_Settings">Display Settings</a>. Set <b>Text Alpha</b> and
+<b>Graphics Alpha</b> to 4. You need a display with
+at least 8 bits per pixel.
+<p>Save the displayed bitmap.
+Edit | <a href="#Clipboard">Copy</a> to copy to the clipboard.
+To save to a BMP file, use Edit | <a href="#Clipboard">Copy</a> then <a href="#Clipboard">Paste To</a>...
+<p>Create a bitmap with smooth edges (anti-aliasing).
+1. Display with smooth edges and save the display bitmap.
+OR
+2.
+<a href="#Convert">Convert</a> using a bitmap device and set the following
+in the properties.
+<pre>
+ -dTextAlphaBits=4 -dGraphicsAlphaBits=4
+</pre>
+<p>
+<p>
+<hr>
+<h2><a name="Convert">Convert</a></h2>
+<b>File </b>| <b>Convert</b> uses Ghostscript to convert PostScript or PDF
+to bitmaps, PostScript or PDF.
+<p>You need to select a Ghostscript output device and resolution.
+The default list of available devices and resolutions is stored
+in the [Convert] section of
+gsview32.ini
+and is taken from the standard distribution version of Ghostscript 6.01.
+You can use other devices or resolutions.
+<p>Some Ghostscript options may be added using either the
+<b>Options </b>field or the <a href="#Properties">Properties</a> button.
+<p>All pages, individual pages or any combination may be converted.
+The <b>All</b>, <b>Odd</b> and <b>Even</b> buttons provide quick selection of pages.
+If a single contiguous block of pages is marked, the <b>Odd</b> and <b>Even</b>
+buttons will select odd or even pages within this range.
+The <b>Reverse</b> check box causes the pages to be converted in
+descending order.
+<p>To control how GSview handles requests by the PostScript or
+PDF documents to change the page size, see the
+<a href="#Page_Size_Matching">Page Size Matching</a> topic.
+<p>See also <a href="#Conversions">Conversions</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Extract">Extract</a></h2>
+<b>Extract</b> allows a range of pages to be copied from the current
+document to a new document. For example, ten pages can be extracted
+from the middle of the current document and written to another file,
+which will later be sent to a printer.
+If you select <b>Reverse</b>, the extracted pages will be in descending
+order.
+<p>See also <a href="#Conversions">Conversions</a>.
+<p>
+<p>
+<hr>
+<h2><a name="PS_to_EPS">PS to EPS</a></h2>
+In general, it is not possible to convert a PostScript file to <a href="#Document_Structuring_Conventions">EPS</a>.
+However, many single page PostScript files can be converted to <a href="#Document_Structuring_Conventions">EPS</a>
+by changing the first line of the file to
+<pre>
+ %!PS-Adobe-3.0 EPSF-3.0
+</pre>
+<p>and then adding or fixing up the <b>%%BoundingBox</b> comment.
+<p>EPS files are commonly used for inclusion in other documents and
+for this reason require the bounding box comment:
+<pre>
+ %%BoundingBox: llx lly urx ury
+</pre>
+<p>where llx, lly, urx and ury are integers giving the x and y co-ordinates
+of the lower left and upper right corners of a bounding box which encloses
+all marks made on the page.
+<p><b>When used incorrectly, the PS to EPS command can produce PostScript
+files with incorrect DSC comments. Such a document will cause problems
+when you try to include it inside another document.</b>
+<p>To convert a PostScript file to <a href="#Document_Structuring_Conventions">EPS</a>, the original file <b>must</b> be
+a <b>single page</b> document. If the document contains <a href="#Document_Structuring_Conventions">DSC</a> comments
+and is multi page, extract the desired page with <a href="#Opening_a_Document">File</a> | <a href="#Extract">Extract</a>.
+If the document does not contain <a href="#Document_Structuring_Conventions">DSC</a> comments, you will need to
+edit the file by hand to extract the desired page.
+<p><a href="#Document_Structuring_Conventions">EPS</a> documents <b>must not</b> use any of the following operators:
+<pre>
+ banddevice clear cleardictstack copypage
+ erasepage exitserver framedevice grestoreall
+ initclip initgraphics initmatrix quit
+ renderbands setglobal setpagedevice setpageparams
+ setshared startjob letter note
+ legal a3 a4 a5
+</pre>
+<p>The following operators should be used with care:
+<pre>
+ nulldevice setgstate sethalftone setmatrix
+ setscreen settransfer setcolortransfer
+</pre>
+<p>It is <b>your</b> responsibility to make sure that the above requirements
+are met.
+<p>To test if a document contains any of the above operators, select
+<a href="#Options">Options</a> | <a href="#EPS_Warn">EPS Warn</a> and then <a href="#Opening_a_Document">Open</a> the desired document.
+After the page has been displayed, <a href="#Opening_a_Document">Close</a> the document and
+then display the Ghostscript messages with <a href="#Opening_a_Document">File</a> | <a href="#Show_Messages">Show Messages</a>.
+If any of the above operators have been used you should see lines like:
+<pre>
+ Warning: EPS files must not use ...
+</pre>
+<p>If you find these warnings then do <b>not</b> use <b>PS to EPS</b>.
+Remember to turn off <a href="#EPS_Warn">EPS Warn</a> afterwards.
+<p>A document must be displayed before <b>PS to EPS</b> is used.
+<p>For documents without <a href="#Document_Structuring_Conventions">DSC</a> comments, <b>PS to EPS</b> allows a bounding
+box to be specified, then writes out an <a href="#Document_Structuring_Conventions">EPS</a> file consisting of
+an <a href="#Document_Structuring_Conventions">EPS</a> wrapper around the original document.
+<p>For documents with <a href="#Document_Structuring_Conventions">DSC</a> comments, <b>PS to EPS</b> will change the
+first line of the file to
+<pre>
+ %!PS-Adobe-3.0 EPSF-3.0
+</pre>
+<p>then allows the <b>%%BoundingBox</b> comment to be changed or added.
+<p>For <a href="#Document_Structuring_Conventions">EPS</a> documents, <b>PS to EPS</b> allows the <b>%%BoundingBox</b> comment to
+be changed.
+<p><b>PS to EPS</b> does not clip the document to the <b>%%BoundingBox</b>.
+To do so would require changing the PostScript code itself.
+<b>PS to EPS</b> only changes the <a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p>If <b>Automatically calculate Bounding Box</b> is checked, GSview
+will calculate the bounding box from the non white pixels.
+If unchecked, you get to choose the bounding box by clicking at
+the left, bottom, right and top.
+<p><b>PS to EPS</b> does not add a preview to a document.
+If you want a preview you add it with <b>Edit </b>| <a href="#EPS_Preview">Add EPS Preview</a> after
+first creating an <a href="#Document_Structuring_Conventions">EPS</a> file with a correct <b>%%BoundingBox</b>.
+<p>See also <a href="#EPS_Preview">Add EPS Preview</a>, <a href="#Extract">Extract</a>, <a href="#EPS_Warn">EPS Warn</a> and <a href="#Conversions">Conversions</a>.
+<p>
+<p>
+<hr>
+<h2><a name="EPS_Preview">EPS Preview</a></h2>
+<b>Add EPS Preview</b> takes a bitmap from the
+display and uses it to add a preview to an EPS file.
+<b>Add EPS Preview</b> can create a DOS EPS file with a
+Windows Metafile or TIFF preview, or an EPSI file with an Interchange preview.
+To use the <b>Add EPS Preview</b> command the following steps must be followed.
+<p>1. Deselect <b>Options | Ignore DSC</b>
+<p>2. Make sure the document has a correct bounding box.
+<a href="#Options">Options</a> | <a href="#Show_Bounding_Box">Show Bounding Box</a> is useful for checking the
+bounding box.
+A bounding box can be added or changed using <a href="#Opening_a_Document">File</a> | <a href="#PS_to_EPS">PS to EPS</a>.
+<p>3. Select <a href="#Page_Orientation">Orientation</a> | <a href="#Page_Orientation">Portrait</a>.
+<p>4. Select <b>Media </b>| <a href="#Display_Settings">Display Settings</a> and set a suitable resolution
+for the preview. If the resolution is too high
+it will make the EPS file excessively large.
+<p>5. <a href="#Opening_a_Document">Open</a> an EPS file that does not contain a preview.
+<p>6. Select <b>Edit </b>| <b>Add EPS Preview</b>, then the preview format,
+then the new EPS filename. GSview will write a new file containing
+the original PostScript EPS file and a preview created from the
+display bitmap.
+The available preview formats are <b>Interchange</b>,
+<b>TIFF 4</b>, <b>TIFF 6 uncompressed</b>, <b>TIFF 6 packbits</b> and <b>Windows Metafile</b>.
+If adding an Interchange preview, the document must have an <b>%%EndComments</b>
+line, otherwise GSview may put the preview in the wrong place.
+An interchange preview is always monochrome.
+A TIFF 4 preview is a Baseline Bilevel Image (1 bit/pixel) with
+no compression as described in the TIFF 6.0 memorandum, but avoiding
+tags which are not described in the TIFF 4 specification.
+WordPerfect 5.1 requires a TIFF 4 preview.
+A TIFF 6 preview is a Baseline Bilevel Image,
+or a Baseline Palette-colour Image (4 or 8 bits/pixel)
+or a Baseline RGB Full Colour Image (24 bits/pixel)
+according to the TIFF 6.0 specification.
+TIFF 6 previews are either uncompressed or compressed with packbits.
+A Windows Metafile preview contains an uncompressed bitmap.
+<p>7.
+Reset <a href="#Page_Orientation">Orientation</a> | <a href="#Page_Orientation">Portrait</a>, and
+<b>Media </b>| <a href="#Display_Settings">Display Settings</a> to their previous values.
+<p>To extract the PostScript or Preview section from a DOS EPS
+file, use <a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Select File</a> followed by <b>Edit </b>| <b>Extract EPS</b>
+then <b>PostScript</b> or <b>Preview</b>.
+<p>See also <a href="#PS_to_EPS">PS to EPS</a>.
+<p>
+<p>
+<hr>
+<h2><a name="User_Supplied_Preview">User Supplied Preview</a></h2>
+The <b>Edit </b>| <a href="#EPS_Preview">Add EPS Preview</a> | <b>User Supplied Preview</b> command
+allows an existing TIFF or WMF file to be added to an EPS file
+to create a DOS EPS file.
+This is useful if an application can export to an EPS file and to
+a WMF file, but cannot create a DOS EPS file with a WMF preview.
+The EPS file <b>must</b> contain a bounding box that corresponds with
+the TIFF or WMF preview file.
+It is not necessary to display the EPS file. <b>User Supplied Preview</b>
+can be used after an EPS file has been opened with <a href="#Opening_a_Document">Select File</a>.
+<p>You can add a preview that has no resemblance to the PostScript,
+which is most undesirable.
+<p>
+<p>
+<hr>
+<h2><a name="Convert_to_vector_format">Convert to vector format</a></h2>
+You can convert a PostScript or PDF file to an editable vector
+format using <b>pstoedit</b> by Wolfgang Glunz.
+<b>pstoedit</b> is licensed with the GNU Public Licence and is not
+included with GSview. You will need to download it separately
+from the pstoedit homepage
+<pre>
+ http://www.pstoedit.net/pstoedit
+</pre>
+<p>or from
+<pre>
+ http://www.cs.wisc.edu/~ghost/gsview/pstoedit.htm
+</pre>
+<p>To use <b>pstoedit</b> from within GSview, use
+<b>Edit | Convert to vector format</b>.
+Three dialog boxes will be shown.
+<p>The first dialog is for pstoedit settings.
+<p>Select an output <b>Format</b>.
+<p><b>Draw text as polygons</b> should be selected if the PostScript file
+contains text and the output format does not support this, e.g. gnuplot.
+This might produce a large output file.
+<p>When <b>Map to ISO-Latin1</b> is selected, pstoedit maps all character codes
+to the ones defined by the ISO-Latin1 encoding, which is used by
+HTML and MS-Windows. This is the default.
+If you uncheck this item, the encoding from the input PostScript
+is passed unchanged to the output.
+<p>If the output format does not support curves in the way PostScript
+does, all curves are approximated by lines. The <b>Flatness</b> option
+is used to control this approximation. This parameter is directly
+converted to a PostScript setflat command. Small values produce
+a more accurate approximation, but more line segments.
+<p>Sometimes fonts embedded in a PostScript program do not have a
+fontname. For example, this happens in PostScript files generated
+by dvips. In such a case pstoedit uses a replacement font.
+The default for this is Courier. Another font can be specified
+using the <b>Default Font</b> option.
+Some alternative font names are Courier, Helvetica and Times-Roman.
+<p>Some of the output formats support extra options. See the pstoedit
+manual for more details. For example, the java output format
+uses <b>Driver Options</b> to specify the name of the java class.
+<p>The second dialog (omitted if no page numbering is available)
+specifies the page to be converted, or if supported by the output
+format, a range of pages to be converted.
+<p>The third dialog specifies the output file name.
+<p>Not all <b>pstoedit</b> formats support bitmap graphics.
+If you need bitmap output, see <a href="#File_conversions_and_tricks">File conversions and tricks</a>.
+<p>For more details please read the pstoedit manual.
+<p>See also <a href="#Conversions">Conversions</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Text_Extract_and_Find">Text Extract and Find</a></h2>
+In general, extracting text from a PostScript document is not a
+trivial operation. Words may be broken. Text may be encoded.
+Ligatures may be used (e.g. replacing 'fi' with a single character).
+There may be no relationship between the location of a word in
+the PostScript file and its location on the page.
+Success in extracting text from a PostScript document depends
+greatly on the document itself.
+<p>GSview has two methods of extracting text from a PostScript file.
+<p>The quick method extracts all text from PostScript strings.
+<p>The second method uses pstotext and Ghostscript to more accurately
+extract text from a PostScript document.
+<p>The method used is selected by <a href="#Options">Options</a> | <a href="#PStoText">PStoText</a>.
+See the appropriate topic below:
+<p>See also <a href="#Conversions">Conversions</a>.
+<p>
+<a href="#Quick_Text_Extract_and_Find">Quick Text Extract and Find</a><br>
+<a href="#PStoText_Text_Extract_and_Find">PStoText Text Extract and Find</a><br>
+<p>
+<hr>
+<h3><a name="Quick_Text_Extract_and_Find">Quick Text Extract and Find</a></h3>
+It is common for PostScript documents to contain text in the
+same order as it appears on the page, and for it to be given in
+PostScript strings, surrounded by parentheses. Complete lines
+may be given in one string, or one word per string. For this sort
+of document, extracting text can be done with reasonable success.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Text Extract</a> will extract text contained in strings from
+specified pages and write it to a text file.
+Line breaks in this text file correspond to lines in the document.
+Spaces in the text file correspond to spaces within strings, or to
+separate strings. A more effective method of extracting text is to
+use ps2ascii.ps supplied with Ghostscript, or to use the <a href="#PStoText">PStoText</a>
+program listed on the Ghostscript <a href="#World_Wide_Web">WWW</a> page. <a href="#PStoText">PStoText</a> can be
+used from GSview by using <a href="#Options">Options</a> | <a href="#PStoText">PStoText</a>.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Find</a> will search for text and display the first
+page that contains the text. <a href="#Text_Extract_and_Find">Find</a> asks for a search text
+and a range of pages in which to search.
+The preceding comments about extracting text from a PostScript
+document should be noted. <a href="#Text_Extract_and_Find">Find</a> first extracts text from
+the document, then searches it ignoring all spaces in both the
+document and the search text. Case is ignored when searching.
+Consequently the search text <b>these</b> would match both <b>These</b>
+and <b>The serial</b>. No information is given about where the word
+is located on a given page because this information is not
+available without a complete PostScript interpreter.
+<a href="#Text_Extract_and_Find">Find</a> will not work for non DSC documents or DSC documents with
+special page order.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Find Next</a> will continue the search from the next page.
+<p>
+<p>
+<hr>
+<h3><a name="PStoText_Text_Extract_and_Find">PStoText Text Extract and Find</a></h3>
+This method uses pstotext and Ghostscript to extract text from
+a PostScript document. Before doing any text extraction or
+searching, the entire PostScript document will be processed by
+Ghostscript and pstotext to produce a text index file.
+This may take a long time. Once this has finished, text extraction
+and searching should be quick.
+<p>pstotext uses the ISO-Latin1 character set. See the pstotext
+documentation for more details.
+<pre>
+ http://www.research.digital.com/SRC/virtualpaper/pstotext.html
+</pre>
+<p><a href="#Page_Orientation">Orientation</a> must be set to match the text direction of the
+document.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Text Extract</a> will extract text from specified pages
+and write it to a text file.
+<p>Words can be copied to the clipboard using<b> Edit</b> | <a href="#Clipboard">Copy</a>.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Find</a> will search for text and display the first
+page that contains the text. <a href="#Text_Extract_and_Find">Find</a> asks for a search text
+and a range of pages in which to search.
+The search text is first broken up into words. For each search word,
+a search is made to find a match anywhere within a document word.
+Searching for<b> frog</b> would find<b> frog</b>,<b> frogs</b> and<b> bullfrogs</b>.
+The wildcards '*' (zero or more characters) and '?' (any one character)
+are supported, but it doesn't make sense to use them at the beginning
+or end of a word.
+Wildcards do not extend beyond the word being searched.
+Multiple complete words may be specified, e.g. <b>GSview is a</b>.
+If the search text is found, the page containing the text is displayed
+and the first word highlighted.
+<a href="#Text_Extract_and_Find">Find</a> will not work for non DSC documents or DSC documents with
+special page order.
+<p><b>Edit </b>| <a href="#Text_Extract_and_Find">Find Next</a> will continue the search.
+<p>For most PostScript files you should use
+<a href="#Options">Options</a> | <a href="#PStoText">PStoText</a> | <b>Normal</b>.
+<p><a href="#Options">Options</a> | <a href="#PStoText">PStoText</a> | <b>Dvips Cork Encoding</b>
+is only relevant for PostScript files produced by
+dvips from TeX or LaTeX documents; it tells <b>pstotext</b> to use the
+Cork encoding rather than the old TeX text encoding. Unfortunately
+files produced by dvips don't distinguish which font encodings were
+used.
+<p>
+<p>
+<hr>
+<h2><a name="Clipboard">Clipboard</a></h2>
+The GSview window can be copied to the Clipboard as a bitmap
+by selecting <b>Copy</b> from the <b>Edit</b> menu.
+The bitmap will be a Device Independent Bitmap (DIB/BMP format).
+<p>An alternative way to get a bitmap output from Ghostscript is
+to use one of the BMP drivers. See <a href="#Printing">Print</a>.
+<p><b>Paste To</b> copies a Device Independent Bitmap from the Clipboard
+(if available) to a BMP file.
+<p><b>Convert Bitmap</b> converts between a Device Independent Bitmap and
+a Device Dependent Bitmap.
+If the clipboard contains a Device Independent Bitmap (BMP format),
+this is converted to a Device Dependent Bitmap and added to the clipboard.
+If the clipboard does not contain a colour palette, one is created
+from the Device Independent Bitmap and added to the clipboard.
+This option is present because some applications (notably Windows
+Paintbrush) won't recognise a Device Independent Bitmap in the clipboard.
+<p>If <a href="#Text_Extract_and_Find">Text Extract</a> or <a href="#Text_Extract_and_Find">Find</a> are used on a document with <a href="#PStoText">PStoText</a> enabled,
+GSview creates an index of the words in the document. If any words are
+marked with the mouse,
+<b>Copy</b> will copy these words to the clipboard instead
+of copying a bitmap.
+Text cannot be marked until either <a href="#Text_Extract_and_Find">Text Extract</a>
+or <a href="#Text_Extract_and_Find">Find</a> has been used with <a href="#Options">Options</a> | <a href="#PStoText">PStoText</a> enabled.
+<p>
+<p>
+<hr>
+<h1><a name="Measure">Measure</a></h1>
+Lengths can be measured using the cursor location displayed on
+the status bar, or with the <b>Edit |</b> <b>Measure</b> dialog box.
+<p>This dialog box shows the start location, finish location,
+difference between these locations and the length and angle
+between these locations.
+The start location is set when you click the left mouse button.
+The default start location is the lower left corner of the page.
+The units can be pt, mm, inch, or custom.
+<p>Custom units allows you to display coordinates as they appear
+in a PostScript file.
+Custom units are usually specified by starting with an identity
+matrix and then performing a series of transformations.
+If a PostScript file invokes landscape orientation using
+<pre>
+ 90 rotate
+ 0 -595 translate
+</pre>
+<p>then to display the user coordinates you would enter
+the following in the Calculate Transformation dialog:
+<pre>
+ Custom
+ initmatrix
+ 90 rotate
+ 0 -595 translate
+ invertmatrix
+ Ok
+</pre>
+<p>The Current Transformation Matrix (CTM) is shown in
+upper part of the dialog. You can enter a CTM directly
+if you like maths.
+It is easier to enter values in the Custom edit fields below this,
+but these have no effect until one of the transform buttons
+(translate, rotate, scale) is selected.
+<p>See also <a href="#Units">Units</a>.
+<p>
+<p>
+<hr>
+<h1><a name="Options">Options</a></h1>
+The <b>Options</b> menu has the following selections:
+<p>
+<a href="#Easy_Configure">Easy Configure</a><br>
+<a href="#Advanced_Configure">Advanced Configure</a><br>
+<a href="#Sounds">Sounds</a><br>
+<a href="#Units">Units</a><br>
+<a href="#Language">Language</a><br>
+<a href="#PStoText">PStoText</a><br>
+<a href="#DSC_Warnings">DSC Warnings</a><br>
+<a href="#Save_Settings">Save Settings</a><br>
+<a href="#Safer">Safer</a><br>
+<a href="#Save_Last_Directory">Save Last Directory</a><br>
+<a href="#Button_Bar">Button Bar</a><br>
+<a href="#Fit_Window_To_Page">Fit Window To Page</a><br>
+<a href="#Auto_Redisplay">Auto Redisplay</a><br>
+<a href="#EPS_Clip">EPS Clip</a><br>
+<a href="#EPS_Warn">EPS Warn</a><br>
+<a href="#Ignore_DSC">Ignore DSC</a><br>
+<a href="#Show_Bounding_Box">Show Bounding Box</a><br>
+<p>
+<hr>
+<h2><a name="Easy_Configure">Easy Configure</a></h2>
+Easy configure allows you to select which version of
+Ghostscript to use. It is assumed that you have already installed
+AFPL Ghostscript 7.04 or later.
+If you do not have Ghostscript installed, see the topic
+<a href="#Obtaining_Ghostscript">Obtaining Ghostscript</a>.
+For more control over configuration of GSview, see
+<a href="#Advanced_Configure">Advanced Configure</a>.
+<p>Easy configure will set the correct paths for Ghostscript
+and copy some printer defaults to the INI file.
+It does not alter the registry or start menu.
+<p>
+<p>
+<hr>
+<h2><a name="Advanced_Configure">Advanced Configure</a></h2>
+<b>Ghostscript DLL</b> tells GSview where to find Ghostscript.
+The default for Win32 is
+<pre>
+ c:\gs\gsN.NN\bin\gsdll32.dll
+</pre>
+<p>Enter the correct Ghostscript include path into the
+<b>Ghostscript Include Path</b> field.
+This include path must include the directories where the Ghostscript
+library files (gs_*.ps and Fontmap) and the Ghostscript fonts (*.pfb)
+are located. For example:
+<pre>
+ c:\gs\gsN.NN\lib;c:\gs\fonts
+</pre>
+<p>Do NOT put a <b>-I</b> before the include path.
+<p>The <b>Ghostscript Options</b> field may be empty.
+If you wish to turn off the <b>Platform Fonts</b> feature under
+MS-Windows, put <b>-dNOPLATFONTS</b> in the <b>Ghostscript Options</b> field.
+If you wish to search for fonts not listed in Fontmap,
+add -sFONTPATH to this field. For example
+<pre>
+ -dNOPLATFONTS -sFONTPATH="c:\psfonts"
+</pre>
+<p>If you do not get the <b>Ghostscript DLL</b> field correct, GSview will
+not be able to load Ghostscript.
+If you do not get the <b>Ghostscript Include Path</b> correct, Ghostscript
+will not initialise and will then unload.
+<p>Selecting <b>Copy printer defaults</b> will update gsview32.ini from the
+file printer.ini.
+<p>Selecting <b>Associate .ps files with GSview</b> will update the registry
+to associate PostScript files with GSview.
+<p>Selecting <b>Associate .pdf files with GSview</b> will update the registry
+to associate Portable Document Format files with GSview.
+<p>Selecting <b>Create Start Menu items</b> will add GSview to the start menu.
+<p>There is no undo facility for the actions of these four checkboxes.
+The Associate and Start Menu actions are normally performed
+(with an undo facility) by the GSview setup program.
+<p>See the <a href="#Installation">Installation</a> topic.
+<p>
+<p>
+<hr>
+<h2><a name="Sounds">Sounds</a></h2>
+The <b>Sounds</b> option assigns sounds to various events.
+For each event the sound can be set to <b>None</b>, a <b>Speaker Beep</b> or
+a <b>Wave</b> file.
+<p>You must have a sound driver loaded before using Wave files.
+Wave file sounds are not available under MS-Windows 3.0.
+<p>The events are:
+<p><b>Output Page</b>: the PostScript showpage operator was executed.
+<p><b>No Page</b>: an invalid page was selected.
+For example, pressing <b>Prev</b> while on the first page of a document
+with <a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p><b>No Number</b>: a command required page numbering and the document did
+not have page numbering.
+For example, pressing <a href="#Page_Selection">Goto Page</a> when viewing a document without
+<a href="#Document_Structuring_Conventions">DSC</a> comments.
+<p><b>Not Open</b>: a command required a document to be open and this was
+not the case.
+For example, pressing <a href="#Page_Selection">Goto Page</a> when no document is open.
+<p><b>Error</b>: many types of errors.
+<p><b>Start</b>: GSview opened.
+<p><b>Exit</b>: GSview closed.
+<p><b>Busy</b>: busy at the moment, can't do what you asked.
+<p>The defaults are for <b>No Page</b>, <b>Error</b> and <b>Busy</b> to be a
+<b>Speaker Beep</b> and all other events to be <b>None</b>.
+<p>
+<p>
+<hr>
+<h2><a name="Units">Units</a></h2>
+The <b>Units</b> option sets the units used to display the cursor location
+on the status bar. Available units are PostScript points (<b>pt</b> = 1/72"),
+millimetres (<b>mm</b>) and inches (<b>in</b>).
+The default is <b>pt</b>.
+<p>The resolution of the units can be increased by selecting
+<b>Units </b>| <b>Fine Resolution</b>.
+<p>See also <a href="#Measure">Measure</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Language">Language</a></h2>
+GSview is available in English, Dutch, French, German, Greek,
+Italian and Spanish.
+To change the language use <a href="#Options">Options</a> | <b>Language</b>.
+<p>On Windows NT, all existing languages are available to be
+selected, independent of the regional settings.
+On other systems, the language availability depends on the
+selected regional settings, in particular the chosen locale
+or system code page.
+<p>
+<p>
+<hr>
+<h2><a name="PStoText">PStoText</a></h2>
+GSview has two methods of extracting and searching text.
+<p>The <a href="#Quick_Text_Extract_and_Find">Quick Text Extract and Find</a> method does a simple extraction
+of PostScript strings. This method is easily confused.
+This is selected by the menu item <b>PStoText</b> | <b>Disabled</b>.
+<p>The <a href="#PStoText_Text_Extract_and_Find">PStoText Text Extract and Find</a> method uses the external pstotext
+tool and Ghostscript to extract words and their co-ordinates.
+This method is more accurate, but there may be a long pause while
+pstotext and Ghostscript do the initial processing.
+After this, text extraction and searching should be quick.
+There are two modes of operation. <b>Normal</b> should be used
+for most PostScript files. <b>Dvips Cork Encoding</b> should be
+used if you have a PostScript file produced by dvips
+which uses Cork Encoding.
+<p>The default is <b>Normal</b>.
+<p>
+<p>
+<hr>
+<h2><a name="DSC_Warnings">DSC Warnings</a></h2>
+Some documents contain errors in the Document Structuring Conventions.
+The level of warnings provided by GSview can be set using
+<a href="#Options">Options</a> | <b>DSC Warnings</b>.
+If set to<b> Off</b>, GSview will assume that the DSC comments are correct.
+<b>Errors</b> will notify you of errors in the DSC comments .
+<b>Warnings</b> will notify you of warnings and errors in the DSC comments.
+<b>All</b> will notify you of irregularities, warnings and errors in the
+DSC comments. The default is <b>Warnings</b>.
+<p>If you ask to be notified about errors and warnings, the DSC
+warning dialog box allows you to make the following choices:
+<b>OK</b> tells GSview to take a guess about what was probably meant
+(rather than what the DSC comment actually said),
+<b>Cancel</b> tells GSview to treat the DSC as being correct,
+<b>Ignore DSC </b> tells GSview to ignore all DSC comments.
+<p>If <b>DSC Warnings</b> is<b> Off</b>, GSview will assume <b>Cancel</b>.
+Documents with incorrect DSC comments will be likely to cause problems.
+<p>
+<p>
+<hr>
+<h2><a name="Save_Settings">Save Settings</a></h2>
+The <b>Save Settings Now</b> option saves the GSview window position,
+window size, last used printer, last directory,
+all items on the <a href="#Options">Options</a> menu and all items on the <a href="#Page_Size">Media</a> menu
+to the initialisation file
+gsview32.ini in the Windows system directory (or for Windows
+95 or NT 4 in the user profile directory if user profiles are
+being used).
+GSview reads this file during startup.
+<p>When the <b>Save Settings on Exit</b> option is checked, GSview will
+automatically save the above settings when you quit GSview.
+<p>
+<p>
+<hr>
+<h2><a name="Safer">Safer</a></h2>
+When the <b>Safer</b> option is <b>checked</b>, GSview will give Ghostscript
+the <b>-dSAFER</b> flag, which disables the deletefile and renamefile operators,
+and the ability to open files in any mode other than read-only.
+This is the default.
+<p>When the <b>Safer</b> option is <b>unchecked</b> Ghostscript can change
+files.
+<p>
+<p>
+<hr>
+<h2><a name="Save_Last_Directory">Save Last Directory</a></h2>
+When the <b>Save Last Directory</b> option is <b>checked</b>, GSview will
+save the current directory when you quit GSview. When GSview
+is started next, this will be made the current directory.
+This is the default.
+<p>When <b>Save Last Directory</b> option is <b>unchecked</b>, the current
+directory when GSview is started will be the current directory
+of the program that started GSview.
+<p>
+<p>
+<hr>
+<h2><a name="Button_Bar">Button Bar</a></h2>
+When the <b>Button Bar</b> option is <b>checked</b>, GSview will display
+a Button Bar
+at the top
+of the window. This is the default.
+The Button Bar contains the following items in order from
+left to right:
+
+<img src="gvwopen.gif">
+<a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Open</a>
+<p>
+<img src="gvwprint.gif">
+<a href="#Opening_a_Document">File</a> | <a href="#Printing">Print</a>
+<p>
+<img src="gvwinfo.gif">
+<a href="#Opening_a_Document">File</a> | <a href="#Document_Information">Info</a>
+<p>
+<img src="gvwhelp.gif">
+<b>Help</b> | <b>Contents</b>
+<p>
+<img src="gvwgoto.gif">
+<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Goto Page</a>
+<p>
+<img src="gvwprevs.gif">
+<b>Go back 5 pages</b>
+<p>
+<img src="gvwprev.gif">
+<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Previous Page</a>
+<p>
+<img src="gvwnext.gif">
+<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Next Page</a>
+<p>
+<img src="gvwnexts.gif">
+<b>Go forward 5 pages</b>
+<p>
+<img src="gvwback.gif">
+<a href="#Page_Selection">View</a> | <b>Go Back</b>
+<p>
+<img src="gvwfwd.gif">
+<a href="#Page_Selection">View</a> | <b>Go Forward</b>
+<p>
+<img src="gvwmagp.gif">
+<b>Increase resolution by 1.2</b>
+<p>
+<img src="gvwmagm.gif">
+<b>Decrease resolution by 1/1.2</b>
+<p>
+<img src="gvwfind.gif">
+<b>Edit </b>| <a href="#Text_Extract_and_Find">Find</a>
+<p>
+<img src="gvwfindn.gif">
+<b>Edit </b>| <a href="#Text_Extract_and_Find">Find Next</a>
+<p>If using the increase/decrease resolution buttons, <a href="#Auto_Redisplay">Auto Redisplay</a>
+should be set. Instead of using these buttons the
+<b>Media </b>| <a href="#Display_Settings">Display Settings</a> command can be used.
+When the <b>Button Bar</b> option is <b>unchecked</b>, GSview will not
+display the Button Bar.
+<p>
+<p>
+<hr>
+<h2><a name="Fit_Window_To_Page">Fit Window To Page</a></h2>
+When the <b>Fit Window To Page</b> option is <b>checked</b>, changes to the page
+size or orientation will cause the window size to be enlarged or
+reduced to suit the page size.
+Whenever the window is resized, GSview will force it to be no larger
+than the page being displayed.
+<p>Changes in the window size will only occur when the window is resized
+or the page size changed; it does not happen immediately after this
+option is changed.
+Fit Window To Page is ignored for a maximized window.
+<p>If <b>Fit Window To Page</b> is <b>unchecked</b>, GSview will not resize the
+window and areas outside the page will be drawn in light grey.
+This is useful if you do not wish the window to shrink when looking
+at pages at low resolution. This is the default.
+<p>See also <a href="#Page_Selection">View</a> | <a href="#Page_Selection">Fit Window</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Auto_Redisplay">Auto Redisplay</a></h2>
+When the <b>Auto Redisplay</b> option is <b>checked</b>, GSview will
+redisplay <a href="#Document_Structuring_Conventions">DSC</a> documents when the <a href="#Page_Orientation">Orientation</a>, <a href="#Display_Settings">Resolution</a>,
+<a href="#Display_Settings">Depth</a> or <a href="#Page_Size">Media</a> are changed.
+This is the default.
+<p>For <b>non-DSC documents</b>, if <b>Auto Redisplay</b> is <b>checked</b>,
+GSview will <b>restart at the first page</b>.
+<p>If <b>Auto Redisplay</b> is <b>unchecked</b>, the <a href="#Page_Selection">View</a> | <a href="#Page_Selection">Redisplay</a> command
+must be used to redisplay a document after changing the
+<a href="#Page_Orientation">Orientation</a>, <a href="#Display_Settings">Resolution</a>, <a href="#Display_Settings">Depth</a> or <a href="#Page_Size">Media</a>.
+<p>
+<p>
+<hr>
+<h2><a name="EPS_Clip">EPS Clip</a></h2>
+When the <b>EPS Clip</b> option is <b>checked</b>, GSview will clip the
+display bitmap to the bounding box of an EPS file instead of using the
+page size specified on the <a href="#Page_Size">Media</a> menu. This is useful when
+adding a bitmap preview to an EPS file.
+If a PDF file is being displayed, <b>EPS Clip</b> will cause the
+display to be clipped to the PDF crop box.
+<p>If <b>EPS Clip</b> is <b>unchecked</b>, GSview will use the page size
+specified on the <a href="#Page_Size">Media</a> menu for EPS files. This is the default.
+<p><b>EPS Clip</b> does not alter the original document, it only affects
+how much of the document is displayed by GSview.
+It does not affect printing.
+<p>See also <b>Edit </b>| <a href="#EPS_Preview">Add EPS Preview</a>
+<p>
+<p>
+<hr>
+<h2><a name="EPS_Warn">EPS Warn</a></h2>
+When the <b>EPS Warn</b> option is <b>checked</b>, GSview will write a
+prolog to Ghostscript when each file is opened. This prolog will
+produce warning messages in the <b>File </b>| <a href="#Show_Messages">Show Messages</a>
+window if any PostScript operators that should not be used in <a href="#Document_Structuring_Conventions">EPS</a>
+files are used. An example warning message is:
+<pre>
+ Warning: EPS files must not use /initgraphics
+</pre>
+<p><b>EPS Warn</b> is not infallible. It is possible to access restricted
+operators without <b>EPS Warn</b> producing a warning.
+If you do get a warning, do NOT used <a href="#PS_to_EPS">PS to EPS</a>.
+<p>The default for <b>EPS Warn</b> is <b>unchecked</b>.
+<p>See also <a href="#PS_to_EPS">PS to EPS</a>.
+<p>
+<p>
+<hr>
+<h2><a name="Ignore_DSC">Ignore DSC</a></h2>
+Some documents incorrectly claim to conform to the Adobe Document
+Structuring Conventions. Attempting to display one of these bogus
+documents will probably leave GSview horribly confused and unable
+to display the document. If <b>Ignore DSC</b> is <b>checked</b>, GSview
+will treat the document as if it does not contain DSC comments
+and will only display the pages in the original order.
+<p>The default for <b>Ignore DSC</b> is <b>unchecked</b>.
+<p>
+<p>
+<hr>
+<h2><a name="Show_Bounding_Box">Show Bounding Box</a></h2>
+Selecting this option causes a dashed rectangle to drawn over
+the image, showing the location of the bounding box.
+This bounding box is only drawn on the display, and does not
+affect printer output.
+The bounding box will only be shown for <a href="#Document_Structuring_Conventions">DSC</a> documents (non
+conforming documents don't have a bounding box).
+<p>The default for <b>Show Bounding Box</b> is <b>unchecked</b>.
+<p>
+<p>
+<hr>
+<h1><a name="Page_Orientation">Page Orientation</a></h1>
+The <b>Portrait</b>, <b>Landscape</b>, <b>Upside-down</b> and <b>Seascape</b>
+(reverse Landscape) commands on the <b>Orientation </b>Menu select
+the page orientation used by the display.
+<b>Landscape</b> implies a clockwise rotation of the paper by 90 degrees.
+<b>Seascape</b> implies an anti-clockwise rotation of the paper by 90 degrees.
+These orientation options only affect the display and do not affect
+the print commands.
+<p>If the <b>Auto</b> command on the orientation menu is checked and
+a <a href="#Document_Structuring_Conventions">DSC</a> page orientation comment is found (%%Orientation or
+%%PageOrientation), the orientation will be selected automatically.
+<p>When the <b>Swap Landscape</b> option is <b>checked</b>, GSview swaps the
+meaning of Landscape and Seascape.
+Most of the Landscape documents that I have encountered require a 90
+clockwise rotation of the paper to view.
+However, there is no standard and some documents need to be rotated
+the other way.
+The <b>Swap Landscape</b> button allows GSview to automatically rotate the
+document the right way in response to the <b>%%Orientation</b> comment in the
+PostScript file.
+<p>See also <a href="#Page_Size">Page Size</a> and <a href="#Display_Settings">Display Settings</a>.
+<p>
+<p>
+<hr>
+<h1><a name="Display_Settings">Display Settings</a></h1>
+Some settings for display only can be set with <a href="#Page_Size">Media</a> | <b>Display Settings</b>.
+<p>The <b>Resolution</b> field sets the display resolution in dots per inch.
+The default for a VGA display is 96 dots per inch.
+This can also be changed by the resolution changing buttons on
+the button bar.
+<p>For DSC conforming files, pressing the right mouse button will
+<a href="#Zoom">Zoom</a> into the page at what is usually printer resolution.
+Pressing the right mouse button a second time will zoom back out to
+normal display resolution.
+The <b>Zoom Resolution</b> field sets the zoom resolution in dots per inch.
+<p>The <b>Depth</b> field sets the page bitmap depth in bits per pixels
+for the display.
+Default will select the highest depth supported by your display
+driver. In general, you shouldn't set this higher than your
+actual display depth because doing so will use extra memory
+for the page bitmap but won't improve the display.
+<p>The <b>Text Alpha</b> field sets anti-aliasing for fonts. The default
+(use anti-aliasing) is 4 bits. To disable anti-aliasing of fonts,
+use 1 bit.
+<p><b>IMPORTANT</b>: If you use <b>Text Alpha</b>, GSview will disable
+<b>Platform Fonts</b> by doing the equivalent of adding
+<pre>
+ -dNOPLATFONTS
+</pre>
+<p>to the <b>Options </b>| <a href="#Advanced_Configure">Advanced Configure</a> Ghostscript Options field.
+<p>The <b>Graphics Alpha</b> field sets anti-aliasing for graphics and
+also for text that is too large to fit in the font cache.
+<p>Using anti-aliasing slows down drawing.
+Text and Graphics Alpha can only be used if your display depth is
+set to 8bits/pixel or higher.
+<p>
+<a href="#Zoom">Zoom</a><br>
+<p>
+<hr>
+<h2><a name="Zoom">Zoom</a></h2>
+To enlarge a displayed feature, position the cross-hair mouse pointer
+over the feature then press the right mouse button.
+The window will swap from normal display resolution to zoom
+resolution and the status line will have the word <b>Zoomed</b> appended to it.
+The zoomed feature will be in the centre of the window.
+To cancel <b>Zoom</b>, press the right mouse button again or select
+any command that redraws the page (e.g. <a href="#Page_Selection">Redisplay</a>, <a href="#Page_Selection">Next Page</a>).
+By default the zoom resolution is 300 dots per inch but this can
+be changed with <a href="#Page_Size">Media</a> | <a href="#Display_Settings">Display Settings</a> dialog box.
+<p><b>Zoom</b> will only work for <a href="#Document_Structuring_Conventions">DSC</a> conforming documents.
+<p>To enlarge or shrink the entire page, use the <a href="#Display_Settings">Resolution</a>
+on the <a href="#Page_Size">Media</a> | <a href="#Display_Settings">Display Settings</a> dialog box, use the magnifying
+glass toolbar buttons.
+<p>
+<p>
+<hr>
+<h1><a name="Page_Size">Page Size</a></h1>
+The <b>Media</b> menu also allows selection of page size.
+Available page sizes are:
+<pre>
+ 11x17 11 x 17 inch
+ A0 840 x 1189 mm
+ A1 594 x 840 mm
+ A2 420 x 594 mm
+ A3 297 x 420 mm
+ A4 210 x 297 mm
+ A5 148 x 210 mm
+ B4 257 x 364 mm
+ B5 182 x 257 mm
+ Ledger 17 x 11 inch
+ Letter 8.5 x 11 inch
+ Legal 8.5 x 14 inch
+ Note 8.5 x 11 inch
+</pre>
+<p>A user defined size can be specified in PostScript points (1/72 inch)
+with the <b>User Defined</b> command. A size of 480x360 points at 96 dpi
+will give an image size of 640x480 pixels.
+<p>If a <a href="#Document_Structuring_Conventions">DSC</a> media comment is found, such as
+<pre>
+ %%DocumentPaperSizes: a4
+ %%DocumentMedia: a4 595 842 80 white ( )
+</pre>
+<p>the page type will be selected automatically.
+If the media specification is not one of the above page types,
+the <b>User Defined</b> size will be set.
+<p>If <b>Rotate Media</b> is checked, the width and height of the page
+are exchanged. The image drawn on the page is not rotated.
+This affects both display and printing.
+Selecting <b>A4</b> and <b>Rotate Media</b> is equivalent to selecting
+<b>User Defined</b> with a size of 842 x 595 pt.
+It is more common to use the settings on the <a href="#Page_Orientation">Orientation</a> menu
+than <b>Rotate Media</b>.
+<p>
+<p>
+<hr>
+<h1><a name="Keys">Keys</a></h1>
+Following are the key assignments for GSview.
+<p><b>O</b>, <b>o</b> Open and display a file. (<a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Open</a>)
+<p><b>C</b>, <b>c</b> Close file. (<a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Close</a>)
+<p><b>N</b>, <b>n</b>, <b>+</b> Next Page. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Next Page</a>)
+<p>Space Next Page and Home. (<a href="#Page_Selection">View</a> | <b>Next Page and Home</b>)
+<p><b>V</b>, <b>v</b>, <b>-</b> Previous Page. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Previous Page</a>)
+<p>BackSpace Previous Page and Home. (<a href="#Page_Selection">View</a> | <b>Previous Page and Home</b>)
+<p><b>G</b>, <b>g</b> Goto Page. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Goto Page</a>)
+<p><b>I</b>, <b>i</b> File information. (<a href="#Opening_a_Document">File</a> | <a href="#Document_Information">Info</a>)
+<p><b>R</b>, <b>r</b>, <b>F5</b> Redisplay page. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Redisplay</a>)
+<p><b>S</b>, <b>s</b> Select file: open but don't display. (<a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Select File</a>)
+<p><b>A</b>, <b>a</b> Save As. (<a href="#Opening_a_Document">File</a> | <a href="#Opening_a_Document">Save As</a>)
+<p><b>P</b>, <b>p</b> Print all or some pages to a printer. (<a href="#Opening_a_Document">File</a> | <a href="#Printing">Print</a>)
+<p><b>F</b>, <b>f</b> Convert all or some pages to a PDF or bitmap File.
+(<a href="#Opening_a_Document">File</a> | <a href="#Convert">Convert</a>).
+<p><b>E</b>, <b>e</b> Extract some pages to another File. (<a href="#Opening_a_Document">File</a> | <a href="#Extract">Extract</a>)
+<p><b>M</b>, <b>m</b> Show Ghostscript Messages. (<a href="#Opening_a_Document">File</a> | <a href="#Show_Messages">Show Messages</a>)
+<p><b><</b> Decrease resolution by 1/1.2
+<p><b>></b> Increase resolution by 1.2
+<p><b>F1</b> Help. (<b>Help</b> | <b>Contents</b>)
+<p><b>Ctrl+C</b>, <b>Ctrl+Insert</b> Copy displayed bitmap to clipboard. (<b>Edit</b> | <a href="#Clipboard">Copy</a>)
+<p><b>Ctrl+F</b>, Find Text. (<b>Edit</b> | <a href="#Text_Extract_and_Find">Find</a>)
+<p><b>F3</b>, Find Next. (<b>Edit</b> | <a href="#Text_Extract_and_Find">Find Next</a>)
+<p><b>F4</b> Full Screen. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Full Screen</a>)
+<p><b>F6</b> Fit Window. (<a href="#Page_Selection">View</a> | <a href="#Page_Selection">Fit Window</a>)
+<p><b>Arrow Keys</b> Scroll by 1/16 of a screen.
+<p><b>Ctrl + Arrow Keys</b> Scroll by one screen.
+<p><b>Page Up</b> Scroll up one screen (window height).
+<p><b>Page Down</b> Scroll down one screen.
+<p><b>Home</b> Scroll to top of page.
+<p><b>End</b> Scroll to bottom of page.
+<p>
+<p>
+<hr>
+<h1><a name="Command_line_options">Command line options</a></h1>
+GSview ignores the case of options:
+-p is the same as -P. On Windows or OS/2, you can also
+use /p or /P. In the samples below, replace <b>gsview</b> with
+<b>gsview32</b> on Windows and <b>gvpm</b> on OS/2.
+<p>Usage:
+<pre>
+ gsview [-d] [-t] [-f[DEVICE]] [-p[QUEUE]]
+ [-mPAPERSIZE] [-oORIENTATION] [-rXDPIxYDPI]
+ [-geometry WIDTHxHEIGHT[+XOFF+YOFF]] filename
+</pre>
+<p>Options:
+<p><b>filename</b> To start GSview and display filename.ps:
+<pre>
+ gsview filename.ps
+</pre>
+<p><b>-p</b> prints filename.ps using Ghostscript.
+This is similar to <a href="#Opening_a_Document">File</a> | <a href="#Printing">Print</a>, except that you will
+not be prompted for a printer (it will use the printer most
+recently used by GSview, or the printer name you provide)
+and GSview will exit after printing has finished:
+<pre>
+ gsview -p filename.ps
+</pre>
+<p><b>-f</b> converts a PostScript file (not PDF) filename.ps
+to a file using Ghostscript (<a href="#Opening_a_Document">File</a> | <a href="#Convert">Convert</a>):
+<pre>
+ gsview -f filename.ps
+</pre>
+<p><b>-m</b>PAPERSIZE sets the paper size. Any of the predefined
+sizes on the media menu are valid.
+<p><b>-o</b>ORIENTATION sets the orientation and may be one of
+<b>auto</b>, <b>portrait</b>, <b>landscape</b>, <b>upsidedown</b> or <b>seascape</b>.
+<p><b>-r</b>XDPIxYDPI sets the display, convert or print resolution.
+<p>To display a file with A4 paper, landscape orientation
+and 96dpi:
+<pre>
+ gsview -ma4 -olandscape -r96x96 filename.ps
+</pre>
+<p><b>-d</b> Debug mode.
+In debug mode GSview will <b>not</b> remove its temporary files.
+This is to allow inspection of these files after GSview has finished.
+Debug mode also produces more verbose output for <b>File </b>| <a href="#Show_Messages">Show Messages</a>.
+To write debugging output to
+c:\gsview.txt
+use -d9
+<p><b>-t</b> Multi-threading. GSview by default runs multi-threaded,
+except for Windows 3.1/Win32s.
+To change this, use <b>-t</b> to toggle the threading mode, use <b>-t0</b> to select
+single-thread mode and <b>-t1</b> to select multi-thread mode.
+<p>Windows supports a few additional command line options.
+<p><b>-s</b> spools a file directly to the printer, without using Ghostscript.
+GSview will exit when the file has been spooled.
+Some examples are:
+<pre>
+ gsview -s filename.ps
+ gsview -sLPT3: filename.ps
+ gsview "-sHP DeskJet Portable" filename.ps
+</pre>
+<p><b>-e</b> uses DDE to open a file in an existing GSview, or if GSview
+is not already running, in a new window using.
+<pre>
+ gsview -e filename
+</pre>
+<p><b>-x</b> uses DDE to tell an existing GSview to close.
+<pre>
+ gsview -x
+</pre>
+<p>
+<a href="#Dynamic_Data_Exchange">Dynamic Data Exchange</a><br>
+<p>
+<hr>
+<h2><a name="Dynamic_Data_Exchange">Dynamic Data Exchange</a></h2>
+GSview implements a DDE server, service="GSview and topic="GSview".
+The XTYP_EXECUTE commands that are recognised are:
+<pre>
+ [FileOpen("filename")]
+ [FileExit()]
+ [NextPage()]
+ [PrevPage()]
+ [GoBack()]
+ [GotoPage(5)]
+ [ShowWindow(nCmdShow)]
+ [Command("command line")]
+</pre>
+<p>The [Command()] command only understands "filename" or "/P filename".
+<p>Don't sent multiple commands together. GSview won't complain,
+but the multithreaded asynchrononous execution within GSview
+means that the first command won't have been completed before
+the second command is received. If you need to send multiple
+commands, send them separately with pauses inbetween.
+<p>There are two command line options to cause GSview to send a DDE
+command to another copy of GSview.
+The /E command line option uses [Command("command line")][ShowWindow(1)].
+The /X command line option uses [FileExit()].
+<p>
+<p>
+<hr>
+<h1><a name="World_Wide_Web">World Wide Web</a></h1>
+The World Wide Web home page for Ghostscript, Ghostview and GSview
+is at
+<pre>
+ http://www.cs.wisc.edu/~ghost/
+</pre>
+<p>GSview can be registered on-line at
+<pre>
+ http://www.ghostgum.com.au/
+</pre>
+<p>GSview can be used as a PostScript file viewer for several OS/2
+and MS-Windows Web browsers. See the GSview home page for details.
+<p>Thomas Merz has written a Ghostscript manual, which is available
+in <a href="#Portable_Document_Format">PDF</a> from the above WWW site. This manual is an extract from a
+book written by Thomas Merz titled <b>PostScript and Acrobat/PDF</b>,
+available in English and German.
+<p>
+<p>
+<hr>
+<h1><a name="Copyright">Copyright</a></h1>
+The <b>About</b> menu item shows the GSview copyright message
+and GSview version number.
+<p><pre>
+ GSVIEW.EXE - A Ghostscript graphical interface
+ Copyright (C) 1993-2002, Ghostgum Software Pty Ltd. All rights reserved.
+</pre>
+<p>This file is part of GSview.
+<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>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><pre>
+ Author: Russell Lang, Ghostgum Software Pty Ltd
+ Internet: gsview at ghostgum.com.au
+</pre>
+<p>Please read the <a href="#Common_Problems">Common Problems</a> topic, the GSview Readme.htm and browse
+the <a href="#World_Wide_Web">WWW</a> page before sending mail to the author.
+<p>GSview uses pstotext in an external DLL. pstotext was written by
+Andrew Birrell and Paul McJones. It is
+<pre>
+ Copyright (C) 1995-1996, Digital Equipment Corporation.
+</pre>
+<p>See the licence in pstotext.txt or pstotext.zip for more details.
+If you do not agree to the pstotext licence, delete pstotext.zip,
+pstotxt2.dll and pstotxt3.dll.
+<p>
+<p>
+<hr>
+<h1><a name="Common_Problems">Common Problems</a></h1>
+<b>Problem:</b> Can't load Ghostscript DLL ...
+<p>GSview requires the Ghostscript DLL
+(gsdll2.dll for OS/2, gsdll32.dll for Win32).
+This error message usually occurs if you don't have Ghostscript,
+or if GSview can't find Ghostscript.
+<p>From the GSview menu select <a href="#Options">Options</a> | <a href="#Advanced_Configure">Advanced Configure</a>
+and enter the correct <a href="#Advanced_Configure">Ghostscript DLL</a> path. For example
+<pre>
+ c:\gs\gsN.NN\bin\gsdll32.dll
+</pre>
+<p>This message also occurs if Ghostscript cannot find its
+initialisation files (e.g. gs_init.ps). Set the
+<a href="#Advanced_Configure">Ghostscript Include Path</a> correctly.
+<p>If using Win32s, make sure you don't already have a copy of
+the Ghostscript DLL loaded by another copy of GSview.
+Only one copy of Ghostscript DLL can be loaded by Win32s at a time.
+<p>If you can't get GSview to run Ghostscript DLL correctly, make sure
+you can configure and run Ghostscript on its own.
+<p><b>Problem:</b> Ghostscript Messages window says
+<b>Can't find initialization file gs_init.ps</b>.
+<p>Set the <a href="#Advanced_Configure">Ghostscript Include Path</a> to point to the directory containing
+the correct gs_init.ps.
+<p><b>Problem:</b> Ghostscript Messages window says
+<b>gs: Interpreter revision (XXX) does not match gs_init.ps revision (YYY)</b>.
+<p>Set the <a href="#Advanced_Configure">Ghostscript Include Path</a> to point to the directory containing
+the correct gs_init.ps.
+Don't try to display a PostScript file in the directory of an old
+version of Ghostscript (which will cause the old gs_init.ps to be
+loaded irrespective of the <a href="#Advanced_Configure">Ghostscript Include Path</a>).
+<p><b>Problem:</b> Ghostscript Messages window says
+<b>Wrong version of DLL found. Found version XXX Need version YYY</b>.
+<p>GSview found the wrong Ghostscript DLL. Install the required
+version of the Ghostscript DLL. Make sure you have only one copy
+of the Ghostscript DLL on your system.
+<p><b>Problem:</b> GSview says that a multipage PostScript file produced
+by MS-Windows contains 0 pages and will only show the first page.
+<p>This is because the document does not have correct DSC comments.
+From the Control Panel, select <b>Printers</b>, <b>Options...</b>, then in the
+<b>Print to</b> group box click on the <b>Printer</b> radio button. You cannot
+use the <b>Print To</b> <b>Encapsulated PostScript File</b> for printing
+multipage files. The correct method is to connect the printer
+to <b>FILE:</b>.
+In addition,
+from the Control Panel select <b>Printers</b>, <b>Options...</b>, <b>Advanced</b> and
+then check <b>Conform to Adobe Document Structuring Convention</b>.
+<p>The DSC comment <b>%%Pages: 0</b> means that the document does not produce
+any pages. That is, the PostScript <b>showpage</b> operator is not used.
+If you find a PostScript document that has multiple pages and contains
+the <b>%%Pages: 0</b> comment, change the first line from <b>%!PS-Adobe-</b> to <b>%!</b>.
+GSview will then ignore the DSC comments and allow you to view all
+pages, but only in the original order. Complain to the author of the
+program that produced that PostScript file.
+<p>Some PostScript printer drivers include code that is specific to
+a particular printer. The PostScript output from these drivers may
+be unportable and may not display in GSview. If you are having this
+problem, try using a reasonably generic PostScript driver such as
+<b>Apple LaserWriter II NT</b> for PostScript level 2 printers, or
+<b>Apple LaserWriter Plus</b> for PostScript level 1 printers.
+<p>For Windows 95, open the printer properties then select the
+PostScript tab, then select PostScript Output Format =
+<b>PostScript (optimize for portability - ADSC)</b>.
+<p><b>Problem:</b> GSview says "Page ordering is Special..."
+<p>Your document used the DSC comment <b>%%PageOrder: Special</b> which means
+that pages can not be reliably reordered. This may prevent GSview
+from displaying pages in any order other than the original order.
+If you continue and reorder the pages, PostScript errors may occur.
+The only way to fix this is to regenerate the PostScript without
+special page ordering.
+<p>By default, Windows 95 creates PostScript files which use special
+page ordering. To disable this, open the printer properties then
+select the PostScript tab, then select PostScript Output Format =
+<b>PostScript (optimize for portability - ADSC)</b>.
+<p><b>Problem:</b> PostScript files produced by MS-Windows start with a Control-D.
+<p>For Windows 3.1:
+<p>Since this occurs even when the PostScript printer
+<b>Conform to Document Structuring Convention</b>
+checkbox is checked, this must be considered a
+bug in the MS-Windows PostScript printer driver.
+The bug fix is documented in the MS-Windows PRINTERS.WRI file.
+Edit the win.ini file and search for the PostScript printer section.
+There may be more than one. In each of these sections add
+<b>CTRLD=0</b> as shown below.
+<p><pre>
+ [Apple LaserWriter II NT,FILE]
+ CTRLD=0
+</pre>
+<p>For Windows 95:
+<p>The PostScript printer driver setup has an option
+(Properties, PostScript, Advanced) for suppressing
+a ^D at the start of a document.
+Fortunately the default is do not send ^D before job.
+<p><b>Problem:</b> PostScript files produced by Word for Windows 6.0
+cause a "Missing %%Pages comment" message box.
+<p>Congratulations. You have just found a mistake in the DSC comments
+when Word included an EPS file. Word should have surrounded the
+included EPS file with the lines
+<pre>
+ %%BeginDocument: filename.eps
+ %%EndDocument
+</pre>
+<p>Because Word didn't do this, GSview can't tell how many pages
+are in the document and where they are located.
+<p>Please complain to Microsoft. There is a problem in the EPSIMP.FLT
+filter version 2.01 which Microsoft needs to fix.
+<p>In the interim, you have two solutions:
+<p>1. Select <a href="#Options">Options</a> | <a href="#Ignore_DSC">Ignore DSC</a>
+<p>2. Edit the PostScript file to correct the DSC comments.
+Search the PostScript file for all lines containing
+<pre>
+ %MSEPS Preamble
+</pre>
+<p>From each of these lines, search forward for the start of the
+included EPS file which should start with a line like
+<pre>
+ %!PS-Adobe-3.0 EPSF-3.0
+</pre>
+<p>Above these lines add the line
+<pre>
+ %%BeginDocument: AddedByHand
+</pre>
+<p>Then search for all lines containing
+<pre>
+ %MSEPS Trailer
+</pre>
+<p>Above these lines add the line
+<pre>
+ %%EndDocument
+</pre>
+<p>GSview should then be able to display the file correctly.
+<p><b>Problem:</b> GSview doesn't recognise the DSC comments in files
+produced using the Adobe PostScript driver 4.10 for Windows 32-bit.
+<p>Do n