<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Menus and hot keys</TITLE>
</HEAD>
<BODY>
<CENTER>
<A HREF="index.html">Home</A> |
<A HREF="rules.html">Rules</A> |
<A HREF="authors.html">Authors</A> |
<A HREF="mailinglists.html">Mailing lists</A> |
<A HREF="fanfic.html">Fanfic</A> |
<A HREF="options.html">Menus and hot keys</A> |
<A HREF="network.html">Network game</A> |
<A HREF="parameters.html">Command line parameters</A> |
<A HREF="platforms.html">Platform specific issues</A> |
<A HREF="userlevels.html">User levels</A> |
<A HREF="algorithm.html">Core algorithm</A> |
<A HREF="source.html">Source code</A> |
<A HREF="bugs.html">Bugs</A> |
<A HREF="todo.html">To do</A> |
<A HREF="wip.html">WIP</A> |
<A HREF="copying.html">Copying</A>
</CENTER>
<HR>
<CENTER><H1>Menus and hot keys</H1></CENTER>
<HR>
<H2>Introduction</H2>
<P>This section describes how the GUI works.
Since programming advanced GUIs with Allegro is not so easy
- standard C programming definitely lacks flexibility -,
and also since it's somewhat hard for me to figure out what
is user-friendly and what's not, Liquid War's menus are not
always self-explanatory. I'll just try and do something
better next time!</P>
<HR>
<H2>Menus</H2>
<H3>Map menu</H3>
<P>The map menu allows you to choose the map you are going to play on.
A map is defined by 3 things:</P>
<UL><LI>A frame.
The frame can be chosen with the slider which is below the preview.
The frames are automatically sorted by alphabetical order.</LI>
<LI>A texture for walls.</LI>
<LI>A texture for the zone where fighters are allowed to move.</LI>
</UL>
<P>In the middle of the screen, there is a preview of the level.
In this menu, the values of the parameters can be independently changed by:</P>
<UL><LI>Moving a slider.</LI>
<LI>Clicking on a "+" or a "-" button.</LI>
<LI>Typing a number.</LI>
</UL>
<P>On each side of the preview, sliders allow you to choose the two textures.
There is also a preview of each texture.
Below this preview there are 128 little buttons which allow you to choose single colored textures.</P>
<P>The name of the map and its resolution are displayed in the lower
part of the screen.</P>
<P>You'll notice that on some maps the texture selection zones simply
disappear. This is because these maps are associated with a texture,
so choosing a different texture is often not recommended for it
won't look as nice as with the right one. If you still want to
override this behaviour you can click on the "on/off" button just
right to the "Use default texture" label. This is a toggle button
which will allow you to use your own textures even on maps that
normally come with their own skin.</P>
<P>You'll also notice that a "Random map" button is available.
This button generates a new random map using an external program,
"lwmapgen", developped by David Redick, available on
<A HREF="http://www.cs.clemson.edu/~dredick/lwmapgen/">www.cs.clemson.edu/~dredick/lwmapgen/</A></P>
<P>This program supports many command line options, and if you want
a very precise control on the generated maps, you'll need to run
it separately. Looking at LW's log file you should be able to
see the commands LW issues when calling this program, this can
give you ideas on how to launch it manually. Alternatively
using the "--help" option (for instance "liquidwar-mapgen --help"
under UNIX) should describe how to use it.</P>
<H3>Teams menu</H3>
<P>This menu allows you to choose the teams which are going to play.
There are 6 square zones in this menu.
Each of them is associated to a team.</P>
<P>Each team can be either:</P>
<UL><LI>Disabled ("Off")</LI>
<LI>Controlled by a player ("Human")</LI>
<LI>Controlled by the computer ("Cpu")</LI>
</UL>
<P>The computer plays poorly, so remember that Liquid War is basically
a multiplayer game, and that the cpu control is dedicated to beginners only.</P>
<P>You can also choose the color associated to each team by clicking on one
of the 12 colored buttons.</P>
<P>Below the 12 colored buttons, there are four buttons which allow you
to choose your keys.
Click on one of these buttons and then press the key you want to define.
Joystick movements and buttons are considered as keys.
You can disable the joystick with the button which is at the bottom left of the menu.
Mouse input is also possible, and mouse movements are considered as keys too.
To define mouse control, click on the button associated to the direction
you want to control, and then move the mouse.
Then the button should display something like "M->".
Mouse sensibility can be set with the little slider at the bottom right of the menu.</P>
<H3>Graphics menu</H3>
<P>Here you can choose the graphic options of the game.</P>
<P>The "Video mode" button allows you to switch between fullscreen and windowed mode. This button is not available under DOS.</P>
<P>The "Brightness" slider allows you to set the brightness of the game.</P>
<P>The "Menu res" slider allows you to set the resolution used by the menus.
There are currently 5 possible values, which depend on which platform
you're running the game on.</P>
<P>I personnaly think the menus look best with the 640x480 resolution,
but some may prefer higher resolutions.
Lower resolutions should only be used if you have problems using SVGA video modes.</P>
<P>The "Game res" slider allows you to set the resolution used during the game.
The allowed values are the same than those for the menus.
I recommend that you don't use resolution higher than 640x480,
unless you have a Pentium VIII running a 10GHz.</P>
<P>Page flipping can be toggled.
It is up to you to decide wether you keep this option or not.
The main disavantage of turning page flipping off is that
the info bar and the battlefield can look rahter ugly if they overlap.
But if you turn page flipping on you will not easily reach
the 166 frames per second I sometimes get on small levels with my K6-225.
I personnaly always turn page flipping off.</P>
<P>The viewport size defines how much of your screen will be used by the battlefield.</P>
<UL><LI>If you set the slider on its left position, the batllefield will not be stectched at all.
Or if is strechted, it will be by a x2 or a x4 factor.
So this is the mode wich allows the fastest display.</LI>
<LI>If you set the slider ont its right position, the game will run in fullscreen mode.</LI>
<LI>With all the other positions of the slider, the battlefield will keep
its general proportions but it will be stretched.</LI>
</UL>
<P>The "Waves" button allows you to toggle the wave effect. You can also
do this while playing, by simply pressing F4.</P>
<H3>Sound menu</H3>
<P>This section allows you to set the sound volumes. There are 4 sliders, which are:</P>
<UL><LI>"Sfx": sets the volume of all the sfx sounds,
thats to say'the sounds you hear when the game starts, when you loose etc...</LI>
<LI>"Click": sets the volume of the click, this nasty noise you hear
each time your press on a button.</LI>
<LI>"Game water": sets the volume of the blop blop blop sounds
which are played continuously while you are playing.</LI>
<LI>"Menu water": the same thing than "Game water" except
that it concerns the sounds played while your are choosing options.</LI>
<LI>"Music": general music volume.</LI>
</UL>
<H3>Rules menu</H3>
<P>This menu is the one where you can change the rules of the game.</P>
<P>The "Time" slider controls the time limit.
The game will stop after this time is elapsed.
You can pause the game by pressing the "F3" key.</P>
<P>By the way, an info bar can display the time left while you are playing.
This info bar can be toggled during the game by pressing
the "F1" key, and you can change its location by pressing the "F2" key.
It also displays how many fighters there are in each team.</P>
<P>The "Army size" slider controls the amount of fighters there will
be on the battlefield. The position of the slider reflects the amount
of fighters of all the teams together. If there are 4 teams,
then each player will have half as many fighters
than if there had only been 2 teams.</P>
<P>The "Cursor x" slider controls the speed of your cursor.</P>
<UL><LI>If it is set on the left, the cursor goes at the same speed than the fighters.</LI>
<LI>If it is centered, the cursor goes twice faster than the fighters.</LI>
<LI>If it is set on the right, the speed of the cursor is multiplicated by 3.</LI>
</UL>
<P>Below is a "Min 160x100" box with a slider on its right. This means that
maps will automatically be magnified so that they have a size of at least 160x100.
Indeed, some of the maps that come with Liquid War were designed in 1995
when 486 Intel computers were common. Therefore the maps were smalls.
Today, these maps are not really fun to play on fast computers,
so Thomas Harte suggested this automatic magnifying feature, and that was
IMHO a smart idea. You can move the slider to the right to make maps use
a higher resolution - ie magnify them.</P>
<P>The "Defaults" button of the "Rules" menu will reset rules to their
defaults. This way you can tweak rules and then come back to the
default rules whenever you want. Note that there's also a "Defaults"
button in the main "Options" menu, but it will reset *all* options,
including player names... The advantage of the "Defaults" button
in the "Rules" menu is that it will only reset rules parameters,
and keep the rest of your configuration options untouched.</P>
<H3>Speeds menu</H3>
<P>The "frames/s" slider allows you to limit the number of frames per second.
If this slider is set on the left, there won't be any limit, so Liquid War
will repaint your screen each time the fighters move.
But this can be a weird behaviour if your machine is really fast,
for no one cares about 100 fps per second, one can not even see them...
So this paramters limits the refreshment rate, so that there can be
several logical moves of the fichters for only one screen refreshing.
If it is set on its right, the display is limite to 10 fps,
so you'll have to find your setting.
I personnally set it right in the middle, and get 40 fps.
If you press "F5", you'll get the number of frames per second,
and if you press "F6", you'll get the number of logical moves per second.
You can also press "F7" or "F8",
and you will get the percentage of time your computer
spends on calculating or displaying the level.</P>
<P>The "rounds/s" slider allows you to limit the number of rounds per second.
If this slider is set on the left, there won't be any limit, so Liquid War
will run as fast as possible.
This setting will be of no use if you use Liquid War on a slow
computer or if you play with hudge maps, but sometimes, with a high-end
Pentium class computer, it's simply impossible to play on small maps
because things simply go too fast. So this parameter is here to
help you and avoid the "10000 moves per sec" problem.</P>
<H3>Waves menu</H3>
<P>This is where the wave parameters are set.
The waves are just a graphic effect, which is not really usefull.
I don't often use waves, but I still think they can sometimes look nice.
Change these parameters if you really mean to do it,
but if you don't understand what they mean, it is really OK...</P>
<P>There are 4 different types of waves, each of them being defined by:</P>
<UL><LI>An "Ampli" parameter, to define how big the waves have to be.</LI>
<LI>A "Number" parameter, to define how many waves should be
displayed at the same time.</LI>
<LI>A "Speed" parameter, to define how fast the waves should move.</LI>
</UL>
<P>If you want to undestand what the
"WX", "HY", "WY", and "HX"
codes mean, try to pay with only one type of wave,
the "Ampli" parameter of the 3 other types of wave being set to 0
(that is to say the slider is on its left position),
and sea how it looks like.</P>
<P>The wave effects can be toggled during the game by pressing the "F4" key.</P>
<H3>Advanced menu</H3>
<P>This menu allows the user to change the behaviour of the fighters.</P>
<P>The "Attack" slider sets the agressivity of the fighters.
If it is set on the right, fighters eat each other very fast.
If it is set on the left, it takes ages to fighters to change teams.</P>
<P>The "Defense" slider sets the capacity
that the fighters have to regenerate themselves.
The more it is on the right, the faster fighters regenerate.</P>
<P>The "New health" slider sets the health of the fighters
which have just changed teams. The more it is on the left,
the weaker these fighters will be.</P>
<P>The "Winner help" slider controls a parameter which causes
fighters to attack with various strength depending on
how many fighters belong to their team.
Not very clear...
Let's just say that:</P>
<UL><LI>If this slider is set on the right,
the more fighters you have in your team,
the more aggressive they will become.</LI>
<LI>If it is centered, all the fighters of every team will
always attack with the same strength.</LI>
<LI>If it is set on the left,
the less fighters you have, the stronger they will be.
In this mode, games usually never end.</LI>
</UL>
<P>The "Cpu strength" parameter never makes the computer
more intelligent than a monkey.
But if you set it on the right, it advantages the machine
outrageously and fighters controlled by the cpu
will be really strong. So to get rid of them you'll
definitely need to be clever.
Again and again, don't forget that Liquid War was conceived
as a multiplayer game and that playing against the computer
is not really an interesting thing to do.</P>
<P>The "CPU vs human" parameter allows you to control how aggressive
CPUs are towards humans.</P>
<UL><LI>If set to "Always", CPUs will always attack humans
and will never try to attack another CPU, unless there are
no humans left. This used to be the default behavior in
previous Liquid War versions, but some players remarked that
it was rather unfair, so now this is an option.</LI>
<LI>If set to "Random", CPUs won't care wether their opponents
are CPUs or humans, they'll attack anybody. This is the
default behavior.</LI>
<LI>It set to "Never", CPUs will attack each other before
bothering human players.</LI>
</UL>
<P>The "Allow net bots" button can be used to allow bots to
connect on network games. Indeed, bots are by default disabled
in network games, since in this case LW assumes that bots are
useless (there are already several human players). However,
turning this option on will allow you to connect bots within
the game. It's important to note that this is a per client
option, this means that you can't use it to forbid access to bots
to a given network game. This option was simply created to
avoid confusion when connecting on network games, while still
allowing bots to connects if you really want them to.</P>
<P>The "Algorithm" parameter allows you to force the algorithm
to standard C mode. There's no real good reason you would like
to do this, since the C algorithm is slower than the ASM one.
Moreover, the ASM algorithm is automatically disabled if you
play against a computer which does not have ASM enabled.
Think of this as a testing/debugging option.</P>
<HR>
<H2>Hot keys</H2>
<P>Here's a list of keys you might use while playing:</P>
<UL><LI>F1: toggles the "info" zone where the game time and the
state of each team is displayed.</LI>
<LI>F2: moves the "info" the zone arround, possible positions
being top, right, bottom and left.</LI>
<LI>F3: pauses the game. This function is disabled during
network games.</LI>
<LI>F4: toggles the "wave effect". Without this "wave effect",
which is turned on ny default,the game will run faster.</LI>
<LI>F5: displays the number of frames per second (*).</LI>
<LI>F6: displays the number of rounds per second (*).</LI>
<LI>F7: displays the precentage of CPU spent on the game
logic, calculating where fighters must go for instance (*).</LI>
<LI>F8: displays the precentage of CPU spent on graphics (*).</LI>
<LI>F9: turns on/off the "capture" mode. In this mode, screenshots
of each frame are taken, and written to the hard drive as
bitmaps.</LI>
<LI>F10: quits the game right away without any confirmation prompt,
also known as the "my boss is coming here!" function.</LI>
</UL>
<P>(*) all these figures tend to be clearly false as computer go
faster and faster. Basically, the time required for "logic" and
"display" operations is getting shorter and shorter, and the
tools I use to measure it are not precise enough. Therefore I
get approximations which might by plainly wrong.</P>
<HR>
<CENTER>
This documentation is also available on:
<A HREF="http://www.ufoot.org/liquidwar/v5">www.ufoot.org/liquidwar/v5</A>.
</CENTER>
</BODY>
</HTML>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
c207deb72ab596da49d9bdeb34dd25fe
>
files
>
16
