home *** CD-ROM | disk | FTP | other *** search
/ DTP en Graphics 1 / dtpgraf1.zip / dtpgraf1 / DTP / PICTHIS4 / 34DIFF.TXT next >
Text File  |  1991-12-31  |  39KB  |  742 lines

  1.          PICTURETHIS(TM) "SHAREWARE" VERSION
  2.  
  3.          RELEASE 4.00
  4.  
  5.          DECEMBER 31, 1991
  6.  
  7.          DIFFERENCES BETWEEN RELEASES 3.00 and 4.00
  8.  
  9.  
  10.          Copyright 1988, 1989, 1990, 1991 by Patricia Y. Williams and 
  11.            Gregory Williams, All Rights Reserved.
  12.  
  13.          HortIdeas Publishing, 460 Black Lick Road, Gravel Switch, KY 
  14.            40328 U.S.A.
  15.  
  16.          Trademarks/Owners: CaptureThis and PictureThis/Patricia Y. 
  17.            Williams and Gregory Williams; IBM and PC-DOS, 
  18.            International Business Machines Corp.; Hercules/Hercules 
  19.            Computer Technology, Inc.; MS-DOS, Microsoft Corp.; 
  20.            PostScript/Adobe Systems Inc.; typeface names/their 
  21.            respective owners
  22.  
  23.          NOTE: Carefully read all of the terms and conditions of the 
  24.            License Agreement (near the beginning of the READTHIS.1ST 
  25.            file on distribution disk #1) PRIOR to using the 
  26.            PictureThis and/or CaptureThis programs. USE OF THE 
  27.            PROGRAM(S) INDICATES YOUR ACCEPTANCE OF THOSE TERMS AND 
  28.            CONDITIONS.
  29.  
  30.  
  31.          Release 4.0 of PictureThis has two major improvements. 
  32.          First, it works now at EGA and VGA resolutions (in addition 
  33.          to CGA). Second, the editor is larger and more capable, 
  34.          making PictureThis into a full-fledged PostScript page 
  35.          layout "desktop publishing" typesetting program, as well as 
  36.          a vector-based drawing program. There are other minor 
  37.          improvements, and a few bugs have been corrected.
  38.  
  39.          1.0 EGA/VGA SCREENS
  40.  
  41.          PictureThis 4.0 now works with EGA (350 line) and VGA (480 
  42.          line) graphics modes. You'll need to specify in the command 
  43.          line which type of screen you are using (see section 6.0). 
  44.          EGA and VGA screens use more memory than CGA, so you might 
  45.          want to use CGA for complex drawings. VGA uses more memory 
  46.          than EGA (which looks almost as good), so you might want to 
  47.          standardize on EGA.
  48.  
  49.          You can import drawings prepared in any screen mode 
  50.          (including those done using earlier versions of PictureThis) 
  51.          into any other screen mode. (There might be slight round-off 
  52.          errors when you do this, but usually these aren't 
  53.          noticeable.) You also can capture screens in EGA or VGA 
  54.          modes for use as templates (see section 10.0). Templates 
  55.          captured in EGA/VGA modes can be used in the other mode (EGA 
  56.          template on VGA screen or vice versa), but the aspect ratio 
  57.          will be wrong, and if you use a VGA template in EGA mode, 
  58.          you will lose the bottom of it. CGA templates can only be 
  59.          used in CGA mode. NOTE: PictureThis uses the EGA/VGA memory 
  60.  
  61.          in a somewhat non-standard way. If you have a memory 
  62.          optimizer which tries to use the "excess" EGA/VGA memory 
  63.          (such as DESQview's QEMM), you might have problems! (Disable 
  64.          the optimizer if necessary.)
  65.  
  66.          2.0 PROGRAM IN TWO PARTS
  67.  
  68.          The program is in two parts: PICTHIS4.EXE (the root section) 
  69.          and PICTHIS4.OVL (the overlay section). Using overlays 
  70.          allows more user data, since only part of the overlay is in 
  71.          memory at any one time. If you have extended or expanded 
  72.          memory, overlay parts are automatically cached there. See 
  73.          the user's manual for more details.
  74.  
  75.          3.0 EDITOR CHANGES
  76.  
  77.          The editor can import ASCII-format files prepared with word 
  78.          processors. This makes it easy to do not only drawings but 
  79.          entire text pages with PictureThis.
  80.  
  81.          3.1 EDITOR SIZE
  82.  
  83.          The standard size for the editor is 200 lines. (If you run 
  84.          short of memory, the number of lines might be smaller.)
  85.  
  86.          Since the editor is larger than one screen, you must be able 
  87.          to scroll up and down to the various parts of your text. 
  88.          This is accomplished with the usual PgDn and PgUp keys. 
  89.          Ctrl-Home still takes the cursor to the beginning of the 
  90.          text. Ctrl-End moves the cursor to the end of the text, as 
  91.          before.
  92.  
  93.          3.2 HYPHENATION
  94.  
  95.          PictureThis 4.0 hyphenates text automatically. We have 
  96.          incorporated HY-PHEN-EX (Copyright 1989 GeoMaker Software), 
  97.          which uses a sophisticated algorithm to hyphenate words. 
  98.          Hyphenation is ON by default in the editor. All you do is 
  99.          type your text in normally; when the editor determines that 
  100.          it is time to wrap a line, it first checks in the 
  101.          hyphenation exception dictionary HYPHEN.LST (an ASCII-format 
  102.          file which is user-modifiable) for the word that needs to be 
  103.          wrapped. If it can't find the word, HY-PHEN-EX algorithms 
  104.          are used to find possible hyphenation points. If no suitable 
  105.          hyphenation points are found, the line wraps on the nearest 
  106.          SPACE or HARD-HYPHEN. (A HARD-HYPHEN is a hyphen which the 
  107.          user typed in as part of the text.) SOFT-HYPHENS (hyphens 
  108.          inserted by PictureThis) appear different on the screen than 
  109.          normal hyphens (they have a short line down on the left), 
  110.          and can change each time the text is composed.
  111.  
  112.          We think HY-PHEN-EX does a good job -- it very rarely places 
  113.          a hyphen where it doesn't belong. But it doesn't catch every 
  114.          allowable hyphen. (There are all kinds of rules about 
  115.          hyphenation, and dictionaries don't always agree. One rule 
  116.          that HY-PHEN-EX uses, which might seem a bit strange, is 
  117.          that it never hyphenates a word less than five characters 
  118.          long.) If you don't like the way a word is hyphenated by HY-
  119.          PHEN-EX (that is, by PictureThis), you can manually insert 
  120.  
  121.          your own hyphen. However, this can be dangerous, because if 
  122.          you change any of the text before the inserted hyphen, or 
  123.          change any text parameters (such as font or point size), the 
  124.          hyphen is likely to end up in the middle of the line. (We 
  125.          see this frequently in computer typeset work.) Be careful! A 
  126.          better way is to add your word to the exception dictionary. 
  127.          HYPHEN.LST can be edited in most word processors or editors, 
  128.          including the PictureThis editor. If you are in the 
  129.          PictureThis editor, and you want to change HYPHEN.LST, just 
  130.          save your file (see section 3.3), import HYPHEN.LST, and add 
  131.          a word. Each word in HYPHEN.LST ends in a CARRIAGE RETURN 
  132.          and has hyphens wherever you want to put them. The order in 
  133.          which the words appear is unimportant. Then save HYPHEN.LST. 
  134.          If you want to use the new HYPHEN.LST, you must exit 
  135.          PictureThis (save your drawing first), and restart it. If 
  136.          you add too many words to HYPHEN.LST, it will slow down the 
  137.          hyphenation process. In general, HY-PHEN-EX does such a good 
  138.          job that you will probably seldom need to add a word. It 
  139.          even hyphenates nonsense words "correctly". Note that HY-
  140.          PHEN-EX is made to work with American English; it will 
  141.          hyphenate foreign words, but possibly incorrectly.
  142.  
  143.          With normal text, hyphenation is usually desirable. However 
  144.          if you want to turn hyphenation OFF, put the typesetting 
  145.          code <HYX> in your text where you want it turned off. 
  146.          Hyphenation can be reactivated with a <HYO> later in the 
  147.          text.
  148.  
  149.          3.3 IMPORTING AND EXPORTING ASCII FILES IN THE EDITOR
  150.  
  151.          PictureThis 4.0 can import text files prepared in word 
  152.          processors. It can also export a file prepared in the 
  153.          editor. To import/export a file while in the editor, first 
  154.          press F10. A line appears at the top of the editor, asking 
  155.          if you want to [R]ead, [W]rite, (or in some cases) 
  156.          [C]ontinue reading a file. If you press R or W, you are 
  157.          asked for a file specification. You can type in a specific 
  158.          file name (with path if necessary), or a file specification 
  159.          with a wild card character (e.g., *.txt) to get a directory 
  160.          of files from which you can choose, or you can just press 
  161.          ENTER and get a directory of all the files in the current 
  162.          directory.  Choose a file as usual.
  163.  
  164.          If you are writing a file, the contents of the editor will 
  165.          be written to that file, except real CARRIAGE RETURNS 
  166.          replace the END-OF-PARAGRAPH markers in the editor. You 
  167.          could possibly use this saved file in another text editor, 
  168.          but the PictureThis editor is NOT a general purpose editor, 
  169.          and shouldn't be used as such. The file saving capability is 
  170.          mainly so that if you are editing and have to quit, you can 
  171.          save your file and come back to it later.
  172.  
  173.          If you are reading a file, a portion of the file will be 
  174.          appended to the END of the text that is already in the 
  175.          editor, until it fills 75% of the editor's lines. 
  176.          PictureThis remembers what portion of the file has been 
  177.          read, so after you set part of the editor's text to the 
  178.          drawing (in the process, freeing some of the editor's 
  179.          lines), you can continue reading that file where you left 
  180.          off. If you have previously read from a file, when you press 
  181.  
  182.          F10, you will be given the choice to [C]ontinue reading from 
  183.          the same file. Just press C and another portion of the file 
  184.          is appended to the end of the text remaining in the editor, 
  185.          filling no more than 75% of the editor's lines. Why does it 
  186.          fill only 75% of the editor's lines? To allow you to edit 
  187.          the text without overflowing the end of the editor. If you 
  188.          do overflow, (e.g., by changing to a much larger point 
  189.          size), the text which overflows is permanently lost, and you 
  190.          will be warned that it has happened.
  191.  
  192.          An example of a typical session of typesetting a few-page 
  193.          document for which you have an ASCII file produced by a word 
  194.          processor follows:
  195.  
  196.          A. Run CONVERT on the file (see section 4.0).
  197.          B. Set up your frame and margins on the drawing screen. 
  198.          Let's say you want a two-column layout on 8-1/2 by 11 paper. 
  199.          (You could use TWOCOL.DRW.) Choose the left column's margin 
  200.          and place the cursor at the top left of the margin (Ctrl-L, 
  201.          Ctrl-T).
  202.          C. Set up the font, point size, justification, etc. Save the 
  203.          layout as a drawing.
  204.          D. Enter the editor.
  205.          E. Press F10, then R, then type your file name in. Part of 
  206.          the file is read into the editor.
  207.          F. Edit the text as necessary. Compose (F3).
  208.          G. Note the line where the Height Remaining indicator turns 
  209.          negative. Place an END-OF-TEXT (Ctrl-Q) marker at the 
  210.          beginning of this line. Press F5 to set the text to the 
  211.          first column.
  212.          H. Switch the margin to the second column and move the 
  213.          cursor to the top left of this column. Enter the editor. 
  214.          Notice that the text that was previously after the END-OF-
  215.          TEXT marker is now at the beginning of the editor.
  216.          I. Press F10, then C, to continue reading the Ascii file.
  217.          J. Edit and set the second column as you did the first.
  218.          K. Save your first page as a drawing and possibly an EPS 
  219.          file.
  220.          L. Read the layout you previously saved as a drawing back 
  221.          in, position the cursor at the top of the first column, and 
  222.          repeat the above procedure.
  223.          M. Continue the above until you have reached the end of the 
  224.          word processor file.
  225.  
  226.          3.4 COPYING/MOVING/DELETING BLOCKS OF TEXT
  227.  
  228.          PictureThis 4.0 allows the user to mark a block of text in 
  229.          the editor, then move or copy that block to a different 
  230.          position in the editor or delete the block.
  231.  
  232.          To mark a block, place the cursor at the beginning of the 
  233.          block and press Alt-B; then place the cursor at the end of 
  234.          the block (the character AFTER the last character of the 
  235.          block) and press Alt-E. If both ends are marked and the 
  236.          beginning is before the end, the marked block appears in 
  237.          reverse text. You can edit within or outside of the marked 
  238.          block, and it remains marked. You can compose or perform any 
  239.          other editor operations while the block is marked.
  240.  
  241.          To delete a marked block, press Alt-D. The block is deleted, 
  242.          and the text is recomposed. To move a marked block, place 
  243.  
  244.          the cursor after the character you want the block to follow 
  245.          and press Alt-M. The block is moved to the new location and 
  246.          remains marked; the text is recomposed.
  247.  
  248.          To copy a marked block, place the cursor after the character 
  249.          you want the copy to follow and press Alt-C. A copy of the 
  250.          block is placed at the cursor. The copy remains marked (to 
  251.          make multiple copying easy). The text is recomposed. The 
  252.          original block is not changed, but it is no longer marked.
  253.  
  254.          To "unmark" a block, press Alt-U.
  255.  
  256.          3.5 FINDING/REPLACING TEXT
  257.  
  258.          PictureThis 4.0 allows the user to find text in the editor 
  259.          and to replace this text with other text.
  260.  
  261.          To find text, place your cursor somewhere BEFORE the text 
  262.          you want to find. Then press F9. The top line asks for the 
  263.          text you want to find. Type it in and press ENTER. (The text 
  264.          can include Ctrl-A, Ctrl-Z, and Ctrl-Q for their equivalents 
  265.          in the text. It can also include Ctrl-E to find the END-OF-
  266.          PARAGRAPH symbol (down-arrow) which you get when you press 
  267.          ENTER.) Another line appears, asking you to specify other 
  268.          options. If you want to merely find the first instance of 
  269.          the text after the cursor, press ENTER. The cursor moves to 
  270.          the first character of the first instance of the found text. 
  271.          If no instance is found, the cursor does not move, and you 
  272.          see a message. The editor recomposes the text whenever it is 
  273.          attempting a find, so it will find text even if it is 
  274.          wrapped at the end of a line and even if it has a SOFT-
  275.          HYPHEN inserted in it. If you want to find the next instance 
  276.          of the same text, press F9 again. Notice that your previous 
  277.          text to be found is shown on the top line, so if you want to 
  278.          find the same text again, just press ENTER twice. It will 
  279.          find the NEXT instance of the text.
  280.  
  281.          Before you press ENTER to execute the find, you can also 
  282.          specify whether you want to find only text that is exactly 
  283.          like that you typed in (case sensitive, the default), or 
  284.          text that has the same letters, but possibly of a different 
  285.          case (capitals vs. small letters) than that originally typed 
  286.          in (case insensitive). If you specify case insensitive by 
  287.          pressing I, and you are searching for 'dog', the search also 
  288.          finds 'DOG' and 'Dog'. You can also press S for case 
  289.          sensitive, if you have previously chosen case insensitive.
  290.  
  291.          If you want to replace found text with different text, 
  292.          before you press ENTER, press R. You are asked for text to 
  293.          substitute for the original text. Type in your text (you can 
  294.          include the same Ctrl characters as in the find line) and 
  295.          press Enter. You then have, in addition to the case option, 
  296.          a next/all option. Next (the default) means that only the 
  297.          next instance of the found text is replaced. Press A for all 
  298.          if you want ALL instances past the cursor position to be 
  299.          replaced. When you are ready to execute the replace command, 
  300.          press ENTER. The text is recomposed, and the next/all 
  301.          instance(s) of the found text is replaced with the replace 
  302.          text. The cursor goes to the beginning of the last replaced 
  303.  
  304.          text. If no instance is found, the cursor does not move, and 
  305.          you see a message. If you want to perform the same replace 
  306.          operation again, press F9, ENTER, R, ENTER, ENTER.
  307.  
  308.          4.0 CONVERTING A WORD PROCESSOR FILE
  309.  
  310.          Text can be prepared for a PictureThis drawing entirely in 
  311.          the editor, but you might want to typeset text which was 
  312.          previously prepared in a word processor. In section 3.3, you 
  313.          learned how to import an ASCII file into the PictureThis 
  314.          editor. If you import a file directly from a word processor 
  315.          into the PictureThis editor, you will have usable, but not 
  316.          necessarily ideal, text. The editor IGNORES any Ctrl 
  317.          characters which it does not use (such as a linefeed) and 
  318.          replaces RETURNS with its own END-OF-PARAGRAPH character 
  319.          (down-arrow). This is fine in some cases, but not in others.
  320.  
  321.          Various word processors use different methods to mark 
  322.          special occurrences (e.g., indents, page breaks) in their 
  323.          files. In particular, each word processor has a special 
  324.          method to distinguish between HARD-RETURNS (returns which 
  325.          the user enters) and SOFT-RETURNS (returns which the word 
  326.          processor inserts when it decides that a line needs to be 
  327.          wrapped). A typical method is to use a SPACE followed by a 
  328.          CR for a SOFT-RETURN and just a CR for a HARD-RETURN. For 
  329.          typical text imported into the PictureThis editor, you want 
  330.          the SOFT-RETURNS to turn into just a SPACE and the HARD-
  331.          RETURNS to turn into just a CR, since you are reformatting 
  332.          the text into a different margin. To solve this problem and 
  333.          other similar problems, you can run the word-processor 
  334.          prepared file through the program CONVERT before you import 
  335.          it into PictureThis.
  336.  
  337.          CONVERT is a standalone text replacement program useful 
  338.          whenever you need to modify an ASCII file. It uses convert 
  339.          instruction files (we recommend using the extension .CVT), 
  340.          consisting of comments and search/replace pairs. We have 
  341.          prepared a standard convert instruction file (STANDARD.CVT) 
  342.          which is useful with many word processor files.
  343.  
  344.          To run CONVERT, simply type CONVERT at the command line. You 
  345.          are first asked for the name of the ASCII file you want to 
  346.          convert. Type in its name (with path if necessary) and press 
  347.          ENTER. You are then asked for the name of the file you want 
  348.          to write. Type it in and press ENTER. You are asked for the 
  349.          name of the conversion instruction file (e.g., 
  350.          STANDARD.CVT). Type it in and press ENTER. You are asked if 
  351.          you want to replace all multiple spaces with single spaces. 
  352.          (This is preferable for most typesetting. When most people 
  353.          type, they place two spaces at the end of each sentence. 
  354.          This is usually NOT done when typesetting text, so it is 
  355.          desirable to get rid of the multiple spaces. There are 
  356.          occasions when it is not desirable to get rid of multiple 
  357.          spaces; for instance, if you are typesetting computer code, 
  358.          the multiple spaces at the beginning of each line give the 
  359.          code "structure" which you want to maintain.) If you want to 
  360.          change multiple spaces to single spaces, press Y, otherwise 
  361.          press any other key. Finally you are asked if you want to 
  362.          strip the high-order bits of each character. WORDSTAR and 
  363.          some other word processors mark certain characters by adding 
  364.  
  365.          a high-order bit to the character (equivalent to adding 128 
  366.          to the character's ASCII value). For files from these word 
  367.          processors, press Y; the high-order bits are stripped off. 
  368.          (In general, this usually won't harm text prepared by non-
  369.          WORDSTAR-like word processors.) CONVERT then reads the first 
  370.          10000 characters of your Ascii file (or the whole file, if 
  371.          it is shorter than 10000 characters). It performs the first 
  372.          search/replace command in the chosen convert instruction 
  373.          file on the entire read portion of the file. Then it 
  374.          performs the second search/replace command on the results of 
  375.          the first command. It continues until it performs all of the 
  376.          search/replace commands in the chosen convert instruction 
  377.          file, then it writes the resulting portion of the file. It 
  378.          then reads the next 10000 characters of the ASCII file and 
  379.          repeats the process on this portion of the file. It 
  380.          continues to read and process portions of the ASCII file 
  381.          until it has processed all of it.
  382.  
  383.          Since CONVERT processes portions of the Ascii file 
  384.          separately (so that it can handle any size file), it is 
  385.          possible that at a break between portions, a search/replace 
  386.          command is incorrectly processed. CONVERT attempts to 
  387.          correct such errors, but it is still possible (though 
  388.          unlikely) that such an error could occur. If there is a 
  389.          possible error at any break point, CONVERT informs you where 
  390.          the error might occur. Even if CONVERT warns you of such a 
  391.          possible error, it is not likely that such an error actually 
  392.          occurred, and you probably can ignore the warning. If such 
  393.          an error occurred, you would probably notice it in the 
  394.          process of normal proofreading.
  395.  
  396.          To make a convert instruction file, use a text editor or 
  397.          word processor. You do not want any special control codes, 
  398.          etc. in your convert file, so save the file as an ASCII file 
  399.          or non-document file. Or you can use the PictureThis editor 
  400.          to make a convert instruction file. Here are the rules:
  401.  
  402.          No line can be longer than 80 characters.
  403.  
  404.          Any line starting in column 1 with a SEMICOLON (;) is 
  405.          considered a comment and ignored.
  406.  
  407.          Any line consisting only of a CARRIAGE RETURN is ignored. A 
  408.          search line is any other line, and is immediately followed 
  409.          by a replace line (no comments or empty lines are allowed 
  410.          between search and replace lines).
  411.  
  412.          Any keyboard character except '=' or ';' (d,G,8,*, etc.) can 
  413.          be included in a search or a replace line, and represents 
  414.          itself. Special strings beginning with '=' can also be used, 
  415.          as described below. (In the table 'N' represents a single 
  416.          digit, 0 - 9.)
  417.  
  418.          Special Character       Meaning
  419.  
  420.          =e or =E                carriage return
  421.          =l or =L                line feed
  422.          ==                      equals sign
  423.          =;                      semicolon
  424.          =NNN                    the character represented by the ASCII
  425.  
  426.                                    value NNN; NNN must be less than
  427.                                    256 (e.g., =032 is the same as
  428.                                    SPACE, and easier to read)
  429.          =?N                     a wildcard character that matches any
  430.                                    character
  431.          =aN                     a wildcard character that matches any
  432.                                    alphabetic character (a-z, A-Z)
  433.          =#N                     a wildcard character that matches any
  434.                                    digit (0-9)
  435.          =.N                     a wildcard character that matches any
  436.                                    punctuation character
  437.  
  438.          Examples of search lines:
  439.  
  440.          the dog                 will match 'the dog'
  441.  
  442.          =a3=#9                  will match 'A1', 'j5', 'Q0'
  443.  
  444.          =?5"=032                will match 't" ', '?" ', '4" '
  445.  
  446.          t=a1=.7g                will match 'th,g', 'tD@g'
  447.  
  448.          When a match is found, it is replaced by what the replace 
  449.          line indicates. A normal character in a replace line 
  450.          produces that character. A wildcard character uses the 
  451.          character that was found to replace it in its position.
  452.  
  453.          Examples of search/replace pairs:
  454.  
  455.          the dog                 'the dog' will be replaced by 'the cat'
  456.          the cat
  457.  
  458.          =a3=#9                  'A1' will be replaced by '1a'; 'j5'
  459.          =#9=a3                    will be replaced by '5j'
  460.  
  461.          =?5"=032                't" ' will be replaced by 't'' '
  462.          =?5''=032
  463.  
  464.          =a1=#1=a2=#2            'b3c4' will be replaced by 'cb43';
  465.          =a2=a1=#2=#1            'A9Q8' will be replaced by 'QA89'
  466.  
  467.          You cannot have a wildcard character in a replace line which 
  468.          does not appear in the corresponding search line. An equals 
  469.          sign followed by characters which are not in the previous 
  470.          list is also an illegal string. If an illegal search/replace 
  471.          pair is found, CONVERT aborts the conversion process.
  472.  
  473.          Examples of illegal search/replace pairs:
  474.  
  475.          =q4
  476.          a=q4
  477.  
  478.          =?abc
  479.          =?cba
  480.  
  481.          =32dog
  482.          dog
  483.  
  484.          =a2cat=a4
  485.          =a1dog=a4
  486.  
  487.          =456
  488.          ggg
  489.  
  490.          STANDARD.CVT includes search/replace pairs to do the 
  491.          following:
  492.  
  493.          Replace SPACE followed by CARRIAGE RETURN with a SPACE. (To 
  494.          get rid of some SOFT-RETURNS.)
  495.  
  496.          Replace DOUBLE-QUOTES with a pair of SINGLE-QUOTES. (This is 
  497.          normal typesetting practice.)
  498.  
  499.          Replace a TAB with 8 spaces.
  500.  
  501.          Replace a < with the special character used to start a 
  502.          typesetting code in the PictureThis editor.
  503.  
  504.          Replace a > with the special character used to end a 
  505.          typesetting code in the PictureThis editor.
  506.  
  507.          We don't know all of the ways word processors represent 
  508.          SOFT-RETURNS and other important codes. If STANDARD.CVT does 
  509.          not work properly with your word-processor files, you can 
  510.          modify it and/or add to it to make it work. Sometimes just 
  511.          writing the file out in ASCII mode might help. Try it! Write 
  512.          a short file in your word processor. Then look at the HEX 
  513.          version of it using any one of numerous utilities that 
  514.          exist. We'd use LOTUS MAGELLAN, but there are many more. Try 
  515.          to figure out what code your word processor is using for a 
  516.          SOFT-RETURN, and write a conversion instruction file to 
  517.          change it to a SPACE.
  518.  
  519.          5.0 MEMORY MANAGEMENT/SAVING TEXT BACKGROUND
  520.  
  521.          PictureThis 4.0 is a large and complex program which 
  522.          maintains a large amount of user generated data and thus 
  523.          uses a lot of computer memory. But it is still usable on a 
  524.          PC with only standard memory (640K). There is no need to 
  525.          have extended and/or expanded memory (though you can use 
  526.          them (see section 2.0)). Four types of data use considerable 
  527.          memory:
  528.  
  529.          1. Data used to define curves, trails, and objects. You must 
  530.          set how many curves are allowed with a command line 
  531.          parameter (see section 6.0).
  532.  
  533.          2. Textblock data (all of the text, plus all of the 
  534.          information needed for placing the text in the proper 
  535.          position, with the proper font, size, etc.). The memory 
  536.          required for this depends on how much text is in a drawing. 
  537.          When a textblock is cut or deleted, much of the memory it 
  538.          used is freed, but a portion of it is NOT freed. If you cut 
  539.          and delete large textblocks frequently, you can build up a 
  540.          considerable amount of unusable memory. THIS MEMORY CAN BE 
  541.          FREED SIMPLY BY SAVING YOUR DRAWING AND THEN GETTING IT 
  542.          AGAIN.
  543.  
  544.          3. Font information (character widths, kerning, etc.) for 
  545.          each font used and definitions of all characters for each 
  546.          screenfont used. 4. Background pixel color values for the 
  547.  
  548.          drawing screen. When each curve is drawn, the previous color 
  549.          of each pixel in the curve is saved. This allows you to move 
  550.          or erase a curve (or a full object) without leaving "holes" 
  551.          in the background. (This is most obvious when you are using 
  552.          a template.) This information is saved in a highly 
  553.          compressed form used not only for redrawing the background 
  554.          when an element is erased, but also for dashing elements for 
  555.          selection (e.g., when choosing an object to copy). 
  556.          Unfortunately, for large textblocks, this takes a lot of 
  557.          memory. A page of small text uses a lot of pixel memory, 
  558.          sometimes more than is available. "Jabbering" the text 
  559.          helps, but is sometimes undesirable.
  560.  
  561.          To solve this problem, we have added the ability to turn off 
  562.          the background save FOR TEXT ONLY. To do this, press F9 to 
  563.          enter the Miscellaneous menu, and then press B. You can 
  564.          choose S for saving the text background or N for NOT saving 
  565.          the text background. With either selection, the program 
  566.          functions essentially the same. When NoSave is chosen, there 
  567.          are only minor differences:
  568.  
  569.          a. When any text is erased, a hole is left in the 
  570.          background. Press D to redraw and get rid of the hole.
  571.  
  572.          b. Where text is normally dashed-and-dotted (for grouping an 
  573.          object), it is dashed with NoSave.
  574.  
  575.          c. Dashing and erasing of text is slower.
  576.  
  577.          For normal drawing with only small amounts of text, use the 
  578.          Save option (the default). If you are doing a full page of 
  579.          text, it is probably preferable to use the NoSave option 
  580.          and/or to "jabber" the text (on the drawing screen only). If 
  581.          you save a drawing, the current Save/NoSave option is saved 
  582.          with the drawing and is used when the drawing is imported.
  583.  
  584.          When you are setting text from the editor, you might see a 
  585.          message stating that there is not enough memory to save 
  586.          text, and that the editor is aborting. If you see this 
  587.          message, don't panic. Save your drawing. Import it again. 
  588.          Then go back into the editor and check whether you have 
  589.          placed an END-OF-TEXT marker in the appropriate place (you 
  590.          might have been trying to set the contents of the entire 
  591.          editor, which could be much more than will fit on the page); 
  592.          if not, put one in. Press F5 to try setting the text again. 
  593.          If it doesn't work this time, you will have to jabber the 
  594.          text on the drawing screen or switch to NoSave for text 
  595.          background.
  596.  
  597.          If there is enough memory to save the text, there still 
  598.          might not be enough memory to display the text while saving 
  599.          the background. For this message, the same remedy applies; 
  600.          do one, two, or all three of the following:
  601.  
  602.          a. Save the drawing and import it again.
  603.  
  604.          b. Jabber the text on the drawing screen.
  605.  
  606.          c. Change text background setting to NoSave.
  607.  
  608.          6.0 COMMAND LINE PARAMETERS/CONFIGURATION FILE
  609.  
  610.          PictureThis 4.0 requires new command line parameters to 
  611.          specify its new options. You may specify how many curves you 
  612.          want to allow for and what screen type you are using. This 
  613.          information is saved in a configuration file in the default 
  614.          directory (called PICTHIS.CFG) and used the next time you 
  615.          run PICTHIS4, so you don't have to type in configuration 
  616.          information when you subsequently run PictureThis unless you 
  617.          want to change it.
  618.  
  619.          The two command line parameters are, IN ORDER:
  620.  
  621.          1. A letter (a-h or A-H). The letter indicates how many 
  622.          curves are to be allowed. An 'A' (or 'a') means 250 curves. 
  623.          Each succeeding letter adds 250 more curves, so: a = 250; b 
  624.          = 500; c = 750; d = 1000; e = 1250; f = 1500; g = 1750; h = 
  625.          2000. Unlike previous versions of PictureThis, you no longer 
  626.          have to specify the number of pixels allowed; memory for 
  627.          pixels is automatically allocated. Text uses a LOT of pixel 
  628.          memory, especially on EGA/VGA screens, so if you are using a 
  629.          lot of text, either toggle "jabber" on so "real" text only 
  630.          shows on the Quickshow screen, set the curve number low, 
  631.          and/or set the BkgdSave setting on the Miscellaneous menu to 
  632.          NoSave.
  633.  
  634.          2. A three letter indicator of the screen type: CGA, EGA, or 
  635.          VGA. If not specified, the default is CGA.
  636.  
  637.          The command line parameters must be specified in order, but 
  638.          you do not need to specify all of them. If you need to 
  639.          specify only the number of curves, just specify the first 
  640.          parameter. But if you need to change the screen type, you 
  641.          must specify both parameters.
  642.  
  643.          Examples of legal command lines:
  644.  
  645.          PICTHIS4 b ega
  646.  
  647.          PICTHIS4 A VGA
  648.  
  649.          picthis4 d
  650.  
  651.          picthis4 c EGA
  652.  
  653.          PictureThis saves in PICTHIS.CFG not only these command line 
  654.          parameters, but also the aspect ratio and the directories of 
  655.          the font files, the screen font files, and the Kartoon 
  656.          features files. If you install PictureThis correctly, 
  657.          PICTHIS.CFG should include the proper directories. When you 
  658.          need to use these files (i.e., when selecting a font or 
  659.          going into Kartoon mode), if PictureThis cannot find the 
  660.          needed file, it asks you for a new directory. After you type 
  661.          in this new directory, it is saved in PICTHIS.CFG, so you do 
  662.          not have to type in the directory every time you run 
  663.          PictureThis (as was necessary in Version 3.0).
  664.  
  665.          7.0 SAVING AND IMPORTING A DRAWING
  666.  
  667.          In PictureThis 3.0, when a drawing was saved, the current 
  668.  
  669.          contents of the editor were saved along with the drawing. 
  670.          This is no longer desirable, since you can now save the 
  671.          editor contents independently. Now when you save a drawing, 
  672.          the contents of the editor are NOT saved (but text already 
  673.          in the drawing IS saved, of course). When you import a 
  674.          drawing, the contents of the editor are NOT changed (even if 
  675.          it is a version 3.0 drawing with saved editor contents). 
  676.          This is preferable if you are working with a large file 
  677.          prepared in a word processor: you can import your page 
  678.          layout drawing; enter the editor; read in the word processor 
  679.          file; set as much text as is needed to fill the page; save 
  680.          the drawing; import the page layout drawing again; reenter 
  681.          the editor (the text will start after the text that was 
  682.          set); read in more of the word processor file; fill the 
  683.          second page; etc.
  684.  
  685.          8.0 HELP SCREENS
  686.  
  687.          The Help Screens have been slightly modified. When you are 
  688.          viewing the Main (Drawing) Help Screen, and you determine 
  689.          which key that you want to press, you can press that key 
  690.          while still viewing the Help Screen, and you will return to 
  691.          the drawing screen with the operation performed.
  692.  
  693.          There are now TWO Editor Help Screens (in addition to the 
  694.          Font Number Screen).
  695.  
  696.          9.0 NEW SCREENFONT
  697.  
  698.          Included on the distribution disk is STANDARD.SFT. This is a 
  699.          modified screen font which draws somewhat faster than the 
  700.          STANDARD.SFT included with release 3.0. You can continue 
  701.          using the old STANDARD.SFT if you prefer the way that it 
  702.          looks.
  703.  
  704.          10.0 CAPTURING A SCREEN FOR USE AS A TEMPLATE
  705.  
  706.          CAPTHIS and ACAPTHIS work almost as before, but they now 
  707.          capture VGA and EGA screens, in addition to CGA screens. You 
  708.          run CAPTHIS or ACAPTHIS as before. Once loaded, either 
  709.          program is activated when you press Shift-PrintScreen. 
  710.          Either program determines the current screen mode and 
  711.          captures the appropriate type of screen. If the current mode 
  712.          is a text mode, it is not captured, and a regular Shift-
  713.          PrintScreen is executed. CGA templates are captured as in p 
  714.          revious versions. EGA and VGA templates are compressed as 
  715.          they are saved, so their files are of different sizes, 
  716.          depending on how complex they are. The Shift-PrintScreen 
  717.          interrupt is sometimes taken over by the program you are 
  718.          running, in which case CAPTHIS and ACAPTHIS will not work. 
  719.          This seems to be more true with EGA/VGA programs than CGA 
  720.          programs. For example, CAPTHIS and ACAPTHIS will not work if 
  721.          you have run MAGELLAN, even if you exit from it. If you have 
  722.          trouble using CAPTHIS and ACAPTHIS, try rebooting your 
  723.          computer without any shells and TSR's.
  724.  
  725.          11.0 DASH CHANGES
  726.  
  727.          The lengths of the dashes and gaps in both default and user 
  728.          specified dash patterns are now measured in line-weights 
  729.  
  730.          instead of points. In PictureThis 4.0, if a dash is set to 
  731.          be 4 line-weights long, it will be 4 points long for a curve 
  732.          with line weight (thickness) of 1 point, but only 2 points 
  733.          long for a curve with line weight .5. The dash patterns are 
  734.          now proportional to the line-weight of the curve. You may 
  735.          also set dashes and gaps to the values .1, .2, ..., .9 which 
  736.          allows (almost) round or square dots when the linecap is 
  737.          round or square. If you use a drawing prepared in 
  738.          PictureThis 3.0 which has curves with dash patterns in 
  739.          PictureThis 4.0, the PostScript output will look different, 
  740.          unless the dashed curves all have 1 point line weights.
  741.  
  742.