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

  WHOWOPEN()                                                 Window Function
 Purpose..: Define a window opening method
-------------------------------------------------------------------------------
 Syntax...: wHowOpen( <uWin>, <bOpen( [<nDelay>] )> ) --> NIL

 Arguments: <uWin>      = the string identifier of the window
                          OR the reference to the window structure
                          returned as an array by wNew() or wArray().
                          There is no default.

            <bOpen()>   = code block used as a opening method.
                          You can set the delay rate, the lower
                          the number the faster the opening.

            bOpen 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;        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 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 center;   delay n
            ---------------------------------------------------------

            [<nDelay>]  = cycle delay for opening the window.
                          A small number, say, 1 will open a
                          window fast whereas a high number,
                          say, 60 will result in a slower opening.
                          The default is to use no delay.

 Returns..: NIL

 Remark...: 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...: WHOW.PRG
-------------------------------------------------------------------------------
 Example..: . The example uses wHowOpen() to have the
              instance created by wNew() explode down when opening.

            wNew     ( "Intro1", 6, 4, 14, 70, "GR+/B" )
            wHowOpen ( "Intro1", B_EXPLODEDN( 30 ) )
            wHowClose( "Intro1", B_IMPLODEUP( 30 ) )
            wShadow  ( "Intro1", B_SHADOW( , S_HALF ) )

 Note.....: Window defaults for the opening and closing of windows
            can be overridden with the optional parameters of
            wOpen() and wClose().

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