Using the GNU Ghostscript distiller

In order for users to use the SaveAs method to save data as PDF with the distiller, they must first download and install GNU Ghostscript on their computers as described in the procedure that follows.

The use of GNU Ghostscript is subject to the terms and conditions of the GNU General Public License (GPL). Users should be asked to read the GPL before installing GNU Ghostscript on their computers. A copy of the GPL is available on the GNU Project Web server.

StepsTo install GNU Ghostscript:

  1. Into a temporary directory on your computer, download the self-extracting executable file for the version of GNU Ghostscript you want from one of the sites listed on the Ghostscript Web site.

  2. Run the executable file to install Ghostscript on your system.

    The default installation directory is C:\gs. You can select a different directory and/or choose to install shortcuts to the Ghostscript console and readme file.

After installing Ghostscript, you should read the readme.htm file in the doc subdirectory in the Ghostscript installation directory to find out more about using Ghostscript and distributing it with your application.

NoteSave Rows As fails To save as PDF in the DataWindow painter, select File>Save Rows As and select PDF as the Save As type. If you do not install GNU Ghostscript and use the default export properties, PowerBuilder displays a pop-up window notifying you that Save Rows As failed. If you install GNU Ghostscript and then change the name of the directory where GNU Ghostscript is installed, Save Rows As PDF fails silently.

Location of files

When you save a DataWindow object as PDF using the distill method, PowerBuilder searches in the following locations for an installation of GNU Ghostscript:

If GNU Ghostscript is installed using the Ghostscript executable file, the path is added to the Windows registry.

If the Ghostscript files are in the relative path of the pbdwe105.dll file, they must be installed in this directory structure:

dirname\pbdwe105.dll
dirname\gs\gsN.NN
dirname\gs\fonts

where dirname is the directory that contains the runtime DLLs and N.NN represents the release version number for Ghostscript.

You might not need to distribute all the fonts provided in the distribution. For information about fonts, see Fonts and font facilities supplied with Ghostscript.

You must also deploy the default PostScript printer driver and related files that are installed in Sybase\Shared\PowerBuilder\drivers. These files can be copied to or installed on users’ computers. They must be located in this directory structure:

dirname\pbdwe105.dll
dirname\drivers

PostScript printer profile

Each user’s computer must have a PostScript printer profile called Sybase DataWindow PS. This profile is added to your development computer automatically when you save a DataWindow’s rows to a PDF file in the DataWindow painter.

Users can add the profile manually using the Windows Add Printer wizard. In the wizard, click the Have Disk button and browse to the Adist5.inf file installed in the Shared\PowerBuilder\drivers directory, or to another PostScript driver file.