gen_checker_regiongen_checker_regionGenCheckerRegiongen_checker_regionGenCheckerRegionGenCheckerRegion (Operator)

Name

gen_checker_regiongen_checker_regionGenCheckerRegiongen_checker_regionGenCheckerRegionGenCheckerRegion — Erzeugen einer schachbrettartigen Region.

Signatur

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

Beschreibung

gen_checker_regiongen_checker_regionGenCheckerRegiongen_checker_regionGenCheckerRegionGenCheckerRegion liefert eine schachbrettartige Region. Dabei gehören jeweils die schwarzen Felder des Schachbretts zur Region. Die horizontale und vertikale Ausdehnung der Region wird durch WidthRegionWidthRegionWidthRegionWidthRegionWidthRegionwidthRegion bzw. HeightRegionHeightRegionHeightRegionHeightRegionHeightRegionheightRegion begrenzt, die Größe der Felder des Schachbrettes durch WidthPatternWidthPatternWidthPatternWidthPatternWidthPatternwidthPattern * HeightPatternHeightPatternHeightPatternHeightPatternHeightPatternheightPattern.

Achtung

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

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

RegionCheckerRegionCheckerRegionCheckerRegionCheckerRegionCheckerregionChecker (output_object) region → object

Erzeugte Schachbrett-Region.

WidthRegionWidthRegionWidthRegionWidthRegionWidthRegionwidthRegion (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 widthRegion ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: WidthRegion >= 1

HeightRegionHeightRegionHeightRegionHeightRegionHeightRegionheightRegion (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 heightRegion ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: HeightRegion >= 1

WidthPatternWidthPatternWidthPatternWidthPatternWidthPatternwidthPattern (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 widthPattern ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: WidthPattern > 0 && WidthPattern < WidthRegion

HeightPatternHeightPatternHeightPatternHeightPatternHeightPatternheightPattern (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 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)

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((WidthRegionWidthRegionWidthRegionWidthRegionWidthRegionwidthRegion * HeightRegionHeightRegionHeightRegionHeightRegionHeightRegionheightRegion) / WidthPatternWidthPatternWidthPatternWidthPatternWidthPatternwidthPattern)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_checker_regiongen_checker_regionGenCheckerRegiongen_checker_regionGenCheckerRegionGenCheckerRegion 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">)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">) festgelegt.

Nachfolger

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion

Alternativen

gen_grid_regiongen_grid_regionGenGridRegiongen_grid_regionGenGridRegionGenGridRegion, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilled, gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints, gen_region_runsgen_region_runsGenRegionRunsgen_region_runsGenRegionRunsGenRegionRuns, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, concat_objconcat_objConcatObjconcat_objConcatObjConcatObj, gen_random_regiongen_random_regionGenRandomRegiongen_random_regionGenRandomRegionGenRandomRegion, gen_random_regionsgen_random_regionsGenRandomRegionsgen_random_regionsGenRandomRegionsGenRandomRegions

Siehe auch

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Modul

Foundation

Operatoren