projective_trans_contour_xld🔗
Short description🔗
projective_trans_contour_xld — Apply a projective transformation to an XLD contour.
Signature🔗
projective_trans_contour_xld( xld_cont Contours, out xld_cont ContoursProjTrans, hom_mat2d HomMat2D )
Description🔗
projective_trans_contour_xld applies the projective
transformation specified by the homogeneous matrix HomMat2D
on the contours in Contours and returns the transformed
contours in ContoursProjTrans.
For creation and interpretation details of this matrix see also
projective_trans_image.
Attention🔗
The used coordinate system is the same as in affine_trans_pixel. This
means that in fact not HomMat2D is applied but a modified
version. Therefore, applying projective_trans_contour_xld corresponds to
the following chain of transformations, which is applied to each point
\((Row_{i}, Col_{i})\) of the contour (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
contour, e.g., by operators like
area_center_xld. For example, if you use this operator to calculate
the center of gravity of a rotationally symmetric XLD contour and then rotate
the contour around this point using hom_mat2d_rotate, the resulting
contour will not lie on the original one. In such a case, you can compensate
this effect by applying the following translations to HomMat2D
before using it in projective_trans_contour_xld:
| Â |
|---|
hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp) |
hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted) |
projective_trans_contour_xld(Contours, ContoursAffineTrans, HomMat2DAdapted) |
For an explanation of the different 2D coordinate systems used in HALCON, see the introduction of chapter Transformations / 2D Transformations.
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🔗
Contours (input_object) xld_cont(-array) → object
Input contours.
ContoursProjTrans (output_object) xld_cont(-array) → object
Output contours.
HomMat2D (input_control) hom_mat2d → (real)
Homogeneous projective transformation matrix.
Combinations with other operators🔗
Combinations
Possible predecessors
vector_to_proj_hom_mat2d, hom_vector_to_proj_hom_mat2d, proj_match_points_ransac, proj_match_points_ransac_guided, hom_mat3d_project
See also
projective_trans_image, projective_trans_image_size, projective_trans_region, projective_trans_point_2d, projective_trans_pixel
Module🔗
Foundation