home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / RIPIT20.ZIP / RIPIT.DOC < prev    next >
Text File  |  1994-01-02  |  14KB  |  261 lines
  1.                                   RIPIT!
  2.                             Copyright 1993/1994
  3.                               Blake Software
  4.  
  5. Disclaimer:
  6. You use this software solely at your own risk!  Blake Software nor the
  7. author (Howard Blake) are responsible for any loss you may incur from
  8. the use of this software.  Your use of this software constitutes that
  9. you agree to hold harmless Blake Software, Howard Blake, and all other
  10. parties connected with this software.  If you do not agree to the terms
  11. of this agreement, then do not use the software.
  12.  
  13. License Information:
  14. RIPIT and all scenes created by it are the property of Blake
  15. Software, the copyright owner.  You may try, test, or evaluate
  16. RIPIT for 30 days. After that time, either register the software
  17. with the author or discontinue using it and all scenes that were
  18. generated by it.  The scenes generated by RIPIT may not be used inside
  19. a program developed by you or another author without written permission
  20. from Blake Software. Generated scenes may be used on your BBS for the
  21. 30 day evaluation time frame, but may not be transferred to another
  22. person or used on another BBS not running RIPIT. RIPIT may not be reverse
  23. engineered, modified, or tampered with in any way.  Doing so is a
  24. violation of U.S. and international law.
  25.  
  26.                      RIPIT, Quik-RIPIT, Qwik-RIPIT
  27.                   Copyright 1993, 1994 Blake Software.
  28.                           ALL rights reserved
  29.  
  30.  
  31. [ RIPIT!  What it is! ]
  32. RIPIT will create a RIPScrip screen from an existing ASCII, ANSI,
  33. @Color, or any other TEXT based file.  And, it does it quickly and easily!
  34. Only three scene styles require ICONS in all of the scenes in RIPIT,
  35. but those are icons that are included with every copy of RIPTERM.  In
  36. other words, your callers will NOT have to download more icons from your
  37. system when you start using RIPIT.
  38.  
  39. [ This release Info ]
  40. This version of RIPIT was released to allow BBS systems other than
  41. WildCat! to take advantage of quick RIP screen generation.  The original
  42. version of RIPIT was developed for WildCat 3.9x BBS.  I've had TONS of
  43. calls for a version for almost every BBS system that exists, so here
  44. is the new RIPIT!  This version, besides the name change from Quik-RIPIT
  45. to RIPIT, has more styles added.  Rather than support 2 software packages
  46. that do the same thing (Quik-RIPIT and RIPIT), I've modified RIPIT to
  47. cover WildCat and almost all bbs systems.  When you run the RIPITCFG.EXE
  48. program to configure RIPIT, it defaults to WILDCAT variables, but can be
  49. changed to meet most bbs software's needs.
  50.  
  51. [ Installing RIPIT ]
  52. Create a directory for RIPIT or place it in an existing directory on
  53. your hard drive.  Unarchive (UNZip, UNArj, UNPak, or whatever) the file
  54. into this directory.  Run the RIPITCFG.EXE program to create/edit the
  55. file RIPIT.CFG which MUST be in the directory that RIPIT is ran from.
  56.  
  57. *NOTE* If the file RIPIT.CFG already exists when you run RIPITCFG.EXE,
  58. you will enter the configuration program in EDIT mode, editing the
  59. existing RIPIT.CFG file.
  60.  
  61. The configuration file, RIPIT.CFG, contains 17 variables that you must
  62. define for proper operation of RIPIT.  These variables may either
  63. be your BBS system variables (such as the variable used by WildCat! of
  64. @FIRST@ for the caller's first name, @USER@ for the caller's full name,
  65. etc.) or "hard" static constants if your BBS does not support a
  66. particular variable that is asked for.  For example:
  67.  
  68. EXAMPLE RIPIT.CFG File:
  69.                                         WildCat Variables  If Not Supported
  70. Description                             Used as Default    by your BBS Then:
  71. ============================================================================
  72. [ 1] Your BBS Name                      @BBS@              Green Acres! BBS
  73. [ 2] Your Full Name                     @SYSOP@            Howard Blake
  74. [ 3] Caller's Full Name                 @USER@             Friend
  75. [ 4] Caller's First Name                @FIRST@            Friend
  76. [ 5] Caller's Location                  @FROM@             A Brave New World
  77. [ 6] Caller's Security Level            @SEC@              MEMBER
  78. [ 7] Caller's Expiration Date           @EXDATE@           01/01/2001
  79. [ 8] Caller's Total Downloads           @DOWNS@            Lots!
  80. [ 9] Caller's Total Uploads             @UPS@              Lots!
  81. [10] Caller's Total Messages Posted     @MSGLEFT@          Lots!
  82. [11] Caller's Total Minutes On-line     @TIMEON@           ???
  83. [12] Caller's Total Minutes Left        @LEFT@             ???
  84. [13] Caller's Current Conference        @CONF@             Electronic Mail
  85. [14] Last Caller to BBS                 @PREVON@           A Friend
  86. [15] Current System Date                @DATE@             ??/??/??
  87. [16] Current System Time                @TIME@             ??:??
  88. [17] RIPIT Registration Code            0000000000000000   All zeros till
  89.                                                            registered!
  90.  
  91. In place of the WildCat variables above, enter the variables YOUR BBS
  92. uses (such as {FN that RBBS uses for callers first name, etc).  Or,
  93. if your bbs does not support a particular variable, such as sysop
  94. name, enter YOUR name and it will be displayed as entered to your
  95. callers.
  96.  
  97. I'm sorry if your BBS does not support some of the variables asked for.
  98. I've tried to make RIPIT useable by as many BBS systems as possible,
  99. but due to the variety of variables used by the different BBS systems,
  100. yours may not have the capability of displaying all of the 16 types of
  101. information required.  Please ask the author(s) of your BBS software
  102. to build in the variables that you find here that are not supported.
  103. It really helps with making your board that much sharper!
  104.  
  105. *NOTE* If your BBS does not support the DATE and TIME variables for
  106. the current system date/time, try not to enter a large text entry
  107. here!  You have, on certain scenes generated, only room for the date
  108. in MM/DD/YY format (8 characters) and HH:MM AM format for the time
  109. (max of 8 characters).
  110.  
  111. I have not tested it yet, but in the RIPSCRIP documentation, RIPSCRIP
  112. will support passing a variable for you that might help in this
  113. situation.  Supposedly (again not tested), the date could be passed
  114. as $DATE$ and the time as $HOUR$:$MIN$ $AMPM$.  This should query the
  115. BBS system for the current date in MM/DD/YY format and the current
  116. system time in HH:MM am (or pm) format.  If this works for you,
  117. please let me know so I can inform other users (thanks!).
  118.  
  119. After you have entered the required information, press F1 to save your
  120. configuration file.  RIPIT is now ready to run!
  121.  
  122.  
  123. [ How it works ]
  124.  
  125. To make RIPIT do it's thing, pass the proper parameters on the command
  126. line and you'll be done in a flash!  RIPIT's command line parameters
  127. are:
  128.  
  129.                        RIPIT <path\filename.ext> #
  130.  
  131. RIPIT (currently - I will be adding more) has 160 RIP styles it will
  132. produce for you.  If you screw up and enter a number larger than 160,
  133. RIPIT will default to style number 3 and produce your file anyway.
  134. Here's an example command line and explanation:
  135.  
  136.                      RIPIT C:\WC30\DISP\HELLO1.BBS 1
  137.                                    -OR-
  138.                      RIPIT C:\WC30\DISP\HELLO1 1
  139.  
  140. This will result in RIPIT producing HELLO1.RIP using style number 1.
  141. The RIP file will be placed in the directory containing the file
  142. passed on the command line (in this case, C:\WC30\DISP).
  143.  
  144. *NOTE* The .RIP extension is AUTOMATICALLY added to any file created!
  145. If your BBS does not support the .RIP extension, you will have to
  146. modify the generated file name accordingly.
  147.  
  148. [ Styles with Buttons ]
  149.  
  150. The styles with buttons allow the user to press a button on the screen
  151. with mouse or keyboard to perform it's function.  However, since
  152. WildCat has "mouseable" prompts, WC's prompts take over after the
  153. first use of the on-screen buttons (that's why there are only a
  154. few styles with buttons!).
  155.  
  156. The items with a "+" sign after the style number is a style that is
  157. NOT randomized!  I don't think you would want to send a rip to someone
  158. wishing them a happy birthday (or Happy Holidays) when that wasn't the
  159. correct occasion!  I left it up to you to manually send these style
  160. numbers to RIPIT!
  161.  
  162. [ Example of how to use RIPIT ]
  163. If you produce a new newsletter file, run RIPIT to create a RIP version
  164. for you.  Since we all know the best way to create a newsletter (or any
  165. other display file) is by using WildBull or ANSIBull <grin>, create your
  166. newsletter and exit Wild/ANSIBull.  From the DOS prompt enter:
  167.  
  168.                      RIPIT C:\WC30\DISP\NEWSLTR.BBS 6
  169.  
  170. This will create a file called C:\WC30\DISP\NEWSLTR.RIP using style
  171. number 6.
  172.  
  173. You can also run RIPIT in your batch files to automatically produce
  174. RIPScrip screens using files created by other programs you might run.
  175.  
  176.                      RIPIT C:\WC30\DISP\NEWSLTR.BBS RANDOM
  177.  
  178. Execute RIPIT with RANDOM added in place of the style number and you can
  179. let RIPIT pick the style for you!  This is handy in batch files for
  180. letting RIPIT run and generate a different style for you each time it is
  181. executed!  Use this feature in your POSTCALL.BAT file, events, or
  182. whenever you want RIPIT to generate a RIP for you.  RIPIT will RANDOMLY
  183. select from the styles available to create your RIP output file.
  184.  
  185. *NOTE* The RANDOM option will NOT randomly select the BIRTHDAY or
  186. HOLIDAY styles!  If those style numbers are selected by the random
  187. generator, it will be recycled until another number is selected.  It
  188. also will not select The Office, Floppies, Christmas, or any of the
  189. styles with buttons.  There are a few other styles that are NOT
  190. randomly generated.  They are for special holidays or might not
  191. be tasteful for everyone, so I caused them to have to be selected
  192. manually. The button styles MAY NOT work properly on your BBS!
  193. Those were for WildCat, but some systems will support the same
  194. variables so I left them in here.  Test them to see if they are
  195. compatible with your system.
  196.  
  197. One last note.  You can use just about any of the RIP draw/paint/view
  198. programs to view the RIPs created by RIPIT, however, some of them DO
  199. NOT always display RIPs properly!  If you view a RIP and it looks
  200. kinda funky, best run it up in RIPAINT or better yet, call your BBS
  201. and look at it.  That's the ultimate test!
  202.  
  203. [ Hints ]
  204. Every night, run RIPIT as an event in RANDOM mode to regenerate ALL
  205. of your RIP display files!  Your callers will almost always see
  206. something new this way!
  207.  
  208. [ Registration ]
  209. This software is shareware.  As with ALL of my utility programs, I've
  210. priced it so that it is affordable by all (it's only $10.00!).  With
  211. registration comes a key that will remove all delays and 'beg' screens.
  212. To register, see the enclosed REGFORM.TXT file.  A limited time,
  213. "special offer" is included in this file!  You can always find the
  214. latest release of RIPIT and other Blake Software products on
  215. Green Acres! BBS, (505)763-5129.  You can netmail me with questions
  216. or comments at FIDO 1:318/4 (FReq's not currently available), or drop
  217. mail on my board (Green Acres!), or on MSI in the Software Developers
  218. conference.
  219.  
  220. Other Blake Software Products:
  221. ======================================================================
  222. If you are a WildCat sysop, look on the MSI BBS for WildCat specific
  223. Blake Software (WildStuff!) products, or call Green Acres! BBS at
  224. (505)763-5129 for the latest releases.
  225. ======================================================================
  226. The WIT Door - Graffitti door for ANY BBS                       $FREE$
  227. 2 Cents - Quote door for ANY BBS                                $FREE$
  228. ======================================================================
  229. ANSIBull - ANY BBS display file generator          Both For Only
  230. ANSIStyl - Style generator for ANSIBull                         $20.00
  231.  
  232. ANSIBull and ANSIStyle allow you to generate SUPERB display files:
  233. (i.e., bulletins, newsletters, menus, anything you want!).  You can
  234. use the large number of internal styles or create your own with the
  235. ANSIStyle creator program (included).  ANSIBull creates ANSI color,
  236. Mono, and text-based display files using any text or ANSI based file.
  237. Your original text/ANSI file remains intact, if desired, for easy
  238. additions/modifications for future regenerations.  Works with ANY BBS
  239. system that supports ANSI display capability.
  240.  
  241. ======================================================================
  242. WildBull  - WildCat 3.x display file generator     Both For Only
  243. WildStyle - Style generator for WildBull                        $20.00
  244.  
  245. WildBull/WildStyle do the same thing as ANSIBull/Style, but for WC3.x
  246. BBS systems using the @Color macros.  It creates one output file with
  247. the @Color macros.  Works GREAT!
  248. ======================================================================
  249. RIPIT!  The hottest RIP scene generator EVER!              $10.00
  250. Contains 160 RIP scenes with more on the way!  Configurable
  251. to work with ANY BBS system capable of utilizing the RIPScrip
  252. graphics protocol.
  253. ======================================================================
  254. WildEdit - Text Editor designed with WildBull/News in mind, but
  255.            will work for all of your text editing needs!
  256.            Works GREAT with ANSIBull!                           $20.00
  257. *Free with ANSIBull registration!
  258. ======================================================================
  259. There are a lot more!  Call Green Acres! BBS at (505)763-5129 and
  260. check out the "WildStuff - Blake Software" file area!
  261.