Go to: Synopsis. Return value. Flags. MEL examples.
pickWalk [-direction string] [-type string] [objects]
pickWalk is undoable, NOT queryable, and NOT
editable.
The pickWalk command allows you to quickly change the selection
list relative to the nodes that are currently selected. It is
called pickWalk, because it walks from one selection list to
another by unselecting what's currently selected, and selecting
nodes that are in the specified direction from the currently
selected list. If you specify objects on the command line, the
pickWalk command will walk from those objects instead of the
selected list. If the -type flag is instances, then the left and
right direction will walk to the previous or next instance of the
same selected dag node.
| string[] |
A list of the newly selected items |
direction, type
| Long name (short name) |
Argument types |
Properties |
-direction(-d) |
string |
 |
|
The direction to walk from the node. The choices are up | down
| left | right | in | out. up walks to the parent node, down to the
child node, and left and right to the sibling nodes. If a CV on a
surface is selected, the left and right directions walk in the U
parameter direction of the surface, and the up and down directions
walk in the V parameter direction. In and out are only used if the
type flag is 'latticepoints'. Default is right. |
|
-type(-typ) |
string |
|
|
The choices are nodes | instances | edgeloop | edgering |
faceloop | keys | latticepoints | motiontrailpoints. If type is
nodes, then the left and right direction walk to the next dag
siblings. If type is instances, the left and right direction walk
to the previous or next instance of the same dag node. If type is
edgeloop, then the edge loop starting at the first selected edge
will be selected. If type is edgering, then the edge ring starting
at the first selected edge will be selected. If type is faceloop,
and there are two connected quad faces selected which define a face
loop, then that face loop will be selected. edgeloop, edgering and
faceloop all remember which was the first edge or faces selected
for as long as consecutive selections are made by this command.
They use this information to determine what the "next" loop or ring
selection should be. Users can make selections forwards and
backwards by using the direction flag with "left" or "right". If
type is motiontrailpoints, then the left and right direction walk
to the previous or next motion trail points respectively. Default
is nodes. |
|
| 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. |
// Given the transforms A and B which are parented to a transform C,
// and C is instanced with parents D and E.
pickWalk -d right A
// Result: B //
select |E|C
pickWalk -d up
// Result: E //
select |E|C
pickWalk -typ instances -d left
// Result: /E/D //
// The pickWalk command also works on CVs and edit points
select nurbPlaneShape1.cv[2][1];
pickWalk -d right;
// Result: nurbPlaneShape1.cv[3][1] //
pickWalk -d up;
// Result: nurbPlaneShape1.cv[3][2] //
select curveShape2.ep[1];
pickWalk -d left;
// Result: curveShape2.ep[0] //
// Create a poly plane to test loop and ring selections
polyPlane -w 1 -h 1 -sx 10 -sy 10 -ax 0 1 0 -cuv 2 -ch 1;
// ,Result:, pPlane1 polyPlane1 //
select -r pPlane1.e[114] ;
pickWalk -type "edgeloop";
// ,Result:, pPlane1.e[9] pPlane1.e[30] pPlane1.e[51] pPlane1.e[72] pPlane1.e[93] pPlane1.e[114] pPlane1.e[135] pPlane1.e[156] pPlane1.e[177] pPlane1.e[198] //
pickWalk -type "edgeloop" -d left;
// ,Result:, pPlane1.e[7] pPlane1.e[28] pPlane1.e[49] pPlane1.e[70] pPlane1.e[91] pPlane1.e[112] pPlane1.e[133] pPlane1.e[154] pPlane1.e[175] pPlane1.e[196] //
pickWalk -type "edgeloop" -d left;
// ,Result:, pPlane1.e[5] pPlane1.e[26] pPlane1.e[47] pPlane1.e[68] pPlane1.e[89] pPlane1.e[110] pPlane1.e[131] pPlane1.e[152] pPlane1.e[173] pPlane1.e[194] //
pickWalk -type "edgeloop" -d right;
// ,Result:, pPlane1.e[7] pPlane1.e[28] pPlane1.e[49] pPlane1.e[70] pPlane1.e[91] pPlane1.e[112] pPlane1.e[133] pPlane1.e[154] pPlane1.e[175] pPlane1.e[196] //
pickWalk -type "edgeloop" -d right;
// ,Result:, pPlane1.e[9] pPlane1.e[30] pPlane1.e[51] pPlane1.e[72] pPlane1.e[93] pPlane1.e[114] pPlane1.e[135] pPlane1.e[156] pPlane1.e[177] pPlane1.e[198] //
// After going "left" twice and then "right" twice we are now back to the original edge loop selection.
// select a couple of connected faces to walk.
select -r pPlane1.f[44] pPlane1.f[54] ;
pickWalk -type "faceloop";
// ,Result:, pPlane1.f[4] pPlane1.f[14] pPlane1.f[24] pPlane1.f[34] pPlane1.f[44] pPlane1.f[54] pPlane1.f[64] pPlane1.f[74] pPlane1.f[84] pPlane1.f[94] //
pickWalk -type "faceloop" -d left;
// ,Result:, pPlane1.f[5] pPlane1.f[15] pPlane1.f[25] pPlane1.f[35] pPlane1.f[45] pPlane1.f[55] pPlane1.f[65] pPlane1.f[75] pPlane1.f[85] pPlane1.f[95] //
pickWalk -type "faceloop" -d left;
// ,Result:, pPlane1.f[6] pPlane1.f[16] pPlane1.f[26] pPlane1.f[36] pPlane1.f[46] pPlane1.f[56] pPlane1.f[66] pPlane1.f[76] pPlane1.f[86] pPlane1.f[96] //
pickWalk -type "faceloop" -d right;
// ,Result:, pPlane1.f[5] pPlane1.f[15] pPlane1.f[25] pPlane1.f[35] pPlane1.f[45] pPlane1.f[55] pPlane1.f[65] pPlane1.f[75] pPlane1.f[85] pPlane1.f[95] //
pickWalk -type "faceloop" -d right;
// ,Result:, pPlane1.f[4] pPlane1.f[14] pPlane1.f[24] pPlane1.f[34] pPlane1.f[44] pPlane1.f[54] pPlane1.f[64] pPlane1.f[74] pPlane1.f[84] pPlane1.f[94] //