ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.

概要

artAttrTool([add=string], [exists=string], [remove=string])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

artAttrTool コマンドは、アトリビュート ペイントに使用するツール タイプのリストを管理します。このコマンドは、リスト内容の照会や新規ツールのリストへの追加をサポートします。ビルトインのツール セットを使用できることに注目してください。ビルトインのリストを照会するには、Maya を起動して「artAttrTool -q」を実行します。

このコマンドで管理するツールはすべて、アーティザンを使用したアトリビュート ペイント用です。artAttrCtx を使用して新しいコンテキストを作成する場合は、artAttrCtx の -whichTool フラグでツール名を指定します。通常は単純にビルトイン ツールを使用します。ただし、ツールにカスタムのプロパティと値のシートを関連付ける必要がある場合は、artAttrTool -add "toolName" を使用してカスタム ツールを定義する必要があります。カスタムのアトリビュート ペイント ツールのサンプルとして、開発キット サンプルの customtoolPaint.mel を参照してください。

戻り値

なし

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

キーワード

artisan, attribute, paint, context

関連

artAttrCtx

フラグ

add, exists, remove
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
add() string create
指定したツールをツールの内部リストに追加します。
exists(ex) string createquery
指定したツールが存在するかどうかをチェックし、見つかった場合は true を返し、見つからなければ false を返します。
remove(rm) string create
指定したツールをツールの内部リストから除去します。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Add a tool named "customtoolPaint" to the list of
# attribute painting tools, then creates a new context called
# "customtoolPaintContext" which utilises the "customtoolPaint" tool.
#
cmds.artAttrTool( add='customtoolPaint' )
cmds.artAttrCtx( 'customtoolPaintContext', whichTool='customtoolPaint' )

# List all tools currently defined.
#
cmds.artAttrTool( query=True )