HALCON Website / HALCON Operator Reference / Regions / Creation
ClassesClassesClassesClasses | | | | Operators

gen_random_regionsgen_random_regionsGenRandomRegionsgen_random_regionsGenRandomRegionsGenRandomRegions (Operator)

Name

gen_random_regionsgen_random_regionsGenRandomRegionsgen_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)

Herror 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)

HRegionArray HRegionArray::GenRandomRegions(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 HOperatorSetX.GenRandomRegions(
[out] IHUntypedObjectX** Regions, [in] VARIANT Type, [in] VARIANT WidthMin, [in] VARIANT WidthMax, [in] VARIANT HeightMin, [in] VARIANT HeightMax, [in] VARIANT PhiMin, [in] VARIANT PhiMax, [in] VARIANT NumRegions, [in] VARIANT Width, [in] VARIANT Height)

void HRegionX.GenRandomRegions(
[in] BSTR Type, [in] VARIANT WidthMin, [in] VARIANT WidthMax, [in] VARIANT HeightMin, [in] VARIANT HeightMax, [in] VARIANT PhiMin, [in] VARIANT PhiMax, [in] Hlong NumRegions, [in] Hlong Width, [in] Hlong Height)

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_regionsGenRandomRegionsgen_random_regionsGenRandomRegionsGenRandomRegions 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 NumRegionsNumRegionsNumRegionsNumRegionsNumRegionsnumRegions indicates how many regions shall be created.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (output_object)  region-array → objectHRegionHRegionHRegionArrayHRegionXHobject *

Created regions.

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

Type of regions to be created.

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

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

WidthMinWidthMinWidthMinWidthMinWidthMinwidthMin (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 widthMin ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: WidthMin > 0

WidthMaxWidthMaxWidthMaxWidthMaxWidthMaxwidthMax (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 widthMax ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: WidthMax > 0

HeightMinHeightMinHeightMinHeightMinHeightMinheightMin (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 heightMin ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: HeightMin > 0

HeightMaxHeightMaxHeightMaxHeightMaxHeightMaxheightMax (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 heightMax ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Restriction: HeightMax > 0

PhiMinPhiMinPhiMinPhiMinPhiMinphiMin (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 phiMin ≤ 6.28 (lin)

Minimum increment: 0.001

Recommended increment: 0.10

Restriction: PhiMin > 0

PhiMaxPhiMaxPhiMaxPhiMaxPhiMaxphiMax (input_control)  number → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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 phiMax ≤ 6.28 (lin)

Minimum increment: 0.001

Recommended increment: 0.10

Restriction: PhiMax > 0

NumRegionsNumRegionsNumRegionsNumRegionsNumRegionsnumRegions (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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 numRegions ≤ 2000 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: NumRegions > 0

WidthWidthWidthWidthWidthwidth (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum horizontal expansion.

Default value: 512

Suggested values: 128, 256, 512, 1024

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

Minimum increment: 1

Recommended increment: 10

Restriction: Width > 0

HeightHeightHeightHeightHeightheight (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Maximum vertical expansion.

Default value: 512

Suggested values: 128, 256, 512, 1024

Typical range of values: 1 ≤ Height 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_regionsGenRandomRegionsgen_random_regionsGenRandomRegionsGenRandomRegions 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">)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">).

Possible Successors

paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH