Skip to content

create_rectification_gridCreateRectificationGridCreateRectificationGridcreate_rectification_gridcreate_rectification_grid🔗

Short description🔗

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

Signature🔗

create_rectification_grid( real Width, integer NumSquares, filename.write GridFile )void CreateRectificationGrid( const HTuple& Width, const HTuple& NumSquares, const HTuple& GridFile )static void HOperatorSet.CreateRectificationGrid( HTuple width, HTuple numSquares, HTuple gridFile )def create_rectification_grid( width: float, num_squares: int, grid_file: str ) -> None

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 )

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 HMisc.CreateRectificationGrid( double width, int numSquares, string gridFile )

Description🔗

create_rectification_gridCreateRectificationGrid generates a checkered pattern with NumSquares x NumSquares alternating black and white squares. This pattern is Widthwidthwidth meters wide (and high). Around the pattern there is an inner frame of 0.30.3 times the width of one square, which continues the checkered pattern. The pattern is completed by a solid white outer frame of 0.70.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_mapGenGridRectificationMap 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 GridFilegridFilegrid_file contains the PostScript description of the rectification grid.

Execution information🔗

Execution information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Widthwidthwidth (input_control) real → (real)HTuple (double)HTuple (double)floatHtuple (double)

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

Default: 0.170.17
Suggested values: 1.2, 0.8, 0.6, 0.4, 0.2, 0.11.2, 0.8, 0.6, 0.4, 0.2, 0.1
Recommended increment: 0.1
Restriction: 0.0 < Width

NumSquaresnumSquaresnum_squares (input_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Number of squares per row and column.

Default: 1717
Suggested values: 11, 13, 15, 17, 19, 21, 23, 25, 2711, 13, 15, 17, 19, 21, 23, 25, 27
Recommended increment: 2
Restriction: 2 <= NumSquares

GridFilegridFilegrid_file (input_control) filename.write → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name of the PostScript file.

Default: 'rectification_grid.ps'"rectification_grid.ps"
File extension: .ps

Result🔗

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

Combinations with other operators🔗

Combinations

See also

find_rectification_gridFindRectificationGrid, saddle_points_sub_pixSaddlePointsSubPix, connect_grid_pointsConnectGridPoints, gen_grid_rectification_mapGenGridRectificationMap

Module🔗

Foundation