home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / helpfile / shwrip20.zip / SHOWRIP.DOC next >
Text File  |  1993-08-01  |  8KB  |  193 lines
  1.                               
  2.                               
  3.                               S H O W R I P
  4.                    RIP File Viewing / Debugging Utility
  5.                                     By
  6.                           C h u c k   W a r r i x
  7.                                NyteBytes BBS
  8.                                3430 Lacon Rd.
  9.                              Hilliard, OH  43026
  10.                                (614) 529-1464
  11.  
  12.  
  13.                     G E N E R A L   I N F O R M A T I O N 
  14.         This utility is being distributed under the "Shareware" concept.                   
  15.         Anybody interested in this program is probably more than familiar
  16.         with the shareware, try-it-before-you-buy-it concept, so I won't
  17.         waste any time explaining it.  You may use SHOWRIP for a period
  18.         of 14 days to evaluate it's usefullness (or uselessness:) ).
  19.         Registration is only five bucks.  At any rate, let me know what
  20.         you think about SHOWRIP and any ideas for future updates.
  21.                                    
  22.                            
  23.                            
  24.                            D I S C L A I M E R
  25.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  26.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  27.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  28.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  29.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  30.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  31.       OR BREACH OF ANY WARRANTY.
  32.  
  33.                           D I S T R I B U T I O N
  34.    You may make this file available for downloading from your BBS or upload 
  35.    it to any BBS of your choice, provided that you do make no changes to 
  36.    the archive contents or the program itself. The archive in its original
  37.    form may be distributed by any service that charges no more than five
  38.    dollars for ts service.  NO written permission from the author is required
  39.    as long as the contents of the archive are not changed in ANY way.
  40.  
  41.                               U P D A T E S
  42.    The latest version of SHOWRIP is always available for download on 
  43.    NyteBytes BBS (614) 529-1464.
  44.  
  45.   
  46.  
  47. To use SHOWRIP, 
  48.         Make sure that SHOWRIP.EXE is somewhere in your path.
  49.         The BGI and CHR files are not needed for ver 1.2 and up.
  50.  
  51. type: 
  52.         SHOWRIP <filename> [/d nnn] [/s] [/c] [/o]
  53.  
  54. Options:
  55.         /d nnn  Delay between commands for nnn milliseconds.
  56.         /s      Step Mode - press a key between commands.
  57.         /c      Show commands at bottom of screen.
  58.         /o      Show commands ONLY, no graphics ***COMPLETE REWRITE****
  59.  
  60. NOTICE: The '/o' option functions completely different from prev. versions
  61.         1.x and lower.  It now actually decodes the commands for you and
  62.         displays them in a readable, somewhat colorful arrangement. All
  63.         mega-nums are converted to decimal and all color nums are displayed
  64.         as color names.  Give it a try the next time you are debugging 
  65.         a RIP file.
  66.  
  67. EXAMPLES:
  68.         SHOWRIP filename.rip              // shows the file
  69.         
  70.         SHOWRIP filename                  // same as above
  71.         
  72.         SHOWRIR filename /c               // shows the file and displays
  73.                                              commands at bottom of the screen
  74.         
  75.         SHOWRIP filename /c /d 500        // same as above + pauses half a
  76.                                              second between commands
  77.  
  78.         SHOWRIP filename /o /d 1000       // shows commands only, no graphics
  79.                                              + delays for a full second be-
  80.                                              tween commands.  Use this with
  81.                                              the p key to pause even longer
  82.                                              while debugging.
  83.  
  84.         SHOWRIP filename /s /o            // same as above except no delay, 
  85.                                              this one waits for a keypress
  86.                                              between commands.
  87.  
  88.         SHOWRIP filename /d 3000          // Watch it draw real slow!
  89.  
  90. All options can be used together or alone.  Some combinations are not logical
  91. but they will work just the same. (Delay and Step mode together!?!?)
  92.  
  93. The /c option will not work with the /o option as this would cause a mess
  94. on your screen.
  95.  
  96. Options can be in any order as long as nnn follows /d and as long as the 
  97. first parameter is the Rip filename.  When specifying the file name, the
  98. extension is now optional.
  99.  
  100. While SHOWRIP is processing a file, pressing: 
  101.       <ESC>   will abort and return to DOS
  102.         c     toggles 'Show Commands' Mode
  103.  
  104. More to come!
  105.  
  106. There are probably a lot of things this release will do and not do that I
  107. am not aware of.  This was not intended to be released as shareware until
  108. late into it's creation.  After thinking about it I thought that it might 
  109. be of some use to other sysops.  So I decided to send out this release to 
  110. see what kind of response I get.  If I get good response, I will continue to
  111. work on SHOWRIP and probably even add a few extra features I have been
  112. thinking about.  On the other hand, if the response is limited so will be 
  113. the updates! (common sense Huh?)<G>
  114.  
  115. Thanx,
  116. Chuck
  117.  
  118. Comments, suggestions, and registration,
  119.  
  120. Chuck Warrix                           NyteBytes  BBS
  121. 3430 Lacon Rd.                         (614) 529-1464
  122. Hilliard, Ohio  43026                  14400 v.32 bis
  123.  
  124. Registration is only five bucks and will entitle you to registered updates
  125. as they become available.  After I recieve your payment, I will put a copy
  126. of the latest version (without the delay screen) on NyteBytes BBS as an
  127. attachment to a private message to you.  So please log in using the same
  128. name as you use to register, or you will not get the message. (But you 
  129. knew that didn't ya!)<G>
  130.  
  131. I didn't include any kind of form here because......w e l l.....I hate forms!
  132. All I need is the name that you want SHOWRIP to be registered to and
  133. the name you will use to log into NyteBytes with to get it.  If you want
  134. to include a password, I will set up an account for you in advance to speed
  135. up your online time.
  136.  
  137. Please allow up to 7 days for your registered copy to be posted from the time
  138. that you mail your payment.  My job requires that I travel and some times I
  139. end up on the road away from the BBS for most of the week.  Not very 
  140. often though<G>
  141.  
  142. BTW if you want to include SHOWRIP in a batch file here are the values that
  143. it returns to DOS as ERRORLEVEL.
  144.  
  145. Everything worked ok                     0
  146. No filename specified                   99
  147. File open/not found error               98
  148. Graphics error                          97
  149.  
  150.  
  151. HISTORY:
  152.  
  153. 07/26/93  ver 1.0ß
  154.         First public release
  155.  
  156. 07/26/93  ver 1.1ß
  157.         Linked in the BGI graphics driver
  158.  
  159. 07/30/93  ver 1.2
  160.      1. Linked in all fonts so everything is in one executable file.
  161.         This made th EXE a little bigger, but now you don't have to have
  162.         all those CHR files around.
  163.      
  164.      2. You don't have to specify the RIP extension (optional).
  165.      
  166.      3. Added four command-line options:
  167.         /d nnn  Delay nnn milliseconds between each Rip command.
  168.         /s      Step Mode - Press a key between each command.
  169.         /c      Show the command at the bottom of the screen.
  170.         /o      Show only the Rip commands, no graphics.
  171.      
  172.      4. Bezier curves now work like they should!
  173.  
  174. 08/01/93  ver 2.0
  175.      1. Added some keyboard input while SHOWRIP is processing. (see above)
  176.  
  177.      2. Complete re-write on the Command Only '/o' option!  While in this 
  178.         mode, SHOWRIP will show you just about everything you want to
  179.         know about the commands it is reading.  It completely decodes them
  180.         into easy/easier to understand format. GREAT for debugging RIP files
  181.         written with a text editor.
  182.  
  183.      3. I plan to modify the '/o' command to output to a .TXT file or to
  184.         a printer. Another day...
  185.  
  186. Let me know if you would like to see more options.
  187.  
  188.  
  189.  
  190.            (c) Copywrite 1993 Chuck Warrix All Rights Reserved
  191.  
  192.  
  193.