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

  WOPEN()                                                    Window Function
 Purpose..: Display a window on the screen
-------------------------------------------------------------------------------
 Syntax...: wOpen( [<uWin> [, <bHow>]] ) --> NIL

 Arguments: [<uWin>] = the string identifier of the window
                       OR the reference to the window structure
                       returned as an array by wNew() or wArray().
                       If not passed, the function will operate on
                       the window in focus.

            [<bHow>] = code block used as a opening method.
                       You can set the delay rate, the lower
                       the number the faster the opening.

            bHow Translate Directive as found in FW_BOX.CH
            ---------------------------------------------------------
            FW_BOX.CH         Description
            ---------------------------------------------------------
            B_EXPLODEDN( n )  Explode from the top down;      delay n
            B_EXPLODEUP( n )  Explode from the bottom up;     delay n
            B_EXPLODERT( n )  Explode from right to left;     delay n
            B_EXPLODELT( n )  Explode from left to right;     delay n
            B_EXPLODE( n )    Explode the window from center; delay n
            ---------------------------------------------------------
            B_IMPLODEDN( n )  Implode from the top down       delay n
            B_IMPLODEUP( n )  Implode from the bottom up      delay n
            B_IMPLODERT( n )  Implode from right to left      delay n
            B_IMPLODELT( n )  Implode from left to right      delay n
            B_VBLIND( n )     Use a vertical blind effect     delay n
            B_IMPLODE( n )    Implode the window to centre    delay n
            ---------------------------------------------------------

 Returns..: NIL

 Remark...: Opens the named window, saves the screen
            underneath the window and the screen color.

            If you used wZoom() and closed the window, another use
            of wOpen() will cause it to appear in the state it was
            when closed.

            The delay rate is not hardware-related. Rather it is a
            sliding scale to allow you to vary the delay in closing
            or opening. A rate of, say, 30, will be no faster
            on a '486 than it would be on a '286 machine.

 Source...: WOPEN.PRG
-------------------------------------------------------------------------------
 Example..: . The example opens a window already defined
              using an overriding method.

                  wOpen( "MyWin", B_EXPLODELT( 40 ) )

            .  wOpen is now compatible with dispbegin() and dispend().
               The window and gets will be flashed on the screen together
               after the dispend().

                 dispbegin()
                 wOpen( "getwin" )
                 wShoGets()
                 dispend()
                 READ MOUSE IN WINDOW


            As with all FreshWin window functions that alter the display,
            this function hides and redisplays automatically the mouse
            cursor if it is active.