home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / repp.zip / REPP310.DOC < prev    next >
Text File  |  1989-02-16  |  53KB  |  1,535 lines
  1. +----------------------------------------------------------------------------+
  2. |                                                                            |
  3. |        R.E.P.P. -- 'Reverse-Engineer Printer Picture'    -- v. 3.10        |
  4. |        ============================================================        |
  5. |         (C) 1986 Galaxy Systems Corporation -- All Rights Reserved         |
  6. |                                                                            |
  7. +----------------------------------------------------------------------------+
  8.  
  9.                          QuickBASIC Runtime Modules
  10.     (C) Copyright 1982-1988 Microsoft Corporation -- All Rights Reserved
  11.  
  12.  
  13. R.E.P.P. may be given away and shared between interested parties on an AS-IS
  14. basis only.  No liability is assumed by Galaxy Systems Corporation for any
  15. damages, direct, indirect or consequential, which may arise out of the use
  16. of this product or inability to use this product.  No warranty, express or
  17. implied, including the warranties of merchantability and fitness for a
  18. particular purpose, is offered.
  19.  
  20. The complete, entire R.E.P.P. package is now distributed by PC-SIG,
  21. and upgrades to the package will only be available through PC-SIG.
  22. No monies of any kind are solicited.  If you have any comments about
  23. the package, please address them to:
  24.  
  25. >>> Galaxy Systems Corp., Box 26387, Richmond, Va. 23260-6387 <<<  --Enjoy!
  26.  
  27.  
  28. Program Specifications for R.E.P.P. (REPP310.EXE):
  29. ==================================================
  30.  
  31.      Usage:          . Converts Printer Art into Graphics Images
  32.  
  33.                      . Contains a built-in version of YAMP, a ReadMAC
  34.                        viewer optimized for display on CGA monitors.
  35.  
  36.                      . Provides a Slide-show Presentation of REPP
  37.                        .IMG Files, standard BLoads, and ReadMACS
  38.  
  39.                      . Converts REPP .IMG files, standard BLoads & ReadMAC
  40.                        files to/from each other (not all combinations)
  41.  
  42.                      . Provides colorization functions for BLoads,
  43.                        .IMG and ReadMAC files
  44.  
  45.                      . Provides top/bottom & left-right inversion functions
  46.  
  47.                      . CAN BE USED AS A TEXT-SCRUBBER.  Expands blanks,
  48.                        replaces certain control characters and premature
  49.                        eof marks with blanks, and can remove hi-bits
  50.                        from bytes.
  51.  
  52.                      . Has other miscellaneous capabilities
  53.  
  54.      Requirements:   . Color Graphics Adaptor card, or equivalent
  55.                      . DOS 2.1 or later; 384K available memory (may
  56.                        also run successfully in some smaller machines)
  57.  
  58.  
  59.                                   Page 1
  60. Introduction to REPP:
  61. =====================
  62.  
  63. The REPP package originally consisted of two programs, REPP and
  64. UTIL.  REPP was the original program that converted Printer Art
  65. into graphics images.  UTIL was a separate program that provided
  66. image conversions, colorizations, and a number of other options.
  67.  
  68. With the advent of REPP310, REPP and UTIL have been merged into
  69. a single program.  The original REPP menu screen comes up as the
  70. program is fired up.  The UTIL menu screen can be reached by keying
  71. alt-M (for "alternate Menu").  ("alt-M" means hold down the Alt key
  72. and press M, and then let go.)  Once in the utility menu, you can
  73. go back to the REPP menu by again pressing alt-M.
  74.  
  75. Also, with the release of REPP310, a built-in ReadMAC viewer has
  76. been added.  The viewer is YAMP, "Yet Another Mac Program", a viewer
  77. optimized for the display of ReadMACs on CGA monitors.  It contains
  78. Portrait and Landscape mode views, contrast settings, colorized
  79. contrast settings, inversions and mirroring, and other options.
  80.  
  81. The ReadMAC viewer is available from either the REPP or UTIL menus.
  82. All you have to do is select a .MAC file to view.
  83.  
  84.  
  85. The documentation that follows is organized in this order:
  86.  
  87.          .  An introduction to the REPP & UTIL menus
  88.  
  89.          .  A suggested installation procedure
  90.  
  91.          .  A list of initial considerations
  92.  
  93.          .  An explanation of command-line options
  94.  
  95.          .  An explanation of the REPP menu
  96.  
  97.          .  An explanation of the UTIL menu
  98.  
  99.          .  An explanation of the YAMP options
  100.  
  101.  
  102. Have fun!
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                   Page 2
  119. Introduction to the REPP Menu:
  120. ==============================
  121.  
  122. The R.E.P.P menu can be used to create bit-image graphic
  123. equivalents of old-style, ASCII-type 'printer art'.
  124.  
  125. Further, R.E.P.P. provides you with various 'tuning' options--
  126. horizontal & vertical orientation of the pictures, normal and
  127. squeezed representations, contrast & color modes, and so forth.
  128.  
  129. Also, once a picture has been re-created to your liking, it can
  130. be saved for later redisplay.  Further, REPP now permits you to
  131. create slideshow presentations of those saved files. 
  132.  
  133. Pictures to be R.E.P.P.ed must be in printable, ASCII form.
  134. If "COPY picname.pic LPT1" works, then R.E.P.P. will usually
  135. work with "picname.pic".
  136.  
  137.  
  138. Introduction to the UTIL Menu:
  139. ==============================
  140.  
  141. The UTIL Menu provides three major functions:
  142.  
  143.       It can "clean up" printer art text files which have "bad"
  144.       characters in them, such as premature eof marks and errors
  145.       generated during a modem download.  This means this function
  146.       can also be used as a GENERAL TEXT SCRUBBER.
  147.  
  148.       It can read standard BASIC BLoad images and TRS 80 Model 4
  149.       hi-res images, and Bloads without BASIC header bytes.  These
  150.       images can then be colorized or inverted if desired, and
  151.       then saved in standard .IMG form.
  152.  
  153.       Finally, if you have an Okidata 82A with OKWriter (tm) ROMs,
  154.       or if you have an Okidata 92/93 with Okigraph (tm) ROMs,
  155.       the UTIL menu will let you print an .IMG file.  (Users with IBM-
  156.       compatible printers can use the DOS GRAPHICS command along
  157.       with Shift-PrtSc instead.)
  158.  
  159. Note that the built-in ReadMAC viewer, YAMP, permits you to compose an
  160. image for a CGA screen.  When you exit the YAMP viewer, this CGA screen
  161. will be captured automatically, and the remainder of the functions of the
  162. UTIL menu would then be available to modify or colorize the captured
  163. screen.  Thereafter, the image can be saved as a .BLD or .IMG file.
  164.  
  165. Finally, the UTIL Menu provides the same slide-show feature as the
  166. REPP Menu.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                   Page 3
  178. Installation Notes:
  179. ===================
  180.  
  181. 1.  The R.E.P.P. package consists of the following files:
  182.  
  183.           REPP310.EXE      The printer art conversion program, now
  184.                              with built-in utility functions and a
  185.                              built-in ReadMAC viewer.
  186.           REPPHELP.DAT     On-Line Help information.
  187.           UTILHELP.DAT     On-Line Help information.
  188.           REPP310.DOC      This documentation file.
  189.  
  190.     Various sample pictures and files are also usually included.
  191.  
  192. 2.  If you have a hard drive, skip to #3.  If you will be running REPP
  193.     from a floppy-based system, read on:
  194.  
  195.     For a single-drive system:
  196.  
  197.           Place REPP310.EXE, REPPHELP.DAT and UTILHELP.DAT onto a
  198.           single floppy.  Copy any printer art, .IMG files (see later)
  199.           and ReadMACs you wish to view to this same floppy, or to a
  200.           RAM disk which you may have set up (see your DOS manual
  201.           for details on VDISK.SYS).
  202.  
  203.     For a double-drive system:
  204.  
  205.           Place REPP310.EXE, REPPHELP.DAT and UTILHELP.DAT onto one
  206.           floppy.  You should also have room to include the REPP310.DOC
  207.           file and any other samples that may have come with the package,
  208.           so you may as well keep everything together.
  209.  
  210.           Place the files of printer art, ReadMACs and .IMG files (see
  211.           later) onto a second floppy.
  212.  
  213.           When you are ready to run the programs, run them from the
  214.           floppy they are on, and set up the default directory to point
  215.           to the root directory of the other drive.  (See function F1,
  216.           later in this document.)  Note:  in version 3.10, you can
  217.           switch to the other drive and switch directories once
  218.           in the program also.
  219.  
  220. 3.  For hard disk users, the following installation configuration is
  221.     suggested:
  222.  
  223.           Create a directory such as \IMG.  Copy all the files from
  224.           this package into it.  (Obviously, you won't need the .DOC
  225.           file or the sample .PIC files to *run* the programs, so if
  226.           you are tight on space, you can eliminate these.)
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                   Page 4
  237. 3.  (cont'd.)
  238.  
  239.           REPP is designed to run with DOS versions that have some
  240.           problems in providing directory information.  Therefore,
  241.           whenever REPP310 is executed, it will assume that the
  242.           REPPHELP.DAT and UTILHELP.DAT files are in the current
  243.           directory unless told otherwise by the /DDIR= command-line
  244.           option:
  245.  
  246.           C>REPP310 /DDIR=\IMG
  247.  
  248.           You could also create a .BAT file in a directory that is in
  249.           your current PATH, and then be able to execute REPP310 
  250.           from any point on your hard drive:
  251.  
  252.           REPP.BAT:
  253.  
  254.               REPP310 /DDIR=\datfiledirectory
  255.  
  256.           Other run-time options are also available and are discussed
  257.           in the text that follows.
  258.  
  259.  
  260. Some Initial Notes:
  261. ===================
  262.  
  263. 1.  REPP310 can determine if you have a CGA-capable monitor, but it
  264.     cannot tell if the monitor is color or black & white (monochrome).
  265.     If you have a monochrome CGA monitor, some parts of the menus may be
  266.     very hard to read.  Use the /BWMON option on the command line:
  267.  
  268.       C>REPP310 /BWMON
  269.  
  270.       A>REPP310 /BWMON
  271.  
  272. 2.  REPP Menu:  Printer art which uses OVERPRINTING *IS* SUPPORTED, though
  273.     in the color modes the overprinting may not work as expected.
  274.     In the black and white modes, overprint support works quite well.
  275.  
  276. 3.  Upon entry, REPP310 sets up to work with the current drive's CURRENT
  277.     DIRECTORY.  *THIS IS DIFFERENT FROM PRIOR VERSIONS OF REPP, WHICH SET
  278.     UP IN THE ROOT DIRECTORY.*  You can set the directory again, even
  279.     changing the drive and giving an ambiguous file specification to
  280.     limit the display, if you wish, once in this menu screen.
  281.     You can also specify the Initial DIRectory and file specification
  282.     on the command line, as in the following example:
  283.  
  284.           C>REPP310 /IDIR=\IMG\*.PIC
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                   Page 5
  296. +--------------------+
  297. |                    |
  298. |  Running REPP310:  |
  299. |  ================  |
  300. |                    |
  301. +--------------------+
  302.  
  303. REPP310 is invoked from the command line by typing
  304.  
  305.        d>REPP310
  306.  
  307. Several optional command-line parameters may be coded.  The
  308. complete syntax for a REPP310 invocation is
  309.  
  310.        d>REPP310 [/BWMON] [/QUIET] [IDIR=\initialdirectory&filespec]
  311.                                    [DDIR=\dat&helpfiledirectoryspec]
  312.                                    [SHO=\slideshowfilespecification]
  313.  
  314. Note that the square brackets [] simply indicate OPTIONAL items
  315. that are not required for executing REPP310.  You do not code
  316. the [ and ] brackets themselves.
  317.  
  318. Also, since QuickBASIC replaces all lower-case letters on the command 
  319. line with upper-case, case is not important when keying the parameters.
  320.  
  321.        /BWMON      is used to make all menu displays Black & White.
  322.                    If you are using a composite video monitor, you
  323.                    will appreciate this.
  324.  
  325.        /QUIET      automatically places the program into "quiet mode"
  326.                    and bypasses the initial keypress after the signon
  327.                    screen is displayed.
  328.  
  329.        /IDIR=      indicates to the program what the initial directory
  330.                    is to be.  If omitted, the current directory is
  331.                    used as the initial directory.
  332.  
  333.        /DDIR=      indicates the location of the REPPHELP.DAT and
  334.                    UTILHELP.DAT files.  This is needed only if these
  335.                    files are not in the directory from which REPP310
  336.                    is being invoked.
  337.  
  338.        /SHO=       indicates a SlideShow Script file to be 
  339.                    automatically executed by REPP310.
  340.                    This automatically forces /QUIET.  Also, the
  341.                    filename MUST have an extension of ".SHO".
  342.  
  343. Once the program has begun and the menu screen is showing,
  344. F1, F2, F3 and F4 place the cursor into the associated keying
  345. area.  To leave an entry unchanged, press RETURN or another F-key
  346. WHENEVER the cursor is at the LEFT EDGE of the keying area.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                   Page 6
  355. +------------------+
  356. |                  |
  357. |  The REPP Menu:  |
  358. |  ==============  |
  359. |                  |
  360. +------------------+
  361.  
  362.  
  363. F1 (Current Drive/Directory/Ambiguous File Name Specification):
  364. ===============================================================
  365.  
  366. Note that TO ENTER A DIRECTORY, you DO NOT lead off with the
  367. CHDIR or CD command; just enter the directory name.  Also, to
  368. list any files, a specification (such as *.*) MUST follow the
  369. directory.  Example:  \art\*.pic
  370.  
  371. The directory you entered will be shown once you press another
  372. function key (or RETURN).
  373.  
  374. If you just wish to point to a directory but do not wish the files
  375. listed, enter the directory name without any file specification,
  376. as in
  377.     \dir\subdir
  378.  
  379. You may also enter a drive letter and colon (:) to switch to a 
  380. particular drive.
  381.  
  382. If you enter a drive letter and directory (for example, b:\pic) and
  383. the drive you specify IS valid but the directory you specify IS NOT,
  384. then REPP will switch to the new drive's CURRENT directory.
  385.  
  386.  
  387. F2 (Selection of File to Graph):
  388. ================================
  389.  
  390. In this area, you key the name of the printer art file to be
  391. translated into a graphics image.  If you do not supply an
  392. extension, ".PIC" is assumed.
  393.  
  394. The file's existence is verified once you activate the selection
  395. (see below) or move out of this keying area into another area,
  396. so some disk activity may occur.
  397.  
  398. If the file does not exist, you will be beeped at and a message
  399. will appear.
  400.  
  401.  
  402. F3 (Saving a Graphed Image):
  403. ============================
  404.  
  405. Once the message <In Save Area> appears in the F2 area, a
  406. graphics image may be saved to disk for later viewing.  Key
  407. the name of the file to save the image to in this area.  The
  408. file MUST NOT ALREADY EXIST, or else you will be beeped at and
  409. a message will appear.
  410.  
  411.  
  412.  
  413.                                   Page 7
  414. F3 (cont'd.)
  415. ============
  416.  
  417. File verification occurs when you activate the save (see below)
  418. or move to another keying area.
  419.  
  420. The extension used for the file must be ".IMG", for a REPP-type
  421. .IMG-file save, or .BLD, for a straight Bload-able file save.
  422.  
  423. If you do not specify an extension, ".IMG" will be used.
  424.  
  425. NOTE:  There exist one or more software packages that also use
  426.        .IMG as an extension for their image files.  These files
  427.        will likely not be in the same format as REPP-created .IMG
  428.        files.  If you experience problems in viewing an .IMG file,
  429.        this may be the problem.
  430.  
  431.  
  432. F4 (Recalling a Saved Image or SlideShow Script):
  433. =================================================
  434.  
  435. In this area, you key the name of the saved image file you wish
  436. to recall.  The file must exist, or else you will be beeped at,
  437. and a message will appear.
  438.  
  439. File verification occurs when you activate the recall or move
  440. to a different keying area.
  441.  
  442. If you do not specify an extension, ".IMG" will be used.
  443.  
  444. It is now possible to directly load BASIC Bload files and Bload files
  445. without the BASIC header bytes.  This function is performed automatically 
  446. whenever the requested picture file is not recognized as an .IMG file.
  447.  
  448. It is now also possible to load and view ReadMAC files.  ReadMAC files
  449. are image files created originally on the Apple Macintosh (TM)
  450. computer.  These files proliferate on bulletin boards and are usually
  451. described by the term "ReadMAC", or may have an extension of ".MAC".
  452.  
  453. Also, if you specify a filename with an extension of .SHO, it will
  454. be assumed that you are specification a SlideShow Script.
  455.  
  456. SlideShow Scripts are standard ASCII files (nondocument mode in
  457. WordStar(R)) which can even be created by the COPY CON filename.SHO
  458. command.  The available commands within a SlideShow file are the
  459. following:
  460.  
  461.       Command:                       Explanation:
  462.       ---------------------------    ----------------------------------
  463.  
  464.       DELAY n                        "n" is a number from 0 to 99.
  465.                                      This is the number of
  466.                                      seconds to delay between
  467.                                      SHOW commands ("0" means
  468.                                      wait for a keypress before
  469.                                      showing the next file)
  470.  
  471.  
  472.                                   Page 8
  473. F4 (cont'd.)
  474. ============
  475.  
  476.       SHOW filespecification         The name of file to show
  477.                                      (must be .IMG or BLOADable
  478.                                      file; CANNOT be a printer
  479.                                      art text file).  May now
  480.                                      also be a ReadMAC file
  481.                                      (.MAC extension).
  482.  
  483.                                      NOTE:  If it is a ReadMAC
  484.                                      that you are SHOWing, you can
  485.                                      follow the filespecification
  486.                                      with a blank and a string of
  487.                                      YAMP directives (keystrokes).
  488.                                      See the later discussion of
  489.                                      YAMP for details.
  490.  
  491.       CHDIR d:\directorypath         You can change drives and/or
  492.                                      directories to be able to
  493.                                      SHOW files located in other
  494.                                      places (useful if you don't
  495.                                      want to keep keying the drive
  496.                                      and/or the directory in the 
  497.                                      names of files to be shown)
  498.  
  499.       ' commentary                   Lines whose first nonblank
  500.                                      character is an apostrophe
  501.                                      are taken as comments.
  502.  
  503.       MENU                           Return to the REPP or UTIL menu
  504.  
  505.       REPEAT                         Repeat the script from the top
  506.  
  507.       If neither MENU or REPEAT are contained in the script, then
  508.       at the end of the script REPP310 returns either to the MENU,
  509.       or to DOS if the script was invoked with the /SHO command line
  510.       parameter.
  511.  
  512.       Example:
  513.  
  514.           d>\img\repp310 /sho=\img\sample.sho 
  515.  
  516.       Sample .SHO file:
  517.  
  518.           DELAY 3
  519.           CHDIR \IMG\SHIPS
  520.           SHOW FRIGATE.IMG
  521.           SHOW KETCH.BLD
  522.           SHOW ESCHER.MAC 
  523.           CHDIR \IMG\PLANES
  524.           DELAY 5
  525.           SHOW X15.IMG
  526.           ' The X-15 -- my favorite!
  527.           ' Now we repeat until stopped with ESC or F9/F10:
  528.           REPEAT
  529.  
  530.  
  531.                                   Page 9
  532. Activating F2, F3, or F4:
  533. =========================
  534.  
  535. To execute an F2, F3 or F4 option after all other options have been
  536. set or are satisfactory, press F2, F3 or F4, enter the file name, and
  537. EITHER press RETURN or REPEAT the same F-key again.
  538.  
  539. (If the correct file name is already in the option area, you can just
  540. press the appropriate F-key TWICE.)
  541.  
  542. UPON COMPLETION OF AN F2, F3 OR F4 FUNCTION, SOME MUSICAL NOTES
  543. WILL PLAY.  FOR THE F2 AND F4 FUNCTIONS, THIS METHOD OF INDICATING
  544. COMPLETION DOES NOT CLUTTER UP THE IMAGE WITH TEXT.
  545.  
  546. Note:  After a graphics image is completed, pressing any key (other
  547. =====  than F9 or F10) will return you to the menu screen.  If you
  548.        press F9 or F10 (see below) you will return to DOS.
  549.  
  550.  
  551. F5 (Framing), F6 (Sizing), F7 (Contrast/Color Palette):
  552. =======================================================
  553.  
  554. F5, F6 & F7 simply rotate between the available customizing options
  555. for the generation of the graphics image.
  556.  
  557.  
  558. F8 (Help):
  559. ==========
  560.  
  561. F8 displays an abbreviated version of this documentation.
  562.  
  563.  
  564. F9/F10 (Exit/Interrupt Drawing):
  565. ================================
  566.  
  567. F9 quits to DOS, to the directory last in the F1 area, when pressed
  568. with the REPP menu showing OR after the graphics image has been
  569. completed.  F10 works the same way, except during the draw (F2)
  570. function:
  571.  
  572. If F9 is pressed while the graphics picture is being drawn, REPP will
  573. return to the current menu screen.  So if you do not like how a
  574. graphics image is turning out, you do not need to wait for its
  575. completion before adjusting the contrast and trying again, for
  576. example.  If you use F10, REPP will return to the menu screen, but
  577. NOT show the contents of the current directory.  (Useful if a snoop
  578. is in the area.)
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                   Page 10
  591. An Example:
  592. ===========
  593.  
  594. On the distribution disk is a file called PHANTOM.PIC, a picture
  595. of an F-4 Phantom jet fighter.  The following will create an
  596. image of this craft:
  597.  
  598. Press F2 and key 'PHANTOM'.  (The .PIC suffix is assumed.)
  599. Press F7 enough times to bring up PALETTE 1.
  600. Press F5 enough times to select HORIZONTAL/EXACT.
  601.  
  602. Press F2 once.  This gives you a chance to change the picture
  603. file name.  Since it is correct, however, just press F2 -AGAIN-
  604. to indicate so, and the PHANTOM.PIC file will be analyzed for you.
  605.  
  606. After the analysis, press RETURN (or ENTER) to begin drawing the
  607. picture.  Note that PALETTE 0 is more becoming to living things
  608. while PALETTE 1 works best with objects.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                   Page 11
  650. +------------------+
  651. |                  |
  652. |  The UTIL Menu:  |
  653. |  ==============  |
  654. |                  |
  655. +------------------+
  656.  
  657.  
  658.                    --- Please note the following: ---
  659.  
  660. Although the interface that this Menu presents is similar to that of the
  661. REPP Menu, only the F2 option area is an activatable area.  In other words,
  662. the F3 and F4 entries are only data for the option you select while in
  663. the F2 area.  (This is further explained in the text which follows.)
  664.  
  665.                           --- End of Note ---
  666.  
  667. Once this Menu has been selected and the menu screen is showing,
  668. F1, F3 and F4 place the cursor into the associated keying
  669. area.  To leave an entry unchanged, press RETURN or another F-key
  670. WHENEVER the cursor is at the LEFT EDGE of the keying area.
  671.  
  672. F2 brings up a menu of available utility options.  After selecting
  673. the desired option using the up & down arrow keys, you can activate
  674. the option by pressing either RETURN or F2.
  675.  
  676.  
  677. F1 (Current Directory/Ambiguous File Name Specification):
  678. =========================================================
  679.  
  680. This works as in the REPP Menu.
  681.  
  682.  
  683. F2 (Selection of Utility Option):
  684. =================================
  685.  
  686. Once in the F2 area, thirteen different functions are available.
  687. Some of these functions require that an image already have been loaded
  688. into memory.
  689.  
  690. The option you desire is selected using the arrow keys and activated
  691. with RETURN or F2.  Any other F-key can be used to get out of the
  692. F2 function.
  693.  
  694. Beginning with REPP310, the PgUp and PgDn keys are available to
  695. skip two options at a time.  This permits you to get up and down the
  696. list of options more quickly.  Also, Home and End get you, respectively,
  697. to the Top and Bottom of the list.
  698.  
  699.     The Available Functions:
  700.  
  701.     00: Load Image or Slideshow File.  This option takes the file
  702.         specification located in the F4 area and, if an .IMG file
  703.         or a supported Bload-type file, displays the image.  If a
  704.         SlideShow script, the script is enacted.  If a ReadMAC is
  705.         specified, it is shown.
  706.  
  707.  
  708.                                   Page 12
  709. F2 (cont'd.)
  710. ============
  711.  
  712.     01: Show Image in Save Area.  After an image has been placed
  713.         <In Save Area>, it can be redisplayed with this function.
  714.         NOTE:  If the last item you viewed was a ReadMAC, only the
  715.         portion of the ReadMAC on the screen at the time you exited
  716.         the ReadMAC viewer will be recallable using this option.
  717.         If you wish to see the entire ReadMAC again, just leave the
  718.         ReadMAC name in the F4 area and select Function 00 from
  719.         this list.
  720.  
  721.     02: Save Image in .IMG Format.  This option takes the file
  722.         specification in the F3 area and creates a .IMG file from
  723.         the image in the Save Area.
  724.  
  725.     03: Invert Curr Image Top/Bottom.  This flips the image in
  726.         the Save Area vertically.
  727.  
  728.     04: Invert Curr Image Left/Right.  This flips the image in
  729.         the Save Area horizontally (makes a mirror image).
  730.  
  731.     05: Convert Curr Image->Palette 0.  This just displays the
  732.         current Save Area image using Palette 0.
  733.  
  734.     06: Convert Curr Image->Palette 1.  And this displays the
  735.         current Save Area image using Palette 1.  This is usually
  736.         a better selection than simply using 05.
  737.  
  738.     07: Logical Cvt BW/Pal.1->Pal. 0.  This function logically
  739.         converts the gray shadings of Black & White and Palette 0
  740.         images into a 5-color Palette 0 image.  The image to be
  741.         converted must be <In Save Area>.  The fifth color, black,
  742.         is obtained by dithering red & green for the interference.
  743.         NOTE for ReadMAC conversions:  A very nice effect is possible
  744.         if you load a ReadMAC file, use the viewer's T option to
  745.         bring up the old-style double-wide image mode, compose the
  746.         image to your liking, and then use this 07 function on the
  747.         composed image, which would now be in the Save Area.
  748.         Try it.
  749.  
  750.     08: Convert Color Image -> B/W.  This function does a simple
  751.         convert of a Save Area image to Black & White.  Some
  752.         conversions may not yield particularly good results.
  753.  
  754.     09: Save Image as Standard BLOAD.  Instead of saving the image
  755.         in the Save Area as a .IMG file, it is saved as a straight
  756.         BASIC BLOAD.  This means that any color information will
  757.         be lost.  A proper file specification must be in the F3 area.
  758.  
  759.     10: Load TRS Model 4 HiRes Image.  The TRS 80 Model 4 image is
  760.         loaded using the file specification in the F4 area.  Each
  761.         5th & 6th line-pair is combined to compress the 240-line
  762.         image to 200 lines.
  763.  
  764.  
  765.  
  766.  
  767.                                   Page 13
  768. F2 (cont'd.)
  769. ============
  770.  
  771.     11: Print Image OKWriter/ML92-93.  This option takes the image
  772.         in the Save Area and prints it on an Okidata(R) printer that
  773.         supports Okigraph(R) graphics.  This is a goody for folks
  774.         that do not have PC-compatible graphics printers.  A dip-
  775.         switch setting in an 82A with OKWriter(TM) roms may need to
  776.         be set to ML92/93 line-feed mode for this work properly.
  777.  
  778.     12: Clean Up Printer Art/Text.  This is the only option that
  779.         does not work with bit-image files.  For this option, F3
  780.         contains the name of an input file, and F4 contains the
  781.         specification of an output file.  This function then makes
  782.         one pass of the file in F3 to analyze it, and then converts
  783.         it into a clean text file using the file name in F4.
  784.  
  785.         In other words, this functions as a general text scrubber
  786.         with usage outside the realm of just .PIC file cleanups.
  787.  
  788.         With this option, the following conversions are ALWAYS done:
  789.  
  790.             Tabs are expanded to blanks.
  791.             Premature ^Z (end-of-file) characters are made spaces.
  792.  
  793.         The following conversions, however, are prompted-for and
  794.         are optional:
  795.  
  796.             Leading Blank Lines can be removed.  This can shorten
  797.             a printer art file and cause better centering.
  798.  
  799.             Trailing Blank Lines can be removed.  This can save
  800.             disk space and, for printer art, cause better centering.
  801.  
  802.             Leftmost common blanks can be removed.  If all lines in
  803.             the F3 file have a number of leading blanks, these can
  804.             be trimmed.  Again, this saves disk space and leads to
  805.             better centering for printer art files.
  806.  
  807.             Lines' Trailing Blanks can be removed.  This saves
  808.             disk space and leads to better centering of art files.
  809.  
  810.             High Bits (bit 7) can be turned off.  Useful with
  811.             WordStar(R) files and files that have been corrupted.
  812.  
  813.             Control Characters less than 20h (i.e., space) can be
  814.             converted to spaces.  Only BACKSPACE, TAB, LF, FF, and CR
  815.             are permitted to remain.  Again, useful with trashed
  816.             files or files with transmission errors.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                   Page 14
  827. F3 (Specifying a Save-To File):
  828. ===============================
  829.  
  830. This works just like the F3 area in the REPP Menu, except that
  831. activation of the save requires a selection from the F2 options
  832. list.
  833.  
  834.  
  835. F4 (Recalling a Saved Image or SlideShow Script):
  836. =================================================
  837.  
  838. This works just like the F4 area in the REPP Menu, except that
  839. activation of the save requires a selection from the F2 options
  840. list.
  841.  
  842.  
  843. Activating F2:
  844. ==============
  845.  
  846. To execute an F2 option after all necessary data has been provided
  847. in the F1 and/or F3 and/or F4 areas, simply press F2, select the
  848. option with the arrow keys, PgUp, PgDn, Home or End, and then press
  849. RETURN or F2 to activate.
  850.  
  851. UPON COMPLETION OF AN F2 FUNCTION, SOME MUSICAL NOTES WILL PLAY.
  852. FOR GRAPHICS-DISPLAY FUNCTIONS, THIS METHOD OF INDICATING
  853. COMPLETION DOES NOT CLUTTER UP THE IMAGE WITH TEXT.
  854.  
  855. Note:  After a graphics image is completed, pressing any key (other
  856. =====  than F9 or F10) will return you to the menu screen.  If you
  857.        press F9 or F10 (see below) you will return to DOS.
  858.  
  859. Note:  If you are viewing a ReadMAC, press ESC or RETURN to return
  860. =====  to the menu screen.  Pressing F9 or F10 will return you to DOS.
  861.  
  862.  
  863. F5 (Framing), F6 (Sizing), F7 (Contrast/Color Palette):
  864. =======================================================
  865.  
  866. F5, F6 & F7 are not used in the UTIL menu.
  867.  
  868.  
  869. F8 (Help):
  870. ==========
  871.  
  872. F8 displays an abbreviated version of this documentation.
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                   Page 15
  886. F9/F10 (Exit/Interrupt Drawing):
  887. ================================
  888.  
  889. F9 quits to DOS, to the directory last in the F1 area, when pressed
  890. with the UTIL Menu showing OR after the graphics image has been
  891. completed.  F10 works the same way, except during a lengthy F2
  892. function:
  893.  
  894. If F9 is pressed while the F2 function is being processed, UTIL will
  895. return to the current menu screen.  So if you do not like how a
  896. graphics image is turning out, you do not need to wait for its
  897. completion before trying something else.  If you use F10, UTIL will
  898. return to the menu screen, but NOT show the contents of the
  899. current directory.  (Useful if a snoop is in the area.)
  900.  
  901.  
  902. An Example:
  903. ===========
  904.  
  905. An Example of UTIL Menu usage:
  906.  
  907. On the distribution disk is a file called DRAGON.IMG, a picture
  908. of a rather bored-looking dragon.  Unfortunately, the dragon is
  909. upside down.  The following will get the .IMG file, invert the
  910. poor dragon, and save him (or her?) in an upright position:
  911.  
  912. Press F4 and key DRAGON.  Hit RETURN (the .IMG suffix is supplied
  913. automatically).  Press F3 and key DRAGON2.  Again, the file exten-
  914. sion is supplied.
  915.  
  916. Now Press F2.  Since the selected option is already "Load Image",
  917. just press RETURN.  DRAGON.IMG will be loaded and displayed.
  918. After the display finishes, press any key (other than F9/F10) to
  919. get back to the Menu.
  920.  
  921. Press F2 again, and use the arrow keys (which wrap, top/bottom,
  922. by the way) to select "Invert Curr Image Top/Bottom".  Press
  923. RETURN.  The Image will be inverted.
  924.  
  925. Get back to the Menu and press F2 again.  Select "Save Image in
  926. .IMG Format" and press RETURN.  DRAGON2.IMG will be saved.
  927. By now you get the idea.  Try re-loading DRAGON2 for practice.
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.                                   Page 16
  945. +----------------------------+
  946. |                            |
  947. |  The YAMP ReadMAC Viewer:  |
  948. |  ========================  |
  949. |                            |
  950. +----------------------------+
  951.  
  952. REPP310 incorporates the functions of the YAMP 2.1 ReadMAC viewer.
  953. The YAMP program ("Yet Another MAC Program") is a ReadMAC viewer which
  954. has been painstakingly optimized for the display of ReadMACs on CGA
  955. monitors.  If you request a .MAC file to be viewed, either in the
  956. REPP Menu or the UTIL Menu, the YAMP viewer will be invoked.
  957.  
  958. After returning from the YAMP viewer, the last screen image displayed
  959. will be placed <In Save Area> for further processing or re-viewing.
  960.  
  961. While in the YAMP viewer, F1 or F8 bring up a help menu.  F1 was the
  962. original key used by YAMP; F8 was added to be consistent with the
  963. REPP and UTIL menus.
  964.  
  965. Note that, in giving the ReadMAC viewer commands, lower-case keys
  966. work just as well as upper-case.
  967.  
  968. The following functions are available:
  969.  
  970.     .  You can scroll the image with the Arrow Keys and PgUp and PgDn.
  971.  
  972.     .  The Home key brings you to the top of the image, and the
  973.        End key puts you at the bottom of the image.
  974.  
  975.     .  Ctrl-Left Arrow aligns you with the left edge of the image, and
  976.        Ctrl-Right Arrow aligns you with the right edge of the image
  977.        (especially useful in the double-wide modes).
  978.  
  979.     .  "V" toggles between 1/2-vertical & normal modes.  Because of the
  980.        number of vertical scan lines on the CGA display (200) as opposed
  981.        to the number of lines on the Macintosh (350 or so), the image on
  982.        the CGA will appear elongated.  Cutting the image in half restores
  983.        the aspect ratio but loses you some detail.
  984.  
  985.     .  "H" toggles between enhanced-dbl-wide & normal modes.  Another way
  986.        to get around the elongation problem is to make the ReadMAC image
  987.        twice as wide on the CGA screen.  This means you will now have to
  988.        scroll sideways to view the entire image, but you will not lose
  989.        any detail.  However, the image may appear grainy.  This enhanced
  990.        double-wide mode has been set up to reduce the graininess where
  991.        possible.  See also the next option.
  992.  
  993.     .  "T" toggles between original-dbl-wide & normal modes.  "T" is the
  994.        original way in which most ReadMAC viewers created a double-wide
  995.        mode.  It is still useful with the UTIL Menu colorization options,
  996.        as these options (especially option 07) work better with an image
  997.        captured from a "T" double-wide mode as opposed to an "H" double-
  998.        wide mode.
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                   Page 17
  1004.     .  "S" begins a sequence of 1/2-vertical "Smart" modes.  Keying "S"
  1005.        again & again toggles between 5 contrast settings.  These modes
  1006.        are similar to the "V" mode but use extra algorithms to enhance
  1007.        the image.  You get out of the "S"mart modes by choosing another
  1008.        mode, such as "H", "V", "P" (see below), or "N" (for normal mode).
  1009.  
  1010.     .  "P" begins a sequence of 1/2-vertical Palette-1 colorizations.
  1011.        Pressing "P" again & again toggles between 5 contrast settings.
  1012.        "P" modes function like the "S" modes above.  Again, get out the
  1013.        "P" modes by choosing another mode (H,V,N,S).
  1014.  
  1015.     .  "I" simply inverts the image top-to-bottom.
  1016.  
  1017.     .  "M" mirrors the image.  (Inverts left-to-right.)
  1018.  
  1019.     .  "L" toggles between Landscape and Portrait views of the image.
  1020.        The Portrait (or vertical) view is the normal view.  The Landscape
  1021.        (or horizontal) view is created by this option the first time
  1022.        this option is selected for a particular image.  Thereafter, access
  1023.        to the Landscape view of an image is practically instantaneous.
  1024.        Note that the Portrait and Landscape views of an image are
  1025.        independent images.  That means you can manipulate one image
  1026.        without affecting the other, and when you toggle between the
  1027.        images, you will always return to where you left off with an
  1028.        image, and return to the display mode in which you were with
  1029.        that image.
  1030.  
  1031.     .  "D" just reDisplays the current screen.  This is useful after the
  1032.        display of the help screen.
  1033.  
  1034.     .  "Z" applies a smoothing algorithm to the image.  Sometimes, after
  1035.        the creation of a Landscape version of a ReadMAC, a "striping"
  1036.        or "lined-up" effect will appear.  Smoothing will get rid of this,
  1037.        but we suggest trying the "S"mart modes on the image first.
  1038.        This is because the "Z" function actually changes the image
  1039.        in memory, and if you have both Portrait and Landscape views,
  1040.        it changes them BOTH.  There are some exiguous technical reasons
  1041.        for this, which we will omit here.  See also the next option.
  1042.  
  1043.     .  "R" reloads the image from disk.  If, after a smoothing function
  1044.        (the only function that actually modifies the image), you decide
  1045.        you would like the original image back, just press "R".  This keeps
  1046.        you from having to return to the REPP or UTIL menu screen to
  1047.        request a reload of the ReadMAC file.
  1048.  
  1049.     .  RETURN (ENTER) or ESC get you out of YAMP and return you to the
  1050.        REPP or UTIL menus.  The last view on the CGA screen will be
  1051.        captured and placed <In Save Area>.  Consistency note:  REPP, UTIL
  1052.        and YAMP were originally three different programs, so there are
  1053.        some inconsistencies in the user interface.  If you wish to use the
  1054.        same key to return to the REPP or UTIL menus after viewing any
  1055.        image, just use the RETURN (or ENTER) key.
  1056.  
  1057.     .  Effect of F9 and F10:  F9 and F10 work as if the image were always
  1058.        completely displayed, and return you to DOS.  This is because the
  1059.        grafting of YAMP onto REPP310 was not 100% transparent.  To hide
  1060.        the current screen on a temporary basis, see the following:
  1061.  
  1062.                                   Page 18
  1063.  
  1064.     .  "Ins" and "Del" are the "BOSS" keys for the YAMP viewer.  If you
  1065.        press these keys, they will show a normal screen on an apparently
  1066.        "hung" system.  No keystrokes will appear to work (besides Ctrl-
  1067.        Alt-Del, of course).  To get back to what you were viewing after
  1068.        the danger passes, press Ctrl-Home.
  1069.  
  1070. Extra note:  The smoothing routine (Z) turns out to be asymmetric in its
  1071. effect on the "S"mart and "P"alette modes.  This means that after
  1072. "smoothing" or colorizing, the "S"mart and "P"alette modes may differ
  1073. in their effect on an image that has been mirrored from one that has not
  1074. been mirrored.  Try it and see.
  1075.  
  1076.  
  1077. Slideshow Interface:
  1078. ====================
  1079.  
  1080. If you SHOW a ReadMAC file in a slideshow script file (.SHO), the normal
  1081. action by YAMP is to pan the image in Normal Mode (the unmodified elongated
  1082. image) from top to bottom.  However, you can optionally add YAMP keystroke
  1083. commands to the SHOW command.  Just follow the file specification with
  1084. one or more blanks, and enter the keystrokes:
  1085.  
  1086.         SHOW ESCHER.MAC SS260-
  1087.  
  1088. In the above example, the second of the 5 "S"mart modes is selected, and
  1089. 260 down-arrows follow.  (The 260 is a repeater count and "-" substitutes
  1090. for the down-arrow character, which cannot be easily entered into an
  1091. ASCII non-document script file.)
  1092.  
  1093. The following YAMP keystrokes and their slideshow equivalents are
  1094. supported:
  1095.  
  1096.         YAMP key       Slideshow character
  1097.         --------       -------------------
  1098.  
  1099.         Left Arrow             <
  1100.         Right Arrow            >
  1101.         Up Arrow               +
  1102.         Down Arrow             -
  1103.         Ctrl-Left Arrow        ^<       (use the "hat" above the "6" key)
  1104.         Ctrl-Right Arrow       ^>
  1105.         Home                   ^+
  1106.         End                    ^-
  1107.         PgUp                   '        (single quote mark, or apostrophe)
  1108.         PgDn                   ,        (comma)
  1109.  
  1110.         DHILMNPRSTVZ           same
  1111.  
  1112.         Not Applicable         W        inserts a single-second wait into
  1113.                                         the display
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.                                   Page 19
  1122.  
  1123. To repeat a command, just precede it with a replication count.  See the
  1124. following keystring:
  1125.  
  1126.         ss260-5w^+h>>>>260-5w
  1127.  
  1128. This string says: Smart Mode 2 (SS), Down Arrow 260 times (this views
  1129. a full ReadMAC 720-line image), Wait 5 seconds, go to the top of the
  1130. image (^+), go into double-wide mode (H), four Right Arrows, 260 Down
  1131. Arrows, and Wait 5 seconds.
  1132.  
  1133. Note that any wait you specify with the slideshow DELAY command will
  1134. also be taken at the end of the display of each image.
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.                                   Page 20
  1181. +--------------------+
  1182. |                    |
  1183. |  Technical Notes:  |
  1184. |  ================  |
  1185. |                    |
  1186. +--------------------+
  1187.  
  1188. The Saved .IMG files were created in the following manner:
  1189.  
  1190.     . First, the image in screen memory was moved to an array
  1191.       using the BASIC graphic GET command.
  1192.     . Various control information is appended to the end of
  1193.       the array (options set, original name of the file, etc.).
  1194.     . Finally, a BSAVE is issued on the ARRAY (not on the
  1195.       graphics memory).  This means you cannot directly BLOAD
  1196.       a REPP-format .IMG file to the screen memory and expect
  1197.       worthwhile results.
  1198.  
  1199. Regarding the COLOR Palettes:
  1200.  
  1201.     . Palette 0 is more becoming to human beings and animate
  1202.       objects.  Palette 1 is more becoming to things.
  1203.  
  1204.     . In Palette 0, an alternating grid of red and green dots
  1205.       is used to simulate a dark (black) background because of
  1206.       the visual interference pattern that is created when red
  1207.       meets green.  This is not perfect, but it is about the best
  1208.       one can do with just four colors.
  1209.  
  1210.  
  1211. +-------------------+
  1212. |                   |
  1213. |  Known Problems:  |
  1214. |  ===============  |
  1215. |                   |
  1216. +-------------------+
  1217.  
  1218. 1.  If the DELAY in a SlideShow Script is too short (say, 1 second),
  1219.     then it may be necessary to briefly HOLD DOWN the ESC key to
  1220.     break out of a REPEATed loop.
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.                                   Page 21
  1240. +--------------------+
  1241. |                    |
  1242. |  Upgrade History:  |
  1243. |  ================  |
  1244. |                    |
  1245. +--------------------+
  1246.  
  1247. THE FOLLOWING CHANGES & IMPROVEMENTS HAVE BEEN MADE IN REPP247 OVER REPP230:
  1248.  
  1249.      1.  A continuous beep-loop occurred if you changed directories
  1250.          and one or more requested files were no longer available.
  1251.          This has been fixed.  Now, if a file does not exist in
  1252.          the named directory, the file name is replaced with
  1253.          "NONE.PIC" or "NONE.IMG".
  1254.  
  1255.      2.  Root directories could sometimes cause incorrectly-
  1256.          constructed file names.  This has been fixed.
  1257.  
  1258.      3.  Keying has been disabled while certain time-consuming
  1259.          functions are performed.  (Important mainly if you are
  1260.          running REPP247 under an interpreter.)
  1261.  
  1262.      4.  At the start of the program, you can specify a "Quiet Mode"
  1263.          of operation.  BEEPs for file name errors and the music at
  1264.          the conclusion of the drawing of a picture will not sound.
  1265.  
  1266.      5.  DIMension statements have been moved to the front of the
  1267.          program; this permits compilation with QUICKBASIC 2.0.
  1268.          If you are going to compile REPP with QB 2.0, the following
  1269.          options are suggested:
  1270.  
  1271.                 qb repp247.bas /d /o /q /s /v /x;
  1272.                 link repp247.obj;
  1273.                 erase repp247.obj
  1274.  
  1275.      6.  Three utilities have been provided with REPP247:
  1276.  
  1277.          CVTBLOAD -- This converts a normal BSAVEd screen image
  1278.                      into a .IMG-type file viewable by REPP.
  1279.  
  1280.          CVTPAL1  -- This converts a Palette-1 .IMG file
  1281.                      into a Palette-0 .IMG file (i.e., from
  1282.                      cool colors into warm colors).
  1283.  
  1284.          CVTTABS  -- This expands tabs into spaces.  The expansion
  1285.                      occurs whether the tabs are within literals or not.
  1286.                      This is actually a general utility which can
  1287.                      be used for more than just converting printer art
  1288.                      containing tabs.
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                   Page 22
  1299. +--------------------+
  1300. |                    |
  1301. |  Upgrade History:  |
  1302. |  ================  |
  1303. |                    |
  1304. +--------------------+
  1305.  
  1306. THE FOLLOWING CHANGES & IMPROVEMENTS HAVE BEEN MADE IN REPP288 OVER REPP247:
  1307.  
  1308. 01.  An invalid file specification, or a specification that returns
  1309.      no files, no longer terminates the programs.  All file names
  1310.      entered in the course of using the programs are now automatically
  1311.      uppercased.  The ability to disable the directory display by
  1312.      placing "*" in the F1 area has been removed  (this is now done
  1313.      differently--just do not follow the directory path with a file
  1314.      specification).  The ability to display the default directory by
  1315.      placing a space in the F1 area is now superfluous, and has been
  1316.      removed.
  1317.  
  1318. 02.  The bit-translation table and help texts have been made external
  1319.      files.  This should permit more BASICA and GWBASIC interpreters
  1320.      to be able to run REPP288 and UTIL288 without running out of memory.
  1321.  
  1322. 03.  Superfluous redisplays of the current directory have been
  1323.      reduced or eliminated.
  1324.  
  1325. 04.  A "configuration section" now exists at the front of the source.
  1326.      .  Quiet Mode can now be made a default.
  1327.      .  The default directory for the REPPHELP.DAT, UTILHELP.DAT
  1328.              and REPPBITS.DAT files can now be specified.
  1329.      .  The initial directory for files to be displayed can now be
  1330.              made a default.
  1331.      .  If you are using a monochrome monitor, setting BWMON=YES should
  1332.              improve the display of the menu screen.
  1333.      .  The name of a .SHO-type script file can be specified on the
  1334.              command line (see later about scripts)
  1335.  
  1336.      If you compile the source with QuickBASIC 2.0 or later, you
  1337.      can specify the configuration information on the command line
  1338.      as follows:
  1339.  
  1340.         d> [path]REPP288 [/BWMON] [/QUIET] [/DDIR=reppdatpath]
  1341.                 [/IDIR=initialdirectory]
  1342.                 [/SHO=scriptfilespec]
  1343.  
  1344.      Items in square brackets indicate optional entries.  Entries,
  1345.      if coded, can be either in upper, lower or mixed case.
  1346.  
  1347.         For example:
  1348.  
  1349.                 d>\img\repp288 /quiet /ddir=\img
  1350.  
  1351.         The /ddir= parameter is required if the REPPBITS.DAT
  1352.         and REPPHELP.DAT files are not in the ROOT directory.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.                                   Page 23
  1358. 05.  The missing character at position 24,80 on the menu screen has
  1359.      been POKEd.
  1360.  
  1361. 06.  ON ERROR with RESUME has been improved so that a smaller .EXE
  1362.      module can be obtained with compilation by QuickBASIC 2.0 or later.
  1363.      The suggested compilation options are now:
  1364.  
  1365.           qb repp288.bas /d /e /o /s /w;
  1366.           link repp288.obj;
  1367.           erase repp288.obj
  1368.  
  1369. 07.  In the F1, F2, F3 and F4 areas, typing the entry and then pressing
  1370.      RETURN now activates that function.  This is more intuitive than
  1371.      doubling the pressing of F2, F3 and F4.
  1372.  
  1373. 08.  Text Error Messages have been added to the "beep" error indication.
  1374.  
  1375. 09.  The ability to retrieve direct BSAVEd screen memory has been added.
  1376.  
  1377. 10.  The ability to retrieve non-BASIC screen memory dumps has been added.
  1378.  
  1379. 11.  It is now possible to set up a script file which will give
  1380.      REPP288 or UTIL288 the ability to show .IMG or BLOADable files,
  1381.      one after the other, in slide-show format.  The show can run and cycle
  1382.      in an unattended manner, or it can be interrupted or run to conclusion
  1383.      after one pass through the various images.
  1384.  
  1385.      Note: the script file MUST have an extension of .SHO and be
  1386.            composed of only standard ASCII characters (for example,
  1387.            using WordStar(R) in Non-Document mode)
  1388.  
  1389. 12.  Line overprints are now supported in all modes, although
  1390.      in the color modes the overprinting may not work as expected.
  1391.      In the black and white modes, overprint support works very well.
  1392.  
  1393. 13.  The aspect ratio for horizontal mode, non-squeezed pictures
  1394.      has been improved; the images are no longer overly wide.
  1395.  
  1396. 14.  Tabs in picture files are now expanded "on-the-fly".  A separate
  1397.      detab conversion is no longer needed.
  1398.  
  1399. 15.  The source for REPP288.BAS now takes up about 500-600 bytes less
  1400.      space; this should permit it to be run by more BASICA or GWBASIC
  1401.      interpreters.
  1402.  
  1403. 16.  The functions once provided by the CVTTABS, CVTBLOAD and CVTPAL1
  1404.      utilities have been absorbed by the new program, UTIL288.EXE.
  1405.      CVTTABS, CVTBLOAD and CVTPAL1 are no longer distributed with
  1406.      the REPP package.
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.                                   Page 24
  1417. +--------------------+
  1418. |                    |
  1419. |  Upgrade History:  |
  1420. |  ================  |
  1421. |                    |
  1422. +--------------------+
  1423.  
  1424. THE FOLLOWING CHANGES & IMPROVEMENTS HAVE BEEN MADE IN REPP310 OVER REPP288:
  1425.  
  1426.  
  1427. Bug Fixes:
  1428. ----------
  1429.  
  1430. 01.  A potential system hang while processing the information in the F2 area
  1431.      has been fixed.
  1432.  
  1433. 02.  UTIL Menu option 12 (text scrubbing) would occasionally drop lines
  1434.      in the detrashing operation.  This has been fixed.
  1435.  
  1436. 03.  Some .PIC file widths were incorrectly calculated.  This has
  1437.      now been fixed.
  1438.  
  1439. 04.  Certain situations which would create zero-length files have been
  1440.      eliminated.
  1441.  
  1442. 05.  Not actually a bug, but just a note:  There exist one or more
  1443.      software packages that also use .IMG as an extension for their
  1444.      image files.  These files will likely not be in the same format
  1445.      as REPP-created .IMG files.  If you experience problems in viewing
  1446.      an .IMG file, this may be the problem.
  1447.  
  1448.  
  1449. Minor Changes:
  1450. --------------
  1451.  
  1452. 01.  REPPBITS.DAT is no longer needed.  This information has been
  1453.      incorporated into the program.
  1454.  
  1455. 02.  Pixel display has been accelerated.
  1456.  
  1457. 03.  REPP now comes up in the current directory and no longer comes
  1458.      up in the root if the /IDIR= command-line parameter is not specified.
  1459.  
  1460. 04.  A drive letter can now be attached to the CHDIR slideshow command
  1461.      and to the specification in the F1 areas of the menus.
  1462.  
  1463. 05.  Hidden directories can be accessed by REPP.  To create the
  1464.      little triangle character, hold down the Alt key, press 127
  1465.      on the numeric keypad, and then let the Alt key up.
  1466.  
  1467. 06.  The Palette 0 and Palette 1 color palettes have been slightly improved.
  1468.      This improvement will even be visible with existing .IMG files.
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.                                   Page 25
  1476. Major Changes:
  1477. --------------
  1478.  
  1479. 01.  UTIL288 functions have now been incorporated into REPP310.  Separate
  1480.      programs no longer exist.  To toggle between the Menus, use alt-M.
  1481.  
  1482. 02.  YAMP 2.1, a ReadMAC viewer optimized for CGA displays, has been
  1483.      incorporated into REPP310.  Further, the slideshow SHOW command
  1484.      can now contain keystrokes to be passed to YAMP if a ReadMAC
  1485.      file is specified as the file to be shown.
  1486.  
  1487. 03.  Registration of users for REPP310 is no longer sought, and distribution
  1488.      of the sources for the programs is no longer being done.  This is
  1489.      not because the sources contain such secret techniques, but because
  1490.      this enhanced program now contains assembly-language subroutines that
  1491.      use a customized macro library, and providing an assemble-able and
  1492.      compilable source is now just too complex an issue.
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.                           --- End of Document ---
  1531.  
  1532.  
  1533.  
  1534.                                   Page 26
  1535.