home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Multimedia & CD-ROM 4
/
mmcd04-julaug1995-cd.iso
/
utils
/
graphics
/
showrip
/
showrip.doc
< prev
next >
Wrap
Text File
|
1995-06-06
|
28KB
|
521 lines
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒ ▒▒
▒▒ ▒▒
▒▒ ███████┐ ██┐ ██┐ ███████┐ ██┐ ██┐ ██┐ ███████┐ ████┐ ███████┐ ▒▒
▒▒ ██┌────┘ ██│ ██│ ██┌──██│ ██│ ██│ ██│ ██┌──██│ └██┌┘ ██┌──██│ ▒▒
▒▒ ███████┐ ███████│ ██│ ██│ ██│ ██│ ██│ ███████│ ██│ ███████│ ▒▒
▒▒ └────██│ ██┌──██│ ██│ ██│ ██│ ██│ ██│ ██┌─██┌┘ ██│ ██┌────┘ ▒▒
▒▒ ███████│ ██│ ██│ ███████│ ██████████│ ██│ ███┐ ████┐ ██│ ▒▒
▒▒ └──────┘ └─┘ └─┘ └──────┘ └─────────┘ └─┘ └──┘ └───┘ └─┘ ▒▒
▒▒ ▒▒
▒▒ The Ultimate RIP viewing / debugging utility ▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
The latest version of
╖─╖ ╖ ╖─╖ ■
╙─╖ ╟╖ ╓╖ ╖╖╖ ║╥╜ ╖ ╓╖
╜─╜ ╙╙ ╙╜ ╙╨╜ ╜╙─ ╙ ╟╜
by Chuck Warrix ╙
is always available on
╖╖╖ ╖─╖ ╖─╖ ╖─╖ ╖─╖
║║║ ╖╖ ╫─ ╓╖ ║─╢ ╖╖ ╫─ ╓╖ ╓─ ║─╢ ║─╢ ╙─╖
╜╙╜ ╙╢ ╙╜ ╙─ ╜─╜ ╙╢ ╙╜ ╙─ ─╜ ╜─╜ ╜─╜ ╜─╜
(614) 529-1464
14.4k v32/bis
24hrs 365 days
ShowRip is a utility that allows you to view RIP files in a
variety of ways. You can simply view the RIP file in EGA
graphics mode to see what your users will see, or you can
instruct ShowRip to 'dissect' your RIP file and give you a
'Plain English' description of each of the otherwise cryptic
commands. In either mode, you can see each command one step
at a time, or specify a delay between commands. ShowRip will
even output the plain english translations to a text file to
be printed or viewed at a later time. ShowRip is a perfect
tool for the SysOp who is new to RIP or for the pros. It is
the best and easiest utility of it's kind and new features
are being added everyday.
S H O W R I P
RIP File Viewing / Debugging Utility
By
C h u c k W a r r i x
NyteBytes BBS
3430 Lacon Rd.
Hilliard, OH 43026
(614) 529-1464
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
G E N E R A L I N F O R M A T I O N
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
D E S C R I P T I O N
ShowRip can be used to display RIP files in ways you have never seen
before! You can use it to get an idea of what a screen is going to
look like before you put it on your system. But it will do MUCH more
than that. Using one of the command line options, you can instruct
ShowRip to decode the RIP file and display each command in PLAIN
ENGLISH so you can understand what is going on. You can also tell
ShowRip to do this one command at a time or specify a delay time
between commands. Using these features and a simple text editor, you
can create simple RIP files or edit complex ones. ShowRip was
originally designed to be a viewer, but has grown into more of a
debugging/decoding tool. Now ShowRip is @ code and ANSI compatible.
You can now use it display/debug RIP files containing ANSI or @ codes!
ShowRip has been tested on a lot of different files with GREAT
results, but I'm sure it's not perfect. So...IF you find a screen
that ShowRip will not display, PLEASE U/L it to a private area on
NyteBytes BBS so that I can find out why. THANX
S H A R E W A R E
This utility is being distributed under the "Shareware" concept.
Anybody interested in this program is probably more than familiar with
the shareware, try-before-you-buy concept, so I won't waste any time
explaining it. You may use SHOWRIP for a period of 14 days to
evaluate it's usefulness (or uselessness:) ). After that, registration
is only ten bucks and entitles you to all future upgrades. So if you
find this program useful, let me know by registering it and get rid of
that pesky delay screen! At any rate, let me know what you think
about SHOWRIP and any ideas for future updates. See the registration
section later in this manual for registration instructions. Thanx for
trying ShowRip!
D I S C L A I M E R
THE AUTHOR OF THIS UTILITY DISCLAIMS ALL WARRANTIES RELATING TO THIS
SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY
DISCLAIMED. NEITHER THE AUTHOR NOR ANYONE ELSE WHO HAS BEEN INVOLVED
IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE
LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE EVEN IF THE AUTHOR
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO
EVENT SHALL THE AUTHOR'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE
PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE, REGARDLESS OF THE FORM
OF THE CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE
QUALITY AND PERFORMANCE OF THE SOFTWARE.
Some states do not allow the exclusion of the limit of liability for
consequential or incidental damages, so the above limitation may not
apply to you.
This agreement shall be governed by the laws of the state of Ohio and
shall inure to the benefit of the author of this utility and any
successors, administrators, heirs and assigns. Any action or
proceeding brought by either party against the other arising out of or
related to this agreement shall be brought only in a STATE or FEDERAL
COURT of competent jurisdiction located in Franklin County, Ohio. The
parties herby consent to in persona jurisdiction of said courts.
D I S T R I B U T I O N
(UNREGISTERED VERSION ONLY)
You may make this file available for down loading from your BBS or
upload it to any BBS of your choice, provided that you make no changes
to the archive contents or the program itself. The archive in its
original form may be distributed by any service that charges no more
than five dollars for its service, without written permission from the
author as long as the contents of the archive are not changed in ANY
way. However any such services are invited to contact the author via
mail or NyteBytes BBS for any additional information or for any
special distribution arrangements. Please maintain current naming
scheme: ShowRip = SHWRIPxx.ZIP, ShowRip Lite = SHWLITxx.ZIP and
ShowCon = SHWCONxx.ZIP.
U P D A T E S
The latest UNREGISTERED version of SHOWRIP is always available for
download on NyteBytes BBS (614)529-1464 (Check the RIP utils area
LOCAL)
REGISTERED USERS: Join conference 20 to D/L the latest REGISTERED
version. THANX for your support!
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
O P E R A T I O N
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
To use SHOWRIP,
Make sure that SHOWRIP.EXE is somewhere in your path. The
BGI files are not needed for ver 1.2 and up. The .CHR files
are not needed for fonts one through five.
Syntax:
SHOWRIP <filename>[.RIP] [/d nnn] [/s] [/c] [/o] [/ega]
Filename:
Versions 2.9a and up support wildcard filenames, so all of the
following are valid entries for filename.
SHOWRIP *.RIP SHOWRIP ???????5.RIP
SHOWRIP MENU*.RIP SHOWRIP *.ANS
SHOWRIP *.SCR SHOWRIP *.BBS
Notice the examples above which end in those other familiar
extensions besides RIP. ShowRip will now display ANSI and Wildcat!
@ code screens. The display will be in EGA graphics mode and in a
condensed font (the default RIP text font), but it can be done. I
wanted ShowRip to be able to pick the ANSI and @ codes out of the
RIP files and display it in the defined text window. So when you
tell it to display an ANSI or BBS file or a plain text file for
that matter, it doesn't know the difference. It just looks at it
as another RIP file and does what it was supposed to do. Since the
default text window is the entire screen, ShowRip goes to work
displaying the file in that area. I have to admit, this one was
kind of unintentional, but a nice surprise none the less ;) The
extension is optional, and is assumed to be RIP if omitted.
Options:
/d nnn Delay between commands for nnn milliseconds. This command
is useful if you want to see a file in slow motion. This
option will works well with the /o option described below.
/s Step mode - This is a simple but important feature of
ShowRip which will stop and wait for you to press a key
between commands. Remember, when using this command, that
you may not see something happen every time you press a
key. This is because not every RIP, @BBS@, or ANSI command
changes the screen. For example ShowRip will pause after
reading @8F@, but nothing happened on the screen because
this command is a Wildcat! command to change the color of
next block of text. This option works well with the /c
option below.
/c This option will display each command (unchanged) at the
bottom of the screen as it is being processed. This is
another useful function which has its drawbacks. As the
text prints to the bottom of the screen, part of the
graphic image on some RIP files is erased. This is usually
not a problem until a fill command comes along and fills
the entire screen because part of its border was wiped out
by the text. Keep this in mind if you have a problem
displaying a file while using this option. It is also
recommended to use the /s or /d nnn option above with this
option, because the text is displayed to fast to read.
/o Show commands ONLY, no graphics. ***COMPLETE REWRITE**** This
started out as something I was using to debug how ShowRip
was reading files. It quickly became evident to me that
this was going to be the most powerful option that ShowRip
has to offer. This option instructs ShowRip to display
each of the commands, as it reads them, in text mode. The
useful part of this utility is that it decodes each of
these commands for you (RIP only for now). It shows you
the command, gives you a description of that command, and
lists all parameters associated with it. It converts the
meganums to decimal and color nums to english! This is a
good option to use to learn the cryptic RIP protocol.
Works well with the /ega option below.
/ega This option changes to EGA or VGA text mode and displays
all text from the /o option using 43 or 50 lines. This
allows you to see more of what is going on at one time
because you can't scroll back :( (yet?!?!)
/of Outputs to a text file. This option is an extension of the
/o option above. This option echos everything to a text
file so you can display it later (and scroll up and down).
The filename is the same as the RIP file, only it has a TXT
extension. This is a great tool for learning RIP.
EXAMPLES:
SHOWRIP filename.rip // shows the file
SHOWRIP filename // same as above
SHOWRIP filename /c // shows the file and displays
commands at bottom of the screen
SHOWRIP filename /c /d 500 // same as above + pauses half a
second between commands
SHOWRIP filename /o /d 1000 // shows commands only, no graphics
+ delays for a full second be-
tween commands. Use this with
the p key to pause even longer
while debugging.
SHOWRIP filename /s /o // same as above except no delay,
this one waits for a key press
between commands.
SHOWRIP filename /s /o /EGA // same as above except will show
more info per screen. 43 or 50
lines per screen vs 25 stndrd.
SHOWRIP filename /d 3000 // Watch it draw real slow!
SHOWRIP filename /of // outputs the /o info to a file
called filename.TXT
More Syntax RULES:
Most options can be used together or alone. Some combinations are not
logical but they will work just the same. (Delay and Step mode
together!?!?) Some options enhance other options, so try them all.
The /c option will not work with the /o option as this would cause a
mess on your screen. The /ega option only works with the /o or /of
option as these commands only change the text mode.
Options can be in any order as long as nnn follows /d and as long as
the first parameter is the Rip filename. When specifying the file
name, the extension is now optional, but will be assumed to be RIP if
omitted.
While SHOWRIP is processing a file, pressing:
<ESC> Will abort and return to DOS.
c Toggles /c option 'Show Commands' mode.
s Toggles the /s option 'Step' mode.
p Pauses the screen until a key is pressed.
<SPACE> Returns to DOS if one filename was specified. If you specified
more than one file on the command line by using wildcards, this
key will step to the next file until the last file of the
wildcard match is reached. Pressing the space bar again will
exit to DOS. If you press the space bar before a file is
finished being displayed, that file will be canceled and the
next file will start.
After a screen is finished, pressing any other key will display the
filename and size at the bottom of the screen. This is a helpful
little addition for when you have to search through 10 billion RIP
files for that one that you want, and then you want to see the filename
so you don't lose it again!
More to come!
Every effort has been made to test this software for inconsistencies
and especially for stupid bugs! However, I have been known to miss a
bug now and then :) So if you find something that just doesn't seem
right, please let me know.
Comments, suggestions, and registration,
Chuck Warrix NyteBytes BBS
3430 Lacon Road (614) 529-1464
Hilliard, Ohio 43026 14400 v.32 bis
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
R E G I S T R A T I O N
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
NOTE: If you have registered an earlier version of ShowRip, you are
entitled to free upgrades. Just call NyteBytes and D/L the latest!
There are now two versions of ShowRip, the full featured version and
ShowRip Lite. If you are interested in ShowRip Lite, D/L Shwlitxx
(where "xx" is the version #). I have also released an icon viewer as
FREEWARE. If interested Please D/L file ShwConxx (again "xx" is the
version #). ShowRip Lite is for people who don't need or want the
extended features of ShowRip.
Registration is only ten bucks for ShowRip and five bucks for ShowRip
Lite. As a registered user of either you are entitled to all updates
as available.
After I receive your payment and registration form, I will set up an
account for you on NyteBytes BBS and give you access to a private file
area. Registered users may call NyteBytes anytime to D/L current
releases of ShowRip as often as they like.
Make sure that you log on to NyteBytes BBS using the same name and
password that you give on the registration form (next page). You must
provide this information for me to set up an account for you in
advance. I CAN NOT set up an account for you if you don't give me a
password to use.
Please allow up to 7 days for your registered copy to be posted from
the time that you mail your payment. My job requires that I travel and
some times I end up on the road away from the BBS for most of the week.
Not very often though <G>
If you prefer, I will mail your copy on 3.5 floppy. Please include the
appropriate amount for shipping and handling if you want this option
(see form below).
╔═════════════════════════════════════════════════════════════════════════╗
║ S H O W R I P R E G I S T R A T I O N F O R M ║
╠═══════════════════════════════════╤═════════════════════════════════════╣
║ │ ║
║ │ ║
║ Name___________________________ │ BBS Name__________________________ ║
║ │ ║
║ │ ║
║ Add1___________________________ │ BBS # __________________________ ║
║ │ ║
║ │ ║
║ Add2___________________________ │ PSSWRD __________________________ ║
║ │ **(to logon NyteBytes)** ║
║ │-------------------------------------║
║ City___________________________ │ ShowRip ........ $10.00 ║
║ │ ShowRip Lite ... $ 5.00 ║
║ │ Shipping........ $ 4.00 (optional) ║
║ State________ Zip_____________ │ ║
║ │ AMOUNT ENCLOSED $_________ ║
╠═══════════════════════════════════╧═════════════════════════════════════╣
║ ║
║ Where did you hear about ShowRip? ║
║ [ ] NyteBytes BBS [ ] MSI BBS ║
║ ║
║ [ ] other ________________________________________________ ║
║ ║
║ ║
║ What version are you using now? ______________________ [ ] Lite? ║
║ ║
║ What options have you used so far? ║
║ [ ] /c [ ] /o [ ] /of ║
║ [ ] /s [ ] /ega [ ] /d nnn ║
║ ║
║ What options are most helpful? ║
║ [ ] /c [ ] /o [ ] /of ║
║ [ ] /s [ ] /ega [ ] /d nnn ║
║ ║
║ What is your level of RIP knowledge? ║
║ [ ] beginner [ ] I get by [ ] guru <g> ║
║ ║
║ Do you write software? If so what types? ║
║ [ ] personal [ ] gen shareware [ ] BBS doors ║
║ ║
║ [ ] other _________________________________________________ ║
║ ║
║ ║
║ COMMENTS:_____________________________________________________ ║
║ ║
║ ║
║ ______________________________________________________________ ║
║ ║
║ ║
║ ______________________________________________________________ ║
╚═════════════════════════════════════════════════════════════════════════╝
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
T E C H N I C A L I N F O R M A T I O N
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
ShowRip was written in Turbo C++ ver2.0 on a 386DX/40 w/ 8megs RAM
RETURN CODES (ERRORLEVEL)
Everything worked ok 0
No filename specified 99
File open/not found error 98
Graphics error 97
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
H I S T O R Y
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
07/26/93 ver 1.0ß
First public release
07/26/93 ver 1.1ß
Linked in the BGI graphics driver
07/30/93 ver 1.2
1. Linked in all fonts so everything is in one executable file.
This made th EXE a little bigger, but now you don't have to have
all those CHR files around.
2. You don't have to specify the RIP extension (optional).
3. Added four command-line options:
/d nnn Delay nnn milliseconds between each Rip command.
/s Step Mode - Press a key between each command.
/c Show the command at the bottom of the screen.
/o Show only the Rip commands, no graphics.
4. Bezier curves now work like they should!
08/01/93 ver 2.0
1. Added some keyboard input while SHOWRIP is processing. (see above)
2. Complete re-write on the Command Only '/o' option! While in this
mode, SHOWRIP will show you just about everything you want to
know about the commands it is reading. It completely decodes them
into easy/easier to understand format. GREAT for debugging RIP files
written with a text editor.
3. I plan to modify the '/o' command to output to a .TXT file or to
a printer. Another day...
08/09/93 ver 2.2
1. Fixed a bug in the polygon functions. ShowRip now closes the
polygons for you. It is still good practice when creating a RIP
file to close them in the RIP command.
2. Added some more detail to the /o (COMMAND ONLY) option. Now shows
a graphic representation of the 8x8 fill pattern. Also more detail
on TEXT_WINDOW and FONT_STYLE, and a few more.
08/13/93 ver 2.3
1. Fixed a (stupid!) bug in the main module. Before when you hit p
while processing, ShowRip would pause, but then put you in a step
mode (not what I intended). Now hitting p pauses until any key is
pressed and then resumes normal operation.
2. Added an EGA/VGA text mode for the /o option to allow you to see
more commands on the screen at once. The new command is '/EGA'.
3. Changed the way the RIP_SET_PALETTE displays in the /o mode. It
used to tell you the name of the color or out of range. Now it
just gives you the color number. I couldn't have it show the colors
in the actual palette because it would require changing the palette
which would screw up the rest of the screen. So for now in this
command only, the color numbers are correct, but the color they
are displayed in may not be.
08/14/93 ver 2.4
1. Added a new option (/of) to export the /o information to a text file
to be printed or whatever else you like to do with text files. This
was probably the number one most requested upgrade. So here it is:)
I didn't have much time to test this option so . . . let me know.
08/28/93 ver 2.9a This is a sneak preview of ver 3.0 which is coming soon.
1. ShowRip now reads and displays all @ and ANSI codes! This means
that those old .BBS or .ANS screens that you just added a RIP
header to, can be displayed or decoded (/o option) using ShowRip!
Currently there is no detailed information, only raw codes for @
and ANSI when using the /o option. (support in ver 3.0?)
2. Fixed a bug (stupid!!!) in the the function that displays a single
pixel. It should work a little faster now with files containing a
lot of |X commands. This bug also locked up your PC on some RIP
files. (I hate when that happens!)
3. Added code to partially support the RIP clipboard. ShowRip will
now work on some of those files containing animation. It used to
display a bunch of colors and sometimes (again) lock up ;(
09/12/93 ver 3.01
1. Added the ability to use wildcard file names. Read the
information above for details.
2. Fixed a centering problem with button labels.
3. Minor changes / enhancements to the ANSI interpreter.