User Tools

Site Tools


client:optional_parameters

This is an old revision of the document!


Crossfire Client launch Options

The default Crossfire x11, gtk, gtk-v2 client recognizes the following parameters or arguments when it starts :

-cache

Short: - Cache images for future use.

-nocache

Short: - Do not cache images (default action).

-darkness

Short: - Enables darkness code (default)

-nodarkness

Short: - Disables darkness code

-display

Short: -display <name> - Use <name> instead if DISPLAY environment variable.

-download_all_faces

Short: - Download all needed faces before play starts

-echo

Short: - Echo the bound commands

-noecho

Short: - Do not echo the bound commands (default)

-faceset

Sort: -faceset <name> - Use faceset <name> if available

-fasttcpsend

Short: - Send data immediately to server, may increase bandwidth

-nofasttcpsend

Short: - Disables fasttcpsend

-fog

Short: - Enable fog of war code

-help

Short: - Display this message.

-iconscale

Short: - Set icon scale percentage

-loglevel

Short: -loglevel <val> - Set default logging level (0 is most verbose)
Description: The client has 5 logging levels as 0-4 . In opposite to the server
that has just 4 logging levels, they are less talk-active when set to a high value.
gdefaults entry: No
Default : common/config.h /* Default logging level. */ #define MINLOGLEVEL 0
Defines: common/client.h , common/misc.c

typedef enum LogLevel {
  LOG_DEBUG = 0, LOG_INFO = 1, LOG_WARNING = 2, LOG_ERROR = 3, LOG_CRITICAL = 4
} LogLevel;
static const char *const LogLevelTexts[] = {
    " DEBUG  ",
    "  INFO  ",
    "WARNING ",
    " ERROR  ",
    "CRITICAL",
    "UNKNOWN ",
};

Functions: common/misc.c

  • void LOG(LogLevel level, const char *origin, const char *format, …)
  • char *getLogText(const LogEntry *le)
  • char *getLogTextRaw(LogLevel level, const char *origin, const char *message)
  • static const char *getLogLevelText(LogLevel level)
    • return LogLevelTexts[level>LOG_CRITICAL?LOG_CRITICAL+1:level];

-mapscale

Short: -mapscale %% - Set map scale percentage

-mapsize

Short: -mapsize xXy - Set the mapsize to be X by Y spaces. (default 11×11)

-mapscroll

Short: Enable mapscrolling by bitmap operations
Used only in SDL map display mode.
Clients that understand this option : x11 cfclient and gtk-1 gcfclient. The gtk-v2 client throws the -help message and exits.
Purpose: UNKNOWN

      /* Mark all tiles as "need_update" that are overlapped by a big face 
       * from outside the view area. */ 

Default : TRUE ( apparently )
gdefaults file entry : mapscroll: <0|1> ( guessed TRUE | FALSE )
Client Menu entry : UNKNOWN
Bugs : x11/x11.c: Fix display_mapscroll() to handle scrolling by greater than 1 tile at a time. Fixes bug #1564584.
Implemented : x11/x11.c: Implement map scrolling by using XCopyArea(). Add config options -mapscroll/-nomapscroll to enable/disable this. 2005-08-31

Defines: common/client.h

  • #define CONFIG_MAPSCROLL 29 /* Use bitmap operations for map scrolling */
  • #define CONFIG_NUMS 32 /* This should always be the last value in the list */

Functions :

  • init_client_vars in comon.init.c , calls want_config[CONFIG_MAPSCROLL] = TRUE;
  • display_mapscroll in gtk/map.c , returns either 0 or sdl_mapscroll, called by mapdata_scroll in common/mapdata.c
  • sdl_mapscroll in gtk/sdl.c , returns always '1' , called by display_mapscroll

-nomapscroll

Short: Disable mapscrolling by bitmap operations

Function common/mapdata.c mapdata_scroll says: /* Emulate map scrolling by redrawing all tiles. */

-popups

Short: - Use pop up windows for input (default)
Result: The -help message claims, that popup would be the default, but that is apparently not true.
The default is set to 0 inside the source code
in function init_client_vars() in file common/init.c as variable want_config[CONFIG_POPUPS] = FALSE; .

The GTK-v1 gcfclient had a bug in the 1.9.1, 1.10.0 and 1.11.0 versions, that made new players impossible to log-on to a crossfire server , because a log-in required the popup-login-GUI to function.

See also

-nopopups

Short: - Don't use pop up windows for input

-port

Short: -port <number> - Use port <number> instead of the standard port number

-resists

Short: -resists <val> - Control look of resistances.

-sdl

Short: - Use sdl for drawing png (may not work on all hardware

-server

Short: -server <name> - Connect to <name> instead of localhost.

-showicon

Short: - Print status icons in inventory window

-smooth

Short: - Enable smooth

-nosmooth

Short: - Disable smooth

-sound

Short: - Enable sound output (default).

-nosound

Short: - Disable sound output.

-sound_server

Short: -sound_server <path> - Executable to use to play sounds.

-splash

Short: - Display the splash screen (startup logo) (default)

-nosplash

Short: - Don't display the splash screen

-split

Short: - Use split windows.

-splitinfo

Short: - Use two information windows, segregated by information type.

-timemapredraw

Short: - Print out timing information for map generation

-triminfowindow

Short: - Trims size of information window(s)

-notriminfowindow

Short: - Do not trims size of information window(s) (default)

-updatekeycodes

Short: - Update the saved bindings for this keyboard.

client/optional_parameters.1521151111.txt.gz · Last modified: 2018/03/15 16:58 by karl