hom_mat2d_rotate

Herror ::hom_mat2d_rotate ( const HTuple &HomMat2D, const HTuple &Phi, const HTuple &Px, const HTuple &Py, HTuple *HomMat2DRotate )

Add a rotation to a homogeneous 2D transformation matrix.

::hom_mat2d_rotate adds a rotation by the angle Phi to a homogeneous 2D transformation matrix HomMat2D. The point (Px,Py) is the fixed point of the transformation. The resulting matrix is returned in HomMat2DRotate.

Parameters

`HomMat2D` (input_control)	affine2d-array `->` HTuple.double
Input transformation matrix.
Number of elements: 6

`Phi` (input_control)	angle.rad `->` HTuple.double / long
Rotation angle.
Default value: 0.78
Suggested values: 0.1, 0.2, 0.3, 0.4, 0.78, 1.57, 3.14
Typical range of values: `0 <= Phi <= 6.28318530718`
Minimum increment: 0.01
Recommended increment: 0.1

`Px` (input_control)	point.x `->` HTuple.double / long
Fixed point of the transformation (x coordinate).
Default value: 0
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Typical range of values: `0 <= Px <= 1024`
Minimum increment: 1
Recommended increment: 10

`Py` (input_control)	point.y `->` HTuple.double / long
Fixed point of the transformation (y coordinate).
Default value: 0
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Typical range of values: `0 <= Py <= 1024`
Minimum increment: 1
Recommended increment: 10

`HomMat2DRotate` (output_control)	affine2d-array `->` HTuple.double *
Output transformation matrix.
Number of elements: 6

Result

::hom_mat2d_rotate always returns H_MSG_TRUE.

Possible Predecessors

::hom_mat2d_identity, ::hom_mat2d_translate, ::hom_mat2d_scale, ::hom_mat2d_rotate

Possible Successors

::hom_mat2d_translate, ::hom_mat2d_scale, ::hom_mat2d_rotate

Module

Basic operators