ClassesClassesClassesClasses | | | | Operators

select_shape_stdselect_shape_stdSelectShapeStdselect_shape_stdSelectShapeStdSelectShapeStd (Operator)

Name

select_shape_stdselect_shape_stdSelectShapeStdselect_shape_stdSelectShapeStdSelectShapeStd — Select regions of a given shape.

Signature

select_shape_std(Regions : SelectedRegions : Shape, Percent : )

Herror select_shape_std(const Hobject Regions, Hobject* SelectedRegions, const char* Shape, double Percent)

Herror T_select_shape_std(const Hobject Regions, Hobject* SelectedRegions, const Htuple Shape, const Htuple Percent)

Herror select_shape_std(Hobject Regions, Hobject* SelectedRegions, const HTuple& Shape, const HTuple& Percent)

HRegion HRegion::SelectShapeStd(const HTuple& Shape, const HTuple& Percent) const

HRegionArray HRegionArray::SelectShapeStd(const HTuple& Shape, const HTuple& Percent) const

void SelectShapeStd(const HObject& Regions, HObject* SelectedRegions, const HTuple& Shape, const HTuple& Percent)

HRegion HRegion::SelectShapeStd(const HString& Shape, double Percent) const

HRegion HRegion::SelectShapeStd(const char* Shape, double Percent) const

void HOperatorSetX.SelectShapeStd(
[in] IHUntypedObjectX* Regions, [out] IHUntypedObjectX*SelectedRegions, [in] VARIANT Shape, [in] VARIANT Percent)

IHRegionX* HRegionX.SelectShapeStd(
[in] BSTR Shape, [in] double Percent)

static void HOperatorSet.SelectShapeStd(HObject regions, out HObject selectedRegions, HTuple shape, HTuple percent)

HRegion HRegion.SelectShapeStd(string shape, double percent)

Description

The operator select_shape_stdselect_shape_stdSelectShapeStdselect_shape_stdSelectShapeStdSelectShapeStd compares the shape of the given regions with default shapes. If the region has a similar shape it is adopted into the output. Possible values for ShapeShapeShapeShapeShapeshape are:

'max_area'

The largest region is selected.

'rectangle1'

The surrounding rectangle parallel to the coordinate axes is determined via the operator smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1. If the area difference in percent is larger than PercentPercentPercentPercentPercentpercent the region is adopted.

'rectangle2'

The smallest surrounding rectangle with any orientation is determined via the operator smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2. If the area difference in percent is larger than PercentPercentPercentPercentPercentpercent the region is adopted. Note that as a more robust alternative the operator select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape with FeatureFeatureFeatureFeatureFeaturefeature set to 'rectangularity'"rectangularity""rectangularity""rectangularity""rectangularity""rectangularity" can be used instead.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Input regions to be selected.

SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Regions with desired shape.

ShapeShapeShapeShapeShapeshape (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Shape features to be checked.

Default value: 'max_area' "max_area" "max_area" "max_area" "max_area" "max_area"

List of values: 'max_area'"max_area""max_area""max_area""max_area""max_area", 'rectangle1'"rectangle1""rectangle1""rectangle1""rectangle1""rectangle1", 'rectangle2'"rectangle2""rectangle2""rectangle2""rectangle2""rectangle2"

PercentPercentPercentPercentPercentpercent (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Similarity measure.

Default value: 70.0

Suggested values: 10.0, 30.0, 50.0, 60.0, 70.0, 80.0, 90.0, 95.0, 100.0

Typical range of values: 0.0 ≤ Percent Percent Percent Percent Percent percent ≤ 100.0 (lin)

Minimum increment: 0.1

Recommended increment: 10.0

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection, smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2

Alternatives

intersectionintersectionIntersectionintersectionIntersectionIntersection, complementcomplementComplementcomplementComplementComplement, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape

See also

smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2, rectangularityrectangularityRectangularityrectangularityRectangularityRectangularity

Module

Foundation


ClassesClassesClassesClasses | | | | Operators