JMRI: Translate Selection Help
Author: Bob Jacobsen
Keywords: JMRI help Layout Editor Translate

# Translate Selection

The Translate Selection dialog provides for translating in 2D a user-selected part of a panel created using Layout Editor. Before selecting Translate Selection... in the Options menu, an area of the panel must be "selected". To select an area, press and hold down the mouse at the upper left of the area, and drag the mouse to the lower right of the area. The selected area is outlined by a rectangle. For icon items, the upper left corner of the icon must be within the selection rectangle if the icon is to be translated.

To translate your selected area in the Panel window, enter the amount to translate in the x (horizontal) and y (vertical) directions. The units are pixels--the same units shown in the x,y position display in the Layout Editor tool bar. For no translation in either direction enter zero. For horizontal translation, enter a negative number to move the selected area left that number of pixels; enter a positive number to move right. For vertical translation, enter a negative number to move the selected area up by that number of pixels; enter a positive number to move the selected area down.

After entering the amounts to translate, click Move Selection to move the selected area. Caution: translating too far can move the upper left corner of an icon over the edge of the panel, where it cannot be selected, and may disappear forever. Fortunately, if you make this mistake, you can undo a translation by immediately selecting Undo Translation in the Options menu. Undo Translation only works for the last Translate Selection... performed. Remember to check results immediately after translating a selection in case undoing the operation is needed.

To retain your changes, please remember to save your Panel!