基本TE

概要と主要な概念

基本TEオブジェクトは、開発者がユーザーライブラリの作成に使用できるタスク実行者です。ほぼすべての継承可能なタスク実行者ロジックをピックリスト関数に渡します。そのため、ユーザーライブラリの開発者は、タスク実行者の事実上すべての機能を指定できます。

基本TEはタスク実行者です。これを使用すると、基本TEのオフセット移動機能のロジックや、オブジェクトを停止/オブジェクトを再開、ピック/プレースオフセットなどの詳細機能を指定できます。

イベント

基本TEはすべてのタスク実行者に共通の標準イベントを使用します。これらのイベントの説明については、「タスク実行者の概念 - イベント」を参照してください。

基本TEには次の追加イベントがあります。

詳細機能

このイベントはさまざまな理由で起動します。ほとんどの場合、これらの通知のロジックを実装する必要はありませんが、実装はいつでも可能です。イベントが起動されると、詳細機能トリガーが実行されます。

次のパラメータがあります。

イベントパラメータ タイプ 説明
メッセージタイプ 整数 通知のタイプ。詳細については、以下を参照してください。

次のとおり、さまざまなメッセージタイプがあります。

  • ADV_FUNC_CLASSTYPE - これはオブジェクトのクラスのタイプを取得するリクエストです。特定のビット数を高く設定した整数としてclasstypeが返される必要があります。この値は、ビット単位のOR演算子（|）といくつかのclasstypeマクロで作成できます。たとえば、FixedResourceのclasstypeは次のとおりです。CLASSTYPE_FLEXSIMOBJECT > CLASSTYPE_FIXEDRESOURCE。
  • ADV_FUNC_DRAGCONNECTION - この関数は、任意のキーボードのキーを押したまま、ユーザーがこのオブジェクトをクリックして別のオブジェクトにドラッグすると呼び出されます。この場合、マウスのドラッグ先のオブジェクトはparam(2)として、クリックされたキーのASCII値はparam(3)として、オブジェクトのclasstype値はparam(4)として渡されます。
  • ADV_FUNC_CLICK - この関数はオブジェクトがクリックされると呼び出されます。ここでクリックされたビューへの参照はparam(2)として渡され、クリックコードはparam(3)として渡されます。考えられるクリックコードは、DOUBLE_CLICK、LEFT_PRESS、LEFT_RELEASE、RIGHT_PRESS、RIGHT_RELEASEです。
  • ADV_FUNC_KEYEDCLICK - この関数は任意のキーボードのキーを押したままオブジェクトをクリックすると呼び出されます。ここではビューがparam(2)として、クリックコードはparam(3)として、押したキーのASCII値はparam(4)として渡されます。考えられるクリックコードは、DOUBLE_CLICK、LEFT_PRESS、LEFT_RELEASE、RIGHT_PRESS、RIGHT_RELEASEです。

詳細機能トリガーの戻り値は、1または0となる必要があります。0の場合、指定した通知に関連付けられたデフォルトの機能がオブジェクトで実行されます。1の場合、オブジェクトではデフォルトの機能が実行されず、デフォルトが関数でオーバーライドされたとみなされます。

ｵﾌｾｯﾄ開始時

オフセット開始イベントは、オフセット移動オペレーションの開始時に起動します。オフセット開始時トリガーを実行します。このイベントでは、x、y、zのオフセット位置が使用されます。オブジェクトは、指定されたオフセットを移動する方法を見つけます。

次のパラメータがあります。

イベントパラメータ タイプ 説明
Xの場所 倍精度浮動小数点数 リクエストされたxオフセット。これはオブジェクトのx中心からのオフセット距離です。
Yの場所 倍精度浮動小数点数 リクエストされたyオフセット。これはオブジェクトのy中心からのオフセット距離です。
Zの場所 倍精度浮動小数点数 リクエストされたzオフセット。これはオブジェクトのz基点からのオフセット距離です。
アイテム オブジェクト オフセットオペレーションに関連するアイテムがある場合、これはアイテムへの参照です。
終了速度 倍精度浮動小数点数 オフセット移動オペレーションのリクエストされた終了速度。
最大速度 倍精度浮動小数点数 このオブジェクトの最大速度変数の値。
加速度 倍精度浮動小数点数 このオブジェクトの加速変数の値。
減速 倍精度浮動小数点数 このオブジェクトの減速変数の値。
最終更新速度 倍精度浮動小数点数 オブジェクトの最後の移動オペレーションの終了速度。
移動中に回転 整数 これは1または0で、ユーザーが移動中にオブジェクトを回転させるかどうかを指定します。この値はオブジェクトのプロパティウィンドウで定義します。

オフセット開始時の戻り値は、移動オペレーションを実行するのにかかる時間です。

ｵﾌｾｯﾄ終了時

オフセット終了時イベントは、オブジェクトがオフセットオペレーションを終了すると起動します。これにより、オブジェクトの位置が最終的なオフセット位置に更新されます。このイベントはオブジェクトのオフセット終了時トリガーを起動させます。

次のパラメータがあります。

イベントパラメータ タイプ 説明
現在オフセット中 倍精度浮動小数点数 オブジェクトが現在オフセットオペレーションを実行している場合は1、オブジェクトが現在オフセットオペレーションを実行している場合は1、それ以外の場合は0になります。それ以外の場合は0になります。オフセット開始時が起動すると、現在オフセット中の値は自動で1に設定され、オフセット終了時が起動すると0に戻ります。
オフセット合計時間 倍精度浮動小数点数 このオブジェクトがオフセット開始時トリガーから戻った合計時間。
最大速度 倍精度浮動小数点数 このオブジェクトの最大速度変数の値。
加速度 倍精度浮動小数点数 このオブジェクトの加速変数の値。
減速 倍精度浮動小数点数 このオブジェクトの減速変数の値。
最終更新速度 倍精度浮動小数点数 オブジェクトの最後の移動オペレーションの終了速度。
移動中に回転 倍精度浮動小数点数 これは1または0で、ユーザーが移動中にオブジェクトを回転させるかどうかを指定します。この値はオブジェクトのプロパティウィンドウで定義します。
ロード/アンロード時間 倍精度浮動小数点数 オフセットオペレーションがロードまたはアンロードオペレーションの場合、この値はオペレーションのロード/アンロード時間です。

状態変化時

このイベントは、Object.setState()コマンドまたはタスクシーケンスの実行プロセスによってオブジェクトの状態が変化したときに起動します。

次のパラメータがあります。

イベントパラメータ タイプ 説明
状態 整数 オブジェクトが移行しようとしている新しい状態。
状態ﾌﾟﾛﾌｧｲﾙ 整数 新しい状態のプロファイル番号。デフォルトの状態プロファイルは0です。

関数から0が返された場合、オブジェクトは状態を変更します。関数から-1が返された場合、オブジェクトでは何も実行されず、前の状態が保持されます。関数から正の数が返された場合、この新しい状態番号に状態が変わります。

ｵﾌｾｯﾄ更新時

オフセット更新時イベントは、ビューがリフレッシュされてオブジェクトが描画される前に起動します。これは、オブジェクトが現在のオフセットオペレーションに基づいてその位置を更新するときです。

このイベントは、オフセット終了時イベントと同じパラメータを共有します。

ピックプレースオフセット

ピックプレースオフセットイベントは、タスク実行者標準イベント、ピックオフセット、プレースオフセットと同時に起動されます。違いは利用できるパラメータです。プレースオフセットの場合、このイベントは、別の輸送オブジェクトがこのオブジェクトにフローアイテムを配置またはアンロードしようとしたときに起動します。ピックオフセットの場合は、輸送がこのオブジェクトからアイテムをピッキングまたはロードしようとしているときに起動します。

次のパラメータがあります。

イベントパラメータ タイプ 説明
ピックオペレーション 整数 これは1または0です。1はピックオペレーションを示し、0はプレースオペレーションを示します。
アイテム オブジェクト ピックされたアイテムまたは配置されたアイテム。
その他のオブジェクト オブジェクト アイテムをピックまたは配置しているオブジェクト。
X値ノード ツリーノード このノードの値は、この関数で設定します。またこのノードの値は、この関数から返されるオフセット位置を表します。たとえば、ピックしているオブジェクトまたは配置しているオブジェクトをx方向に10、y方向に0、z方向に5にオフセットするには、xvalnode.value = 10、yvalnode = 0、zvalnode.value = 5を使用してX値ノードを10に設定します。
Y値ノード ツリーノード 「X値ノード」を参照してください。
Z値ノード ツリーノード 「X値ノード」を参照してください。

両オペレーションとも、ここでユーザーが独自のピックロジックまたは配置ロジックを実装中で、デフォルトのロジックを実行しない場合は、この関数から1を返す必要があります。0が返された場合、オブジェクトでは何も行われなかったとみなされ、独自のデフォルトロジックが実行されます。

停止/再開

停止または再開イベントは、タスク実行者標準イベント、停止時および再開時と同時に起動されます。違いは利用できるパラメータです。停止の場合、Object.stop()コマンドでオブジェクトが停止したとき、このイベントが起動されます。再開の場合、Object.resume()コマンドが呼び出されたとき、このイベントが起動されます。このイベントではオブジェクト停止 - オブジェクト再開トリガーが実行されます。このトリガーでは、オブジェクトがどのように「停止」され、どのように「再開」されるかの方法が定義されます。また、このフィールドでは、停止リクエストの数、停止前のオブジェクトの状態などを記憶しておくデータも管理します。

次のパラメータがあります。

イベントパラメータ タイプ 説明
停止オペレーション 整数 この値は1または0です。1はオブジェクトが停止していることを示し、0はオブジェクトが再開していることを示します。
停止状態 整数 この値は停止オペレーションにのみ適用されます。リクエストを受けてObject.stop()コマンドに渡される状態を指定します。
停止数ノード ツリーノード これが停止オペレーションである場合、この関数内でこのノードの値が1のみ増加します。再開オペレーションの場合、この関数内でこのノードの値が1のみ減少します。また、このノードの値を取得すると、このオブジェクトに対して呼び出された停止コマンドの数を把握できます。ユーザーはオブジェクトの初回停止時（ノードの値が0から1に変化）に、このオブジェクトを停止する方法を指定するロジックを実行します。オブジェクトの最終再開時（ノードの値が1から0に変化）には、このオブジェクトを再開する方法を指定するロジックを実行します。
最終停止時間ノード ツリーノード このオブジェクトの初回停止時に、このノードを現在の時刻に設定します。こうしておくと、オブジェクトの最終再開時にオブジェクトが停止した時間を把握できます。
停止前の状態ノード ツリーノード このオブジェクトの初回停止時に、このノードをオブジェクトの現在の状態に設定します。これにより、オブジェクトが再開時にどの状態に戻るかを把握できます。
状態ﾌﾟﾛﾌｧｲﾙ 整数 停止状態のプロファイル番号。デフォルトの状態プロファイルは0です。

ここでユーザーが独自の停止ロジックまたは再開ロジックを実装中で、デフォルトのロジックを実行しない場合は、この関数から1を返す必要があります。オブジェクトでは、この関数から戻り値0が渡されると、何も行われなかったとみなされ、独自のデフォルトロジックが実行されます。

状態

基本TEは標準のタスク実行者の状態を使用します。詳細については、「タスク実行者の概念 - 状態」を参照してください。

統計

基本TEはすべてのタスク実行者に共通の標準統計を使用します。これらの統計情報については、「タスク実行者の概念 - 統計」を参照してください。

プロパティ

基本TEオブジェクトには、さまざまなプロパティを持つ7つのタブがあります。最後の6つのタブは、すべてのタスク実行者（ディスパッチャー以外）に共通する標準タブです。これらのタブのプロパティの詳細については、以下を参照してください。

［基本TE］タブのみが基本TEオブジェクトに固有です。このタブのトリガーの詳細については、上の「イベント」セクションを参照してください。