ClassesClassesClassesClasses | | | | Operators

find_rectification_gridfind_rectification_gridFindRectificationGridfind_rectification_gridFindRectificationGridFindRectificationGrid (Operator)

Name

find_rectification_gridfind_rectification_gridFindRectificationGridfind_rectification_gridFindRectificationGridFindRectificationGrid — Segment the rectification grid region in the image.

Signature

find_rectification_grid(Image : GridRegion : MinContrast, Radius : )

Herror find_rectification_grid(const Hobject Image, Hobject* GridRegion, double MinContrast, double Radius)

Herror T_find_rectification_grid(const Hobject Image, Hobject* GridRegion, const Htuple MinContrast, const Htuple Radius)

Herror find_rectification_grid(Hobject Image, Hobject* GridRegion, const HTuple& MinContrast, const HTuple& Radius)

HRegion HImage::FindRectificationGrid(const HTuple& MinContrast, const HTuple& Radius) const

void FindRectificationGrid(const HObject& Image, HObject* GridRegion, const HTuple& MinContrast, const HTuple& Radius)

HRegion HImage::FindRectificationGrid(const HTuple& MinContrast, const HTuple& Radius) const

HRegion HImage::FindRectificationGrid(double MinContrast, double Radius) const

void HOperatorSetX.FindRectificationGrid(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*GridRegion, [in] VARIANT MinContrast, [in] VARIANT Radius)

IHRegionX* HImageX.FindRectificationGrid(
[in] VARIANT MinContrast, [in] VARIANT Radius)

static void HOperatorSet.FindRectificationGrid(HObject image, out HObject gridRegion, HTuple minContrast, HTuple radius)

HRegion HImage.FindRectificationGrid(HTuple minContrast, HTuple radius)

HRegion HImage.FindRectificationGrid(double minContrast, double radius)

Description

find_rectification_gridfind_rectification_gridFindRectificationGridfind_rectification_gridFindRectificationGridFindRectificationGrid searches in the image ImageImageImageImageImageimage for image parts that contain the rectification grid and returns them in the region GridRegionGridRegionGridRegionGridRegionGridRegiongridRegion. To do so, essentially image areas with a contrast of at least MinContrastMinContrastMinContrastMinContrastMinContrastminContrast are extracted and the holes in these areas are filled up. Then, an opening with the radius RadiusRadiusRadiusRadiusRadiusradius is applied to these areas to eliminate smaller areas of high contrast.

During grid-rectification, a careful reduction of the input region to those image parts that actually contain the rectification grid is useful for two purposes: First, the computing time can be reduced and secondly, saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPix and connect_grid_pointsconnect_grid_pointsConnectGridPointsconnect_grid_pointsConnectGridPointsConnectGridPoints can be prevented from detecting false grid points and connecting lines.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / uint2)

Input image.

GridRegionGridRegionGridRegionGridRegionGridRegiongridRegion (output_object)  region objectHRegionHRegionHRegionHRegionXHobject *

Output region containing the rectification grid.

MinContrastMinContrastMinContrastMinContrastMinContrastminContrast (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Minimum contrast.

Default value: 8.0

Suggested values: 2.0, 4.0, 8.0, 16.0, 32.0

Restriction: MinContrast >= 0

RadiusRadiusRadiusRadiusRadiusradius (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of the circular structuring element.

Default value: 7.5

Suggested values: 1.5, 2.5, 3.5, 4.5, 5.5, 7.5, 9.5, 12.5, 15.5, 19.5, 25.5, 33.5, 45.5, 60.5, 110.5

Restriction: Radius >= 0.5

Example (HDevelop)

find_rectification_grid (Image, GridRegion, 8, 10)
dilation_circle (GridRegion, GridRegionDilated, 5.5)
reduce_domain (Image, GridRegionDilated, ImageReduced)
saddle_points_sub_pix (ImageReduced, 'facet', 1.5, 5, Row, Column)
connect_grid_points (ImageReduced, ConnectingLines, Row, Column, 1.1, 5.5)
gen_grid_rectification_map (ImageReduced, ConnectingLines, Map, Meshes, 20, \
                            'auto', Row, Column, 'bilinear')
map_image (Image, Map, ImageMapped)

Result

find_rectification_gridfind_rectification_gridFindRectificationGridfind_rectification_gridFindRectificationGridFindRectificationGrid returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Possible Successors

dilation_circledilation_circleDilationCircledilation_circleDilationCircleDilationCircle, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Module

Calibration


ClassesClassesClassesClasses | | | | Operators