.. /*  
    * 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
    */

.. _app-ppd-ext-tips-and-tricks:

Tips and Tricks
---------------

.. contents:: |RST_TABLE_OF_CONTENTS|
   :depth: 1
   :local:

.. _app-ppd-ext-tips-and-tricks-fast-mode-virtual-tray:

Fast Print A4 and Letter to Single Tray
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

For :ref:`Fast Mode <ch-webapp-admin-devices-card-reader-proxy-print-fast>` printers
with a single tray holding A4 media, PPDE can be used to configure an
extra (virtual) IPP
:ref:`media-source <app-ppd-ext-mapping-ipp-iana-media-source>` entry for
Letter, that maps to the same A4 tray. The two media sources will be
visible in the :ref:`Proxy Printer Edit <ch-webapp-admin-proxyprinter-edit-media-sources>`
dialog, so A4 and Letter media size can be assigned to them, and both A4 and Letter
jobs will be Fast Print candidates. With an :ref:`SPExtra <app-ppd-ext-rules-generic-extra>`
rule the Letter media is substituted with A4. And, since ``fit-to-page``
:ref:`print-scaling <app-ppd-ext-mapping-ipp-iana-print-scaling>` is
applied for Fast Mode printing by default, the Letter job will correctly
scale to A4.

The .ppde of the Fast Mode printer looks like this:

.. code-block:: text

   #-------------------------------------------------------------------------
   # Two trays mapped to a single media-source holding A4 media. 
   # In SavaPage Admin Web App: assign A4 to tray-1 and US Letter to tray-2. 
   # ------------------------------------------------------------------------
   *VENInputSlot media-source
   *VENInputSlot *Auto tray-1
   *VENInputSlot  Auto tray-2

   # ------------------------------------------------------------------------
   # When job is US Letter, send as A4. The fit-to-page strategy 
   # for Fast Print will make Letter scale to A4.
   # ------------------------------------------------------------------------
   *SPExtra/media/na_letter_8.5x11in: letter-to-a4 \
      *media/iso_a4_210x297mm