Go to: Synopsis. Return value. Related. Flags. MEL examples.
defineDataServer [-device string] [-server string] [-undefine]
defineDataServer is undoable, NOT queryable, and NOT editable.
Connects to the specified data servername, creating a named device which
then can be attached to device handlers.
When the device is defined, it queries queries the server for data axis
information. The "CapChannels" present are represented as axis in form
"channelName"."usage" for scalar channels and "channelName"."component"
for compound channels. See listInputDeviceAxes to list axis names.
Note that undoing
defineDataServer -d "myDevice" -s "myServer"
does not break the connection with the data server until it cannot be
redone. Executing any other command (sphere for example) will cause
this to occur. Similarly, the command
defineDataServer -d "myDevice" -u
does not break the connection with the data server until it cannot be
undone. Either flushUndo, or the 'defineDataServer' command falling"
off the end of the undo queue causes this to occur, and the connection.
to be broken.
No return value.
None
applyTake, defineVirtualDevice, enableDevice, filter, movIn, movOut, readTake, recordDevice, writeTake
device, server, undefine
| Long name (short name) |
Argument types |
Properties |
|
-device(-d)
|
string
|
|
|
specified the device name to be given to the server connection.
device name must be unique or the command fails.
|
|
-server(-s)
|
string
|
|
|
specifies the name of the server with which the define
device connects, and can be specifiied in two ways
- name -- the name of the server socket
- Server names of the form name connect to the
server socket on the localhost corresponding to
name. If name does not begin with "/",
then /tmp/name is used. This is the default behavior
of most servers. If name begins with "/",
name denotes the full path to the socket.
- host:service - a udp service
on the specified host.
- The service can be any one of a "udp service name,"
a "port number," or a named service of "tcpmux," and they are
found in that order. If
host is omitted, the localhost is used.
In any case, if the server cannot be found, the device is not
defined (created) and the command fails.
|
|
-undefine(-u)
|
|
|
|
undefines (destroys) the dataServer device, closing the connection
with the server.
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
Flag can appear in Query mode of command
|
Flag can be used more than once in a command.
|
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.