View Last Log / Variable / If / Switch
The log for the edited sequence can be referred by menu View Last Log in Edit Sequence, which is available with FRep Unlock Key. To get the details, you can add Variables control, or Set variables on success/fail for important phase. The used variables can be referred in the log, too.
View Last Log in Edit Sequence (Requires Unlock Key)
Show success/fail, finished time, and last played item for last playing. Variables referred in the sequence are also shown. With Log Only Last Error option, successful playing does not overwrite the log.
– Date
The date of playing finished with rectangle of result color, green for success, red for fail or interrupted.
– Label, Result: Last played item
Label name on playing, result of success or fail/interruption, and #. label of item of last played.
– Error message
Information message about the issue for the failure or abort.
– Referred variables
The variables referred in the sequence with their values at finish playing.
Variables
Retrieve and/or calculate values in playing sequence to store them to variables. The variables can be used in specific control settings or IF / Switch branch (see next section). The stored values are common in all sequences, i.e. all variables can be referred / overwritten by other sequences.
Registered statements in the list will perform from above.
Remove / prepend statements from left trash / right + buttons, edit by tapping the statement. Long-tap the statement will start dragging to reorder in the list.
Format of statements;
(Destination Variable)=(Code):(Arg1)(Operator)(Arg2)
Variable name: [A-Za-z_@][0-9A-Za-z_]+
Definable variable name consists of alphanumerical characters and under bar(_). First letter cannot be a number. The reserved variables as environmental variables start with @, and they are used only for arguments and some settings.
frep0, frep1, frep2, frep3, frep4 are passed to Tasker as temporal variables %frep0, %frep1, %frep2, %frep3, %frep4 by Tasker Event Plugin (%frepsuccess will be 1 for success or 0 for fail to play).
Value Type [(Empty), Number, Rectangle, String]
There are 4 value types including empty value. The type of variables are determined by the value they have.
| Type | Description | Example |
| (Empty) | The state of no value defined. *Shown as null in Log. |
var=num: var=rect: var=str: |
| Number | Integer or decimal, including negative value. | var=num:0 var=num:0.012 var=num:-0.5 |
| Rectangle | Rectangle defined by: (left top right bottom) Each component must be integer or variable. |
var=rect:(10 20 30 40) |
| String | String defined by: “character sequence” Escaped characters; (line feed)\n (tab)\t (\backslash)\\ (“quote)\” |
var=str:”line1\nline2″ |
@reserved environmental variables
System variables for referring the state of device or playing sequence.
| Name | Type | Description |
| @repeat | Number | Current repeat number (0 for first time) |
| @loop | Number | Last loop count number (0 for first time) |
| @lastif | Number | Last IF result (success/true:1, fail/false:0) |
| @rotation | Number | Current orientation of the device (0: 0°, 1:90°, 2:180°, 3:270°) |
| @cpuusage | Number | Current CPU load (0~100) *Works on Android ~7 |
| @start | Number | Starting time (ms) |
| @now | Number | Current time (ms) |
| @lastfinish |
Number | Success of failure of last replay (0:not replayed, -1:failed/interrupted, 1:successful) |
| @laststep |
Number | Step No. in Edit Sequence on last replay finish (0 if it is not replayed) |
| @lastmatch | Rectangle | Latest successful Image Match position |
| @screen | Rectangle | Screen size of the device (fixed for orientation 0°) |
| @clipboard | String | Contents of the clipboard text *Works on Android ~9 |
| @tofrep |
String | Text passed by the caller, by FRep Tasker Plugin (Empty when started manually or with shortcut) |
Special modification for variables; var.left, var.x, var.length
For some types of variables, the derived values can be referred by special postfix modification.
| Modification | Description | Example |
| (Rect).left (Rect).top (Rect).right (Rect).bottom |
Refer each component of the rectangle | l=num:r.left |
| (Rect).x (Rect).y |
Refer the center x or y of the rectangle x=(left+right)/2 y=(top+bottom)/2 |
centerx=num:r.x |
| (Rect).width (Rect).height |
Refer the width or height of the rectangle width=right-left height=bottom-top |
w=num:r.width |
| (String).length | Refer the length of the string | len=num:s.length |
| (String).asnum (String).asrect |
Refer the number converted from numeric string Refer the rectangle converted from “(left top right bottom)” type string |
n=num:s.asnum r=rect:s.asrect |
| (String).asint (Num).asint |
Refer the integer number (truncated after the decimal point) | i=num:s.asint i=num:n.asint |
| (Num).asstr (Rect).asstr |
Refer the number / rectangle as string | s=str:n.asstr s=str:r.asstr |
| (Num).asdate (Num).astime |
Refer the time (ms) number as date string with format “yyyy/MM/dd kk:mm:ss” Refer the time (ms) number as time difference string with format “hour:min:sec.ms” |
s=str:@now.asdate t=num:@now–@start s=str:t.astime |
Code references
num: Set / Calculate Number
| Operator | Arg1 | Arg2 | Description | Example |
| (None) | Variable, Number, (Empty) | (None) | Set number value | var=num:0 |
| + – * | Variable, Number | Variable, Number | Add Subtract Multiply | var=num:var + 1 |
| / | Variable, Number | Variable, Number | Divide (If Arg2 is 0, returns Arg1 without change) |
var=num:var / 3 |
| % | Variable, Number | Variable, Number | Residue (If Arg2 is 0, returns 0) |
var=num:var % 3 |
| & | ^ | Variable, Number | Variable, Number | Bit operation AND OR XOR (Args are forced to be integer) |
var=num:var & 7 |
| ~ | Variable, Number | Variable, Number | Bit operation ANDNOT (Args are forced to be integer) |
var=num:var ~ 128 |
rect: Set / Calculate Rectangle
| Operator | Arg1 | Arg2 | Description | Example |
| (None) | Variable, Rectangle, (Empty) | (Empty) | Set rectangle value | var=rect:(0 0 100 200) |
| + – * | Variable, Rectangle | Variable, Number, Rectangle | Add Subtract Multiply *If Arg2 is rectangle, each component will be used for calculation. If Arg2 is number, it is applied for all components. |
var=rect:var + (10 20 10 20) *Move the var rectangle by (10,20) |
| / | Variable, Rectangle | Variable, Number, Rectangle | Divide *If Arg2 is rectangle, each component will be used for calculation. If Arg2 is number, it is applied for all components. When the component is divided by 0, it will not change. |
var=rect:var / (2 2 0 0) *Halve the (left, top) coordinates |
| & | Variable, Rectangle | Variable, Rectangle | Intersect Retrieve common area in both rectangles. |
var=rect:var & @screen *Clip by screen size |
| | | Variable, Rectangle | Variable, Rectangle | Union Retrieve the minimum area which covers both rectangles. |
var=rect:var | @lastmatch *Expand rectangle to contain image matched area |
str: Set / Calculate String
| Operator | Arg1 | Arg2 | Description | Example |
| (None) | Variable, Number, Rectangle, String, (Empty) |
(None) | Set String value | var=str:”char seq” |
| + | Variable, Number, Rectangle, String |
Variable, Number, Rectangle, String |
Concatenate 2 values as string | var=str:var + “\n” *Append line feed |
| sub | Variable, String | Rectangle | Extract string from Arg1, as defined range of Arg2 (la ln ca cn).When ln>0, extract ln lines from offset:la.When cn>0, extract cn characters from offset:ca.*If la<0 or ca<0, each extraction starts from back position from tail. | var=str:var sub (1 2 5 10) *Extract 2 lines from var, offset:1 (#2,3 line) and then get 10 characters from 6th.var=str:var sub (a 1 0 0) *Extract line #(a+1) from var.var=str:var sub (0 0 -5 5) *Extract last 5 characters from var. |
| idx | Variable, String | Variable, String | If Arg1 contains Arg2 string, the position of Arg2 start in Arg1 string (first is 0). If Arg1 does not contain Arg2 string, -1. |
var=str:”abcde” idx “cd” *var is 2.var=str:”abcde” idx “f” *var is -1. |
| read | Variable, String | (None) | Read the file designated by the path of Arg1. (up to 1MB) | var=str:”/sdcard/test.txt” read |
Other Functional Codes
| Code | Arg1 | Arg2 | Description | Example |
| toast: | Variable, Number, Rectangle, String |
(None) | Show the message by popup. | toast:”message” |
| clean: | (None) | (None) | Clear all variables except environmental ones(@~). | clean: |
IF
Branch or finish the sequence by condition of variables. If they meets the conditions, the sequence proceeds to On Success, and @lastif will be 1. If not, the sequence proceeds to On Fail, and @lastif will be 0.
Registered statements in the list will perform from above.
Remove / prepend statements from left trash / right + buttons, edit by tapping the statement. Long-tap the statement will start dragging to reorder in the list.
Format of statements;
and/or(not):(Arg1) (Operator) (Arg2)
Combined condition by and: or: (andnot: ornot:)
Multiple conditions can be combined with and: / or: cases. With and:, previous condition must be met to succeed. With or:, new condition check starts even if the above conditions fail. The first condition ignores and: / or: cases because they make sense only with previous condition(s). Neither of and: or: cannot be nested. If there are multiple conditions divided by or:, each section is colored in the list.
andnot: ornot: are variant of and: or:, they use the reversed result of each condition check.
Operators for condition
| Operator | Arg1,2 | Description | Example |
| == != |
Variable, Number, Rectangle, String, (Empty) |
Check if the contents of Args are equal or not equal. | and:var == “char seq”and:@loop == 0 *Check if first loop or not |
| > >= < <= |
Variable, Number | Compare the number of Args. | and:var > 0 |
| & | Variable, Number, Rectangle | If Args are numbers, success on the result of BITAND operation is not zero.If Args are rectangle, success on any intersect area exists. | and:var & 5and:r & @lastmatch *Check if the result of Image Match hits on r or not |
| ]= | Variable, Rectangle, String | If Args are rectangle, success when Arg1 equals or includes whole Arg2 area.If Args are string, success when Arg1 contains Arg2 string. | and:r ]= @lastmatch *Check if the result of Image Match is in r or notand:var ]= “ok” *Check if var has string “ok” or not |
Switch
Branch the sequence by condition of variables. Each condition has respective destination. The conditions are evaluated from the top of the list, and the sequence proceeds to the destination of first met condition. When all conditions do not match, it goes to Other(default): destination.
Remove / prepend statements from left trash / right + buttons, edit by tapping the statement and the destination. Long-tap the statement will start dragging to reorder in the list.
The available operators are same with IF statements, except for combination (and: or: etc).
TIPS
– To confirm the contents of the variables on successful replay, set Log Only Last Error option to OFF and then play the sequence.
– To set the clipboard text as variable, add Clipboard control and assign the variable from ▼ button in its settings.