HALCON Website / HALCON Operator-Referenz / Regionen / Generierung
KlassenKlassenKlassenKlassen | | | | Operatoren

gen_grid_regiongen_grid_regionGenGridRegiongen_grid_regionGenGridRegionGenGridRegion (Operator)

Name

gen_grid_regiongen_grid_regionGenGridRegiongen_grid_regionGenGridRegionGenGridRegion — Erzeugen einer Region aus Linien oder Punkten.

Signatur

gen_grid_region( : RegionGrid : RowSteps, ColumnSteps, Type, Width, Height : )

Herror gen_grid_region(Hobject* RegionGrid, const Hlong RowSteps, const Hlong ColumnSteps, const char* Type, const Hlong Width, const Hlong Height)

Herror T_gen_grid_region(Hobject* RegionGrid, const Htuple RowSteps, const Htuple ColumnSteps, const Htuple Type, const Htuple Width, const Htuple Height)

Herror gen_grid_region(Hobject* RegionGrid, const HTuple& RowSteps, const HTuple& ColumnSteps, const HTuple& Type, const HTuple& Width, const HTuple& Height)

HRegion HRegion::GenGridRegion(const HTuple& RowSteps, const HTuple& ColumnSteps, const HTuple& Type, const HTuple& Width, const HTuple& Height)

void GenGridRegion(HObject* RegionGrid, const HTuple& RowSteps, const HTuple& ColumnSteps, const HTuple& Type, const HTuple& Width, const HTuple& Height)

void HRegion::GenGridRegion(const HTuple& RowSteps, const HTuple& ColumnSteps, const HString& Type, Hlong Width, Hlong Height)

void HRegion::GenGridRegion(Hlong RowSteps, Hlong ColumnSteps, const HString& Type, Hlong Width, Hlong Height)

void HRegion::GenGridRegion(Hlong RowSteps, Hlong ColumnSteps, const char* Type, Hlong Width, Hlong Height)

void HOperatorSetX.GenGridRegion(
[out] IHUntypedObjectX** RegionGrid, [in] VARIANT RowSteps, [in] VARIANT ColumnSteps, [in] VARIANT Type, [in] VARIANT Width, [in] VARIANT Height)

void HRegionX.GenGridRegion(
[in] VARIANT RowSteps, [in] VARIANT ColumnSteps, [in] BSTR Type, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.GenGridRegion(out HObject regionGrid, HTuple rowSteps, HTuple columnSteps, HTuple type, HTuple width, HTuple height)

void HRegion.GenGridRegion(HTuple rowSteps, HTuple columnSteps, string type, int width, int height)

void HRegion.GenGridRegion(int rowSteps, int columnSteps, string type, int width, int height)

Beschreibung

gen_grid_regiongen_grid_regionGenGridRegiongen_grid_regionGenGridRegionGenGridRegion erzeugt ein Raster, das aus Linien (TypeTypeTypeTypeTypetype = 'lines') oder Punkten (TypeTypeTypeTypeTypetype = 'points') aufgebaut ist. Bei 'lines' werden durchgezogene Linien bei 'points' nur die Schnittpunkte der Linien ausgegeben. Ausgehend von dem Punkt (0,0) bis zum Punkt (HeightHeightHeightHeightHeightheight-1,WidthWidthWidthWidthWidthwidth-1) wird das Raster in der Schrittweite RowStepsRowStepsRowStepsRowStepsRowStepsrowSteps in Zeilenrichtung und ColumnStepsColumnStepsColumnStepsColumnStepsColumnStepscolumnSteps in Spaltenrichtung aufgebaut. Im Modus 'lines' kann RowStepsRowStepsRowStepsRowStepsRowStepsrowSteps bzw. ColumnStepsColumnStepsColumnStepsColumnStepsColumnStepscolumnSteps auf Null gesetzt werden. In diesem Fall werden nur Spalten bzw. Zeilen erzeugt.

Achtung

Wird das Muster sehr klein gewählt (RowStepsRowStepsRowStepsRowStepsRowStepsrowSteps < 4 or ColumnStepsColumnStepsColumnStepsColumnStepsColumnStepscolumnSteps < 4), so benötigt die erzeugte Region viel Speicher.

Im Modus 'points' dürfen RowStepsRowStepsRowStepsRowStepsRowStepsrowSteps und ColumnStepsColumnStepsColumnStepsColumnStepsColumnStepscolumnSteps nicht auf Null gesetzt werden.

Parallelisierung

Parameter

RegionGridRegionGridRegionGridRegionGridRegionGridregionGrid (output_object)  region → objectHRegionHRegionHRegionHRegionXHobject *

Erzeugte Linien/Punkte-Region.

RowStepsRowStepsRowStepsRowStepsRowStepsrowSteps (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Schrittweite in Zeilenrichtung oder Null.

Defaultwert: 10

Wertevorschläge: 0, 2, 3, 4, 5, 7, 10, 15, 20, 30, 50, 100

Typischer Wertebereich: 0 ≤ RowSteps RowSteps RowSteps RowSteps RowSteps rowSteps ≤ 512 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: RowSteps > 1 || RowSteps == 0

ColumnStepsColumnStepsColumnStepsColumnStepsColumnStepscolumnSteps (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Schrittweite in Spaltenrichtung oder Null.

Defaultwert: 10

Wertevorschläge: 0, 2, 3, 4, 5, 7, 10, 15, 20, 30, 50, 100

Typischer Wertebereich: 0 ≤ ColumnSteps ColumnSteps ColumnSteps ColumnSteps ColumnSteps columnSteps ≤ 512 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: ColumnSteps > 1 || ColumnSteps == 0

TypeTypeTypeTypeTypetype (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Art des erzeugten Musters.

Defaultwert: 'lines' "lines" "lines" "lines" "lines" "lines"

Werteliste: 'lines'"lines""lines""lines""lines""lines", 'points'"points""points""points""points""points"

WidthWidthWidthWidthWidthwidth (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximale Breite des Musters.

Defaultwert: 512

Wertevorschläge: 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Width Width Width Width Width width ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Width >= 1

HeightHeightHeightHeightHeightheight (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximale Höhe des Musters.

Defaultwert: 512

Wertevorschläge: 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Height Height Height Height Height height ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Height >= 1

Beispiel (HDevelop)

read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)

Beispiel (C)

read_image(&Image,"fabrik");
gen_grid_region(&Raster,10,10,"lines",512,512);
reduce_domain(Image,Raster,&Mask);
sobel_amp(Mask,GridSobel,"sum_abs",3);
disp_image(GridSobel,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)

Beispiel (HDevelop)

read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)

Beispiel (HDevelop)

read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)

Beispiel (HDevelop)

read_image(Image,'fabrik')
gen_grid_region(Raster,10,10,'lines',512,512)
reduce_domain(Image,Raster,Mask)
sobel_amp(Mask,GridSobel,'sum_abs',3)
dev_display(GridSobel)

Komplexität

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

O((ImageWidth / ColumnSteps) * (ImageHeight / RowSteps))

Ergebnis

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

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion

Alternativen

gen_region_linegen_region_lineGenRegionLinegen_region_lineGenRegionLineGenRegionLine, gen_region_polygongen_region_polygonGenRegionPolygongen_region_polygonGenRegionPolygonGenRegionPolygon, gen_region_pointsgen_region_pointsGenRegionPointsgen_region_pointsGenRegionPointsGenRegionPoints, gen_region_runsgen_region_runsGenRegionRunsgen_region_runsGenRegionRunsGenRegionRuns

Siehe auch

gen_checker_regiongen_checker_regionGenCheckerRegiongen_checker_regionGenCheckerRegionGenCheckerRegion, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH