Skip to content

affine_trans_image_sizeaffine_trans_image_sizeAffineTransImageSizeAffineTransImageSizeaffine_trans_image_sizeT_affine_trans_image_size๐Ÿ”—

Short description๐Ÿ”—

affine_trans_image_sizeaffine_trans_image_sizeAffineTransImageSizeAffineTransImageSizeaffine_trans_image_sizeT_affine_trans_image_size โ€” Apply an arbitrary affine 2D transformation to an image and specify the output image size.

Signature๐Ÿ”—

affine_trans_image_size( image Image, out image ImageAffineTrans, hom_mat2d HomMat2D, string Interpolation, extent.x Width, extent.y Height )affine_trans_image_size( Image : ImageAffineTrans : HomMat2D, Interpolation, Width, Height : )void AffineTransImageSize( const HObject& Image, HObject* ImageAffineTrans, const HTuple& HomMat2D, const HTuple& Interpolation, const HTuple& Width, const HTuple& Height )static void HOperatorSet.AffineTransImageSize( HObject image, out HObject imageAffineTrans, HTuple homMat2D, HTuple interpolation, HTuple width, HTuple height )def affine_trans_image_size( image: HObject, hom_mat_2d: Sequence[float], interpolation: str, width: int, height: int ) -> HObject

Herror T_affine_trans_image_size( const Hobject Image, Hobject* ImageAffineTrans, const Htuple HomMat2D, const Htuple Interpolation, const Htuple Width, const Htuple Height )

HImage HImage::AffineTransImageSize( const HHomMat2D& HomMat2D, const HString& Interpolation, Hlong Width, Hlong Height ) const

HImage HImage::AffineTransImageSize( const HHomMat2D& HomMat2D, const char* Interpolation, Hlong Width, Hlong Height ) const

HImage HImage::AffineTransImageSize( const HHomMat2D& HomMat2D, const wchar_t* Interpolation, Hlong Width, Hlong Height ) const (Windows only)

HImage HHomMat2D::AffineTransImageSize( const HImage& Image, const HString& Interpolation, Hlong Width, Hlong Height ) const

HImage HHomMat2D::AffineTransImageSize( const HImage& Image, const char* Interpolation, Hlong Width, Hlong Height ) const

HImage HHomMat2D::AffineTransImageSize( const HImage& Image, const wchar_t* Interpolation, Hlong Width, Hlong Height ) const (Windows only)

HImage HImage.AffineTransImageSize( HHomMat2D homMat2D, string interpolation, int width, int height )

HImage HHomMat2D.AffineTransImageSize( HImage image, string interpolation, int width, int height )

Description๐Ÿ”—

affine_trans_image_sizeAffineTransImageSize applies an arbitrary affine 2D transformation, i.e., scaling, rotation, translation, and slant (skewing), to the images given in Imageimageimage and returns the transformed images in ImageAffineTransimageAffineTransimage_affine_trans. The affine transformation is described by the homogeneous transformation matrix given in HomMat2DhomMat2Dhom_mat_2d, which can be created using the operators hom_mat2d_identityHomMat2dIdentity, hom_mat2d_scaleHomMat2dScale, hom_mat2d_rotateHomMat2dRotate, hom_mat2d_translateHomMat2dTranslate, etc., or be the result of operators like vector_angle_to_rigidVectorAngleToRigid.

The components of the homogeneous transformation matrix are interpreted as follows: The row coordinate of the image corresponds to \(x\) and the column coordinate corresponds to \(y\) of the coordinate system in which the transformation matrix was defined. This is necessary to obtain a right-handed coordinate system for the image. In particular, this assures that rotations are performed in the correct direction. Note that the (\(x\),\(y\)) order of the matrices quite naturally corresponds to the usual (row,column) order for coordinates in the image.

The region of the input image is ignored, i.e., assumed to be the full rectangle of the image. The region of the resulting image is set to the transformed rectangle of the input image. If necessary, the resulting image is filled with zero (black) outside of the region of the original image.

Generally, transformed points will lie between pixel coordinates. Therefore, an appropriate interpolation scheme has to be used. The interpolation can also be used to avoid aliasing effects for scaled images. The quality and speed of the interpolation can be set by the parameter Interpolationinterpolationinterpolation:

  • nearest_neighbor Nearest-neighbor interpolation: The gray value is determined from the nearest pixelโ€™s gray value (possibly low quality, very fast).

  • bilinear Bilinear interpolation. The gray value is determined from the four nearest pixels through bilinear interpolation. If the affine transformation contains a scaling with a scale factor < 1, no smoothing is performed, which may cause severe aliasing effects (medium quality and run time).

  • bicubic Bicubic interpolation. The gray value is determined from the \(4 \times 4\) nearest pixels through bicubic interpolation. If the affine transformation contains a scaling with a scale factor < 1, no smoothing is performed, which may cause severe aliasing effects (high quality for enlargements, slow).

  • constant Bilinear interpolation. The gray value is determined from the four nearest pixels through bilinear interpolation. If the affine transformation contains a scaling with a scale factor \(< 1\), a kind of mean filter is used to prevent aliasing effects (medium quality and run time).

  • weighted Bilinear interpolation. The gray value is determined from the four nearest pixels through bilinear interpolation. If the affine transformation contains a scaling with a scale factor \(< 1\), a kind of Gaussian filter is used to prevent aliasing effects (high quality, slow).

In addition, the system parameter 'int_zooming'"int_zooming" (see set_systemSetSystem) affects the accuracy of the transformation. If 'int_zooming'"int_zooming" is set to 'true'"true", the transformation for byte, int2 and uint2 images is carried out internally using fixed point arithmetic, leading to much shorter execution times. However, the accuracy of the transformed gray values is smaller in this case. For byte images, the differences to the more accurate calculation (using 'int_zooming'"int_zooming" = 'false'"false") is typically less than two gray levels. Correspondingly, for int2 and uint2 images, the gray value differences are less than 1/128 times the dynamic gray value range of the image, i.e., they can be as large as 512 gray levels if the entire dynamic range of 16 bit is used. When using fixed point arithmetic, the domain of resulting images can differ as well. Additionally, if a large scale factor is applied and a large output image is obtained, then undefined gray values at the lower and at the right image border may result. The maximum width \(B_{max}\) of this border of undefined gray values can be estimated as \(B_{max}=0.5 \cdot S \cdot I / 2^{15}\), where \(S\) is the scale factor in one dimension and \(I\) is the size of the output image in the corresponding dimension. For real images, the parameter 'int_zooming'"int_zooming" does not affect the accuracy, since the internal calculations are always done using floating point arithmetic.

The size of the target image is specified by the parameters Widthwidthwidth and Heightheightheight. Note that the image is always clipped at the left and upper edge, i.e., all image parts that have negative coordinates after the transformation are clipped. If the affine transformation (in particular, the translation) is chosen appropriately, a part of the image can be transformed as well as cropped in one call. This is useful, for example, when using the variation model (see compare_variation_modelCompareVariationModel), because with this mechanism only the parts of the image that should be examined, are transformed.

Attention๐Ÿ”—

The region of the input image is ignored.

affine_trans_image_sizeAffineTransImageSize does not use the HALCON standard coordinate system (with the origin in the center of the upper left pixel), but instead uses the same coordinate system as in affine_trans_pixelAffineTransPixel, i.e., the origin lies in the upper left corner of the upper left pixel. Therefore, applying affine_trans_image_sizeAffineTransImageSize corresponds to a chain of transformations (see affine_trans_pixelAffineTransPixel), which is applied to each point of the image (input and output pixels as homogeneous vectors). As an effect, you might get unexpected results when creating affine transformations based on coordinates that are derived from the image, e.g., by operators like area_center_grayAreaCenterGray. 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_rotateHomMat2dRotate, 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 HomMat2DhomMat2Dhom_mat_2d before using it in affine_trans_image_sizeAffineTransImageSize:

ย 
hom_mat2d_translate(HomMat2D, 0.5, 0.5, HomMat2DTmp)
hom_mat2d_translate_local(HomMat2DTmp, -0.5, -0.5, HomMat2DAdapted)
affine_trans_image_size(Image, ImageAffineTrans, HomMat2DAdapted, 'constant', Width, Height)

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

Execution information๐Ÿ”—

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๐Ÿ”—

Imageimageimage (input_object) (multichannel-)image(-array) โ†’ object (byte / int2 / uint2 / real)object (byte / int2 / uint2 / real)HObject (byte / int2 / uint2 / real)HImage (byte / int2 / uint2 / real)HObject (byte / int2 / uint2 / real)Hobject (byte / int2 / uint2 / real)

Input image.

ImageAffineTransimageAffineTransimage_affine_trans (output_object) (multichannel-)image(-array) โ†’ object (byte / int2 / uint2 / real)object (byte / int2 / uint2 / real)HObject (byte / int2 / uint2 / real)HImage (byte / int2 / uint2 / real)HObject (byte / int2 / uint2 / real)Hobject * (byte / int2 / uint2 / real)

Transformed image.

HomMat2DhomMat2Dhom_mat_2d (input_control) hom_mat2d โ†’ (real)(real)HTuple (double)HHomMat2D, HTuple (double)Sequence[float]Htuple (double)

Input transformation matrix.

Interpolationinterpolationinterpolation (input_control) string โ†’ (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Type of interpolation.

Default: 'constant'"constant"
List of values: 'bicubic', 'bilinear', 'constant', 'nearest_neighbor', 'weighted'"bicubic", "bilinear", "constant", "nearest_neighbor", "weighted"

Widthwidthwidth (input_control) extent.x โ†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Width of the output image.

Default: 640640
Suggested values: 128, 160, 192, 256, 320, 384, 512, 640, 768128, 160, 192, 256, 320, 384, 512, 640, 768

Heightheightheight (input_control) extent.y โ†’ (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Height of the output image.

Default: 480480
Suggested values: 120, 128, 144, 240, 256, 288, 480, 512, 576120, 128, 144, 240, 256, 288, 480, 512, 576

Result๐Ÿ”—

If the matrix HomMat2DhomMat2Dhom_mat_2d represents an affine transformation (i.e., not a projective transformation), affine_trans_image_sizeAffineTransImageSize returns 2 (H_MSG_TRUE). If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.

Combinations with other operators๐Ÿ”—

Combinations

Possible predecessors

hom_mat2d_identityHomMat2dIdentity, hom_mat2d_translateHomMat2dTranslate, hom_mat2d_rotateHomMat2dRotate, hom_mat2d_scaleHomMat2dScale, hom_mat2d_reflectHomMat2dReflect

Alternatives

affine_trans_imageAffineTransImage, zoom_image_sizeZoomImageSize, zoom_image_factorZoomImageFactor, mirror_imageMirrorImage, rotate_imageRotateImage, affine_trans_regionAffineTransRegion

See also

set_part_styleSetPartStyle

Module๐Ÿ”—

Foundation