Show frames

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

Synopsis

hilite [-replace] [-toggle] [-unHilite] [objects]

hilite is undoable, NOT queryable, and NOT editable.

Hilites/Unhilites the specified object(s). Hiliting an object makes it possible to select the components of the object. If no objects are specified then the selection list is used.

Return value

None

Flags

replace, toggle, unHilite
Long name (short name) Argument types Properties
-replace(-r) create
Hilite the specified objects. Any objects previously hilited will no longer be hilited.
-toggle(-tgl) create
Toggle the hilite state of the specified objects.
-unHilite(-u) create
Remove the specified objects from the hilite list.
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 a few objects.
//
string $sphere[] = `sphere`; move -relative 0 0 3;
string $cone[] = `cone`; move -relative 0 0 -3;
string $cylinder[] = `cylinder`;

//    Select the sphere.
//
select -replace $sphere;

//    Add the cone and cylinder to the hilite list.
//
hilite $cone[0] $cylinder[0];

//    Toggle the hilite state of the cylinder.
//
hilite -toggle $cylinder[0];

//    Replace the hilite list with the current selected objects.
//
hilite -replace;