Function GraTranslate() Foundation
Calculates translation (shift) transformation for a matrix.
GraTranslate( [<oPS>], <aMatrix>, ; <nXDiff>, <nYDiff>, [<nMode>] ) --> lSuccess
|GRA_TRANSFORM_REPLACE||Replaces the <aMatrix> transformation after the transformation|
|GRA_TRANSFORM_ADD||Keeps the existing <aMatrix> transformation and calculates an additional transformation|
The return value of GraTranslate() is .T. (true) if the translation transformation was calculated, otherwise it is .F. (false). If the return value equals .F., the cause of error can be determined using GraError().
The function GraTranslate() completes the matrix calculations required for the translation (shift) of graphic segments. A matrix must be passed to the function to hold the values resulting from the calculations. This matrix is a three dimensional array which must first be created by GraInitMatrix() before it can be used for matrix calculations.
Graphic segments moved by a specific amount must have been previously created with graphic primitives. The functions GraSegOpen() and GraSegClose() are used to define a graphic segment. GraTranslate() calculates the shift and the function GraSegDraw() makes the shift visible.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.