KlassenKlassenKlassenKlassen | | | | Operatoren

convexityconvexityConvexityconvexityConvexityConvexity (Operator)

Name

convexityconvexityConvexityconvexityConvexityConvexity — Ermitteln des Formfaktors für die Konvexität einer Region.

Signatur

convexity(Regions : : : Convexity)

Herror convexity(const Hobject Regions, double* Convexity)

Herror T_convexity(const Hobject Regions, Htuple* Convexity)

Herror convexity(Hobject Regions, double* Convexity)

Herror convexity(Hobject Regions, HTuple* Convexity)

double HRegion::Convexity() const

HTuple HRegionArray::Convexity() const

void Convexity(const HObject& Regions, HTuple* Convexity)

HTuple HRegion::Convexity() const

void HOperatorSetX.Convexity(
[in] IHUntypedObjectX* Regions, [out] VARIANT* Convexity)

VARIANT HRegionX.Convexity()

static void HOperatorSet.Convexity(HObject regions, out HTuple convexity)

HTuple HRegion.Convexity()

Beschreibung

convexityconvexityConvexityconvexityConvexityConvexity berechnet die Konvexität jeder Eingaberegion aus RegionsRegionsRegionsRegionsRegionsregions.

Berechnung:

Sei die Fläche der konvexen Hülle und die Originalfläche der Region, dann ist der Formfaktor C definiert als:

Der Formfaktor C ist gleich 1, wenn die Region konvex ist (z.B. Rechteck, Kreis etc.). Sind Einbuchtungen oder Hohlflächen vorhanden, dann ist C kleiner als 1.

In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie ein Bild mit Regionen, die sich in ihrer Konvexität unterscheiden.

Bei einer leeren Region liefert convexityconvexityConvexityconvexityConvexityConvexity (soweit kein anderes Verhalten festgelegt wurde (siehe set_systemset_systemSetSystemset_systemSetSystemSetSystem)) den Wert 0. Wird mehr als eine Region übergeben, dann werden die Zahlenwerte des Formfaktors in einem Tupel abgespeichert, wobei die Position eines Wertes in dem Tupel der Position der Region im Eingabetupel entspricht.

Parallelisierung

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Zu untersuchende Region(en).

ConvexityConvexityConvexityConvexityConvexityconvexity (output_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Konvexität der Eingaberegion(en).

Zusicherung: Convexity <= 1

Ergebnis

convexityconvexityConvexityconvexityConvexityConvexity liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Das Verhalten bei einer leeren Region (Region ist die leere Menge) wird mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Siehe auch

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, shape_transshape_transShapeTransshape_transShapeTransShapeTrans

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren