ClassesClassesClassesClasses | | | | Operators

partition_linesT_partition_linesPartitionLinespartition_linesPartitionLinesPartitionLines (Operator)

Name

partition_linesT_partition_linesPartitionLinespartition_linesPartitionLinesPartitionLines — Partition lines according to various criteria.

Signature

partition_lines( : : RowBeginIn, ColBeginIn, RowEndIn, ColEndIn, Feature, Operation, Min, Max : RowBeginOut, ColBeginOut, RowEndOut, ColEndOut, FailRowBOut, FailColBOut, FailRowEOut, FailColEOut)

Herror T_partition_lines(const Htuple RowBeginIn, const Htuple ColBeginIn, const Htuple RowEndIn, const Htuple ColEndIn, const Htuple Feature, const Htuple Operation, const Htuple Min, const Htuple Max, Htuple* RowBeginOut, Htuple* ColBeginOut, Htuple* RowEndOut, Htuple* ColEndOut, Htuple* FailRowBOut, Htuple* FailColBOut, Htuple* FailRowEOut, Htuple* FailColEOut)

Herror partition_lines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HTuple& Feature, const HTuple& Operation, const HTuple& Min, const HTuple& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut, HTuple* FailRowBOut, HTuple* FailColBOut, HTuple* FailRowEOut, HTuple* FailColEOut)

void PartitionLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HTuple& Feature, const HTuple& Operation, const HTuple& Min, const HTuple& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut, HTuple* FailRowBOut, HTuple* FailColBOut, HTuple* FailRowEOut, HTuple* FailColEOut)

static void HMisc::PartitionLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HTuple& Feature, const HString& Operation, const HTuple& Min, const HTuple& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut, HTuple* FailRowBOut, HTuple* FailColBOut, HTuple* FailRowEOut, HTuple* FailColEOut)

static void HMisc::PartitionLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const HString& Feature, const HString& Operation, const HString& Min, const HString& Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut, HTuple* FailRowBOut, HTuple* FailColBOut, HTuple* FailRowEOut, HTuple* FailColEOut)

static void HMisc::PartitionLines(const HTuple& RowBeginIn, const HTuple& ColBeginIn, const HTuple& RowEndIn, const HTuple& ColEndIn, const char* Feature, const char* Operation, const char* Min, const char* Max, HTuple* RowBeginOut, HTuple* ColBeginOut, HTuple* RowEndOut, HTuple* ColEndOut, HTuple* FailRowBOut, HTuple* FailColBOut, HTuple* FailRowEOut, HTuple* FailColEOut)

void HOperatorSetX.PartitionLines(
[in] VARIANT RowBeginIn, [in] VARIANT ColBeginIn, [in] VARIANT RowEndIn, [in] VARIANT ColEndIn, [in] VARIANT Feature, [in] VARIANT Operation, [in] VARIANT Min, [in] VARIANT Max, [out] VARIANT* RowBeginOut, [out] VARIANT* ColBeginOut, [out] VARIANT* RowEndOut, [out] VARIANT* ColEndOut, [out] VARIANT* FailRowBOut, [out] VARIANT* FailColBOut, [out] VARIANT* FailRowEOut, [out] VARIANT* FailColEOut)

VARIANT HMiscX.PartitionLines(
[in] VARIANT RowBeginIn, [in] VARIANT ColBeginIn, [in] VARIANT RowEndIn, [in] VARIANT ColEndIn, [in] VARIANT Feature, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max, [out] VARIANT* ColBeginOut, [out] VARIANT* RowEndOut, [out] VARIANT* ColEndOut, [out] VARIANT* FailRowBOut, [out] VARIANT* FailColBOut, [out] VARIANT* FailRowEOut, [out] VARIANT* FailColEOut)

static void HOperatorSet.PartitionLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, HTuple feature, HTuple operation, HTuple min, HTuple max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut, out HTuple failRowBOut, out HTuple failColBOut, out HTuple failRowEOut, out HTuple failColEOut)

static void HMisc.PartitionLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, HTuple feature, string operation, HTuple min, HTuple max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut, out HTuple failRowBOut, out HTuple failColBOut, out HTuple failRowEOut, out HTuple failColEOut)

static void HMisc.PartitionLines(HTuple rowBeginIn, HTuple colBeginIn, HTuple rowEndIn, HTuple colEndIn, string feature, string operation, string min, string max, out HTuple rowBeginOut, out HTuple colBeginOut, out HTuple rowEndOut, out HTuple colEndOut, out HTuple failRowBOut, out HTuple failColBOut, out HTuple failRowEOut, out HTuple failColEOut)

Description

The operator partition_linespartition_linesPartitionLinespartition_linesPartitionLinesPartitionLines divides lines into two sets according to various criteria. For each input line the indicated features (FeatureFeatureFeatureFeatureFeaturefeature) are calculated. If each (OperationOperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationOperationoperation = 'or') of the calculated features is within the given limits (MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax) the line is transferred into the first set (parameters RowBeginOutRowBeginOutRowBeginOutRowBeginOutRowBeginOutrowBeginOut to ColEndOutColEndOutColEndOutColEndOutColEndOutcolEndOut), otherwise into the second set (parameters FailRowBOutFailRowBOutFailRowBOutFailRowBOutFailRowBOutfailRowBOut to FailColEOutFailColEOutFailColEOutFailColEOutFailColEOutfailColEOut).

Condition:   Min_i <= Feature_i(Line) <= Max_i

Possible values for FeatureFeatureFeatureFeatureFeaturefeature:

'length'

(Euclidean) length of the line

'row'

Line index of the center

'column'

Column index of the center

'phi'

Orientation of the line (-pi/2 < phi <= pi/2)

Attention

If only one feature is used the value of OperationOperationOperationOperationOperationoperation is meaningless. Several features are processed according to the sequence in which they are passed.

Parallelization

Parameters

RowBeginInRowBeginInRowBeginInRowBeginInRowBeginInrowBeginIn (input_control)  line.begin.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points of the input lines.

ColBeginInColBeginInColBeginInColBeginInColBeginIncolBeginIn (input_control)  line.begin.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points of the input lines.

RowEndInRowEndInRowEndInRowEndInRowEndInrowEndIn (input_control)  line.end.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the ending points of the input lines.

ColEndInColEndInColEndInColEndInColEndIncolEndIn (input_control)  line.end.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the ending points of the input lines.

FeatureFeatureFeatureFeatureFeaturefeature (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Features to be used for selection.

List of values: 'column'"column""column""column""column""column", 'length'"length""length""length""length""length", 'phi'"phi""phi""phi""phi""phi", 'row'"row""row""row""row""row"

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

Desired combination of the features.

List of values: 'and'"and""and""and""and""and", 'or'"or""or""or""or""or"

MinMinMinMinMinmin (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Lower limits of the features or 'min'.

Default value: 'min' "min" "min" "min" "min" "min"

MaxMaxMaxMaxMaxmax (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)

Upper limits of the features or 'max'.

Default value: 'max' "max" "max" "max" "max" "max"

RowBeginOutRowBeginOutRowBeginOutRowBeginOutRowBeginOutrowBeginOut (output_control)  line.begin.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points of the lines fulfilling the conditions.

ColBeginOutColBeginOutColBeginOutColBeginOutColBeginOutcolBeginOut (output_control)  line.begin.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points of the lines fulfilling the conditions.

RowEndOutRowEndOutRowEndOutRowEndOutRowEndOutrowEndOut (output_control)  line.end.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the ending points of the lines fulfilling the conditions.

ColEndOutColEndOutColEndOutColEndOutColEndOutcolEndOut (output_control)  line.begin.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the ending points of the lines fulfilling the conditions.

FailRowBOutFailRowBOutFailRowBOutFailRowBOutFailRowBOutfailRowBOut (output_control)  line.begin.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the starting points of the lines not fulfilling the conditions.

FailColBOutFailColBOutFailColBOutFailColBOutFailColBOutfailColBOut (output_control)  line.begin.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the starting points of the lines not fulfilling the conditions.

FailRowEOutFailRowEOutFailRowEOutFailRowEOutFailRowEOutfailRowEOut (output_control)  line.end.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Row coordinates of the ending points of the lines not fulfilling the conditions.

FailColEOutFailColEOutFailColEOutFailColEOutFailColEOutfailColEOut (output_control)  line.end.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column coordinates of the ending points of the lines not fulfilling the conditions.

Result

The operator partition_linespartition_linesPartitionLinespartition_linesPartitionLinesPartitionLines returns the value 2 (H_MSG_TRUE) if the parameter values are correct. Otherwise an exception is raised.

Possible Predecessors

sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, edges_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage, thresholdthresholdThresholdthresholdThresholdThreshold, hysteresis_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold, split_skeleton_regionsplit_skeleton_regionSplitSkeletonRegionsplit_skeleton_regionSplitSkeletonRegionSplitSkeletonRegion, split_skeleton_linessplit_skeleton_linesSplitSkeletonLinessplit_skeleton_linesSplitSkeletonLinesSplitSkeletonLines

Possible Successors

set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, disp_linedisp_lineDispLinedisp_lineDispLineDispLine

Alternatives

line_orientationline_orientationLineOrientationline_orientationLineOrientationLineOrientation, line_positionline_positionLinePositionline_positionLinePositionLinePosition, select_linesselect_linesSelectLinesselect_linesSelectLinesSelectLines, select_lines_longestselect_lines_longestSelectLinesLongestselect_lines_longestSelectLinesLongestSelectLinesLongest

See also

select_linesselect_linesSelectLinesselect_linesSelectLinesSelectLines, select_lines_longestselect_lines_longestSelectLinesLongestselect_lines_longestSelectLinesLongestSelectLinesLongest, detect_edge_segmentsdetect_edge_segmentsDetectEdgeSegmentsdetect_edge_segmentsDetectEdgeSegmentsDetectEdgeSegments, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape

Module

Foundation


ClassesClassesClassesClasses | | | | Operators