image_getmatrix ( : : : Matrix )

Return the current transformation matrix.

image_getmatrix returns the current transformation matrix that was built up by using image_identity, image_scale, image_translate, or image_rotate. This operator is useful for saving a transformation built up using these operators with image_getmatrix , while temporarily building another transformation, and then restoring the former transformation with image_setmatrix.


Parameters

Matrix (output_control)
real-array -> real
Current transformation matrix.
Number of elements: 6


Example
image_identity(:::) >
image_scale(::256.0,256.0,0.5,0.5:) >
image_transform__(Image:TrafoImage1:1:) >
image_getmatrix(:::Matrix1) >
...
image_identity(:::) >
image_rotate(::256.0,256.0,3.14:) >
image_translate(::-256.0,-256.0:) >
image_transform__(Image:TrafoImage2:1:)
...
image_setmatrix(::Matrix1:) >
image_transform__(Image:TrafoImage3:1:).

/* Result: TrafoImage3 = TrafoImage1 */

Result

image_getmatrix always returns TRUE.


Possible Predecessors

dvf_to_affin, vector_to_affin, image_scale, image_rotate


See also

image_setmatrix, image_transform__, image_identity, image_scale, image_rotate



Copyright © 1996-1997 MVTec Software GmbH