projective_trans_imageT_projective_trans_imageProjectiveTransImageProjectiveTransImage (Operator)

Name

projective_trans_imageT_projective_trans_imageProjectiveTransImageProjectiveTransImage — Apply a projective transformation to an image.

Signature

Description

projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImage applies the projective transformation (homography) determined by the homogeneous transformation matrix HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D on the input image ImageImageImageImageimage and stores the result into the output image TransImageTransImageTransImageTransImagetransImage.

If the parameter AdaptImageSizeAdaptImageSizeAdaptImageSizeAdaptImageSizeadaptImageSize is set to 'false'"false""false""false""false", TransImageTransImageTransImageTransImagetransImage will have the same size as ImageImageImageImageimage; if AdaptImageSizeAdaptImageSizeAdaptImageSizeAdaptImageSizeadaptImageSize is 'true'"true""true""true""true", the output image size will be automatically adapted so that all non-negative points of the transformed image are visible.

The parameter InterpolationInterpolationInterpolationInterpolationinterpolation determines, which interpolation method is used to determine the gray values of the output image. For InterpolationInterpolationInterpolationInterpolationinterpolation = 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor", the gray value is determined from the nearest pixel in the input image. This mode is very fast, but also leads to the typical “jagged” appearance for large enlargements of the image. For InterpolationInterpolationInterpolationInterpolationinterpolation = 'bilinear'"bilinear""bilinear""bilinear""bilinear", the gray values are interpolated bilinearly, leading to longer runtimes, but also to significantly improved results.

The parameter TransformDomainTransformDomainTransformDomainTransformDomaintransformDomain can be used to determine whether the domain of ImageImageImageImageimage is also transformed. Since the transformation of the domain costs runtime, this parameter should be used to specify whether this is desired or not. If TransformDomainTransformDomainTransformDomainTransformDomaintransformDomain is set to 'false'"false""false""false""false" the domain of the input image is ignored and the complete image is transformed.

The projective transformation matrix could for example be created using the operator vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2d.

In a homography the points to be projected are represented by homogeneous vectors of the form (x,y,w). A Euclidean point can be derived as (x',y') = .

Just like in affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageAffineTransImage, x represents the row coordinate while y represents the column coordinate in projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImage. With this convention, affine transformations are a special case of projective transformations in which the last row of HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D is of the form (0,0,c).

For images of type 'byte'"byte""byte""byte""byte" or 'uint2'"uint2""uint2""uint2""uint2" the system parameter 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" selects between fast calculation in floating point arithmetics ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" = 'true'"true""true""true""true") and highly accurate floating point arithmetics ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" = 'false'"false""false""false""false"). Especially for InterpolationInterpolationInterpolationInterpolationinterpolation = 'bilinear'"bilinear""bilinear""bilinear""bilinear", however, the faster calculation can lead to minor gray value deviations since the faster algorithm is less accurate and only has an accuracy around times the size of the image. Therefore, when applying large scales 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming" = 'false'"false""false""false""false" is recommended.

Attention

The used coordinate system is the same as in affine_trans_pixelaffine_trans_pixelAffineTransPixelAffineTransPixelAffineTransPixel. This means that in fact not HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D is applied but a modified version. Therefore, applying projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImage corresponds to the following chain of transformations, which is applied to each point (Row_i, Col_i) of the image (input and output pixels as homogeneous vectors):

As an effect, you might get unexpected results when creating projective transformations based on coordinates that are derived from the image, e.g., by operators like area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray. For example, if you use this operator to calculate the center of gravity of a rotationally symmetric image and then rotate the image around this point using hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotateHomMat2dRotate, the resulting image will not lie on the original one. In such a case, you can compensate this effect by applying the following translations to HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D before using it in projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImage:

hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp) hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted) projective_trans_image(Image, TransImage, HomMat2DAdapted, 'bilinear', 'false', 'false')

For an explanation of the different 2D coordinate systems used in HALCON, see the introduction of chapter Transformations / 2D Transformations.

projective_trans_imageprojective_trans_imageProjectiveTransImageProjectiveTransImageProjectiveTransImage can be executed on OpenCL devices if the input image does not exceed the maximum size of image objects of the selected device and the parameter TransformDomainTransformDomainTransformDomainTransformDomaintransformDomain is set to 'false'"false""false""false""false". The result can diverge slightly from that calculated on the CPU.

Execution Information

• Supports OpenCL compute devices.
• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.
• Automatically parallelized on channel level.
• Automatically parallelized on internal data level.

Parameters

Possible Predecessors

vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2dVectorToProjHomMat2d, hom_vector_to_proj_hom_mat2dhom_vector_to_proj_hom_mat2dHomVectorToProjHomMat2dHomVectorToProjHomMat2dHomVectorToProjHomMat2d, proj_match_points_ransacproj_match_points_ransacProjMatchPointsRansacProjMatchPointsRansacProjMatchPointsRansac, proj_match_points_ransac_guidedproj_match_points_ransac_guidedProjMatchPointsRansacGuidedProjMatchPointsRansacGuidedProjMatchPointsRansacGuided, hom_mat3d_projecthom_mat3d_projectHomMat3dProjectHomMat3dProjectHomMat3dProject

See also

projective_trans_image_sizeprojective_trans_image_sizeProjectiveTransImageSizeProjectiveTransImageSizeProjectiveTransImageSize, projective_trans_contour_xldprojective_trans_contour_xldProjectiveTransContourXldProjectiveTransContourXldProjectiveTransContourXld, projective_trans_regionprojective_trans_regionProjectiveTransRegionProjectiveTransRegionProjectiveTransRegion, projective_trans_point_2dprojective_trans_point_2dProjectiveTransPoint2dProjectiveTransPoint2dProjectiveTransPoint2d, projective_trans_pixelprojective_trans_pixelProjectiveTransPixelProjectiveTransPixelProjectiveTransPixel

Module

Foundation