home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ansi / ansv30.zip / AV.DOC < prev    next >
Text File  |  1994-02-06  |  12KB  |  348 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                  ANSI View
  32.                                     3.0
  33.  
  34.                     Copyright 1993,94 Robert D. Bouman
  35.                             All Rights Reserved
  36.                              February 5, 1994
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43. License Information :
  44.  
  45. The ANSI View software package is NOT free.  You are expected to register
  46. your copy of ANSI View within 30 days or cease all use of software.
  47.  
  48. ANSI View is not to be included with any other software package unless
  49. permission is obtained in writing from the author.
  50.  
  51. You may freely distribute the shareware version of ANSI View (in fact I
  52. encourage it) as long as all files included in the official release of ANSI
  53. View are included (see README.1ST for files comprising the official release
  54. of ANSI View).  Shareware distributors may sell disks containing ANSI View
  55. as long as no fee is charged for the software itself, however, distribution
  56. fees and reimbursement for cost of media may be charged to end user as long
  57. as the fee does not exceed $5.00 (U.S. funds).
  58.  
  59. Warranty Information:
  60.  
  61. All measures have been taken to ensure that ANSI View is of the highest
  62. quality.  However, the author takes no responsibility for any loss of
  63. equipment and/or loss of data resulting from the use of ANSI View and
  64. utilities.
  65.  
  66.  
  67. (See REGISTER.DOC for information on registering ANSI View)
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. The Shareware Concept and What it Means to You.
  75.  
  76. Shareware is a method of marketing and distributing software that requires
  77. almost no capital (money) on the part of the author to distribute his/her
  78. software product to potential customers.  You may have downloaded ANSI View
  79. from an electronic BBS service or purchased a disk from a shareware
  80. distributor with ANSI View on it.  Simply because you have a copy of ANSI
  81. View does not mean that you own it.  In fact, after a reasonable trial
  82. period, you are encouraged to register your version of ANSI View.  There
  83. are many benefits in doing so, here are a few;
  84.  
  85. - By registering ANSI View you will receive a disk from the author with the
  86.   registered version of ANSI View on it.  The registered version comes with
  87.   all annoying delays disabled as well as your name "branded" right into
  88.   the program itself.
  89.  
  90. - If you register, you will be automatically notified of future
  91.   enhancements to ANSI View or related utilities.
  92.  
  93. - By registering, you help to support an industry that provides thousands
  94.   of new software titles to the public each year at very reasonable prices.
  95.  
  96. The registration fee for ANSI View is $20.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                             What is ANSI View?
  104.  
  105. ANSI View is a DOS command line utility similar to XCOPY or MOVE that
  106. displays ANSI coded images on your computer screen.  It does this with no
  107. assistance from the ANSI.SYS device driver.  Those of you that keep
  108. ANSI.SYS installed for viewing ANSI graphics can now free your computer's
  109. memory from ANSI.SYS forever!
  110.  
  111. Since ANSI View displays full color ANSI images and animation sequences,
  112. its possible uses are boundless.  One great use for it that I have found is
  113. for viewing ANSI files from the MS-DOS Shell or MS Windows' File Manager.
  114. By simply associating files with the extension .ANS (see perspective
  115. manuals) with AV.EXE, you can view all your favorite ANSI files easily from
  116. within a graphical environment.  Another great use for ANSI View is for
  117. setting up killer menu systems.  See information on the /K switch for how
  118. this can be done.
  119.  
  120. Of course, since ANSI View is not a memory-resident utility it does not re-
  121. map your keyboard for you as ANSI.SYS can.  But, when it comes to
  122. displaying color ANSI graphics, ANSI View blows ANSI.SYS out of the water
  123. in both speed and usability.
  124.  
  125.  
  126.                                Requirements
  127.  
  128. ANSI View requires :
  129.  
  130.      - IBM PC XT/AT compatible computer
  131.      - DOS 2.0+
  132.  
  133. Optional : An EGA or VGA graphics card is required for the display mode
  134. altering programs 12R.EXE, 14R.EXE, 21R.EXE, 25R.EXE, 28R.EXE, 43R.EXE, and
  135. 50R.EXE.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                              - INSTRUCTIONS -
  143.  
  144. ANSI View is very simple to use, if you can copy a file from the DOS
  145. command prompt you can use ANSI View.
  146.  
  147. The command line format of ANSI View is as follows;
  148.  
  149. AV <file name> [<file name>] [<prompt message>] [<switch> <switch>]
  150.  
  151. Specifications surrounded in "[]" are optional.
  152.  
  153. In order for ANSI View to function, at least one file name must be provided
  154. on the command line.  However, you may specify as many ANSI files as you
  155. wish at the command line and ANSI View will display them in the order they
  156. were given.  DOS does unfortunately limit the total length of the command
  157. line to 128 characters long however.
  158.  
  159. All DOS type wild cards can be used with ANSI View.  This includes the
  160. characters ? and * wild card characters.  For example;
  161.  
  162.      AV *.ANS *.TXT
  163.  
  164. will display all files with the extensions .ANS and .TXT in the current
  165. directory.
  166.  
  167. Also, there are four different command line switches that can be used with
  168. ANSI View to achieve desired results.  They are;
  169.  
  170.      /P - Pauses after each image displayed.
  171.      /C - Clears the screen before each image is displayed.
  172.      /K - See description below.
  173.      /S=0-9 - Alters the display speed; 0=fastest, 9=slowest
  174.      /V=x - Forces AV to use either direct screen writes or to use BIOS
  175.           screen writes.  x=D is direct screen writes, x=B is BIOS screen
  176.           writes.
  177.      /COLOR=OFF - Displays ANSI files in black and white
  178.      /? - Displays the help screen for ANSI View.
  179.  
  180. **** Note:  Beginning with version 3.0, ANSI View will now automatically
  181. detect which video adapter you have installed and configure itself
  182. accordingly.  However, due to the vast variety of video adapters in use
  183. today, ANSI View also allows you to manually select how it displays images
  184. on the screen.  See below for more details.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191. Examples;
  192.  
  193.      (1) AV *.ANS /P
  194.      (2) AV /P *.ANS
  195.      (3) AV OPENNING.ANS /P MYMENU.ANS
  196.      (4) AV OPENNING.ANS /P /C MYMENU.ANS
  197.      (5) AV PICTURE.ANS /V=B /COLOR=OFF
  198.      (6) AV PICTURE.ANS /V=D /P
  199.      (7) AV PICTURE.ANS /S=9
  200.  
  201. In example 1, all files with the .ANS extension will be displayed with a
  202. pause message between each file.  The user must press a key to view the
  203. next image.
  204.  
  205. Example 2 is exactly the same as the first.  The difference is that the /P
  206. switch is at the beginning of the command line sequence instead of at the
  207. end.  This demonstrates that ANSI View does not require that the switches
  208. be placed in any particular order, they may be mixed throughout the command
  209. line if the user prefers.
  210.  
  211. Example 3 shows how more than one file is specified on the command line.
  212. Again, switches may be placed anywhere in the command line sequence.
  213.  
  214. Example 4 illustrates how the /C switch is used to clear the screen before
  215. each file is displayed.
  216.  
  217. Example 5 shows how ANSI View can be set to write to the screen using BIOS
  218. instead of directly to the video screen.  This is somewhat slower than the
  219. direct method, but is compatible with nearly every video system in use
  220. today.  This example also shows how ANSI View can be configured to display
  221. ANSI pictures in black and white.
  222.  
  223. Example 6 shows how ANSI View can be set to write to the screen directly.
  224. This is a much faster method than using the BIOS method but may be prone to
  225. compatibility problems.
  226.  
  227. Example 7 demonstrates how the display speed of ANSI View can be altered.
  228. /S=0 is the fastest (default), while /S=9 is the slowest.  This switch can
  229. be useful if ANSI View is run from a very fast computer in which case the
  230. on-screen animation appears too rapidly on the screen to follow.  This
  231. feature is also useful for following exactly how a particular image is
  232. animated.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.                           Keys used in ANSI View
  240.  
  241. <P> - Pauses image display on screen, pressing <P> again will "unpause" the
  242. frozen image.
  243.  
  244. <SPACE> - Pressing the <SPACE BAR> while the computer is drawing an ANSI
  245. image on the screen will skip to the next file or exit the program.
  246.  
  247. <ESC> - Will abort ANSI View.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                    Returning Key Strokes to Batch Files
  255.  
  256. By using the /K switch and a prompt message, it is possible to return a
  257. keystroke value to a calling batch program for use with the ERRORLEVEL
  258. batch command.
  259.  
  260. First I'll present an example then discuss its workings.
  261.  
  262. Example:
  263.      AV TESTMENU.ANS "Please make selection from menu : " /K
  264.  
  265. The ingredients necessary for AV to return a keystroke properly are the /K
  266. switch and a file name.  A prompt message is optional.  ANSI View will not
  267. return a key stroke if a file name is not given on the command line.
  268.  
  269. When the /K switch is used, the last item in the command line is used for
  270. the prompt message (excluding any switch options that may follow).  In the
  271. above example, the message surrounded in quotes is used and not the /K.
  272. Messages requiring more than one word must be surrounded in quotes in order
  273. for ANSI View to properly interpret the message.
  274.  
  275. Prompt messages need not be surround in quotes, however, if they consist of
  276. only one word.  The example below will produce proper results also.
  277.  
  278. Example:
  279.      AV TESTMENU.ANS Selection? /K
  280.  
  281. This example will display the file TESTMENU.ANS and then display the
  282. message "Selection?" at the bottom of the image.
  283.  
  284. After the user has pressed the desired key the program will terminate
  285. setting the errorlevel to the value of the key that was pressed.
  286.  
  287. For a broader example of the process, see TESTMENU.BAT for an example of a
  288. menu system based around ANSI View.
  289.  
  290. One last note on the /K switch.  It is possible to specify more than one
  291. file name with the /K switch.  The prompt message will appear only after
  292. the last file has been displayed.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                          Adjusting the Line Height
  300.  
  301. Included with the ANSI View package are seven utilities designed to adjust
  302. the character height of EGA/VGA display terminal types.
  303.  
  304. The names of the utilities and their function are given below.
  305.  
  306.  Name            Function                      Hardware Required
  307. ------          ----------                    -------------------
  308. 12R.EXE          Set screen to 12 chars. high         VGA
  309. 14R.EXE          Set screen to 14 chars. high         VGA
  310. 21R.EXE          Set screen to 21 chars. high         VGA
  311. 25R.EXE          Set screen to 25 chars. high (ALL video adapters)
  312. 28R.EXE          Set screen to 28 chars. high         VGA
  313. 43R.EXE          Set screen to 43 chars. high       EGA/VGA
  314. 50R.EXE          Set screen to 50 chars. high         VGA
  315.  
  316.  
  317. ANSI View has been configured to work within these video modes.
  318.  
  319. There may be times when the standard 25 line screen is not big enough to
  320. hold the needed menu or other ANSI image so the higher number of lines per
  321. screen can become very useful.  Also, the visually impaired will welcome
  322. the larger letters provided by 12R.EXE and 14R.EXE for working within the
  323. DOS command line or ANSI View.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330. If you have any comments or suggestions, I would be very happy to hear from
  331. you.  I can be reached at the following locations:
  332.  
  333. Robert D. Bouman
  334. 94 W Roosevelt Ave.
  335. Zeeland, MI  49464
  336.  
  337.       - or -
  338.  
  339. The Dutch Ghetto BBS
  340. Phone - (616)772-0347
  341. VNET address - 255@6160
  342. User account #255, Robert Bouman
  343.  
  344.  
  345. Thank you for interest in ANSI View!
  346.  
  347. Robert D. Bouman
  348.