.. highlightlang:: us

.. index:: auto_xy_Scale

.. _auto_xy_scale:

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

.. us.tag  auto_xy_Scale NOTREADYENGLISH auto_xy

The function is obsolete. New scripts should use the :ref:`XYSetFilterFunctions` 
function.

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

.. us.return

**Return Value**

*hDataNew* is the handle of the new 2D dataset.

.. us.params

**Parameters**

.. uparam:: hData_Layer

   *hData_Layer* is a vector with
   one or two elements:

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

      * - Value
        - Meaning
      * - hData_Layer[1]
        - Handle of a dataset. The new dataset is added to the diagram to which the dataset hData_Layer[1] belongs.
      * - hData_Layer[1, 2]
        - The first element is the handle of a dataset and the second element is the handle of diagram (layer). The new dataset is added to the diagram with the handle hData_Layer[2].

.. us.example

**Example**

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

::

   hPage = auto_LoadTemplate("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:`overview-automation`,
   :ref:`PageGetLayerHandle`

:sub:`id-690718`