November 10th, 2013, 5:01 pm BrianDeveloper [1651 posts]

We have added a new IfAction option called IfConditions.

IfConditions allow you to evaluate a mathematical formula that will execute an action based on when the formula is either true or false. IfConditions can be used in any type of measure and you may have multiple IfConditions per measure (eg. IfCondition2/IfTrueAction2/IfFalseAction2). Formulas need to follow the same rules as the Formula option for Calc measures. All the mathematical operators, constants, and functions (except Random and Counter) are available to use. Like Calc, measure names do not need [brackets] and are always dynamic when referenced inside the condition.

Options:

IfCondition - A mathematical formula that will evaluate to either true or false.

IfTrueAction - If the condition is true, this action is executed only once when the condition becomes "true", so it needs to become "false" and again "true" to execute again.

IfFalseAction - If the condition is false, this action is executed only once when the condition becomes "false", so it needs to become "true" and again "false" to execute again.

IfConditionMode - If set to 1, the appropriate actions will execute on every update of the measure instead of the default behavior (described above).

Here's how it works:

Define a boolean condition, which is a formula that evaluates to true or false. Example: IfCondition=(MeasureCPU >= 10) && (MeasureCPU < 90)

Define a True and/or False action to perform when the IfCondition is evaluated. Example: IfTrueAction=[!SetOption MeterCPU Text "CPU usage is between 10 and 90 percent!"]

Note: The comparison on either side of logical AND && and OR || operators must be enclosed in (parentheses).

That's it!

Here are some example skins made by jsmorley. They are all included in the .rmskin:

This skin has two "counters", one that counts up to "Limit" and starts over, and the other that counts down from "Limit". Since we want the current value of the measure to change the formula that is doing the counting on every update, we need to use IfConditionMode=1 on this skin.

This skin simply rolls two dice and sets the appropriate Image meters. Then it evaluates the roll, and sets a String meter to The results. Again, since we are dynamically using the value of the measure and some text in the String meter on each "roll", we need to use IfConditionMode=1 on the measures.

[MeasureBothDice] Measure=Calc Formula=MeasureDieOne + MeasureDieTwo IfCondition=MeasureDieOne = MeasureDieTwo IfTrueAction=[!SetOption MeterBothDice Text "Roll is [MeasureBothDice] and is doubles!"] IfFalseAction=[!SetOption MeterBothDice Text "Roll is [MeasureBothDice]"] IfCondition2=MeasureBothDice = 2 IfTrueAction2=[!SetOption MeterBothDice Text "Roll is Snake Eyes"] IfCondition3=MeasureBothDice = 12 IfTrueAction3=[!SetOption MeterBothDice Text "Roll is Boxcars"] IfCondition4=MeasureBothDice = 7 IfTrueAction4=[!SetOption MeterBothDice Text "Roll is Lucky Seven"] IfConditionMode=1 UpdateDivider=5

This skin simply generates a random number, and tests whether it is a single digit number or not, and whether it is "odd" or "even". Since we are using %1 in the bangs, and MeasureName=MeasureRandom in the Meter, we don't need to have the measure with the IfConditions execute on every update, and we leave IfConditionMode=1 off, so it defaults to "0".

This skin generates a random number in [MeasureTwo]. On the next update, it checks [MeasureOne] to see if the number is a "new" one on this update, or is the same one as last time.

Note that we are using a Substitute to turn the number into text. Since the Substitute changes the value from a number to text, it can't be used in IfCondition to do the comparison. So what we do is use the Section Variables form of the measure [MeasureTwo:] in order to obtain the original number value of the measure. While measures are always "dynamic" when used in Calc measures or (as in this case) IfCondition options, Section Variables are not. So we need to use DynamicVariables=1 on the measure.

[MeasureTwo] Measure=Calc Formula=Random LowBound=1 HighBound=5 UpdateRandom=1 IfCondition=(MeasureOne <> [MeasureTwo:]) IfTrueAction=[!SetOption MeterOutput Text "The number is now %1"] IfFalseAction=[!SetOption MeterOutput Text "The number stayed %1"] OnUpdateAction=[!SetOption MeasureOne Formula [MeasureTwo:]] Substitute="1":"ONE","2":"TWO","3":"THREE","4":"FOUR","5":"FIVE" UpdateDivider=2 DynamicVariables=1

This skin gets the day of the week as text (Sunday, Monday etc.) and the day of the week as a number (0=Sunday, 1=Monday etc.). Then it checks to see if the number reflects a weekend (6 or 0) or a weekday. The appropriate text is set on the String meter. Note that while we need IFConditionMode=1 in order to set the correct text on each update, we really don't need to update the measure at all unless the day of the week changes. So we use an OnChangeAction on the measure getting the day of the week as text, and have it update the measure getting the number and doing the comparison, which is patiently waiting without acting due to UpdateDivider=-1.

[MeasureWeekdayNum] Measure=Time Format=%w IfCondition=(MeasureWeekdayNum = 6) || (MeasureWeekdayNum = 0) IfTrueAction=[!SetOption MeterOutput Text "[MeasureWeekdayName]#CRLF#It's the weekend#CRLF#Go back to bed!"] IfFalseAction=[!SetOption MeterOutput Text "[MeasureWeekdayName]#CRLF#It's a weekday#CRLF#Go to work!"] ConditionMode=1 UpdateDivider=-1

to execute something when the weather is Rain, Heavy Rain, Rainshowers, etc. for example

You are like a bad, spoiled child!

I would think that you could use RegExpSubtitute on the WebParser measure to turn the "weather condition" into a number with that regular expression. Then use as many IfConditionN as you need to take actions based on the "true" or "false" tests.

Sort of "anything with rain is 1", "anything with cloudy is 2", "anything with thunder is 3", etc...

Not that some kind of regular expression based IfCondition wouldn't be nice, but it is a different animal to create than the one that is based on the existing math "conditional formula" functionality we use. We didn't really have to invent any wheels to get this. We basically just add "? 1 : 0" to the end of the formula in IfCondition, and off it goes.

November 10th, 2013, 10:58 pm jsmorleyDeveloper [17493 posts]

P.S. Moshi, this can in fact pretty much replace the IFAction functionality, while being arguably easier to understand and certainly much more powerful.

jsmorley wrote:I would think that you could use RegExpSubtitute on the WebParser measure to turn the "weather condition" into a number with that regular expression. Then use as many IfConditionN as you need to take actions based on the "true" or "false" tests.

yeah, pretty much everything is possible with RegExpSubstitute, i just would love to add this to the tips & tricks section: