Set an analog/dimmable device to a level between 0 and 100
dim “name of the unit or group”
brighten “name of the unit or group”
dim "foyer light" to 45
dim "foyer light" to 45 in 30
brighten "foyer light" by 25 in (5 * minutes) for (30 * minutes)
dim and brighten are interchangeable. Either verb can perform either action. You dont have to know the value of the light and figure out if you're actually going to dim or brighten it and issue the proper command. If the light is at 50% and you say dim “myLight” to 100 that will work just as well as saying brighten “MyLight” to 100.
If the unit is blocked and you issue a dim or brighten command no scripts will run and no commands will be sent.
You may use either the “to” clause or the “by” clause, but not both.
The “by” clause is intended for “relative” changes.
As an aid in preventing limit errors in such “relative” changes, Xtension will limit the range of the command to values between 0 and 100 for real units. If the unit has it’s use min/max turned on in the Advanced tab of the Edit Unit window those values will be used instead.