Synopsis

edit translate [(1) from] (2) to object...

(1) [-n] -k { (4) from_object | (3) from_position }(2) [-n] [ -a | -r ] { (4) to_object | (3) to_position }(3) { (5) coords } | { [ -x { x | (4) x-obj } ] [ -y { y | (4) y-obj } ] [ -z { z | (4) z-obj } ] } (4) [path/] object [ (5) offset_distance ](5) x [ y [z] ]

EXAMPLES











Example 11.  This example breaks down a particularly complex translation.

> edit translate -k -x c/obj1 1.5 -y c/obj2 0 3 -z c/obj3 0 0 10 -a -x b/c/obj4 2 -y b/c/obj5 0 4 -z b/c/obj6 0 0 20 obj7 obj8

Every use of translate involves a from point and a to point. One of the more flexible features of the edit commands is the capability to use an object and an offset to specify each axis of these points individually. The command in this example can be broken down to three simpler commands, in order to ease comprehension:

> edit translate -k -x c/obj1 1.5 -a -x b/c/obj4 2 obj7 obj8

> edit translate -k -y c/obj2 0 3 -a -y b/c/obj5 0 4 obj7 obj8

> edit translate -k -z c/obj3 0 0 10 -a -z b/c/obj6 0 0 20 obj7 obj8

In the first shortened command, the from point is set to the x-coordinate of the apparent point of the bounding box center of the instance of obj1 in combination c, plus 1.5. The to point is set to the x-coordinate of the apparent point of the bounding box center of the specific instance of obj4 in combination c in combination b, plus 2. Both obj7 and obj8 move from from to to, ending up the same relative distance from each other.The other shortened commands are similar.

By splitting the larger command, an interesting detail was revealed. In the larger command, every point was set explicitly, so none defaulted. In the first shortened command, the y and z from values default to the bounding box center of obj7. Since the y and z to values default to the values set by from, neither obj7 nor obj8 will move in the y or z axes.