.. highlightlang:: us .. index:: XYGetData .. _xygetdata: XYGetData ========= .. us.tag XYGetData GERMAN xy.data Changed5200 :ref:`XYGetData` gibt alle Datenpunkte oder einen Ausschnitt der Datenpunkte zurück. .. function:: rmXY = XYGetData(hData) rmXY = XYGetData(hData, bExt) rmXY = XYGetData(hData, nFirst) rmXY = XYGetData(hData, nFirst, nCount) rmXY = XYGetData(hData, nFirst, nCount, bExt) .. us.return **Returnwert** *rmXY* ist die zweispaltige Matrix der Datenpunkte. ``rmXY[;1]`` sind die x-Koordinaten und ``rmXY[;2]`` sind die y-Koordinaten der Datenpunkte. .. us.params **Parameter** .. uparam:: hData *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYCreate` erzeugt wurde. .. uparam:: nFirst *nFirst* ist der Index des ersten Punktes der ausgelesen werden soll. Der erste Punkt hat den Index 1. .. uparam:: nCount *nCount* ist die Anzahl der Datenpunkte, die gelesen werden sollen. Falls *nCount* größer ist als die Anzahl der Datenpunkte im Datensatz, wird die maximale Anzahl an Datenpunkten zurück gegeben: ``nCount = nData - (nFirst-1)``. .. uparam:: bExt Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die gefilterten Daten zugreift. .. list-table:: :header-rows: 1 * - Wert - Beschreibung * - -1 - Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist -1. * - 0 - Zugriff auf die Originaldaten. * - 1 - Zugriff auf die gefilterten Daten. .. us.comment **Kommentar** Wird die Funktion nur mit einem Parameter aufgerufen, werden alle Datenpunkte zurück geliefert. Die Funktion liefert die skalierten Werte (siehe :ref:`XYSetScaleOffset`). .. us.example **Beispiel** :: x = linspace(1, 100); y = sin(x); hvHandle = plot(x,y); hData = hvHandle[3]; nCount = XYGetNumberOfPoints(hData); // Hole die letzten 50 Punkte. Index: 51, 52, ... , 100 rmXY = XYGetData(hData, nCount - 50 + 1, 50); **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - 5.20.0 - Die Behandlung des Parameters *nCount* geändert. Der Wert kann nun auch eine Maximalanzahl an gewünschten Werten enthalten. .. seealso:: :ref:`uberblick-xy-datensatze`, :ref:`XYSetData`, :ref:`XYCreate`, :ref:`XYSetScaleOffset`, :ref:`XYSetGetOrgDataFlag` :sub:`id-1966329`