Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

inheritTransform [-off] [-on] [-preserve] [-toggle] [objects...]

inheritTransform is undoable, queryable, and NOT editable.

This command toggles the inherit state of an object. If this flag is off the object will not inherit transformations from its parent. In other words transformations applied to the parent node will not affect the object and it will act as though it is under the world.

If the -p flag is specified then the object's transformation will be modified to compensate when changing the inherit flag so the object will not change its world-space location.

Return value

None

In query mode, return type is based on queried flag.

Flags

off, on, preserve, toggle
Long name (short name) Argument types Properties
-off(-off) createquery
turn off inherit state for the given object(s)
-on(-on) createquery
turn on inherit state for the given object(s)
-preserve(-p) createquery
preserve the objects world-space position by modifying the object(s) transformation matrix.
-toggle(-tgl) createquery
toggle the inherit state for the given object(s) (default if no flags are given) -on turn on inherit state for the given object(s) -off turn off inherit state for the given object(s)

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// create an circle, move it off center, group it
// and move the group so that the circle is back in center
circle -nr 0 1 0 -n circle1; move 2 0 0;
group; move -2 0 0;

// turn off inherits transform flag of circle1.
// The circle will now appear at (2, 0, 0)
inheritTransform -off circle1;

// turn off inherits transform flag of circle1 but preserve the
// position of the circle. The circle will stay centered at (0, 0, 0)
inheritTransform -on circle1;
inheritTransform -off -preserve circle1;

// query state of inherits transform flag
inheritTransform -q circle1;