impressario_ppd_model(1)

NAME
     impressario_ppd_model.gui - PPD Printer Configuration Dialog

SYNOPSIS
     <printer name> <userid> "" "<options>"

DESCRIPTION
     impressario_ppd_model.gui is a generic printer configuration dialog for
     use with printers supported by Adobe PPD (Postscript Printer Description)
     descriptions.

     The dialog executable is given the name of an installed printer.  The
     command line includes a user id, an empty string, and a string consisting
     of a set of initial item option settings.  The initial options string may
     be empty.

THE MAIN DIALOG
     The main dialog consists of an item help window, an item option panel,
     and a set of action buttons.

ACTION BUTTONS
     The action area of the main dialog provides five buttons:

     OK:
      Select the current settings and end the dialog.

     UNDO:
      Reverse the last setting.

     APPLY:
      Select the current settings and continue the dialog.

     CANCEL:
      Cancel the dialog.

     DEFAULTS:
      Restore all settings to their initial values.

OPTION PANEL
     The option panel consists of zero or more groups of printer items with
     one or more options per item.  Alternative options are selected by means
     of option menus or sets of radio buttons.  Numeric options are indicated
     by means of text boxes and sliders.  Note that some boxes require integer
     values while other allow decimal values.  Pairs of values are intervals
     which require the second value to be larger than the first.  Some item
     may be disabled certain option settings of other items.  Disabled options
     are displayed in gray.  Disabled options are insensitive to selection.

ITEM AND ACTION HELP
     A text window at the top of the dialog provides help text for individual
     configuration items and for action buttons on the main dialog.  This
     window can be disabled by an appropriate choice of X resource values.
CONSTRAINTS AND CONFLICTS
     PPD files may include constraints which exclude certain combinations of
     printer item option settings.  These item options are displayed in red on
     the option panel in order to indicate a conflict.

CONFLICT DIALOGS
     A Potential Conflict  dialog is displayed each time a setting involving a
     potential conflict is selected.  This dialog indicates the constraints
     involved in the selection.  The user may then use buttons provided in the
     action area of the dialog to continue or cancel the setting.

     The conflict Resolution dialog is display if one or more actual item
     option setting conflicts exist when an OK or Apply is chosen.  This
     dialog lists each pair of conflicting setting and provides one or more
     setting options for resolving each conflict.  Each choice of a resolution
     causes the dialog to be redisplayed until all actual actual conflicts are
     resolved.

PPD EXTENSIONS
     Adobe PPD support three kinds of option structures for selecting
     enumerated alternatives: Boolean, PickOne (of many), and PickMany (of
     many).  Impressario_ppd_model.gui add six additional types in order to
     support numeric options.  These include: IntegerScale, FloatScale,
     IntegerField, FloatField, IntegerInterval, and FloatInterval.

     The field item types provide a single numeric field.  The scale item
     types provide a single numeric field and an associated horizontal slider.
     The interval item types provide two numeric fields.  The fixed and float
     item types are identical with the exception that the fixed types employ
     integer field values while the float types employ decimal values.  Two
     additional statement forms are added to the PPD language in order to
     support these new item types.  These have the form:

     *RANGE <min 1> <dflt 1> <max 1> <min 2> <dflt 2> <max 2>

     *TAGS <tag1> <tag2>

     The range form specifies the minimum, maximum, and default values for an
     item.  Interval types require all six values while the scale and field
     item types require only the first three.  These parameters may be
     supplied as integers or decimal values.

     The TAGS form specified one or two character strings which are used for
     the value of text lables which follow each field in a numeric item type.
     Interval item types require both tags while the scale and field item
     types require only the first tag.

FILES
     The file impressario_ppd_model.gui is installed in the directory
     ~lp/gui_model/ELF.

     The file impressario_ppd_model.gui is installed for each supported
     printer as ~lp/gui_interface/ELF/<printer name>.

     The packed PPD and X resources files used which control the behavior of
     the PPD printer configuration GUI is installed as ~lp/app-
     defaults/<printer name>/<printer name>.

TRADEMARKS
     PostScript is a registered trademark of Adobe Systems, Inc.

SEE ALSO
     ppd(1M), impressario(1)

     PostScript Printer Description File Format Specification Version 4.2 29
     March 1994 by Adobe Systems Incorporated San Jose, California.