Click above to get retro games delivered to your door ever month!

COLORMOD()

    COLORMOD() allows you (or the user) to view, modify, and optionally
    save all of the color settings.  You may also toggle between color
    and monochrome via this function.

    Syntax

    COLORMOD( [<file>] )

    Optional Parameter

    <file> is the filename (and path, if desired) to which to save
    color settings.  If this is not passed, the user will be allowed
    to enter a filename.  This filename will be the same as the file
    used by ColorInit() to load the colors.  If you did not load the
    colors, the filename will default to COLORS.GF.

    Return Value

    Absolutely nothing ("... say it again...")

    Notes

    COLORMOD() displays all the internal color settings on the screen.
    To modify a color setting, use the arrow keys to move to the desired
    setting and press Enter.  This will pop up the color palette and
    allow you to change the setting for that particular color. (Please
    refer to COLORPAL() if you need more specifics on the operation of
    the color palette).

    Press F10 to toggle between color and monochrome.

    Any changes made in COLORMOD() are maintained for the duration of the
    program.  You may also save color settings to a configuration file,
    which can then be read in by COLORSET() to re-establish color
    settings on a future run of your program.

    Note that if you pass a filename to COLORMOD(), and that file exists,
    you will NOT be asked for confirmation if you elect to save colors.
    The file will automatically be overwritten.

    Conditional Compilation

    If you do not intend to allow the user change colors with
    COLORMOD(), you can recompile COLORSET.PRG like so:

    clipper colorset /n /dCANNOT_MODIFY_COLORS

    Then either link in the resultant COLORSET.OBJ file, or put it into
    GRUMP.LIB with a library manager.

    Sample Usage

    COLORMOD( "c:\user\color.cfg" )