scriptJob command

概要

scriptJob [-allChildren] [-attributeAdded string script] [-attributeChange string script] [-attributeDeleted string script] [-compressUndo boolean] [-conditionChange string script] [-conditionFalse string script] [-conditionTrue string script] [-connectionChange string script] [-disregardIndex] [-event string script] [-exists int] [-force] [-idleEvent script] [-kill int] [-killAll] [-killWithScene] [-listConditions] [-listEvents] [-listJobs] [-nodeDeleted string script] [-nodeNameChanged string script] [-parent string] [-permanent] [-protected] [-replacePrevious] [-runOnce boolean] [-timeChange script] [-uiDeleted string script]

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

このコマンドは、MEL コマンドまたはスクリプトである「スクリプトジョブ」を作成します。このジョブは、指定した条件、イベント、またはアトリビュートにアタッチされます。条件が目的の状態に切り替わるたびに(またはトリガが起動されるたびに)、スクリプトが実行されます。

スクリプトジョブは、インタラクティブなアプリケーションでイベントループに結び付けられています。このジョブはアイドルイベント中に実行されます。このことは、スクリプトジョブがバッチアプリケーションに存在しないことを意味しています。scriptJob コマンドは、バッチモードでは何も行いません。

このトリガは非常に頻繁に発生するので、スピードを考慮して、再生中にイベントが転送されることはありません。つまり、scriptJob -tc tcCallback; を使用してアニメーションの動作を変更することはできません。代わりに、エクスプレッションか、レンダリングコールバック「preRenderMel」と「postRenderMel」を使用します。

条件のジョブをセットアップするときに、true 状態、false 状態、状態変更のジョブを同時にセットアップすると無効になります。この動作は未定義です。ユーザは、true 状態および/または false 状態のジョブ、あるいは状態変更のジョブのいずれかのみをセットアップできますが、同時に 3 つの状態のジョブをセットアップすることはできません。すなわち、次のように実行する場合、

// アプリケーションの存続期間中に実行されるジョブを設定します。 // このジョブは「kill」コマンドを使用しても削除できません。 scriptJob -e "SelectionChanged" "print \"Annoying Message!\\n\"" -permanent;

// true 状態についてジョブを設定します。 scriptJob -ct "playingBack" playBackCallback;

// false 状態についてジョブを設定します。 scriptJob -cf "playingBack" playBackCallback;

scriptJob -cc "playingBack" playBackCallback; を実行してはなりません。実行すると、未定義の動作が引き起こされます。

このコマンドは、使用可能な条件とイベントをリストする、そして実行中のジョブを中断するときにも使用できます。

戻り値

int	ジョブの中断に使用できるジョブ番号です。ジョブ番号は 0 以上の整数値です。
string[]	list フラグ使用時の文字列リスト
boolean	exists フラグの場合

フラグ

allChildren, attributeAdded, attributeChange, attributeDeleted, compressUndo, conditionChange, conditionFalse, conditionTrue, connectionChange, disregardIndex, event, exists, force, idleEvent, kill, killAll, killWithScene, listConditions, listEvents, listJobs, nodeDeleted, nodeNameChanged, parent, permanent, protected, replacePrevious, runOnce, timeChange, uiDeleted

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

-exists(-ex) int

指定した「ジョブ番号」を持つ scriptJob が存在する場合は true を返し、存在しない場合は false を返します。「ジョブ番号」は、新しい scriptJob の作成時に返された値である必要があります。

-conditionTrue(-ct) string script

指定した条件が true になったときにスクリプトを実行します。文字列は定義済みまたはユーザ定義のブーリアン条件の名前である必要があります。存在する条件のリストを取得するには、-listConditions フラグを使用します。

-conditionFalse(-cf) string script

指定した条件が false になったときにスクリプトを実行します。文字列は定義済みまたはユーザ定義のブーリアン条件の名前である必要があります。存在する条件のリストを取得するには、-listConditions フラグを使用します。

-conditionChange(-cc) string script

指定した条件の状態が変わったときにスクリプトを実行します。文字列は定義済みまたはユーザ定義のブーリアン条件の名前である必要があります。存在する条件のリストを取得するには、-listConditions フラグを使用します。

-event(-e) string script

指定したイベントが発生したときにスクリプトを実行します。文字列は定義済みの Maya イベントの名前である必要があります。存在するイベントのリストを取得するには、-listEvents フラグを使用します。

-attributeChange(-ac) string script

指定したアトリビュートの値が変わったときにスクリプトを実行します。文字列はディペンデンシーノードと特定のアトリビュートの両方を識別する必要があります。ディペンデンシーノードが削除された場合、(削除を元に戻すことができても)このジョブは中断されます。

-attributeDeleted(-ad) string script

指定したアトリビュートが削除されるときにスクリプトを実行します。文字列はディペンデンシーノードと特定のアトリビュートの両方を識別する必要があります。ディペンデンシーノードが削除された場合、(削除を元に戻すことができても)このジョブは中断されます。

-attributeAdded(-aa) string script

指定したアトリビュートが追加されるときにスクリプトを実行します。文字列はディペンデンシーノードと特定のアトリビュートの両方を識別する必要があります。ディペンデンシーノードが削除された場合、(削除を元に戻すことができても)このジョブは中断されます。

-connectionChange(-con) string script

指定したアトリビュートの結合関係が変わったときにスクリプトを実行します。文字列はディペンデンシーノードと特定のアトリビュートの両方を識別する必要があります。ディペンデンシーノードが削除された場合、(削除を元に戻すことができても)このジョブは中断されます。

-permanent(-per)

ジョブを中断できないようにします。永続ジョブは、アプリケーションの存続期間中、またはジョブの親オブジェクトの存続期間中、存在します。-killWithScene フラグは、永続ジョブには適用されません。

-protected(-pro)

ジョブを中断されにくくします。保護されたジョブは、-force フラグを使用して意図的に中断または置き換えを行う必要があります。-killWithScene フラグは、保護されたジョブには適用されません。

-idleEvent(-ie) script

Maya がアイドル状態になるたびにスクリプトを実行します。警告: アイドルイベントが登録されているかぎり、アプリケーションはイベントをコールし続け、使用可能な CPU 時間をすべて使い果たします。idleEvents は注意して使用してください。

-disregardIndex(-dri)

このフラグは -ac/attributeChange フラグと一緒に使用した場合のみに使用できます。これが指定されており、ジョブがマルチ(インデックス付き)アトリビュートにアタッチされている場合、マルチアトリビュートのいかなるアトリビュートが変更されてもジョブが実行されます。

-allChildren(-alc)

このフラグは -ac/attributeChange フラグと一緒に使用した場合のみに使用できます。これが指定されており、ジョブが複合アトリビュートにアタッチされている場合、指定したアトリビュートとその子に変更が加えられるとジョブが実行されます。

-timeChange(-tc) script

現在のタイムが変更されたときにスクリプトを実行します。タイムスライダのクリックによって時間が変更された場合、スクリプトは実行されません。これに対して、「timeChanged」条件によってトリガされたスクリプトは実行されます。

-uiDeleted(-uid) string script

指定した UI のピースが削除されたときにスクリプトを実行します。

-nodeNameChanged(-nnc) string script

指定されたノードの名前が変更されたときにスクリプトを実行します。

-nodeDeleted(-nd) string script

指定したノードが削除されるときにスクリプトを実行します。

-parent(-p) string

このジョブを Maya UI のピースにアタッチします。UI が破壊されると、このジョブも一緒に中断されます。

-replacePrevious(-rp)

このフラグは、必ず -parent フラグと一緒に使用します。新しい scriptJob が作成される前に、同じ親を持つ既存の scriptJobs がまず削除されます。

-force(-f)

このフラグは、-kill、-killAll、または -replacePrevious と一緒にのみ使用でき、保護されたジョブの削除が可能になります。

-killWithScene(-kws)

現在のシーンが空になったときに、ジョブを現在のシーンにアタッチします。現在のシーンは、新しいシーンまたは既存のシーンを開くと空になります。

-runOnce(-ro) boolean

これが true に設定されている場合、スクリプトは一度だけ実行されます。false (既定)に設定されている場合、スクリプトは条件/イベントのトリガが発生するたびに実行されます。-uid フラグまたは -nd フラグが使用される場合、runOnce が自動的にオンになります。

-compressUndo(-cu) boolean

これを true に設定すると scriptJob を元に戻すことができるようになり、そのアクションは、取り消しのために最後に行ったアクションとセットになります。たとえば、セレクションの変更により scriptJob がトリガされた場合に undo を押すと、scriptJob とセレクションの変更が両方一度に元に戻されます。

-listJobs(-lj)

このフラグが指定されている場合、既存のすべてのジョブの説明を含む文字配列とジョブ番号がコマンドから返されます。返されたジョブ番号を使用して、後からジョブを中断することができます。

-kill(-k) int

指定したジョブ番号を持つジョブを中断します。ただし、永続ジョブを中断することはできません。また、保護されたジョブは、コマンドで -force フラグが使用されている場合にかぎり中断できます。

-killAll(-ka)

すべてのジョブを中断します。永続ジョブは削除されません。保護されたジョブは、-force フラグが使用されている場合にかぎり削除されます。

-listEvents(-le)

このフラグを指定すると、既存のすべてのイベントの名前を含む文字配列がコマンドから返されます。以下に、既存のすべてのイベントについて説明します。

angularToleranceChanged:

角度単位の許容値が変更されたとき。許容値は次の場合に変更されます。

MEL コマンド「tolerance」に「-angular」フラグを付けて使用する場合
オプション ->GeneralPreferences-> モデリングタブ-> 接線許容値でプリファレンスを変更する場合

angularUnitChanged:

ユーザが角度単位を変更したとき。

axisAtOriginChanged:

原点の軸が変更されたとき。

axisInViewChanged:

特定のビューの軸が変更されたとき。

ColorIndexChanged:

カラーインデックスの値が変更されたとき。

constructionHistoryChanged:

コンストラクションヒストリをオンまたはオフにしたとき。

currentContainerChanged:

ユーザーが現在のコンテナを設定または設定解除したとき。

currentSoundNodeChanged:

次の理由から、タイムスライダに表示されているサウンドが変更されたとき:

サウンドが除去されている(表示されない)[タイムスライダで右マウスボタン]
新しいサウンドが表示されている [タイムスライダで右マウスボタン]
サウンド表示が切り替えられている [アニメーションオプション]
サウンド表示モードが変更されている [アニメーションオプション]

DagObjectCreated:

新しい DAG オブジェクトが作成されたとき。

deleteAll:

file new が実行されたとき。

DisplayColorChanged:

表示カラーが変更されたとき。

displayLayerChange:

レイヤが作成または破壊されたとき。

displayLayerManagerChange:

ディスプレイレイヤマネージャが変更されたとき。

DisplayRGBColorChanged:

RGB 表示カラーが変更されたとき。

glFrameTrigger:

内部使用限定。

gridDisplayChanged:

内部使用限定。

idle:

Maya がアイドル状態で優先順位の高いタスクが存在しないとき。

idleHigh:

Maya がアイドル状態のとき。これは、優先順位が低いアイドルタスクより前にコールされます。通常は「idle」を使用します。

lightLinkingChanged:

ライトリンクリレーションシップを修正する変更が生じたとき。

lightLinkingChangedNonSG:

ライトリンクリレーションシップを修正する変更が生じたとき(シェーディング割り当ての変更を除く)。

linearToleranceChanged:

リニア許容値が変更されたとき。許容値は次の場合に変更されます。

MEL コマンド「tolerance」に「-linear」フラグを付けて使用する場合
オプション ->GeneralPreferences-> モデリングタブ -> 位置許容値でプリファレンスを変更する場合

linearUnitChanged:

ユーザがオプション(Options)メニューからリニア単位を変更したとき

MenuModeChanged:

ユーザが Maya メインウィンドウでメニューバーのメニューセットを変更したとき(たとえば、モデリング(Modeling)をアニメーション(Animation)に変更したとき)。

RecentCommandChanged:

内部使用限定。

NewSceneOpened:

シーンが開かれたとき。

PostSceneRead:

シーンが読み込まれた後。特に、ファイルを開いた後や読み込み後、またはすべての子リファレンスが読み込まれた後。

nurbsToPolygonsPrefsChanged:

NURBS をポリゴンに(Nurbs To Polygons)のいずれかのプリファレンスが変更されたとき。プリファレンスは次の場合に変更されます。

MEL コマンドを使用(「nurbsToPolygonsPref」)
ポリゴン -> NURBS をポリゴンに -> オプションボックス(Polygons->Nurbs To Polygons->Option Box)でプリファレンスを変更

playbackRangeChanged:

再生キーフレームの範囲が変更されたとき

playbackRangeSliderChanged:

アニメーション開始/終了範囲(タイムスライダ範囲の右端または左端のエントリセル、その間のセルで再生範囲を調整)が変更されたとき

quitApplication:

ユーザが、MEL コマンドの quit、または終了(Exit)メニュー項目を使用して、終了を選択したとき

Redo:

ユーザがメニューから再実行を選択し、対象が再実行されたときこのコールバックは、UI またはローカルストレージの更新に使用できます。このコールバックの最中は、シーンや DG の状態を変更しないでください。

renderLayerChange:

レンダーレイヤノードの作成や削除が行われたとき。

renderLayerManagerChange:

現在のレンダーレイヤが変更されたとき。

RebuildUIValues:

内部使用限定。

SceneOpened:

シーンが開かれたとき。

SceneSaved:

シーンが保存されたとき。

SelectionChanged:

新しい選択が作成されたとき。

SelectModeChanged:

セレクションモードが変更されたとき。

SelectPreferenceChanged:

内部使用限定。

SelectPriorityChanged:

選択の優先順位が変更されたとき。

SelectTypeChanged:

セレクションタイプが変更されたとき。

setEditorChanged:

廃止されました。現在は使用されていません。

SetModified:

set コマンドを使用してセットを修正したとき。

SequencerActiveShotChanged:

アクティブなシーケンサショットが変更されたとき。

snapModeChanged:

スナップモードが変更されたとき。たとえば、グリッドスナップに変更されたとき。

timeChanged:

時間が変更されたとき。

timeUnitChanged:

時間単位が変更されたとき。

ToolChanged:

ツール／コンテキストが変更されたとき。

PostToolChanged:

ツール／コンテキストの変更後。

NameChanged:

オブジェクトの名前が rename コマンドを使って変更されたとき。

Undo:

ユーザがメニューから元に戻すを選択し、対象が取り消されたとき。このコールバックは、UI またはローカルストレージの更新に使用できます。このコールバックの最中は、シーンや DG の状態を変更しないでください。

modelEditorChanged:

ユーザがモデルエディタのオプションを変更した場合。

-listConditions(-lc)

このフラグを指定すると、既存のすべての条件の名前を含む文字配列がコマンドから返されます。以下に、既存のすべての条件について説明します。

使用可能な Maya 機能に基づくイベント

指定した機能が使用できる場合、これらのイベントは true になります。

イベント名 Maya 機能

AnimationExists アニメーション

AnimationUIExists アニメーションのユーザインタフェース

BaseMayaExists Maya の任意の基本機能

BaseUIExists 任意のインタラクティブな Maya 機能

DatabaseUIExists

DeformersExists デフォーマ機能

DeformersUIExists デフォーマのユーザインタフェース

DevicesExists デバイスサポート

DimensionsExists 次元

DynamicsExists ダイナミクス

DynamicsUIExists ダイナミクスのユーザインタフェース

ExplorerExists Explorer

ImageUIExists イメージングのユーザインタフェース

KinematicsExists キネマティクス

KinematicsUIExists キネマティクスのユーザインタフェース

ManipsExists マニピュレータ

ModelExists 基本モデリングツール

ModelUIExists 基本モデリングのユーザインタフェース

NurbsExists NURBS モデリングツール

NurbsUIExists NURBS モデリングのユーザインタフェース

PolyCoreExists 基本ポリゴンサポート

PolygonsExists ポリゴンモデリング

PolygonsUIExists ポリゴンモデリングのユーザインタフェース

PolyTextureExists ポリゴナルテクスチャリング

RenderingExists ビルトインレンダリング

RenderingUIExists レンダリングのユーザインタフェース

その他のイベント

autoKeyframeState:: Maya で autoKeyframing が有効なときは true
busy:: Maya がビジーなときは true
deleteAllCondition:: すべてを削除の操作の最中は true
flushingScene:: シーンをフラッシュしている間は true
GoButtonEnabled:: パネルコンテキストの Go ボタンが使用可能なときは true
hotkeyListChange:: ホットキーの定義リストが変更されたときは true
playingBack:: Maya でアニメーションキーフレームが再生されているときは true
playbackIconsCondition:: タイムスライダで使用されている再生状態のインスタンス
readingFile:: Maya がファイルを読み取り中のときは true
RedoAvailable:: 再実行のために使用可能なコマンドがあるときは true
SomethingSelected:: 何らかのオブジェクト(1 つまたは複数)が選択されているときは true
UndoAvailable:: 元に戻すための使用可能なコマンドがあるときは true

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

MEL 例

// create a job that deletes things when they are seleted
int $jobNum = `scriptJob -ct "SomethingSelected" "delete" -protected`;

// Now display the job
scriptJob -listJobs;

// Now kill it (need to use -force flag since it's protected)
scriptJob -kill $jobNum -force;

// create a sphere, but print a warning the next time it
// is raised over 10 units high
global proc warn(){
    float $height = `getAttr mySphere.ty`;
    if ( $height > 10.0 ){
        print ("Sphere is too high!\n");
    }//end if
}// end proc
sphere -n mySphere;
scriptJob -runOnce true -attributeChange mySphere.ty warn;

// create a job to detect a new attribute named "tag"
//
global proc detectNewTagAttr() {
    print(" New tag attribute was added\n" );
}
scriptJob -runOnce true -attributeAdded mySphere.tag detectNewTagAttr;
addAttr -ln "tag" -sn "tg" -dt "string" mySphere;

// list all the existing conditions and print them
// nicely
string $conds[] = `scriptJob -listConditions`;
int $i;
for ( $i=0; $i < size($conds); $i++ ){
    print( $conds[$i]+"\n" );
}//end for

コマンド (MEL)	Python バージョン
scriptJob	カテゴリ内: 言語, スクリプティング

scriptJob

概要

戻り値

関連

フラグ

使用可能な Maya 機能に基づくイベント

その他のイベント

MEL 例