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

 BOXCOLOR() 

          Changing the color attributes within a given area can be
          accomplished with NEWCOLOR, but BOXCOLOR will only change the color
          attribute of the border of the area.  With an optional parameter
          you can instruct the function to change the color of the first
          column and last column inside the area thereby showing a more
          appealing BOX.  Changing the background color with BOXCOLOR you can
          create your own "boxes" or even exploding and imploding emulation.


      Format: 

               boxcolor(top,left,bottom,right,attr[,double][,type])


      Parameters: 

               top.......Numeric variable or constant indicating the top row
                         of the area to be changed.  Value checked to be
                         between 0 and 24 inclusive.

               left......Numeric variable or constant indicating the left
                         column of the area to be changed.  Value checked to
                         be between 0 and 79 inclusive.

               bottom....Numeric variable or constant indicating the ending
                         row of the area to be changed.  Value checked to be
                         greater than TOP but less than or equal to 24.

               right.....Numeric variable or constant indicating the right
                         column of the area to be changed.  Value checked to
                         be greater than LEFT but less than or equal to 79.

               attr......Character string variable or constant, non case
                         sensitive, which contains a valid color command or
                         combination for character and background.  Must be
                         the alpha representation of the color, the numeric
                         will be rejected.

                                  (valid colors)
                          black                          N
                          blue                           B
                          green                          G
                          cyan                           BG
                          red                            R
                          magenta                        RB
                          brown                          GR
                          white                          W
                          intense                        +
                          blink                          *

               double... OPTIONAL Character string variable or constant,
                         non case sensitive, which instructs the function to
                         change the attribute of the first and last columns
                         within the area specified.  As columns are "slimmer"
                         than rows, changing these columns as well causes a
                         more appealing border.

                         'd'            This is the only valid parameter.
                                        Any other letter will be rejected as
                                        a bad parameter.

              type... OPTIONAL. Logical variable or constant instructing
                         the function to use DMA updating or not.

                         .T.            DEFAULT.  If not specified, the
                                        function will use DMA screen
                                        updating.

                         .F.            Setting this flag to a logical false
                                        will cause the function to use the
                                        standard BIOS INT 10H for screen
                                        updating.


      Examples: 

               1.   Change the color of the border of an area.

                    .
                    .
                    .
                    boxcolor(05,05,10,10,'n/w')
                    .
                    .
                    .


               1.   Change the color of the border of the same area, but use
                    double wide columns.

                    .
                    .
                    .
                    boxcolor(05,05,10,10,'n/w','d')
                    .
                    .
                    .


      Returns: 

               Nothing.


      Cautions: 

               None.