Clickteam Fusion - Expression Editor GUI
The Clickteam Fusion Expression Editor
1.
2.
3.
4.
5.
Used to enter literal expressions and object expressions
Standard Numpad Keys
Shortcuts to Expression Editor expressions
Object Box
Syntax Validation Button
Clickteam Fus ion - Expres s ion Editor GUI - 1
A pril 1 1 th, 2 0 1 5
Expression Input Buttons
In order from left to right,
•
Delete - Deletes the selected text
•
Next Parameter - Highlights the next text surrounded by angle brackets such as
>number< or >text<
•
Undo - Undo the last action
•
Redo - Redo the last action
•
Decrease Font - Decreases the size of the font in the Expression Edit Box
•
Increase Font - Increases the size of the font in the Expression Edit Box
•
Format - Formats all text in the Expression Edit Box such that the text easier to read
Clickteam Fus ion - Expres s ion Editor GUI - 2
A pril 1 1 th, 2 0 1 5
Expression Edit Box
The Expression Edit Boxes are used to input expressions in to the Expression Editor. Literal
expressions, such as "Hello World", and object expressions such as " X("Active Object") "
are allowed.
C lickteam Fusion colors the various expression types; strings, numbers, integers, and
operators; in different customizable colors. within the Expression Edit Boxes.
Clickteam Fus ion - Expres s ion Editor GUI - 3
A pril 1 1 th, 2 0 1 5
Conditional Drop Down Box
The C onditional Drop Down Box is used to test for various types of conditions within the
"C ompare Two General Value" condition.
Includes:
•
Different condition - ( != )
•
Equal condition - ( == )
•
Greater Than condition - ( > )
•
Greater Than or Equal To condition - ( >= )
•
Less Than condition - ( < )
•
Less Than or Equal to condition - ( <= )
Clickteam Fus ion - Expres s ion Editor GUI - 4
A pril 1 1 th, 2 0 1 5
Expression Editor Function Group
This section contains most of the buttons; labeled 2, 3, and 5 above, used within the
Expression Editor. The following section describe the various components of the Expression
Editor Function Group.
Clickteam Fus ion - Expres s ion Editor GUI - 5
A pril 1 1 th, 2 0 1 5
Numpad Group
The buttons within the Numpad Group allows you to input numbers and parenthesis into the
Expression Editor Edit Box, similar to the NUMPAD on a physical keyboard.
Clickteam Fus ion - Expres s ion Editor GUI - 6
A pril 1 1 th, 2 0 1 5
Modulus Function
The modulus function returns the remainder between a divisor and a dividend. The modulus
function does not work correctly when A or B is negative and has a slightly different output if
A or B are non-integer.
Format: A mod B
Where:
•
A = Positive Integer
•
B = Positive Integer
Output: Positive Integer
Clickteam Fus ion - Expres s ion Editor GUI - 7
A pril 1 1 th, 2 0 1 5
Bit Operator Functions
The boolean algebra functions are mainly used in digital circuits and binary algebra. This
function does the proper circuit function on the bits of the given numbers and returns a base
10 number which represents the output from the function.
Format: A <And/ Or/ Xor> B
Where:
•
A = Real Number
•
B = Real Number
Output: Base 10 Number
Clickteam Fus ion - Expres s ion Editor GUI - 8
A pril 1 1 th, 2 0 1 5
Pi Constant
This button acts as a shortcut for the PI constant. When pressed, 3.141592654 is inserted
into the Expression Editor Edit Box
Clickteam Fus ion - Expres s ion Editor GUI - 9
A pril 1 1 th, 2 0 1 5
Square Root Function
This function takes the square root of a number.
Format: Sqr(A)
Where:
•
A = Non-negative number
Output:
•
Non-negative number if successful
•
"-1.#IND" if A is a negative number
**Note**
1.#IND cannot be evaluated in the expression editor so you must make sure A >= 0
Clickteam Fus ion - Expres s ion Editor GUI - 10
A pril 1 1 th, 2 0 1 5
Trigonometric Functions
These functions perform the basic trigonometric functions on their given arguments
Format: Sin(A), C os(A), Tan(A)
Where
•
A = Any number
Output:: Any Number
**Note**
All inputs should be in degrees (not radians) and all outputs are in degrees.
Clickteam Fus ion - Expres s ion Editor GUI - 11
A pril 1 1 th, 2 0 1 5
Transcendental Functions
The transcendental functions performs their respective functions on the the given input
Format: Ln(A), Log(A), Exp(B)
Where:
•
A = Positive Integer
•
B = Any Number
Output: Real Number
Clickteam Fus ion - Expres s ion Editor GUI - 12
A pril 1 1 th, 2 0 1 5
String Functions
The string functions return part of a string. The Left$ function returns x amount of
characters from the beginning of the string while the Right$ function returns x amount of
characters from the end of the string. The Mid$ function starts at a specified character and
returns x characters from the initial character.
Format: Left$(A,B), Right$(A,B), Mid$(A,B,C )
•
Where:
•
A = String
•
B = Any Number
•
C = Any Number
Output: String
Clickteam Fus ion - Expres s ion Editor GUI - 13
A pril 1 1 th, 2 0 1 5
Data Conversion
The Val() and Str$() functions convert a string into a number, and a number into string
respectively.
Format: Val(A), Str$(B)
Where:
•
A = String
•
B = Any Number
Output: Number, String respectively
**Note**
Trying to convert a letter/series of letters into a number, such as Val("Hello World") will
always return a 0 unless the string is a hexadecimal or binary string.
Clickteam Fus ion - Expres s ion Editor GUI - 14
A pril 1 1 th, 2 0 1 5
String Length Function
This function returns the length of a string, excluding any null terminators.
Format: Len(A)
Where:
•
A = String
Output: Non-negative Integer
Clickteam Fus ion - Expres s ion Editor GUI - 15
A pril 1 1 th, 2 0 1 5
Random Ranges
The random functions generate a random number. Random generates a number from 0 ≤ x
≤ (max_number - 1) while Random Range generates min_number ≤ x ≤ max_number
Format: Random(A), RRandom(B, C )
Where:
•
A = Positive Integer
•
B = Integer where B ≤ C
•
C = Integer where C ≥ B
Output: Integer
Clickteam Fus ion - Expres s ion Editor GUI - 16
A pril 1 1 th, 2 0 1 5
Min/Max Functions
These functions return the minimum or maximum of two numbers. C haining these functions
allows you to check the min/max of multiple numbers
Format: Min(A,B), Max(A,B)
Where:
•
A = Real Number
•
B = Real Number
Output: Real Number
Clickteam Fus ion - Expres s ion Editor GUI - 17
A pril 1 1 th, 2 0 1 5
Syntax/Error Box
The error box will tell you of any problems in the entered expression. If a problem is found,
an error message becomes displayed.
Messages include:
•
Valid Expression: Everything is ok.
•
Enter a Numeric Expression: The entered expression is a string, but should be a
number. Solution: Wrap Val() around the string portion(s).
•
Enter a Text Expression: The entered expression is a number, but should be a string.
Solution: Wrap Str$() around the numerical portion(s).
•
Mixed String and Numbers: The entered expression has numbers and strings in it.
Solution: C onvert all sections of the expression to string or numbers.
•
Syntax Error: A critical delimiter is missing from the expression, such as a comma, or
a quotation mark. Solution: Insert the correct delimiter into the expression.
•
Missing C lose Bracket: The entered expression contains too many closing parenthesis.
Solution: Insert a closing bracket at the appropriate place in the editor.
•
Too many C lose Brackets: The entered expression contains too many closing
Clickteam Fus ion - Expres s ion Editor GUI - 18
A pril 1 1 th, 2 0 1 5
parenthesis or not enough opening parenthesis. Solution: Remove a closing bracket.
**Note**
C licking the "Where?" button will set the cursor to the next syntax error in the Expression
Editor Input Box.
Expression Editor Object Box
In MMF2, accessing the expressions of other objects, required a click on the "Retrieve data
from object" button. C lickteam Fusion completely removes this button and allows direct
access to other objects through the Object Box, saving time and clicks.
Clickteam Fus ion - Expres s ion Editor GUI - 19
A pril 1 1 th, 2 0 1 5
Object Box View Buttons
These buttons allow the way the objects in the Object Box are listed.
The options, in order from left to right, are:
•
Display objects as big icons
•
Display objects as small icons
•
Display object as a list
Clickteam Fus ion - Expres s ion Editor GUI - 20
A pril 1 1 th, 2 0 1 5