.. /*  
    * 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-printable-file-types:

.. figure:: ../images/manual/savapage-logo-no-text-100px.png
   :width: 75px


Printable File Types
====================

.. admonition:: |ADMONITION_TABLE_OF_CONTENTS|
     
   - :numref:`{number}. {name} <app-printable-file-types-standard>`
    
     - :numref:`{number}. {name} <app-printable-file-type-xps>`
      
   - :numref:`{number}. {name} <app-printable-file-types-advanced>`
   - :numref:`{number}. {name} <app-printable-file-types-pdf-font-subst>`


.. _app-printable-file-types-standard:

Standard File Types
-------------------

SavaPage printer supports a number of common file types out of the
box as summarized in the :ref:`table below <tbl-printable-file-types-standard>`.

.. important::

   Non-embedded fonts in original or produced PDF documents are subject
   to :ref:`Font Substitution <app-printable-file-types-pdf-font-subst>`.

.. _tbl-printable-file-types-standard:

.. list-table:: Standard Printable File Types
   :width: 100%
   :header-rows: 1
   
   * - Extension
     - Type
   * - ``pdf``
     - | **Portable Document Format**
       |
       | The PDF must not be password protected and not have dynamic XFA [1]_ form content.
       |
       | To accept encrypted PDF the :ref:`Allow Encrypted PDF for Proxy Printing <ch-webapp-admin-options-advanced-safepages>` option
       | must explicitly be enabled.
       |
       | Non-embedded fonts are subject to :ref:`PDF Font Substitution <app-printable-file-types-pdf-font-subst>`.
   * - ``ps``
     - | **PostScript**
       |
       | DRM protected PostScript is rendered for ProxyPrinting only. 
       | See :ref:`Printing Encrypted PDF <ch-printer-encryped-pdf>`.
   * - | ``oxps``
       | ``xps``
     - | **Open XML Paper Specification**
       | 
       | See :ref:`XPS to PDF Installation Instructions <app-printable-file-type-xps>`.
   * - | ``html``
       | ``htm`` 
     -  **Hypertext Markup Language**  
   * - ``txt``
     - **Text File**  
   * - ``bmp``
     - **Bitmap**
   * - ``gif``
     - | **Graphic Interchange Format**
       |                                   
       | For Animated GIF each image is rendered separately.
   * - | ``heif``
       | ``heic`` 
     - | **High Efficiency Image File Format** 
       |
       | :ref:`heif-convert <ch-intro-sys-req-server-heif-convert>`  is needed for this file type.
   * - | ``jpg``
       | ``jpeg``
       | ``jpe``
     - **JPEG/JIFF Image** 
   * - ``png``
     - **Portable (Public) Network Graphic**
   * - ``md``
     - **Markdown**
   * - ``svg``
     - | **Scalable Vector Graphics**
       |                                   
       | :ref:`rsvg-convert <ch-intro-sys-req-server-rsvg-convert>` is needed for this file type.
   * - | ``tiff``
       | ``tif`` 
     - | **Tagged Image Format File** 
       |
       | Multi-page tiff is supported.
   * - ``eml``
     - | **Electronic Mail Format** 
       |
       | EML is a file extension for an email message saved to a file in the
       | Internet Message Format protocol for electronic mail messages.
       | EML files comply with industry standard `RFC 5322 <https://datatracker.ietf.org/doc/html/rfc5322>`__   
       | and can be exported from most email clients.


.. note::

   The :ref:`default paper size <ch-webapp-admin-options-advanced-default-paper-size>`
   is used as the paper size for the printed document of a Printable File Type
   which itself does not have a document structure with a clearly
   defined page size. These types typically include HTML, TXT and
   *images*.

.. [1]
   XML Forms Architecture (XFA) is a proprietary format for forms
   introduced by Adobe in PDF 1.5 that is not compatible with ISO
   32000's AcroForms feature. Most PDF processors do not handle XFA
   content. The XFA specification is referenced from ISO 32000-1 / PDF
   1.7 as an external proprietary specification, and was entirely
   deprecated from PDF with ISO 32000-2 (PDF 2.0). Dynamic PDF-XFA can
   change its layout and appearance based on the data entered by the
   user. Static forms have a fixed layout.

.. _app-printable-file-type-xps:

XPS to PDF Installation Instructions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Open XML Paper Specification (XPS) is an XML based electronic paper
format originally developed by Microsoft to serve as a PDF alternative.
XPS files are usually created using "Microsoft XPS Document Writer" in a
Windows environment.

SavaPage uses the ``xpstopdf`` command from the libgxps [2]_
package to convert XPS documents to PDF format. Check if this package is
installed by entering the command: 

.. code-block:: bash

  xpstopdf --help

On Debian based systems you can install the package with the command:

.. code-block:: bash

  sudo apt install libgxps-utils

.. note::

   Before XPS to PDF can be used it must be enabled. See
   :ref:`Options > Advanced > Converters <ch-webapp-admin-options-advanced-converters>`.


.. [2]
   `libgxps <https://wiki.gnome.org/libgxps>`__ is a library for
   handling and rendering XPS documents.