Viz Artist

Version 3.11.0 | Published January 22, 2018 ©

Control List

images/download/attachments/27789238/viz_icons_controllist.png
The Control List plug-in allows creation of table controls. By following some design conventions when designing the table in Viz Artist, Viz Trio will show a table editor to the user. This editor supplies a more effective way for filling tables than having one tab field for each table cell.

Note: This plug-in is located in: Built Ins -> Container plug-ins -> Control

This section contains information on the following topics:

Control List Properties

images/download/attachments/27789238/plugins_container_controllist_editor_r.png

  • Number of exposed rows: Sets the default number of exposed rows for the scene when the number of rows can be changed by the operator. If the number of rows cannot be changed the number of exposed rows is fixed.

  • Mutable Number of Rows: If set to on, the operator can add or delete rows.

  • Minimum and Maximum Number of Rows: Sets the minimum and maximum number of rows. To the operator, the number of fields can only be added or deleted when inside the range (for example greater than > 2 and less than < 10).

Tables and Preview Points

A table scene might be hard to read if you need to show a large table with many rows (e.g. 20) and/or columns. In such cases it is not uncommon to only show a subset of the information (e.g. 5 rows), and rather animate the scene to show the next 5 rows and so on.

However, in such a situation, while editing table data in Viz Trio, you cannot use a basic jump to Key Frame event for preview, as this will only show the Key Frame that relates to the table’s Field identifier (e.g. 3), and not the rows or columns of the table.

To enable operators to preview the data in the scene, it is therefore possible to add a preview point that extends to the next starting point (i.e. the next 5 rows of the table), using the table’s (Control List) Field identifier in addition to the row number.

So, if the identifier of Control List is 03, you have to define tags with names 03.0, 03.5, 03.10 and 03.15 (zero based row index) for Viz Trio to detect the tags and jump to them on focusing the according rows in Viz Trio’s Control List table editor.

  • Basic jump to Key Frame: When adding Key Frame events (stop points, tags,...) and giving them the name of a control plug-in identifier, Viz Trio jumps the time-line to that Key Frame event when selecting the tab field with that identifier.

  • Extended jump to Key Frame: If the Key Frame event name is e.g. 3_005 and there is a control list with identifier 3, then Viz Trio jumps the time-line to that Key Frame event. In this case when the sixth row of the table is focused.

To Design a Table Scene

images/download/attachments/27789238/plugins_container_controllist_example.png
To design a table scene that will be correctly interpreted by the Control List plug-in there are some design conventions that needs to be followed:

  1. Add a group as the root container for the table. Give it a descriptive name such as “table”

  2. Add the Control List plug-in to the table group container

  3. Add a new group as a Sub-Container to the table container. This container will be the design for the rows in the table. Give it a name such as “row_1”.

  4. Add a Control Object plug-in to the newly added row container.

  5. As Sub-Containers of the row container, add text containers with backgrounds to form the design for a single table row with the required number of columns.

    • Each of the text containers must get a Control Text plug-in and the field identifiers for each must be set from 1-n depending on how many columns the table should have.

    • The Description property in the ControlText plug-ins will be picked up by the Control List plug-in and used as column headers.

  6. When the single row looks as it should, duplicate it to make the needed total number of table rows.

    • The container plug-in Coco can be used to automate this task.

    • Add the Coco plug-in to the row container, and set the number of copies, for example 9 (1+9=10), and click Execute.

  7. Arrange the rows

    • The arrange plug-in Grid Arrange can be used to automate this task.

    • Add the Grid Arrange plug-in to the table container, and set the number of rows to the same as above and press ENTER.

    • Set the row offset and press ENTER.
      The table item of the scene is ready and when imported into Viz Trio and read, the table tab-field will be shown with a special table editor. When imported into Viz Template Wizard, a template with a custom table editor will be generated.

See Also