home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d105 / record-replay / readme < prev    next >
Text File  |  1987-10-25  |  6KB  |  168 lines
  1. /**********************************************************************/
  2.                            RECORD-REPLAY
  3.                            version 2.0
  4.                            By: Alex Livshits
  5.                            20-Sep-87
  6. /***********************************************************************/
  7.  
  8.          THIS IS NEW UPDATED VERSION OF RECORD-REPLAY
  9.          ---------------------------------------------
  10.  
  11.     The RECORD was heavily modified and now should be much more reliable
  12.     then the previous release (on FISH disk 95).
  13.     New features added for RECORD and for REPLAY.
  14.  
  15.  
  16. IMPORTANT
  17. ---------
  18.     Record & Replay can be freely distributed provided the Copyright notice
  19.     is intact and no charge for them or for their use is made without
  20.     written permission of the author.
  21.  
  22.     RECORD-REPLAY are SHAREWARE programs. Please, send 15$ to the author
  23.     if you feel his effort worth it.
  24.  
  25.  
  26. RECORD
  27. ------
  28.          Record picks up all input events (mouse and keyboard) and saves
  29.          them to a file ( 10 bytes per event ). It should be started from
  30.          CLI by:
  31.          RUN Record <file name> [-options,,].
  32.          Where:
  33.             - <file name>   valid DOS file name.
  34.             - options:
  35.  
  36.                     -i  ->  start recording immediately (don't wait ALT-P).
  37.                             Default: wait for ALT-P.
  38.  
  39.                     -b# ->  number of events in memory buffer before
  40.                             writing them to the file. The number you can use
  41.                             depends on amount of free memory you have.
  42.                             When this buffer is full, the Record blocks all
  43.                             new input while writing it out.
  44.                             Default value is 1000.
  45.  
  46.                     -a  ->  append events to an existing file.
  47.                             Default: create file <file name> anew.
  48.  
  49.  
  50.         If option -i is not used, the record will start when
  51.         you press keys ALT and 'P' simultaneously.
  52.  
  53.         To stop recording press ALT and 'F' keys together.
  54.  
  55.  
  56. EXAMPLES
  57. --------
  58.  
  59.             RUN Record ram:x
  60.                 Will:
  61.                     1)  create NEW file ram:x.
  62.                     2)  Allocate memory buffer for 1000 events.
  63.                     3)  wait for ALT-P to start recording.
  64.                     4)  write events to ram:x.
  65.  
  66.             RUN Record ram:x -i -b2300
  67.                 Will:
  68.                     1)  create NEW file ram:x.
  69.                     2)  Allocate memory buffer for 2300 events.
  70.                     3)  start recording immediately
  71.                     4)  write events to ram:x.
  72.  
  73.             RUN Record ram:x -ia
  74.                 Will:
  75.                     1)  open EXISTING file ram:x.
  76.                     2)  Allocate memory buffer for 1000 events.
  77.                     3)  start recording immediately
  78.                     4)  write events at end of ram:x.
  79.  
  80.  
  81.  
  82. REPLAY
  83. ------
  84.          Replay reads the file created by Record and sends the events back
  85.          to the input stream. All mouse and keyboard activity that was
  86.          recorded previously is reconstructed. Replay is launched from
  87.          CLI by:
  88.             RUN Replay <file name> [-options,,]
  89.             Where:
  90.             - <file name>   previously 'Recorded' file.
  91.             - options:
  92.  
  93.                     -i  ->  start replay immediately (don't wait ALT-P).
  94.                             Default: wait for ALT-P.
  95.  
  96.                     -b# ->  number of events in memory buffer before next
  97.                             read from the file. The number you can use
  98.                             depends on amount of free memory you have.
  99.                             Default value is 1000.
  100.  
  101.                     -d# ->  delay (in 20 msec) between events.
  102.                             This is directly related to speed.
  103.                             Value of 0 is fastest.
  104.                             Default: 0.
  105.  
  106.                     -o  ->  'replay' the file only once.
  107.                             Default: infinite loop
  108.  
  109.  
  110.         While in replay, all new inputs are rejected.
  111.         You can toglle replay ON/OFF by pressing ALT and 'P' keys together.
  112.  
  113.         If option -i is not used, the Replay will start when
  114.         you press keys ALT and 'P' simultaneously.
  115.  
  116.         To stop Replay press ALT and 'F' keys together.
  117.  
  118. EXAMPLES
  119. --------
  120.  
  121.             RUN Replay ram:x
  122.                 Will:
  123.                     1)  open file ram:x.
  124.                     2)  Allocate memory buffer for 1000 events.
  125.                     3)  wait for ALT-P to start replay.
  126.                     4)  no delay between events.
  127.                     5)  read events from ram:x, send them to input stream.
  128.                     6)  when EOF restart replay from the beginning.
  129.  
  130.             RUN Record ram:x -b2300 -oi -d3
  131.                 Will:
  132.                     1)  open file ram:x.
  133.                     2)  Allocate memory buffer for 2300 events.
  134.                     3)  start replay immediately.
  135.                     4)  delay of 3*20=60 msec between events.
  136.                     5)  read events from ram:x.
  137.                     6)  when EOF exit.
  138.  
  139.  
  140.  
  141. NOTES
  142. -----
  143.  
  144.    Record-Replay works fine with all of the AMIGA software that respects
  145.    multitasking and I had no problems using it with DPaint, PageSetter,
  146.    TextCraft etc.
  147.  
  148.    Make sure that the state of the software is exactly the same in
  149.    the beginning of record and of replay. Do not hurry! And specially
  150.    when opening icons, loading, writing or reading files, make pauses long
  151.    enough to compensate for longer file access in some cases etc.
  152.    Give system a time to breath.
  153.  
  154.  
  155.  
  156. CONTACT
  157. -------
  158.         Alexander Livshits,
  159.         15 rue Durantin,
  160.         75018 Paris,
  161.         FRANCE
  162.  
  163.  
  164.     Enjoy!
  165.  
  166.  
  167.  
  168.