PerspectiveTransformTool¶
The PerspectiveTransformTool appends a non-linear transformation to the CogCoordinateSpaceTree of a CogImage8Grey.
Columns/Rows: Default values within the transformation matrix
decimal places: Number of decimal places displayed in the matrix
Coordinate space name: Name of the new perspective image space
Set SelectedSpaceName: Specifies whether to set the SelectedSpaceName of the output image to names of the coordinate space.
Unwrap the image: Image is rectified in perspective
Enabled: Enables the calculation of the transformation matrix via an N-to-N point mapping
NumPoints: Number of N to N points
Unfixed X/Y: Unfixed points, or starting points, for example in pixel coorinate space.
Rax Fixtured X/Y: Fixed points, or target points, for example in world coordinates.
The matrix is a planar transformation, followed by a radial transformation, followed by a linear transformation without a rotation matrix:
With this matrix, a point P is transformed into the point P’ as follows:
- Note PDX
- Controls the perspective transformation in the untransformed X direction.0 = no perspective transformation in X> 0 = Tilting of the plane backwards with increasing X< 0 = Tilting of the plane backwards with decreasing X
- Note PDY
- Controls the perspective transformation in the non-transformed Y direction.0 = no perspective transformation in Y> 0 = Tilting of the plane backwards with increasing Y< 0 = Tilting of the plane backwards with decreasing Y)
Hint
The perspective transformation cannot be used directly by Cognex VisionPro Tools. It is only intended for the “Unwarp” case or further use in subsequent scripts.
Color images (CogImage24PlanarColor) are not allowed!