home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / s / super25n.zip / COLORS.DOC < prev    next >
Text File  |  1993-01-05  |  3KB  |  90 lines
  1.  
  2.                     ┌───────────────────────────────┐
  3.                     │         SuperLib 2.50         │
  4.                     │    For Clipper S87 and 5.01   │
  5.                     │    -------------------------  │
  6.                     │       copyright 1990          │
  7.                     │      Garry A Prefontaine      │
  8.                     └───────────────────────────────┘
  9.  
  10.                               Color Usage
  11.                               -----------
  12.  
  13. This is not the perfect color scheme. It is the one this library runs
  14. on.
  15.  
  16. Several global color variables are used by the functions. These are:
  17.  
  18.           c_normcol       -       For normal input/output
  19.           c_normmenu      -       For normal 'menu to' operations
  20.           c_popcol        -       For popup box colors
  21.           c_popmenu       -       For popup box menus
  22.           c_frame         -       Frame string ("┌─┐│┘─└│ ")
  23.           c_shadatt       -       Shadow color attribute (numeric)
  24.           c_shadpos       -       Shadow position (0,1,3,7,9)
  25.           c_xplode        -       Logical - explode windows?
  26.  
  27. All are of the format "f/b,f/b,,,f/b"  (f-foreground b-background)
  28.  
  29. The function INITSUP() initializes these variables, and sets them
  30. to their default settings. If COLORS.MEM is present, INITSUP()
  31. will use the values for these variables contained within it.
  32.  
  33. The defaults for a color monitor are:
  34.  
  35.     c_normcol      =  'W/B,GR+/R,,,W/N'
  36.     c_normmenu     =  'W/B,N/R,,,W/N'
  37.     c_popcol       =  'N/BG,N/W,,,BG+/N'
  38.     c_popmenu      =  'N/BG,W+/N,,,BG+/N'
  39.     c_frame        = "┌─┐│┘─└│ "
  40.     c_shadatt      = 7
  41.     c_shadpos      = 1
  42.     c_xplode       = .T.
  43.  
  44. If a color monitor is not detected, a default set of monochrome
  45. colors is used. You may override this by initializing a global
  46. variable called _SUPISCOLOR of type logical. If INITSUP() sees
  47. this variable, it will use the value in _SUPISCOLOR instead of
  48. the value returned by ISCOLOR(). This is helpful in instances
  49. where ISCOLOR() sees a color card with a monochrome monitor, or
  50. some such combination. _SUPISCOLOR must be assigned before the
  51. first call to INITSUP().
  52.  
  53. The defaults for a mono monitor are:
  54.  
  55.     c_normcol      =  'W/N,N/W,,,+W/N'
  56.     c_normmenu     =  'W/N,N/W,,,+W/N'
  57.     c_popcol       =  'N/W,+W/N,,,W/N'
  58.     c_popmenu      =  'N/W,W/N,,,+W/N'
  59.     c_frame        = "┌─┐│┘─└│ "
  60.     c_shadatt      = 8
  61.     c_shadpos      = 1
  62.     c_xplode       = .T.
  63.  
  64.  
  65. The function SETCOLORS() allows interactive setting of these colors.
  66. The variables are stored in COLORS.MEM.
  67. Note: See INITSUP() for discussion of using alternate file and/or path
  68. for COLORS.MEM.
  69.  
  70. Many of the functions require a numeric color parameter. The file
  71. COLORS.EXE and the Norton Guide Datafile contain conversion charts
  72. for color string to color integer.
  73.  
  74. The functions STANDARD(), ENHANCED() & UNSELECTED() return the
  75. numeric equivalents for the current SETCOLOR() setting.
  76.  
  77. These refer to the three active parts of a color string:
  78.  
  79. For example, in the following color string:
  80.  
  81.   W/N,W/R,,,+GR/N
  82.  
  83.   standard   = W/N    , numeric equivalent = 7
  84.   enhanced   = W/R    , numeric equivalent = 71
  85.   unselected = +GR/N  , numeric equivalent = 14
  86.  
  87.  
  88. COLORS.EXE will display a grid showing you color string to number
  89. conversions.
  90.