namespace command

概要

namespace [-absoluteName] [-addNamespace string] [-collapseAncestors string] [-deleteNamespaceContent] [-exists string] [-force] [-isRootNamespace string] [-mergeNamespaceWithParent] [-mergeNamespaceWithRoot] [-moveNamespace string string] [-parent string] [-recurse] [-relativeNames boolean] [-removeNamespace string] [-rename string string] [-setNamespace string] [-validateName string] [string]

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

このコマンドを使用して、ネームスペースを作成、設定、または除去できます。

ネームスペースとは、特定の名前で複数のオブジェクトを単にグループ化したものです。ネームスペースは、主に Maya での名前の衝突を回避するために使用されます。名前の衝突とは、ファイルを読み込んだ場合などに、新規のオブジェクトが既存のオブジェクトと同じ名前を持つことを指します。ネームスペースを使用すると、2 つのオブジェクトが別のネームスペースにあれば、同じ名前を付けることができます。

ネームスペースは、ファイルシステムのような階層状の構造になっていると考えてください。ネームスペースはディレクトリにあたり、オブジェクトはファイルにあたります。ネームスペース名を区切るには、コロン(':')記号を使用します。スラッシュ('/')や円記号('¥')は使用しません。ネームスペースは、オブジェクトだけでなく、他のネームスペースを含むことができます。オブジェクト同様、1つのネームスペース内い含めるネームスペース名はそれぞれ固有でなければなりません。オブジェクトおよびネームスペースは、1つのネームスペースにしか存在できません。ネームスペース名とオブジェクト名は衝突しないため、1つのネームスペース内であっても、ネームスペースとオブジェクトは同じ名前にすることができます。

コロン(':')に続けて、名称が未設定のルートネームスペースが指定されています。名前のついたネームスペースにない他のすべてのオブジェクトは、ルートネームスペースにあります。オブジェクト名の前のコロンはなくてもわかるため、通常は省略されています。最初のコロンが重要になるのは、「rename」コマンドを使用して、ネームスペース間でオブジェクトを移動する場合です。「rename」コマンドでは、新規の名前は現在のネームスペースに関連します。ただし、最初のコロンを使用した完全な名前の場合にはこの限りではありません。

ネームスペースの作成には「add/addNamespace」フラグが使用されます。既定では、現在のネームスペースに作成されます。現在のネームスペースの変更は、「set/setNamespace」フラグで行います。現在のネームスペースをルートネームスペースにリセットするには、「namespace -set ":";」を使用します。オブジェクトが作成されると、既定で現在のネームスペースに追加されます。

修飾された名前を使用して新しいネームスペースを作成すると、まだ存在していない中間ネームスペースが自動的に作成されます。たとえば、新しいネームスペースの名前を「A:B」と指定し、現在のネームスペースに「A」という子ネームスペースがすでに含まれている場合は、「B」という新しい子ネームスペースが「A」の下に作成されます。ただし、現在のネームスペースに「A」という子がまだ含まれていない場合は、「A」が自動的に作成されます。これは指定した名前(「A:B:C:D」など)に含まれているレベルの数に関係なく適用されます。

「p/-parent」フラグを使用すると、単に現在のネームスペースを既定にする代わりに、新しいネームスペースの作成先の親ネームスペースを明示的に指定できます。

新しいネームスペースに対して指定した名前が絶対名(「:A:B」のようにコロンで始まる名前)である場合は、現在のネームスペースと「parent」フラグの両方が無視され、ルートネームスペースに新しいネームスペースが作成されます。

relativeNamespace フラグを使用して、ノード名の UI 上での表示方法や「ls」コマンドによって返される方法を変更することができます。「ls」コマンドの戻り値の、relativeNamespace モードでの動作に関する詳細を以下に記します。

戻り値

string

コマンドの結果

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

absoluteName, addNamespace, collapseAncestors, deleteNamespaceContent, exists, force, isRootNamespace, mergeNamespaceWithParent, mergeNamespaceWithRoot, moveNamespace, parent, recurse, relativeNames, removeNamespace, rename, setNamespace, validateName

ロングネーム(ショートネーム) 引数タイプ プロパティ

-absoluteName(-an)

コマンドによって返されるネームスペースの目的のフォーマットを指定するために使用できる汎用フラグです。ネームスペースの絶対名は、ルートネームスペース「:」で始まり、すべての親ネームスペースを含むフルネームスペースパスです。たとえば、「:ns:ball」は絶対ネームスペース名ですが、「ns:ball」は絶対ネームスペース名ではありません。

-addNamespace(-add) string

指定した名前のネームスペースを作成します。修飾された名前(「A:B」)と修飾されていない名前(「A」)の両方を使用できます。修飾された名前に含まれている高レベルのネームスペースの中にまだ存在しないものがある場合は、それらのネームスペースが作成されます。指定された名前に無効な文字が含まれている場合は、まず validateName フラグに従って修正されます。

-collapseAncestors(-ch) string

指定されたネームスペースのすべての空の先祖を削除します。空のネームスペースとは、オブジェクトまたはその他のネストされたネームスペースをまったく含まないネームスペースです。

-deleteNamespaceContent(-dnc)

ネームスペースの除去時に、ネームスペースの内容も除去されることを示すために、「rm/removeNamespace」フラグと一緒に使用します。

-exists(-ex) string

指定したネームスペースがある場合は true、ない場合は false を返します。

-force(-f)

名前の衝突を無視する移動操作を強制的に実行するために、「mv/-moveNamespace」と一緒に使用します。

-isRootNamespace(-ir) string

指定したネームスペースがルートの場合は true、ルートでない場合は false を返します。

-mergeNamespaceWithParent(-mnp)

「rm/-removeNamespace」フラグと一緒に使用します。ネームスペースを除去する場合、残りのネームスペースの内容を親ネームスペースに移動します。

-mergeNamespaceWithRoot(-mnr)

「rm/-removeNamespace」フラグと一緒に使用します。ネームスペースを除去する場合、残りのネームスペースの内容をルートネームスペースに移動します。

-moveNamespace(-mv) string string

1 番目のネームスペースの内容を 2 番目のネームスペースに移動します。子ネームスペースも移動されます。

参照されたノードを含むネームスペースを移動しようとすると、エラーが発生します。「file」コマンド(「file -edit -namespace」)を使用して、リファレンスネームスペースを変更してください。

移動元のネームスペースに移動先のネームスペース内のオブジェクトと同じ名前のオブジェクトが含まれる場合、エラーが発生します。「force」フラグを使用してこのエラーを無効にしてください。オブジェクトの名前を変更して固有な名前にすると、名前の衝突を解決できます。

-parent(-p) string

「addNamespace」または「rename」フラグと一緒に使用して、新しいネームスペースの親を指定します。ネームスペースの親のフルパスが必要です。「addNamespace」を絶対名を一緒に使用すると「parent」が無視され、警告が表示されます。

-recurse(-r)

「exists」フラグと一緒に使用して、指定したネームスペースを再帰的に探します。

-relativeNames(-rel) boolean

名前を現在のネームスペースに相対してルックアップする、相対名のルックアップモードをオンにします。既定ではオフのため、名前のルックアップは常にルートネームスペース相対になります。setAttr などのコマンドの動作が変わるため、この機能をオンにする場合はご注意ください。ネームスペース非依存のカスタムプロシージャを実行する際に relativeNames をオンにし、カスタムプロシージャから制御を戻す際にこの機能をオフにすることをお勧めします。なお、相対命名はファイル I/O 時にオンになります。relativeNames をオンのままにしておくことは推奨しませんが、ファイル I/O 時に値を切り替えようとすると、Maya 内部で一時的に有効にされているために「オン」のままになります。

relativeNames を有効にすると、「ls」コマンドの戻り値は現在のネームスペース相対になります。詳細については、このコマンドの説明を参照してください。

-removeNamespace(-rm) string

指定したネームスペースを削除します。削除するためには、そのネームスペースは空でなければなりません。

-rename(-ren) string string

1 番目のネームスペースの名前を 2 番目のネームスペースの名前に変更します。子ネームスペースの名前も変更されます。どちらの名前も現在のネームスペースに相対します。「parent」フラグを使用して、名前を変更したネームスペースの親ネームスペースを指定します。2 番目のネームスペース名がすでに存在する場合はエラーになります。指定された名前に無効な文字が含まれている場合は、まず validateName フラグに従って修正されます。

-setNamespace(-set) string

現在のネームスペースを設定します。

-validateName(-vn) string

不正な文字が含まれないように、指定された名前を有効な名前に変換します。先頭の不正な文字は除去され、その他の不正な文字は「_」に変換されます。特別に、先頭の数字と末尾のスペースも除去されます。フルパス名も同様に検証することができます。ただし、パスのネームスペースが存在しない場合、コマンドはベース名のみを返します。たとえば、「:nonExistentNS:name」は「name」に変換されます。先頭の数字のみが含まれる「123」のように、名前全体が不正な文字だけで構成されている場合、返される文字列は空になります。

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

MEL 例

  // Create three namespaces
  namespace -add "FOO";
  namespace -add "BAR";
  namespace -add "FRED";

  // Create namespace with qualified name
  namespace -add "A:B";

  // Create "C:D" under "A:B"
  namespace -add "C:D" -parent "A:B";

  // Create absolute name
  namespace -add ":A:B:C:D:E";

  // Set the current namespace to FOO
  namespace -set "FOO";

  // Create the namespace BAR Under FOO. Note there are
  // two "BAR" namespaces, :BAR and :FOO:BAR.
  namespace -add "BAR";

  // Validate the name
  namespace -validateName "name$space";
  // Result : name_space

  // Check to see that the BAR namespace exists within the current
  // namespace (FOO)
  namespace -exists "BAR";
  // Result: 1 //

  // Check to see that the FRED namespace exists under the root namespace
  namespace -exists ":FRED";
  // Result: 1 //

  // Create two objects. It gets added to the current namespace FOO;
  sphere -n sphere1;
  sphere -n sphere2;
  // Result: FOO:sphere2 //

  // Move sphere1 from namespace FOO to FOO:BAR. Note that we
  // need to qualify sphere1 with the namespace FOO because
  // "sphere1" identifies a non-existent object in the root namespace.
  rename FOO:sphere1 "BAR:sphere1";
  // Result: FOO:BAR:sphere1 //

  // Move sphere2 from namespace FOO to BAR.  Note the leading
  // colon on the new name.
  rename FOO:sphere2 :BAR:sphere2;
  // Result: BAR:sphere2 //

  // query the current namespace (using the namespaceInfo command)
  namespaceInfo -currentNamespace;
  // Result: FOO //

  // remove the namespace FRED (it must be empty)
  namespace -set ":";
  namespace -rm "FRED";

  // Check to see that the FRED namespace has been removed
  namespace -exists ":FRED";
  // Result: 0 //

  // Rename namespace BAR to JOE
  // Note: this is done by creating JOE, moving the contents of
  // BAR into JOE, and then removing the (now empty) BAR.
  namespace -set ":";
  namespace -add "JOE";
  namespace -mv "BAR" "JOE";
  namespace -rm "BAR";

  // JOE should now contain a single node: 'sphere2'.
  // Move the contents of JOE into FRANK, when FRANK already
  // has a 'sphere2' node. The '-force'
  // flag is needed.
  namespace -set ":";
  namespace -add "FRANK";
  namespace -set "FRANK";
  sphere -n "sphere2";
  namespace -force -mv ":JOE" ":FRANK";
  // In moving 'sphere2' from JOE to FRANK it will be renamed to
  // 'sphere3' to ensure uniqueness.
  // The namespace FRANK should now contain 'sphere2', 'sphere2Shape',
  // and 'sphere3'.

  // Determine whether the specified namespace is root
  //
  namespace -query -isRootNamespace "FOO";

  //Set return value to be absolute namespace name
  //
  string $retName = `namespace -add "testAbsoluteName" -absoluteName`;
  print $retName;

  //Create a sample hierachy that contains only empty namespaces, then collapse it
  //
  namespace -set ":";
  namespace -add "emptyLevel1";
  namespace -add "emptyLevel2" -parent "emptyLevel1";
  namespace -add "leaf" -parent "emptyLevel1:emptyLevel2";
  namespace -collapseAncestors "emptyLevel1:emptyLevel2:leaf";

  // Create a sample for "namespace -remove" command.
  // This command can also be used together with three option flag named
  // -deleteNamespaceContent/-mergeNamespaceWithParent/-mergeNamespaceWithRoot.
  // The functionality of the three option flags will also be displayed in the
  // following sample.
  // Note: The three option flags are mutually exclusive.
  //       The default way the "namespace -remove" acts is that it is used to
  //       remove a namespace that is empty. If you want to remove any namespace
  //       with contents, please add option flag -deleteNamespaceContent.
  //

  namespace -set ":";
  namespace -add ":RM_TEST_ROOT:FOO:BAR:JOE";
  sphere -n ":RM_TEST_ROOT:FOO:obj1";
  sphere -n ":RM_TEST_ROOT:FOO:BAR:obj2";

  // Trying to remove a namespace that is not empty without option flag,
  // user will get an error message show that maya cannot remove a namespace that
  // is not empty.
  //
  // namespace -removeNamespace ":RM_TEST_ROOT:FOO"; // Run this command you'll get an error.

  // Trying to remove an empty namespace.
  // Namespace :RM_TEST_ROOT:FOO:BAR:JOE has been removed successfully by the command.
  //
  namespace -removeNamespace ":RM_TEST_ROOT:FOO:BAR:JOE";

  undo; // Recover namespace structure.

  // Usage of -deleteNamespaceContent flag:
  // Remove all the contents in the target namespace specified in the command and
  // remove the namespace
  namespace -deleteNamespaceContent -removeNamespace ":RM_TEST_ROOT:FOO:BAR";

  undo; // Recover namespace structure.

  // Usage of -mergeNamespaceWithParent flag:
  // Move the content of the target namespace specified in the command to its parent
  // namespace and remove the namespace.
  namespace -mergeNamespaceWithParent -removeNamespace ":RM_TEST_ROOT:FOO:BAR";

  undo; // Recover namespace structure.

  // Usage of -mergeNamespaceWithRoot flag:
  // Move the content of the target namespace specified in the command to the root
  // namespace and remove the namespace.
  namespace -mergeNamespaceWithRoot -removeNamespace ":RM_TEST_ROOT:FOO:BAR";

コマンド (MEL)	Python バージョン
namespace	カテゴリ内: システム, ファイル