                                  RIP2 Now
                                 ----------

Here is the way we are using the commands available in RIP 2 to add jpg, bmp 
and wav files to our rip screens.  The paint program is not out to support 
version 2 but the commands are in the new RIPterm pro terminal 2.00.01 program,
for all to take advantage of now.

Rip is based on the terminal accepting commands and doing things locally. The 
rip screen on a bbs tells the users bbs what to do. So if the screen says play 
a wav and the terminal accepts this command and the wav is at the correct place
on the terminal end then the wav is played. The same thing happens with the 
other commands like display a jpg, display a bmp, draw square, etc. It is the 
combination of the screen and the terminal that produce these effects. We now 
have the terminal, so we need to produce the screens to have these effects.

Yes,it will be easier with the paint program to do this but if you don't want 
to wait you can do some now with a text editor. This is the method we use, you 
may fine an easier way and if you do please share it with us.


-------------------------------------------------------------------------------
First to be able to view what your doing we setup the RIPterm2 terminal program.  
This is to view our progress and help with the editing of the screens. All of 
this is in the docs but it is easy to miss items.

I load the terminal program with the command ripterm -o (made a little bat file)
which does not load the modem and allows the use of the program for viewing and
dropping to DOS, etc. This way you can move back and forth between viewing and
the changes you make.

Then I add an option that puts an editor in the program (makes it easier to edit
script). From the RIPterm menu select file then edit external to add an external
application. You can add you favorite text editor (qedit etc.) use description 
area for the name of the editor, command is what is needed to run the editor. 
This will allow you to have a rip screen in a directory and make a change, view,
adjust, view, etc.

To start I would recommend that you decide what you want to add for options and
write them down as well as putting them in the directory to use when creating 
the screens. This would be the wav, bmp and jpg files.

It is easier for me to create the screen I want with RIP paint optimize it and
save it. Then turn optimize off on the save screen option (if you optimize you
lose the new commands).

Warning is do not optimize the screen after you add these commands as the
current RIP paint takes the commands back out.


--------------------------------------------------------------------------------
RIP_PLAY_AUDIO command.

If you want to add a wav file to a rip screen you make a note of the name of the
wav file. Bring up the rip screen with a text editor and before the last line 
add this new line with your changes.:

!|1w0000nameit.wav

That is an exclamation mark, pipe, number one, small w, four zeros, then the 
name of the wav file that's it, above example we have nameit.wav as the file we 
are adding. Some waves will play when placed anywhere on the screen and some 
need to be near the end. This is using the new RIP_PLAY_AUDIO command.


--------------------------------------------------------------------------------
Adding BMP JPG RIP

You must create a place for bmp, JPGs, and rips on the screen, you will need to
define the size of the item (BMP,etc.). You could have the same bmp display a 
number of times at different locations and different sizes depending on the 
size of the field you define. The same thing goes for  JPGs, they could be at 
different locations and sizes. You must define the size of these items as they 
will display according to the defined area and location.

What that means is you need to make a rectangle of the size and location you 
want the items displayed. We will then use that info to place the item there.

What we will be looking for in the following examples is the location and size 
you want the items. How this is accomplished at this time is to create the 
rectangle then use the info for the feature.

Example One :
BMP

Select a RIP screen you have completed and want to add a bmp to. Load that
screen with the paint program and save it. Then turn optimize off and select
draw a rectangle no fill just the rectangle. Now draw a rectangle the size and 
location you want the bmp to be displayed, then save it.

OK now the fun part, leave the paint program, and load RIPterm2, select the
external application and the editor. Using the editor load the rip screen you 
just saved. Look for the command you just added it should be next to the end. 
For a rectangle it will have !|R as a start of the line. What your looking 
for is all of that information.

Now edit it to read:
!|1b########0001000000thename.bmp

So this will now read Exclamation point, pipe sign, number one, small b(for BMP)
the eight pound signs are the location letters and numbers from the rectangle 
line, three zeros, number one, six zeros, and the name of the BMP with 
extension. This will display a BMP at the location and size you made the 
rectangle.

Now save and exit the editor and from the terminal program select view a screen. 
Select the location and name of the screen you just edited and it should 
display with the BMP at the location and size. Make sure the bmps and all the
items you're going to be adding are available in your ripterm directory for it
to use.


-------------------------------------------------------------------------------

Example Two :
RIP Screens:

!|10000$>FILENAME.RIP$
!|#|#|#|#


This will play back a large RIP screen that exist on the caller's system.
The rip command !|10000$>FILENAME.RIP$ tells rip to display the file
FILENAME.RIP, and it pops up instantly on their end, no matter how large it is.
The  symbol can be obtained by holding down your ALT key and hiting the numbers
1 and 2 on your ten key pad. 


--------------------------------------------------------------------------------

Example Three:
RIP_IMAGE_STYLE

This is a two part command, first we need to create the location and size for 
the JPG, then we need to tell the program what JPG to display. This will be the
same as previously dome for the BMP.

Select a RIP screen you have completed and want to add a JPG to. Load that 
screen with the paint program and save it. Then turn optimize off and select 
draw a rectangle no fill just the rectangle. Now draw a rectangle the size and 
location you want the bmp to be displayed, save it. 

Leave the paint program, and load RIPterm2, select the external application and
the editor. Using the editor load the rip screen you just saved. Look for the 
command you just added it should be next to the end. For a rectangle it will 
have !|R as a start of the line. What your looking for is all of that 
information. 

Now edit it to read:
!|1i########000100000000000

So this will now read  Exclamation point, pipe sign, number one, small i 
(for image), the eight pound signs are the location letters and numbers from 
the rectangle line, three zeros, number one, eleven zeros.This will display an
image file at the location and size you made the rectangle. 

You now must tell what file to display at that location. This is done with the 
command line:
!|1p0000FILENAME.JPG

This reads Exclamation point, pipe sign, number one, small p, four zeros, and 
the name of the JPG. Then to display a jpg called filename.jpg at location and 
size on the rip screen it would be.

!|1i########000100000000000
!|1p0000FILENAME.JPG

Each time you edit the rip screen you can exit out of your editor that will 
return you to the terminal program. Then select file, then show local RIPscrip 
file, then type the directory and the name of the rip file and it will display 
with the features you just added.



There are a number of examples in this package:
1st.rip is an example of a wav file in a screen.
2nd.rip is an example of a screen with different size  rectangles.
2nd-b.rip is the same screen as 2nd.rip but the script was changed for BMP
2nd-j.rip is the same screen as 2nd.rip but the script was changed for JPG
Additional examples are login.rip, main.rip, tutor.rip, and  rip2menu.rip

The wav file RIPTERM.wav is included with your RIPterm2 terminal program. It
is used in one of the example wav screen inclosed. So you must have it 
available for the sound to work. Also you need a sound card for the sound etc.

This text file was produced by Vince Jacobs and Bill Pommenville. It is only a 
help file that explains how we use RIPscript and ripscript 2 as well as RIPterm
Pro 2.00.01. We are not stateing that you should do these things or if you do 
that they will work for you. 

There is an additional file called readme2.txt which may explain it a little 
clearer or more technical depending on your experience. 


RIPscript is a registed trade mark of TeleGrafix Communications,Inc.
