gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldgen_region_contour_xld (Operator)
Name
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldgen_region_contour_xld — Generierung einer Region aus einer XLD-Kontur.
Signatur
Herror gen_region_contour_xld(const Hobject Contour, Hobject* Region, const char* Mode)
Herror T_gen_region_contour_xld(const Hobject Contour, Hobject* Region, const Htuple Mode)
def gen_region_contour_xld(contour: HObject, mode: str) -> HObject
Beschreibung
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld erzeugt eine pixelgenaue Region
RegionRegionRegionRegionregionregion aus einer subpixelgenauen XLD-Kontur ContourContourContourContourcontourcontour.
Die örtliche Diskretisierung der Kontur erfolgt nach dem
Bresenham-Algorithmus und berücksichtigt die Nachbarschaftsbeziehung,
welche sich mit Hilfe des Wertes des Parameters 'neighborhood'"neighborhood""neighborhood""neighborhood""neighborhood""neighborhood" des
Operators set_systemset_systemSetSystemSetSystemSetSystemset_system einstellen lässt. Offene Konturen werden
geschlossen, bevor sie in eine Region gewandelt werden. Der Parameter
ModeModeModeModemodemode legt schließlich fest, ob die Region gefüllt
('filled'"filled""filled""filled""filled""filled") oder nur ihr Rand ('margin'"margin""margin""margin""margin""margin") zurückgegeben wird.
Zu beachten ist, dass die Koordinaten der Konturpunkte während
der Umwandlung auf die nächsten Integer-Pixelkoordinaten gerundet
werden. Dies kann zu unerwarteten Ergebnissen führen, wenn man
die aus dem Operator gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld erhaltene Kontur
als Eingabe an gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld übergibt: Setzt man
den Parameter ModeModeModeModemodemode von gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld auf
'border'"border""border""border""border""border", dann sind die Eingaberegion von
gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld und die Ergebnisregion von
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld unterschiedlich. Nehmen wir z.B.
an, dass die Eingaberegion von gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld
lediglich aus dem Pixel (1,1) besteht. Dann enthält die
Ergebniskontur von gen_contour_region_xldgen_contour_region_xldGenContourRegionXldGenContourRegionXldGenContourRegionXldgen_contour_region_xld (wenn
ModeModeModeModemodemode auf 'border'"border""border""border""border""border" gesetzt ist) die fünf Punkte
(0.5,0.5), (0.5,1.5), (1.5,1.5), (1.5,0.5) und (0.5,0.5).
Übergibt man diese Kontur wiederum an
gen_region_contour_xldgen_region_contour_xldGenRegionContourXldGenRegionContourXldGenRegionContourXldgen_region_contour_xld, erhält man folglich eine
Ergebnisregion, die aus den Punkten (1,1), (1,2), (2,2) und (2,1)
besteht.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ContourContourContourContourcontourcontour (input_object) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject
Eingabe-Kontur(en).
RegionRegionRegionRegionregionregion (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Erzeugte Region(en).
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Füllmodus der Region(en).
Defaultwert:
'filled'
"filled"
"filled"
"filled"
"filled"
"filled"
Wertevorschläge: 'filled'"filled""filled""filled""filled""filled", 'margin'"margin""margin""margin""margin""margin"
Vorgänger
gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld,
gen_contour_polygon_rounded_xldgen_contour_polygon_rounded_xldGenContourPolygonRoundedXldGenContourPolygonRoundedXldGenContourPolygonRoundedXldgen_contour_polygon_rounded_xld
Alternativen
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygongen_region_polygon,
gen_region_polygon_xldgen_region_polygon_xldGenRegionPolygonXldGenRegionPolygonXldGenRegionPolygonXldgen_region_polygon_xld
Siehe auch
set_systemset_systemSetSystemSetSystemSetSystemset_system
Modul
Foundation