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

COLORWIN()

Syntax:     COLORWIN([<expN1>][,<expN2>]
                   [,<expN3>][,<expN4>][,<attr1>][,<attr2>])

Arguments:  <expN1> denotes the first line to be processed from (default:
            cursor line).
            <expN2> denotes the first column to be processed (default:
            cursor column).
            <expN3> denotes the last line to be processed (default: last
            screen or window line).
            <expN4> denotes the last column to be processed (default:
            right-hand edge of screen or window).
            <attr1> is the attribute with which to overwrite (default:
            standard attribute CLEARA).
            <attr2> denotes the attribute to be overwritten  (default:
            change all attributes).

Returns:    A character string.
            A null string is returned.

Usage:      With COLORWIN() it is possible to replace all <attr2>
            attributes which appear in a particular area of screen or
            window with <attr1> attribute.  This function operates similarly
            to COLORREPL(), but in this case it is possible to specify
            the area of the screen to be processed.

            The arguments <expN1> and <expN2> specify the line and
            column of the top left-hand corner; <expN3> and <expN4>
            specify the line and column of the bottom right-hand corner .

Notes:      In the absence of <attr2> all attributes are replaced; in the
            absence of <attr1> CLEARA is assumed.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * Replace attribute 7 (white on black) for 0
            * (black on black = invisible) from the actual
            * cursor position to the end of the screen.
            COLORWIN(0,7)

            * Replace all attributes in the area line 23,
            * column 15 to line 24,column 70 using the
            * standard attribute CLEARA.
            COLORWIN(23,15,24,70)

            * Replace all attributes for the attribute 120
            * (red on white) in the area of line 23,
            * column 15 to line 24, column 70.
            COLORWIN(23,15,24,70,120)

            * Change the display white on black into black
            * on white.  The  arguments may be specified
            * differently.
            COLORWIN(23,15,24,70,"0/7","7/0",)
            COLORWIN(112,7)

            * Mixed forms are also possible.
            COLORWIN(23,15,24,70,"0/7",7)