RotateImage (Exp)

Rotate an image by an individual rotation angle in degrees.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

HRESULT RotateImage(
    HRESULT                        hrPrev,
    ITcVnImage*                    ipSrcImage,
    ITcVnImage*&                   ipDestImage,
    double                         fAngleDeg,
    bool                           bAdjustDestSize,
    ETcVnInterpolationType         eInterpolationType = IT_BILINEAR,
    ETcVnBorderInterpolationMethod eBorderInterpolation = BIM_CONSTANT,
    TcVnVector4_LREAL&             aBorderValue = {0, 0, 0, 0}
)

Parameters

Name	Type	Default	Description
hrPrev	HRESULT		HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipSrcImage	ITcVnImage*		Source image
ipDestImage	ITcVnImage*&		Destination image (An appropriate image will be created if required.)
fAngleDeg	double		Rotation angle in degree (positive: counter-clockwise, negative: clockwise)
bAdjustDestSize	bool		If true, ipDestImage size is adjusted so that the whole rotated ipSrcImage is contained. Otherwise, ipDestImage size is set to ipSrcImage size.
eInterpolationType	ETcVnInterpolationType	IT_BILINEAR	Interpolation method
eBorderInterpolation	ETcVnBorderInterpolationMethod	BIM_CONSTANT	Border interpolation method (ISOLATED not supported)
aBorderValue	TcVnVector4_LREAL&	{0, 0, 0, 0}	Border value, if CONSTANT is used

Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.59 or later	PC or CX (x64) with min. PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision