image_setmatrix ( : : Matrix : )

Set the current transformation matrix.

image_setmatrix returns the current transformation matrix used by image_transform__. The current transformation matrix can be 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 (input_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

image_setmatrix always returns TRUE.


Possible Successors

image_transform__


See also

image_getmatrix, image_identity, image_scale, image_rotate, image_translate



Copyright © 1996-1997 MVTec Software GmbH