This is an old revision of the document!
The default Crossfire x11, gtk, gtk-v2 client recognizes the following parameters or arguments when it starts :
Short: - Cache images for future use.
Short: - Do not cache images (default action).
Short: - Enables darkness code (default)
Short: - Disables darkness code
Short: -display <name> - Use <name> instead if DISPLAY environment variable.
Short: - Download all needed faces before play starts
Short: - Echo the bound commands
Short: - Do not echo the bound commands (default)
Sort: -faceset <name> - Use faceset <name> if available
Short: - Send data immediately to server, may increase bandwidth
Short: - Disables fasttcpsend
Short: - Enable fog of war code
Short: - Display this message.
Short: - Set icon scale percentage
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
Short: -mapscale %% - Set map scale percentage
Short: -mapsize xXy - Set the mapsize to be X by Y spaces. (default 11×11)
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
Functions :
Short: Disable mapscrolling by bitmap operations
Function common/mapdata.c mapdata_scroll says: /* Emulate map scrolling by redrawing all tiles. */
Short: - Use pop up windows for input (default)
Result: Many messages, that normally occur in the info message pane, now are shown in separate popping up windows; like book entries and the login.
Reality: 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;
since version 1.10.0 .
See also ChangeLog entry : Popups not the default anymore
gdefaults settings file entry : popups
The GTK-v1 gcfclient when configured to partly use GTK-2 features by the -–enable-cfgtk2
configure option, 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
Short: - Don't use pop up windows for input
Short: -port <number> - Use port <number> instead of the standard port number
Short: -resists <val> - Control look of resistances.
Short: - Use sdl for drawing png (may not work on all hardware
Short: -server <name> - Connect to <name> instead of localhost.
Short: - Print status icons in inventory window
Short: - Enable smooth
Short: - Disable smooth
Short: - Enable sound output (default).
Short: - Disable sound output.
Description: The client uses an external soundserver binary, usually the cfsndserv . This sound server gets raised by the function init_sounds() in the source file client/gtk-v2/src/sound.c .
The function would return early if if (!want_config[CONFIG_SOUND]) return -1;
.
Comment in the source code :
/* Easy trick - global nosound is set in the arg processing - if set, just
* return -1 - this way, the calling function only needs to check the value
* of init_sounds, and not worry about checking nosound.
*/
Benefits: The cfsndserv binary blocks the audio device for other users.
It is therefore likely desireable to disable the usage of that child process,
when there are other sound programs running in parallel.
Short: -sound_server <path> - Executable to use to play sounds.
Short: - Display the splash screen (startup logo) (default)
Short: - Don't display the splash screen
Short: - Use split windows.
Short: - Use two information windows, segregated by information type.
Short: - Print out timing information for map generation
Short: - Trims size of information window(s)
Short: - Do not trims size of information window(s) (default)
Short: - Update the saved bindings for this keyboard.