home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / acc / general / d_viewer.txt < prev    next >
Text File  |  1990-12-31  |  8KB  |  157 lines
  1.                        D_Viewer (aka - Don's Viewer)
  2.  
  3.     D_Viewer is a simple text viewer with a couple of twist. The idea for
  4. the program came from the Amiga world and since the St did not have any-
  5. thing like it, figured it was time we did (with a few added options of
  6. course). The twists or main features of the program are:
  7. 1) To be able to view files without useing the keyboard or holding down
  8.    mouse buttons.
  9. 2) Smooth scroll the text so that it is easy to read and be able to adjust
  10.    the speed of the scroll to a comfortable reading speed.
  11.  
  12.     D_Viewer is released as Freeware, so if you like it, please share it
  13. with as many folks as you can. The program was developed on a stock 1040
  14. monochrome system (with a screen accelerator) and does work in medium rez.
  15. It has not been tested on Ste's or TT's and not sure how it will work with
  16. a blitter chip.
  17.     The program has been keep pretty simple, because the routines will
  18. replace the 'viewer mode' in Dterm. Simple means that there are no dialog
  19. boxes, info-lines or on-line help screens. Simple does not mean the lack
  20. of search routines, block settings, page marks and the ability to save,
  21. print or load. D_Viewer can also be run as an accessary by replacing the
  22. .PRG extender with .ACC and run from the root directory on the boot drive.
  23. For those that care, D_Viewer was written in assembler.
  24.  
  25.                                             Enjoy...  Don Pefley (2/1/91)
  26.  
  27.  
  28.                    Commands and 'How to Use' D_Viewer
  29.  
  30.     Once a file has been loaded, the screen is divided up into 3 equal
  31. horizontal areas. The top and bottom areas are sub divided into 5 zones,
  32. each with their own scrolling speed. The closer you get to the screen
  33. boundary, the faster the scoll. Needless to say, the top area moves towards
  34. the top of the file and the bottom area moves towards the end of the file.
  35. The middle area is neutral and all scrolling will stop.
  36.     To start scrolling the file, move the mouse into a zone and sit back
  37. and read. To adjust the speed of the scroll, move the mouse again. Towards
  38. the middle of the screen will slow the scroll, while moving away from the
  39. middle area will speed it up.
  40.  
  41. Mouse Buttons -
  42.     The left mouse button is used for advancing a 'page' at a time. The
  43.     speed and direction of the page depends on the zone that you are in.
  44.  
  45.     The right mouse button is used for 'block' settings. See below for more
  46.     info.
  47.  
  48.     Both mouse buttons at the same time will move you immediately to the
  49.     top or bottom of the file, depending on which area that you are in.
  50.  
  51. Keyboard commands -
  52.     Note: If you are scrolling, the keyboard commands will not act until
  53.     the current character line has been completely drawn to screen.
  54.     Keyboard commands can be entered in either upper or lower case.
  55.  
  56. Help - small alert box to load another file, quit the viewer or just exit
  57.     (return) to the file that you are already viewing.
  58. Undo - immediately quit the program and return to Desktop
  59. UP arrow key - scroll 1 line towards top of file
  60. DOWN arrow key - scroll 1 line towards bottom of file
  61. U - move 1 page towards top of file
  62. D - move 1 page towards bottom of file
  63. T - move immediately to the begining of the file
  64. B - move immediately to the end of the file
  65. * - toggle smooth (mouse) scrolling on/off. Default is ON - will smooth
  66.     scroll.
  67. F - search (find) prompt (see below)
  68. N - find next occurence of search
  69. P - back up to the previouse find
  70. M - move immediately to the start of a valid block
  71. 1,2,3,4 - jump to a page mark
  72. Clr Home - clear all page marks (does not remove block marks)
  73. F1 - set a page mark or the begining of a block
  74. F2 - set end of block
  75. F5 - block alert to print or save the block or just return to the file
  76. F7 - alert box to configure the printer - normal, italics or condensed
  77. F10 - toggle the search mode from case dependent to NOT case dependent.
  78.     Default is not dependent.
  79. CapsLock - stop scroll until CapsLock hit again
  80. Alternate - pause scroll until released
  81.  
  82.  
  83.                            Block Commands
  84.  
  85.     Blocks are controlled by the right mouse button. Pressing and HOLDING
  86. the right mouse button will show the mouse pointer allowing you to move it
  87. anywhere on the screen. Once the right button is released, you will have a
  88. blinking cursor. This locating can be used for a block mark or page mark.
  89. F1 will set this location to a page mark AND the start of a block. F2 will
  90. set this location to the end of a block. If you hit the right mouse button
  91. again, the cursor will be removed and no page or block marks will be set.
  92.  
  93.     Note: In scrolling mode, the right mouse button canbe used to pause
  94. the scroll and by hitting the right mouse button again, the scroll will
  95. resume at the same speed and direction.
  96.  
  97.     The block maybe any size that you like, spanding any number of pages.
  98. The end of the block maybe set before the start of the block if you like.
  99. Once a valid block has been set, the whole block will appear in inverse
  100. mode. The block canbe released by either setting a new end mark before
  101. the begining of the current block or a new start mark after the current
  102. end point (same as GenSt). Also note that the end block is 1 character
  103. before the cursor, in other words, where the currsor is setting is NOT the
  104. true end of the block (also the same as GenSt).
  105.     Once a valid block has been marked, it can be saved to disk (via the
  106. file selector) or dumped to printer by hitting F5. You will be warned if
  107. the printer is off-line if you try to print. Only one valid block canbe
  108. set at any given time.
  109.     Warning! - do NOT set a block mark in the middle of a tab. D_Viewer
  110. uses true tabs and unpredictable marks will be set if you do.
  111.  
  112.  
  113.                            Search Commands
  114.  
  115.     F10 will toggle the search from case dependent to not case dependent.
  116. Not case dependent is about 30% slower than a dependent search but not
  117. having to worry about caps makes searchs a little easier. Default at boot
  118. up is for not dependent. Hitting the F key will bring up a prompt line for
  119. the string that you would like to search for. Up to 20 characters are
  120. allowed. The return key will end the string input and start the search. If
  121. a match is found, the whole screen will be redrawn at that line with the
  122. the match shown in inverse video, unless the match is in a block, then it
  123. will be shown in normal video.
  124.     All searches are performed from the current top of screen line and go
  125. towards the end of the file. The next occurence of a search canbe found
  126. with the N key. You may backup to a previous match but this only goes 1
  127. place backwards.
  128.     You will be warned if there are no matches or the last match in the
  129. file has been found. If there is more than 1 match found in the last
  130. screen of the file, only the first one will be high lighted.
  131.  
  132.  
  133.                                  Page Marks
  134.  
  135.     You can have up to 4 page marks at any given time. The marks are stored
  136. in a circle pattern, mening that on the 5th mark, the 1st mark is replaced
  137. with the 5th, the 6th replaces the 2nd, ect.
  138.     Page marks are set with the right mouse button and the F1 key. Place the
  139. cursor where you want and hit F1. To jump to the page marks, use the number
  140. keys 1,2,3 or 4. All page marks canbe removed via the Clr Home key.
  141.  
  142.  
  143.                                  Final Comments
  144.  
  145.     The smooth scroll of D_Viewer works by moving the screen by raster
  146. lines. If you have a screen accelerator - use it and help the poor cpu out
  147. some. On the other hand, a color monitor only has half as many raster lines,
  148. therefore the scroll is twice as fast. All I can say is play around to see
  149. what looks best to you.
  150.     Remember that the program can run as an ACC by changing the extender.
  151. I also have a version of D_Viewer that runs from the auto folder (like
  152. DCShow_It) that installs in place of the Show option of the DeskTop. But
  153. at this time is still abit buggy and do not like the way that some other
  154. auto run programs can steal the vectors needed.
  155.     All in all, it is nice to see smooth scrolling on my old friend, the
  156. 1040 St...                                            Don
  157.