create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGrid (Operator)


create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGrid — Generate a PostScript file, which describes the rectification grid.


create_rectification_grid( : : Width, NumSquares, GridFile : )

Herror create_rectification_grid(double Width, const Hlong NumSquares, const char* GridFile)

Herror T_create_rectification_grid(const Htuple Width, const Htuple NumSquares, const Htuple GridFile)

void CreateRectificationGrid(const HTuple& Width, const HTuple& NumSquares, const HTuple& GridFile)

static void HMisc::CreateRectificationGrid(double Width, Hlong NumSquares, const HString& GridFile)

static void HMisc::CreateRectificationGrid(double Width, Hlong NumSquares, const char* GridFile)

static void HMisc::CreateRectificationGrid(double Width, Hlong NumSquares, const wchar_t* GridFile)   (Windows only)

static void HOperatorSet.CreateRectificationGrid(HTuple width, HTuple numSquares, HTuple gridFile)

static void HMisc.CreateRectificationGrid(double width, int numSquares, string gridFile)


create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGridCreateRectificationGrid generates a checkered pattern with NumSquaresNumSquaresNumSquaresNumSquaresnumSquares x NumSquaresNumSquaresNumSquaresNumSquaresnumSquares alternating black and white squares. This pattern is WidthWidthWidthWidthwidth meters wide (and high). Around the pattern there is an inner frame of 0.3 times the width of one square, which continues the checkered pattern. The pattern is completed by a solid white outer frame of 0.7 times the width of one square. In the center of the pattern there are two circular marks, one black on a white square and one white on a black square. The radius of both marks correspond to one third of the side length of the respective enclosing square. These marks are used by gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMap to rotate the detected layout of the grid points into the correct orientation. It is assumed that the black mark is positioned to the left of the white mark, when oriented correctly. The file GridFileGridFileGridFileGridFilegridFile contains the PostScript description of the rectification grid.

Execution Information


WidthWidthWidthWidthwidth (input_control)  real HTupleHTupleHtuple (real) (double) (double) (double)

Width of the checkered pattern in meters (without the two frames).

Default value: 0.17

Suggested values: 1.2, 0.8, 0.6, 0.4, 0.2, 0.1

Recommended increment: 0.1

Restriction: 0.0 < Width

NumSquaresNumSquaresNumSquaresNumSquaresnumSquares (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of squares per row and column.

Default value: 17

Suggested values: 11, 13, 15, 17, 19, 21, 23, 25, 27

Recommended increment: 2

Restriction: 2 <= NumSquares

GridFileGridFileGridFileGridFilegridFile (input_control)  filename.write HTupleHTupleHtuple (string) (string) (HString) (char*)

File name of the PostScript file.

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

File extension: .ps


find_rectification_gridfind_rectification_gridFindRectificationGridFindRectificationGridFindRectificationGrid returns 2 (H_MSG_TRUE) if all parameter values are correct and the file has been written successfully. If necessary, an exception is raised.

See also

find_rectification_gridfind_rectification_gridFindRectificationGridFindRectificationGridFindRectificationGrid, saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPix, connect_grid_pointsconnect_grid_pointsConnectGridPointsConnectGridPointsConnectGridPoints, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMap