Provided by:
pingus_0.7.6-1_i386 
NAME
pingus - A puzzle game where you have to save penguins
SYNOPSIS
pingus [OPTION]... [FILE]
DESCRIPTION
Pingus is a side-scrolling puzzle game where the player has to guide a
group of penguins from the entrance of a level to the exit, in between
the path is blocked by numerous obstacles and dangers that the player
has to overcome by assigning actions to the penguins.
OPTIONS
GENERAL OPTIONS
-h, --help
Displays this help
-V, --version
Print version number and exit
-v, --verbose
Enable info level log output
-D, --debug
Enable debug level log output
-Q, --quiet
Disable all log output
DISPLAY OPTIONS
-w, --window
Start in Window Mode
-f, --fullscreen
Start in Fullscreen
-r, --renderer=RENDERER
Use the given renderer, defaults to sdl. Available renderers
are:
sdl A simple software renderer based on SDL, this is the
default and the safest options.
opengl The OpenGL renderer will use hardware acceleration to
render the graphics, it is much faster then the SDL
renderer and recommended when the hardware supports
OpenGL.
delta The delta renderer uses SDL for rendering and doesn't use
hardware acceleration, it will however try to increase
rendering performance by only re rendering screen
elements that have changed. Using the delta renderer will
disable some effects such as scrolling background to
allow maximum benefits.
-g, --geometry=WIDTHxHEIGHT
Set the window resolution for pingus (default: 800x600). Note
that --geometry only applies to the window resolution, for the
fullscreen resolution use --fullscreen-resolution
-R, --fullscreen-resolution=WIDTHxHEIGHT
Set the resolution used in fullscreen mode (default: 800x600)
--software-cursor
Enable software cursor
GAME OPTIONS
--no-auto-scrolling
Disable automatic scrolling. Automatic scrolling will cause the
screen to scroll whenever the mouse reaches the border of the
screen. Automatic scrolling will only be active in fullscreen
mode or when mouse-grab is enabled.
--drag-drop-scrolling
Enable drag'n drop scrolling. By default Pingus will use a
rubber-band scrolling where the scroll speed depends on how far
away the cursor is from the position when the mouse button has
been clicked. In drag&drop mode scrolling will behave more like
in traditional GUI applications such as Gimp, where clicking the
scroll button will 'pick up' the playfield and allow to move it
around till it is released again.
SOUND OPTIONS
-s, --disable-sound
Disable sound
-m, --disable-music
Disable music
LANGUAGE OPTIONS
-l, --language=LANG
Select language to use with Pingus
--list-languages
List all available languages
EDITOR OPTIONS
-e, --editor
Loads the level editor
DIRECTORY OPTIONS
-d, --datadir=DIR
Load game datafiles from DIR
-u, --userdir=DIR
Load config files and store savegames in DIR
-a, --addon=DIR
Load game modifications from DIR. Files in DIR will be used
instead of the files in found in the main datadir of Pingus,
thus allowing to modifications, such as sprites replacements,
additional levels, etc. to the game, without changing the main
data files.
--no-cfg-file
Don't read ~/.pingus/config
-c, --config=FILE
Read config from FILE
--controller=FILE
Uses the controller given in FILE
DEBUG OPTIONS
--developer-mode
Enables some special features for developers
-t, --speed=SPEED
Set the game speed (0=fastest, >0=slower)
-k, --fps=FPS
Set the desired game framerate (frames per second)
--tile-size=INT
Set the size of the map tiles (default: 32)
KEYBOARD SHORTCUTS
GAMEPLAY
All gameplay related keyboard shortcuts are configurable via a
controller config file, see --controller and controller/default.scm.
W, A, S, D
Scroll in the level
Space Hold to ast-forward
P, R Pause the game.
S, F Advance the game by a single frame.
Backspace
Activate armageddon.
Escape Leave the current screen/level.
ENGINE
F10 Show/hide the FPS counter.
AltReturn, F11
Switch to fullscreen/window mode.
Ctrlg Toggle mouse grab, when active, the mouse can not leave the
window.
Ctrlo, F5
Show the option menu.
F12 Make a screenshot. Screenshots are stored in
~/.pingus/screenshots/.
Ctrlm Toggle the developer mode, see --developer-mode
c (only in developer-mode)
Show the collision map overlayed over the regular groundmap.
k (only in developer-mode)
Clear the screen for delta mode debugging.
ACTIONS
Basher The Basher will to a horizontal dig, leaving behind it a tunnel.
It is not able to dig through metal.
Blocker
The Blocker will stop and stay in position, directing other
penguins to turn around when they reach him.
Bomber The Bomber will blow up on the spot and take a bit of
surrounding ground with it.
Bridger
The Bridger will build a small bridge, useful for crossing small
chasm.
Climber
The Climber actions allows a Pingu to travel upwards a vertical
wall. Unlike other actions the climber action is a permanent
addition to the Pingus ability.
Digger The Digger will dig a hole into the ground. It can't dig through
metal.
Floater
The Floater action will give a penguin a small propeller that
lets him gently glide down from great heights that would
otherwise be deadly.
Jumper The Jumper will let the Pingu do a big leap forward, allowing
him to cross chasm and small vertical obstacles.
Miner The Miner will dig a diagonal hole into the ground.
Slider The Slider will make a tiny leap forward, gliding on its belly
for a short while, allowing the Pingu to make it through narrow
tunnels.
LEVEL EDITOR
Pingus comes with a build in level editor. The level editor can
currently be used to edit level files (*.pingus) as well as
prefabricated objects (*.prefabs). Worldmaps (*.worldmap) can currently
not be edited with the editor.
All Pingus data files, except the sound and images, are raw text files
and can be edited in a text editor if the editor isn't sufficient.
If you want to submit a level to be included in the next release follow
the following naming convention:
{theme}{number}-{nickname}.pingus
Do not use space or uppercase in the levelname and keep the levelname
simple (i.e. snow1-grumbel.pingus not
pingus-go-on-a-long-journey-in-snowland-grumbel.pingus). The filename
should not reflect the actual level title, it simply should be unique
and not conflict with other peoples levels. If you plan on building a
whole levelset, name the levels after the levelset.
To submit a level send it to <pingus-devel@nongnu.org>.
PREFABS
A prefab, short for prefabricated object, is a group of objects that
have been combined into a new single object. A classic case of a prefab
would for example be a snowman, it is build out of multiple smaller
snowball objects and then saved as prefab to allow easy reuse in
multiple levels. Unlike simple object groups, prefab are saved as
reference in the level, thus if the prefab is updated, all levels will
see the change. Like object groups prefabs can be ungrouped to break
them back down to individual objects if individual editing is needed,
they are seizing to be prefabs at that point and changes to the .prefab
file will no longer be reflected in the level.
Prefabs behave pretty much like regular levels, to create a prefab
simply start a new level and insert the objects as usual, unlike
regular levels the level size is ignored and thus you have to place
your object around the center of the levels, marked by a cross, to have
the prefab function properly. To save a prefab as prefab instead of
level you have to append .prefab suffix to the filename.
Thumbnail generation for prefabs is currently done offline with the
script ./tools/generate-prefab-images.sh available from the Pingus
source tree.
UI QUIRCKS
The Pingus level editor is best used with a combination of mouse and
keyboard, all essential functions have keyboard shortcuts.
Unlike more traditional GUIs, the Pingus editor lacks scrollbars, so to
move around the level or the object list on the right simply use the
middle or right mouse button and drag&drop the list around.
Objects from the object list can be inserted into the level by
drag&dropping them over to the level.
KEYBOARD SHORTCUTS
Delete, Backspace
Delete all currently selected objects
A Select or unselect all objects
D Duplicate the currently selected objects
I, K, J, L
Move the current selection by one pixel, if Shift is held, move
it by 32 pixel.
PageUp, PageDown
Raise or lower an object
ShiftPageUp, ShiftPageDown
Raise or lower an object to the top or bottom
R, ShiftR
Rotate an objects 90 degrees, if Shift is held rotate it the
other way around
F, ShiftV
Flip an object horizontally
V, ShiftF
Flip an object vertically
B, ShiftB
Toggle the background color to make it easier to see small pixel
errors. If shift is hold the color will be toggled in the
opposite direction.
+, =, -
Increase/decrease the repeat value of selected objects, this
will only have an effect on objects having an repeat value
(switchdoors, liquids, ...).
COPYRIGHT
Copyright (C) 1998-2011 Ingo Ruhnke <grumbel@gmail.com> See the file
AUTHORS for a complete list of contributors. Pingus comes with
ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to
redistribute it under certain conditions; see the file COPYING for
details.
SEE ALSO
http://pingus.seul.org