.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _ch-printer-postscript-driver:

PostScript Driver Print
-----------------------

Any desktop system can print to SavaPage with a PostScript driver.
The driver can either be generic, or a mainstream one from a vendor as
shipped with the OS, or a dedicated one provided by PRODUCT_NAME. When
printing from public Internet a private Device URI must be used. See
:ref:`Internet Printer <ch-webapp-user-main-user-details-internet-printer>`.

.. caution::

   Although the SavaPage driver is not required, beware that
   vendor-specific drivers might offer options that are irrelevant, or
   not supported by the SavaPage Print Server.

The SavaPage Printer Driver comes as a PostScript Printer
Description (PPD), as captured in the ``SAVAPAGE.ppd`` file located in
the :ref:`shared client directory <ch-install-share-client-files>`
``/opt/savapage/client``. The driver is optimized for PRODUCT_NAME
printing. Irrelevant options, like *Duplex Printing* are stripped, other
options like *Paper Size* and *Resolution*, are narrowed down to the
most common choices. If you feel options are missing please let us know.

.. important::

   ``SAVAPAGE.ppd`` is a PostScript-only driver, and does *not* produce
   PDF. This is on purpose, since PDF producing drivers print landscape
   orientated documents with 270 page rotation. As a result these
   documents will show as portrait orientated SafePages.  [2]_

The driver file can be downloaded from the About section of the :ref:`User
Web App <ch-webapp-user-main-footer>` and :ref:`Admin Web
App <ch-webapp-admin-about-support>`.

The installation scripts below use the SavaPage printer driver. When
you want to use a PostScript driver already present in the OS, please
use the proper selection dialogs.

.. caution::

   *The SavaPage JetDirect Server accepts PostScript print jobs
   only*. So do not use the JetDirect protocol unless you are absolutely
   sure that the print client uses PostScript as Print Job Format.
   Windows clients can safely use JetDirect. On macOS and GNU/Linux
   systems IPP and IPPS are the obvious choices.


.. [2]
   SavaPage acts as a Virtual PostScript Printer Device. This is
   separate from the decision on the OSDL Printing Summit in 2006 to
   switch the GNU/Linux standard print job transfer format from
   PostScript to PDF. See 
   `PDF as standard print
   job format <https://wiki.linuxfoundation.org/openprinting/pdf_as_standard_print_job_format>`__.


.. _ch-printer-postscript-driver-ipp-options:

IPP Options from PostScript
~~~~~~~~~~~~~~~~~~~~~~~~~~~

|image62|

.. admonition:: |ADMONITION_TITLE_PREVIEW|

   :ref:`IPP Options from
   PostScript <ch-printer-postscript-driver-ipp-options>` is a
   :ref:`Feature Preview <preface-conventions-feature-preview>` that is
   fully operational but impermanent. The preview is offered to provoke
   feedback based on real world use. Please tell us your requirements.

During PostScript Driver Print the PostScript stream is scanned by
SavaPage for elements that can be mapped to IPP options.


.. list-table:: PostScript elements mapped to IPP options
   :width: 100%
   :widths: 40 12 18 30
   :header-rows: 1
   
   * - PostScript element
     - value
     - IPP option
     - value

   * - | ``%RBINumCopies:``
       |
       | ``%%BeginNonPPDFeature: NumCopies``
     - |
     - copies
     - (number of copies)
     
   * - | ``%%BeginFeature: *Duplex``
     - | ``None``
       | ``DuplexNoTumble``
       | ``DuplexTumble``
     - | sides
     - | one-sided
       | two-sided-long-edge
       | two-sided-short-edge
     
     
   * - | ``%%BeginFeature: *Collate``
     - | ``True``
       | ``False``
     - | sheet-collate
     - | collated
       | uncollated

   * - | ``featurebegin{<< /Collate``
     - | ``true``
       | ``false``
     - | sheet-collate
     - | collated
       | uncollated
   
   * - | ``<</ProcessColorModel``
     - | ``/DeviceCMYK``
       | ``/DeviceGray``
     - | print-color-mode
     - | color
       | monochrome
     
   * - | ``featurebegin{<< /ProcessColorModel`` 
     - | ``/DeviceCMYK``
       | ``/DeviceGray``
     - | print-color-mode
     - | color
       | monochrome
     
   * - | ``@PJL SET LCOLORMODEL=``
     - | ``CMYK``
       | ``BLACK``
     - | print-color-mode
     - | color
       | monochrome


.. note::

   If :ref:`Inherit IPP options from print-in
   document <ch-webapp-admin-options-proxy-print-modes>` is enabled
   extracted IPP options are used for :ref:`Fast Print
   Mode <ch-webapp-admin-devices-card-reader-proxy-print-fast>`.

.. /*  
    * Images
    */

.. |image62| image:: ../images/manual/savapage-feature-preview-75x100.png
   :width: 50px
   :target: #preface-conventions-feature-preview