The following DPS support files are included with NCDware and reside by default in /usr/lib/X11/ncd/dps:

• PSres.upr-the PostScript resource file
  

• VM_3_2.SNF-the virtual memory file
  

• CIE-dict19c.dat-the color-rendering file
  

• InitProc.dat-the context initialization file
  

The following sections describe these files in more detail.

The PostScript Resource File

This section describes the PostScript resource file, PSres.upr, which is essential for DPS operation, and the NCD utility for creating a new resource file or updating a resource file. When working with this file, keep the following in mind:

• If you change the default locations of the DPS support files or DPS font files, you must modify the contents of the PostScript resource file to reflect the changes. You may also need to add new file service table entries; for information on the terminal's file service table, see Chapter 5, Configuring Network Services.
  

• If you use other PostScript resource files, make sure they follow the *.upr naming convention.
  

For more information about PostScript resource files, refer to Programming the Display PostScript System with X from Adobe Systems Incorporated.

Sections in the PostScript Resource File

The PostScript resource file contains the following sections:

• DPSVM-This section identifies the VM (Virtual Memory) file. The VM file must be loaded for DPS to work correctly. For example:
  

  
  DSPVM
  local=VM_3_2_.snf
  master=VM_3_2_.snf
  

• ColorRendering-This section identifies the file containing color-rendering information. The identified file aids the DPS extension in rendering colors in a device-independent manner. For example:
  

  
  ColorRendering
  DefaultCIE=CIE-dict19c.dat
  ColorCIE=CIE-dict19c.dat
  

• ContextInit-This section identifies the context initialization file used when a context is created. Forexample:
  

  
  ContextInit
  InitProc=InitProc.dat
  

• FontAFM-This section identifies the locations of the Adobe Font Metric (AFM) files. Some applications that use the PostScript language need these files for proper operation. The section lists each font name and font location. For example:
  

  
  FontAFM
  AvantGarde-BoldObl=fonts/AFM/AGWO____.afm
  AvantGarde-Book=fonts/AFM/AGW_____.afm
  AvantGarde-Demi=fonts/AFM/AGD_____.afm
  AvantGarde-DemiOblique=fonts/AFM/AGDO____.afm
  

• FontFamily-This section identifies the supported font families and additional typefaces. For example:
  

  
  FontFamily
  Courier=Bold Oblique,Courier-BoldOblique,Bold,CourierBold,Medium,Courier, 
  Oblique,Courier-Oblique
  .
  

• FontOutline-This section identifies the locations of the available outline font files. It lists each outline font name and the font location. For example:
  

  
  FontOutline
  AvantGarde-Book=fonts/AGW_____.pfa
  AvantGarde-BookOblique=fonts/AGWO____.pfa
  AvantGarde-Demi=fonts/AGD_____.pfa
  AvantGarde-DemiOblique=fonts/AGDO____.pfa
  

• FontPrebuilt-This section identifies the locations of the available hand-tuned, bitmap fonts. It lists each font name and the font location. For example:
  

  
  FontPrebuilt
  Courier-BoldOblique=prebuilts/COBO____.bepf
  Courier-Bold=prebuilts/COB_____.bepf
  Courier=prebuilts/COM_____.bepf
  Courier-Oblique=prebuilts/COO_____.bepf
  

The makepsres utility allows you to make a new PostScript resource file or update an existing file. The following example shows how to use this utility to update the PSres.upr file so that DPS servers can access more fonts:

1. Change to the directory to which you will be adding fonts.
   
   

   Note:

   NCD recommends that you use a directory under /usr/lib/X11/ncd. Otherwise, the DPS module may not be able to locate the PostScript resource file. If you must place the fonts in another location, make sure that each terminal can access the new fonts through its file service table.

   
   

2. Add the desired fonts to the directory.
   

3. While in the directory, invoke makepsres:
   

   
   > /usr/lib/X11/makepsres
   

   
   In response, makepsres creates a new PostScript resource file in the current directory. If the current directory contains an existing PostScript resource file, makepsres merges the contents of the existing file with the information from the new fonts and produces a new PSres.upr file.
   

4. Add the DPSVM section to the resulting PSres.upr file if that section does not already exist.
   
   If you invoke makepsres in a directory that does not contain an existing PSres.upr file, you must include information identifying the location of the VM file. To do this, add DPSVM to the beginning of the PSres.upr file where it lists all sections of the file. For example:
   

   
   PS-Resources-1.0
   DPSVM
   FontAFM
   FontFamily
   FontOutline
   

   
   Add the DPSVM section to the file; for example:
   

   
   DPSVM
   local=VM_3_2_beta2.snf
   master=VM_3_2_beta2.snf
   

   
   When you finish modifying this file, it should resemble the following example:
   

   
   PS-Resources-1.0DPSVM
   ColorRendering
   ContextInit
   FontAFM
   FontFamily
   FontOutline
   FontPrebuilt
   .
   DPSVM
   local=VM_3_2_beta2.snf
   master=VM_3_2_beta2.snf
   .
   ColorRendering
   %DefaultCIE=CIE-dict19c
   ColorCIE=CIE-dict19c.dat
   .
   .
   .
   

   
   If necessary, modify the dps-resource-path parameter on all terminals using DPS so the DPS module can locate the resource files. For information on setting this parameter, see "Configuring the DPS Resource Path".
   

5. Reboot the affected terminals so they can read the new PSres.upr file.
   

The virtual memory file, VM_3_2.SNF, provides information about the VM (Virtual Memory) space that Display PostScript needs for operation. The DPS extension uses two types of virtual memory:

• Shared VM holds system fonts and other resources shared by all contexts.
  

• Private VM holds fonts specific to each context.
  

The color-rendering file, CIE-dict19c.dat, contains a PostScript rendering dictionary that allows the DPS extension to provide device-independent color. This file is loaded for each DPS context. The information in the file allows all requests for color to be honored. The output generated by DPS depends on the output device:

• On monochrome monitors, the output consists of dithered, halftone patterns of black and white pixels.
  

• On grayscale monitors, the output consists of halftone patterns using gray levels.
  

• On color monitors, the output consists of the requested color or a dithered pattern of RGB pixels that approximates the color.
  

The context initialization file, InitProc.dat, executes arbitrary PostScript code when a context is created. You can use the file to set various user parameters or to initialize local virtual memory.