XYZSetHullNewData

XYZSetHullNewData creates a new data hull that can also contain islands.

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

Return Value

If the function succeeds, the return value bool is TRUE (1); otherwise it is FALSE (0).

Parameters

hData

The handle of a dataset created with XYZCreate.

rvX

rvX A vector with the x-coordinates.

rvY

rvY A vector with the y-coordinates.

rvLineTo

rvLineTo A vector of characters which define the shape of the data hull, e.g. Full Load Line (WOT). Each vector element be one of the following ASCII characters:

Value	Meaning
“m” ASCII-Code = 109	MoveTo without z-value label.
“M” ASCII-Code = 77	MoveTo with z-value label.
“l” ASCII-Code = 108	LineTo without z-value label.
“L” ASCII-Code = 76	LineTo with z-value label.

Comment

All vectors must have the same number of elements. The z-value for the labelling of hull data points will be interpolated.

Example

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);

See also

Overview XYZ-Datasets, XYZCreate, XYZGetHullData, XYZSetHullType, XYZUpdate, strcode, strsplit, strchar, sum

_id-892593