Scripted_Behavior : MAXObject

MAXSｃript を編集

[MAXScript を編集](Edit MaxScript)ボタンは、スクリプト定義動作のロールアウトで、スクリプト定義動作のスクリプトを入力するために使用する[MAXScript エディタ](MAXScript Editor)ウィンドウを開きます。このエディタ ウィンドウは、MAXScript の他のエディタ ウィンドウと似ていますが、スクリプト定義動作用に若干カスタマイズされています。

[ファイル](File)メニューにある次の要素は、機能が異なります。

[新規](New): 1 つのスクリプト定義動作につき 1 つのエディタしか開けないので、無効になっています。

[開く](Open): 既存のエディタ ウィンドウでファイルを開きます。既存のテキストは失われます。

[評価](Evaluate): スクリプトを評価し、動作のパラメータ ブロックに保存します。

[閉じる](Close): エラーが検出されなければ、動作のパラメータ ブロックに保存してエディタを閉じます。

スクリプト定義動作の構文

スクリプト定義動作のスクリプトは、シミュレーションの計算時に群集システムによって呼び出される一連のイベント ハンドラを定義して実行します。イベント ハンドラは、自動的に非表示の MAXScript コンテキストに含められます。コンテキストの名前は、このダイアログ ボックスの[スクリプトのコンテキスト名](Script Context Name)テキスト ボックスか、それと等しい .scriptContextName から取得されます。

スクリプト定義動作のイベント ハンドラ

on execute do <expr> 

スクリプトが評価されるたびに呼び出されます。初期化はすべてここで行われます。

on setupDelegates <delegates> <behavior>do<expr> 

<delegates> シミュレーションへの参加が命令された後のすべての代理オブジェクトの配列。すべての代理オブジェクトの配列[動作の割り当てとチーム](Behavior and Team Assignment)ダイアログ ボックスの[動作の割り当て](Behavior Assignments)ペインにリストされる代理オブジェクトは、すべてここにリストされます。

<behavior> は、現在の動作です。

シミュレーションが開始する前に呼び出されます。

on display <behavior> <time>do<expr> 

<behavior> は、現在の動作です。

<time> は、シミュレーションの現在の時間です。

群集システムが再描画されるたびに呼び出されます。ビューポート描画メソッドである gw 構造体の低レベルの描画関数を使って、動作のカスタム表示を指定することができます。

on behaviorStarted <delegate> <behavior> <time>do<expr> 

<delegate> は、動作が割り当てられる代理オブジェクト ノードです。

<behavior> は、現在の動作です。

<time> は、シミュレーションの現在の時間です。

特定の代理オブジェクトについて動作が有効になるたびに呼び出されます。これは、割り当てられた動作のシミュレーションの最初や、認識機能コントローラが動作を有効にするときに呼び出されます。

on initAtThisTime <behavior> <time> 

この関数は、フレームの最初で各動作に対して呼び出されます。

on applyForce <delegate> <behavior> <time> <numSubSamples> <displayHelpers> <weight>do<expr> 

動作のタイプが[フォース](Force)または[方向](Orientation)の場合、このハンドラは各フレームで代理オブジェクトを動かすために呼び出されます。

<delegate> は、動作が割り当てられる代理オブジェクト ノードです。

<behavior> は、現在の動作です。

<time> は、シミュレーションの現在の時間です。

<numSubSamples> フレームごとに必要なサブ サンプルの数。

<displayHelpers> 値が true になるか false になるかは、<Crowd>.update と <Crowd>.updateFrequency および現在のフレームによって決まります。true の場合、代理オブジェクト構造から使用できる表示関数を使って、必要なヘルパー イメージを表示します。たとえば、true の場合は、ほとんどの動作はそのフォースを表示し、パスフローはそのターゲットを表示します。delegates.lineDisplay、.sphereDisplay、.bboxDisplay、および .textDisplay はすべて、群集シミュレーションの計算中に特定の代理オブジェクトに対してグラフィック プリミティブを描くことができる関数です。その他のビューポート描画方法については、「ビューポート描画メソッド」を参照してください。

<weight> は、この動作の代理オブジェクトでの重みです。

イベント ハンドラは、次のタイプの配列を戻します。

#(<int_flags>, <point3_force>, <point3_goal>, <float_speed>, <Speed_Weight_at_the_Goal>)

<int_flags> は次の値の合計です。

0 - 戻り値は、群集システムで使用されません。

1 - フォースのみが影響を受けます。

2 - ゴールのみが影響を受けます。

4 - スピードのみが影響を受けます。

たとえば、5 (1+4) の値は、

<point3_force> は、フォースのベクトルです。正規化して、代理オブジェクトの平均スピードを乗算する単位です。フォースを強くする場合はこの値を大きくし、弱くする場合はこの値を小さくします。

<point3_goal> は、ワールド空間のゴール位置です。

<float_speed> は、代理オブジェクトの正味スピードです。この値は、代理オブジェクトの平均スピードに正規化されます。1.0 の値は、平均スピードで移動することを意味します。

<Speed_Weight_at_the_Goal> は、代理オブジェクトがゴールに到達するときのスピードを表します。この値は、代理オブジェクトの平均スピードで正規化されます。つまり、値 1.0 がその平均スピードになります。

on constraint <delegate> <behavior> <time> <numSubSamples> <displayHelpers> <finalSet> <velocity> <speed> <pos>do<expr> 

動作のタイプ <Scripted_Behavior>. type がコンストレイントの場合、このハンドラは代理オブジェクトを制限するために少なくとも各フレームで 1 回呼び出されます。コンストレイント動作は、その他のフォース動作、回避動作をすべて変更する他、加速制限やスピード制限などもすべて変更します。コンストレイント動作をシミュレーションで使用するときは注意してください。

コンストレイント動作を使用すると、代理オブジェクトの現在の位置、速度、スピードが変更され、その移動する位置が制限されます。これらの位置の組み合わせで、次の位置が決まります(Next_position = Current_Position +Normalized(vel) * Speed)。現在の位置が変更されても、その実際の位置が変わるわけではなく、新しい位置を計算するときに使用する位置が変わるだけです。このデザインでは、コンストレイントによってオブジェクトの速度を急に変更してそのスピードを維持し、代理オブジェクトのエネルギーを節約することができます。

<delegate> は、動作が割り当てられる代理オブジェクト ノードです。

<behavior> は、現在の動作です。

<time> は、シミュレーションの現在の時間です。

<numSubSamples> は、フレームごとに必要なサブ サンプルの数です。

<displayHelpers> 値が true になるか false になるかは、<Crowd>.update と <Crowd>.updateFrequency、および現在のフレームに応じて異なります。true の場合、代理オブジェクトから使用できる表示関数を使って、必要なヘルパー イメージを表示します。たとえば、true の場合は、ほとんどの動作はそのフォースを表示し、パスフローはそのターゲットを表示します。delegates .lineDisplay、.sphereDisplay、.bboxDisplay、および .textDisplay はすべて、群集シミュレーションの計算中に特定の代理オブジェクトに対してグラフィック プリミティブを描くために使用できる関数です。その他のビューポート描画方法については、「ビューポート描画メソッド」を参照してください。

<finalSet> は、これが最後であるかどうかに関係なく、現在のフレームで呼び出されます。

現在、コンストレイント動作の「on constraint」イベント ハンドラは、フレームごとに 2 回呼び出されます。最初は、値が false のパラメータ finalSet を持つ既存の Avoid_Behavior の前に呼び出されます。2 回目は、代理オブジェクトの制限と Avoid_Behavior が、値が true のパラメータ finalSet で適用された後に呼び出されます。この評価は、代理オブジェクトの制限と Avoid_Behavior が、コンストレイントが実行する変更に影響を与えることができるように行われます。2 回目の呼び出しは、コンストレイントが依然として満たされていることを確認するためのものです。

finalSet の状態をチェックする理由の 1 つは、内部でキャッシュされた内容が変更されないようにするためです。たとえば、Surface_Follow コンストレイント動作は、それが位置する三角形および重心座標を追跡します。シミュレーションでは、finalSet が true になるまで、これらの値は変わりません。

<velocity> は、このフレームにおける代理オブジェクトの現在の速度です。

<speed> は、このフレームにおける代理オブジェクトの現在のスピードです。

<pos> は、このフレームにおける代理オブジェクトの現在の位置です。

最後の代理オブジェクトの「on constraint」がシミュレーションの最後のフレームに対して実行された後、「on setupDelegates delegates behavior do」は空の配列「#() ReferenceTarget:Scripted_Behavior」によって呼び出されます。これは保証されているので、内部キャッシュをすべて消去するために、書き込まれたコンストレイント動作で使用できます。

イベント ハンドラは、次のタイプの配列を戻します。

#(<int_flags>, <point3_velocity>, <point3_pos>, <point3_goal>, <float_speed>)

0 - 戻り値は、群集システムで使用されません。

1 - 戻り値は、群集システムで使用されます。

<point3_velocity> は、速度です。

<point3_pos> は、修正された現在の位置で、これを使って新しい位置が計算されます。コンストレイントを満たすために、この動作は代理オブジェクトの現在位置を修正することができます。

<point3_goal> は、ワールド空間のゴール位置です。

<float_speed> は、代理オブジェクトの正味スピードです。この値は、代理オブジェクトの平均スピードに正規化されます。

on orient <delegate> <behavior> <time> <velocity> do <expr> 

動作のタイプ <Scripted_Behavior>. type が「方向」の場合、このハンドラは各フレームで呼び出されます。このハンドラは、常に applyForce ハンドラとともに呼び出されます。

<delegate> は、動作が割り当てられる代理オブジェクト ノードです。

<behavior> は、現在の動作です。

<time> は、シミュレーションの現在の時間です。

<velocity> は、このフレームにおける代理オブジェクトの現在の速度です。

イベント ハンドラは、次のタイプの配列を戻します。

 #(<int_flags>, quat_orientation)

<int_flags> は、次の値の合計です。

0 - 戻り値は、群集システムで使用されません。

1 - 戻り値は、群集システムで使用されます。

<quat_orientation> は、クォータニオンの代理オブジェクトの方向です。

on orient delegate behavior time vel do
(
#(1,delegate.rotation.keys[1].value as quat )
)

on execute do( print" executed")
 
on constraint delegate behavior time numsubsamples displayHelpers finalSet vel speed pos do
(
leader_velocity = delegates.velocity $TheFormationLeader   
Normalized_Leader_Velocity= normalize (delegates.velocity $TheFormationLeader)   
magVel = speed*Normalized_Leader_Velocity   
temp_dis = (pos+leader_velocity)- magVel   
the_goal =temp_dis + magVel  
if displayHelpers== true then  
( 
delegates.textDisplay delegate the_goal delegate.wirecolor delegate.name 
delegates.lineDisplay delegate pos (pos+leader_velocity) delegate.wirecolor true 
delegates.sphereDisplay delegate (pos+ (leader_velocity * $Crowd01.vectorScale)) 4 
delegate.wirecolor  
)   
#(1, Normalized_Leader_Velocity, temp_dis, the_goal, speed) 
)