| Table of Contents / Tools / Grid Rectification | Operators |
gen_arbitrary_distortion_map — Generate a projection map that describes the mapping between an arbitrarily distorted image and the rectified image.
gen_arbitrary_distortion_map( : Map : GridSpacing, Row, Col, GridWidth, ImageWidth, ImageHeight, MapType : )
gen_arbitrary_distortion_map computes the mapping Map between an arbitrarily distorted image and the rectified image. Assuming that the points (Row,Col) form a regular grid in the rectified image, each grid cell, which is defined by the coordinates (Row,Col) of its four corners in the distorted image, is projected onto a square of GridSpacing x GridSpacing pixels. The coordinates of the grid points must be passed line by line in Row and Col. GridWidth is the width of the point grid in grid points. To compute the mapping Map, additionally the width ImageWidth and height ImageHeight of the images to be rectified must be passed.
MapType is used to specify the type of the output Map. If 'bilinear' interpolation is chosen, Map consists of one image containing five channels. In the first channel for each pixel in the resulting image the linearized coordinates of the pixel in the input image is stored that is in the upper left position relative to the transformed coordinates. The four other channels contain the weights of the four neighboring pixels of the transformed coordinates which are used for the bilinear interpolation, in the following order:
+---+---+ | 2 | 3 | +---+---+ | 4 | 5 | +---+---+
The second channel, for example, contains the weights of the pixels that lie to the upper left relative to the transformed coordinates. If 'coordinate_map_sub_pix' is chosen, Map consists of one vector field image, in which for each pixel of the resulting image the subpixel precise coordinates in the input image are stored.
In contrary to gen_grid_rectification_map, gen_arbitrary_distortion_map is used when the coordinates (Row,Col) of the grid points in the distorted image are already known or the relevant part of the image consist of regular grid structures, which the coordinates can be derived from.
If you want to re-use the created map in another program, you can save it as a multi-channel image with the operator write_image, using the format 'tiff'.
Image containing the mapping data.
Distance of the grid points in the rectified image.
Restriction: GridSpacing > 0
Row coordinates of the grid points in the distorted image.
Column coordinates of the grid points in the distorted image.
Restriction: number(Row) == number(Col)
Width of the point grid (number of grid points).
Width of the images to be rectified.
Restriction: ImageWidth > 0
Height of the images to be rectified.
Restriction: ImageHeight > 0
Type of mapping.
Default value: 'bilinear'
List of values: 'bilinear', 'coord_map_sub_pix'
gen_arbitrary_distortion_map returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.
create_rectification_grid, find_rectification_grid, connect_grid_points, gen_grid_rectification_map
Calibration
| Table of Contents / Tools / Grid Rectification | Operators |
| HALCON Reference Manual 10.0.2 | Copyright © 1996-2011 MVTec Software GmbH |