Adobe ® Acrobat ® Distiller

Online Guide

• New features • Commands • Using Acrobat Distiller • Creating PostScript files • Converting PostScript files to PDF • Choosing Distiller job options • Using Distiller on a network • Troubleshooting

New features
This section describes the new features available in Acrobat Distiller 3.0, which make it easier for you to create smaller, more efficient PDF documents.

Automatic orientation. •Most landscape pages are
oriented to a landscape position in Distiller for correct display in Acrobat Exchange or Reader.

Automating Document Info field entry.
Distiller 3.0 will automatically include certain Document Structuring Comments (DSC) information found in a PostScript file as Document Info field data. The DSC comments For, Title, and Creator are converted to Author, Title, and Creator Document Info fields, respectively.

Distiller Assistant. Distiller Assistant, the
utility that makes it easy to create a PDF file with Distiller in one step, is now available on the Macintosh.

Font subsetting. Distiller 3.0 allows you to set
the character threshold that determines when to subset a font to reduce file size.

Compressing fonts. Distiller uses the new compressed Type 1C font format to reduce file size when 3.0 compatibility is chosen. Type 1C fonts reduce file size by compressing the fonts. A font that is 30K can be compressed to as little as 7K with the new font format. Image Resampling. Distiller 3.0 offers two methods of resampling; downsampling and subsampling. Subsampling is faster than downsampling but may result in a color shift. See Using downsampling and subsampling to reduce file size for more information.

Advanced Options. Distiller 3.0 provides the
ability to control the printing-specific information maintained in a PDF file for use in outputting to high-end printing systems. See Choosing Advanced Options settings for information.

Commands
File Edit Undo Cut Copy Paste Clear

Using the Open command Open…
Quit

Distiller

Setting preferences Preferences... Job Options... Choosing Distiller job Choosing font locations, Font Locations... Distilling Folders... Watched with watched

Using Acrobat Distiller
Acrobat Distiller creates PDF documents from PostScript information. The PDF documents it creates can be viewed and printed by anyone with the Acrobat Exchange or Reader program. PDF documents created by Acrobat Distiller maintain all the formatting, graphics, and photographic images in the original documents. Creating a PDF file with Distiller is a two-step process that can be streamlined to one step if you have approximately 20MB of application RAM available above the amount of RAM needed to run the program used to create the document. The two-step process: 1 Create a PostScript file and save it to your hard drive or a watched folder. 2 Convert the PostScript file to PDF with Distiller.

The one step process: From the application in which you would otherwise create a PostScript file, send the PostScript information that describes the original document directly to Distiller and let Distiller convert it to PDF automatically. This automatic process is managed by Distiller Assistant, a utility installed with Distiller. See Using Distiller Assistant for more information. Distiller’s default compression and font settings will usually create an acceptably small and efficient PDF file. If you need more control over file size or image quality, you can easily change the default options. See Choosing Distiller job options for more information.

Creating PostScript files
A PostScript file contains a page description of the original electronic document that Distiller interprets to create a PDF document.

Creating PostScript files in Windows Creating PostScript on the Macintosh Creating PostScript files in UNIX Naming PostScript files Tips for creating PostScript files

Creating PostScript files in Windows
Use the Adobe PostScript Printer Driver to create PostScript files for distilling in Windows 3.1 and later and Windows 95. You can install this driver from the Adobe Acrobat 3.0 CD-ROM. See the Getting Started Guide for more information. Use the Microsoft printer driver to create PostScript files in Windows NT. After installing the driver and adding Acrobat Distiller to your list of installed printers, you can create PostScript files from most Windows applications. If you are using Acrobat Distiller on a network , save the PostScript file directly to a folder that is monitored by Acrobat Distiller.

Creating PostScript files in Windows 3.1 and later Creating PostScript files in Windows 95 Creating PostScript files in Windows NT

Creating PostScript files in Windows 3.1 and later
Use the Adobe PostScript Printer Driver to add the Acrobat Distiller PostScript Printer Description (PPD) file to your list of installed printers. Or if you are using the Microsoft driver, add the Acrobat Distiller Windows Printer Description (WPD) to your list of printers. Then create the PostScript file from your Windows application. PPDs and WPDs provide device-specific information to printer drivers to ensure the most efficient PostScript file output.

To add the Acrobat Distiller PPD with the Adobe driver (Windows 3.1 and later): To add the Acrobat Distiller WPD with the Microsoft driver (Windows 3.1 and later): To create a PostScript file (Windows 3.1 and later):

To add the Acrobat Distiller PPD with the Adobe driver (Windows 3.1 and later):
1 Open the Adobe PostScript Printers control panel. 2 Select Acrobat Distiller from the Printer Descriptions Available list, and click Install. 3 After receiving the message that the printer has been successfully installed, click OK and Close. Click OK in the dialog box instructing you to open the Printers Control Panel. 4 Open the Printers Control Panel. 5 Select Acrobat Distiller on LPT1:, and click Connect. (If Distiller appears on a port other than LPT1:, select it on that port.)

6 Select FILE: from the Ports list, and click OK. 7 Click Close to close the Printers dialog box. 8 Open a text editor. Locate and open your WIN.INI file in the Windows directory. 9 Add this line to the section that begins with the name of your printer driver (for example, [AdobePS] begins the section for the Adobe PostScript printer driver):

MinOutlinePPEM=1 Note: Entering this line in your WIN.INI file ensures that TrueType fonts will not be converted to Type 3 fonts in a PostScript file. Type 3 can be the cause of unnecessarily large, slow PDF files.
10 If ATM is installed, open the ATM control panel.

Note: You can install ATM 3.0.1 from the ATM301 folder on the Acrobat CD-ROM.

11 Select all the fonts in the Available fonts window, and click Remove. 12 Click Add. Adding the fonts again through ATM ensures that the Printer Port section of the WIN.INI file is correctly updated. If fonts do not appear in the add fonts window, navigate to the PSFONTS\PFM directory.

To add the Acrobat Distiller WPD with the Microsoft driver (Windows 3.1 and later):
1 Open the Printers control panel. 2 Click Add. 3 From the list of printers, select Unlisted or Updated Printer, and click Install. 4 Click Browse. Navigate to the Acrobat 3/Distillr/Xtras directory and click OK. 5 The path in the Install Driver dialog box should read /Acrobat3/Distillr/Xtras. Click OK. 6 Select Acrobat Distiller in the Add Unlisted or Updated Printer dialog box, and click OK. 7 If prompted, insert the correct Windows disk and follow the on-screen directions in the dialog boxes until you are returned to the Printers dialog box.

8 With the new Acrobat Distiller entry selected, click Connect. 9 Select FILE: from the Ports list, and click OK. 10 Click Close to close the Printers dialog box. 11 Open a text editor. Locate and open your WIN.INI file in the Windows directory. 12 Add this line to the section that begins with the name of your printer driver (for example, [AdobePS] begins the section for the Adobe PostScript printer driver):

MinOutlinePPEM=1 Note: Entering this line in your WIN.INI file ensures that TrueType fonts will not be converted to Type 3 fonts in a PostScript file. Type 3 can be the cause of unnecessarily large, slow PDF files.

13 If ATM is installed, open the ATM control panel. 14 Select all the fonts in the Available fonts window, and click Remove. 15 Click Add. Adding the fonts again through ATM ensures that the Printer Port section of the WIN.INI file is correctly updated. If fonts do not appear in the add fonts window, navigate to the PSFONTS\PFM directory. 16 Close the ATM control panel.

To create a PostScript file (Windows 3.1 and later):
1 Start your application, and open the document to be printed to a PostScript file. 2 Choose File > Print. 3 Click Printer. 4 From the list of Specific Printers, select Acrobat Distiller on FILE. Click Set as Default Printer, and click Close. 5 Click OK in the Print dialog box. 6 Enter a pathname and a filename for the PostScript file, using .ps as the file extension, and click OK. See Naming PostScript files for information.

Creating PostScript files in Windows 95
Add the Acrobat Distiller PostScript Printer Description (PPD) file to your list of printers and then create the PostScript file from your application. You need to install the PPD file only once. PPD files provide device-specific information to printer drivers to ensure the most efficient PostScript file output.

To add the Acrobat Distiller PPD with the Adobe driver (Windows 95): To create a PostScript file (Windows 95):

To add the Acrobat Distiller PPD with the Adobe driver (Windows 95):
1 Launch the setup utility for Adobe PostScript Printer Driver from the Drivers folder on the Acrobat 3.0 CD-ROM. 2 Follow the instructions on-screen to progress through the introduction, accept the license agreement, and copy the setup program to your local disk. 3 Choose Local Printer as your printer type, and click Next. 4 Locate the acrobat3/distillr/xtras folder, choose Acrobat Distiller from the list of available PPDs, and click Next. 5 Select FILE: from the list of available ports, and click Next. 6 Choose not install this printer as the default printer or print a test page, and click Next.

7 Click OK to accept the Acrobat Distiller PPD properties. 8 Click Exit to exit the setup utility. 9 Select Settings > Printers from the Start menu, rightclick the Acrobat Distiller printer, and select Properties. 10 Click the Fonts tab, then the Send Fonts As button. 11 Select Outlines from the Send TrueType Fonts As: menu. 12 Enter 1 in the Threshold to switch between downloading bitmap or outline fonts…box, and click OK.

Note: Entering this value ensures that TrueType fonts will not be converted to Type 3 fonts in a PostScript file. Type 3 fonts can be the cause of unnecessarily large, slow PDF files.
13 Click OK to close the Acrobat Distiller Properties dialog box.

To create a PostScript file (Windows 95):
1 Start your application, and open the document to be printed to a PostScript file. 2 Choose File > Print. 3 Select Acrobat Distiller from the printer list, and click OK. 4 Enter a pathname and filename for the PostScript file, using .ps as a file extension, select All Files (*.*) from the Save As Type menu, and click OK. See Naming PostScript files for information.

Note: Some applications insist on using a .prn extension instead of the .ps extension that you designate. If this happens, you should rename the file with a .ps extension to allow Distiller to recognize and process the file.

Creating PostScript files in Windows NT
You can use the Microsoft driver to create PostScript files in Windows NT 3.5.1 and 4.0. Contact your system administrator for assistance with setting up a PostScript printer driver to print to file. You should set up a PostScript printer with color capabilities such as an imagesetter. Once you have a PostScript printer driver set up to print to file, choose that printer driver from the standard Print command in any application to create a PostScript file.

Creating PostScript on the Macintosh
Use the Adobe PSPrinter 8.3.1 PostScript driver to create PostScript files for distilling. You can install this driver from the Adobe Acrobat 3.0 CD-ROM. See the Getting Started Guide for more information. After installing this driver and selecting the Acrobat Distiller PostScript Printer Description (PPD) file in the Chooser, you can create PostScript files from most Macintosh applications. PPD files provide device-specific information to printer drivers to ensure the most efficient PostScript file output.

To set up PSPrinter 8.3.1 with the Acrobat Distiller PPD (Macintosh): To create a PostScript file (Macintosh):

To set up PSPrinter 8.3.1 with the Acrobat Distiller PPD (Macintosh):
1 With PSPrinter 8.3.1 already installed, select the Chooser. 2 Click the PSPrinter icon. Select any printer. preferably a printer that you do not normally print to. 3 Click Setup. Navigate to System Folder: Extensions: Printer Descriptions, if you are not already there. Select Acrobat Distiller (PPD), and click Select. 4 Close the Chooser.

To create a PostScript file (Macintosh):
1 Start your application, and open the document to be printed to a PostScript file. 2 Select the Chooser. 3 Click the PSPrinter icon. Choose the printer you set up with the Acrobat Distiller PPD. Close the Chooser. 4 Return to your application. 5 Choose File > Print. 6 Select File as the destination if it is not already chosen. If the document is a color document or contains grayscale images, select the Color/Grayscale print option. (If you are using PSPrinter, click Options to set the Color/Grayscale Print option.) 7 Click OK; the Save As dialog box appears. 8 Select a destination, and enter a name for the PostScript file. See Naming PostScript files for information.

9 Select the Binary and Level 2 Only buttons. Selecting these buttons creates the smallest and most efficient PostScript file. 10 Select All But Standard 13 from the Font Inclusion menu. Any TrueType and PostScript fonts used in the original document are included in the file. 11 Click Save. The PostScript file is created, and you are returned to your application.

Creating PostScript files in UNIX
You must print your document to a PostScript file before converting it to PDF with Distiller. In UNIX, a PostScript file is produced by the application rather than by a printer driver. Use your application’s method for creating a PostScript file. That method should be documented in your application’s user guide.

Naming PostScript files
By convention, PostScript filenames end with the extension .ps. Following this naming convention makes it easier to keep track of the original, PostScript, and PDF versions of your documents. Acrobat Distiller uses the names of the PostScript files it processes to name the PDF files it creates. To name a PDF file, Acrobat Distiller drops the file extension and adds .pdf or .PDF, depending on the case of the original file extension, to the PostScript filename.

Tips for creating PostScript files
• Use the latest version of the PostScript printer driver. • To create a color PDF document, select a color printer.
If you use the Acrobat Distiller PPD, you will get a color PDF file.

• To create PDF documents with custom page sizes,
select a printer that supports custom page sizes. The Acrobat Distiller PPD supports custom page sizes.

• When using Fetch or FTP to transfer PostScript files between computers, send the files as 8-bit binary data to avoid conversion of line feeds to carriage returns or vice versa.

• On the Macintosh, do not select Substitute Fonts
or Smooth Graphics in the Page Setup dialog box. If chosen, the printer driver smooths graphics by adding many tiny images to the document. Also, selecting either of these options may result in a large PDF file, one that takes a long time to display and print.

• You can easily create PostScript files with
QuarkXPress, Adobe PageMaker, Adobe FrameMaker, and Corel Ventura. For details, see the notes contained in the Technote folder inside the Techinfo (Windows, UNIX) or the Adobe Technical Info (Macintosh) folder on the Acrobat CD-ROM.

Converting PostScript files to PDF
In most cases, Distiller’s default compression and font settings create an acceptably small and efficient PDF file. All you need to do is convert the PostScript file. For cases in which you need more control over file size or image quality, change the Distiller options.

Converting PostScript files Monitoring Distiller jobs Choosing Distiller job options

Converting PostScript files
As a general rule, you should have double the size of the PostScript file you wish to convert available in free hard disk space on the computer running Distiller.

Converting PostScript files (Windows and Macintosh) Converting PostScript files (UNIX) Combining PostScript files into one PDF file Interrupting distilling jobs

Converting PostScript files (Windows and Macintosh)
Using the Open command (Windows and Macintosh) Drag-and-drop distilling (Windows and Macintosh) Using the Run command (Windows) Using Distiller Assistant (Windows and Macintosh)

Using the Open command (Windows and Macintosh)
You can start Acrobat Distiller by double-clicking the Acrobat Distiller icon in the Program Manager, Windows Explorer, or Finder. You can then distill PostScript files by choosing File > Open and selecting the files to distill. To open a PostScript file: 1 Start Acrobat Distiller. 2 Choose File > Open. 3 Select the PostScript file you want to distill, and click OK (Windows) or Open (Macintosh). 4 Type a filename, and choose a location for the file. 5 Click OK (Windows) or Save (Macintosh).

To save the PDF file in the same folder as the source PostScript file with same name: Press the Shift key (Windows) or the Option key (Macintosh) as you click OK or Open in the Open dialog box. The PDF file is given the same name as the source PostScript file, and .pdf or .PDF is added to the end of the name.

Drag-and-drop distilling (Windows and Macintosh)
In Windows, and on the Macintosh, you can start Distiller and immediately begin processing files by dragging one or more PostScript files onto the Acrobat Distiller icon. By default, Distiller does not display the Save As dialog box when you use the drag-and-drop method. Instead, it places PDF files into the same folder as the source PostScript files and adds the extension .pdf or .PDF to the original filename. To display the Save As dialog box by using drag-and-drop distilling: Press the Control key (Windows) or the Option key (Macintosh) while dragging the PostScript files. The Save As dialog box appears, with the last folder used as the default folder.

Using the Run command (Windows)
In Windows, you can start Acrobat Distiller and convert a PostScript file by using the Run command from the Program or File Manager’s File menu (Windows 3.1 and later, and Windows NT) or from the Start menu (Windows 95). For example:

c:\acrobat3\distillr\acrodist.exe c:\q1\chart.ps,c:\q1\report.ps
In the example, the path to acrodist.exe uses the default Distiller drive and folder. If you change the installation default, use the drive and folder name you specify when installing Acrobat Distiller. If you specify more than one PostScript file, as in the example, the filenames must be separated by a comma without any spaces. In such cases, the files are processed in the order they are listed. Separate PDF files are created for each PostScript file listed in the command.

Using Distiller Assistant (Windows and Macintosh)
Distiller Assistant makes it possible to print directly to Acrobat Distiller so that you can create PDF files in one easy step. Setup of Distiller Assistant is not necessary on the Macintosh after installation. With Windows, setup of Distiller Assistant is not usually needed after installation, but if you need to set it up manually, see Setting up Distiller Assistant (Windows).

Choosing Distiller Assistant options Using Distiller Assistant to distill files (Windows) Using Distiller Assistant to distill files (Macintosh)

Setting up Distiller Assistant (Windows)
To use Distiller Assistant, you need approximately 20 MB of application RAM to run Distiller, Distiller Assistant, and Exchange or Reader, plus the amount of RAM needed to run the application in which the document was created.

To set up Distiller Assistant in Windows 3.1 and later: To set up Distiller Assistant in Windows 95: To set up Distiller Assistant in Windows NT 3.5.1: To set up Distiller Assistant in Windows NT 4.0:

To set up Distiller Assistant in Windows 3.1 and later:
1 Open the Adobe Acrobat program group. 2 Choose one of the following to set up the Distiller Assistant application (the application is launched minimized):

• Double-click the Distiller Assistant program icon. • Drag the Distiller Assistant program icon to the
Startup group, and restart Windows. Dragging Distiller Assistant to the Startup group ensures that Distiller Assistant is launched and active at every startup. 3 Distiller Assistant’s default options are usually acceptable. If you need to change the defaults, see Choosing Distiller Assistant options for details.

To set up Distiller Assistant in Windows 95:
1 Open the Acrobat3/Distillr folder. 2 Choose one of the following to launch the Distiller Assistant application:

• Double-click the Distiller Assistant program icon
named Distasst.exe or Distasst.

• Drag the Distiller Assistant program icon to the
Win95/Start Menu/Programs/StartUp folder, and restart Windows. Dragging Distiller Assistant to the StartUp folder ensures that Distiller Assistant is launched and active at every startup. 3 Distiller Assistant’s default options are usually acceptable. If you need to change the defaults, see Choosing Distiller Assistant options for details.

To set up Distiller Assistant in Windows NT 3.5.1:
1 Open the Adobe Acrobat program group. 2 Choose one of the following to launch the Distiller Assistant application (the application is launched minimized):

• Double-click the Distiller Assistant program icon. • Drag the Distiller Assistant program icon to the
Startup group, and restart Windows. Dragging Distiller Assistant to the Startup group ensures that Distiller Assistant is launched and active at every startup. 3 Distiller Assistant’s default options are usually acceptable. If you need to change the defaults, see Choosing Distiller Assistant options for details. 4 If Distiller Assistant does not appear as a printer, you must set it up manually. See the Readme for instructions.

To set up Distiller Assistant in Windows NT 4.0:
1 Open the Acrobat3/Distillr folder. 2 Choose one of the following to launch the Distiller Assistant application:

• Double-click the Distiller Assistant program icon
named Distasst.exe or Distasst.

• Drag the Distiller Assistant program icon to the
Win95/Start Menu/Programs/StartUp folder, and restart Windows. Dragging Distiller Assistant to the StartUp folder ensures that Distiller Assistant is launched and active at every startup. 3 Distiller Assistant’s default options are usually acceptable. If you need to change the defaults, see Choosing Distiller Assistant options for details. 4 If Distiller Assistant does not appear as a printer, you must set it up manually. See the Readme for instructions.

Choosing Distiller Assistant options
With Windows 3.1 and later or NT, Distiller Assistant appears as an icon near the bottom of the screen when running; click the icon once to choose the options. With Windows 95, right-click the Distiller Assistant entry in the taskbar. On the Macintosh the options are available from the Save As dialog box of the original application. The following options are available:

• View PDF File specifies displaying the PDf file in an
Acrobat viewer after Distiller converts that file to PDF.

• Save PostScript file (Macintosh) specifies saving
the PostScript file on the hard disk.

• Exit Distiller When Idle (Windows) specifies exiting
Distiller after all queued files have been distilled and all watched folders are empty. If Acrobat Distiller is already running when Distiller Assistant tries to launch it, it continues to run.

• Ask for PDF File Destination (Windows) specifies
displaying a Save As dialog box when Acrobat Distiller is activated. If this option is not selected, the PDF file is saved to the root directory on the local hard drive.

Using Distiller Assistant to distill files (Windows)
With Windows, besides printing directly to Distiller from an application, you can use Distiller Assistant to do the following things:

• Monitor Acrobat Distiller’s watched folders, and
launch Acrobat Distiller if a PostScript file appears in any watched folder. See Using Distiller on a network for information about watched folders.

• Drag-and-drop a PostScript file onto its program icon
to launch Distiller. Distiller then converts the file to a PDF file and displays the PDF file in an Acrobat viewer.

Using Distiller Assistant in Windows 3.1 and later Using Distiller Assistant in Windows 95 Using Distiller Assistant in Windows NT

Using Distiller Assistant in Windows 3.1 and later
The Acrobat installer adds a DistAsst.ps item to your list of installed printers in the Print Setup dialog box. After following the instructions to set up Distiller Assistant in Windows 3.1 and later, you will select the DistAsst.ps item to use Distiller Assistant to create PDF files. To create a PDF file with Distiller Assistant: 1 Start your application, and open the document to be converted to PDF. 2 Choose File > Print. 3 Select Acrobat Distiller on /DistAsst.ps from the Specific printer menu. Click Use as Default printer. 4 Click Print.

Using Distiller Assistant in Windows 95
The Acrobat installer adds Distiller Assistant to your list of installed printers in the Print Setup dialog box. After following the instructions to set up Distiller Assistant in Windows 95, you can use Distiller Assistant to create PDF files in one step. To create a PDF file with Distiller Assistant: 1 Start your application, and open the document to be converted to PDF. 2 Choose File > Print. 3 Select Distiller Assistant from the Specific printer menu. Click Use as Default printer. 4 Click Print.

Using Distiller Assistant in Windows NT
Follow the instructions to set up Distiller Assistant in Windows NT; then see the Readme file for information about adding Distiller Assistant as a printer. After setting up Distiller Assistant and adding it as a printer, follow the instructions below. To create a PDF file with Distiller Assistant: 1 Start your application, and open the document to be converted to PDF. 2 Choose File > Print. 3 Select Distiller Assistant from the Specific printer menu. Click Use as Default printer. 4 Click Print.

Using Distiller Assistant to distill files (Macintosh)
Distiller Assistant is installed in the Extensions folder within the System Folder on the Macintosh. Distiller Assistant works in conjunction with Adobe PSPrinter 8.3 or later to add a PDF option in the Print command dialog box of the original application. See the Getting Started Guide for Adobe PSPrinter install instructions.

Note: Distiller Assistant is not supported on the QuickDraw GX system.
To create a PDF file with Distiller Assistant: 1 Start your application, and open the document to be converted to PDF. 2 Choose File > Print.

3 Select PDF in the Destination box, and click Distill. 4 In the Save As dialog box, select a folder and enter a filename for the PDF file. Saving the PostScript file and viewing the PDF file immediately after creation are available options. 5 Click Save.

Note: LaserWriter 8.4 does not support Acrobat Distiller Assistant. You must use Adobe PSPrinter to have the PDF option available when printing.

Converting PostScript files (UNIX)
To create a PDF file by using the Distill command: Piping files through Distiller Distiller command syntax Distilling options

To create a PDF file by using the Distill command:
Start the Distiller program, and enter the name of one or more files to distill:

% distill PostScript_file1 PostScript_file2 PDF_folder
Acrobat Distiller distills the PostScript file, replacing the .ps or .eps extension with .pdf or .PDF, and puts the PDF file into the specified directory. If you don’t specify a directory, the PDF files are placed into the same directory as the PostScript files.

Note: If you did not create symbolic links to the launch scripts, type the following: %<installdir>/AcroDist/bin/distill [arguments] where <installdir> is the root directory where your Adobe applications are installed.

Piping files through Distiller
You can use the Distill command as a filter to distill standard input to standard output, placing any PostScript log messages on standard error. This example uses ptroff to produce a PostScript file from troff and pipes the file through the distill command to produce a PDF file:

% ptroff -t Example.trf | distill > Example.pdf
If you do not specify any files, Distiller displays the message “ Distilling stdin to stdout,” and waits indefinitely for PostScript from standard input. Press Control+D to return to the shell prompt.

Distiller command syntax
The distill command syntax includes the Distiller options and parameters:

% distill [options] [parameters]
When you specify files to be distilled, use one of these two formats:

% distill [options] [params] [-files] PS_file... [PDF_dir]
where -files is needed when the first filename begins with a hyphen (and would otherwise be interpreted as an option) or is needed to separate the file list from a font list, given with the -embed, alwaysembed, or -neverembed parameter.

% distill [options] [params] -pairs [-files] PS_file_1 PDF_file_1...

where -pairs indicates that a list of corresponding PostScript and PDF files follows. For example, the ellipses (...) could be replaced with PS_file_2, PDF_file_2, PS_file_3, PDF_file3, etc. For a complete list of Distiller options and parameters, type the following:

% distill -help all
See Distilling options for details.

Distilling options
-v: Distill verbosely. Distilling messages appear on-screen during processing. -stats: Shows processing time and file size information. -quiet: Distilling occurs in the background, without any messages sent to the screen. -params: Shows the compression, downsampling, and command line specifications. -saveprefs: Saves the preferences set in startup files, existing user preferences (unless -noprefs), and command line specifications as the user preferences. -noprefs: Suppresses application of the user preferences in the distilling process.

Combining PostScript files into one PDF file
The RunFile procedure facilitates processing one file through Distiller to combine two or more PostScript files into one PDF file. When you use the RunFile procedure to combine multiple PostScript files into a single PDF file, only one font subset is used for each font. This decreases the combined file size. There are additional uses of the RunFile procedure:

• To distill PostScript files located in folders other than
those that Acrobat Distiller monitors.

• To distill an entire folder of PostScript files. The Xtras
folder contains the RunDirEx.txt file, which you can use to distill an entire folder of PostScript files.

To create a RunFile script to combine documents: 1 Start a text editor or a word processor, and choose File > Open. 2 Locate and open the text file called runfilex.ps in the Adobe Acrobat Xtras folder or directory. Open the file as a text file with carriage returns. 3 Follow the instructions in the Runfilex.ps file. 4 Choose File > Save As, and save and name the modified RunFile.ps. Use the name you want Acrobat Distiller to give the PDF file. For example, if you name the file HANDBOOK.PS, Acrobat Distiller creates a PDF file called HANDBOOK.PDF. If you are using a word processor, make sure to save the file as a text file.

5 Quit the text editor or word processor. 6 Place your file into Acrobat Distiller’s In folder, or start Acrobat Distiller and distill the file. 7 After Acrobat Distiller finishes processing the file, open the PDF file with Acrobat Exchange and make sure that all of the document parts are present and in the correct order.

Interrupting distilling jobs
If you want to change Acrobat Distiller’s setup before it begins processing PostScript files, pause the process immediately after starting the program. If you try to pause Distiller while it is processing a PostScript file, Distiller finishes processing the file first. If you want Distiller to stop processing the current PostScript file immediately, cancel the job. Distiller stops processing the current file and begins processing the next available PostScript file. A PDF file that is partially processed is deleted, and a log file is created (named filename.log), indicating that the job was terminated at the user’s request.

To interrupt Distiller (Windows and Macintosh): Choose one of the following:

• Click Pause to have Distiller stop distilling after it
finishes the current job. Distiller pauses until you click the Resume button. When you click Resume, Distiller begins processing the next available PostScript file.

• Click Cancel to keep the current job from completing,
and start on the next file. To interrupt Acrobat Distiller running as a foreground task (UNIX): Press Control+Z to pause Distiller. After pausing Distiller, type the following (in the same UNIX window you used to pause the Distiller) to resume its operation:

% fg

To interrupt Acrobat Distiller running as a background task (UNIX): Find Distiller’s process identification number, and type the following to stop Distiller:

% kill <distiller ID>
To pause Distiller, type the following:

% kill -STOP <distiller ID>
After pausing Distiller, type the following to resume its operation:

% kill -CONT <distiller ID>

Monitoring Distiller jobs
Use the Messages window to read the information that Distiller provides during distillation. The window shows source and destination path information, start and stop times, and any error messages for the last processed file. In Windows, you can resize the Distiller window to enlarge the Messages window. All messages displayed are written to the MESSAGES.LOG file in the Distiller application folder.

Choosing Distiller job options
Distiller’s default settings and options work well in most cases, but consider changing them if you receive unsatisfactory results from Distiller.

Choosing an Acrobat compatibility setting Adding thumbnails to PDF files Choosing a page size Choosing a resolution setting Setting preferences Choosing font locations, embedding, and subsetting Compressing data in PDF files Choosing Advanced Options settings

Choosing an Acrobat compatibility setting
Acrobat Distiller 3.0 offers you two choices for compatibility, Acrobat 2.1 and Acrobat 3.0. PDF files cannot be opened in Acrobat 2.1 or earlier viewers if those files were created with Acrobat 3.0 compatibility and either of the following compressed text and line art or embedded Type 1 fonts. Choosing 3.0 compatibility takes advantage of a number of 3.0 improvements. However, unless you know that all the recipients of your PDF documents have 3.0 viewers, you should use Acrobat 2.1 compatibility during the upgrade period to ensure file access.

Compatibility Comparison Chart Changing compatibility settings

Compatibility Comparison Chart
Acrobat 2.1
PDF files opened by Acrobat viewers 3.0 and earlier Uses LZW compression Patterns display as 50% gray

Acrobat 3.0
PDF files opened by Acrobat viewers 3.0 and later Uses ZIP compression Patterns display as 50% gray, but print correctly Places halftone information in file User decides to preserve, remove, or apply Transfer functions Embeds compressed Type 1 fonts Recognizes TrueType fonts in PostScript file Option to include OPI comments in the user interface

Removes halftone information Applies Transfer functions

Embeds complete Type 1 font information Does not recognize TrueType fonts Could only include OPI comments using pdfmark

Changing compatibility settings
You are asked to choose a compatibility setting the first time you launch Distiller. On the Macintosh, if the Distiller preferences file is moved or thrown away, you will be prompted to choose a setting again. To change compatibility settings (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the General tab. 2 Select a compatibility setting. 3 Click OK. To change compatibility settings (UNIX): Specify the compatibility options on the command line when starting Acrobat Distiller:

-compatlevel value
where value can be 2.1 or 3.0.

Adding thumbnails to PDF files
Earlier versions of Acrobat Distiller provided the option to create thumbnails. Beginning with this release, only Acrobat Exchange can generate thumbnails. See the Exchange online guide for more information.

Choosing a page size
The default page size is 612-by-792 points (8 1/2by-11 inches). If the PostScript file contains a different page size, Distiller uses the page size in the file. In most cases, you need to choose a page size only if you are processing Encapsulated PostScript (EPS) files, which do not contain page dimension information. The minimum page size is 1-by-1 inch. The maximum is 45-by-45 inches. To choose a page size (Windows and Macintosh): Choose Distiller > Job Options, and click the General tab. Enter a page size.

To choose a page size (UNIX): Specify the page size on the command line when starting Acrobat Distiller with the -pagesize parameter:

-pagesize <width> <height> <page units>
Page units can be picas, cm, in, or pts. Pts (points) is the default. Specify the width and height in the specified page units.

Choosing a resolution setting
The default resolution for device-dependent objects is 600 dpi. Device-dependent objects take on the resolution of the display device. Low resolution settings can result in disappearing lines or objects. You can choose a setting in the 72-to-2400-dpi range.

Note: Increasing the resolution setting will increase the time required to process files.
To choose a resolution setting (Windows and Macintosh): Choose Distiller > Job Options, and click the General tab. Enter a resolution value.

To choose a resolution setting (UNIX): Specify the resolution setting on the command line when starting Acrobat Distiller with the -resolution parameter:

-resolution <dpi>
where dpi ranges from 72 to 2400 dpi.

Setting preferences
In Windows and on the Macintosh, Distiller preferences control the behavior of Distiller when it encounters a fatal error and other trouble. In UNIX, Distiller preferences enable individual users to save job option parameter values to be used the next time they run Distiller. To set preferences (Windows and Macintosh): Choose File > Preferences, and then choose the preferences you want to change:

• Restart Windows/Distiller after PostScript
fatal error

• Notify if cannot connect to a Watched Folder

• Display warning if startup volume is nearly full
The Display warning option instructs Distiller to notify you if less than 1 megabyte of space is available on the hard disk where Distiller is installed. The hard disk space needed temporarily to convert the file to PDF successfully is approximately double the size of the PostScript language file being processed. To save preferences (UNIX): Use the -saveprefs parameter to set individual user preferences:

% distill -saveprefs <list of preferences> % distilld -saveparamprefs -savedirprefs <list of preferences>

This option saves the distillation parameters resulting from the startup files, existing user preferences, and command-line parameters. In the following example, LZW text and graphic compression will be used (by default) the next time you start the Distiller.

% distill -saveprefs -lzwtext -on MyFile.ps
For more information about user preferences and other ways to customize the Distiller, see <installdir>/Distillr/Xtras/README.

Choosing font locations, embedding, and subsetting
Locating and using fonts Adding monitored font locations Embedding fonts Subsetting fonts Finding a PostScript font name (Windows and Macintosh)

Locating and using fonts
Distiller gains access to font information in three ways.

• The font is included in the PostScript file that Distiller
is converting.

• The font is available in a monitored font location. • The font is described in the ATM Font Database. The
ATM Font Database makes it possible for Distiller to include Adobe font information in a PDF file, even if the actual font is not installed in one of Distiller’s monitored font locations or included in the PostScript file. If the font is accessible in none of these ways, Distiller uses Courier. Acrobat Distiller must have access to any font used in a document so that it can do one of the following:

• Embed the actual font in the PDF file.

• Include minimal font information in the PDF file for
the actual font to be used if the font is available on the system viewing the PDF file—or for the Acrobat substitution fonts to mimic the font spacing if the font is not available. Embedding fonts ensures that the document maintains its original look, but it increases file size considerably with a 2.1 compatibility setting. With a 3.0 compatibility setting, Distiller can compress Type 1 fonts and subset all fonts, so embedding has little impact on the file size. See Choosing an Acrobat compatibility setting for details. Distiller must also have access to the Base 13 fonts. In UNIX, you can give Distiller access to your installed Type 1 fonts by setting the PSRESOURCEPATH variable. See Giving Distiller access to fonts (UNIX) for information.

Base 13 fonts
A find font error will result if Distiller does not have access to the Base 13 fonts. The fonts are Courier, Courier Bold, Courier Italic, Courier Bold Italic, Helvetica, Helvetica Bold, Helvetica Oblique, Helvetica Bold Oblique, Times, Times Bold, Times Italic, Times Bold Italic, and Symbol. The Base 13, plus Zapf Dingbats, are installed in the fonts folder within the Acrobat Exchange folder if they are not already available via the operating system software.

Giving Distiller access to fonts (UNIX)
Distiller must have access to font referenced in PostScript files to insert the appropriate information into the PDF file. You can give Distiller access to your installed Type 1 fonts by setting the PSRESOURCEPATH variable in the Distiller launch script or in your user configuration file. Editing the launch script, usually done by a system administrator, gives all users who access that copy of Distiller access to the fonts. Editing a user configuration file gives an individual access to the fonts. The PSRESOURCEPATH variable looks for UNIX PostScript Resource (.upr) files in the location at which you point it. The .upr files are created when Type1 fonts are installed. If you have installed Adobe Illustrator or Adobe Photoshop, the PSRESOURCEPATH is already set for the individual, and Distiller will find it.

To give access to fonts systemwide: 1 Open

Acrobat3/Distillr/Xtras/ACRO_RES_DIR in a
text editor. 2 Enter the following command:

# PSRESOURCEPATH=<font_location>::
3 Restart Distiller. To give an individual access to fonts: 1 Open your user configuration file in a text editor. 2 Set the PSRESOURCEPATH environment variable:

# PSRESOURCEPATH=<font_location>::
3 Restart Distiller.

Adding monitored font locations
By default, Distiller monitors certain folders containing fonts it can use to convert PostScript files that refer to fonts but that don’t include them. (The default depends on the operating system.) If you need Distiller to monitor font folders other than the default folders, you can add those font locations in Distiller.

To add a font location (Windows and Macintosh): To remove a font location (Windows and Macintosh): Adding font locations (UNIX)

To add a font location (Windows and Macintosh): 1 Choose Distiller > Font Locations. The Font Locations dialog box displays a list of the folders Acrobat Distiller looks in for fonts. These folders can be on your hard drive or on the network.

Note: Acrobat Distiller indicates that a font folder is available by displaying the eyes icon to the left of the folder name. If no symbol appears to the left of the folder name, the network connection to the folder has probably been lost. Reestablish the connection.
2 Click Folder (Windows) or Add Folder (Macintosh). 3 Select the folder you want to add. 4 Use steps 1-3 to add other font locations, and click OK (Windows) or Save (Macintosh).

To remove a font location (Windows and Macintosh): 1 Choose Distiller > Font Locations. 2 Select the font folder you want to remove, and click Remove.

Note: On the Macintosh, you cannot remove the System Folder or the Fonts or Extensions folder within the System Folder from the list of font locations.
3 Click OK.

Adding font locations (UNIX)
Distiller looks for fonts and other PostScript resources in the path set by your PSRESOURCEPATH environment variable. If PSRESOURCEPATH has not been set, or if its value includes a double colon (::), then the path specified in the file < installdir>/ Distillr/Xtras/ACRO_RES_DIR is also searched. These paths are searched for files that end with a .upr (UNIX PostScript Resource) extension. UPR files list the names, categories, and files of available PostScript resources.

To add font locations: Modify the PSRESOURCEPATH environment variable to include the folders where your PostScript resources and fonts are located. For example, if PSRESOURCEPATH is set to

/proj/excalibur/psres: /user/dave/xyz/psres::
then applications and servers will search /proj/excalibur/psres, followed by /user/dave/xyz/psres, followed by their default locations.

Important: Including the double colon in the PSRESOURCEPATH enables an application to find its own application-specific PostScript resources.
The default locations for Distiller are indicated in the ACRO_RES_DIR file. See the <installdir>/Distillr/Xtras/ACRO_RES_DIR file for more information.

Embedding fonts
When you embed Type 1 and TrueType fonts in PDF files, Acrobat viewers can display and print the fonts on computers that do not have them installed. You can embed a PostScript Type 1 font in a PDF file only if it is included in the PostScript file or is available in one of the font locations monitored by Acrobat Distiller. TrueType fonts can be embedded only if they are included in the PostScript file. If you use the Acrobat 3.0 compatibility setting, font embedding should have little impact on the size of PDF files because of compressed Type 1 fonts and subsetting.

To embed fonts (Windows and Macintosh): Embedding fonts (UNIX) Creating a user font list

To embed fonts (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Font Embedding tab. 2 Choose one of the following:

• To embed all fonts, click Embed All Fonts and
click OK.

• To embed specific fonts, select the location of the
fonts from the Font Names menu, select the fonts that you want to embed, either drag them to the Always Embed list or click Add, and click OK.

• In order to never embed certain fonts, select the locations of the fonts from the Font Names menu, select the fonts that you do not want to embed, either drag them to the Never Embed list or click Add, and click OK.

Note: You may need permission from the font suppliers to distribute PDF files containing embedded fonts other than the following: Adobe Originals and fonts that are owned by Linotype-Hell AG, International Typeface Corporation, Agfa-Gevaert, AlphaOmega, Bigelow & Holmes, Fundicion Tipografica Neufville, and Monotype Typography, Ltd. that are available from the Adobe Type Library.

Embedding fonts (UNIX)
You choose which fonts to embed in a document by using the embed parameter when starting Distiller. To embed all fonts: Use the distill command with the -embedall parameter.

% distill -embedallfonts on
To embed no fonts: Use the distill command with the -embednone parameter.

% distill -embednone

To always embed certain fonts: Use the distill command with the -alwaysembed parameter:

% distill -alwaysembed font1 font2 font3
where font1, font2, font3 are the PostScript font names of the fonts to be embedded. To never embed certain fonts: Use the distill command with the -neverembed parameter:

% distill -neverembed font1 font2 font3

Creating a user font list
If you need to add a font to the Always Embed or Never Embed list and that font isn't listed in any of the monitored font locations, you can simply type the font name and then add it. Once you have done that, you can also add the font to a user font list from which you can add it in the future, without typing. This need arises when a PostScript file you are converting contains a font you wish to embed and the font isn't in any available monitored font location. The alternative is to use the Embed All option to embed all the fonts in the PostScript file, which you may not want to do.

You may also want to create a user font list if you use the Windows version of Acrobat Distiller to distill PostScript files that originated on a Macintosh, or vice versa. Because Windows and Macintosh font file formats differ, the Macintosh and Windows versions of Acrobat Distiller cannot refer to the same font folders, even though the fonts share the same PostScript font names. But if you add a PostScript font names to the user font list, Distiller will embed the fonts in the PDF file because it recognizes the names in the PostScript file. It will do this even if the font originated on a platform different from the one in which Distiller is running.

To add a font to the user font list, or remove it: 1 Choose Distiller > Job Options, and click the Font Embedding tab. 2 Click New Font Name, and type a PostScript font name in the Add the Font text field in the dialog box. See Finding a PostScript font name (Windows and Macintosh) for more information. 3 Click Always Embed or Never Embed, and click Add; then click Done, which returns you to the Font Embedding Distiller menu. 4 Click OK.

Note: After you have added the font name, it stays listed; you can move it to the User Font list.

Subsetting fonts
To minimize PDF file size, you can choose to embed only those characters of a font that are used in a document—that is, subset the font. Subsetting is chosen as the default. When you choose to subset, you also choose the character threshold that determines when a font subset is created. If the percentage of characters exceeds the character threshold setting in a document, then the entire font will be embedded in the file rather than a subset of it. The default is 35%. When you combine PDF files with the same font subset, the subsets are not combined. As a result, combining files with subsetted fonts may result in a large file. To embed font subsets (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Font Embedding tab.

2 Select the Subset fonts below option. 3 Enter a character threshold percentage value in the Subset fonts below box, and click OK. In UNIX, you can disable font subsetting or set the character threshold percentage on the command line. To turn off font subsetting (UNIX): To turn off font subset embedding, set the

subsetfonts parameter to off: % distill -subsetfonts off
To set the character threshold for subsetting fonts (UNIX): Use the -maxsubsetpct parameter:

% distill -maxsubsetpct <percentage>
where the percentage is a number between 1 and 99.

Finding a PostScript font name (Windows and Macintosh)
Use Acrobat Exchange to find a font’s PostScript font name in the Font Info dialog box to use with the user font list. To find a PostScript font name: 1 Use any application to create a one-page document that uses the PostScript font. 2 Use PDF Writer to create a PDF file from the document. In the Print PDF File dialog box, select View PDF file. 3 After Acrobat Exchange has opened the new PDF file, choose File > Document Info > Fonts. 4 If the document contains more than a single page and the font you are interested in is not on the first page, click List All Fonts.

5 When you find the font you are looking for, write down the name of the font carefully. The capitalization and hyphenation of the font name are important. If you are going to add this font to the User Font list, type the font name exactly as it appears in this dialog box. 6 Click OK to close the dialog box.

Compressing data in PDF files
About compression Compressing text and line art Using automatic compression Compressing color and grayscale images Compressing monochrome images Changing compression options for individual images Using downsampling and subsampling to reduce file size

Compressing text and line art
Line art, or vector graphics, is described with a mathematical equation. (By contrast, bitmap images are described as pixels.) Line art is usually created with a drawing program such as Adobe Illustrator, MacroMedia Freehand, or CorelDraw. See the Electronic Publishing Guide for more information. ZIP (3.0 compatibility) or LZW (2.1 compatibility) compression is used for text and line art. To compress text and line art (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Compression tab. 2 Select Compress text and line art.

To compress text and line art (UNIX): Specify the compression options on the command line when starting Acrobat Distiller with the - compresstext parameter:

-compresstext on, off

Using automatic compression
If you choose the Automatic Compression option, Acrobat Distiller determines the best compression method for your color and grayscale bitmap images (JPEG, ZIP, or LZW) and applies the correct setting. For example, JPEG compression is used for images with smooth color changes, such as scanned photographs. ZIP (3.0 compatibility) or LZW (2.1. compatibility) compression is used for images with sharp color changes, such as screenshots of dialog boxes. The Automatic Compression option does not affect monochrome images or line art.

Acrobat Distiller’s automatic compression and the default Job Option settings apply the following compression to images:

• Medium JPEG is applied to 8-bit grayscale images and
to 8-bit, 16-bit, and 24-bit color images when the images have continuous, smooth tones. You can change the level of JPEG compression applied to images. See Compressing color and grayscale images for more information.

• ZIP or LZW is applied to 8-bit grayscale images and to
16-bit and 24-bit color images when the images have sharp color changes.

• ZIP or LZW is applied to 2-bit and 4-bit grayscale
images, 4-bit color images, and indexed 8-bit color images.

For the majority of your files, automatic compression provides satisfactory results. If you want to control compression completely, you can turn off automatic compression and set the compression options according to your requirements. To use automatic compression (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Compression tab. 2 Choose the level of JPEG compression you would like Distiller to apply to grayscale and color images. 3 Click OK.

To use automatic compression (UNIX):

% distill -coloracs on % distill -grayacs on % distill -coloracsq low, medium-low, medium, medium-high, high % distill -grayacsq low, medium-low, medium, medium-high, high
The q parameter can also be a number greater than zero.

Compressing color and grayscale images
Distiller can compress a color or grayscale bitmap image to a fraction of its original size. Distiller also provides resampling options for reducing the size of a color or grayscale image. You can resample or compress the image, or do both. See

Using downsampling and subsampling to reduce file size and About compression for more
information. The compression methods available are LZW, LZW 4-bit, LZW 8-bit, ZIP, Zip 4-bit, Zip 8-bit, and JPEG. LZW and ZIP are lossless compression methods. JPEG, LZW 4-bit, LZW 8-bit, ZIP 4-bit, and ZIP 8-bit are lossy compression methods.

The LZW compression methods are available when 2.1 compatibility is selected. The Zip compression methods are available when 3.0 compatibility is selected. JPEG compression is available with both compatibility settings. To select color and grayscale compression settings (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Compression tab. 2 Deselect the Automatic Compression option in the color images and grayscale images boxes. 3 Select Manual Compression and a compression setting from the Compression menu for color images and one for grayscale images. Distiller applies the selected color compression level to all color images in your document; similarly, it applies the selected grayscale compression level to all grayscale images in a document. 4 Click OK.

To compress color and grayscale images (UNIX): You can set compression options for color and grayscale images on the command line in UNIX. Besides choosing a compression setting method, you can instruct Distiller to reduce file size by reducing the color precision in an image. To turn compression on (UNIX): Use the -encodecolor or -encodegray parameters to enable compression:

-encodecolor on, off -encodegray on, off
To set compression methods (UNIX): Specify the compression method on the command line when starting Acrobat Distiller:

-colorcompr <value> -graycompr <value>

where value can be lzw, zip, or jpeg:q. You control the amount of JPEG compression by setting the q parameter to a number greater than 0.0. The following settings are the most commonly used:

0.1 = Low 0.25 = Medium-low 0.5 = Medium 0.9 = Medium-high 1.3 = High 2.0 = Highest accepted value
You can also set the q parameter to low, medium-low, medium, medium-high, or high.

For example, the following command line specifies High JPEG compression for all color images in a document:

% distill -colorcompr jpeg:high PSfile.ps
To reduce the color precision in an image (UNIX): Use the following command-line parameters:

-colordepth value -graydepth value -mondepth value
where value can be -1, (no change), 1, 2, 4, or 8 bits per component in depth. The default is -1. The values instruct Distiller to reduce the number of bits per component used to represent an image to a different number of bits per component. For example, a 24-bit image (8-bits per each RGB component) represented by 16 million colors becomes a 12-bit image represented by 4000 colors when it is reduced by a factor of 4 bits per component.

Compressing monochrome images
Distiller provides resampling and compression options for reducing the size of monochrome (black-and-white) images. You can choose either to resample or compress the image, or both. See Using

downsampling and subsampling to reduce file size and About compression for more information.
You can choose from several lossless compression options for monochrome images: CCITT Group 3, CCITT Group 4, LZW (2.1 Acrobat compatibility), ZIP (3.0 Acrobat compatibility), and Run Length.

Note: Make sure that monochrome images are scanned as monochrome and not as grayscale. Scanned text is sometimes saved as grayscale by default. Grayscale text compressed with the JPEG compression method is muddy at best, and may be unreadable.

To set monochrome compression options (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Compression tab. 2 Select the compression method from the Compression menu for monochrome images. 3 Click OK. To set monochrome compression options (UNIX): Use the -encodemono parameter to enable monochrome compression and the -monocompr parameter to define the compression type. The default is CCITT Group 4 compression on:

-encodemono on, off -monocompr value
where value can be fax3 (CCITT Group 3), fax4 (CCITT Group 4), lzw, zip, or run (Run Length).

For example, the following command line specifies Run Length compression for all monochrome images in a document:

% distill -monocompr run PSfile.ps

Changing compression options for individual images
When Acrobat Distiller creates a PDF file and the Automatic Compression option is deselected, all color images are resampled with the same resolution setting, and all color images of the same bit depth are compressed by the same compression method. Similarly, all grayscale images are processed with one set of resampling and compression settings, and all monochrome images are processed with one set of resampling and compression settings. However, you can create a PDF document containing images that are resampled and compressed with different settings. You can accomplish this with any of the following techniques:

• Use the Adobe Photoshop program to resample
images before processing through Distiller to any resolution.

• Create separate PostScript files for each part of the
document that you want to process differently, and use different compression options to distill each part. Then use Exchange to merge the resulting PDF files. You can write Distiller scripts that use the RunFile operator to process every page with different resampling and compression settings.

• Create color, grayscale, and monochrome images.
Then select different resampling and compression settings for each image type.

• Insert Distiller parameters before images in a PostScript file. You can use this technique to process every image in a document differently. The technique is the most difficult, however, because it requires that you edit a PostScript file. See the DistParm.pdf for information.

Using downsampling and subsampling to reduce file size
Downsampling and subsampling, sometimes referred to as resampling, are techniques whereby information represented by several pixels in a bitmap is combined to make a single larger pixel. You can choose either downsampling or subsampling to reduce the file size, but note that resampling may result in some loss of detail in your images. The default setting downsamples color and grayscale images to 72 dpi and monochrome images to 300 dpi.

• Downsample to reduces the resolution of the image to the specified dpi setting by averaging the pixel color of a sample area and replacing that area with a pixel of the averaged color.

• Subsample to reduces the resolution of the image to
the specified dpi setting by choosing a pixel in the center of the sample area and replacing that area with the pixel chosen. Subsampling significantly reduces the processing time compared with downsampling. See Using downsampling and subsampling to reduce file size for more information. To select a resampling setting (Windows and Macintosh): 1 Choose Distiller > Job Options, and click the Compression tab. 2 Select a resampling method from the menu for each type of image: color, grayscale, and monochrome. 3 Enter a value for the dpi setting for each type of image.

4 Click OK.

Note:Downsampling monochrome images can have unexpected viewing results, such as no image display. If this happens, turn off downsampling and redistill the file.
To select a resampling setting (UNIX): Specify the resampling parameters on the command line when starting Acrobat Distiller:

-colordownsampletype average, subsample -graydownsampletype average, subsample -monodownsampletype average, subsample
where average averages the pixel color of a sample area and replaces that area with a pixel of the averaged color and subsample chooses a pixel in the center of the sample area and replaces that area with the pixel chosen.

To resample to a specified resolution (UNIX):

–colorres value –grayres value –monores value
where value can be between 9 and 1500 dpi, inclusive. For example, the following command line turns off downsampling for all color images in a document:

% distill -colordownsample off PSfile.ps
Assuming downsampling is enabled, the following example downsamples all grayscale images to no fewer than 72 pixels per inch:

% distill -grayres 72 PSfile.ps

Choosing Advanced Options settings
In Windows and on the Macintosh, you choose Advanced Options settings by choosing Distiller > Job Options and clicking the Advanced Options tab, selecting an option, and clicking OK. In UNIX, you make a choice by including a parameter on the command line when you convert the PostScript file. See Guidelines for Using Adobe Acrobat 3.0 for Production Printing for more information.

The Distill with prologue/epilogue option The Convert CMYK Images to RGB option Preserving data for high-end printing options The Color Conversion options

The Distill with prologue/epilogue option
When you select the Distill with prologue.ps/ eplilogue.ps option, Distiller processes these files with each job. Prologue files can be used, for example, to specify cover pages and watermarks. Epilogue files can be used to resolve a series of procedures performed in a PostScript file. There are many other uses for these files. The default is not to distill with prologue and epilogue files. A good understanding of the PostScript language is necessary to use these files effectively. Refer to the PostScript Language Reference Manual (ISBN 0-201-18127-4) for more information.

Distiller processes these files only if they are located appropriately. In Windows and on the Macintosh, the files need to be located in the same folder as the Distiller application if the Open command or a watched folder is used to process a PostScript file. If Epilogue.ps and Prologue.ps files are located at the same level as the IN and OUT folders of a watched folder, then those files will be used instead of the ones located in the same folder as the Distiller application. In UNIX, edit the Distill.upr file located in the Acrobat3/Distillr/Xtras directory to indicate the location of the prologue and epilogue files. In UNIX, use the -includebookends parameter to use prologue and epilogue files. Include the -includebookends off parameter to disable use of prologue and epilogue files.

The Convert CMYK Images to RGB option
The Convert CMYK Images to RGB option usually reduces the size and increases the display speed of PDF files, because less information is needed to describe RGB than CMYK images. Because RGB is the native color space used on monitors, no color conversion is necessary during display, contributing to fast online viewing. The default is to convert the CMYK images to RGB. In UNIX, use the -cmykimagestorgb on parameter to convert CMYK images to RGB. Use the -cmykimagestorgb off parameter to disable converting CMYK images.

Preserving data for high-end printing options
• Preserve OPI Comments retains the information
needed to replace a For Placement Only (FPO) image with the high-resolution image located on an OPI server. The default is to preserve OPI comments. In UNIX, use the -preserveopi on, off parameter to preserve or remove OPI comments.

• Preserve Overprint Settings retains the overprint
setting used when printing color separations.The default is to preserve overprint settings. In UNIX, use the -preservecoverprint on, off parameter to preserve or remove overprint settings.

• Preserve Halftone Screens retains halftone
screen information, such as frequency, angle, and spot functions, used when outputting to a device that uses halftones. The default is to preserve halftone information.

In UNIX, use the -preservehalftone on, off parameter to preserve or remove halftone screens.

• Preserve/Apply/Remove Transfer Functions
Preserving transfer functions retains the information so that it is included in the PostScript output at print time. Applying transfer functions is the default. Applying the transfer function affects the display of the PDF file onscreen as well as output. Removing the transfer settings means that they will not be used when printed or displayed. The original PostScript file may have been created for a specific device that uses the transfer function, but this file may go out for general distribution with no specific output device in mind, in which case it would be best to remove the transfer settings. In UNIX, use the -transferfunction remove, preserve, or apply parameter to remove, preserve, or apply transfer functions.

• Preserve/Remove Under Color Removal / Black
Generation UCR/BG information is used in the conversion from RGB to CMYK. Remove this information if you do not want device-specific settings in the file. The default is to preserve under color removal/black generation. In UNIX, use the -UCRandBG remove, preserve parameters to remove or preserve under color removal/black generation.

The Color Conversion options
Device-independent conversion offers the most consistent representation of color across different devices. Device-dependent is not as accurate, but it may provide faster display time. The default is unchanged.

• Unchanged prohibits conversion unless a deviceindependent color space is specified and does not map directly to Calibrated RGB or LAB. In this case, it will convert to LAB.

• Device Independent does not convert color if the
color space specified in the PostScript file maps directly to a Calibrated RGB or LAB space. If it is a different CIEbased color space (such as CIE-basedDEFG) or Device CMYK, then it is converted to LAB. If the incoming color is Device RGB, it is converted to Calibrated RGB. If it is Device Gray, it is converted to Calibrated Gray. For conversion from a device color space, default color rendering information, which can't be changed, is used.

• Device Dependent does not convert color if the
color space coming in is a device color space. If it is device independent, then it is converted into Device RGB. Use this option to get the fastest possible display time, but realize that you lose the device independence of the color information. In UNIX, use the -colorconversion unchanged, dependent, or independent parameter to set color conversion options. See About separation color spaces for more information.

About separation color spaces
Separation color spaces can be used to specify spot colors or separations other than CMYK. There is no user selection for separation color spaces. If Acrobat 2.1 compatibility is selected, any separation color space specified will be converted to the alternate color space. If 3.0 compatibility is selected, the separation color space is retained in the file. In this case, the alternate color space will be used for rendering to the screen, and the separation color space will be used for the printing separations.

Using Distiller on a network
You can set up Distiller to watch certain folders on a network server. When Distiller watches a folder, it periodically checks the folders for PostScript files. When a PostScript file is saved or copied into a watched folder, Distiller automatically processes the file and moves it to an Out folder. Sharing Distiller on a network conserves individual machine resources, such as memory and disk space. You can also have Distiller watch folders on your own system.

Distiller watched folder diagram Distilling with watched folders Customizing Distiller setup for UNIX sites and users

Distiller watched folder diagram
Watched Folder

PS
Computer running Distiller

IN

Users send PS files & retrieve PDF files

Network Server
Computer running Distiller processes PS files from IN folder and moves PDF files to OUT folder

PDF

Macintosh

DOS

OUT
Windows UNIX

Distilling with watched folders
Acrobat Distiller must have read, write, create, and delete access to each folder it watches on the network.

Setting up watched folders (Windows and Macintosh) Setting up watched folders (UNIX) Setting job options for individual watched folders Setting up Distiller for watched folders Using watched folders Checking watched folder processing and options

Setting up watched folders (Windows and Macintosh)
Acrobat Distiller can watch up to 100 folders. You can specify different options for each folder. To add watched folders (Windows and Macintosh): 1 Choose Distiller > Watched Folders; then click Add Folder. 2 Select the folder location for the In and Out folders. Distiller creates an In folder and an Out folder in the selected folder. Distiller does not create new In and Out folders if folders named In and Out already exist in the selected folder. With Windows, you can place an In/Out folder pair at the root level of a disk drive. For example, you can create a pair of DOS folders, E:\In and E:\Out, by selecting E:\ as a watched folder.

If Distiller is monitoring a folder, the eyes icon appears next to the folder name. 3 Choose Edit Options to change the Job Options controlling compression, fonts, and advanced settings for this folder. See Setting job options for individual watched folders for information. When you edit the individual watched folder job options, this delta symbol will appear in the window next to the folder name.

Note: In Windows, the delta symbol replaces the eyes symbol if you set individual watched folder job options. On the Macintosh, the eyes symbol and the selta symbol appear side by side if the job options have been edited.

To remove a watched folder (Windows and Macintosh): 1 Choose Distiller > watched folders. 2 Select the folder you want to remove. Click Remove Folder. When you delete a Watched Folder from the list, Distiller does not delete the In and Out folders or their contents. You can delete them when it is appropriate.

Setting up watched folders (UNIX)
The UNIX Distiller daemon monitors watched folders. See the Distiller Daemon Administrator’s Guide for configuration information. To add watched folders (UNIX): Add watched folders by specifying the folder names when starting the Distiller daemon. For example:

% distilld /usr/proj_a /usr/proj_b /net/adobe/newpro
Specify the setup parameters on the command line. For example:

% distilld -colorcompr jpeg:1.0 -graycompr lzw -thumbs on\ /proj/excalibur/doc /disks/pcserver1/mon

To remove watched folders (UNIX): To remove watched folders, you must stop the Distiller daemon and start it again with the new list of watched folders. For information about stopping the Distiller daemon, see Using UNIX Distiller daemon to watch folders.

Setting job options for individual watched folders
You can set job options for each watched folder. These options are comparable to the general, embedding, compression, and advanced job options you set for individual distilling jobs. To set job options in UNIX, see the Distiller Daemon Administrator’s Guide. To set watched folder job options (Windows and Macintosh): 1 Choose Distiller > Watched Folders. 2 Select a watched folder. 3 Click Edit Options. 4 Select the appropriate general, compression, font embedding, and advanced options. 5 Click OK.

Setting up Distiller for watched folders
The Watched Folders options control how Distiller manages the processing of files. You can set the following options:

• Check watched folders every x seconds specifies
the number of seconds you want Acrobat Distiller to wait before checking watched folders. You can enter any value from 1 to 10,000 seconds. (10,000 seconds is approximately two and three-quarters hours.)

• Deleted deletes PostScript files from watched folders
after they are processed.

• Moved to the Out folder transfers processed PostScript files to the Out folders with the PDF files.

• Delete files deletes PDF, log, and PostScript files in
Out folders after a specified number of days. You can enter from 1 to 365 days.

To specify watched folder options (UNIX): Specify watched folder options on the command line.

-pause [1:10000] defines the number of seconds to pause; default is 10 seconds. -srcdisp [delete, movetoout] defines what to do with the PostScript file; default is to move the file. -destexp [-1, 1:365] defines the number of days to leave files in the Out folder; default is -1, which specifies not deleting the file. -resume [-1, 1:24] defines the number of hours to wait before resuming the monitoring of suspended directories; default is 24 hours.
For details, see the Distiller Daemon Administrator’s Guide.

Using watched folders
After a watched folder is set up, users save or place PostScript files into the IN folder and later retrieve converted PDF files from the OUT folder. Users must be connected to the server where the watched folders reside to distill PostScript files placed in a watched folder. Contact your system administrator for information about making a network connection. To distill a file: 1 Save or copy the PostScript file to be distilled to the watched folder’s IN folder. 2 Come back later to copy (or drag) your PDF file from the OUT folder. You can continue working on your system during the distillation.

Important: When two PostScript files with the same name are placed in an In folder, the second PDF file created by Acrobat Distiller automatically replaces the first. If you share an In folder with many people, you should give your PostScript files unique names.

Checking watched folder processing and options
Acrobat Distiller maintains a text file called DTIME.TXT in every OUT folder. DTIME.TXT records the last time Acrobat Distiller checked the corresponding In folder for PostScript files and lists the current job option and font embedding settings. Users can open the DTIME.TXT file to check job option settings before deciding to use a particular watched folder on a network. This is especially handy for those users who do not have access to the machine running Distiller to check the job options from Distiller. Windows users can open DTIME.TXT with Notepad, Write, or any word processor. Macintosh users can double-click the DTIME.TXT file icon to open the document in SimpleText. If you don’t have SimpleText, you can use any word processor to open DTIME.TXT as a text file.

Customizing Distiller setup for UNIX sites and users
Customizing Distiller setup Using UNIX Distiller daemon to watch folders Using the startup file to set options

Customizing Distiller setup
Distiller behavior can be customized for sites and for users. The Acrobat Distiller site customization folder <installdir>/Distillr/Startup contains site-specific files for Distiller. Sites can customize Distiller by changing files in this folder. For example, when files are distilled, the default is to compress text and line art. But you can enter a command in your Distiller site-specific startup file (Example.ps) to override this default. See Using the startup file to set options for information about Example.ps. Distiller knows the location of the customization folder because it is specified in the ACRO_RES_DIR file within the <installdir>/Distillr/Xtras folder. You can customize how Distiller finds its resources on a site-wide basis by modifying the ACRO_RES_DIR file.

Users can create their own Distiller customization folders, for example, AcroDist_custom. The resources in this folder can override or supplement those in the site folder. A user must set the PSRESOURCEPATH environment variable to include this user-specific folder. See the ReadMe file located in the customization folder ( <installdir>/Distillr/Xtras/ReadMe) for a description of ways you can customize the distillation.

Using UNIX Distiller daemon to watch folders
The distilld daemon watches directories designated by the system administrator for files to distill. The system administrator can set up the Distiller daemon to run on a UNIX server and to watch directories mounted through NFS.The system administrator can edit a run command (rc) file, such as /etc/rc.local, to start the Distiller daemon automatically whenever the system is booted. The rc file checks whether the daemon executable exists and, if so, starts the daemon. For a description of the distilld options and parameters, type

% distilld -help
See the < installDir>/Exchange/Help/ Admin.pdf file for more information about administering the Distiller daemon.

To stop the Distiller daemon: To stop the Acrobat Distiller daemon, find its process identification number, and then type

% kill <distiller daemon ID>
To stop the Acrobat Distiller daemon temporarily, type

% kill -STOP <distiller daemon ID>
After temporarily stopping the Distiller daemon, type the following to resume operation:

% kill -CONT <distiller daemon ID>

Using the startup file to set options
When Distiller starts, it looks in the Startup folder within the Distiller folder for text files containing PostScript programs. If the Startup folder contains one or more text files, Distiller assumes they are PostScript language programs and uses them to initialize the virtual memory of its PostScript interpreter. The EXAMPLE.PS file contains examples of what you can do in a Startup file. You can load frequently used fonts (to keep Distiller from having to search for them every job), globally set embedding attributes of fonts, and so on. The EXAMPLE.PS file can be found in the Startup folder in the installation directory. Be conservative about what you do with the Startup folder. The settings are global; they affect all PostScript files processed by Distiller.

© 1996 Adobe Systems Incorporated. All rights reserved. Adobe Acrobat 3.0 Distiller Online Guide This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. The copyrighted software that accompanies this manual is licensed to the End User for use only in strict accordance with the End User License Agreement, which the Licensee should read carefully before commencing use of the software. Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Adobe, the Adobe logo, Acrobat, Acrobat Capture, the Acrobat logo, Distiller, Acrobat Exchange, Adobe Type Manager, PostScript, and the tagline “If you can dream it, you can do it” are trademarks of Adobe Systems Incorporated. Microsoft and Windows are registered trademarks and ActiveX and Windows NT are trademarks of Microsoft Corporation in the U.S. and other countries. Apple, Macintosh, Power Macintosh, and QuickTime are registered trademarks and AppleScript and TrueType are trademarks of Apple Computer, Inc. Lotus Notes is a registered trademark of Lotus Development Corporation. Netscape and Netscape Navigator are trademarks of Netscape Communications Corporation. UNIX is a registered trademark in the U.S. and other countries, licensed exclusively through X/Open Company, Ltd. Pentium is a trademark of Intel Corporation. All other products or name brands are trademarks of their respective owners. This product contains an implementation of the LZW algorithm licensed under U.S. Patent 4,558,302.

This software includes software licensed from Verity, Inc., copyright 1994. All rights reserved. The address of Verity, Inc., is 894 Ross Drive, Sunnyvale, California 94089. Verity ® and TOPIC ® are registered trademarks of Verity, Inc. in the United States and other countries. English Electronic Thesaurus copyright 1993 by INSO Corporation. Adapted from the Oxford Thesaurus copyright 1991 by Oxford University Press and from Roget's II: The New Thesaurus copyright 1980 by Houghton Mifflin Company. All rights reserved. Reproduction or disassembly of embodied programs and databases prohibited. ©1994 This software includes software licensed from RSA Data Security, Inc. Written and designed at Adobe Systems Incorporated, 345 Park Ave., San Jose, CA 95110-2704. Adobe Systems Europe Limited, Adobe House, 5 Mid New Cultins, Edinburgh EH11 4DU, Scotland, United Kingdom Adobe Systems Co., Ltd., Yebisu Garden Place Tower, 4-20-3 Ebisu, Shibuya-ku, Tokyo 150, Japan For defense agencies: Restricted Rights Legend. Use, reproduction, or disclosure is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013. For civilian agencies: Restricted Rights Legend. Use, reproduction, or disclosure is subject to restrictions set forth in subparagraphs (a) through (d) of the commercial Computer Software Restricted Rights clause at 52.227-19 and the limitations set forth in Adobe’s standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States. (9/96)

How to use this online guide
Page back or page forward. Undoes a change of page or view, or redoes a change (Go Back/Go Forward). Go to the Contents. Go to the Index. Go to the how-to page (this page). Go to the “parent” of the current topic.

text

Go to the indicated topic. Go to the next page of a continued topic. End of a continued topic.

For instructions on printing this guide, go to the next page.

How to print this online guide
You can print separate topics or the entire guide. Since the pages of the guide have been made small for online viewing, Windows and Macintosh users may prefer to print them two to a page of paper— ”two up.” To print pages two up: 1 Choose File > Print Setup (Windows) or File > Page Setup (Macintosh). 2 Follow the instructions for your platform:

• In Windows, click Options, select 2 up on the Paper
tab, click OK to return to the Print Setup dialog box, and click OK again to close it.

• On a Macintosh, choose 2 Up from the Layout menu
and click OK.

Note: If you can’t perform step 2, you may not be using an Adobe or PostScript printer driver. If you are and you still can’t perform the step, install the Adobe printer driver on the Acrobat CD-ROM. See the Acrobat Getting Started guide for installation instructions.
3 Choose File > Print. 4 Indicate the page range. Click OK (Windows) or Print (Macintosh).