home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / SHWRIP23.ZIP / SHOWRIP.DOC < prev    next >
Text File  |  1993-08-14  |  12KB  |  274 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.  
  14. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%                    
  15.                     G E N E R A L   I N F O R M A T I O N 
  16. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%        
  17.         
  18.         
  19.                            D E S C R I P T I O N
  20.         ShowRip can be used to display RIP files in ways you have never                           
  21.         seen before!  You can use it to get an idea of what a screen is
  22.         going to look like before you  put it on your system.  But it will
  23.         do much more than that.  Using one of the command line options,
  24.         you can instruct ShowRip to decode the RIP file and display each
  25.         command in PLAIN ENGLISH so you can understand what is going on.
  26.         You can also tell ShowRip to do this one command at a time or
  27.         specify a delay time between commands. Using these features
  28.         and a simple text editor, you can create simple RIP files or
  29.         edit complex ones.  ShowRip was originally designed to be a
  30.         viewer, but has grown into more of a debugging/decoding tool.
  31.                            
  32.                            
  33.                            
  34.                              S H A R E W A R E
  35.         This utility is being distributed under the "Shareware" concept.                   
  36.         Anybody interested in this program is probably more than familiar
  37.         with the shareware, try-it-before-you-buy-it concept, so I won't
  38.         waste any time explaining it.  You may use SHOWRIP for a period
  39.         of 14 days to evaluate it's usefullness (or uselessness:) ).
  40.         Registration is only five bucks.  At any rate, let me know what
  41.         you think about SHOWRIP and any ideas for future updates.
  42.                     
  43.  
  44.                             D I S C L A I M E R
  45.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  46.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  47.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  48.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  49.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  50.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  51.       OR BREACH OF ANY WARRANTY.
  52.  
  53.                           
  54.                           D I S T R I B U T I O N
  55.    You may make this file available for downloading from your BBS or upload 
  56.    it to any BBS of your choice, provided that you do make no changes to 
  57.    the archive contents or the program itself. The archive in its original
  58.    form may be distributed by any service that charges no more than five
  59.    dollars for ts service.  NO written permission from the author is required
  60.    as long as the contents of the archive are not changed in ANY way.
  61.  
  62.                               
  63.                               U P D A T E S
  64.    The latest version of SHOWRIP is always available for download on 
  65.    NyteBytes BBS (614) 529-1464.
  66.  
  67.   
  68.  
  69. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  70.                             O P E R A T I O N 
  71. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  72.  
  73. To use SHOWRIP, 
  74.         Make sure that SHOWRIP.EXE is somewhere in your path.
  75.         The BGI and CHR files are not needed for ver 1.2 and up.
  76.  
  77. type: 
  78.         SHOWRIP <filename> [/d nnn] [/s] [/c] [/o] [/ega]
  79.  
  80. Options:
  81.         /d nnn  Delay between commands for nnn milliseconds.
  82.         /s      Step Mode - press a key between commands.
  83.         /c      Show commands at bottom of screen.
  84.         /o      Show commands ONLY, no graphics ***COMPLETE REWRITE****
  85.         /ega    Use 43 or 50 lines in text mode (use with /o to see more)
  86.  
  87.  
  88. NOTICE: The '/o' option functions completely different from prev. versions
  89.         1.x and lower.  It now actually decodes the commands for you and
  90.         displays them in a readable, somewhat colorful arrangement. All
  91.         mega-nums are converted to decimal and all color nums are displayed
  92.         as color names.  Give it a try the next time you are debugging 
  93.         a RIP file.
  94.  
  95.  
  96. EXAMPLES:
  97.         SHOWRIP filename.rip              // shows the file
  98.         
  99.         SHOWRIP filename                  // same as above
  100.         
  101.         SHOWRIR filename /c               // shows the file and displays
  102.                                              commands at bottom of the screen
  103.         
  104.         SHOWRIP filename /c /d 500        // same as above + pauses half a
  105.                                              second between commands
  106.  
  107.         SHOWRIP filename /o /d 1000       // shows commands only, no graphics
  108.                                              + delays for a full second be-
  109.                                              tween commands.  Use this with
  110.                                              the p key to pause even longer
  111.                                              while debugging.
  112.  
  113.         SHOWRIP filename /s /o            // same as above except no delay, 
  114.                                              this one waits for a keypress
  115.                                              between commands.
  116.  
  117.         SHOWRIP filename /s /o /EGA       // same as above except will show
  118.                                              more info per screen.  43 or 50
  119.                                              lines per screen vs 25 stndrd.
  120.  
  121.         SHOWRIP filename /d 3000          // Watch it draw real slow!
  122.  
  123. Most options can be used together or alone.  Some combinations are not logical
  124. but they will work just the same. (Delay and Step mode together!?!?)
  125.  
  126. The /c option will not work with the /o option as this would cause a mess
  127. on your screen.  The /ega option only works with the /o option as this 
  128. command only changes the text mode.
  129.  
  130. Options can be in any order as long as nnn follows /d and as long as the 
  131. first parameter is the Rip filename.  When specifying the file name, the
  132. extension is now optional.
  133.  
  134. While SHOWRIP is processing a file, pressing: 
  135.       <ESC>   will abort and return to DOS
  136.         c     toggles 'Show Commands' Mode
  137.         p     pauses the screen until a key is pressed
  138.  
  139. More to come!
  140.  
  141. There are probably a lot of things this release will do and not do that I
  142. am not aware of.  This was not intended to be released as shareware until
  143. late into it's creation.  After thinking about it I thought that it might 
  144. be of some use to other sysops.  So I decided to send out this release to 
  145. see what kind of response I get.  If I get good response, I will continue to
  146. work on SHOWRIP and probably even add a few extra features I have been
  147. thinking about.  On the other hand, if the response is limited so will be 
  148. the updates! (common sense Huh?)<G>
  149.  
  150. Thanx,
  151. Chuck
  152.  
  153. Comments, suggestions, and registration,
  154.  
  155.          Chuck Warrix                           NyteBytes  BBS
  156.         3430 Lacon Road                         (614) 529-1464
  157.       Hilliard, Ohio  43026                     14400 v.32 bis
  158.  
  159.  
  160.  
  161.  
  162.  
  163. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  164.                          R E G I S T R A T I O N
  165. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  166.  
  167. Registration is only five bucks and will entitle you to registered updates
  168. as they become available.  After I recieve your payment, I will set up an
  169. account for you on NyteBytes BBS and give you a security level which will
  170. allow you access to a private conference for registered ShowRip users only.
  171. In this conference will be one file area containing the latest registered
  172. version of ShowRip.
  173.  
  174. I didn't include any kind of form here because......w e l l.....I hate forms!
  175. All that I need is:
  176.         1.  FIRST NAME
  177.         2.  LAST NAME
  178.         3.  PASSWORD (for logging onto NyteBytes BBS)
  179.  
  180. Make sure that you log in to NyteBytes BBS using the same name and password.
  181. You must provide this information for me to set up an account for you in 
  182. advance.
  183.  
  184. Please allow up to 7 days for your registered copy to be posted from the time
  185. that you mail your payment.  My job requires that I travel and some times I
  186. end up on the road away from the BBS for most of the week.  Not very 
  187. often though<G>
  188.  
  189.  
  190. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  191.                    T E C H N I C A L    I N F O R M A T I O N
  192. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  193.  
  194. ShowRip was written in Turbo C++ ver2.0 on a 386DX/40
  195.  
  196. RETURN CODES (ERRORLEVEL)
  197. Everything worked ok                     0
  198. No filename specified                   99
  199. File open/not found error               98
  200. Graphics error                          97
  201.  
  202.  
  203. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  204.                               H I S T O R Y
  205. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  206.  
  207. 07/26/93  ver 1.0ß
  208.         First public release
  209.  
  210. 07/26/93  ver 1.1ß
  211.         Linked in the BGI graphics driver
  212.  
  213. 07/30/93  ver 1.2
  214.      1. Linked in all fonts so everything is in one executable file.
  215.         This made th EXE a little bigger, but now you don't have to have
  216.         all those CHR files around.
  217.      
  218.      2. You don't have to specify the RIP extension (optional).
  219.      
  220.      3. Added four command-line options:
  221.         /d nnn  Delay nnn milliseconds between each Rip command.
  222.         /s      Step Mode - Press a key between each command.
  223.         /c      Show the command at the bottom of the screen.
  224.         /o      Show only the Rip commands, no graphics.
  225.      
  226.      4. Bezier curves now work like they should!
  227.  
  228. 08/01/93  ver 2.0
  229.      1. Added some keyboard input while SHOWRIP is processing. (see above)
  230.  
  231.      2. Complete re-write on the Command Only '/o' option!  While in this 
  232.         mode, SHOWRIP will show you just about everything you want to
  233.         know about the commands it is reading.  It completely decodes them
  234.         into easy/easier to understand format. GREAT for debugging RIP files
  235.         written with a text editor.
  236.  
  237.      3. I plan to modify the '/o' command to output to a .TXT file or to
  238.         a printer. Another day...
  239.  
  240. 08/09/93  ver 2.2
  241.      1. Fixed a bug in the polygon functions.  ShowRip now closes the
  242.         polygons for you.  It is still good practice when creating a RIP
  243.         file to close them in the RIP command.
  244.  
  245.      2. Added some more detail to the /o (COMMAND ONLY) option.  Now shows
  246.         a graphic representation of the 8x8 fill pattern.  Also more detail
  247.         on TEXT_WINDOW and FONT_STYLE, and a few more.
  248.  
  249. 08/13/93  ver 2.3
  250.      1. Fixed a (stupid!) bug in the main module.  Before when you hit p
  251.         while processing, ShowRip would pause, but then put you in a step
  252.         mode (not what I intended).  Now hitting p pauses until any key is 
  253.         pressed and then resumes normal operation.
  254.  
  255.      2. Added an EGA/VGA text mode for the /o option to allow you to see
  256.         more commands on the screen at once. The new command is '/EGA'.
  257.  
  258.      3. Changed the way the RIP_SET_PALETTE displays in the /o mode.  It
  259.         used to tell you the name of the color or out of range.  Now it
  260.         just gives you the color number.  I couldn't have it show the colors
  261.         in the actual palette because it would require changing the palette
  262.         which would screw up the rest of the screen.  So for now in this 
  263.         command only, the color numbers are correct, but the color they
  264.         are displayed in may not be.
  265.  
  266.  
  267. Let me know if you would like to see more options.
  268.  
  269.  
  270.  
  271.            (c) Copywrite 1993 Chuck Warrix All Rights Reserved
  272.  
  273.  
  274.