HALCON 20.05.0.0 / HALCON Operator Reference / Regions / Creation
ClassesClasses | | Operators

gen_random_regionsgen_random_regionsGenRandomRegionsGenRandomRegions (Operator)

Name

gen_random_regionsgen_random_regionsGenRandomRegionsGenRandomRegions — Create random regions like circles, rectangles and ellipses.

Signature

gen_random_regions( : Regions : Type, WidthMin, WidthMax, HeightMin, HeightMax, PhiMin, PhiMax, NumRegions, Width, Height : )

Herror gen_random_regions(Hobject* Regions, const char* Type, double WidthMin, double WidthMax, double HeightMin, double HeightMax, double PhiMin, double PhiMax, const Hlong NumRegions, const Hlong Width, const Hlong Height)

Herror T_gen_random_regions(Hobject* Regions, const Htuple Type, const Htuple WidthMin, const Htuple WidthMax, const Htuple HeightMin, const Htuple HeightMax, const Htuple PhiMin, const Htuple PhiMax, const Htuple NumRegions, const Htuple Width, const Htuple Height)

void GenRandomRegions(HObject* Regions, const HTuple& Type, const HTuple& WidthMin, const HTuple& WidthMax, const HTuple& HeightMin, const HTuple& HeightMax, const HTuple& PhiMin, const HTuple& PhiMax, const HTuple& NumRegions, const HTuple& Width, const HTuple& Height)

void HRegion::GenRandomRegions(const HString& Type, const HTuple& WidthMin, const HTuple& WidthMax, const HTuple& HeightMin, const HTuple& HeightMax, const HTuple& PhiMin, const HTuple& PhiMax, Hlong NumRegions, Hlong Width, Hlong Height)

void HRegion::GenRandomRegions(const HString& Type, double WidthMin, double WidthMax, double HeightMin, double HeightMax, double PhiMin, double PhiMax, Hlong NumRegions, Hlong Width, Hlong Height)

void HRegion::GenRandomRegions(const char* Type, double WidthMin, double WidthMax, double HeightMin, double HeightMax, double PhiMin, double PhiMax, Hlong NumRegions, Hlong Width, Hlong Height)

void HRegion::GenRandomRegions(const wchar_t* Type, double WidthMin, double WidthMax, double HeightMin, double HeightMax, double PhiMin, double PhiMax, Hlong NumRegions, Hlong Width, Hlong Height)   (Windows only)

static void HOperatorSet.GenRandomRegions(out HObject regions, HTuple type, HTuple widthMin, HTuple widthMax, HTuple heightMin, HTuple heightMax, HTuple phiMin, HTuple phiMax, HTuple numRegions, HTuple width, HTuple height)

void HRegion.GenRandomRegions(string type, HTuple widthMin, HTuple widthMax, HTuple heightMin, HTuple heightMax, HTuple phiMin, HTuple phiMax, int numRegions, int width, int height)

void HRegion.GenRandomRegions(string type, double widthMin, double widthMax, double heightMin, double heightMax, double phiMin, double phiMax, int numRegions, int width, int height)

Description

The operator gen_random_regionsgen_random_regionsGenRandomRegionsGenRandomRegionsGenRandomRegions generates circles, rectangles and ellipses whose parameters are determined at random. In each case only one lower, upper limit respectively, is given. The position is always random and cannot be determined by parameters. The parameter NumRegionsNumRegionsNumRegionsNumRegionsnumRegions indicates how many regions shall be created.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionHobject *

Created regions.

TypeTypeTypeTypetype (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Type of regions to be created.

Default value: 'circle' "circle" "circle" "circle" "circle"

List of values: 'circle'"circle""circle""circle""circle", 'ellipse'"ellipse""ellipse""ellipse""ellipse", 'rectangle1'"rectangle1""rectangle1""rectangle1""rectangle1", 'rectangle2'"rectangle2""rectangle2""rectangle2""rectangle2", 'ring'"ring""ring""ring""ring"

WidthMinWidthMinWidthMinWidthMinwidthMin (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimum width of the region.

Default value: 10.0

Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0

Typical range of values: 1.0 ≤ WidthMin WidthMin WidthMin WidthMin widthMin ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: WidthMin > 0

WidthMaxWidthMaxWidthMaxWidthMaxwidthMax (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum width of the region.

Default value: 20.0

Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0

Typical range of values: 1.0 ≤ WidthMax WidthMax WidthMax WidthMax widthMax ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: WidthMax > 0

HeightMinHeightMinHeightMinHeightMinheightMin (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimum height of the region.

Default value: 10.0

Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0

Typical range of values: 1.0 ≤ HeightMin HeightMin HeightMin HeightMin heightMin ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: HeightMin > 0

HeightMaxHeightMaxHeightMaxHeightMaxheightMax (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum height of the region.

Default value: 30.0

Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0

Typical range of values: 1.0 ≤ HeightMax HeightMax HeightMax HeightMax heightMax ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: HeightMax > 0

PhiMinPhiMinPhiMinPhiMinphiMin (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimum rotation angle of the region.

Default value: -0.7854

Suggested values: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5

Typical range of values: 0.0 ≤ PhiMin PhiMin PhiMin PhiMin phiMin ≤ 6.28 (lin)

Restriction: PhiMin > 0

PhiMaxPhiMaxPhiMaxPhiMaxphiMax (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum rotation angle of the region.

Default value: 0.7854

Suggested values: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5

Typical range of values: 0.0 ≤ PhiMax PhiMax PhiMax PhiMax phiMax ≤ 6.28 (lin)

Restriction: PhiMax > 0

NumRegionsNumRegionsNumRegionsNumRegionsnumRegions (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of regions.

Default value: 100

Suggested values: 1, 5, 20, 100, 200, 500, 1000, 2000

Typical range of values: 1 ≤ NumRegions NumRegions NumRegions NumRegions numRegions ≤ 2000 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: NumRegions > 0

WidthWidthWidthWidthwidth (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximum horizontal expansion.

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Width Width Width Width width ≤ 1024 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Width > 0

HeightHeightHeightHeightheight (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximum vertical expansion.

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Height Height Height Height height ≤ 1024 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Height > 0

Result

If the parameter values are correct gen_random_regionsgen_random_regionsGenRandomRegionsGenRandomRegionsGenRandomRegions returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised. The clipping according to the current image format is determined by the operator 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">).

Possible Successors

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 20.05.0.0 Copyright © 1996-2020 MVTec Software GmbH