SDLClient

From Freeciv

1 First of all
2 Requirements
3 Some Info
4 In-game Controls
- 4.1 How to save or load games
5 See Also

[edit] First of all

Some graphics and part of the SDL gfx code come from Michael Speck and his "LGeneral". Many Thanks for his job... but I don't known if he agrees that I use his graphics ( but LGeneral is covered by GPL )

The zoom and putline functions come from the SDL_gfx-2.0 lib and they are covered by the LGPL licence. I don't use the new lib except for these functions. The AA_ZoomSurfaceFastRGBA(...) function and some others in SDLClient are my invention.

[edit] Requirements

The "SDL" library.

"Simple DirectMedia Layer is a cross-platform multimedia library designed to provide low level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, and 2D video framebuffer."
(http://www.libsdl.org)

These features make it a good choice for portable games. You may obtain it at:

  http://www.libsdl.org/release/SDL-1.2.11.tar.gz

To compile the client using the "SDL" library add "--enable-client=sdl" to the Freeciv configure script. See the section below for more information about the configure script.

The "SDL_image" library.

This library loads the PNG images (with the help of libpng) and converts them to "SDL surfaces" that can be handled by the "SDL" library. You may obtain it at:

  http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.5.tar.gz

The "freetype" library.

This library helps to render text for the SDL client, using an externally provided TrueType font. You may obtain it at:

  http://download.savannah.gnu.org/releases/freetype/freetype-2.3.2.tar.gz

[edit] Some Info

The SDL client looks for its themes in the "gui-sdl" subdirectory within any of the Freeciv theme directories.

If you have the current cvs version of SDL (or >= 1.2.6), uncomment the

#define SDL_CVS line (36) from gui-sdl/mapview.c

If your CPU has MMX1 registers then goto gui-sdl/graphics.h line 31 and

#define HAVE_MMX1

If you want report a drawing bug in SDLClient then please attach your screen bits per pixel coding.

[edit] In-game Controls

Tab to show input dialog (chatline)
ctrl - w hide/show fog of war
ctrl - r hide/show road/RR
ctrl - t hide/show terrains
ctrl - i hide/show irrigations/farmlands
ctrl - u hide/show units
ctrl - o hide/show pollutions
ctrl - p hide/show city productions
ctrl - s hide/show map specials
ctrl - g hide/show map grids
ctrl - b hide/show national borders
ctrl - l hide/show nuke waste
ctrl - c hide/show cities
ctrl - n hide/show city names
print screen make screenshot
F1 - cities report
F2 - units report
F3 - players report
F5 - economy report
F6 - science report
F7 - wonder list
F8 - top 5 cities
F10 - hide/show log
F11 - demographics
F12 - your space ship
MMB - advanced menu
Left Shift + LMB - advanced menu
left CTRL + LBM on city - open production dialog
left ALT + LBM on city - open buy production dialog
if active unit stays on city then Enter key opens the city dialog
Esc - options dlg
Shift + Enter - end turn

In options dlg

q exit game.

In city dlg:

c change production dlg.
h hurry production dlg.
a cma dlg.

In all dlgs:

ESC - exit/close dlg.
ENTER - ok/commit/etc.

In Worklist dlg.

LMB on "target" - change production to "target"
RMB on "target" - add "target" to work list
MMB on "target" - call help about "target"
LMB on "worklist item" - swap "item" up
RMB on "worklist item" - swap "item" down
MMB on "worklist item" - remove "item" from worklist

In Unit Info Window

LMB - next unit.
RMB - center on focused unit

In Science Window

MMB on "target" - call help about "target"

On MiniMap :

RMB center map here

[edit] How to save or load games

At the time of writing, the SDL Client lacks an obvious way to save or load games. This might improve in the future, but for the time being these are the workarounds: