create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGridcreate_rectification_grid (Operator)

Name

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

Signature

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)

def create_rectification_grid(width: float, num_squares: int, grid_file: str) -> None

Description

create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGridCreateRectificationGridcreate_rectification_grid generates a checkered pattern with NumSquaresNumSquaresNumSquaresNumSquaresnumSquaresnum_squares x NumSquaresNumSquaresNumSquaresNumSquaresnumSquaresnum_squares alternating black and white squares. This pattern is WidthWidthWidthWidthwidthwidth 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_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMapgen_grid_rectification_map 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 GridFileGridFileGridFileGridFilegridFilegrid_file contains the PostScript description of the rectification grid.

Execution Information

Parameters

WidthWidthWidthWidthwidthwidth (input_control)  real HTuplefloatHTupleHtuple (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

NumSquaresNumSquaresNumSquaresNumSquaresnumSquaresnum_squares (input_control)  integer HTupleintHTupleHtuple (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

GridFileGridFileGridFileGridFilegridFilegrid_file (input_control)  filename.write HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name of the PostScript file.

Default value: 'rectification_grid.ps' "rectification_grid.ps" "rectification_grid.ps" "rectification_grid.ps" "rectification_grid.ps" "rectification_grid.ps"

File extension: .ps

Result

find_rectification_gridfind_rectification_gridFindRectificationGridFindRectificationGridFindRectificationGridfind_rectification_grid 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_gridFindRectificationGridFindRectificationGridFindRectificationGridfind_rectification_grid, saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixSaddlePointsSubPixsaddle_points_sub_pix, connect_grid_pointsconnect_grid_pointsConnectGridPointsConnectGridPointsConnectGridPointsconnect_grid_points, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapGenGridRectificationMapgen_grid_rectification_map

Module

Foundation