<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><title>How to install Ghostscript</title><!-- $Id: Install.htm,v 1.56 2005/10/20 19:46:23 ray Exp $ --><!-- Originally: install.txt --><link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style"></head> <body><!-- [1.0 begin visible header] ============================================ --> <!-- [1.1 begin headline] ================================================== --> <h1>How to install Ghostscript</h1> <!-- [1.1 end headline] ==================================================== --> <!-- [1.2 begin table of contents] ========================================= --> <h2>Table of contents</h2> <blockquote><ul><li><a href="#Overview">Overview of how to install Ghostscript</a><li><a href="#Install_Unix">Installing Ghostscript on Unix</a><ul><li><a href="#Shared_object">Ghostscript as a shared object</a><li><a href="#Install_Linux">Additional notes on Linux</a></ul><li><a href="#Install_Windows">Installing Ghostscript on MS Windows</a><li><a href="#Install_VMS">Installing Ghostscript on OpenVMS</a><li><a href="#Install_DOS">Installing Ghostscript on DOS</a><li><a href="#Install_OS2">Installing Ghostscript on OS/2 2.x</a></ul></blockquote> <!-- [1.2 end table of contents] =========================================== --> <!-- [1.3 begin hint] ====================================================== --> <p>For other information, see the <a href="Readme.htm">Ghostscriptoverview</a> and "<a href="Make.htm">How to build Ghostscript from sourcecode</a>". <!-- [1.3 end hint] ======================================================== --> <hr> <!-- [1.0 end visible header] ============================================== --> <!-- [2.0 begin contents] ================================================== --> <h2><a name="Overview"></a>Overview of how to install Ghostscript</h2> <p>You must have three things to run Ghostscript:<ol><li>The Ghostscript executable file; on some operatingsystems, more than one file is required.  These are entirelyplatform-specific.  See below for details. <li>Initialization files that Ghostscript reads in when itstarts up; these are the same on all platforms.<ul><li><b><tt>gs_</tt></b>*<b><tt>.ps</tt></b> unless Ghostscript was compiledusing the "compiled initialization files" option.  See the documentation of<a href="Psfiles.htm">PostScript files distributed with Ghostscript</a>. <li><b><tt>pdf_</tt></b>*<b><tt>.ps</tt></b> if Ghostscript was compiledwith the ability to interpret Adobe Portable Document Format (PDF) files,that is, <b><tt>pdf.dev</tt></b> was included in<b><tt>FEATURE_DEVS</tt></b> when Ghostscript was built. <li><b><tt>Fontmap</tt></b> and <b><tt>Fontmap.GS</tt></b> (or theappropriate <b><tt>Fontmap.</tt></b><em>xxx</em> for your platform), unlessyou plan always to invoke Ghostscript with the <ahref="Use.htm#FONTMAP_switch"><b><tt>-dNOFONTMAP</tt></b> switch</a>.</ul> <li>Fonts, for rendering text.  These are platform-independent,but if you already have fonts of the right kind on your platform,you may be able to use those.  See below for details.  Also see the<a href="Fonts.htm">documentation on fonts</a>.</ol> <p>The <a href="Use.htm">usage documentation</a> describes the searchalgorithms used to find initialization files and font files.  Theper-platform descriptions that follow tell you where to install thesefiles. <hr> <h2><a name="Install_Unix"></a>Installing Ghostscript on Unix</h2> <p>Ghostscript uses the common configure, build and install method common to many modern software packages. In general the following with sufficeto build ghostscript:<blockquote><tt><b>	./configure<br>	make</b></tt></blockquote>and then it may be installed in the default location with:<blockquote><b>	<tt>make install</tt></b></blockquote>	This last command may need to be performed with super user privileges. <p>You can set the installation directory by adding <tt>--prefix=<em>path</em></tt>to the configure invocation in the first step. The default prefix is <tt>/usr/local</tt>,which is to say the <tt>gs</tt> executable is installed as <tt>/usr/local/bin/gs</tt>. </p>A list of similar configuration options is available via <tt>./configure --help</tt> <p>For more detailed information on building Ghostscript see<a href="Make.htm#Unix_build">how to build Ghostscript on Unix</a> inthe documentation on building Ghostscript, especially regarding informationon using the older <a href="Make.htm#UNIX_makefile">hand edited makefile</a>approach. Whatever configuration method you use, execute "<b><tt>makeinstall</tt></b>" to install the executable and all the required andancillary files after the build is complete. <h3><a name="Use_Acrobat_fonts_Unix"></a>Fonts</h3> <p>The makefile installs all the files except fonts under the directorydefined in the makefile as <b><tt>prefix</tt></b>. Fonts need to beinstalled separately. The fonts should be installed in<tt><em>{prefix}</em>/share/ghostscript/fonts</tt>.(That is, <tt>/usr/local/share/ghostscript/fonts/</tt> if you used the defaultconfiguration above.) <p>If you have Adobe Acrobat installed, you can use the Acrobat fonts in place of the ones distributed with with Ghostscript by adding the Acrobat fonts directory to<b><tt>GS_FONTPATH</tt></b> and removing these fonts from<b><tt>Fontmap.GS</tt></b>: <blockquote>Courier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,Helvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,Times-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats</blockquote> <p>Similarly, you can have ghostscript use other fonts on your system by addingentries to the fontmap or adding the directories to the GS_FONTMAP environmentvariable. See the <a href="Use.htm#Font_lookup">usage documentation</a> for moreinformation. For example, many linux distributions place fonts under <tt>/usr/share/fonts</tt>. <h3><a name="Shared_object"></a>Ghostscript as a shared object</h3>If you've built Ghostscript as a shared object, instead of '<tt>make install</tt>', you must use '<tt>make soinstall</tt>'.  See <a href="Make.htm#Shared_object">how to build Ghostscriptas a shared object</a> for more details. <h3><a name="Install_Linux"></a>Additional notes on Linux</h3> <p>For Linux, you may be able to install or upgrade Ghostscript fromprecompiled <a href="http://www.rpm.org">RPM</a> files using: <blockquote><b><tt>rpm -U ghostscript-N.NN-1.i386.rpm<br>rpm -U ghostscript-fonts-N.NN-1.noarch.rpm</tt></b></blockquote> <p>However, please note that we do not create RPMs for Ghostscript, and we takeno responsibility for RPMs created by others. <hr> <h2><a name="Install_Windows"></a>Installing Ghostscript on MS Windows</h2> <p>We usually distribute Ghostscript releases for Windows as self-extractingarchive files, since this is the most convenient form for users.  Thesefiles can also be unpacked as if they were plain zip files. <p>The self-extracting archive is normally named<b><tt>gs###w32.exe</tt></b>,where ### is the release number (e.g., 650 for Ghostscript 6.50, 700 for Ghostscript 7.00). <h3><a name="Windows4"></a>Windows 95/98 and NT 4</h3> <p>To install a self-extracting Ghostscript archive on Windows 95/98 orWindows NT4/2000, you need just this self-extracting archive file.  Run this file to install Ghostscript. <p>Alternatively, if you have the zip file, unzip it to a temporarydirectory then run the included <b><tt>setupgs.exe</tt></b>.After the setup program has finished, remove the temporary files. <p>After installing Ghostscript, it is strongly recommended that you install the <b>GSview previewer</b>, which provides an easier to use graphical interface for Ghostscript.Information on GSview is available from: <blockquote><ahref="http://www.cs.wisc.edu/~ghost/gsview/" class="offsite">http://www.cs.wisc.edu/~ghost/gsview/</a></blockquote> <h3><a name="General_Windows"></a>General Windows configuration</h3> <p>The archive includes files in these subdirectories: <blockquote><b><tt>gs<em>#.##</em>\bin<br>gs<em>#.##</em>\lib<br>gs<em>#.##</em>\examples<br>gs<em>#.##</em>\doc<br>fonts</tt></b></blockquote> <p>The actual executable files, in the <b><tt>gs<em>#.##</em>\bin</tt></b>subdirectory, are: <blockquote><table cellpadding=0 cellspacing=0><tr valign=top>	<td><b><tt>GSWIN32.EXE</tt></b>	<td>&nbsp;	<td>32-bit Ghostscript using windows<tr valign=top>	<td><b><tt>GSWIN32C.EXE</tt></b>	<td>&nbsp;	<td>32-bit Ghostscript using only the command line<tr valign=top>	<td><b><tt>GSDLL32.DLL</tt></b>	<td>&nbsp;	<td>32-bit dynamic link library containing most of Ghostscript'sfunctionality</table></blockquote> <p>See "<a href="#Install_DOS">Installing Ghostscript on DOS</a>" below forinformation about using Adobe Type Manager, Adobe Type Basics, or AdobeAcrobat fonts.  If your system uses TrueType fonts, you can get themconverted to a Ghostscript-compatible format at the time you select your"printer" by doing the following: <blockquote><ol><li>Open control panel and double-click on the "Printers" icon.<li>Select your PostScript printer.<li>Choose Setup.<li>Choose Options.<li>Choose Advanced.<li>At the top of the dialog box you will see TrueType Fonts Send toPrinter As: Choose <em>(drop-down menu)</em> Adobe Type 1.<li>Uncheck Use Printer Fonts for All TrueType Fonts and UseSubstitutionTable.<li>OK.<li>OK etc.</ol></blockquote> <p>That's it!  Your TrueType fonts will automatically be downloaded in yourPostScript file for Ghostscript to use. <p>For printer devices, the default output is: <blockquote><table cellpadding=0 cellspacing=0><tr valign=top>	<td>The default printer	<td>&nbsp;&nbsp;&nbsp;	<td>Win95 or WinNT<tr valign=top>	<td>Prompt for a printer port	<td>&nbsp;	<td>Win32s (Windows 3.1)</table></blockquote> <p>This can be modified as follows. <blockquote><dl><dt><b><tt>-sOutputFile="LPT1:"</tt></b><dd>Output to the named port. <dt><b><tt>-sOutputFile="%printer%printer name"</tt></b> (Windows 95, 98,NT or 2000)<dd>Output to the named printer.  If your printer is named "HP DeskJet 500"then you would use <tt>-sOutputFile="%printer%HP DeskJet 500"</tt>. <dt><b><tt>-sOutputFile="\\spool\printer name"</tt></b> (Windows 3.1/Win32s)<dd>Output to the named printer.  Note that this is NOT a UNC name. </dl></blockquote> <p>If Ghostscript fails to find an environment variable, it looks for aregistry value of the same name under the key <blockquote><b><tt>HKEY_CURRENT_USER\Software\AFPL Ghostscript\#.##</tt></b></blockquote> <p>or if that fails, under the key <blockquote><b><tt>HKEY_LOCAL_MACHINE\SOFTWARE\AFPL Ghostscript\#.##</tt></b></blockquote> <p>where #.## is the Ghostscript version number.  This does not work underWin32s (that is, Windows 3.1, which doesn't support named registryvalues). <p>Ghostscript will attempt to load the Ghostscript dynamic link library <b><tt>GSDLL32.DLL</tt></b> in the following order:<ul><li> In the same directory as the Ghostscript executable.<li> If the environment variable <b><tt>GS_DLL</tt></b> is defined, Ghostscript tries to load the Ghostscript dynamic link library (DLL) with the name given.  <li> Using the standard Windows library search method: the directoryfrom which the application loaded, the current directory, the Windowssystem directory, the Windows directory and the directories listed inthe PATH environment variable.</ul> <p>The Ghostscript setup program will create registry valuesfor the environment variables <b><tt>GS_LIB</tt></b> and <b><tt>GS_DLL</tt></b>. <h3><a name="Uninstall_Windows"></a>Uninstalling Ghostscript on Windows</h3> <p>To uninstall Ghostscript, use the Control Panel, Add/Remove Programs andremove "Ghostscript #.##" and "Ghostscript Fonts".  (The entries may becalled "Aladdin Ghostscript" or "AFPL Ghostscript", rather than just"Ghostscript", depending on what version of Ghostscript was installed.) <hr> <h2><a name="Install_VMS"></a>Installing Ghostscript on OpenVMS</h2> <p>You need the file <b><tt>GS.EXE</tt></b> to run Ghostscript on OpenVMS, andinstalling Ghostscript on an OpenVMS system requires building it first:please read <a href="Make.htm#VMS_build">how to build Ghostscript on VMS</a>in the documentation on building Ghostscript. <p>The following installation steps assume that the Ghostscript directory is<b><tt>DISK1:[DIR.GHOSTSCRIPT]</tt></b>.  Yours will almost certainly be ina different location so adjust the following commands accordingly. <ul> <li>Download the fonts and unpack them into<b><tt>DISK1:[DIR.GHOSTSCRIPT.LIB]</tt></b>. <li>Enable access to the program and support files for all users with: <blockquote><pre>$ set file/prot=w:re DISK1:[DIR]GHOSTSCRIPT.dir$ set file/prot=w:re DISK1:[DIR.GHOSTSCRIPT...]*.*</pre></blockquote> <li>Optionally, add the Ghostscript help instructions to your system widehelp file: <blockquote><pre>$ lib/help sys$help:HELPLIB.HLB DISK1:[DIR.GHOSTSCRIPT.DOC]GS-VMS.HLP</pre></blockquote> <li>Lastly, add the following lines to the appropriate system wide or userspecific login script. <blockquote><pre>$ define gs_exe DISK1:[DIR.GHOSTSCRIPT.BIN]$ define gs_lib DISK1:[DIR.GHOSTSCRIPT.EXE]$ gs :== $gs_exe:gs.exe</pre></blockquote> </ul> <p>If you have DECWindows/Motif installed, you may wish to replace the<b><tt>FONTMAP.GS</tt></b> file with <b><tt>FONTMAP.VMS</tt></b>.  Read thecomment at the beginning of the latter file for more information. <hr> <h2><a name="Install_DOS"></a>Installing Ghostscript on DOS</h2> <p>You need the files <b><tt>GS386.EXE</tt></b> and <b><tt>DOS4GW.EXE</tt></b>to run Ghostscript.  You should install all the files except the fonts in<b><tt>C:\GS</tt></b>, and the fonts in <b><tt>C:\GS\FONTS</tt></b>. <p><a name="Use_platform_fonts_DOS"></a> If you have Adobe Type Manager(ATM) fonts installed on your system, and you wish to use them withGhostscript, you may wish to replace the <b><tt>FONTMAP</tt></b> file with<b><tt>FONTMAP.ATM</tt></b>, and to add to the environment variable<b><tt>GS_LIB</tt></b> the name of the directory where the fonts are located(see <a href="Use.htm#Finding_files">Use.htm</a> for more information about <b><tt>GS_LIB</tt></b>).  Before youdo this, please read carefully the license that accompanies the ATM fonts;we take no responsibility for any possible violations of such licenses.Similarly, if you have Adobe Type Basics, you may wish to replace<b><tt>FONTMAP</tt></b> with <b><tt>FONTMAP.ATB</tt></b>.  Finally, if youhave neither ATM nor ATB but you have Adobe Acrobat installed, you can usethe Acrobat fonts in place of the ones provided with Ghostscript by addingthe Acrobat fonts directory to <b><tt>GS_FONTPATH</tt></b> and removingthese fonts from <b><tt>FONTMAP</tt></b>: <blockquote>Courier, Courier-Bold, Courier-BoldOblique, Courier-Oblique, Helvetica,Helvetica-Bold, Helvetica-BoldOblique, Helvetica-Oblique, Symbol, Times-Bold,Times-BoldItalic, Times-Italic, Times-Roman, ZapfDingbats</blockquote> <hr> <h2><a name="Install_OS2"></a>Installing Ghostscript on OS/2 2.x</h2> <p>The Ghostscript OS/2 implementation is designed for OS/2 2.1 or later.  Afew people have used it successfully under OS/2 2.0, but it has had verylittle testing.  You need these files to run Ghostscript on OS/2: <blockquote><table cellpadding=0 cellspacing=0><tr valign=top>	<td><b><tt>GSOS2.EXE</tt></b>	<td>&nbsp;&nbsp;&nbsp;	<td>A text application that will run windowed or full screen<tr valign=top>	<td><b><tt>GSDLL2.DLL</tt></b>	<td>&nbsp;	<td>A dynamic link library that must be in the same directory as	    <b><tt>GSOS2.EXE</tt></b> or on the <b><tt>LIBPATH</tt></b>.<tr valign=top>	<td><b><tt>GSPMDRV.EXE</tt></b>	<td>&nbsp;	<td>An "external driver" used by the "<b><tt>os2pm</tt></b>"	    device, which is normally the default device and which displays	    output in a Presentation Manager window;	    <b><tt>GSPMDRV.EXE</tt></b> must be located in the same	    directory as <b><tt>GSOS2.EXE</tt></b> or on the	    <b><tt>PATH</tt></b></table></blockquote> <p><b><tt>GSOS2.EXE</tt></b>, <b><tt>GSDLL2.DLL</tt></b> and<b><tt>GSPMDRV.EXE</tt></b> are compiled using EMX/GCC 0.9d.  You must havethe EMX DLLs on your <b><tt>LIBPATH</tt></b>; they are available in apackage <b><tt>emxrt.zip</tt></b> from many places on the Internet, so youcan find the package by using a search engine or an ftp lookup service suchas the one at <blockquote><a href="http://ftpsearch.lycos.com/"class="offset">http://ftpsearch.lycos.com/</a></blockquote> <p>The system menu of the Ghostscript Image window includes a "Copy" commandto copy the currently displayed bitmap to the Clipboard. <p>OS/2 comes with some Adobe Type Manager fonts. If you wish to use these withGhostscript, you should replace the <b><tt>FONTMAP</tt></b> file with<b><tt>FONTMAP.OS2</tt></b>, and add to the environment variable<b><tt>GS_LIB</tt></b> (see <a href="Use.htm#Finding_files">Use.htm</a> for more information about<b><tt>GS_LIB</tt></b>) the name of the directory where the fonts arelocated, usually <b><tt>C:\PSFONTS</tt></b>.  Before you do this, pleaseread carefully the license that accompanies the ATM fonts; we take noresponsibility for any possible violations of such licenses. <p>Since <b><tt>GSOS2.EXE</tt></b> is not a PM application, it cannotdetermine the depth of the PM display.  You must provide this informationusing the <b><tt>-dBitsPerPixel</tt></b> option.  Valid values are 1, 4, 8(the default), and 24. <blockquote><table cellpadding=0 cellspacing=0><tr valign=bottom>	<th align=left>Use	<td>&nbsp;&nbsp;&nbsp;&nbsp;	<th align=left>For<tr>	<td colspan=3><hr><tr valign=top>	<td><b><tt>-dBitsPerPixel=1</tt></b>	<td>&nbsp;	<td>VGA monochrome<tr valign=top>	<td><b><tt>-dBitsPerPixel=4</tt></b>

Lines 1–500 of 573. Load more