image_translate ( : : TranslationRow, TranslationColumn : )

Modify the current transformation matrix by a translation.

image_scale modifies the current transformation matrix by applying a translation. The current transformation matrix is used in image_transform__ for an arbitrary affine transformation of an image. The translation is addeed to any other modifications of the CTM effected by image_scale, image_translate, or image_rotate. If this is not desired, image_identity must be called before calling image_scale. TranslationRow and TranslationColumn determine the translation vertically and horizontally, respectively. A positive value of TranslationRow results in a downward translation, while a positive value for TranslationColumn results in a translation to the right.


Parameters

TranslationRow (input_control)
point.y -> real / integer
Vertical translation.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Range of values: 0 <= TranslationRow <= 1024
Minimum increment: 1
Recommended increment: 10

TranslationColumn (input_control)
point.x -> real / integer
Horizontal translation.
Default value: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Range of values: 0 <= TranslationColumn <= 1024
Minimum increment: 1
Recommended increment: 10


Example
image_identity(:::) >
image_translate(::-256.0,-256.0:) >
image_transform__(Image:TrafoImage2:1:).

Result

image_translate returns TRUE if all parameter values are correct. Otherwise, an exception is raised.


Possible Successors

image_transform__, image_scale, image_rotate


See also

image_identity



Copyright © 1996-1997 MVTec Software GmbH