XYZSetHullNewData

XYZSetHullNewData erzeugt eine neue Datenhülle, die auch Inseln enthalten kann.

bool = XYZSetHullNewData(hData, rvX, rvY, rvLineTo)

Returnwert

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

Parameter

hData

hData ist die Zugriffsnummer (Handle) des Datensatzes, der mit XYZCreate oder XYZCreateFromMatrix erzeugt wurde.

rvX

rvX ist ein Vektor mit den X-Koordinaten.

rvY

rvY ist ein Vektor mit den Y-Koordinaten.

rvLineTo

rvLineTo ist ein Vektor, der die Form der Datenhülle festlegt (Volllastlinie). Jedes Vektorelement kann den ASCII-Code-Wert der Zeichen "m", "M", "l" und "L" annehmen. Die Zeichen haben folgende Bedeutung:

Wert Bedeutung
"m" ASCII-Code = 109 MoveTo ohne Beschriftung des z-Wertes.
"M" ASCII-Code = 77 MoveTo mit Beschriftung des z-Wertes.
"l" ASCII-Code = 108 LineTo ohne Beschriftung des z-Wertes.
"L" ASCII-Code = 76 LineTo mit Beschriftung des z-Wertes.

Kommentar

Alle Vektoren müssen die gleiche Anzahl an Elementen haben. Der z-Wert für die Beschriftung der Hüllenpunkte wird interpoliert.

Beispiel

rvHull = [10,10; 20,10; 20,20; 20,10];

nRows = nr(rvHull);
rvLineTo = zeros(nRows, 1) + 109; // MoveTo
XYZSetHullNewData(hData, rvHull[;1], rvHull[;2], rvLineTo);
XYZSetHullType(hData, HULL_USERDEF);
XYZUpdate(hData);

id-892593