.. highlightlang:: us

.. index:: AppSetGDI

.. _appsetgdi:

AppSetGDI
=========

.. us.tag  AppSetGDI GERMAN App New6000

:ref:`AppSetGDI` setzt das Interface für die graphische Ausgabe (Graphics Device
Interface). Ab UniPlot R2018 können drei verschiedene Interfaces verwendet werden.

.. function:: bool = AppSetGDI(nGDIType)
              bool = AppSetGDI(oOptions)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: nGDIType

   *nGDIType* ist einer der folgenden Werte:

   .. list-table::
      :header-rows: 1

      * - nGDIType
        - Typ
        - Anmerkung
      * - 1
        - GDI
        - Verwendet bis einschliesslich UniPlot R2016. Schneller als GDI+, aber
          keine transparenten Flächen, Antialiasing etc.
      * - 2
        - GDI+
        - Ab UniPlot R2017. Bessere Ausgabequalität als GDI, aber langsamer.
      * - 3
        - Direct2D
        - Hardwarebeschleunigte Ausgabe. Ab UniPlot R2018. Qualität wie GDI+
          und schneller als GDI.

.. uparam:: oOptions

   *oOptions* ist ein Objekt mit den folgenden Keys: screen, printer, timing.

   .. list-table::
      :header-rows: 1

      * - Option
        - Werte
        - Anmerkung
      * - screen
        - 1,2,3
        - 1:GDI, 2:GDI+, 3:Direct2D
      * - printer
        - 1,2
        - 1:GDI, 2:GDI+ (Direct2D kann momentan noch nicht für die Druckausgabe
          verwendet werden.)
      * - timing
        - 0,1
        - 0: Keine Zeitmessung, 1:Im Log-Fenster wird die Zeitspanne eines Replots
          ausgegeben.

.. us.comment

**Kommentar**

Die Einstellung wird in der Registry gespeichert, so dass sie beim Neustart von
UniPlot erhalten bleibt. Das Interface wird bei der Bildschirmausgabe und beim
Drucken verwendet.

.. us.example

**Beispiel**

Für Druckerausgabe GDI verwenden:

::

   AppSetGDI( [. printer = 1] )

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2018 (6.00.0)
     - Neu.

.. seealso::
   :ref:`uberblick-application-objekt`,
   :ref:`AppGetGDI`

:sub:`id-413742`