.. highlightlang:: us

.. index:: auto_xy_Scale

.. _auto_xy_scale:

auto_xy_Scale
=============

.. us.tag  auto_xy_Scale GERMAN auto_xy

Diese Funktion ist veraltet. Neue Scripte sollten die Funktion
:ref:`XYSetFilterFunctions` verwenden.

:ref:`auto_xy_Scale` skaliert die Datenpunkte eines 1D- oder 2D-Datensatzes.

.. function::  hDataNew = auto_xy_Scale(hData_Layer, rsYScale, rsYOffset)
    hDataNew = auto_xy_Scale(hData_Layer, rsXScale, rsXOffset, rsYScale, rsYOffset)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer (Handle) des neu erzeugten Datensatzes.

.. us.params

**Parameter**

.. uparam:: hData_Layer

   *hData_Layer* ist entweder die Zugriffsnummer (Handle) des Datensatzes
   (*hData*) auf den die Funktion angewendet werden soll oder ein Vektor mit den
   Zugriffsnummern des Datensatzes und eines  Diagramms ([hData, hLayer]). 

   Wird nur ein Datensatzhandle *hData* übergeben, wird der erzeugte Datensatz
   dem Diagramm zugefügt, in dem sich *hData* befindet.

   Beim Aufruf mit [*hData*, *hLayer*] wird der neue Datensatz dem Diagramm
   *hLayer* zugefügt.

.. uparam:: rsYScale

   *rsYScale* ist ein Faktor, mit dem die Y-Koordinaten des Datensatzes *hData*
   skaliert werden (yNew = rsYScale * yOld + rsYOffset).

.. uparam:: rsYOffset

   *rsYOffset* ist ein Offset (yNew = rsYScale * yOld + rsYOffset).

.. uparam:: rsXScale

   *rsXScale* ist ein Faktor, mit dem die X-Koordinaten des Datensatzes *hData*
   skaliert werden (xNew = rsXScale * xOld + rsXOffset).

.. uparam:: rsXOffset

   *rsXOffset* ist ein Offset (xNew = rsXScale * xOld + rsXOffset).

.. us.comment

**Kommentar**

Der Datensatz mit dem Handle *hData* muss in jedem Fall einem Diagramm zugeordnet
sein, ansonsten geben alle ``auto_xy_`` -Funktionen den Wert 0 (Datensatz konnte
nicht erzeugt werden) zurück.

.. us.example

**Beispiel**

.. image:: S:/uniplot-obj/images/auto_xy_Scale.*

::

   hPage = auto_LoadTemplate(GetRootDirectory() + "template/tpl_ger", "2 Diagramme");
   auto_ImportData(GetRootDirectory() + "samples/vollast.asc");
   hData = auto_LoadDataset("Diagramm 1", "N", "PME");
   hLayer = PageGetLayerHandle(hPage, "Diagramm 2");
   auto_xy_Scale([hData, hLayer], 2, 0);
   auto_ScaleAxes();
   auto_UpdatePage();

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_LoadDataset`,
   :ref:`PageGetLayerHandle`

:sub:`id-690718`