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

WOPEN()

Syntax:     WOPEN() (<expN1>,<expN2>,<expN3>,<expN4>[,<expL>])

Arguments:  <expN1> Corresponds to the first row.  The value must be
            between 0 and 24.
            <expN2> Corresponds to the outer left-hand column.  The value
            must be between 0 and 79.
            <expN3> Corresponds to the bottom row.  The value must be
            between 0 and 24.
            <expN4> Corresponds to the outer left-hand column.  The value
            must be between 0 and 79.
            <expL> Indicates whether the area of the screen selected for
            the new window opened will be erased(.T.) or not (.F.).
            Standard setting is (.F.) (do not erase).

Returns:    A numeric value.

Usage:      Opening a new window.

Note:       The window must lie within the area defined by WBOARD().
            If the window is opened with invalid coordinates, WOPEN() will
            return -1 and you will remain in the active window.  After a
            window is opened, all subsequent screen outputs will be in
            the selected window unless you have low level user-defined
            functions writing directly to video RAM.  This also applies to
            DOS and other programs if a run command is issued.  Line breaks
            occur if the output lines are longer than the width of the window
            (e.g., for a scoreboard output).

Library:    CT1.LIB


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

Examples:   WOPEN(5,10,20,70)

            *   This opens a window with it's top left-hand
            *   corner in row 5 of column 10 and the bottom
            *   right-hand in row 20 of column 70.  The return
            *   value will be 1 if window 1 is selected.

Warning:    WOPEN() will not, as you would expect, open the windows
            in numeric order.  Therefore, it is essential that the user
            stores the window number to a variable with WSELECT().

Examples:   window_no = WOPEN(5,10,20,70)
            WSELECT(0)

            ...

            WSELECT(window_no)