.. _pscairo_output_icon:


pscairo_output
=========================

Defines a Postscript plot output driver based on the Cairo library.

.. py:function:: pscairo_output(**kwargs)
  
    Defines a Postscript plot output driver based on the Cairo library.


    :param output_title: Defines a title for the output which gets displayed if the format supports it.
    :type output_title: str, default: "magics++ plot"

    :param output_name: Defines the root of output filename without the suffix.
    :type output_name: str

    :param output_name_first_page_number: Determines whether, for the first page of multipage output, the number is included in the filename.
    :type output_name_first_page_number: {"on", "off"}, default: "on"

    :param output_file_minimal_width: Width of numbering of multi-file outputs (eg. use 1 for 'plot.1.png', 3 for 'plot.001.png' etc).
    :type output_file_minimal_width: number, default: 1

    :param output_debug: Defines if extra debug information are written in the output file (PS, EPS, SVG) or console (PNG).
    :type output_debug: {"on", "off"}, default: "off"

    :param output_filelist: Defines if a list of all the generated files should be written into a file.
    :type output_filelist: {"on", "off"}, default: "off"

    :param output_filelist_name: Defines the name of the file containing the list of generated files. Enabled when ``output_filelist`` is "on".
    :type output_filelist_name: str, default: "magics_outputs.lst"

    :rtype: :class:`Request`

.. mv-minigallery:: pscairo_output