From c90c389a8a8d9d8661e9772ec4144c5cf2039f23 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/kspaceduel/Makefile.am | 4 + doc/kspaceduel/index.docbook | 659 +++++++++++++++++++++++++++++++++++++++++ doc/kspaceduel/kspaceduel3.png | Bin 0 -> 34970 bytes 3 files changed, 663 insertions(+) create mode 100644 doc/kspaceduel/Makefile.am create mode 100644 doc/kspaceduel/index.docbook create mode 100644 doc/kspaceduel/kspaceduel3.png (limited to 'doc/kspaceduel') diff --git a/doc/kspaceduel/Makefile.am b/doc/kspaceduel/Makefile.am new file mode 100644 index 00000000..368fc0da --- /dev/null +++ b/doc/kspaceduel/Makefile.am @@ -0,0 +1,4 @@ + +KDE_DOCS = AUTO +KDE_LANG = en + diff --git a/doc/kspaceduel/index.docbook b/doc/kspaceduel/index.docbook new file mode 100644 index 00000000..2d3cc2b7 --- /dev/null +++ b/doc/kspaceduel/index.docbook @@ -0,0 +1,659 @@ + + + + + +]> + + + +The &kspaceduel; Handbook + + + +Andreas +Zehender + +
az@azweb.de
+ + + + + + +19992000 +Andreas Zehender + + +&FDLNotice; + +2003-09-17 +1.1 + + +&kspaceduel; is an space arcade game. +Two ships fly around the sun and try to shoot eachother. + + + + +Space duel +KDE +game +ships +shooting + + + + + +Introduction + +&kspaceduel; is an space arcade game for two players. + +Each player controls a ship that flies around the sun and tries to shoot +at the other ship. You can play &kspaceduel; with another person, against the +computer, or you can have the computer control both ships and play each +other. + + + + +The Game +The idea of the game is simple (but addictive). You try to destroy your opponent before he destroys you. +Be careful not to hit the sun. + +Rules of the Game + +Ship Movement +Each player controls one ship. +The ships can rotate, accelerate, shoot and lay mines. + + + +Energy + +Each ship has an amount of energy (refer to the game +options for values). + +Ships need energy for rotation, acceleration, shooting and laying mines. A +ship gets energy from its solar panels. The amount of energy a ship gets depends +on the distance from and direction to the sun. A ship gets more energy near the +sun and less energy near the border. It gets the full amount of energy if the +sun shines directly on the panels and less or even no energy if the sun shines +at an angle to the panel or to the side of the panel. + +If a ship has no energy it can't navigate or shoot. + + + + +Hit points + +Collisions with own or other bullets or mines decrease the hit points of a +ship. If two ships collide, the weaker ship is destroyed and the hit points of +the stronger ship are decreased by the hit points of the weaker ship plus an +amount (Crash Damage). A ship is destroyed when it flies into the sun. + + + + +Bullets and Mines + +Bullets fly around the sun like a ship. + +Mines have an amount of energy to stay at the same position. When the +energy is spent, the mine falls into the sun. Mines near the sun need more +energy than those which are further away. + +Mines can be destroyed with bullets. + +By default a ship can have 5 bullets and 3 mines on the screen. + + + + +Powerups + +From time to time powerups appear on the play field. + +There are four different powerups: + + + +Mine +The maximum number of mines is increased for the +player. + + +Bullet +The maximum number of bullets is increased for the +player. + + +Energy (yellow sphere) +The player gets energy. + + +Shield (blue sphere) +The player gets hit points + + + + + + +The &kspaceduel; screen + + +&kspaceduel; Main Screen + + +&kspaceduel; Main Screen + + + +You can see that the central part of the &kspaceduel; screen is the playing +area. To the left and the right are the Red Player's and the Blue Player's +stats. +The top box on the player stats, represents the Hit Points of the +craft. +The middle box on the player stats, represents the battery power. +The bottom box on the player stats, shows the number of wins. +The top of the playing area is occupied by the menubar and toolbar. +The bottom of the playing area is the status bar. + + + + + +Game Options + +&kspaceduel; has many, many options you can adjust to increase the enjoyment +of this game. + +Configuration is divided into two sections: + + +Player Keys +Game Settings + + + +Keys + +&kspaceduel; has a default set of keys to control the game. For a list of +default keys see the section entitled Default key +bindings. + +Keys can be configured by: + +Selecting SettingsConfigure +Shortcuts... from the menubar. + +This will bring up a dialog box which lets you configure all hotkeys, +including the keys used for steering the space ships, for firing bullets, and +for laying mines. + +You can see that each player (Red and Blue), have 5 keystrokes +corresponding to Rotate Left, Rotate Right, Accelerate, Shot, and Mines. + +When you are finished configuring your keys, you should click on +OK to apply your changes. + +If you want to restore the default keys, simply click on the +Default button once. To make these changes permenant, +press OK. + +If you want to abandon the changes you made, and return to your previously +selected keys, simply click Cancel, and your changes +will be lost. + + + +Game Configuration + +All game settings of &kspaceduel; are configurable. + +If you want to change the game settings, simply select +SettingsConfigure &kspaceduel;... + from the menubar. + +This will bring up a dialog box with two pages, labelled +General and Game. The first page +is rather simple, the second one has seven tabs across the top. + +Settings are collected in different configurations. You can choose from +several pre-defined configurations. + +If you choose the Custom configuration, you can +define all settings for yourself. + +If you have not selected Custom, you will not +be able to make any changes to these options. + + If you have found an interesting configuration, mail it to the +author of the game. It can be implemented in a future version (send the part +[Game] in the file +~/.kde/share/config/kspaceduelrc). + +When you are finished altering the options, you should click on +OK to apply your changes. + +If you want to restore the default, simply click on the +Default button once. To make these changes permenant, +press OK. + +If you want to abandon the changes you made, and return to your previous +options, simply click Cancel, and your changes will be +lost. + +The settings are: + + +<guilabel>General</guilabel> + + + +Hit Points +These two sliders allow you to define the hitpoints for each +of the two players; you might want to decrease the hitpoints for a player +to give that player a handycap. + + + +Refresh time +Time between two screen refreshes in milliseconds. All other +settings are independent of the refresh time. + + + +Red Player +Here you can define whether the red player gets controlled by +the AI, and also choose the skill level of the AI for this player. Just +experiment with the different skill level to find one which fits you. + + + + +Blue Player +This works the same as the options for the Red +Player described above. + + + + + + +<guilabel>Game</guilabel> + + + +Game speed +Controls the speed of the whole game. + + + + + + +<guilabel>Bullet</guilabel> + + + +Shot speed +The speed of bullets + + +Energy need +The amount of energy needed for one shot. + + +Max number +The maximum number of bullets a player can have on the +screen. + + +Damage +The number of hit points damage done when a bullet hits a +ship. + + +Life time +The maximum life time of a bullet. + + +Reload time +The time a ship needs to reload a bullet. + + + + + +Mine + + + +Mine fuel +The amount of fuel on a mine. + + +Energy need +The amount of energy needed for laying a mine. + + +Activate time +The time a mine is inactive. + + +Damage +The number of hit points of damage done when a ship hits a +mine. + + +Max number +Maximum number of mines a player can have on the +screen. + + +Reload time +The time a ship needs to reload a mine. + + + + + + +<guilabel>Ship</guilabel> + + + +Acceleration +Acceleration of the ships + + +Energy need +The energy needed to accelerate a ship. + + +Rotation speed +The speed at which a ship rotates. + + +Energy need +The energy needed to rotate a ship. + + +Crash damage +The number of hit points damage done when two ships +collide. + + + + + + +<guilabel>Sun</guilabel> + + + +Sun energy +The strength of the sun. The higher the value, the quicker +ships will be recharged. + + +Gravity +The strength of the gravitational pull of the +sun. + + + + + + +<guilabel>Start</guilabel> + + + +Position X and Position Y +The ships position at the beginning of a new round. The ships +start at opposite sides of the sun. + + +Velocity X and Velocity Y +Velocity at the beginning of a new round. + + + + + + +<guilabel>Powerups</guilabel> + + + +Appearance time +Maximal time between the appearance of two +powerups. + + +Life time +Maximal life time of a powerup. + + +Energy amount +Amount of energy a player gets from an energy +powerup. + + +Shield amount +Amount of hit points a player gets from a shield +powerup. + + + + + + + + + +Commands/Keyboard Shortcuts + +The following sections briefly describe each menubar option. + + +The <guimenu>Game</guimenu> Menu + +The Game menu is used to start and pause the game. + + + + + +&Ctrl;N +GameNew +Starts a new game of &kspaceduel;. + + + + + +&Ctrl;N +GameNew Round +Starts a new round, at the current level. + + + + +P +GamePause +Pauses and unpauses the game. + + + + +&Ctrl; +Q +GameQuit + +Quits &kspaceduel; + + + + + + +<guimenu>Settings</guimenu> Menu + + + + +SettingsShow Toolbar +When selected, the toolbar will be visible. When not selected, +the toolbar will be hidden. + + + + +SettingsShow Statusbar + +When selected, the status bar (the bar along the bottom of the +screen which gives textual information) will be visible. When not selected, the +status bar will be hidden. + + + + +Settings +Configure Shortcuts... + +Allows you to change the keyboard shortcuts for &kspaceduel;, +including the keys for steering the space ship, firing bullets &etc;. + + + + + +Settings +Configure Toolbars... + +Display the standard KDE Toolbar Configuration Dialog. + + + + + +Settings +Configure &kspaceduel;... + +Opens a configuration dialog which lets you define many +settings of the game, refer to the chapter Game +Options for further information. + + + + + + +<guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + +Default Key Bindings + +The following tables show you the default key bindings. + +Menu bindings + + + +Key ComboAction + +&Ctrl;QQuit &kspaceduel; +&Ctrl;NNew Game +&Ctrl;NNew Round +PPause Game +F1Help Contents +&Shift;F1Whats This Help +SpaceStart Game + + + + +The Menu Key Bindings can be changed by selecting +Settings Configure Key Bindings + + +Game Play + + + + + + +ActionRed PlayerBlue Player + +Rotate LeftSLeft Arrow +Rotate RightFRight Arrow +AccelerateEUp Arrow +ShotDDown Arrow +MinesAInsert + + + + +To change these keys, refer to the section entitled Player Keys.... + + + + + +Credits and License + + +&kspaceduel; + + +Program copyright 1999-2000 Andreas Zehender az@azweb.de +Documentation copyright 2000 Andreas Zehender az@azweb.de +Documentation updated for &kde; 2.0 by Mike McBride mpmcbride7@yahoo.com + + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &kspaceduel; + +&install.intro.documentation; + + + + +Compilation and Installation + +&install.compile.documentation; + + + + + + + diff --git a/doc/kspaceduel/kspaceduel3.png b/doc/kspaceduel/kspaceduel3.png new file mode 100644 index 00000000..a23bc50e Binary files /dev/null and b/doc/kspaceduel/kspaceduel3.png differ -- cgit v1.2.1