home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / PROGRAM / PASCAL / PAVT199 / DIST / DISK150.EXE / A2AVT210.ZIP / ANS2AVT.DOC next >
Text File  |  1991-04-30  |  10KB  |  202 lines
  1.  
  2.  
  3.  
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.                                      ANS2AVT
  14.                                   Version 2.10
  15.                          Copyright (c) 1991, Greg Smith
  16.         
  17.                        ANSI to AVATAR level 0+ converter.
  18.         
  19.         
  20.         
  21.         
  22.         
  23.         
  24.         
  25.         
  26.         Introduction --
  27.         
  28.              "What  is ANS2AVT?"  You may ask.  ANS2AVT is part of a  new 
  29.         breed  of  software.  It will convert any  file  containing  ANSI 
  30.         escape  codes into an equivalent file containing  Avatar  control 
  31.         codes.    The   main advantage of Avatar over ANSI  is  that   it  
  32.         requires   less   disk space.  Allowing the control codes  to  be 
  33.         sent  over  a modem much faster.  Although Avatar is not in  wide 
  34.         spread use  as of  this writing, many more Bulletin Board Systems  
  35.         are  supporting  it.  Within a few years it is entirely  possible 
  36.         that  it will replace ANSI!
  37.         
  38.         Liability --
  39.         
  40.              By using this product, you agree to take full responsibility 
  41.         for any damages or consequences of ANS2AVT's use or misuse.   You 
  42.         agree that in now way, manner, or form I can be held  responsible 
  43.         for  damages  caused by this product.  If you do not  agree  with 
  44.         this,  do not use it.  Furthermore, if you continue to  use  this 
  45.         product   for more than thirty days, you must register   it.  See 
  46.         the  registration  section at the end of this document  for  more 
  47.         details.
  48.         
  49.  
  50.         Usage --
  51.         
  52.              The use of this program should be straight forward, but  for 
  53.         those  of  you  who like to read the documentation  here  it  is.  
  54.         ANS2AVT  is meant to be used as a command line program.   It   is 
  55.         designed to accept multiple command line parameters as follows:
  56.         
  57.         ANS2AVT [options] Ansi_File(s) [Avatar_File[.avt]] [options]
  58.         
  59.              Only  the  ANSI file name is required for the conversion  to 
  60.         work,  but  an Avatar file can be specified if no  wildcards  are 
  61.         used.  Options  are, as  you might expect, optional.  The follow-
  62.         ing is a list of  command  line options, and their usage.  Param-
  63.         eters  may  be  prefaced with either a "/" or a "-" and  are  not 
  64.         case sensitive.
  65.         
  66.              -c   Disable Avatar RLE compression.
  67.                   This  is a fairly straight  forward option.  In  short, 
  68.                   it turns  the  default Avatar RLE compression off.  The 
  69.                   only  time  this  should be needed  is  if  compression 
  70.                   causes  an animated sequence to be displayed too  fast.  
  71.                   Otherwise  it will often decrease the size of the  file 
  72.                   significantly!
  73.         
  74.              -a   Keep delays embedded in ANSI for animation.
  75.                   This  is useful for ANSI files that might  have  delays 
  76.                   embedded within them for slowing animation.  The delays 
  77.                   are normally discarded in the conversion process.
  78.         
  79.              -w#  Set width of animation screen to # (40-132) default 80.
  80.                   This  parameter  allows  you to set the  width  of  the 
  81.                   screen your ANSI file would normally be displayed on. I  
  82.                   have included this for configurability, but you  should 
  83.                   never need to change it from eighty columns wide.
  84.         
  85.              -l#  Set length of animation screen to # (10-80) default 25.
  86.                   This parameter is similar to the last one, but  instead 
  87.                   it  sets  the length of the screen that the  ANSI  file 
  88.                   would  normally be displayed on.  Normally  you  should 
  89.                   not need to change this, but I will leave it up to  you 
  90.                   to experiment with it.
  91.         
  92.              -n   Add a clear screen code to the start of the file.
  93.                   This  is useful for bulletins or colored text  displays 
  94.                   and  other  non-animated graphics.   Not  clearing  the 
  95.                   screen  will  make alphabet soup out of  many  animated 
  96.                   sequences, yet most animators seem to include the clear 
  97.                   screen in the ANSI itself.  If a screen doesn't convert 
  98.                   properly, try this option first.
  99.         
  100.  
  101.         
  102.         Registration --
  103.         
  104.              This  product is being distributed under the Shareware  con-
  105.         cept.  After 30 days, you should either register this product  or 
  106.         remove it from use.
  107.              There are two types of registrations available; the  current  
  108.         and the lifetime.  The lifetime registration is US $25 and  enti-
  109.         tles  you  to "free" upgrades by sending in a blank disk  and  US 
  110.         $2.00  for postage.  The current registration on the  other  hand 
  111.         costs  US $14 entitling you to receive only the latest   version.  
  112.         All  registered users will be mailed notices concerning  the  re-
  113.         lease of any major upgrades.
  114.              To register send the appropriate check or money order to the 
  115.         following address:
  116.         
  117.               Greg Smith
  118.               Ans2Avt Registration
  119.               4422 Pali Way
  120.               Boulder, CO. 80301 USA.
  121.         
  122.         Please  make  all checks payable to Gregory P. Smith.   Also,  be 
  123.         sure to include your name, address, and phone number for informa-
  124.         tion  on  future  releases.  Please add US $2.00  for  the  disk, 
  125.         postage  and handling if you wish to receive the  latest  version  
  126.         with  your  own registration number installed and  the  shareware  
  127.         notice removed.
  128.         
  129.  
  130.  
  131.         What to do about errors or files that won't convert:
  132.         
  133.              If you encounter any errors in the program or any ANSI files 
  134.         that   simply won't convert correctly, please contact me  at  the 
  135.         registration address or any of the locations listed at the end of 
  136.         this  file.  If a program error occurs, please include the  error 
  137.         number, the command line parameters, your computer setup, and the 
  138.         error address.  If possible I would like a copy of the file  that 
  139.         the error occurred on.
  140.         
  141.         Last minute additions and troubleshooting tips:
  142.         
  143.              As  Avatar  is not a text based terminal, you will  get  the 
  144.         best  results  by saving your ANSI file with  an  unlimited  line 
  145.         length, as this will decrease the size dramatically.
  146.              The AvtType utility provided with this package is free.  Use 
  147.         it to type Avatar files to the screen, it should be self explana-
  148.         tory.   If  you are using any type of Avatar device  driver,  you 
  149.         will probably find that many Avatar files won't work when issuing 
  150.         the  type command.  This is due to dos's filtering out  and  pre-
  151.         processing  (cooking) of control characters.  Try issuing a  dif-
  152.         ferent  command  such  as: copy /b avtfile.avt  con.   This  will 
  153.         bypass  the "cooked" mode which dos types files in.  NOTE:   With 
  154.         the  Avatar.Sys driver provided in AVT1CON.ZIP, George  has  also 
  155.         provided  a special utility for typing Avatar files  without  the 
  156.         garbage caused by cooked mode.
  157.         
  158.         
  159.         Coming Soon To A Terminal Near You:
  160.         
  161.              Future versions of ANS2AVT may include these new features:
  162.         
  163.                       * The ability to strip end of line clutter found
  164.                         in ANSI files saved with more than one line.
  165.                       * The ability to convert Avatar files back into
  166.                         their ANSI counterparts.
  167.                       * Avatar's pattern repetition compression could
  168.                         reduce the file size even more!
  169.                       * Avatar level 1 console (AVT/1) support
  170.                       * And much more. . .
  171.         
  172.         
  173.         
  174.                                                 Greg Smith
  175.                                                 April 30, 1991
  176.         
  177.   
  178.  
  179.         If  you find any bugs or problems with this program, please  con-
  180.         tact  me  via U.S. Snail Mail, or at one of the  following  loca-
  181.         tions:
  182.         
  183.                   UseNet:    Greg.Smith@bohemia.metronet.org
  184.                              ncar.UCAR.EDU!boulder!bohemia!Greg.Smith
  185.                   FidoNet:   Greg.Smith@1:104/477
  186.                              Greg.Smith@1:104/441 or 469
  187.                              Greg.Smith@1:104/120
  188.                   PcRelay:   ->BOREALIS
  189.                   BBSes:     CMOS BBS line 1 at (303)-322-4078(*)
  190.                              CMOS BBS line 2 at (303)-320-4125(*)
  191.                              Bohemia BBS at (303)-449-8946 (my bbs)
  192.                              Jag's Networking Labs at (303)-377-2371(*)
  193.         
  194.         (*) The latest version of ANS2AVT can be f'reqed through  FidoNet 
  195.         at the following addresses by using the magic name ANS2AVT or the 
  196.         file  name A2AVTnnn.ARJ where nnn is the version number.   (Using 
  197.         wildcards may get you more than the most recent version.)  
  198.         
  199.         1:104/441 or 469
  200.         1:104/477
  201.  
  202.