ステート マシンの例: インタラクティブ チュートリアル

ステート マシンの最も役立つ利用方法の 1 つは、インタラクティブ チュートリアルを作成することです。まず始めに、次のいずれかをロードします。

• コンテンツ ブラウザに表示される TutorialBuldingDemo ファイル
• アプリケーション ホームの[スタートアップ]タブから使用するインタラクティブな基本チュートリアル

これらのファイルは両方とも同じような構造であるため、どちらのファイルを選択しても、次の操作を行うと作業を開始できます。

ステート マシンを表示するには

1. アウトライナ(Outliner)で、ディスプレイ > DAG オブジェクトのみ(Display > DAG objects only)をオフにします。
2. 「stage」という単語でフィルタします。
3. すべてのステージ ノードを選択します。
   注: ステージ ノードの横には、多くの「activate_stage」ノードもありますが、気にしないでください。
4. ウィンドウ > ノード エディタ(Windows > Node Editor)を開きます。
5. 入出力の表示(Show Inputs/Outputs)ボタン()をクリックして、ステージ ノードとその接続関係を表示します。

この時点で、チュートリアルのステージ ノードがどのように構成されているかを確認できます。次の重要項目には、注意が必要です。

• アクティブ化スクリプト(On Activate Script): 各ステージの大部分で発生するスクリプト ノードです。エクスプレッション エディタ(Expression Editor)に Python コードを表示することができます(下記を参照)。
• 非アクティブ化スクリプト(On Deactivate Script): ここでスクリプト ノードに接続し、ステージが終了したらクリーンアップします。必要に応じて移動したり、挿入または削除しやすいように、ステージ ロジック自体で独立して保持することをお勧めします。上記の例では、開発中のある時点で stage0 と stage1 の間に stage0_1 が挿入されていることが分かります。また、すべてのステージ ノードで使用できる汎用非アクティブ化スクリプトを作成する場合にも便利です。これにより、すべての非アクティブ化スクリプト(On Deactivate Script)アトリビュートをチェーンに接続するだけで、分かりやすくなります。
• タイム スライダのブックマーク(Time Slider Bookmarks): ステージの最初にアニメーションを設定する場合や、シーンの状態をあるステージから別のステージに変更する場合に便利です。たとえば、ブックマークの先頭にあるアクティブ カメラにキーフレームを設定すると、カメラをステージの開始点にあるシーンの別の場所にジャンプさせることができます。また、オブジェクトの表示にキーフレームを設定し、あるステージでは表示し、別のステージでは表示しないようにすることもできます。
• ステージの進行: ステージの目標に応じて、次のステージに進む方法は異なります。最も一般的な方法をいくつか示します。
  • ステージの条件(Condition)アトリビュートをアクティブにする、または「-next」フラグを使用する: この方法は、カスタム ウィンドウやその他の UI ウィジェットのボタンをクリックした場合や、何らかの条件を満たす(特定の場所にオブジェクトを移動する、特定のエディタを開くなど)といったイベントで、次のステージをトリガする必要がある場合に使用します。後者の場合、このようなイベントをリッスンするために、scriptJob 内にコマンドの埋め込みが必要になることもあります。
  • ステージのアニメーション終了(End of Animation)アトリビュートのアクティブ化: 単に何かをデモンストレーションするステージで使用します。タイム スライダが終了点に到達(最後まで再生される)と、次のステージが自動的にアクティブになります。
  • 遅延(Delay)の値を 0 (ゼロ)以外に設定する: このオプションを使用して、次のステージに自動的に移動するのを保留する時間を設定します。次のステージに進む前に、十分な時間をかけて検討する場合に役立ちます。
• UI 上に 2D テキストまたはイメージを表示する: 指示やヒントを示す最適な方法です。上記のサンプル ファイルには、次のスクリプト ノードにオーバーレイ ソース コードが含まれています。
  • overlayBubble
  • overlayDialog
  • controller
  Maya には、他に可能なことを示す製品デモも用意されています。このデモは、次のコードで実行できます。

  import moverlay
  moverlay.mayaDemo.demoOverlays()
  

  インストール フォルダの /Python/Lib/site-packages/moverlay フォルダ内には、製品デモのソース コードと、ムーバーレイ モジュール自体が含まれています。 2D オーバーレイの詳細については、「2D オーバーレイを表示する」を参照してください。

アクティブ化スクリプトおよび非アクティブ化スクリプトを表示する

ステージでの作業の大部分は、接続されたスクリプト ノードで行われます。上記のどちらのサンプル ファイルも、通常、「activate_stage#」または「deactivate_stage#」という名前になります。また、ステージに接続されていないヘルパー スクリプトも数多く存在しますが、多くの場合、何らかの一般的なタスクを実行するために呼び出されます。次に、いくつかの例を示します。

• overlayBubble: 画面上のバブルスタイル オーバーレイ描画の文字を処理します。
• overlayDialog: 画面上のダイアログ ボックススタイルのオーバーレイ描画を処理します。バブルとは異なり、移動したり閉じたりできます。
• clearOverlays: すべてのバブルスタイルのオーバーレイを削除します。
• clearDialogs: すべてのダイアログスタイルのオーバーレイを削除します。
• populateText: ステージ名によって参照できるチュートリアルのすべての文字のディクショナリを含めます。
• updateController: コントローラの文字および表示を更新します。

チュートリアルのすべてのスクリプトを表示するには

1. ウィンドウ > アニメーション エディタ > エクスプレッション エディタ(Windows > Animation Editors > Expression Editor)を選択します。
2. フィルタの選択 > スクリプト ノード名(Select Filter > By Script Node Name)をクリックします。
3. 左上の列のスクリプトを選択すると、その内容が表示されます。

どちらのサンプル ファイルも、便宜上、完全にコメント化およびドキュメント化されています。