ls

ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

ls [-absoluteName] [-allPaths] [-assemblies] [-cameras] [-containerType string] [-containers] [-dagObjects] [-defaultNodes] [-dependencyNodes] [-exactType string] [-excludeType string] [-flatten] [-geometry] [-ghost] [-head int] [-hilite] [-intermediateObjects] [-invisible] [-leaf] [-lights] [-live] [-lockedNodes] [-long] [-materials] [-modified] [-noIntermediate] [-nodeTypes] [-objectsOnly] [-orderedSelection] [-partitions] [-persistentNodes] [-planes] [-preSelectHilite] [-readOnly] [-recursive boolean] [-referencedNodes] [-references] [-renderGlobals] [-renderQualities] [-renderResolutions] [-renderSetups] [-selection] [-sets] [-shapes] [-shortNames] [-showNamespace] [-showType] [-tail int] [-templated] [-textures] [-transforms] [-type string] [-ufeObjects] [-undeletable] [-untemplated] [-uuid] [-visible] [object [object...]]

ls は、取り消し可能、照会不可能、および編集不可能です。

ls は一般的に、名前(ワイルドカードを含む)またはタイプに基づいて、オブジェクトのフィルタ処理または突き合せを行うのに使用します。既定では ls コマンドはシーン内のすべてのオブジェクトと突き合せを行いますが、-selection フラグを一緒に使用すると、選択したオブジェクトをフィルタリングまたはリスト表示することができます。

showType フラグを使用してタイプ名を要求すると、結果はオブジェクト名を挟んだ <object, type> の組み合わせで返されます。

内部ノード(例: itemFilter ノード)は、通常、シーン オブジェクトのみを返すようにフィルタリングされます。ただし、ワイルドカードを使用すると、ワイルドカードに一致するすべてのノードが内部ノードも含めて表示されてしまいます。たとえば、ls * の場合、内部ノードかどうかに関係なくすべてのノードがリスト表示されます。

ノードをリストするときに再帰的ネームスペース検索を指示するには、構文「::」を使用します。たとえば、ls "::pSphere1" は、深度にかかわらず、すべてのネームスペース内の「pSphere1」という名前のオブジェクトと一致します。ls "ns::*" は、ネームスペース「ns」または子ネームスペース内の任意のノードと一致します。

Maya が relativeNames モードにある場合、ls コマンドは現在のネームスペースに関連する名前を返し、ls * は現在のネームスペースからリスト表示します。詳細については、namespace コマンドの -relativeNames フラグを参照してください。

このコマンドは、名前/パスでなくノードの UUID を渡すこともできます。-uuid フラグを指定すると、名前でなく UUID を返すことができます。

戻り値

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-absoluteName(-an)
このフラグを showNamespace フラグと一緒に使用することで、コマンドによって返されるネームスペースが絶対ネームスペース フォーマットになるように指定できます。ネームスペースの絶対名は、ルート ネームスペース「:」で始まり、すべての親ネームスペースを含むフル ネームスペース パスです。たとえば、「:ns:ball」は絶対ネームスペース名ですが、「ns:ball」は絶対ネームスペース名ではありません。絶対ネームスペース名は不変であり、現在のネームスペースまたは相対ネームスペース モードの影響を受けません。
-allPaths(-ap)
DAG 内にあるノードのすべてのパスがリストされます。このフラグは、-dag も指定した場合、またはオブジェクト名を指定した場合に限って動作します。
-assemblies(-as)
最上位レベルのトランスフォーム DAG オブジェクトがリストされます。
-cameras(-ca)
カメラのシェイプがリストされます。
-containerType(-ct)	string
指定のユーザ定義タイプを伴うリスト コンテナです。 このフラグは、type または exactType フラグと一緒に使用できません。
-containers(-con)
コンテナをリストします。標準コンテナと dagContainers などの別のコンテナ タイプの両方を含みます。
-dagObjects(-dag)
すべてのタイプの DAG オブジェクトがリストされます。オブジェクト名引数をコマンドに渡した場合、このフラグでは、指定したオブジェクトの下にすべての DAG オブジェクトがリストされます。
-defaultNodes(-dn)
既定のノードを返します。既定のノードとは、Maya が自動的に作成するノードで、シーンとともに保存されないノードです。ただし、ノードのいくつかアトリビュート値は保存することができます。
-dependencyNodes(-dep)
ディペンデンシー ノードがリストされます(DAG オブジェクトを含む)。
-exactType(-et)	string
指定したタイプのオブジェクトをすべてリストします。ただし、そのタイプの下層にあるオブジェクトはリストしません。このフラグは、コマンド ラインで複数回使用できます。注: このフラグに渡すタイプは、showType フラグで返されるタイプ名と同じになります。 このフラグは、type または excludeType フラグと一緒に使用できません。
-excludeType(-ext)	string
指定したタイプではないすべてのオブジェクトがリストされます。このフラグは、コマンド ラインで複数回使用できます。注: このフラグに渡すタイプは、showType フラグで返されるタイプ名と同じになります。 このフラグは、type または exactType フラグと一緒に使用できません。
-flatten(-fl)
返されるオブジェクトのリストを平らにし、それぞれのコンポーネントを個別に識別できるようにします。
-geometry(-g)
ジオメトリ DAG オブジェクトがリストされます。
-ghost(-gh)
ゴースト化オブジェクトがリストされます。
-head(-hd)	int
項目のリストの先頭から返される要素の最大数を指定します。注: それぞれの type フラグでは、最大でこの数の項目が返されます。複数の type フラグを指定すると、返される項目の数は、指定した値より多くなります。
-hilite(-hl)
コンポーネント選択で現在ハイライトされているオブジェクトがリストされます。
-intermediateObjects(-io)
中間 DAG ノードのみがリストされます。
-invisible(-iv)
表示されない DAG ノードのみがリストされます。
-leaf(-lf)
DAG のすべてのリーフ ノードがリストされます。このフラグはモディファイアなので、-dag フラグと一緒に使用する必要があります。
-lights(-lt)
ライトのシェイプがリストされます。
-live(-lv)
現在ライブにしているオブジェクトがリストされます。
-lockedNodes(-ln)
ロックされたノードを返します。これらのノードは削除も名前の変更もできません。ただし、ステータスは変更できます。
-long(-l)
DAG オブジェクトのフル パス名が返されます。既定では、最も短い固有の名前を返します。
-materials(-mat)
マテリアルまたはシェーディング グループがリストされます。
-modified(-mod)
このフラグを設定した場合、最後の保存後に変更されたノードのみが返されます。
-noIntermediate(-ni)
中間以外の DAG ノードのみがリストされます。
-nodeTypes(-nt)
登録されているすべてのノード タイプがリストされます。
-objectsOnly(-o)
設定すると、オブジェクト名のみが返され、コンポーネントやアトリビュートは無視されます。
-orderedSelection(-os)
オブジェクトとコンポーネントを現在の選択順でリスト表示します。このフラグは、selectPref コマンドの -tso/trackSelectionOrder フラグの値に依存します。そのフラグが有効になっていなければ、このフラグは -sl/selection フラグと同じものを返します。
-partitions(-pr)
パーティションがリストされます。
-persistentNodes(-pn)
永続ノードを返します。これは「file」 > 「new」の後の Maya セッションでも存続するノードです。ファイル > 新規でリセットされない特殊なクラスの既定のノードがあります。たとえば、itemFilter ノード、selectionListOperator ノードです。
-planes(-pl)
コンストラクション プレーンのシェイプがリストされます。
-preSelectHilite(-psh)
プリ選択で現在ハイライトされているコンポーネントがリストされます。
-readOnly(-ro)
参照されたノードを返します。参照されたノードは読み取り専用です。注: 廃止されました。「-referencedNodes」を使用してください。
-recursive(-r)	boolean
true に設定すると、このコマンドはすべてのネームスペースから合致する名前を探します。false に設定すると、要求されたネームスペースだけから探します(たとえば「:」を含む名前を指定すると、「ns1:pSphere1」)。
-referencedNodes(-rn)
参照されたノードを返します。参照されたノードは読み取り専用です。
-references(-rf)
ファイルに関連するリファレンスをリストします。sharedReferenceNode や不明リファレンス ノードなどの特別なリファレンス ノードは除外します。
-renderGlobals(-rg)
レンダー グローバルがリストされます。
-renderQualities(-rq)
指定したレンダー画質がリストされます。
-renderResolutions(-rr)
レンダー解像度がリストされます。
-renderSetups(-rs)
-renderGlobals のエイリアス。
-selection(-sl)
現在選択しているオブジェクトがリストされます。
-sets(-set)
セットがリストされます。
-shapes(-s)
シェイプ オブジェクトがリストされます。
-shortNames(-sn)
アトリビュートのショート ネームが返されます。既定では、アトリビュートのロング ネームが返されます。
-showNamespace(-sns)
オブジェクト名の後に各オブジェクトのネームスペースを表示します。 このフラグは showType フラグと一緒に使用することはできません。
-showType(-st)
オブジェクト名の後にタイプがリストされます。
-tail(-tl)	int
項目のリストの末尾から返される要素の最大数を指定します。注: それぞれの type フラグでは、最大でこの数の項目が返されます。複数の type フラグを指定すると、返される項目の数は、指定した値より多くなります
-templated(-tm)
テンプレート化 DAG ノードのみがリストされます。
-textures(-tex)
テクスチャがリストされます。
-transforms(-tr)
トランスフォーム オブジェクトがリストされます。
-type(-typ)	string
指定したタイプのすべてのオブジェクトがリストされます。このフラグは、コマンド ラインで複数回使用できます。注: このフラグに渡すタイプは、showType フラグで返されるタイプ名と同じになります。注: Maya での一部の選択項目は、特定オブジェクト/データ タイプが関連しないので、このフラグでリストすると「untyped」が返されます。 このフラグは、exactType または excludeType フラグと一緒に使用できません。
-ufeObjects(-ufe)
-sl/selection フラグと一緒に使用すると、ネイティブの Maya オブジェクトだけでなく、UFE インタフェースによって定義されているオブジェクトも返されます。
-undeletable(-ud)
削除できないノード(ロックされたノードを含む)を返します。削除できないノードは名前の変更もできません。
-untemplated(-ut)
テンプレート化が解除された DAG ノードのみがリストされます。
-uuid(-uid)
ノード名の代わりに ノードの UUID を返します。「UUID パス」がないことにご注意ください。このフラグと -long フラグなどを組み合わせた場合、ノード UUID のパスは形成されません。
-visible(-v)
可視 DAG ノードのみがリストされます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// create some objects to operate on and select them all.
// Note that there are two objects named circle1;
circle -n circle1; group; circle -n circle1;
sphere -n sphere1; group; instance;
select -ado;

// list all objects
ls;

// List all selected objects
ls -selection;

// List all hilited objects
ls -hilite;

// List last selected object
ls -selection -tail 1;

// List all objects named "sphere1". Note that since sphere1 is
// instanced, the command below lists only the first instance.
ls sphere1;

// To list all instances of sphere1, use the -ap/allPaths flag.
ls -ap sphere1;

// List all selected objects named "group*"
ls -sl "group*";

// List all geometry, lights and cameras in the DAG.
ls -geometry -lights -cameras;

// List all shapes in the dag.
ls -shapes;

// One thing to note is that it is better to always use the
// -l/long flag when listing nodes without any filter. This is
// because there may be two nodes with the same name (in this
// example, circle1). 'ls' will list the names of all the objects
// in the scene. Objects with the same name need a qualified
// path name which uniquely identifies the object. A command
// to select all objects such as "select `ls`" will fail because
// the object lookup can't resolve which "circle1" object is
// intended. To select all objects, you need the following:
// select `ls -l`;

// When trying to find a list of all objects of a specific
// type, one approach might be to list all objects and then
// use the nodeType command to then filter the list. As in:
// string  $allObjects[];
// string  $obj;
// $allObjects = `ls -l`;
// for ( $obj in $allObjects ) {
//     if ( `nodeType $obj` == "surfaceShape" ) {
//         print ($obj + "\n");
//     }
// }
//
// The problem with this is that 'nodeType' returns the
// most derived type of the node. In this example, "surfaceShape"
// is a base type for nurbsSurface so nothing will be printed.
// To do this properly, the -typ/type flag should be used
// to list objects of a specific type as in:
// $allObjects = `ls -type surfaceShape`;
// for ( $obj in $allObjects ) {
//     print ($obj + "\n");
// }

// List all geometry shapes and their types
ls -type geometryShape -showType;

// List all paths to all leaf nodes in the DAG
ls -dag -lf -ap;

// List all nodes below the selected node
ls -dag -ap -sl;

// List all ghosting objects
ls -ghost;

// List all dag nodes that are read-only (i.e. referenced nodes)
ls -dag -ro;

// List reference nodes associated with specific files
ls -references;

// List all reference nodes, including unknown and shared reference
// nodes
ls -type reference;

// Select some components and then get the list in both selected and numeric order
string $obj1[] = `polySphere -r 1 -sx 20 -sy 20 -ax 0 1 0 -cuv 2 -ch 1`;
select -clear;
selectPref -trackSelectionOrder 1;

select ($obj1[0]+".f[100]");
select -add ($obj1[0]+".f[50:55]");
select -add ($obj1[0]+".f[0]");
select -add ($obj1[0]+".f[56:60]");

// regular -selection flag returns the components in compacted numeric order.
ls -selection;
// Result: pSphere1.f[0] pSphere1.f[50:60] pSphere1.f[100] //
// -orderedSelection flag returns the components in the order that we selected them.
ls -orderedSelection;
// Result: pSphere1.f[100] pSphere1.f[50:55] pSphere1.f[0] pSphere1.f[56:60] //

// turn off tracking when we are done
selectPref -trackSelectionOrder 0;

// init some namespace
namespace -add "A:B:C";

// add object into namespace
namespace -set ":A:B";
polySphere -name "obj1";
namespace -set ":A:B:C";
polySphere -name "obj1";
polySphere -name "obj2";

// The current Namespace is ":A:B:C" and relative mode is off
// List all objects and their namespace in the scene
// If the object is in the root namespace, then return root ":"
// Note that the results shown below have been elided (...) for documentation purposes.
ls -showNamespace;
// Result: time1 : sequenceManager1 : renderPartition :  (...) A:B:obj1 A:B A:B:C:obj1 A:B:C A:B:C:obj2 A:B:C //

select -r ":A:B:obj1";
select -add ":A:B:C:obj2";

// List both name and namespace of each selected object
ls -showNamespace -selection;
// Result: A:B:obj1 A:B A:B:C:obj2 A:B:C //

// List name and namespace of all objects named "obj1"
ls -showNamespace -recursive true "obj1";
// Result: A:B:obj1 A:B A:B:C:obj1 A:B:C //

// Set current namespace
namespace -set ":A:B";

// Enable relative mode
namespace -relativeNames true;

// Now the current namespace is ":A:B" and relative mode is on
// Note that the name of the current namespace is "" in relative mode
// List both name and namespace of each selected objects
ls -showNamespace -selection;
// Result: obj1  C:obj1 C //

// Make a new scene, modify the transform of the camera perspective, play with the timeline and modify the camera's shape
file -new -force
setAttr "persp.translateX" 10;
currentTime 8 ;
setAttr "perspShape.horizontalFilmAperture" 16;

// List all modified objects of type camera and type time
ls -modified -type time -type camera;
// Result: perspShape time1 //

ls -modified;
// Result: persp perspShape time1 //

ls -excludeType camera -modified
// Result: persp time1 //

// Return a node's UUID
ls -uuid sphere1;
// Result: ECE85CCC-438D-8113-0236-39A6917DE484 //

// Find a node by UUID
ls "ECE85CCC-438D-8113-0236-39A6917DE484";
// Result: group2|sphere1 //