string[] | the list of available evaluators (querying with no evaluator flag or invalid evaluator name) |
boolean | the previous active state of the named evaluator (with 'name' and 'enable' flags) |
boolean | the active state of the named evaluator (query with 'name' and 'enable' flags) |
string[] | the list of evaluators in the requested active state (query 'enable' flag alone) |
string[] | the list of nodes for which the evaluator was activated or deactivated (with 'nodeType' or 'nodeTypeChildren' flags) |
string | the queried value for the evaluator (with 'name' and 'valueName' flags) |
boolean | true if the configuration request was accepted by the evaluator (with 'name' flag and 'configuration' flag) |
string[] | the list of configuration parameters accepted by the evaluator (query mode with 'name' flag and 'configuration' flag) |
string[] | the list of clusters currently assigned to the evaluator with intervening sublist sizes (query mode with 'name' flag and 'clusters' flag) |
string | the help information supplied by the evaluator (query mode with 'name' flag and 'info' flag) |
In query mode, return type is based on queried flag.
Long name (short name) |
Argument types |
Properties |
-clusters(-cl)
|
boolean
|
|
|
This flag queries the list of clusters currently assigned to the named custom evaluator.
The return value will be an array of strings where the array consists of a
set of (number, string[]) groups. e.g. If an evaluator has 2 clusters with
2 and 3 nodes in them respectively the output would be something like:
(2, 'transform2', 'transform3', 3, 'joint1', 'joint2', 'joint3')
|
|
-configuration(-c)
|
string
|
|
|
Sends configuration information to a custom evaluator. It's up to the evaluator
to understand what they mean.
Multiple configuration messages can be sent in a single command.
Query this flag for a given evaluator to find out what configuration
messages it accepts.
|
|
-enable(-en)
|
boolean
|
|
|
Enables or disables a specific graph evaluation runtime, depending on the
state of the flag. In order to use this flag you must also specify the
name in the 'name' argument.
When the 'enable' flag is used in conjunction with the 'nodeType' flag then
it is used to selectively turn on or off the ability of the given evaluator
to handle nodes of the given type (i.e. it no longer toggles the evaluator
enabled state).
When the 'enable' flag is used in conjunction with the 'configuration' flag then
it is passed along with the configuration message interpreted by the custom
evaluator.
|
|
-info(-i)
|
boolean
|
|
|
Queries the evaluator information. Only valid in query mode since the
information is generated by the evaluator's internal state and cannot be
changed.
In order to use this flag, the 'name' argument must also be specified.
|
|
-name(-n)
|
string
|
|
|
Names a particular DG evaluation override evaluator. Evaluators are registered
automatically by name. Query this flag to get a list of available runtimes.
When a runtime is registered it is enabled by default. Use the 'enable'
flag to change its enabled state.
In query mode, this flag can accept a value.
|
|
-nodeType(-nt)
|
string
|
|
|
Names a particular node type to be passed to the evaluator request.
Evaluators can either use or ignore the node type information as passed.
|
|
-nodeTypeChildren(-ntc)
|
|
|
|
If enabled when using the 'nodeType' flag then handle all of the node types
derived from the given one as well. Default is to only handle the named
node type.
|
|
-priority(-p)
|
|
|
|
Gets the evaluator priority. Custom evaluator with highest priority order will
get the chance to claim the nodes first.
In order to use this flag you must also specify the name in the 'name' argument.
|
|
-valueName(-vn)
|
string
|
|
|
Queries a value from a given evaluator. Evaluators can define a set of
values for which they answer.
|
|