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

 NEWCOLOR() 

          Changing colors on entire areas of the screen, regardless of the
          current screen contents, can now be managed very effectively and
          efficiently with NEWCOLOR.

          The NEWCOLOR function provides the programmer with the ability to
          change colors on the screen without having to reset the color and
          rewrite the screen information.  This is particularly useful in
          those occasions when a highlighting of information is necessary
          which would normally be prohibitive due to slow screen update
          characteristics.  Self programmed light bar menus and highlighting
          screen selections becomes much easier with this function employed.


      Format: 

               newcolor(top, left, bottom, right, attr [,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, 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                          *

             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.   This will change the character attributes from row #10,
                    column #20 through row #12, column #60 to intense
                    blinking red (*+r) on a black background (n).

                    .
                    .
                    .
                    newcolor(10,20,12,60,'*+r/n)
                    .
                    .
                    .
               2.   This will change the character attributes from row #05,
                    column #10 through row #05, column #15 to inverse white
                    (w) with black characters (n).

                    .
                    .
                    .
                    newcolor(5,10,5,15,'n/w')
                    .
                    .
                    .


      Returns: 

               Nothing.


      Cautions: 

               None.