Herror ::gen_region_line (
    Hobject *RegionLines,
    const HTuple &BeginRow,
    const HTuple &BeginCol,
    const HTuple &EndRow,
    const HTuple &EndCol
)
HRegion HRegion::GenRegionLine (
    const HTuple &BeginRow,
    const HTuple &BeginCol,
    const HTuple &EndRow,
    const HTuple &EndCol
)
HRegionArray HRegionArray::GenRegionLine (
    const HTuple &BeginRow,
    const HTuple &BeginCol,
    const HTuple &EndRow,
    const HTuple &EndCol
)

Store input lines as regions.

The operator ::gen_region_line stores the given lines (with starting point [BeginRow,BeginCol] and ending point [EndRow, EndCol]) as region.

Parameters

RegionLines (output_object)
 region(-array) -> Hobject * : HRegion(Array)
Created regions.

BeginRow (input_control)
 line.begin.y(-array) -> HTuple.long
Line coordinates of the starting points of the input lines.
Default value: 100
Suggested values: 10, 50, 100, 200, 300, 400
Typical range of values: 0 <= BeginRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

BeginCol (input_control)
 line.begin.x(-array) -> HTuple.long
Column coordinates of the starting points of the input lines.
Default value: 50
Suggested values: 10, 50, 100, 200, 300, 400
Typical range of values: 0 <= BeginCol <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

EndRow (input_control)
 line.end.y(-array) -> HTuple.long
Line coordinates of the ending points of the input lines.
Default value: 150
Suggested values: 50, 100, 200, 300, 400, 500
Typical range of values: 0 <= EndRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

EndCol (input_control)
 line.end.x(-array) -> HTuple.long
Column coordinates of the ending points of the input lines.
Default value: 250
Suggested values: 50, 100, 200, 300, 400, 500
Typical range of values: 0 <= EndCol <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Result

The operator ::gen_region_line always returns the value H_MSG_TRUE. The clipping according to the current image format is determined by the operator ::set_system('clip_region',<'true'/'false'>).

Possible Predecessors

::split_skeleton_lines

Alternatives

::gen_region_hline

Module

Region processing

Copyright © 1996-2002 MVTec Software GmbH