projective_trans_region ( Regions : TransRegions : HomMat2D, Interpolation : )

Apply a projective transformation to a region.

projective_trans_region applies the projective transformation specified by the homogeneous matrix HomMat2D on the regions in Regions and returns the transformed regions in TransRegions.

For creation and interpretation details of this matrix see also projective_trans_image.

If 'clip_region' is set to its default value 'true' by set_system('clip_region', 'true') or if the transformation is degenerated and thus produces infinite regions, the output region is clipped by the rectangle with upper left corner (0, 0) and lower right corner ('width', 'height'), where 'width' and 'height' are system variables (see also get_system). If 'clip_region' is 'false', the output region is not clipped except by the maximum supported coordinate size MAX_FORMAT. This may result in extremely memory and time intensive computations, so use with care.


Parameters

Regions (input_object)
region(-array) -> object
Input regions.

TransRegions (output_object)
region(-array) -> object
Output regions.

HomMat2D (input_control)
hom_mat2d-array -> real
Homogeneous projective transformation matrix.

Interpolation (input_control)
string -> string
Interpolation method for the transformation.
Default value: 'bilinear'
List of values: 'nearest_neighbor', 'bilinear'


Parallelization Information

projective_trans_region is reentrant and automatically parallelized (on tuple level).


Possible Predecessors

vector_to_proj_hom_mat2d, hom_vector_to_proj_hom_mat2d, proj_match_points_ransac, hom_mat3d_project


See also

projective_trans_image, projective_trans_image_size, projective_trans_contour_xld, projective_trans_point_2d, projective_trans_pixel


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH