home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / dos / 002 / scrollit.doc < prev    next >
Text File  |  1993-05-29  |  37KB  |  900 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                     SCROLLit
  10.  
  11.  
  12.                            Advanced ScrollBack Buffer
  13.  
  14.  
  15.  
  16.                                   Version 1.7
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                Copyright 1992-93
  27.                               All Rights Reserved
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                        By
  34.  
  35.  
  36.                           Bromfield Software Products
  37.                                  P.O. Box 70081
  38.                                 Ottawa, Ontario
  39.                                     K2P 2M3
  40.                                      Canada
  41.  
  42.  
  43.  
  44.  
  45.                              Compuserve 71054,3051
  46.  
  47.  
  48.        License
  49.  
  50.        SCROLLit  is  NOT free  software,  but  is  being distributed  as
  51.        "shareware".
  52.  
  53.        Non-registered  users  of this  software  are  granted a  limited
  54.        license to use this program for a trial period of thirty days for
  55.        the purpose  of determining  if SCROLLit  is  suitable for  their
  56.        needs.  At  the  end of  this  trial  period,  you should  either
  57.        register your copy or discontinue using SCROLLit.
  58.  
  59.        Whether or not you  register SCROLLit, we encourage you  to share
  60.        the unregistered  version of  the program  with your friends  and
  61.        colleagues and to upload it to  any BBS's you use. Please be sure
  62.        to keep all the files together; a complete list of  files appears
  63.        in README.DOC.
  64.  
  65.  
  66.  
  67.        Introduction - What is SCROLLit?
  68.  
  69.        SCROLLit is  a memory  resident (TSR)  program that captures,  in
  70.        full color,  the lines  of text  that scroll off  the top  of the
  71.        video  screen  and stores  them in  an  XMS, EMS  or conventional
  72.        memory 'scrollback' buffer  of a  size specified by  the user.  A
  73.        fast compression technique is  used to store more than  twice the
  74.        number of lines in the available buffer space. 
  75.  
  76.        SCROLLit  can  then be  activated or  'popped  up' over  any non-
  77.        graphical  program   by  pressing  the  scroll   lock  key.  Once
  78.        activated,  SCROLLit will let you  scroll back through this saved
  79.        information, line by line  or page by  page. SCROLLit has a  fast
  80.        search  capability as well  as a block-write  feature that allows
  81.        you  to mark  a block  of lines  for  writing to  a disk  file or
  82.        sending to your printer.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                        1
  107.  
  108.  
  109.        Capturing Lines
  110.  
  111.        Once resident,  SCROLLit monitors video activity  to capture text
  112.        lines  that are scrolled off the top  of the screen. You may wish
  113.        to look  back through the  output of the  DIR command in  DOS, or
  114.        review the progress of a Bulletin Board (BBS) session while using
  115.        your communications software, for example.
  116.  
  117.        A program can  scroll the  screen in three  ways: DOS  (interrupt
  118.        21h)  function calls,  BIOS (interrupt  10h) function  calls, and
  119.        direct  writing to video memory. SCROLLit is able to capture both
  120.        DOS and BIOS scrolling, but not the scrolling performed by direct
  121.        screen writing. Fortunately, many programs that use direct screen
  122.        writing  can be configured to use BIOS function calls. Appendix 1
  123.        describes how to reconfigure two popular  communications programs
  124.        (Qmodem and  Telix) to  use  BIOS scrolling,  rather than  direct
  125.        screen writing. 
  126.  
  127.        Some programs clear the  screen rather than scrolling  old output
  128.        off  the top  of the  screen. Monitoring  DOS and  BIOS scrolling
  129.        would not capture  this output because no scrolling  is involved.
  130.        To get around this problem, SCROLLit monitors BIOS 'clear-screen'
  131.        requests.  When a  clear-screen request  has been  made, SCROLLit
  132.        copies the entire screen to the scrollback buffer before the BIOS
  133.        clears  the  screen. As  a result,  you  will find  that SCROLLit
  134.        captures more output than most other scrollback buffer utilities.
  135.  
  136.        Disable Screen Capture Temporarily 
  137.  
  138.        SCROLLit's capturing of screen scrolling and clear-screens can be
  139.        temporarily disabled by typing:
  140.  
  141.                  SCROLLit /-
  142.  
  143.        Screen capturing can later be re-enabled with the /+ command line
  144.        switch.  It may  be  useful to  disable  screen capturing  before
  145.        executing a program that  generates a lot of scrolling  or clear-
  146.        screens, but that  you do  not wish captured  in your  scrollback
  147.        buffer. WordPerfect is a good example of this. In WordPerfect, as
  148.        you page  through your document, SCROLLit  would normally capture
  149.        each page into the scrollback buffer, potentially taking up a lot
  150.        of  buffer  space.  You  may   find  it  convenient  to   execute
  151.        WordPerfect using a simple batch file as follows:
  152.  
  153.                  CD\WP51
  154.                  CLS
  155.                  SCROLLIT /-
  156.                  WP51
  157.                  SCROLLIT /+
  158.  
  159.        SCROLLit  can still be popped  up when capturing  is disabled, so
  160.        that you can still  scroll back through lines that  were captured
  161.        before screen capture was disabled.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.                                                                        2
  168.  
  169.  
  170.        Compressing the scrollback buffer
  171.  
  172.        Each line that SCROLLit saves contains 80 characters and 80 color
  173.        attributes, requiring a  total of  160 bytes storage.  A full  25
  174.        line  screen  requires 4000  bytes  of  storage space.  There  is
  175.        usually a  lot of blank space on a screen, however, and the color
  176.        attributes are often  unchanged for  an entire line  of text  and
  177.        sometimes the whole screen. SCROLLit uses a very fast run-length-
  178.        encoded  compression  algorithm to  shrink  the  amount of  space
  179.        required to save a line of text and is typically able to compress
  180.        the scrollback  buffer by 60 to 70%, meaning that more than twice
  181.        the  number of  lines of  can be  saved in  the  available buffer
  182.        space.
  183.  
  184.        The  extent to  which  SCROLLit has  been  able to  compress  the
  185.        scrollback buffer is displayed when the help key (F1) is pressed.
  186.  
  187.                       ╒═════════════════════════════════╕               
  188.        For example:   │  Number of lines saved:  2046   │               
  189.                       │  Average bytes per line: 43     │               
  190.                       │  Percent compression:    73%    │               
  191.                       ╘═════════════════════════════════╛         
  192.  
  193.        There is some overhead in setting up the buffer, which means that
  194.        SCROLLit  will obtain  better  compression with  a larger  buffer
  195.        size.
  196.  
  197.  
  198.  
  199.        Installing and Unloading SCROLLit
  200.  
  201.        SCROLLit  is a memory resident (TSR) program that is installed in
  202.        memory  by typing  SCROLLit  followed by  the desired  scrollback
  203.        buffer  size in kilobytes. The buffer size  must be at least 20k.
  204.        For example, to install  SCROLLit with a 100k scrollback  buffer,
  205.        type:
  206.  
  207.                  SCROLLit 100
  208.  
  209.        You may wish  to store this command in your  autoexec.bat file to
  210.        ensure  that  SCROLLit  is  loaded  whenever  you  turn  on  your
  211.        computer. You  will need to  prefix the command with  the name of
  212.        the  directory where SCROLLit is  stored, or store  SCROLLit in a
  213.        directory that you have set in your path command.
  214.  
  215.        SCROLLit can be  unloaded from  memory with the  /U command  line
  216.        option, provided that other TSR's have not been loaded after it:
  217.  
  218.                  SCROLLit /U
  219.  
  220.        Installing  and unloading of  SCROLLit is this  simple. There are
  221.        other command line options that will be discussed throughout this
  222.        document.  A complete list of command line options is provided in
  223.        Appendix 3, and can be displayed by typing:
  224.  
  225.                  SCROLLit /?
  226.  
  227.  
  228.                                                                        3
  229.  
  230.  
  231.        Me