namespace

ジャンプ先: 概要. 戻り値. 関連項目. フラグ. Python 例.

概要

namespace( [string] , [absoluteName=boolean], [addNamespace=string], [collapseAncestors=string], [exists=string], [force=boolean], [isRootNamespace=string], [moveNamespace=[string, string]], [parent=string], [recurse=boolean], [relativeNames=boolean], [removeNamespace=string], [rename=[string, string]], [setNamespace=string])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

namespace は 「元に戻す」が可能、「照会」が可能、「編集」が不可能 です。

戻り値

戻り値の型は照会モードでは照会フラグが基になります。

関連項目

フラグ

ロング ネーム（ショート ネーム）	引数型	プロパティ
addNamespace(add)	string
指定した名前のネームスペースを作成します。
exists(ex)	string
指定したネームスペースがある場合は true、ない場合は false を返します。
isRootNamespace(ir)	string
指定したネームスペースがルートの場合は true、ルートでない場合は false を返します。
force(f)	boolean
名前の衝突を無視する移動操作を強制的に実行するために -mv/-moveNamespace と一緒に使用します。
moveNamespace(mv)	[string, string]
1 番目のネームスペースの内容を 2 番目のネームスペースに移動します。 子ネームスペースも移動されます。 参照されたノードノードを含むネームスペースを移動しようとすると、エラーが発生します。「file -e -namespace」コマンドを使用して、リファレンス ネームスペースを変更してください。 移動元のネームスペースに移動先のネームスペース内のオブジェクトと同じ名前のオブジェクトが含まれる場合、エラーが発生します。「-force」フラグを使用してこのエラーを無効にしてください。オブジェクトの名前を変更して固有な名前にすると、名前の衝突を解決できます。
parent(p)	string
-add/-addNamespace と一緒に使用して、新規のネームスペースの親を指定します。
relativeNames(rel)	boolean
名前をカレントのネームスペースに相対してルックアップする、相対名のルックアップ モードをオンにします。デフォルトではオフのため、名前のルックアップは常にルート ネームスペース相対になります。setAttr などのコマンドの動作が変わるため、この機能をオンにする場合はご注意ください。ネームスペース非依存のカスタム プロシージャを実行する際に relativeNames をオンにし、カスタム プロシージャから制御を戻す際にこの機能をオフにすることをお勧めします。 なお、相対命名はファイル I/O 時にオンになります。relativeNames をオンのままにしておくことは推奨しませんが、ファイル I/O 時に値を切り替えようとすると、Maya 内部で一時的に有効にされているために「オン」のままになります。 relativeNames を有効にすると、「ls」コマンドの戻り値はカレントのネームスペース相対になります。詳細については、このコマンドの説明を参照してください。
removeNamespace(rm)	string
指定したネームスペースを削除します。削除するためには、そのネームスペースは空でなければなりません。
rename(ren)	[string, string]
1 番目のネームスペースの名前を 2 番目のネームスペースの名前に変更します。子ネームスペースの名前も変更されます。どちらの名前もカレントのネームスペースに相対します。-parent フラグを使用して、名前を変更したネームスペースの親ネームスペースを指定します。 2 番目のネームスペース名がすでに存在する場合はエラーになります。
setNamespace(set)	string
カレント ネームスペースを設定します。
recurse(r)	boolean
-exists フラグと一緒に使用して、指定したネームスペースを再帰的に探します
absoluteName(an)	boolean
戻り値がネームスペースの場合に、ネームスペースの値を 絶対形式で返します。ネームスペースの絶対名とは、 ルートのネームスペース名と「:」が付いたプリフィックスで 始まる名前です。
collapseAncestors(ch)	string
指定されたネームスペースのすべての空の先祖を削除します。 空のネームスペースとは、DAG オブジェクトまたはネストされたネームスペースを まったく含まないネームスペースです。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

import maya.cmds as cmds

# Create three namespaces
cmds.namespace( add='FOO' )
cmds.namespace( add='BAR' )
cmds.namespace( add='FRED' )

# Set the current namespace to FOO
cmds.namespace( set='FOO' )

# Create the namespace BAR Under FOO. Note there are
# two "BAR" namespaces, :BAR and :FOO:BAR.
cmds.namespace( add='BAR' )

# Check to see that the BAR namespace exists within the current
# namespace (FOO)
cmds.namespace( exists='BAR' )
# Result: 1 #

# Check to see that the FRED namespace exists under the root namespace
cmds.namespace( exists=':FRED' )
# Result: 1 #

# Create two objects. It gets added to the current namespace FOO;
cmds.sphere( n='sphere1' )
cmds.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.
cmds.rename( 'FOO:sphere1', 'BAR:sphere1' )
# Result: FOO:BAR:sphere1 #

# Move sphere2 from namespace FOO to BAR.  Note the leading
# colon on the new name.
cmds.rename( 'FOO:sphere2', ':BAR:sphere2' )
# Result: BAR:sphere2 #

# query the current namespace (using the namespaceInfo command)
cmds.namespaceInfo( currentNamespace=True )
# Result: FOO #

# remove the namespace FRED (it must be empty)
cmds.namespace( set=':' )
cmds.namespace( rm='FRED' )

# Check to see that the FRED namespace has been removed
cmds.namespace( query=True, 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.
cmds.namespace( set=':' )
cmds.namespace( add='JOE' )
cmds.namespace( mv=('BAR', 'JOE') )
cmds.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.
cmds.namespace( set=':' )
cmds.namespace( add='FRANK' )
cmds.namespace( set='FRANK' )
cmds.sphere( n='sphere2' )
cmds.namespace( force=True, 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 given namespace is root
#
cmds.namespace( query=True, isRootNamespace="FOO" )

#Set return value to be absolute namespace name
#
print(cmds.namespace(add = "testAbsoluteName", absoluteName = true))

#Create a sample hierachy that contains only empty namespaces, then collapse it
#
cmds.namespace( set = ":");
cmds.namespace( add = "emptyLevel1");
cmds.namespace( add = "emptyLevel2", parent = "emptyLevel1");
cmds.namespace( add = "leaf", parent = "emptyLevel1:emptyLevel2");
cmds.namespace( collapseAncestors = "emptyLevel1:emptyLevel2:leaf");