Operator Reference

HALCON Operator Reference / Tools / Grid Rectification

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

create_rectification_gridcreate_rectification_gridCreateRectificationGridCreateRectificationGridcreate_rectification_grid (Operator)

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_gridCreateRectificationGridCreateRectificationGridcreate_rectification_grid generates a checkered pattern with NumSquaresNumSquaresNumSquaresnumSquaresnum_squares x NumSquaresNumSquaresNumSquaresnumSquaresnum_squares 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_mapGenGridRectificationMapGenGridRectificationMapgen_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 GridFileGridFileGridFilegridFilegrid_file contains the PostScript description of the rectification grid.

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

WidthWidthWidthwidthwidth (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

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

Default: 0.17

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

Recommended increment: 0.1

Restriction: 0.0 < Width

NumSquaresNumSquaresNumSquaresnumSquaresnum_squares (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of squares per row and column.

Default: 17

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

Recommended increment: 2

Restriction: 2 <= NumSquares

GridFileGridFileGridFilegridFilegrid_file (input_control)  filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

File name of the PostScript file.

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

File extension: .ps

Result

find_rectification_gridfind_rectification_gridFindRectificationGridFindRectificationGridfind_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_gridFindRectificationGridFindRectificationGridfind_rectification_grid, saddle_points_sub_pixsaddle_points_sub_pixSaddlePointsSubPixSaddlePointsSubPixsaddle_points_sub_pix, connect_grid_pointsconnect_grid_pointsConnectGridPointsConnectGridPointsconnect_grid_points, gen_grid_rectification_mapgen_grid_rectification_mapGenGridRectificationMapGenGridRectificationMapgen_grid_rectification_map

Module

Foundation

---

ClassesClasses | | Operators