<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>GSview Readme</title>
<link rel="stylesheet" type="text/css" href="gsview.css" title="GSview Style">
</head>
<body>
<h1>
GSview Readme
</h1>
<p>
GSview 4.8 PostScript previewer. Needs Ghostscript 7.04 or later.
<br>
Release date: 2006-02-25
</p>
<h2>
Table of contents
</h2>
<ul>
<li><a href="Overview">Overview</a>
<li><a href="Installation">Installation</a>
<li><a href="Compilation">Compilation</a>
<li><a href="X11">X11/Unix</a>
<li><a href="Bugs">Bugs</a>
<li><a href="Updates">Updates</a>
<li><a href="ObtainGS">Obtaining Ghostscript</a>
<li><a href="Copyright">Copyright, Licensing and Registration</a>
<li><a href="Other">Other Useful Programs</a>
<li><a href="Acknowledgements">Acknowledgements</a>
</ul>
<h2>
<a name="Overview"></a>
Overview
</h2>
<p>
GSview is a graphical interface for Ghostscript under MS-Windows,
OS/2 and Unix. 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="#ObtainGS">Ghostscript 7.04 - 9.99</a>.
</p>
<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 GNU/Linux executables. Older versions support Win16.
<li> Can be run directly off a CD-ROM.
<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.19 (GSview checks the
Ghostscript version number). Older version of GSview will
work with Ghostscript 4.03 - 6.99.
</ul>
<p>
Changes in version 4.8:
</p>
<ul>
<li> Minor bug fixes.
</ul>
<p>
GSview was written by Russell Lang at Ghostgum Software Pty Ltd.
</p>
<h2>
<a name="Installation"></a>
Installation
</h2>
<p>
First uninstall any previous versions of GSview.
</p>
<h3>
Win32
</h3>
<p>
Obtain GSview (gsv48w32.exe) from
</p>
<blockquote>
<a href="http://www.cs.wisc.edu/~ghost/gsview/get48.htm">
http://www.cs.wisc.edu/~ghost/gsview/get48.htm
</a>
</blockquote>
<p>
Obtain AFPL Ghostscript 8.53 (gs853w32.exe) from
</p>
<blockquote>
<a href="http://www.cs.wisc.edu/~ghost/doc/AFPL/get853.htm">
http://www.cs.wisc.edu/~ghost/doc/AFPL/get853.htm
</a>
</blockquote>
<p>
First install the AFPL Ghostscript self extracting archive
gs853w32.exe (or a later version if available)
Then install the GSview self extracting archive gsv48w32.exe.
Run GSview.
</p>
<h4>
Win32 location details
</h4>
<p>
By default, GSview is installed in the directory
<tt>c:\Program Files\Ghostgum</tt>, which creates the sub-directories
<tt>c:\Program Files\Ghostgum\gsview</tt> and
<tt>c:\Program Files\Ghostgum\pstotext</tt>.
The GSview executable is
<tt>c:\Program Files\Ghostgum\gsview\gsview32.exe</tt>.
</p>
<p>
By default, AFPL Ghostscript is installed in the directory
<tt>c:\gs</tt>, which creates the sub-directories
<tt>c:\gs\gsN.NN</tt> and <tt>c:\gs\fonts</tt>.
The AFPL Ghostscript executables are
<tt>c:\gs\gsN.NN\gswin32c.exe</tt> for console mode and
<tt>c:\gs\gsN.NN\gswin32.exe</tt> for windowing mode.
</p>
<p>
GSview normally locates AFPL Ghostscript using registry
entries created by the AFPL Ghostscript setup program.
If these do not exist, GSview will assume that Ghostscript
is in an adjacent directory to GSview, usually
<tt>c:\Program Files\Ghostgum\gsN.NN</tt>
and <tt>c:\Program Files\Ghostgum\fonts</tt>.
</p>
<h3>
Win64 (AMD64)
</h3>
<p>
Obtain GSview (gsv48w64.exe) from
</p>
<blockquote>
<a href="http://www.cs.wisc.edu/~ghost/gsview/get48.htm">
http://www.cs.wisc.edu/~ghost/gsview/get48.htm
</a>
</blockquote>
<p>
First install the AFPL Ghostscript self extracting archive
gs853w64.exe (or a later version if available)
Then install the GSview self extracting archive gsv48w64.exe.
Run GSview.
</p>
<p>
This version requires that you have a 64-bit x64 processor
(AMD64 or EM64T), and that you are also running a 64-bit
version of Windows such as Windows XP x64 Edition.
It will not run on the more common 32-bit Windows XP.
</p>
<h3>
OS/2
</h3>
<p>
Obtain GSview (gsv48os2.zip) from
</p>
<blockquote>
<a href="http://www.cs.wisc.edu/~ghost/gsview/get48.htm">
http://www.cs.wisc.edu/~ghost/gsview/get48.htm
</a>
</blockquote>
<p>
Obtain AFPL Ghostscript 8.53 (gs853os2.zip) from
</p>
<blockquote>
<a href="http://www.cs.wisc.edu/~ghost/doc/AFPL/get853.htm">
http://www.cs.wisc.edu/~ghost/doc/AFPL/get853.htm
</a>
</blockquote>
<p>
<a href="http://www.info-zip.org/pub/infozip/">Unzip</a>
GSview to a temporary directory, change to the gsview2 subdirectory,
place gs853os2.zip (or a later version) in the same directory,
and then run os2setup.exe.
</p>
<p>
If you do not already have EMX installed on your system, you will
also need to obtain the EMX Run Time library, emxrt.zip,
from one of
</p>
<blockquote>
<a href="ftp://ftp-os2.cdrom.com/pub/os2/emx09d/emxrt.zip">
ftp://ftp-os2.cdrom.com/pub/os2/emx09d/emxrt.zip
</a>
<br>
<a href="ftp://ftp-os2.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip">
ftp://ftp-os2.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip
</a>
</blockquote>
<p>
If GSview refuses to run at all, make sure you do not have
an old version of the emx DLL on your system.
</p>
<p>
GSview (gvpm.exe) will run under OS/2 2.1 and OS/2 Warp.
</p>
<h3>
Win16
</h3>
<p>
Use the older GSview 2.7 and Aladdin Ghostscript 4.03.
</p>
<h3>
Win32s
</h3>
<p>
This has not been tested by Ghostgum Software Pty Ltd.
First you will need to recompile GSview and Ghostscript
with Microsoft Visual C++ 5. Later versions will not
work with Win32s.
<p>
For MS-Windows 3.1, it is recommended that you use the
Win32 version. You must have Win32s installed before
installing GSview. See
<a href="http://www.microsoft.com/">
http://www.microsoft.com/</a>;
or
<a href="ftp://ftp.microsoft.com/softlib/mslfiles/PW1118.EXE">
ftp://ftp.microsoft.com/softlib/mslfiles/PW1118.EXE</a>.
GSview and Ghostscript will not work with some versions
of Win32s. If it doesn't work with your version, try
updating to a later version of Win32s. Some computers
will work with Win32s v1.15, others will not.
</p>
<p>
For Win32s, you will need to manually install both
GSview and AFPL Ghostscript. The included setup
programs will not run under Win32s. The self extracting
archives can be unpacked with Info-ZIP
<a href="http://www.info-zip.org/pub/infozip/">unzip</a>.
</p>
<h3>
X11/Unix
</h3>
<p>
Copy <tt>gsview</tt>, <tt>gsview-help</tt>, <tt>epstool</tt> and
<tt>pstotext</tt> to a directory on your search path.
Copy <tt>gvx*.htm</tt> to the directory <tt>/usr/share/doc/gsview-N.N</tt>.
Copy <tt>printer.ini</tt> to directory <tt>/etc/gsview</tt>.
GSview stores configuration information in <tt>$HOME/.gsview.ini</tt>.
</p>
<p>
You must have the <b>shared object</b> version of Ghostscript 7.04 - 9.19,
which should be included in recent GNU/Linux distributions.
If you don't have the ghostscript shared object,
you must first install Ghostscript, then the additional shared
object files. To build the ghostscript shared object files,
use '<tt>./configure ; make so</tt>'
</p>
<p>
A precompiled version is available for GNU/Linux.
GSview can also be compiled for SunOS and SGI IRIX.
</p>
<h3>General</h3>
<p>
Make sure that the zip/exe files are transferred in binary mode.
</p>
<p>
The Ghostscript fonts are used by Ghostscript alone. Your system
Fonts folder will not be modified.
</p>
<p>
If you don't like automatic installation programs, it is
possible to install GSview and Ghostscript manually.
For Ghostscript, read the file
<a href="http://www.cs.wisc.edu/~ghost/doc/cvs/Install.htm">
gsN.NN\doc\Install.htm.
</a>
For GSview, read the file
<a href="gsviewen.hlp">
gsviewen.hlp
</a>
</p>
<p>
If you wish to use install GSview without any prompts, give
a destination directory on the command line. For example:
</p>
<blockquote>
setup "c:\Program Files\ghostgum"
</blockquote>
<p>
This will not prompt for a destination directory and will
overwrite files without asking.
</p>
<p>
Configuration of GSview will occur the first time it is run.
</p>
<p>
See the
<a href="gsviewen.hlp">
on-line help
</a>
for more details.
The 'Common Problems' topic is worth reading if GSview doesn't work.
</p>
<h2>
<a name="Compilation"></a>
Compilation
</h2>
<p>
To compile GSview for Windows you need MS Visual C++ 5, 6, 7 or 7.1.
Copy srcwin/win.mak to Makefile, edit Makefile to set
<tt>VCVER</tt> and <tt>DEVBASE</tt> as required, then type '<tt>nmake</tt>'.
To build for Win64 use '<tt>nmake VCVER=71 WIN64=1</tt>'
</p>
<p>
To compile GSview for OS/2 you need IBM NMAKE.EXE and EMX/GCC 0.9d.
To create the GSview online help you need the IBM toolkit.
Copy srcos2/os2.mak to Makefile and edit COMPBASE and EMXPATH as required.
Type 'nmake'
</p>
<p>
To compile GSview for X11/Unix you need gcc and the GTK+ 1.2 toolkit.
Unzip the sources as follows to convert the line endings:
<pre>
unzip -aa gsv48src.zip
unzip -o gsv48src.zip "gsview-4.8/binary/*"
cd gsview-4.8
cp srcunx/unx.mak Makefile
make
</pre>
GSview may also be available in a tar.gz file which already has
Unix line endings.
To install, run <tt>make install</tt>
See the <a href="#X11">X11/Unix</a> topic for more notes
on X11 GSview.
For SunOS or SGI IRIX, uncomment the appropriate lines in the makefile.
You also be able to use
<pre>
rpmbuild -ta gsview-4.8.tar.gz
</pre>
</p>
<h2>
<a name="X11"></a>
X11/Unix
</h2>
<p>
X11 GSview is written by a novice at X Windows programming.
It might have serious problems.
The GTK+ toolkit is used for most of the graphical interface,
with a very small amount of Xlib.
</p>
<p>
GSview on Unix uses the Ghostscript shared object.
Drawing (especially over a network when using anti-aliased text)
should be faster.
</p>
<h3>
Unimplemented features
</h3>
<ul>
<li> Help uses HTML and netscape.
Gnome Help Browser is not used because it doesn't
support #topic on the command line. For example:
gnome-help-browser file:/path/gsview.htm#Page_Size
If you know of a way to tell the Gnome Help Browser to
jump to a particular topic, particularly without opening
another copy of the browser, please let me know.
<li> Keyboard movement between widgets
<li> Full screen not implemented
<li> Clipboard operations
<li> Sounds
</ul>
<p>
<h3>
Known problems
</h3>
<ul>
<li> Fit window doesn't get the correct dimension of the scrolled window
client area, so the resize is slightly wrong.
At the moment we use the size of the scroll window less the
two scroll bars.
<li> GSview still includes lots of debugging code.
</ul>
<h3>
Requests
</h3>
<p>
Suggestions from GTK+ programmers about how to improve GSview.
</p>
<p>
Bug reports. Use "gsview -d9" to get debugging messages on stdout.
</p>
<h2>
<a name="Bugs"></a>
Bugs
</h2>
<p>
Send bug reports to Russell Lang at Ghostgum Software Pty Ltd,
<tt>gsview</tt> <b>at</b> <tt>ghostgum.com.au</tt>.
When reporting bugs, please include the version number and date of
GSview (from the Help | About box), the version number of Ghostscript,
and the exact wording of any error messages.
The text in the "Ghostscript Messages" dialog can be copied
to the clipboard and pasted as text (not bitmap please!) into
an email message.
Do not send me large files (>100k bytes) unless requested.
If you get a SYS3175 or GPF, please send the address of the GPF - I can
use this to help locate the bug.
Please distinguish between bugs in GSview and bugs in Ghostscript,
by making sure that the problem only occurs when using GSview,
and not when using Ghostscript alone.
Don't expect a fast response - the work I'm paid to do has a higher
priority.
For a list of known bugs, see
<a href="http://www.cs.wisc.edu/~ghost/gsview/bugs.htm">
http://www.cs.wisc.edu/~ghost/gsview/bugs.htm
</a>
</p>
<h2>
<a name="Updates"></a>
Updates
</h2>
<p>
A World Wide Web home page for Ghostscript, Ghostview and GSview is at
<a href="http://www.cs.wisc.edu/~ghost/">
http://www.cs.wisc.edu/~ghost/
</a>
</p>
<p>
The latest version of GSview should be available from
<a href="ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/">
ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsview*.zip
</a>
or by mail (see next section) on a CD-ROM.
</p>
<h2>
<a name="ObtainGS"></a>
Obtaining Ghostscript
</h2>
<p>
Ghostscript can be downloaded from the Internet, or obtained on
<a href="cdorder.txt">CD-ROM</a>.
</p>
<p>
To download, go to the <a href="http://www.cs.wisc.edu/~ghost/">
Ghostscript home page</a>
then follow the link to <b>Obtaining AFPL Ghostscript</b>.
</p>
<p>
To obtain the latest version of GSview and AFPL Ghostscript
on CD-ROM, send the <a href="cdorder.txt">order form</a>
and payment to the address on the order form.
Payment may be credit card or cheque for USD$60 drawn on a
USA bank or equivalent drawn on your local bank.
For surface delivery within Australia, send a cheque for AUD$70
drawn on an Australian bank.
</p>
<p>
The CD-ROM (actually a CD-R) will contain ready to run
and ready to install copies of GSview and AFPL Ghostscript for
Windows and OS/2, plus a number of other PostScript utilities.
The CD-ROM will be dispatched by air-mail.
This offer is valid until 31 December 2006. If this date has
passed, send mail to
<tt>gsview</tt> <b>at</b> <tt>ghostgum.com.au</tt>.
to find out if the offer is still valid.
For more details see the page
<a href="http://www.ghostgum.com.au/cd.htm">
http://www.ghostgum.com.au/cd.htm
</a>
<h2>
<a name="Copyright"></a>
Copyright, Licensing and Registration
</h2>
<p>
GSview is copyright by Ghostgum Software Pty Ltd.
GSview is distributed with the Aladdin Free Public Licence.
This licence is contained in the file
<a href="LICENCE">
LICENCE
</a>.
</p>
<p>
These licences do not require any payment to the author;
however the author would welcome any registrations of GSview to cover
costs and time involved in developing and maintaining GSview.
The registration fee is currently AUD$40.
GSview can be <a href="http://www.ghostgum.com.au/">registered online</a>
at <a href="http://www.ghostgum.com.au/">http://www.ghostgum.com.au/</a>;
or by faxing or mailing the <a href="regorder.txt">registration form</a>.
Ghostgum Software prefers that you use the online registration.
On registration you will be sent a registration code to disable
the nag screen.
</p>
<p>
The postal address for Ghostgum Software is:
</p>
<blockquote>
Russell Lang
<br>
Ghostgum Software Pty Ltd
<br>
218 Gallaghers Rd
<br>
GLEN WAVERLEY VIC 3150
<br>
AUSTRALIA
</blockquote>
<p>
GSview uses Ghostscript to display the contents of the PostScript
files. Ghostscript is a separate program from GSview; it is
owned by artofcode LLC, not by Ghostgum Software Pty Ltd.
</p>
<p>
AFPL Ghostscript comes with a licence that is more restrictive
than the GNU Licence; in particular, it restricts the distribution of
AFPL Ghostscript in commercial contexts. Please see the file
PUBLIC that accompanies AFPL Ghostscript for more details.
</p>
<p>
GSview uses pstotext in an external DLL. pstotext was written by
Andrew Birrell and Paul McJones. It is
Copyright (C) 1995-1996, Digital Equipment Corporation.
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.
See
<a href="http://www.research.digital.com/SRC/virtualpaper/pstotext.html">
http://www.research.digital.com/SRC/virtualpaper/pstotext.html
</a>
</p>
<p>
GSview can convert PostScript or PDF file to an editable vector
using pstoedit in an external DLL.
pstoedit is Copyright by Wolfgang Glunz and is licensed with
the GNU Public Licence (GPL). pstoedit is <b>not</b> included
with GSview. You will need to obtain pstoedit separately from the
pstoedit homepage
<a href="http://www.pstoedit.net/pstoedit">
http://www.pstoedit.net/pstoedit
</a>
or from
<a href="http://www.cs.wisc.edu/~ghost/gsview/pstoedit.htm">
http://www.cs.wisc.edu/~ghost/gsview/pstoedit.htm
</a>.
Source code can be obtained from these sites.
</p>
<p>
GSview uses zlib 1.2.2 in an external DLL. zlib is
Copyright (C) 1995-2004 Jean-loup Gailly and Mark Adler.
See
<a href="http://www.zlib.net/">
http://www.zlib.net/
</a>
</p>
<p>
GSview uses bzip2 in an external DLL. bzip2 is
Copyright 1996-2000 by Julian Seward.
See
<a href="http://sources.redhat.com/bzip2/">
http://sources.redhat.com/bzip2/
</a>
</p>
<p>
The installation programs may use an
<a href="http://www.info-zip.org/pub/infozip/">unzip</a>
decompression library (DLL)
by the Info-ZIP group. The original sources are freely available
from
<a href="ftp://ftp.info-zip.org/pub/infozip/">
ftp://ftp.info-zip.org/pub/infozip/
</a>
</p>
<h2>
<a name="Other"></a>
Other Useful Programs
</h2>
<p>
<a href="gsprint.htm">GSPRINT</a> is a command line tool
for printing using Windows GDI printer drivers. This is
included with GSview.
</p>
<p>
<a href="epstool.htm">EPSTOOL</a> is a command line tool
for adding and removing previews from EPS files.
An older version is included with GSview.
</p>
<h2>
<a name="Acknowledgements"></a>
Acknowledgements
</h2>
<p>
L. Peter Deutsch, for writing Ghostscript and for making changes to
Ghostscript to support GSview.
</p>
<p>
Tim Theisen, who wrote Ghostview for X11 which provided the inspiration
for GSview.
</p>
<p>
Paul McJones and Andrew Birrell of DEC, for making pstotext available
and making changes to it for use with GSview.
</p>
<p>
Thomas Pfeiffer and Mrs. Stefanie Kolweyh for translating GSview into
German/Deutsch. Thomas Hoffmann for updates.
</p>
<p>
Cyrille Chevallet for translating GSview into French/Français.
</p>
<p>
Antonio Guadagnin for translating GSview into Italian/Italiano.
</p>
<p>
Pascual Lucas for translating GSview into Spanish/Español.
</p>
<p>
Stamos Mylonas for translating GSview into Greek/Ellenika.
</p>
<p>
Kris Steenhaut for translating GSview into Dutch/Nederlands.
</p>
<p>
Oleg Bondar for translating GSview into Russian.
</p>
<p>
Björn Söderström for translating GSview into Swedish/Svenska.
</p>
<p>
Juo Verut for translating GSview into Slovak.
</p>
<h2>
<a name="End of Readme"></a>
End of Readme
</h2>
</body>
</html>