Transition Icon Properties - Revision history

SteveT at 14:18, 12 June 2026

2026-06-12T14:18:38Z

MartinW at 11:05, 4 April 2023

2023-04-04T11:05:58Z

MartinW at 09:15, 4 April 2023

2023-04-04T09:15:32Z

MartinW: Created page with "Coming soon"

2023-03-22T10:30:37Z

Created page with "Coming soon"

New page

Coming soon

@@ Line 1: / Line 1: @@
 Transitions are lines that connect two states in a state diagram.
@@ Line 4: / Line 17: @@
-Like a state, transitions have a display name (i.e. the text displayed on the state within the diagram) and an optional function (macro call, calculation, delay or execute C code) which is executed when the program flow traverses the transition.
+'''Display Name'''
-In addition, transitions have a condition which is an expression that evaluates to true (non-zero) or false (zero).
+Each transition leaving that state has its condition tested in turn to see which path the program flow should continue along. The order that these are checked is set in the State icon's property page.
-When a state has performed its own optional function, each transition leaving that state has its condition tested in turn to see which path the program flow should continue along.
+The condition expression can be optionally displayed or hidden on the icon itself when the "Show" tick-box is unticked.
 Transitions have an optional label which can display the name of the transition, its condition, or its function.
-Setting the colour of a transition sets the colour of its label.
+The colour of a transition can be changed by right-clicking the transition and selecting "Set shape colour".
+This sets the colour of its label. The colour of the transition line and arrow cannot be altered.
 The entry state icon includes a special transition leaving it which should point to the first state to be executed in the state diagram (after the entry state itself).
@@ Line 30: / Line 86: @@
 During program execution (simulation or ICD), the colour of the transition line changes to blue or orange when its condition is being evaluated – blue signifies the condition is false and the transition will be ignored, and orange signifies that the transition is true and the program flow with execute along this transition.
 When the transition is executing, it changes to a thick orange line.

← Older revision		Revision as of 11:05, 4 April 2023
Line 33:		Line 33:

	When the transition is executing, it changes to a thick orange line.		When the transition is executing, it changes to a thick orange line.
−
−	~~==Transition Order==~~
−	~~In a state diagram, if a state has multiple transitions leaving it then these need to be evaluated in a set order to ensure program execution is expected and repeatable.~~
−
−	~~For example, if two transitions leave a state both evaluate to “true”, we need to ensure one of the transitions has priority over the other.~~
−
−
−	~~When a state with multiple exit transitions is selected, the order of transition evaluation is displayed, where “1” shows the first transition to be evaluated.~~
−
−	~~This transition order is also shown if a transition is selected. A state with only one transition leaving it will not show the transition order.~~
−
−	~~[[File:State_Icon1.png]]~~
−
−	~~The order can be set on the diagram itself by reconnecting the transitions to the state (the last transition to be connected will have the lowest priority).~~
−
−	~~Alternatively, the transitions can be reordered by editing the properties of the state icon and clicking “Set transition order” to open the Transition Order dialog.~~
−
−
−	~~When using the Transition Order dialog, the applicable transitions are listed using either their name, condition or function.~~
−
−	~~Highlighting a transition and pressing the up/down arrows will move it higher/lower in the transition order.~~
−
−	~~The transition at the top of the list will be evaluated first.~~
−	~~When transitions are evaluated, the evaluation process stops once a transition has evaluated to true.~~
−
−	~~All other transitions leaving the state are assumed to be false even if they have not been evaluated yet.~~

← Older revision		Revision as of 09:15, 4 April 2023
Line 1:		Line 1:
−	~~Coming soon~~	+	Transitions are lines that connect two states in a state diagram.
		+
		+	These lines have an arrow at one end signifying the direction of program flow through the transition.
		+
		+
		+	Like a state, transitions have a display name (i.e. the text displayed on the state within the diagram) and an optional function (macro call, calculation, delay or execute C code) which is executed when the program flow traverses the transition.
		+
		+
		+	In addition, transitions have a condition which is an expression that evaluates to true (non-zero) or false (zero).
		+
		+	The condition is used during program execution to determine if the program flow should proceed along that transition.
		+
		+	When a state has performed its own optional function, each transition leaving that state has its condition tested in turn to see which path the program flow should continue along.
		+
		+
		+	Transitions have an optional label which can display the name of the transition, its condition, or its function.
		+
		+	Setting the colour of a transition sets the colour of its label.
		+
		+	The colour of the transition line and arrow cannot be altered.
		+
		+
		+	The entry state icon includes a special transition leaving it which should point to the first state to be executed in the state diagram (after the entry state itself).
		+
		+	This transition is always connected to the enter state and cannot be deleted.
		+
		+	Also, it has no properties and so cannot have a label or code.
		+
		+	It is always executed as if its transition condition is true.
		+
		+
		+	During program execution (simulation or ICD), the colour of the transition line changes to blue or orange when its condition is being evaluated – blue signifies the condition is false and the transition will be ignored, and orange signifies that the transition is true and the program flow with execute along this transition.
		+
		+	When the transition is executing, it changes to a thick orange line.
		+
		+	==Transition Order==
		+	In a state diagram, if a state has multiple transitions leaving it then these need to be evaluated in a set order to ensure program execution is expected and repeatable.
		+
		+	For example, if two transitions leave a state both evaluate to “true”, we need to ensure one of the transitions has priority over the other.
		+
		+
		+	When a state with multiple exit transitions is selected, the order of transition evaluation is displayed, where “1” shows the first transition to be evaluated.
		+
		+	This transition order is also shown if a transition is selected. A state with only one transition leaving it will not show the transition order.
		+
		+	[[File:State_Icon1.png]]
		+
		+	The order can be set on the diagram itself by reconnecting the transitions to the state (the last transition to be connected will have the lowest priority).
		+
		+	Alternatively, the transitions can be reordered by editing the properties of the state icon and clicking “Set transition order” to open the Transition Order dialog.
		+
		+
		+	When using the Transition Order dialog, the applicable transitions are listed using either their name, condition or function.
		+
		+	Highlighting a transition and pressing the up/down arrows will move it higher/lower in the transition order.
		+
		+	The transition at the top of the list will be evaluated first.
		+	When transitions are evaluated, the evaluation process stops once a transition has evaluated to true.
		+
		+	All other transitions leaving the state are assumed to be false even if they have not been evaluated yet.