home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / pc_wread.zip / COLORS.DOC next >
Text File  |  1990-02-06  |  45KB  |  737 lines

  1.  
  2.      COLORS          
  3.         COLORS                 COLORS:
  4.            COLORS                                
  5.               COLORS                 A brief essay
  6.                  COLORS                 on
  7.                     COLORS                 the use of color
  8.                        COLORS                 in PC-Write screen displays . . .
  9.                           COLORS
  10.                              COLORS
  11.                                 COLORS
  12.                                    COLORS                 from --
  13.                                       COLORS
  14.                                          COLORS              High Boskage House
  15.                                             COLORS
  16.                                                COLORS           Software
  17.                                                   COLORS
  18.                                                      COLORS
  19.                                                         COLORS
  20.                                                            COLORS
  21.                                                               COLORS
  22.                                                                  COLORS
  23.  
  24.                      ABOUT SCREEN-DISPLAY OPTIONS IN PC-WRITE
  25.  
  26.    PC-Write is a very powerful tool.  Every tool represents a series of trade-
  27.    offs between power and simplicity, and PC-Write is no exception.  The price 
  28.    that must be paid for its power is an innate complexity--a need for the 
  29.    user to be able to understand and profitably harness all those powers. 
  30.    
  31.    While no powerful tool can be without complexity, the better ones are 
  32.    designed with that complexity systematized as well as can be, so as to make 
  33.    learning and using it no more difficult than it inherently must be.  Every 
  34.    cue and clue that can ease the way for the user is important.  Without a 
  35.    good set of such cues and clues, the most powerful of tools can be nearly 
  36.    valueless, for an inoperable tool is a useless tool, regardless of its 
  37.    capabilities; a tractor beats a mule, but not if you don't know how to drive.
  38.  
  39.    To move from the philosophically vague to the pragmatically specific, PC-
  40.    Write offers its user a substantial variety of ways to transform simple text 
  41.    into printed characters on a page.  Although some printers will be limited 
  42.    in their abilities to make use of all of PC-Write's capabilities, most newer 
  43.    ones can use most of the available options.  In full, PC-Write offers users 
  44.    some 20 different ways to output printed text; 18 of these are specifically 
  45.    defined (although redefinable), and another two are user-definable. 
  46.  
  47.    The full panoply of available effects, with their nominal definitions, is:
  48.  
  49.      ∙ Boldface (significantly darker than normal type)
  50.      ∙ Compressed type (pitch varies with printer, but usually circa 17 cpi)
  51.      ∙ Double-width type (halves pitch of prevailing type)
  52.      ∙ Elite (12 cpi, draft quality)
  53.      ∙ "Fast" (10 cpi, pica draft quality)
  54.      ∙ "Higher" (superscripts, as in algebraic equations)
  55.      ∙ Italics
  56.      ∙ "Lower" (subscripts, as in chemical formulae)
  57.      ∙ "Marine Blue"  (for printers that can do color printing)
  58.      ∙ Overstrike (everything overstruck, usually with /, for legal usages)
  59.      ∙ Pica, (10 cpi, "near-letter quality")
  60.      ∙ "Quality" (12 cpi, elite "near-letter quality")
  61.      ∙ Red (for printers that can do color printing)
  62.      ∙ Second-Strike (slightly darker than normal type)
  63.      ∙ Underlining (all characters, including spaces, underlined)
  64.      ∙ "Variable" (proportionally spaced type--each character a different width)
  65.      ∙ "W" [Double-U] (double underlining)
  66.      ∙ "X" [user #1] (available for user definition)
  67.      ∙ Yellow (for printers that can do color printing)
  68.      ∙ "Z" [user #2] (available for user definition)
  69.  
  70.  
  71.      Considering that even the nominally specified effects can be redefined by 
  72.      the user, that is quite an assortment of styles.
  73.  
  74.      Specifying these effects within a document is extraordinarily simple.  One 
  75.      need only press a two-key combination--the Alt key and an ordinary letter 
  76.      key--to toggle any one of these effects.  And, as long as they are not 
  77.      incompatible, any number of them can be made to be "on" simultaneously via 
  78.      "nested" commands (Red and italics are compatible, but subscripting and 
  79.      superscripting simultaneously is manifestly impossible).  The Quicksoft 
  80.      folks have even managed to make virtually all of the letter keys used  
  81.      reasonably mnemonic for their effects (as the previous Table showed). 
  82.  
  83.      So far, so good.  Now, however, comes the problem: keeping the user 
  84.      (that's you) clearly informed as to what text is "scheduled" to be printed 
  85.      in what form.  If all your "enhancements" (anything in the Table above) 
  86.      are invisible (to you) in your text, editing is almost as impossible as it 
  87.      would be if the text itself were invisible.  Manifestly, text affected by 
  88.      an enhancement must be displayed on the screen in a way different from 
  89.      "plain" or "normal" text.  Moreover, the user would ideally like to know a 
  90.      lot more than just "enhanced/not-enhanced" about her or his text, 
  91.      especially when there are nearly two dozen possibilities to consider. 
  92.  
  93.      In the best of worlds, monitors would show text exactly as it would appear 
  94.      on the printed page.   A few dedicated word-processing machines have come 
  95.      close to this ideal, but even the jazziest new video hardware cannot do 
  96.      the trick for PCs.  It is therefore necessary to use what amounts to a 
  97.      symbolic information system to give the user as much information as 
  98.      possible in a useful form--that is, without overwhelming him or her.
  99.  
  100.      Monochrome monitors offer a limited but useful set of symbols.  In 
  101.      addition to "normal" text, they can show text as underlined, boldfaced, 
  102.      boldfaced and underlined, or "reversed" (dark on light).  Clearly, it is 
  103.      essential to group all enhancements into no more than four categories, or 
  104.      "families," for monochrome displays. 
  105.  
  106.      Color obviously offers far more possibilities.  Although today's jazzy 
  107.      hardware has lots of potential, one is best advised to stick with the old 
  108.      CGA standard "palette" of colors.  A video card that offers "256 colors"  
  109.      is offering tints and hues that differ from one another in subtle degrees 
  110.      of more interest to an artist than a word processor seeking visual cues. 
  111.  
  112.      Judging just by the color tables, a CGA-standard color system offers 16 
  113.      foreground colors on 8 backgrounds, 128 different possible combinations. 
  114.      But this is a simplistic calculation, and its results useless. 
  115.  
  116.      First of all, any color on itself is invisible.  Second, the 16 foreground 
  117.      colors are really 8 colors in two groups: "normal" and "intense."  The 
  118.      differences can be seen, of course, but few users can readily detect them 
  119.      outside of a side-by-side, or "A-B" comparison mode.  Blue on red versus 
  120.      bright-blue on red is definitely not a wise way to distinguish different 
  121.      enhancements. 
  122.  
  123.      These obvious considerations alone reduce the useful palette to 56 
  124.      combinations (8 times 8, minus the 8 same-on-same pairs).  Beyond this is 
  125.      the fact that many nominally visible and distinguishable combinations are, 
  126.      in practice, nearly unreadable.  This latter point is, to some extent, a 
  127.      judgement call, and in any event a matter for trial-and-error on-screen 
  128.      examination, not color theory.  At all odds, the useful palette is smaller 
  129.      than 56 combinations.
  130.  
  131.      One might initially reason that with only "normal" and a maximum of 22 
  132.      enhancements to portray, the palette must surely suffice, even if a few 
  133.      pairings are impractical.  Well, yes and no.  Yes, in that there are 
  134.      assuredly well over 23 viable color combinations available.  No (or at 
  135.      least "Whoa, let's look at this"), in that merely making assignments that 
  136.      are unique but arbitrary is not a terribly good approach.  It is here, in 
  137.      the matter of "patterns," that things get tricky.
  138.  
  139.      Most users, given time, would probably learn to live with any arbitrary 
  140.      assignment of color combinations to enhancements; sheer repetition would 
  141.      drill it in, given enough time.  But the adjustment process would be slow, 
  142.      tedious, painful, and--rightly so--aggravating.  What is needed is for the 
  143.      assignments to follow some reasonable system, so that each of the 
  144.      enhancement/color-combination pairings is informative not only in itself 
  145.      (that is, by pure memorization) but as part of a logical system of cues 
  146.      and clues--so that even if not immediately specifically remembered its 
  147.      general significance can be grasped.  It is when we attempt to construct 
  148.      such logical groupings of color combination to signify specific 
  149.      enhancements that we find--even with a nearly two-to-one ratio of 
  150.      available color-pairs to enhancements--we are feeling the pinch. 
  151.  
  152.      This verbose document could easily be trebled in length by an attempt to 
  153.      outline how High Boskage House Software came to the color sets it uses; 
  154.      instead, we will present our results and merely (?!?) offer some after-
  155.      the-fact thoughts on that set.  Incidentally, we tried to extend the same 
  156.      principles to the mono displays, and will comment on that set as well.
  157.  
  158.      Note that there are Appendices that discuss the mechanics of coding the 
  159.      "attributes" (color combinations or mono displays) into PC-Write, and the 
  160.      derivation of the arbitrary-looking "attribute" codes (for the curious).
  161.  
  162.      The High Boskage House set of PC-Write enhancement displays is this.
  163.      (Each line is actually shown in YOUR current display of that mode.)
  164.      ∙ Pica, draft∙∙∙∙∙∙∙∙∙∙∙∙∙∙white on blue∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  165.      ∙ Pica, NLQ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙red on blue∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  166.      ∙ Elite, draft∙∙∙∙∙∙∙∙∙∙∙∙∙white on green∙∙∙∙∙∙∙∙∙∙∙∙reverse
  167.      ∙ Elite, NLQ∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙red on green∙∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  168.      ∙ Compressed∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙white on brown∙∙∙∙∙∙∙∙∙∙∙∙reverse
  169.      ∙ Double-width∙∙∙∙∙∙∙∙∙∙∙∙∙white on red∙∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  170.      ∙ Proportionally spaced∙∙∙∙white on cyan∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  171.      ∙ Boldface∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙red on black∙∙∙∙∙∙∙∙∙∙∙∙∙∙bright
  172.      ∙ Second-Strike∙∙∙∙∙∙∙∙∙∙∙∙yellow on black∙∙∙∙∙∙∙∙∙∙∙bright
  173.      ∙ Superscripts∙∙∙∙∙∙∙∙∙∙∙∙∙green on black∙∙∙∙∙∙∙∙∙∙∙∙bright
  174.      ∙ Subscripts∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙cyan on black∙∙∙∙∙∙∙∙∙∙∙∙∙bright
  175.      ∙ Overstrike∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙blue on black∙∙∙∙∙∙∙∙∙∙∙∙∙bright
  176.      ∙ Italics∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙green on grey∙∙∙∙∙∙∙∙∙∙∙∙∙underline
  177.      ∙ Underlining∙∙∙∙∙∙∙∙∙∙∙∙∙∙cyan on grey∙∙∙∙∙∙∙∙∙∙∙∙∙∙underline
  178.      ∙ Double underlining∙∙∙∙∙∙∙black on grey∙∙∙∙∙∙∙∙∙∙∙∙∙underline
  179.      ∙ "Blue"∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙blue on grey∙∙∙∙∙∙∙∙∙∙∙∙∙∙bright underline
  180.      ∙ "Red"∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙red on grey∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙bright underline
  181.      ∙ "Yellow"∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙yellow on grey∙∙∙∙∙∙∙∙∙∙∙∙bright underline
  182.      ∙ USER #1 (Alt-X)∙∙∙∙∙∙∙∙∙∙brown on black∙∙∙∙∙∙∙∙∙∙∙∙bright
  183.      ∙ USER #2 (Alt-Z)∙∙∙∙∙∙∙∙∙∙magenta on grey∙∙∙∙∙∙∙∙∙∙∙reverse
  184.  
  185.      Before we dilate on these, we need to consider another aspect of screen 
  186.      display as yet unmentioned: "areas." 
  187.  
  188.      We need more visual information than just the enhancements in effect on 
  189.      our text.  There are nonprinting formatting devices that we use in PC-
  190.      Write--things like Ruler Lines, Help screens, and Guide Lines (Help 
  191.      screens are not actually a "formatting device," but we do need to see them 
  192.      on screen too).  Moreover, our text itself has characteristics associated 
  193.      with its screen display but not--not necessarily anyway--its printout: 
  194.      whether it runs beyond the current left or right screen edge, where the 
  195.      actual text (including spaces) ends and blank screen begins, and so on and 
  196.      so forth.  
  197.  
  198.      For all of this (PC-Write defines 16 separate "areas" of screen display), 
  199.      we need distinctive visual cues and clues, and they need, urgently need, 
  200.      to fit into our overall pattern of display-characteristic assignments.
  201.  
  202.      It should be painfully clear that what is "obviously" a good system to one 
  203.      observer may be equally "obviously" terrible to another--there's no 
  204.      accounting for tastes, as the old lady who kissed the goat remarked.  But 
  205.      any system, to even be considered, must have some overall logic, even 
  206.      granted that tradeoffs are impossible to avoid.
  207.  
  208.      Listed next are the 16 PC-Write screen "areas" and what we color them as 
  209.      part of the pattern that includes the attribute display listed earlier.
  210.  
  211.        ∙ screen border∙∙∙∙∙∙∙∙∙∙∙∙black on black∙∙∙∙∙∙∙∙∙∙∙∙normal
  212.        ∙ "normal" text∙∙∙∙∙∙∙∙∙∙∙∙grey on black∙∙∙∙∙∙∙∙∙∙∙∙∙normal
  213.        ∙ lines below text end∙∙∙∙∙grey on black∙∙∙∙∙∙∙∙∙∙∙∙∙normal
  214.        ∙ area after text line∙∙∙∙∙white on black∙∙∙∙∙∙∙∙∙∙∙∙bright
  215.        ∙ beyond-screen marker∙∙∙∙∙grey on red∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  216.        ∙ marking/boxing text∙∙∙∙∙∙light magenta on black∙∙∙∙reverse
  217.        ∙ marked/boxed text∙∙∙∙∙∙∙∙magenta on black∙∙∙∙∙∙∙∙∙∙bright
  218.        ∙ rulers, outside margins∙∙light magenta on grey∙∙∙∙∙bright
  219.        ∙ rulers, within margins∙∙∙magenta on grey∙∙∙∙∙∙∙∙∙∙∙reverse
  220.        ∙ status line∙∙∙∙∙∙∙∙∙∙∙∙∙∙grey on magenta∙∙∙∙∙∙∙∙∙∙∙underline
  221.        ∙ top-area prompts∙∙∙∙∙∙∙∙∙white on magenta∙∙∙∙∙∙∙∙∙∙bright underline
  222.        ∙ menus∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙white on magenta∙∙∙∙∙∙∙∙∙∙bright
  223.        ∙ selected menu item∙∙∙∙∙∙∙magenta on grey∙∙∙∙∙∙∙∙∙∙∙reverse
  224.        ∙ help topic list∙∙∙∙∙∙∙∙∙∙white on red∙∙∙∙∙∙∙∙∙∙∙∙∙∙reverse
  225.        ∙ selected help topic∙∙∙∙∙∙red on grey∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙bright
  226.        ∙ help text∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙grey on blue∙∙∙∙∙∙∙∙∙∙∙∙∙∙normal
  227.      
  228.      If you're not sure to what some of these "area" descriptions refer, 
  229.      consult your PC-Write manual index under Screen, areas of.
  230.  
  231.      The first critical distinction we felt necessary was that between 
  232.      enhancements that change the pitch of the text and those that do not.  
  233.      There can, we feel, hardly be a more basic division: pitch changers affect 
  234.      the very fit of the words onto the page, and have to be carefully 
  235.      considered in formatting.  As you will see, all pitch-effect enhancements 
  236.      are reverse-video in mono, and something-on-color in color modes.  Non-
  237.      pitch enhancements in color are all on either black or grey backgrounds. 
  238.  
  239.      This set up our first major trade-off.  Everyone with a color monitor 
  240.      likes color; using plain black as the "normal" background may seem a bit 
  241.      boring to users who like vivid displays.  Several points affected our 
  242.      decision.  One, the display is to convey information, not impress your 
  243.      friends and neighbors with your wonderful new video card's abilities.  
  244.      Two, black is a useful background to more foreground colors than most or 
  245.      all of the other possible backgrounds.  Three, text on black may not 
  246.      produce as much candlepower as text on a jazzy colored background, but 
  247.      over the long haul is probably both more readable and easier on the eyes 
  248.      (which is why most serious text-only users still stick to mono monitors).  
  249.      Four, keeping the whole screen illuminated constantly will eventually wear 
  250.      out the screen phosphors more quickly than just illuminating letters (yes, 
  251.      monitor screens do eventually wear out, at least if you log 100 hours 
  252.      weekly on them, as we typically do).
  253.     
  254.      So, in our pattern, a colored background for text always signals that that 
  255.      text is going to (or, considering draft-versus-NLQ, is probably going to) 
  256.      affect the fit of that area on the page, and will require close scrutiny 
  257.      to ensure a properly formatted printout.  There are two notable apparent 
  258.      exceptions to this rule: magenta backgrounds and the help-topic displays, 
  259.      with their red and blue backgrounds.
  260.      
  261.      Magenta in our system has a key role--it signals "special" information: 
  262.      as a background, it is reserved for non-document "top-line" text, while 
  263.      when appearing, light or normal, on grey (or white) it signals non-
  264.      document lines (such as Rulers or Guide Lines) appearing in the area 
  265.      normally reserved for true text.  And "Marking" and "Marked," both 
  266.      transient states of true text, are conveyed by variations of magenta on 
  267.      black.  The reservation of magenta-on-grey for the Alt-Z code may seem 
  268.      like an exception to this rule, but we haven't yet discussed the "phantom 
  269.      lines": Guide Lines and Page-Break Lines.  While Alt-Z could be used as a 
  270.      real printer code, fracturing the rule, we will see why this is unlikely. 
  271.  
  272.      The use of red as a background for the Help topic-selection area, and of 
  273.      blue for Help text, is also not a true violation of the rule, because 
  274.      those areas simply take over the whole screen when they appear, and could 
  275.      not possibly be mistaken for document text or vice-versa.
  276.  
  277.      Just as a colored background distinctively cues a pitch-change, the lack 
  278.      of color in the background signifies fixed-pitch text.  And while the use 
  279.      of plain grey-on-black for "normal" text is easy on the eyes, it also 
  280.      makes it possible for the use of foreground color to distinctively signal 
  281.      a fixed-pitch text enhancement.  Since there are 13 such enhancements 
  282.      possible and only about half that number of colors, it is clearly 
  283.      impossible to signal all fixed-pitch enhancements by colors on black; by 
  284.      including colors on grey, we reach the requisite total without actually 
  285.      infringing the rule about colored backgrounds.
  286.  
  287.      Most of the fixed-pitch enhancements can be readily grouped into two 
  288.      "families," and these are especially clearly reflected in the mono-mode 
  289.      displays used: things that alter the appearance of the printed characters 
  290.      themselves, and things that emphasize those characters without actually 
  291.      altering them.  (The prototypical examples of these families are 
  292.      boldfacing and underlining.)  Italics, which might logically belong to the 
  293.      first group, are universally signified by underlining ordinary text--so in 
  294.      practice they naturally fall into the second group.  
  295.  
  296.      The first group was signified with--we hope--good logic by changing the 
  297.      color of the affected characters, just as the enhancement changes their 
  298.      printed appearance; for the second group, the grey background signifies an 
  299.      "external" augmentation (like underlining in print) of their effect.
  300.      
  301.      The only open questions were the "color" commands (Blue, Red, Yellow) and 
  302.      the undefined (but user-definable) enhancements.  Manifestly, an 
  303.      enhancement intimately associated with a color should have that color in 
  304.      its screen display; and since the "on-black" colors are all used for far 
  305.      more common enhancements, the color commands were included in the second 
  306.      group and display as their named colors on grey.  
  307.  
  308.      The Alt-X "undefined" enhancement was included in the "on-black" family 
  309.      rather by Hobson's choice, because--as we will see--the Alt-Z "user" 
  310.      enhancement is not really a viable "user" option, and its "on-grey" 
  311.      status is essentially mandated by other concerns (but, as you can read in 
  312.      your PC-Write manual, Alt-X isn't really much of an "option" either). 
  313.  
  314.      Within these three major groupings--pitch-changers, character modifiers, 
  315.      and character emphasizers--the assignment of specific colors to specific 
  316.      enhancements was made to some extent intuitively.  The factor most often 
  317.      in play was the "feel" of the color versus the effect (red should be 
  318.      something dramatic or important).  For instance, boldfacing cries out for 
  319.      red, given the black background, while double-wide is the "on-red" pitch 
  320.      modifier because it's the most "dangerous" one (it can easily run right 
  321.      off the printed page.)  And the criterion for a given foreground color in 
  322.      "bright" versus "normal" intensity was thoroughly empirical--visibility. 
  323.  
  324.      In the "area" displays, the key-cue color magenta is a bit restricting, 
  325.      but not as much so as it might seem.  Most of these displays are in little 
  326.      or no danger of being mistaken one for another, or for text, so some 
  327.      duplication of color combinations is tolerable.  As previously noted, for 
  328.      example, the Help facility completely takes over the whole screen, while a 
  329.      Ruler line is not likely to be mistaken for anything else at all. 
  330.  
  331.      Using magenta for "marking" and "marked" text, while a minor compromise, 
  332.      was acceptable to us because it is denoting a "special" kind of material: 
  333.      a transitory, unusual state.  And with the Marking/MARKED notices in the 
  334.      Status Line, we felt that "bright/normal" were workable distinctions. 
  335.      
  336.      The Ruler Lines are virtually the only other place where we allowed the 
  337.      difference between "normal" and "bright" to signify.  While we earlier 
  338.      remarked that such distinctions are not readily noticeable to a user, a 
  339.      Ruler Line is a clear exception: a true side-by-side, "A-B" situation.  
  340.      (We do actually also make the cursor white, not grey, when it's past the 
  341.      true end of a line, but that is a nicety, not a critical distinction.) 
  342.  
  343.      Note that our "area" assignments in mono/single-color are mostly the PC-
  344.      Write defaults (we took the Status line from bright to normal after 
  345.      noticing that it was literally burned into our amber--not green--screen). 
  346.  
  347.      Last, but not least, our scheme needs to deal with the "phantom lines": 
  348.      Guide Lines and Page-Break Lines.  Guide Lines always begin with an Alt-G
  349.      character in column 1 of the line--this is a PC-Write absolute requirement
  350.      (in versions 3.xx).  In the "hide" screen mode of PC-Write--which is what
  351.      PC-WREAD emulates--Guide Lines are totally invisible.  But while PC-WREAD 
  352.      needn't concern itself with them, you and we, as overall PC-Write users 
  353.      do.  The PC-Write default values for Guide-Line coloration are grey-on-
  354.      black for all monitor types.  We instead, working them into our pattern, 
  355.      have adopted magenta-on-grey; the non-black, non-color grey emphasizes 
  356.      their critical nature, while the magenta shows them as non-text items. 
  357.  
  358.      Page-Break lines do display, even in "hide" mode.  We have colored them 
  359.      magenta-on-grey in our scheme, for two reasons.  First, there is no real
  360.      chance of confusing them with a Ruler, a Guide Line, or any other special 
  361.      non-text line; second, this coordinates with coloring Alt-Z the same.  A 
  362.      Page Break may be "Hard" or "Soft."  Soft Breaks are marked by a Code-12 
  363.      character, Hard Breaks by a Code-12 followed by a Code-15.  But Code-15 is 
  364.      just the Alt-Z character!  So, if we want Page-Break lines to be colored 
  365.      the same no matter whether Hard or Soft, Alt-Z has to be colored in a 
  366.      nontext manner--the same way as Alt-T (the Code-12, not the character-
  367.      pair).  This is why "User 2" (Alt-Z) some ways back appears to be--but 
  368.      really is not--an infraction of the "magenta-for-nontext-only" rule. 
  369.  
  370.      Always keep clearly in mind the schizophrenic nature of Page-Break Lines:
  371.      the code-number characteristics discussed above control the appearance of 
  372.      such lines in the "show" mode; in "hide" mode, their appearance is
  373.      controlled by the "Area 10" attributes.  The hide-mode display has a life 
  374.      of its own; the previous paragraph refers to the "show" mode display.
  375.  
  376.      That's a few notes on the main thrust of our reasoning in designing the 
  377.      specific set of display attributes we associate in our customized PC-Write 
  378.      with the various enhancements and areas.  It is not exhaustive--we didn't 
  379.      go into the white-for-draft/red-for-NLQ mirroring in the Pica and Elite 
  380.      modes--but it covers the general outline of our thinking, and points out 
  381.      most of the complexities and trade-offs faced in creating such a set.
  382.  
  383.      If you are using just the default attributes of PC-Write--especially on a 
  384.      color display--we feel you are missing a lot of available help.  This is 
  385.      not a criticism of Quicksoft; they built a reasonable set of "quiet" 
  386.      defaults, presumably because "quiet" (muted-tone) displays offend no one.  
  387.      But they included tremendous customization power in PC-Write, and it is 
  388.      our own fault if we do not take full advantage of that power.  Notice how 
  389.      much more jazzy the main documentation file (what you saw with SEEDOC) is 
  390.      than this file; that's what you can accomplish by customization.
  391.  
  392.      If you like the idea of a spectrum of screen effects for the PC-Write 
  393.      spectrum of enhancements and information but don't like our specific 
  394.      choices, design your own.  We like these, and built them into the PC-WREAD 
  395.      documentation reader so you could see them in action for yourself; but the 
  396.      actual PC-WREAD program uses--in the shareware demonstration version--only 
  397.      the original PC-Write default values.  It's what you're reading this with.
  398.  
  399.      The full-license distribution version will read your PR.DEF and ED.DEF
  400.      files, and display accordingly.  But whether or not you ultimately 
  401.      register PC-WREAD, we recommend your customizing those .DEF files, either 
  402.      with our pattern or with one of your own designing.
  403.  
  404.      This discussion has been dual-purpose: to show you the underlying logic of 
  405.      our choices, and to thereby equip you with a better sense of the problems 
  406.      to be met and trade-offs to be made in evolving such a system should you 
  407.      undertake the task yourself.
  408.  
  409.      In the Appendices that follow, we will first show you how to implement PC-
  410.      Write customization, then explain a bit about how the screen displays are 
  411.      coded inside your computer.  Your PC-Write manual remains your primary 
  412.      information source--it is an outstanding example of what program 
  413.      documentation should be (but so rarely is)--but you may find the 
  414.      elaborated instructions here easier to use for this specific task. 
  415.  
  416.      Also, if you are trying to follow all this out with your PC-Write manual 
  417.      in hand, literally or figuratively, you should be aware of a few critical 
  418.      typographical errors therein concerning these topics.  These errors 
  419.      appear in the full PC-Write User's Guide manual, Version 3.0, dated 
  420.      September 1988, and are not picked up in the October 1988 Addenda.
  421.      
  422.      On page 335 of the manual, there is a Table of enhancements, showing the 
  423.      corresponding font letter and character code for the 20 normal PR.DEF 
  424.      font variations.  The middle column shows incorrect code values.  There 
  425.      is a correct, and more complete, Table on page 339.
  426.  
  427.      On page 354 of the manual, the monochrome default attribute for Area 10, 
  428.      "normal" Ruler-line text, is shown as 9 (underline); it is actually 
  429.      implemented as 15 (bright), which makes much more sense anyway.
  430.  
  431.      In conclusion, if we may be excused our self-interest, once again--
  432.  
  433.             ╔═════════════════════════════════════════════════════╗
  434.             ║   DON'T FORGET TO REGISTER YOUR COPY OF PC-WREAD!   ║
  435.             ╟─────────────────────────────────────────────────────╢
  436.             ║   It's the honorable thing to do, and it's cheap!   ║
  437.             ╚═════════════════════════════════════════════════════╝
  438.  
  439.  
  440.               
  441.                     ╔═════════════════════════════════════╗
  442.                     ║             APPENDIX 1:             ║
  443.                     ╟─────────────────────────────────────╢
  444.                     ║    Implementing The Color Scheme    ║
  445.                     ╚═════════════════════════════════════╝
  446.  
  447.  
  448.      
  449.      Let us assume, for the sake of discussion, that you have elected to 
  450.      implement the display formats discussed above exactly as shown there.  (If 
  451.      you want to implement different changes, the same methods will apply, but 
  452.      the actual numbers to enter will be different; nevertheless, the 
  453.      information here should be very useful to you.) 
  454.       
  455.      To implement the font-effect (Alt-plus-letter) characteristics, you need 
  456.      to edit your Printer Definition file, PR.DEF; to implement the "area" 
  457.      characteristics, you need to edit your Edit Control file, ED.DEF.
  458.  
  459.      In both cases, you edit these files with PC-Write, just like any file.
  460.  
  461.  
  462.  
  463.                            ╔══════════════════════╗
  464.                            ║ ┌──────────────────┐ ║
  465.                            ║ │ ╔══════════════╗ │ ║
  466.                            ║ │ ║  WARNING!!!  ║ │ ║
  467.                            ║ │ ╚══════════════╝ │ ║
  468.                            ║ └──────────────────┘ ║
  469.                            ╚══════════════════════╝
  470.  
  471.  
  472.  
  473.        NEVER EDIT ANY CRITICAL FILE WITHOUT MAKING A BACKUP COPY FIRST!!
  474.  
  475.  
  476.  
  477.      If, like most PC-Write users, your primary control files are indeed named 
  478.      ED.DEF and PR.DEF, we suggest backup copies named EDDEF.OLD and PRDEF.OLD; 
  479.      but the exact names you use aren't as important as the fact that you have 
  480.      backups, clearly labelled and readily identified.  Be sure to make such 
  481.      copies before modifying your files; that way, if you do make a mistake, 
  482.      you haven't done critical damage.
  483.  
  484.      Let's start with PR.DEF.  While there may be many curious lines in the 
  485.      file, you will always find a block where each line begins with a # sign 
  486.      followed immediately by a letter of the alphabet.  These are the font 
  487.      lines, and it is them that you need to edit.  We will be inserting three 
  488.      new lines, but in most cases, the form of the change (and we will show 
  489.      you the exact specifics too) will be to take a line that starts this way: 
  490.  
  491.      #B=02 ∙∙∙∙∙∙∙∙∙∙∙∙
  492.  
  493.      and change it, by inserting three codes, to one that starts like this:
  494.  
  495.      #B:15.15.12=02 ∙∙∙∙∙∙∙∙∙∙∙∙
  496.  
  497.      Please note that the actual PR.DEF lines are not in boldface!  That's just 
  498.      a device we use in this document to highlight what we're talking about.  
  499.      Also please note that the string of dots is not literally what you'll find 
  500.      there; they just stand for some text not relevant to what we're doing now. 
  501.  
  502.      When you inspect this area of your PR.DEF file, you will see that the 
  503.      fonts (the #B shown above is Boldface, the Alt-B font) are alphabetical 
  504.      but that six--A,G,J,K,N and T--are "missing."  Don't worry about them; 
  505.      most we'll leave alone, while for two (G and T) we'll insert new lines.
  506.  
  507. #B:15.15.12=02 ∙∙∙∙∙∙∙∙∙
  508. #C:112.112.111=06 ∙∙∙∙∙∙∙∙         ╔════════════════════════════════════╗
  509. #D:112.112.79=16 ∙∙∙∙∙∙∙∙          ║  This is the relevant portion of a ║
  510. #E:112.112.47=03 ∙∙∙∙∙∙∙∙          ║  PR.DEF file customized to display ║
  511. #F:112.112.31=28 ∙∙∙∙∙∙∙∙          ║  the exact color scheme described. ║
  512. #G:112.112.125=11                  ╚════════════════════════════════════╝
  513. #H:15.15.10=24 ∙∙∙∙∙∙∙∙
  514. #I:1.15.122=21 ∙∙∙∙∙∙∙∙             ┌──────────────────────────────────┐
  515. #L:15.15.11=25 ∙∙∙∙∙∙∙∙             │  CRITICAL NOTE: If you do add a  │
  516. #M:9.15.113=07 ∙∙∙∙∙∙∙∙             │  new #T line, as was done here,  │
  517. #O:15.15.9=19 ∙∙∙∙∙∙∙∙              │  you MUST also add the numbered  │
  518. #P:112.112.18=05 ∙∙∙∙∙∙∙∙           │  line (276:708,015) shown, just  │
  519. #Q:112.112.44=22 ∙∙∙∙∙∙∙∙           │  AFTER the #-letter list.  This  │
  520. #R:9.15.116=30 ∙∙∙∙∙∙∙∙             │  retains Alt-T as a Hard Break.  │
  521. #S:15.15.14=01 ∙∙∙∙∙∙∙∙             └──────────────────────────────────┘
  522. #T:112.112.117=12
  523. #U:1.15.123=23 ∙∙∙∙∙∙∙∙               Comments:
  524. #V:112.112.63=04 ∙∙∙∙∙∙∙∙∙
  525. #W:1.15.112=18 ∙∙∙∙∙∙∙∙∙               1.  The #G, #T, and 276: lines are new.
  526. #X:15.15.6=13
  527. #Y:9.15.126=31 ∙∙∙∙∙∙∙∙∙               2.  Do NOT add or change any text after
  528. #Z:112.112.117=15                          the =xx entry of each line.
  529. 276:708,015
  530.  
  531.         If you insert a definition line for #T in PR.DEF, you MUST add a
  532.         third line in PR.DEF if you want Alt-T to work properly!  That line is:
  533.            276=708,015       (Enter it flush left right AFTER the # lines.
  534.  
  535.      Again: all that is involved with each of the 20 changed lines is to 
  536.      insert between the letter and the = sign a set of three numbers preceded 
  537.      by a : and separated by periods.  From #B= we go to #B:15.15.12= and 
  538.      that's all you have to do; leave the rest of each line unchanged.  And 
  539.      the three new PR.DEF lines need only be inserted exactly as shown above. 
  540.      
  541.      Just so you know what you're doing and why (our old habit): 
  542.  
  543.        ∙ The colon : tells PC-Write that the character's effect on affected 
  544.          text has been customized and that the custom values follow.
  545.  
  546.        ∙ The three numbers are the "attributes" (discussed more in Appendix 2
  547.          of this file) that specify the associated screen-enhancement values
  548.          for, respectively: monochrome monitors, so-called "single-color" 
  549.          monitors, and color monitors.
  550.  
  551.        ∙ The two periods . just tell PC-Write where one attribute ends and 
  552.          another begins.
  553.  
  554.      In the ED.DEF file, we will not be changing any existing lines.  Instead, 
  555.      we will simply insert some brand-new lines, which will redefine the 
  556.      appearance of the "areas" discussed above, in the ways discussed above.  
  557.      You can put these lines anywhere in ED.DEF, but try to place them at a 
  558.      logical-looking point; it's nice to be tidy. 
  559.  
  560.      These are the 14 needed new ED.DEF lines:
  561.      &1:7.7.7
  562.      &2:15.15.15
  563.      &3:112.112.71               NOTE:
  564.      &5:15.15.5 
  565.      &6:112.112.13               Enter all these lines FLUSH LEFT!
  566.      &7:7.7.23
  567.      &8:1.15.87                  DO NOT indent any of them.
  568.      &9:9.15.95
  569.      &10:15.15.117
  570.      &11:112.112.125
  571.      &12:112.112.79
  572.      &13:15.15.124
  573.      &14:15.15.95
  574.      &15:112.112.125
  575.  
  576.      As always, let's tell you what you're doing here.
  577.  
  578.      The ampersand & tells PC-Write that this line is a redefinition command.
  579.      The number right after that defines the specific screen "area" to be dealt 
  580.      with by this line (see your PC-Write manual for the specific meanings that 
  581.      correspond to each number).  The colon : marks the start of the attribute 
  582.      list to be used.  The periods . separate the attribute codes.  And, as in 
  583.      the PR.DEF codings, the three numbers are, in turn, the attributes to be 
  584.      used with monochrome monitors, "single-color" monitors, and color 
  585.      monitors.
  586.  
  587.      We have left areas 0 and 4 in entirely their default states by simply not 
  588.      redefining them.  The codes we use in our redefinitions for single-color 
  589.      monitors are all the same as the default codes.  The mono codes are all 
  590.      the same as the default codes except for the normal Status Line display, 
  591.      which is now ordinary underline rather than bright underline; that line, 
  592.      in a nearly unchanging form, is always on the screen when you work in PC-
  593.      Write, and if you do as much of that as we do (unlikely, we grant), you 
  594.      really can burn it into the screen, even on a modern amber monitor.
  595.  
  596.      Remember that--as mentioned before--the "Area 10" (Ruler Lines outside
  597.      the margins) attribute also controls "hide" mode Page-Break-Line display.
  598.  
  599.  
  600.               
  601.                     ╔═════════════════════════════════════╗
  602.                     ║             APPENDIX 2:             ║
  603.                     ╟─────────────────────────────────────╢
  604.                     ║   Display-Character "Attributes"    ║
  605.                     ╚═════════════════════════════════════╝
  606.  
  607.  
  608.      Note 1: This discussion pertains only to text-mode displays.  The display
  609.              of text in any graphics mode is a decidedly more complex process.
  610.  
  611.      Note 2: You DO NOT need to know this stuff!  It's here for the curious.
  612.  
  613.  
  614.      Your display monitor screen shows text at up to 80 characters a line, and 
  615.      up to 25 lines a screen.  The total number of text-character positions on 
  616.      your screen is thus simply 80 x 25, or 2000.  Glossing over a lot of 
  617.      complications, exceptions, and differences between various specific pieces 
  618.      of video hardware, we may say that somewhere in your computer there is a 
  619.      bank of memory with 2000 bytes each of which corresponds to a specific 
  620.      character spot on your monitor screen.  The byte in a given memory cell is 
  621.      the character that will be displayed at the corresponding screen location.
  622.  
  623.      All possible bytes--all the values from 0 to 255--will display on the 
  624.      screen if you can get them into video memory (actually two, the zero byte 
  625.      and the "space" byte, will show as blanks on the screen, but that's their 
  626.      "display").  Bytes with codes under 32 cannot always be put into video 
  627.      memory--it depends on the specific software that you ask to do the 
  628.      putting.  BASIC, for example, treats 11 of those 32 low-order codes as 
  629.      instructions to do something (such as beep the speaker) rather than as 
  630.      characters to display.  But your video hardware will show them all if you 
  631.      can get them into that video memory.
  632.  
  633.       If the terms "value" and "code" as used here are not clear to you,
  634.       refer to the Appendix in the main PC-WREAD documentation file via SEEDOC.
  635.  
  636.      But, as you should be well aware by now, what to display is only half of 
  637.      the matter; how to display that "what" is the other half.
  638.  
  639.      Sure enough, video memory has another 2000 memory bytes, each uniquely 
  640.      associated with one of the first 2000, and thus also uniquely associated 
  641.      with a specific character position on your screen.  It is in this second 
  642.      bank of memory that we store the "attribute"--or display instructions--for 
  643.      each character position of the screen.
  644.  
  645.      A byte comprises eight bits.  Each of the bits in an attribute byte 
  646.      controls some specific aspect of the display your screen will show at the 
  647.      associated location.  Here is how an attribute byte breaks down:
  648.  
  649.            128      64      32      16  ║   8       4       2       1
  650.         ╔═══════╤═══════╤═══════╤═══════╬═══════╤═══════╤═══════╤═══════╗
  651.         ║ blink │ Red   │ Green │ Blue  ║ bright│ Red   │ Green │ Blue  ║
  652.         ╚═══════╧═══════╧═══════╧═══════╬═══════╧═══════╧═══════╧═══════╝
  653.             8       4       2       1   ║   8       4       2       1
  654.              Background control bits    ║    Foreground control bits 
  655.  
  656.      
  657.      Let's demystify this picture a bit.  First, the numbers: every bit in a 
  658.      byte is a digit in a binary--base 2--number (the word bit is derived from 
  659.      "binary digit"), and is thus a power of 2 (just like every place in a 
  660.      familiar decimal--base 10--number is a power of ten).  The numbers across 
  661.      the top are the values of every place in the byte expressed in "normal" 
  662.      decimal representation.  As you see, the byte divides into two areas of 
  663.      control; since in some situations (such as the BASIC programming 
  664.      language's COLOR statement) we think of these separately, we have also 
  665.      shown bit coding for each half as if it were a distinct entity (which it 
  666.      is not; we just sometimes think of it that way).
  667.  
  668.      Next, the color names: color monitors, like color TV sets, use three 
  669.      separate color-presentation tools (we'll skip the electronics involved), 
  670.      one each in the three so-called "primary colors" of Red, Green, and Blue, 
  671.      to produce the full spectrum of visible colors.  On a TV, the relative 
  672.      intensities of each primary can be varied in almost infinitesimal 
  673.      increments; on a PC monitor, at least one compatible with the old CGA 
  674.      cards, the primary colors have only two or three possible values: on, off, 
  675.      and--sometimes--high-intensity on.  There are three bits in the 
  676.      "background" area and another three in the "foreground" area which control 
  677.      the primary-color display for the byte's screen position; if a given bit 
  678.      is 1, that primary in that area is on, and if it's 0, that primary in that 
  679.      area is off--very simple.
  680.  
  681.      In the foreground area, there is a fourth bit called the "intensity bit, 
  682.      or the "brightness" bit.  If it is on, each foreground primary is on--if 
  683.      at all--at a "bright" level; otherwise each is on--if at all--at a 
  684.      "moderate" level of intensity.  Finally, there is the so-called "blink 
  685.      bit"; this, just as you think, enables blinking at the associated screen 
  686.      spot.  (But, although this bit is in the "background" area of the byte, 
  687.      only the foreground blinks!)  On many monitors, appropriate software can 
  688.      change the function of the "blink bit" to that of an intensity bit for 
  689.      the background; but, since not every monitor can do this, our display 
  690.      scheme made no attempt to utilize this feature. 
  691.  
  692.      By using the three primary colors one at a time, we rather obviously get 
  693.      only three different colors: red, green, and blue.  But we can mix the 
  694.      primaries to get secondary colors.  With both Green and Blue turned on, we 
  695.      get the curious result quaintly referred to as "Cyan" in computerspeak; by 
  696.      mixing Red and Green, we get a sort of Brown; Red and Blue give us a 
  697.      passable Magenta; and with all three primaries on, we get--as Isaac Newton 
  698.      discovered long ago--white (actually, a sort of grey). 
  699.  
  700.      These seven combinations, plus Black (the absence of any color) are the 
  701.      full set of background colors normally available.  In the foreground, we 
  702.      have these same eight, plus a set of intensified shades of much the same 
  703.      description (the intensified Brown becomes Yellow, but the others don't 
  704.      change that much in character).  Curiously, the brighter "intensified" 
  705.      versions of these colors all look to the human eye as paler and more 
  706.      washed-out than their plain versions.
  707.  
  708.      By now, you have probably deduced from whence comes the unique "attribute" 
  709.      number associated with a specific color pattern in PC-Write's PR.DEF and 
  710.      ED.DEF customization entries: it is just the numeric value of the screen-
  711.      attribute control byte that produces the desired effect.
  712.  
  713.      The easiest way to see this is with an example.
  714.      
  715.      Assume that we want to have a given character display as Blue on a Brown 
  716.      background.  The bits we need to turn on are Blue in the foreground area 
  717.      and Red and Green in the background area.  The bit values of these three 
  718.      bits are, respectively, 1, 64, and 32 (check the byte shown earlier).  
  719.      When we add those up, we get 97, which is the correct attribute number to 
  720.      specify to PC-Write "Blue on a Brown background." 
  721.  
  722.      Monochrome specifications work a little differently, because mono has so 
  723.      few (five) possible states.  The "blink" and "intensity" bits control the 
  724.      same features--blinking and intensified-foreground.  What would be a Blue 
  725.      foreground in color--just the "blue" bit on--enables underlining; if any 
  726.      other foreground bits are also on, underlining is disabled and the 
  727.      display is "normal" text (or "bright" if the intensity bit is on).  The 
  728.      background is always black unless all three background bits are on and no 
  729.      foreground bits are on; this produces black on white (or whatever color 
  730.      your monochrome monitor displays, probably amber), or "reverse video."  
  731.      You cannot underline in reverse, since all foreground bits must be off. 
  732.      
  733.      As we said, you do not need to know all this stuff.  You can get all the
  734.      attribute codes from the table in the PC-Write manual.  It's just our old
  735.      instinct to provide knowledge along with the step-by-steps.
  736.         ─────────────────────THAT'S ALL, FOLKS!───────────────────────────
  737.