MMTommyGunMessage Manual

Developed by Anibal Wainstein

Copyright Mandomartis Software Company 1999, all rights reserved

 

 

INTRODUCTION

This applet brings the gangsters of the twenties back to life. Use this applet to create your territorial mark! The applet has the following features:

  • You can enter several messages with descriptions and URLs. The URLs are invoked when you click on the message.
  • Supports a background image.
  • The lightning effect is calculated in real-time and you can change the light beam size, dispersion, color and strength.
  • The font can be specified and you can set several parameters such as the size, coarseness and position alignment.
  • Fully compatible with Visual Applet Configurator.
  • Confirmed compatibility with Netscape versions 3.01 to 4.5 and Microsoft Internet Explorer versions 3.0 to 4.1 for Windows 95/98/NT4. Also compatible with Internet Explorer 4.5 for Macintosh.

Before using this applet you must read the license agreement. Note that the VAC links in this manual will only work if you have installed this applet properly and to the same location as the VAC folder.

DEPENDENT FILES

The following files must be included with the applet in order for it to function properly:

tommyfire0.gif, tommyfire1.gif, tommyfire2.gif, tommyfire3.gif, tommyfire4.gif,
tommyfire5.gif, tommyfire6.gif, tommyfire7.gif, tommyfire8.gif,
tommygun0.gif, tommygun1.gif, tommygun2.gif, tommygun3.gif, 
tommygun4.gif, tommygun5.gif, tommygun6.gif, tommygun7.gif, tommygun8.gif,
machinegun.au, mmtommygunmessage.class

If you wish to disable the sound in the applet then you should not include the machinegun.au file with the applet. Note that all these files must be uploaded in binary format. If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section:

 

GENERAL PARAMETERS

The game is an applet and configurable with normal HTML applet parameters. The first thing that must be done is to configure the applet main tags:

<APPLET CODE="mmtommygunmessage.class" WIDTH=450 HEIGHT=150>
</APPLET>

As you can see, the size in the example is 450x150 pixels. You can change the dimensions to whatever size you wish. However, you take note that a big applet requires more processing power which may be hard for some computers. The following parameters may not be changed:

<PARAM name="mandomartis0" value="MMTommyGunMessage is a freeware applet from Anibal's Violent Playground Applet package">
<PARAM name="mandomartis1" value="It was developed by Anibal Wainstein / Mandomartis Software Company">
<PARAM name="mandomartis2" value="Get it for FREE at http://www.mandomartis.com/violentplayground/">

These are Mandomartis credits are are used to identify the applet. The following parameter controls the general frame delay in milliseconds, and thus the frames per second (FPS). The default value is 60:

<PARAM name="delay" value="60">

If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section:

 

SETTING UP THE MESSAGES WITH DESCRIPTIONS AND URLS

Write each message using the "message" parameter in the following manner:

<PARAM name="message0" value="MANDOMARTIS">
<PARAM name="message1" value="WAS HERE"> <PARAM name="message2" value="HELLO">

The parameter "message0" is for the message on the first page, "message1" for the message in the second page and so on. The same system of adding items is applied for the page descriptions ("itemmessage") and the URLs ("url") respectively:

<PARAM name="itemmessage0" value="Click here to go to Mandomartis' page">
<PARAM name="itemmessage1" value="Mandomartis was here!"> <PARAM name="itemmessage2" value="Hello!">
<PARAM name="url0" value="http://www.mandomartis.com/">
<PARAM name="url1" value="http://www.washere.com/"> <PARAM name="url2" value="http://www.hello.com/">

Now the content of "itemmessage0" will be displayed in the page that the content of "message0" appears. If you click on that page then the applet will jump to the URL "http://www.mandomartis.com/". Note the "http://" and the host on each URL. You MUST specify full URLs. Relative URLs will not work with this applet.

If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section:

 

SELECTING COLORS

The "lightcolor" parameter should have very low values:

<PARAM name="lightcolor" value="0b0b0a">

By having different strengths of the RGB components in the parameter you can obtain different light colors. However, note that each color component's hexadecimal value should not be greater than "2f", if you want to obtain good results. The "holecolor", "backgroundcolor", "itemmessagecolor" each handle the shot hole color, the background color (only effective if you do not use a background image) and the description text color respectively:

<PARAM name="backgroundcolor" value="000000">
<PARAM name="itemmessagecolor" value="ffffff">
<PARAM name="holecolor" value="ffffff">

If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section:

 

FONT PARAMETERS

Note that this applet does not use fonts in the traditional way. The font type affects the message appearance slightly, but the font size onlyaffects the number of holes rendered:

<PARAM name="font" value="Helvetica">
<PARAM name="fontsize" value="30">
<PARAM name="coarseness" value="4">

We do not recommend changing the values above. By adjusting the "fontsize" and "coarseness" parameters you can increase the readability of the text, but on the other hand you could make it completely unreadable. The fontsize effect is actually replaced by the "textheight" parameter which will enlarge the text to the height in pixels specified.

<PARAM name="textheight" value="50">
<PARAM name="centertexty" value="No">
<PARAM name="centertextx" value="Yes">

The "centertextx" and "centertexty" parameters are for centering the text on horizontal and vertical directions to the middle of the screen.

If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section:

 

OTHER PARAMETERS

The background image can be specified by the "backgroundimage" parameter:

<PARAM name="backgroundimage" value="background.gif"> 

This parameter overrides the "backgroundcolor" parameter's effect if specified. The "sleeptime" parameter affects the pause before next message appears and you specify the value in milliseconds:

<PARAM name="sleeptime" value="2000">

The "beamsize", "dispersion" and "lightstrength" parameters affect the light beam size, dispersion (widening) and strength:

<PARAM name="beamsize" value="7">
<PARAM name="dispersion" value="3">
<PARAM name="lightstrength" value="2">

Note that you increase the dispersion and strength by decreasing the values in "dispersion" and "lightstrength". If you want the tommy gun to shoot a bit inaccurately, then increase the "shotdispersion" parameter:

<PARAM name="shotdispersion" value="2">

This value should not be too high as the text will become unreadable. Use the "machinegunydisplacement" to adjust the vertical position of the tommy gun while shooting. If you decrease this value then the tommy gun is displaced from the screen.

<PARAM name="machinegunydisplacement" value="50">

If you are using frames and you want the URLs to be invoked in another frame, then specify the name of the frame in the "target" parameter:

<PARAM name="target" value="_top">

The values "_top", "_self", "_left" and so on, are standard built-in HTML target frames.

If you are using this applet together with Visual Applet Configurator, then you should read the following VAC manual chapters concerning this section: