CommandFusion Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Joins ======

CommandFusion software uses a method of data assignment and object identification called 'Joins'. Joins are basically a way of assigning a value to a particular GUI object (or multiple objects). You can think of a join as the ID of a GUI object such as a [[software:gui-designer:buttons|Button]], [[software:gui-designer:sliders|Slider]], etc.\\

Joins are divided into four data types:
  - Digital
  - Analog
  - Serial
  - List

===== Digital Joins =====

A digital join has two possible values, 0 or 1 (off or on, low of high, active or inactive). This boolean data type allows button interaction, such as detecting [[software:gui-designer:buttons|button]] press/release and toggling the button, as well as showing/hiding [[software:gui-designer:subpage|subpages]] and performing page flips.

Within guiDesigner, digital join numbers will appear on a blue background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled. 

===== Analog Joins =====

An analog join has an integer value ranging from 0 (zero) to 65535. This whole integer data type allows for [[software:gui-designer:gauges|gauge]] and [[software:gui-designer:sliders|slider]] interactions, such as setting a gauge level or sending a level when adjusting a slider.\\
It can also be used to adjust the Interval of [[software:gui-designer:timers|Page Timers]].

Within guiDesigner, analog join numbers will appear on a red background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled.

===== Serial Joins =====

A serial join has a string value, with no length limitation set on the CommandFusion end (a Control System being used may have it's own string length restrictions however).
This string data type allows showing dynamic text, dynamic images URLs, webview URLs, etc.
A serial join value can also be set using [[software:gui-designer:input-field|Input Fields]] within iViewer.

Within guiDesigner, serial join numbers will appear on a black background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled.

===== List Joins =====

A list join is used to identify a List object.

Within guiDesigner, list join numbers will appear on a red background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled.

===== Join Numbers =====
The actual number used can be in the range from 0 to 999999999. The same join number and join type can be assigned to multiple objects in your GUI, and they will all react to a change of the join value.

A join number of zero (0) is a special case, which means "no join assigned". By default all objects are assigned a zero join.
CommandFusion Wiki

User Tools

Site Tools

Page Tools
