7.6. ExecuteMessage

execute_message ‐ An action for sending an internal message at the current frame

7.6.1. Attributes

NameTypeDefaults
valueSTRINGNone (required)

7.6.2. Description

This action is used to send a message to a node of the scene graph. The message emission is made at the current frame. The string value of the value attribute defines the label of the message that will be received by the target node(s). If the string contains parenthesized expressions, they are dynamically evaluated as numerical expressions and their values replace the expressions in the string. See also send_message that postpones message emission to the next frame whereas execute_message is made during the current frame.

Messages can have arguments that will be received by a trigger. For this purpose, they must have an OSC-like syntax: <address> (<parameter>)+. The <address> is an identifier that begins with a '/' character followed by alphanumerical characters and the <parameter>s are chosen among f (float), i (integer), and s (string) (see the description of patterns in the aliasScript element and message_event based triggers).

7.6.3. Expected children

None.

7.6.4. Expected target

Any node in a scene graph can receive a message.

7.6.5. Examples

The example below defines an action that sends a message labeled face({$root:ind}) in which ({$root:ind}) is the value of the variable ind attached to node ID root.

<action>
  <execute_message value="face({$root:ind})" />
  <target type="single_node" value="#root" />
</action>

The example below defines an action that sends a message labeled /displayMsg with one string parameter \"Node {#nd}\".

<action>
  <execute_message value="/displayMsg \"Node {#nd}\"" />
  <target type="single_node" value="#root" />
</action>