ITRANSLATE
Syntax | Arguments | Keywords | Examples | Version History | See Also
The ITRANSLATE procedure moves an iTool visualization.
This routine is written in the IDL language. Its source code can be found in the file itranslate.pro in the lib/itools subdirectory of the IDL distribution.
Syntax
ITRANSLATE, Id [, X[, Y[, Z]]] [, /DATA | /DEVICE | /NORMAL] [, /RESET] [, TOOL=iToolID] [, X=value] [, Y=value] [, Z=value]
Arguments
Id
The identifier of the object to translate. If you pass a partial identifier, the IGETID function is called to retrieve the full identifier string.
X, Y, Z
The distance to translate the specified visualization in the x, y, and z directions, specified in normalized coordinates unless the DATA or DEVICE keyword is specified.
Keywords
DATA
Set this keyword if the input arguments are specified in data coordinates.
DEVICE
Set this keyword if the input arguments are specified in device coordinates (pixels). This is the default behavior.
NORMAL
Set this keyword if the input arguments are specified in normalized [0, 1] coordinates.
RESET
Set this keyword to reset the current translation before applying any input translation values.
TOOL
Set this keyword to the identifer of the iTool in which Id is found. If not supplied, the current iTool is used.
X
Set this keyword to the distance to translate the visualization in the X direction. If this keyword is specified, the value supercedes the X argument.
Y
Set this keyword to the distance to translate the visualization in the Y direction. If this keyword is specified, the value supercedes the Y argument.
Z
Set this keyword to the distance to translate the visualization in the Z direction. If this keyword is specified, the value supercedes the Z argument.
Note
Z values are ignored if the DEVICE keyword is set.
Examples
In the following example, we draw a circle over a JPG image, and then translate the circle to another location.
Version History
See Also
IGETID, IROTATE, ISCALE, IZOOM, Translation (iTool User's Guide).
![; Open the data file file = FILEPATH('marsglobe.jpg', $ SUBDIRECTORY = ['examples', 'data']) ; Create an iTool with the image data IIMAGE, file, /FIT_TO_VIEW circle = [150, 120] ; Circle center d = 15 ; Circle diameter circleTran = [167, 100] ; Units to translate circle text = [200, 60] ; Text label location ; Write the ellipse to the iTool's annotation layer IELLIPSE, d, circle[0], circle[1], /DATA, $ IDENTIFIER = ellipseID, THICK=2, COLOR=[240,0,0], $ FILL_BACKGROUND=0 ; Add a label ITEXT, 'Proposed Landing Site', text[0], text[1], /DATA, $ /VISUALIZATION, ALIGNMENT = 0.5, IDENTIFIER = textID, $ COLOR=[255,255,255] ; Insert a dialog box to pause the flow of action result = DIALOG_MESSAGE('Click OK to translate the circle.', $ /INFORMATION) ; Translate the circle to a different location ITRANSLATE, ellipseID, circleTran[0], circleTran[1], /DATA](javascript:doIDL("; Open the data file\nfile = FILEPATH('marsglobe.jpg', $\n SUBDIRECTORY = ['examples', 'data'])\n\n; Create an iTool with the image data\nIIMAGE, file, /FIT_TO_VIEW\n\ncircle = [150, 120] ; Circle center\nd = 15 ; Circle diameter\ncircleTran = [167, 100] ; Units to translate circle\ntext = [200, 60] ; Text label location\n\n; Write the ellipse to the iTool's annotation layer\nIELLIPSE, d, circle[0], circle[1], /DATA, $\n IDENTIFIER = ellipseID, THICK=2, COLOR=[240,0,0], $\n FILL_BACKGROUND=0\n\n; Add a label\nITEXT, 'Proposed Landing Site', text[0], text[1], /DATA, $\n /VISUALIZATION, ALIGNMENT = 0.5, IDENTIFIER = textID, $\n COLOR=[255,255,255]\n\n; Insert a dialog box to pause the flow of action\nresult = DIALOG_MESSAGE('Click OK to translate the circle.', $\n /INFORMATION)\n\n; Translate the circle to a different location\nITRANSLATE, ellipseID, circleTran[0], circleTran[1], /DATA")){kind=link}