differencedifferenceDifferenceDifferencedifference (Operator)

Name

differencedifferenceDifferenceDifferencedifference — Berechnen der Differenz von Mengen von Regionen.

Signatur

difference(Region, Sub : RegionDifference : : )

Herror difference(const Hobject Region, const Hobject Sub, Hobject* RegionDifference)

Herror T_difference(const Hobject Region, const Hobject Sub, Hobject* RegionDifference)

void Difference(const HObject& Region, const HObject& Sub, HObject* RegionDifference)

HRegion HRegion::Difference(const HRegion& Sub) const

static void HOperatorSet.Difference(HObject region, HObject sub, out HObject regionDifference)

HRegion HRegion.Difference(HRegion sub)

def difference(region: HObject, sub: HObject) -> HObject

Beschreibung

differencedifferenceDifferenceDifferencedifference berechnet die flächenmäßige Differenz von Regionen: (Regionen aus Region) - (Regionen aus Sub) Eine Ergebnisregion berechnet sich aus der Eingaberegion (RegionRegionRegionregionregion) minus aller Punkte der Regionen aus SubSubSubsubsub. Intern werden alle Regionen aus SubSubSubsubsub zunächst vereinigt, bevor die Differenz jeder einzelnen Region aus RegionRegionRegionregionregion mit der vereinigten Region berechnet wird.

Achtung

Leere Eingaberegionen sind bei beiden Parametern zulässig. Es ist zu beachten, dass leere Regionen entstehen können. Hierbei ist der Wert von 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region" zu beachten.

Ausführungsinformationen

Parameter

RegionRegionRegionregionregion (input_object)  region(-array) objectHRegionHObjectHObjectHobject

Zu bearbeitende Region(en).

SubSubSubsubsub (input_object)  region(-array) objectHRegionHObjectHObjectHobject

Diese Region(en) (ihre Vereinigung) werden von Region abgezogen.

RegionDifferenceRegionDifferenceRegionDifferenceregionDifferenceregion_difference (output_object)  region(-array) objectHRegionHObjectHObjectHobject *

Ergebnis der Differenz.

Beispiel (HDevelop)

* provides the region X without the points in Y
difference(X,Y,RegionDifference)

Beispiel (C)

/* provides the region X without the points in Y */
difference(X,Y,&RegionDifference);

Beispiel (HDevelop)

* provides the region X without the points in Y
difference(X,Y,RegionDifference)

Beispiel (HDevelop)

* provides the region X without the points in Y
difference(X,Y,RegionDifference)

Komplexität

Sei die Anzahl der Region und deren mittlere Fläche und die Gesamtfläche aller Regionen aus SubSubSubsubsub, dann ist die Laufzeitkomplexität: .

Ergebnis

differencedifferenceDifferenceDifferencedifference liefert normalerweise den Wert 2 ( H_MSG_TRUE) . 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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>), das bei leerer Region mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringpouring, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

Nachfolger

select_shapeselect_shapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegiondisp_region

Siehe auch

intersectionintersectionIntersectionIntersectionintersection, union1union1Union1Union1union1, union2union2Union2Union2union2, complementcomplementComplementComplementcomplement, symm_differencesymm_differenceSymmDifferenceSymmDifferencesymm_difference

Modul

Foundation