;DOCOLOR
;---------------------------------------------------------------
;! specifies whether coloring is done
;# ADVERB PLOT
;-----------------------------------------------------------------------
;;  Copyright (C) 2002, 2020
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
DOCOLOR   LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
----------------------------------------------------------------
DOCOLOR
Type:     Adverb   (Scalar - generally logical)
Use:      Plot programs draw lines and symbols of different
          categories.  They are also able to draw "dark" as well as
          "bright" versions of these line/symbol categories.  The dark
          ones are normally drawn to provide contrast when the
          background grey-scale image is strong.  DOCOLOR is used to
          control whether these different categories are converted to
          colors, usually using the the PLCOLORS adverb.

          DOCOLOR is also used to instruct programs whether to convert
          an image with an RGB axis to a true-color image.  Such image
          may be build with MCUBE using PUTHEAD to create the RGB
          axis.  Tasks RGBMP, TVHUI, and LAYER also create such RGB
          cubes.
Tasks:
  GREYS.......Plots grey-scale with contours and special box and slice
              marks.  Can make 3 images into true color as well as
              using the RGB axis of a cube.
  KNTR........Plots grey-scale, contours, polarization vectors in one
              or more panels with a smooth contouring algorithm.
  LAYER.......Task to create an RGB image from multiple images.  DOCOLOR
              > 0 => PLCOLORS is used to color absolrption.
  LWPLA.......Convert a plot file to PostScript for saving and/or
              printing.  When DOCOLOR is > 0, the PLCOLORS adverb
              controls the coloring of the 4 bright and 4 dark line
              types plus the external characters and the overall
              background.
  PCNTR.......Plots grey-scale, contours, polarization vectors.
  PLOTR.......Basic task to generate a plot file from text input.
              DOCOLOR > 0 => a color input column is used to color the
              data samples.
Procedures:
  BASFIT......Fits antenna locations from SN-table data.  DOCOLOR
              controls how the plots are made.  > 0 -> do some
              overplotting with color separating IFs, polarizations,
              and antennas.
  DEFCOLOR....Sets adverb PLCOLORS to match a default XAS TV.
              DOCOLOR set to 1.
  OKCOLORS....Sets adverb PLCOLORS to use less ink (white background).
              DOCOLOR set to 1.
  TVCOLORS....Sets adverb PLCOLORS to match current TV usage.
              DOCOLOR set to 1.
----------------------------------------------------------------
