ジャンプ先: 概要. 戻り値. 関連. フラグ. MEL 例.

概要

defineDataServer [-device string] [-server string] [-undefine]

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

デバイス ハンドラにアタッチできる指定したデバイスを作成する、指定したデータのサーバ名に接続します。

デバイスが定義されると、そのデバイスはサーバのデータ軸情報を検索します。「CapChannels」は、スカラー チャネルの場合「channelName」.「listInputDeviceAxes」を参照してください。「usage」、複合チャネルの場合 「channelName」.「componente」 の書式で軸情報として示されます。軸の名前をリストするには、listInputDeviceAxes を参照してください。 

defineDataServer -d "myDevice" -s "myServer"
を元に戻しても、やり直しできなくなるまで、データ サーバとの接続は解除されません。他の任意のコマンド(sphere など)を実行することによって、再実行ができなくなり、データ サーバとの接続が切断します。同様に、コマンド
defineDataServer -d "myDevice" -u
は、元に戻せなくなるまでデータ サーバとの接続を解除しません。flushUndo が実行されるか、「defineDataServer」コマンドが元に戻す待ち行列の末尾から削除されると取り消しができなくなり、データ サーバとの接続が切断します。

戻り値はありません。

戻り値

なし

関連

applyTake, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake, recordDevice, writeTake

フラグ

device, server, undefine
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-device(-d) string create
サーバ接続に必要なデバイス名を指定します。デバイス名は固有でなければなりません。固有でない場合は、コマンドが失敗します。
-server(-s) string create
定義したデバイスが接続するサーバの名前を指定します。2 とおりの方法で指定できます。
name -- サーバ ソケットの名前
name 形式のサーバ名は、name に対応するローカル ホストでサーバ ソケットに接続します。name が「/」 で始まらない場合は、/tmp/name が使用されます。これは、ほとんどのサーバの既定の動作です。name が「/」で始まる場合、name はソケットのフル パスを示します。
host: service - 指定ホスト上の udp サービスです。
service は、「udp サービス名」、「ポート番号」、または「tcpmux」 の名前付きサービスのいずれかで、この順序で見つかります。host を省略すると、ローカル ホストが使用されます。

どんな場合でも、サーバがみつからない場合、デバイスは定義(作成)されず、このコマンドはエラーになります。

-undefine(-u) create
dataServer デバイスの定義を取り消し(破棄)して、サーバとの接続を閉じます。
フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例

defineDataServer -s "ultratrak_server" -d "melvin";

// Connects to the ultratrak_server running on the localhost and gives it
// the name "melvin"

defineDataServer -s "mocap_lab:5200" -d "labFlock";

// Creates a device called "labFlock" which connects to the server running
// on host "mocap_lab" at port "5200".

defineDataServer -undefine -d "labFlock";

// Delete the device "labFlock" closing the connection with the server
// specified when it was created.