ジャンプ先: 概要. 戻り値. フラグ. Python 例.
runTimeCommand(
name
, [addKeyword=string], [addTag=string], [annotation=string], [category=string], [categoryArray=boolean], [command=script], [commandArray=boolean], [commandLanguage=string], [default=boolean], [defaultCommandArray=boolean], [delete=boolean], [exists=boolean], [helpUrl=string], [hotkeyCtx=string], [image=string], [keywords=string], [label=string], [longAnnotation=string], [numberOfCommands=boolean], [numberOfDefaultCommands=boolean], [numberOfUserCommands=boolean], [plugin=string], [save=boolean], [showInHotkeyEditor=boolean], [tags=string], [userCommandArray=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
runTimeCommand は、取り消し可能、照会可能、および編集可能です。
指定した名前で MEL コマンドを作成します。作成されたコマンドはその他の MEL コマンドと同様に起動できます。このコマンドを起動すると、command フラグにアタッチされている文字列が実行されます。
作成されたコマンドが、引数とフラグを取らないことに注意してください。照会や編集もできません。
指定するコマンド名は固有である必要があります。名前自体は、英字かアンダースコアで始める必要があり、その後は英数字かアンダースコアを続けることができます。
起動時に自動的に読み込まれるスクリプトでランタイム コマンドを作成する場合は、default フラグを true に設定します。このように設定すると、アプリケーションがラン タイム コマンドを保存しようとしなくなります。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
addKeyword, addTag, annotation, category, categoryArray, command, commandArray, commandLanguage, default, defaultCommandArray, delete, exists, helpUrl, hotkeyCtx, image, keywords, label, longAnnotation, numberOfCommands, numberOfDefaultCommands, numberOfUserCommands, plugin, save, showInHotkeyEditor, tags, userCommandArray
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Create a command that simply prints a message. After executing
# the following lines enter the command name <i>MyHelloCommand</i>
# in the Command Line.
#
if maya.cmds.runTimeCommand( 'MyHelloCommand', exists=True ):
cmds.runTimeCommand( annotation='Print the word "Hello"', command='print "Hello\\n"', MyHelloCommand )
# Create a window with a button that invokes the <i>MyHelloCommand</i>
# command.
#
cmds.window()
cmds.paneLayout()
# Some commands support different language source types. Since the button command does not, it
# assumes Python and the command has to be explicitly forwarded to MEL, which is what the runTimeCommand creates.
cmds.button( command='import maya.mel; mel.eval("MyHelloCommand")' )
cmds.showWindow();