ClassesClassesClassesClasses | | | | Operators

gen_arbitrary_distortion_mapT_gen_arbitrary_distortion_mapGenArbitraryDistortionMapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMap (Operator)

Name

gen_arbitrary_distortion_mapT_gen_arbitrary_distortion_mapGenArbitraryDistortionMapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMap — Generate a projection map that describes the mapping between an arbitrarily distorted image and the rectified image.

Signature

gen_arbitrary_distortion_map( : Map : GridSpacing, Row, Column, GridWidth, ImageWidth, ImageHeight, MapType : )

Herror T_gen_arbitrary_distortion_map(Hobject* Map, const Htuple GridSpacing, const Htuple Row, const Htuple Column, const Htuple GridWidth, const Htuple ImageWidth, const Htuple ImageHeight, const Htuple MapType)

Herror gen_arbitrary_distortion_map(Hobject* Map, const HTuple& GridSpacing, const HTuple& Row, const HTuple& Column, const HTuple& GridWidth, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& MapType)

void GenArbitraryDistortionMap(HObject* Map, const HTuple& GridSpacing, const HTuple& Row, const HTuple& Column, const HTuple& GridWidth, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& MapType)

static HImage HMisc::GenArbitraryDistortionMap(Hlong GridSpacing, const HTuple& Row, const HTuple& Column, Hlong GridWidth, Hlong ImageWidth, Hlong ImageHeight, const HString& MapType)

static HImage HMisc::GenArbitraryDistortionMap(Hlong GridSpacing, const HTuple& Row, const HTuple& Column, Hlong GridWidth, Hlong ImageWidth, Hlong ImageHeight, const char* MapType)

void HOperatorSetX.GenArbitraryDistortionMap(
[out] IHUntypedObjectX*Map, [in] VARIANT GridSpacing, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT GridWidth, [in] VARIANT ImageWidth, [in] VARIANT ImageHeight, [in] VARIANT MapType)

IHImageX* HMiscX.GenArbitraryDistortionMap(
[in] Hlong GridSpacing, [in] VARIANT Row, [in] VARIANT Column, [in] Hlong GridWidth, [in] Hlong ImageWidth, [in] Hlong ImageHeight, [in] BSTR MapType)

static void HOperatorSet.GenArbitraryDistortionMap(out HObject map, HTuple gridSpacing, HTuple row, HTuple column, HTuple gridWidth, HTuple imageWidth, HTuple imageHeight, HTuple mapType)

static HImage HMisc.GenArbitraryDistortionMap(int gridSpacing, HTuple row, HTuple column, int gridWidth, int imageWidth, int imageHeight, string mapType)

Description

gen_arbitrary_distortion_mapgen_arbitrary_distortion_mapGenArbitraryDistortionMapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMap computes the mapping MapMapMapMapMapmap between an arbitrarily distorted image and the rectified image. The coordinates RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn describe a distorted grid, which will be mapped onto a regular grid in the rectified image. The coordinates of the (distorted) grid points must be passed line by line in RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn. GridWidthGridWidthGridWidthGridWidthGridWidthgridWidth is the width of the point grid in grid points. GridSpacingGridSpacingGridSpacingGridSpacingGridSpacinggridSpacing is the distance between two adjacent grid points in the rectified image. Because the grid points are always mapped to the centers of their corresponding pixels a grid cell requires (GridSpacingGridSpacingGridSpacingGridSpacingGridSpacinggridSpacing+1) x (GridSpacingGridSpacingGridSpacingGridSpacingGridSpacinggridSpacing+1) pixels in the rectified image. Note however, that, of course, adjacent grid cells overlap by one pixel.

To compute the mapping MapMapMapMapMapmap, additionally the width ImageWidthImageWidthImageWidthImageWidthImageWidthimageWidth and height ImageHeightImageHeightImageHeightImageHeightImageHeightimageHeight of the images to be rectified must be passed.

MapTypeMapTypeMapTypeMapTypeMapTypemapType is used to specify the type of the output MapMapMapMapMapmap. If 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" interpolation is chosen, MapMapMapMapMapmap 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'"coordinate_map_sub_pix""coordinate_map_sub_pix""coordinate_map_sub_pix""coordinate_map_sub_pix""coordinate_map_sub_pix" is chosen, MapMapMapMapMapmap 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.

As mentioned above, four adjacent pixels in the destorted image are required to interpolate the gray value of one pixel in the mapped image. If at least one of these pixels is located outside of the distorted image the gray value can not be calculated. The domain of the resulting MapMapMapMapMapmap domain is reduced accordingly.

In contrary to gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMap, gen_arbitrary_distortion_mapgen_arbitrary_distortion_mapGenArbitraryDistortionMapgen_arbitrary_distortion_mapGenArbitraryDistortionMapGenArbitraryDistortionMap is used when the coordinates (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) 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_imagewrite_imageWriteImagewrite_imageWriteImageWriteImage, using the format 'tiff'"tiff""tiff""tiff""tiff""tiff".

Parallelization

Parameters

MapMapMapMapMapmap (output_object)  multichannel-image objectHImageHImageHImageHImageXHobject * (int4 / uint2 / vector_field)

Image containing the mapping data.

GridSpacingGridSpacingGridSpacingGridSpacingGridSpacinggridSpacing (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Distance of the grid points in the rectified image.

Restriction: GridSpacing > 0

RowRowRowRowRowrow (input_control)  point.y-array HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row coordinates of the grid points in the distorted image.

ColumnColumnColumnColumnColumncolumn (input_control)  point.x-array HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column coordinates of the grid points in the distorted image.

Restriction: number(Row) == number(Column)

GridWidthGridWidthGridWidthGridWidthGridWidthgridWidth (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the point grid (number of grid points).

ImageWidthImageWidthImageWidthImageWidthImageWidthimageWidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the images to be rectified.

Restriction: ImageWidth > 0

ImageHeightImageHeightImageHeightImageHeightImageHeightimageHeight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Height of the images to be rectified.

Restriction: ImageHeight > 0

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

Type of mapping.

Default value: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

List of values: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix"

Result

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

Possible Successors

map_imagemap_imageMapImagemap_imageMapImageMapImage

See also

create_rectification_gridcreate_rectification_gridCreateRectificationGridcreate_rectification_gridCreateRectificationGridCreateRectificationGrid, find_rectification_gridfind_rectification_gridFindRectificationGridfind_rectification_gridFindRectificationGridFindRectificationGrid, connect_grid_pointsconnect_grid_pointsConnectGridPointsconnect_grid_pointsConnectGridPointsConnectGridPoints, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMap

Module

Calibration


ClassesClassesClassesClasses | | | | Operators