gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegion (Operator)

Name

gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegion — Erzeugen einer schachbrettartigen Region.

Signatur

gen_checker_region( : RegionChecker : WidthRegion, HeightRegion, WidthPattern, HeightPattern : )

Beschreibung

gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegionGenCheckerRegion liefert eine schachbrettartige Region. Dabei gehören jeweils die schwarzen Felder des Schachbretts zur Region. Die horizontale und vertikale Ausdehnung der Region wird durch WidthRegionWidthRegionWidthRegionWidthRegionwidthRegion bzw. HeightRegionHeightRegionHeightRegionHeightRegionheightRegion begrenzt, die Größe der Felder des Schachbrettes durch WidthPatternWidthPatternWidthPatternWidthPatternwidthPattern * HeightPatternHeightPatternHeightPatternHeightPatternheightPattern.

Achtung

Wird das Muster sehr klein gewählt (WidthPatternWidthPatternWidthPatternWidthPatternwidthPattern < 4) und die Begrenzung groß, so benötigt die erzeugte Region viel Speicher.

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

RegionCheckerRegionCheckerRegionCheckerRegionCheckerregionChecker (output_object) region → object

Erzeugte Schachbrett-Region.

WidthRegionWidthRegionWidthRegionWidthRegionwidthRegion (input_control) extent.x → (integer)

Größter auftretender x-Wert der Region.

Defaultwert: 511

Wertevorschläge: 10, 20, 31, 63, 127, 255, 300, 400, 511

Typischer Wertebereich: 1 ≤ WidthRegion WidthRegion WidthRegion WidthRegion widthRegion ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: WidthRegion >= 1

HeightRegionHeightRegionHeightRegionHeightRegionheightRegion (input_control) extent.y → (integer)

Größter auftretender y-Wert der Region.

Defaultwert: 511

Wertevorschläge: 10, 20, 31, 63, 127, 255, 300, 400, 511

Typischer Wertebereich: 1 ≤ HeightRegion HeightRegion HeightRegion HeightRegion heightRegion ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: HeightRegion >= 1

WidthPatternWidthPatternWidthPatternWidthPatternwidthPattern (input_control) extent.x → (integer)

Breite eines Feldes des Schachbrettes.

Defaultwert: 64

Wertevorschläge: 1, 2, 4, 8, 16, 20, 32, 64, 100, 128, 200, 300, 500

Typischer Wertebereich: 1 ≤ WidthPattern WidthPattern WidthPattern WidthPattern widthPattern ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: WidthPattern > 0 && WidthPattern < WidthRegion

HeightPatternHeightPatternHeightPatternHeightPatternheightPattern (input_control) extent.y → (integer)

Höhe eines Feldes des Schachbrettes.

Defaultwert: 64

Wertevorschläge: 1, 2, 4, 8, 16, 20, 32, 64, 100, 128, 200, 300, 500

Typischer Wertebereich: 1 ≤ HeightPattern HeightPattern HeightPattern HeightPattern heightPattern ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: HeightPattern > 0 && HeightPattern < HeightRegion

Beispiel (HDevelop)

gen_checker_region(Checker,512,512,32,64)
dev_set_draw('fill')
dev_display (Checker)

Beispiel (C)

gen_checker_region(&Checker,512,512,32,64);
set_draw(WindowHandle,"fill");
set_part(WindowHandle,0,0,511,511);
disp_region(Checker,WindowHandle);

Beispiel (HDevelop)

gen_checker_region(Checker,512,512,32,64)
dev_set_draw('fill')
dev_display (Checker)

Beispiel (HDevelop)

gen_checker_region(Checker,512,512,32,64)
dev_set_draw('fill')
dev_display (Checker)

Beispiel (HDevelop)

gen_checker_region(Checker,512,512,32,64)
dev_set_draw('fill')
dev_display (Checker)

Komplexität

Der benötigte Speicher (in Byte) für die Region ist:

O((WidthRegionWidthRegionWidthRegionWidthRegionwidthRegion * HeightRegionHeightRegionHeightRegionHeightRegionheightRegion) / WidthPatternWidthPatternWidthPatternWidthPatternwidthPattern)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegionGenCheckerRegion 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.

Nachfolger

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion

Alternativen

gen_grid_regiongen_grid_regionGenGridRegionGenGridRegionGenGridRegion, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, gen_region_runsgen_region_runsGenRegionRunsGenRegionRunsGenRegionRuns, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, concat_objconcat_objConcatObjConcatObjConcatObj, gen_random_regiongen_random_regionGenRandomRegionGenRandomRegionGenRandomRegion, gen_random_regionsgen_random_regionsGenRandomRegionsGenRandomRegionsGenRandomRegions

Siehe auch

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Modul

Foundation

Operatoren