RESTORE COLOR

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Restore saved color schemes


Syntax

RESTORE COLOR FROM <memvar> | FILE <.col filename> | (<expC>)


See Also

@...FILL, @...GET, @...TO, ISCOLOR(), SAVE COLOR, SET COLOR, SETCOLOR()


Description

The RESTORE COLOR FROM command allows the current color scheme to be changed to a previously saved color scheme.

FROM <memvar>

The FROM <memvar> clause can be used to restore the color scheme from a memory variable that was saved with the SAVE COLOR TO <memvar> command.

FROM FILE <.col filename>

The FROM FILE <.col filename> clause can be used to restore the color scheme from a color file. This file must have been created with the SAVE COLOR TO FILE <.col filename> command. The file name can be substituted with an <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, '.col' is assumed.


Example

save color to m_old_color
set color
// Restore color scheme from a memory variable
restore color from m.m_old_color
// Restore color scheme from a color file
restore color from file payroll.col


Products

Recital