PresetOffset - Preset Offset Function

The PresetOffset() command is used to shift the presets assignments on a load controller.
When a load controller hears a preset command for and area or a channel it recalls the level for that preset in a database. This command temporarily changes where in that database it gets the value from, offsetting by the parameter used in the function. If you are at the default offset of 0, and then you send an offset of 6, preset 1 messages will send the load controller to the values for preset 7.
This offset lasts until replaced or the load controller loses power.
Offsets do not affect sensors or panels only load controllers assigned to the area that has been offset. That makes this an elegant way to switch an area to a "night mode". The buttons and sensors will send the same message but you will get a new level for the lights.

After offsetting an area, try a ResetPreset command to fade to the new brightness level.

Syntax

PresetOffset(A=x,O=y)
Where x is the area number and y is the amount you want to offset by.
Area can be any value 0-254.
Offset can be any value 0-127
Area will default to 1 if not specified but Offset must be specified.

Examples

Example 1

{
PresetOffset(A=2,O=4) //Offset preset in area 2 by 4.  So preset 1 will not recall values from preset 5.
Delay(.2)
ResetPreset(A=2,F=60) //Slowly fade the lights to the new levels over 1min.
}

Example 2

Offset all the areas at once using a baselink area.

const# BLA 250
{
PresetOffset(A=BLA,O=0) //Undo any preset offsets for the light areas.
Delay(.2)
ResetPreset(A=BLA,F=5)  //Fade lighting areas to the new light levels over 5s.
}