Set up a dynamic link

Ways to create a link

A dynamic link can be created in different ways. Depending on how it is created, Q Studio automatically runs some settings, shown below:

Mode

Effects

Manual selection of the source using the dynamic link window

Q Studio sets the mode of the dynamic link.

Dragging a source variable on a property

Q Studio sets the mode of the dynamic link.

Dragging a source variable on a graphical object

  • Q Studio sets the dynamic link on the most suitable property of the object based on heuristics.

  • Q Studio sets the mode of the dynamic link.

Through the Advanced Dynamic Link Editor (see Advanced Dynamic Link Editor)

  • Q Studio does not automatically configure any property. The editor allows setting the following elements:

    • source(s) of the link

    • mode of the link

    • transformations of source values based on customized logics that can be created using converters (see Converters).

Setting a Dynamic link by selecting a Source

  1. In Project click a node whose property is to be set through dynamic link.

  2. In Properties panel, near the desired property, click image1: the dynamic links window opens.

  3. Select the source node.

  4. Optional. If an attribute of a node is to be used as source, select it in Attribute.

  5. Optional. If the value of the parent node is to be formatted according to the type of source data, select the appropriate format in the Format field.

  6. (Only for array variables) In Array Indexes, enter the index value to select the relevant variable.

  7. Click Select: the reference to the node or variable selected will appear in the field (see References to the source in the properties with dynamic value).

Setting a Dynamic Link by Dragging the Source

Dragging a Property

  1. In Project click a node whose property is to be set through dynamic link.

  2. Drag a node from Project to the Properties panel in the value field of the property whose value is to be set: the reference to the source variable will appear in the field (see References to the source in the properties with dynamic value).

Dragging a Graphical Object

From Project, drag a variable to a graphical object in the editor: Q Studio sets a dynamic link to the most appropriate property of the graphical object.

Setting a Dynamic Link Using the Advanced Dynamic Link Editor

  1. In Project click a node whose property is to be set through dynamic link.

  2. Near the value field of the property to be set, click image2, then click Advanced: the dynamic link editor will open.

  3. Set the link and any transformations to be run on the reference value (see Using the Advanced Dynamic Link Editor).

Depending on the type of source selected for dynamic linking, the source is displayed in the property value field in different ways.

If the source selected is…

Then the value field of the property displayed…

a node or a variable

the BrowseName of the source.

an attribute of a node or of a variable

BrowseName@[name of the attribute].

an array variable

BrowseName[array index values].

an array index of the array variable

BrowseName[array index number] (e.g. [1] = first array index).

a property of a node

the path of the source node.

a node or a variable formatted by the user

the information on the source, followed by [(formatted)].

Actions on the dynamic value of the properties

Action

Description

Click BrowseName

Select the source in the Project panel.

Double-click the path of the source property

Enable the change of the path.

  • Click image4

  • Double-click an empty area of the property value field

  • F2 key

Displays the source node path and makes it possible to change it.

See also

Related concepts

Dynamic Links

Related APIs

API for dynamic links

References

Dynamic Link Window