gen_region_polygonT_gen_region_polygonGenRegionPolygonGenRegionPolygon (Operator)

Name

gen_region_polygonT_gen_region_polygonGenRegionPolygonGenRegionPolygon — Abspeichern eines Polygons als Region.

Signatur

gen_region_polygon( : Region : Rows, Columns : )

Beschreibung

gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon erzeugt eine Region aus einem Polygonzug, der durch eine Folge von Zeilen- und Spaltenkoordinaten beschrieben wird. Die erzeugte Region besteht aus den Punkten der dadurch definierten Strecken, wobei zwischen den Stützpunkten linear interpoliert wird.

Achtung

Die Region wird nicht automatisch geschlossen und nicht „aufgefüllt“.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf interner Datenebene.

Parameter

RegionRegionRegionRegionregion (output_object) region → object

Erzeugte Region.

RowsRowsRowsRowsrows (input_control) polygon.y-array → (integer)

Zeilenindizes der Stützpunkte der Regionenkontur.

Defaultwert: 100

Wertevorschläge: 0, 10, 30, 50, 100, 200, 300, 500

Typischer Wertebereich: Rows Rows Rows Rows rows (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

ColumnsColumnsColumnsColumnscolumns (input_control) polygon.x-array → (integer)

Spaltenindizes der Stützpunkte der Regionenkontur.

Parameteranzahl: Columns == Rows

Defaultwert: 100

Wertevorschläge: 0, 10, 30, 50, 100, 200, 300, 500

Typischer Wertebereich: Columns Columns Columns Columns columns (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Beispiel (HDevelop)

* Polygon-approximation
get_region_polygon(Region,7,Row,Column)
* store it as a region
gen_region_polygon(Pol,Row,Column)
* fill up the hole
fill_up(Pol,Filled)

Beispiel (C)

/* Polygon-approximation */
T_get_region_polygon(Region,7,&Row,&Column);
/* store it as a region */
T_gen_region_polygon(&Pol,Row,Column);
destroy_tuple(Row);
destroy_tuple(Column);
/* fill up the hole */
fill_up(Pol,&Filled);

Beispiel (HDevelop)

* Polygon-approximation
get_region_polygon(Region,7,Row,Column)
* store it as a region
gen_region_polygon(Pol,Row,Column)
* fill up the hole
fill_up(Pol,Filled)

Beispiel (HDevelop)

* Polygon-approximation
get_region_polygon(Region,7,Row,Column)
* store it as a region
gen_region_polygon(Pol,Row,Column)
* fill up the hole
fill_up(Pol,Filled)

Beispiel (HDevelop)

* Polygon-approximation
get_region_polygon(Region,7,Row,Column)
* store it as a region
gen_region_polygon(Pol,Row,Column)
* fill up the hole
fill_up(Pol,Filled)

Ergebnis

Falls die Stützpunkte korrekt sind, liefert gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt. Das Clipping am aktuellen Bildformat wird durch set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">) festgelegt. Wird eine leere Region erzeugt (durch das Clipping oder eine leere Eingabe), dann legt set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">) fest, ob die Region ausgegeben wird.

Vorgänger

get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygon, draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygon

Alternativen

gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRuns

Siehe auch

fill_upfill_upFillUpFillUpFillUp, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonGetRegionPolygon, draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygon

Modul

Foundation

Operatoren