Persistence in programming means a state which remains after the process that created it has ended. For example a word processor or paint application achieves this by saving the document to a file. The Cronus does this by writing variable values to its EEPROM (Electrically Erasable Programmable Read-Only Memory). This allows you to save the value of a variable so it can be recalled the next time the script is loaded.

Persistent Variables, or PVAR, can be accessed and set from any slot. They are generally used to pass values between scripts. 16 constants have been created for use with the get and set commands for persistent variables, they are:

Slot Persistent Variables, or SPVAR, are private to a specific memory slot. Each of the memory slots has 16 private variables (64 for Cronus Zen), which are used to save specific values for one script. For example, Cronus Zen Slot 1 has 64 private variables which no other Slot can access, you cannot read or set the value of Slot 1's variables from Slot 4, and setting the private variables in Slot 1 will not have any effect on the private variables in any other slot. Constants have been created for use with the get and set commands for persistent variables, they are:

To retrieve the value stored in a persistent variable or to set the value of one, the following functions are available:

get_pvar

get_pvar returns the value stored in a Persistent Variable while allowing you to specify the minimum and maximum permissible value and a default value should the value stored be outside of that range. The min, max and default parameters are mainly intended for when you are retrieving values from a Global variable, however, they must still be specified when reading the value of a private variable.

int a, b , c;
 
init {
    a = get_pvar(SPVAR_1,  0, 10,  5);
    b = get_pvar(SPVAR_2, 20, 40, 30);
    c = get_pvar(PVAR_1, -30,400,100);
}
 
main {
 
}

​🔴 Syntax

get_pvar ( <pvar_constant>, <min_value>, <max_value>, default_value> );

​⚪ Parameters

<pvar_constant> : A global or private persistent variable constant <min_value> : The minimum permissible value <max_value> : The maximum permissible value <default_value> : The default value to return should the retrieved value be less then the min_value or greater than the max_value

​🔵 Returns

The stored value or the default value if the stored one is out of range

set_pvar

set_pvar stores the specified value into a persistent variable.

As GPC supports treating an int as a boolean value, the get_val command can be used to see if a controller entry simply has a value. For example:

int a, b , c;
 
init {
    a = get_pvar(SPVAR_1,  0, 10,  5);
    b = get_pvar(SPVAR_2, 20, 40, 30);
    c = get_pvar(PVAR_1, -30,400,100);
}
 
main {
 
    if(event_press(XB1_VIEW)){
        set_pvar(SPVAR_1, a);
        set_pvar(SPVAR_2, b);
        set_pvar(PVAR_1,  c);
    }
 
}

​🔴 Syntax

set_pvar ( <pvar_constant> , <value>);

​⚪ Parameters

<pvar_constant> : A global or private persistent variable constant. <value> : A value to be stored

​🔵 Returns

None