home *** CD-ROM | disk | FTP | other *** search
/ World of Graphics / WOGRAPH.BIN / 473.PICTVIEW.DOC < prev    next >
Text File  |  1992-12-22  |  12KB  |  296 lines
  1.  
  2.  
  3.                       ╓─────────────────────────────╖
  4.                       ║ P I C T U R E   V I E W E R ║ █
  5.                       ╙─────────────────────────────╜ █
  6.                         ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  7.                             (c) 1992 Don Jones
  8.  
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  11.  
  12.                       VERSION 1.70   December 22, 1922
  13.  
  14.                                     By
  15.  
  16.                               Don Paul Jones
  17.                             84-1043 Hana Street
  18.                                 Waianae, HI
  19.                                    96792
  20.  
  21.                                    From
  22.  
  23.                             One Step Beyond BBS
  24.                             1200/2400/9600/19200
  25.                                24 Hours/Day
  26.                        (808)695-5190 or (808)695-5177
  27.  
  28.  
  29. ╓─────────────────╖
  30. ║ LATEST VERSION: ║
  31. ╙─────────────────╜
  32.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  33. Please call One Step Beyond BBS for the latest version of this program.
  34.  
  35. ╓─────────────╖
  36. ║ LEGALITIES: ║
  37. ╙─────────────╜
  38.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  45. DISTRIBUTION OF THE REGISTERED VERSION OF THIS PROGRAM WILL INVALIDATE YOUR
  46. FUTURE VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN.
  47. DISTRIBUTING A REGISTERED PROGRAM WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  48.  
  49. ╓───────────────╖
  50. ║ DISTRIBUTION: ║ █
  51. ╙───────────────╜ █
  52.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  53. You may make this file available for downloading from your BBS or you may
  54. upload it to any BBS of your choice, provided that you do not make any
  55. changes to the contents of the archive (ZIP file). The archive and its
  56. individual contents may not be used by any service that charges any money
  57. whatsoever, without the written permission of the author.
  58.  
  59. ╓──────────────────────╖
  60. ║ PROGRAM DESCRIPTION: ║ █
  61. ╙──────────────────────╜ █
  62.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  63. PICTURE VIEWER is an ANSI screen display program that will display a total
  64. of 60 ANSI screens. The program can be run from a BBS or LOCALLY as a
  65. stand alone program.
  66.  
  67. The MENU.ANS is fully configurable to whatever screens you want to display.
  68. Remember: When changing the MENU.ANS, do a BLOCK SAVE and HOME CURSOR with
  69. TheDraw Drawing Program.
  70.  
  71. The program reads from 1.ANS to 60.ANS so you can copy over any of them
  72. providing you use the same number and add the name to the MENU.ANS screen.
  73. Any screens that you change from the menu need to be BLOCKED SAVE with HOME
  74. CURSOR to display correctly.
  75.  
  76. ╓───────────╖
  77. ║ FEATURES: ║ █
  78. ╙───────────╜ █
  79.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  80.            --- Desqview Aware.
  81.            --- COM1-4 support and non-standard IRQ's.
  82.            --- Colorful ANSI screens.
  83.            --- Chat function.
  84.            --- NO BRUN module needed for play.
  85.            --- Will return to BBS on dropped carrier.
  86.            --- Will TIMEOUT a player after 5 minutes of no activity.
  87.            --- SysOp configurable.
  88.  
  89. ╓─────────────╖
  90. ║INSTALLATION:║ █
  91. ╙─────────────╜ █
  92.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  93. Just UNZIP the PICTVIEW into the directory of your choosing. Then reconfigure
  94. the PICTVIEW.CFG file to your type of BBS caller file. Then make the batch
  95. file to start the program (see EXAMPLE BATCH FILE) for details.
  96.  
  97. ╓─────────────────────────────────────────╖
  98. ║ CONFIGURATION: (Your PICTVIEW.CFG file) ║ █
  99. ╙─────────────────────────────────────────╜ █
  100.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  101. Example configuration file for PCBOARD.SYS
  102. ------------------------------------------
  103.  
  104. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  105. One Step Beyond BBS <=-  (Change this to your BBS name)
  106. Don                 <=-  (The Sysop's first name)
  107. Jones               <=-  (The Sysop's last name)
  108.  
  109. Example configuration file for USERS.SYS
  110. ----------------------------------------
  111.  
  112. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  113. One Step Beyond BBS <=-  (Change this to your BBS name)
  114. Don                 <=-  (The Sysop's first name)
  115. Jones               <=-  (The Sysop's last name)
  116.  
  117. Example configuration file for DOOR.SYS
  118. ---------------------------------------
  119.  
  120. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  121. One Step Beyond BBS <=-  (Change this to your BBS name)
  122. Don                 <=-  (The Sysop's first name)
  123. Jones               <=-  (The Sysop's last name)
  124.  
  125. Example configuration file for USERINFO.DAT
  126. -------------------------------------------
  127.  
  128. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  129. One Step Beyond BBS <=-  (Change this to your BBS name)
  130. Don                 <=-  (The Sysop's first name)
  131. Jones               <=-  (The Sysop's last name)
  132. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  133.  
  134. Example configuration file for CALLINFO.BBS
  135. -------------------------------------------
  136.  
  137. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  138. One Step Beyond BBS <=-  (Change this to your BBS name)
  139. Don                 <=-  (The Sysop's first name)
  140. Jones               <=-  (The Sysop's last name)
  141.  
  142. Example configuration file for DORINFOx.DEF
  143. -------------------------------------------
  144.  
  145. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  146.                           where 'x' is the BBS Node number.
  147. One Step Beyond BBS <=-  (Change this to your BBS name)
  148. Don                 <=-  (The Sysop's first name)
  149. Jones               <=-  (The Sysop's last name)
  150.  
  151. Example configuration file for SFDOORS.DAT
  152. ------------------------------------------
  153.  
  154. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  155. One Step Beyond BBS <=-  (Change this to your BBS name)
  156. Don                 <=-  (The Sysop's first name)
  157. Jones               <=-  (The Sysop's last name)
  158.  
  159. Example configuration file for CHAIN.TXT
  160. ----------------------------------------
  161.  
  162. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  163. One Step Beyond BBS <=-  (Change this to your BBS name)
  164. Don                 <=-  (The Sysop's first name)
  165. Jones               <=-  (The Sysop's last name)
  166.  
  167. Example configuration file for GTUSER.BBS
  168. -----------------------------------------
  169.  
  170. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  171. One Step Beyond BBS <=-  (Change this to your BBS name)
  172. Don                 <=-  (The Sysop's first name)
  173. Jones               <=-  (The Sysop's last name)
  174. 1                   <=-  (COM port number - defaults to 1)
  175. 1                   <=-  (Node number - defaults to 1)
  176.  
  177. ╓────────────────────╖
  178. ║ Example Batch File ║ █
  179. ╙────────────────────╜ █
  180.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  181.  
  182. A sample batch file similar to the following:
  183.    ECHO OFF
  184.    CD\DOORS\PICTVIEW        <=- Switch to the door's Directory.
  185.    PICTVIEW PICTVIEW.CFG    <=- Execute the door program and pass the
  186.                                 configuration filename to the program.
  187.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  188.    BOARD                    <=- Restart BBS.
  189.  
  190. This Door is multi-node  compatible so you may run more than 1 node from
  191. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  192. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  193. variables, (q.v.)
  194.  
  195. ╓───────────────────────╖
  196. ║ Environment Variables ║ █
  197. ╙───────────────────────╜ █
  198.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  199. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  200. variables. Non-PCBoard systems may also use these variables by including
  201. the following in either your BBS batch or AUTOEXEC.BAT
  202.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  203.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  204. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  205. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  206. .CFG file for multi-node operation!
  207.  
  208. ╓────────────╖
  209. ║ Sysop Keys ║ █
  210. ╙────────────╜ █
  211.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  212. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  213.          written to DOOR.SYS and USERS.SYS
  214. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  215.          and/or written to DOOR.SYS and USERS.SYS
  216. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  217. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  218.          and/or written to DOOR.SYS and USERS.SYS
  219. F8    -  Returns the caller involuntarily to the BBS.
  220. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  221.          and/or written to DOOR.SYS and USERS.SYS
  222. F10   -  Activates SysOp CHAT mode within the DOOR.
  223. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  224. UP    -  Give the caller extra time while in the DOOR.  
  225. DN    -  Subtract time from the caller while in the DOOR. 
  226. HOME  -  HELP key for Status Line options.
  227. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  228. ALT-X -  PCBoard will exit after current caller logs off. Value is
  229.          passed to PCBoard. Not available on non-PCBoard systems.
  230.  
  231.  
  232. ╓──────────────────╖
  233. ║ PLAYING LOCALLY: ║ █
  234. ╙──────────────────╜ █
  235.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  236. A file called LOCAL.BAT is included to allow anyone to use the program
  237. locally. Just type LOCAL
  238.  
  239. ╓──────────────╖
  240. ║ REGISTERING: ║ █
  241. ╙──────────────╜ █
  242.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  243. All prior registered owners just need to contact One Step Beyond to get
  244. their registered "key" file. This was introduced to the code to allow
  245. easier updating of this program. All registration proceeds will be promply
  246. donated to THE ALOHA UNITED WAY.
  247.  
  248. If you have any problems or questions please feel free to call:
  249.  
  250.           One Step Beyond BBS at (808)695-5190 or (808)695-5177
  251.  
  252. ╓────────╖
  253. ║ THANKS ║ █
  254. ╙────────╜ █
  255.   ▀▀▀▀▀▀▀▀▀▀
  256. Many thanks to Ted Freeman of Micronet BBS for his help in getting this
  257. simple program on the road. He is also the author of DFRAMEVB which was
  258. used to compile the program with.
  259.  
  260. ╓──────────────────────╖
  261. ║ THE SCREENS ENCLOSED ║ █
  262. ╙──────────────────────╜ █
  263.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  264. The ANSI screens enclosed in this program were created from some of the best
  265. ANSI ARTIST in the world and they deserve the many thanks for creating them
  266. for yours and my enjoyment. By registering this program you are in fact
  267. registering the viewer program and not the screens included.
  268.  
  269. ╓───────────╖
  270. ║ REVISIONS ║
  271. ╙───────────╜
  272.  
  273.  - v1.00 was the original release. Had some screen bugs to fix, worked fine
  274.  locally, buy not remotely.
  275.  
  276.  - v1.10 had more screen problems to fix.
  277.  
  278.  - v1.20 hopefully is working fine, at least on this end it is.
  279.  
  280.  -v1.30 added support for up to 60 ansi screens and also compiled it to
  281.   reguired BRUN45.EXE to enable a smaller .EXE file, also cleaned up the
  282.   code a little more.
  283.  
  284.  -v1.40 improved the code somewhat and changed from "X to exit" to
  285.   "Q to quit" which makes more sense to the caller. BRUN45.EXE no longer
  286.   needed.
  287.  
  288.  -v1.50 fixed a small bug that would give you an invalid display when
  289.   coming off a shell.
  290.  
  291.  -v1.60 improved the coding, and compiled with MS VISUAL BASIC for DOS as
  292.   well as Ted Freeman's DFRAMEVB door interface routine.
  293.  
  294.  -v1.70 improved "registered to" and closing screens. Installed "key" to
  295.   aid getting updates to this program.
  296.