This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
client:gdefaults [2018/04/15 13:59] karl [Crossfire Client configuration file gdefaults] Add where to find the code for the value parsing and short explanation |
client:gdefaults [2024/12/30 16:38] (current) leaf [popups] remove know_clients issue link |
||
---|---|---|---|
Line 4: | Line 4: | ||
This file applies to the old **gtk-1** client for crossfire, \\ | This file applies to the old **gtk-1** client for crossfire, \\ | ||
The newer gtk-2 client uses the [[gdefaults2]] file as configuration file. \\ | The newer gtk-2 client uses the [[gdefaults2]] file as configuration file. \\ | ||
+ | |||
+ | This configuration file does not exist in a fresh installation of the client. \\ | ||
+ | This file gets created by pressing the 'Save' button in the client configuration sub window \\ | ||
+ | found in the Menubar > Client > Configure . | ||
At the top of the file one reads : | At the top of the file one reads : | ||
Line 12: | Line 16: | ||
# 'True' and 'False' are the proper cases for those two values | # 'True' and 'False' are the proper cases for those two values | ||
# 'True' and 'False' have been replaced with 1 and 0 respectively | # 'True' and 'False' have been replaced with 1 and 0 respectively | ||
- | </code> | + | </code> |
The code in function //load_defaults()// in file //client/gtk/config.c// parses as follows : | The code in function //load_defaults()// in file //client/gtk/config.c// parses as follows : | ||
<code c> | <code c> | ||
if (inbuf[0]=='#') continue; | if (inbuf[0]=='#') continue; | ||
- | /* IF no colon, then we certainly don't have a real value, so just skip */ | + | /* IF no colon, then we certainly don't have a real value, so just skip */ |
- | if (!(cp=strchr(inbuf,':'))) continue; | + | if (!(cp=strchr(inbuf,':'))) continue; |
- | *cp='\0'; | + | *cp='\0'; |
- | cp+=2; /* colon, space, then value */ | + | cp+=2; /* colon, space, then value */ |
- | val = -1; | + | val = -1; |
- | if (isdigit(*cp)) val=atoi(cp); | + | if (isdigit(*cp)) val=atoi(cp); |
- | else if (!strcmp(cp,"True")) val = TRUE; | + | else if (!strcmp(cp,"True")) val = TRUE; |
- | else if (!strcmp(cp,"False")) val = FALSE; | + | else if (!strcmp(cp,"False")) val = FALSE; |
</code> | </code> | ||
Meaning, that lines starting with **#** are ignored, \\ | Meaning, that lines starting with **#** are ignored, \\ | ||
Line 30: | Line 34: | ||
and may have any content, but digits *not* **-1** , \\ | and may have any content, but digits *not* **-1** , \\ | ||
and still recognizes **True** or **False** in case sensitive string comparison. | and still recognizes **True** or **False** in case sensitive string comparison. | ||
+ | |||
+ | ---- | ||
===== Entries ===== | ===== Entries ===== | ||
Line 37: | Line 43: | ||
- [[#command_window]]: < 1 - 127 > | - [[#command_window]]: < 1 - 127 > | ||
- [[#darkness]]: < 0 | 1 > | - [[#darkness]]: < 0 | 1 > | ||
- | - [[#displaymode]]: < 0 | 1 | 2 > [ CFG_DM_PIXMAP , CFG_DM_SDL , CFG_DM_OPENGL ] | + | - [[#displaymode]]: < 0 | 1 > [ CFG_DM_PIXMAP , CFG_DM_SDL ] |
- [[#download_all_images]]: < 0 | 1 > | - [[#download_all_images]]: < 0 | 1 > | ||
- [[#echo_bindings]]: < 0 | 1 > | - [[#echo_bindings]]: < 0 | 1 > | ||
Line 67: | Line 73: | ||
- [[#tooltips]]: < 0 | 1 > | - [[#tooltips]]: < 0 | 1 > | ||
- [[#trim_info_window]]: < 0 | 1 > | - [[#trim_info_window]]: < 0 | 1 > | ||
+ | |||
+ | ---- | ||
==== auto_apply_container ==== | ==== auto_apply_container ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Automatically re-applies a container when you use apply to close it. \nIf off, when you use apply to close the container, it stays unapplied" \\ | ||
+ | Command Line Parameter: //None// | ||
==== cacheimages ==== | ==== cacheimages ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Cache Images" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-cache]] , [[optional_parameters#-nocache]] | ||
==== command_window ==== | ==== command_window ==== | ||
+ | Range: **1** - **127** \\ | ||
+ | Default: **10** \\ | ||
+ | Menu Entry: Client > Configure > General "Command Window" \\ | ||
+ | Command Line Parameter: //None// | ||
+ | |||
+ | Functions: | ||
+ | * init_client_vars() | ||
+ | * File: client/common/init.c | ||
+ | * want_config[CONFIG_CWINDOW] = COMMAND_WINDOW; | ||
+ | * File: client/common/client.h #define COMMAND_WINDOW 10 | ||
+ | |||
+ | * CButtons cbuttons[MAX_BUTTONS] = { | ||
+ | * File: client/gtk/config.c | ||
+ | * {NULL, SPIN_CWINDOW, CONFIG_CWINDOW, FLAG_UPDATE, "Command Window"}, | ||
+ | |||
+ | * configdialog(GtkWidget *widget) | ||
+ | * File: client/gtk/config.c | ||
+ | * else if (cbuttons[i].type == SPIN_CWINDOW) adj = (GtkAdjustment *) gtk_adjustment_new(want_config[cbuttons[i].config], 1, 127, 1, 5, 5); | ||
+ | |||
+ | * load_defaults() | ||
+ | * File client/gtk/config.c | ||
+ | * **Warning**: No check for upper and lower limit, might work beyond 127 and uncertain if set < 1 | ||
==== darkness ==== | ==== darkness ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Enable darkness code - if off, all spaces will not be dimmed." \\ | ||
+ | Command Line Parameter: [[optional_parameters#-darkness]] , [[optional_parameters#-nodarkness]] | ||
- | ==== displaymode ==== | + | The darkness code is provided by the server handling the [[:player_commands#time]] , [[:spells]] and maps with the archetype attribute [[:arch:arch_attributes:d#darkness]] set. |
- | The displaymode entry can have two ( three ) values for drawing the map: | + | |
- | * 0 Pixmap | + | |
- | * 1 SDL ; command line option [[optional parameters#-sdl]] | + | |
- | * 2 OpenGL ; command line option [[optional parameters#-opengl]] ; ( GTK-2 client only ) | + | |
- | Any other numerical values than those above will still be "acknowledged" by the client, but will lead to error messages as \\ | + | |
- | ''[WARNING ] (common::finish_face_cmd) Got error on create_and_rescale_image_from_data, file=HOME/.crossfire/image-cache/la/lava_S.113.base.1'' \\ | + | |
- | and \\ | + | |
- | ''[WARNING ] (common::display_newpng) create_and_rescale_image_from_data failed for face 481'' \\ | + | |
- | , thus the map would not be drawn. | + | |
- | === OpenGL === | + | **Note**: Seems not to work to set the [[#lighting]] value to CFG_LT_NONE when function //applyconfig()// is called. \\ |
- | The OpenGL mode is available on Linux, if the MESA package is found at compilation time. \\ | + | The client handles the want_config[CONFIG_DARKNESS] value only at it's startup in //load_defaults()// . \\ |
- | If the gdefaults2 entry is set to 2, and MESA was not found at compilation time, \\ | + | If the CONFIG_LIGHTING is set to greater than zero, then the darkness code will be always enabled. \\ |
- | <del>the client acts differently than started with the -opengl parameter.</del> \\ | + | Since the user has no possibility to select CFG_LT_NONE in the configuration GUI, darkness will be always enabled. \\ |
- | the client prints \\ | + | :!: BUG: The only possibility to disable the darkness code, is to set [[#lighting]] manually to False | 0 . \\ |
- | ''[ ERROR ] (config.c::load_defaults) Display mode is set to OpenGL, but client is not compiled with OpenGL support. Reverting to pixmap mode.'' \\ | + | CONFIG_DARKNESS is not used anywhere else in the code except while checking commandline parameters and loading defaults; \\ |
- | to the logging output. | + | while CONFIG_LIGHTING is applied in //client/common/mapdata.c// and //client/gtk/sdl.c// . |
- | When using OpenGL displaymode, the GLX and probably DRI extensions should be available to the X-Server, \\ | ||
- | when the X-Server Xorg is started to manage the monitor of the computer. \\ | ||
- | When the GLX extension is not available for the X-Server, then the client will either crash with \\ | ||
- | message ''Xlib: extension "GLX" missing on display ":0.0".'' and ''Segmentation fault'' as for \\ | ||
- | version 1.10.0 for example; or \\ | ||
- | printing ''Direct rendering is not available!'' to the loglevel INFO log output as it is for version 1.70.0 of the client, \\ | ||
- | and still would work in OpenGL drawing mode if libGL.so.1, libGLU.so.1 and libglut.so.3 are available on the system ( but GLX disabled for the X-Server ) . | ||
+ | Functions: | ||
+ | * init_client_vars() | ||
+ | * File: client/common/init.c | ||
+ | * want_config[CONFIG_DARKNESS] = TRUE; | ||
- | Special kdrive X-Servers disbanded after version 1.4.x of the Xorg R7 release like Xvesa, \\ | + | * load_defaults() |
- | likely will not work with MESA and DRI. \\ | + | * File: client/gtk/config.c |
- | The Xorg's own driver vesa_drv.so and probably some special framebuffer drivers will also not work \\ | + | * want_config[i] = val; |
- | with OpenGL / MESA. | + | *if (!want_config[CONFIG_LIGHTING]) { |
+ | * LOG(LOG_WARNING,"gtk::load_defaults","No lighting mechanism selected - will not use darkness code"); | ||
+ | * want_config[CONFIG_DARKNESS] = FALSE; | ||
- | Screenshot of Scorn at nighttime of the client's opengl mode for the intel_drv.so driver: \\ | ||
- | {{opengl_scorn-400.jpg}} | ||
+ | ==== displaymode ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "SDL Image Support (Take effect next run)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-sdl]] | ||
+ | |||
+ | The displaymode entry can have two values for drawing the map: | ||
+ | * 0 : Pixmap | ||
+ | * 1 : SDL ; command line option [[optional parameters#-sdl]] | ||
+ | Any other numerical values than those above will still be "acknowledged" by the client, but will lead to error messages as \\ | ||
+ | ''[ ERROR ] (Library::Gdk-CRITICAL) file gdkdraw.c: line 89 (gdk_draw_rectangle): assertion `drawable != NULL' failed.'' \\ | ||
+ | and \\ | ||
+ | ''[ ERROR ] (Library::Gdk-CRITICAL) file gdkdraw.c: line 379 (gdk_draw_pixmap): assertion `drawable != NULL' failed.'' \\ | ||
+ | and \\ | ||
+ | ''[ ERROR ] (Library::Gdk-CRITICAL) file gdkdraw.c: line 380 (gdk_draw_pixmap): assertion `src != NULL' failed.'' \\ | ||
+ | , thus the map would not be drawn. | ||
+ | |||
+ | === SDL === | ||
+ | If the SDL libraries were not available at [[client compiling]] time, then the displaymode would fall back to Pixmap mode. \\ | ||
+ | The client then does not print anything to stderr from function //load_defaults()// in //client/gtk/config.c// \\ | ||
+ | to inform the user about it: | ||
+ | <code c> | ||
+ | #ifndef HAVE_SDL | ||
+ | /* If SDL is not built in, having SDL mode turned on causes many issues. */ | ||
+ | want_config[CONFIG_DISPLAYMODE] = CFG_DM_PIXMAP; | ||
+ | #endif | ||
+ | </code> | ||
+ | |||
+ | See also [[#lighting]] modes for SDL. | ||
==== download_all_images ==== | ==== download_all_images ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Download All Image Information (Takes effect on next server connection)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-download_all_faces]] | ||
==== echo_bindings ==== | ==== echo_bindings ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Echo Bound Commands" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-echo]] , [[optional_parameters#-noecho]] | ||
+ | |||
+ | When set, should print the commands issued to the server by keypress in the informational window. | ||
+ | |||
+ | See also [[:player_commands]] . | ||
==== faceset ==== | ==== faceset ==== | ||
+ | Range: standard | classic \\ | ||
+ | Default: standard \\ | ||
+ | Menu Entry: Client > Configure > Map & Image \\ | ||
+ | Command Line Parameter: [[optional_parameters#-faceset]] | ||
==== fasttcpsend ==== | ==== fasttcpsend ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Fast TCP Send (May improve performance at expense\n of outgoing bandwidth)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-fasttcpsend]] , [[optional_parameters#-nofasttcpsend]] | ||
==== fog_of_war ==== | ==== fog_of_war ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Fog of War" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-fog]] | ||
+ | |||
+ | The "Fog of War" is mere a "Line of Sight" handler, since cleared areas do not become covered by inscrutable "mist" again, \\ | ||
+ | except for [[#darkness]] may gray out cleared areas again. | ||
==== foodbeep ==== | ==== foodbeep ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Beep When Food is Low" \\ | ||
+ | Command Line Parameter: //None// | ||
+ | |||
+ | The client issues beep tones to the beep speaker of the computer, when the nourishing level gets below 200, | ||
+ | and each time the nourishing level is decremented by 1. | ||
==== grad_color_bars ==== | ==== grad_color_bars ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Gradually change stat bar color based on value of the stat.\nThis option will result in some extra CPU usage." \\ | ||
+ | Command Line Parameter: //None// | ||
+ | |||
+ | When unset, the status bars for HP, SP, GR, Food do not change coloration according to their current amount. | ||
==== iconscale ==== | ==== iconscale ==== | ||
+ | Range: **25** - **200** \\ | ||
+ | Default: **100** \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Icon Scale (Takes effect next run)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-iconscale]] | ||
+ | |||
+ | Functions : | ||
+ | * init_client_vars() | ||
+ | * File: client/common/init.c | ||
+ | * want_config[CONFIG_ICONSCALE] = 100; | ||
+ | |||
+ | * configdialog(GtkWidget *widget) | ||
+ | * File: client/gtk/config.c | ||
+ | * if (cbuttons[i].type == SPIN_SCALE) adj = (GtkAdjustment *) gtk_adjustment_new(want_config[cbuttons[i].config], 25, 200, 1, 5, 5); | ||
+ | |||
+ | * load_defaults() | ||
+ | * File client/gtk/config.c | ||
+ | * if (want_config[CONFIG_ICONSCALE]< 25 || want_config[CONFIG_ICONSCALE]>200) | ||
==== lighting ==== | ==== lighting ==== | ||
+ | Range: **0** - **3** \\ | ||
+ | Default: **1** \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Lighting options, per pixel is prettier, per tile is faster.\nIf the darkness code is off, the pixel/tile options will be ignored." | ||
+ | * 0 : //set by darkness// | ||
+ | * 1 : "Per Tile Lighting" | ||
+ | * 2 : "Fast Per Pixel Lighting" | ||
+ | * 3 : "Best Per Pixel Lighting (slowest)" | ||
+ | Command Line Parameter: //None// | ||
+ | **Note**: When not set (0, CFG_LT_NONE), should disable [[#darkness]] code. | ||
- | SDL lighting in pictures: City of Navar around midnight .. \\ | + | Functions: |
+ | * client/common/client.h: | ||
+ | * /* CONFIG_LIGHTING can have several possible values - set them accordingly */ | ||
+ | * #define CFG_LT_NONE 0 | ||
+ | * #define CFG_LT_TILE 1 | ||
+ | * #define CFG_LT_PIXEL 2 | ||
+ | * #define CFG_LT_PIXEL_BEST 3 | ||
+ | |||
+ | * init_client_vars() | ||
+ | * File: /client/common/init.c | ||
+ | * want_config[CONFIG_LIGHTING] = CFG_LT_TILE; | ||
+ | |||
+ | * load_defaults() | ||
+ | * File: client/gtk/config.c | ||
+ | * if (!want_config[CONFIG_LIGHTING]) want_config[CONFIG_DARKNESS] = FALSE; | ||
+ | |||
+ | * CButtons cbuttons[MAX_BUTTONS] = { | ||
+ | * File: client/gtk/config.c | ||
+ | * {NULL, RBUTTON, 100 + CFG_LT_PIXEL_BEST, FLAG_MAPPANE, "Best Per Pixel Lighting (slowest)"}, | ||
+ | * {NULL, RBUTTON, 100 + CFG_LT_PIXEL, FLAG_MAPPANE, "Fast Per Pixel Lighting"}, | ||
+ | * {NULL, RBUTTON, 100 + CFG_LT_TILE, FLAG_MAPPANE, "Per Tile Lighting"}, | ||
+ | |||
+ | * applyconfig() | ||
+ | * File: client/gtk/config.c | ||
+ | * else if (cbuttons[onbutton].type == RBUTTON) { | ||
+ | * /* We know that the only radio buttons currently in use are those for | ||
+ | * lighting. IF other radio buttons are added later, this should be changed. */ | ||
+ | * if ( GTK_TOGGLE_BUTTON (cbuttons[onbutton].widget)->active) { | ||
+ | * if ( cbuttons[onbutton].config >= 100 && cbuttons[onbutton].config < 200) | ||
+ | * lighting = cbuttons[onbutton].config - 100; | ||
+ | * **Note**: applyconfig does not work correctly for almost all configuration options to apply them immediately "on the fly" - but for the lighting settings, it works. | ||
+ | |||
+ | === SDL lighting in pictures == | ||
+ | City of Navar around midnight .. | ||
^ lighting 0 None ^ lighting 1 Per Tile ^ lighting 2 Fast per Pixel ^ lighting 3 Best per Pixel ^ | ^ lighting 0 None ^ lighting 1 Per Tile ^ lighting 2 Fast per Pixel ^ lighting 3 Best per Pixel ^ | ||
| {{sdl_lightning_0_none.jpg?180}} | {{sdl_lightning_1_per_tile.jpg?180}} | {{sdl_lightning_2_fast_per_pixel.jpg?180}} | {{sdl_lightning_3_best_per_pixel.jpg?180}} | | | {{sdl_lightning_0_none.jpg?180}} | {{sdl_lightning_1_per_tile.jpg?180}} | {{sdl_lightning_2_fast_per_pixel.jpg?180}} | {{sdl_lightning_3_best_per_pixel.jpg?180}} | | ||
+ | |||
==== map_height ==== | ==== map_height ==== | ||
+ | Range: **9** - **31** ( see function //load_defaults()// in //client/gtk/config.c// ) \\ | ||
+ | Default: **11** ( see function //init_client_vars()// want_config[CONFIG_MAPHEIGHT] = 11; in //client/common/init.c// ) \\ | ||
+ | Menu Entry: Client > Configure > General "Map Size: Larger map lets you see more information, but takes more CPU\npower and bandwidth. Changing these will not take effect until the next time\nyou connect to a server" \\ | ||
+ | "Map Height" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-mapsize]] \\ | ||
+ | |||
+ | **Note**: The server has a maximum map size hardcoded to send to the client set as **25** by default. \\ | ||
+ | See topic [[:server:compiling_the_server:config_h#mapsize]] for MAP_CLIENT_Y . | ||
+ | |||
+ | |||
+ | |||
==== map_width ==== | ==== map_width ==== | ||
+ | Range: **9** - **31** ( see function //load_defaults()// in //client/gtk/config.c// ) \\ | ||
+ | Default: **11** ( see function //init_client_vars()// want_config[CONFIG_MAPWIDTH] = 11; in //client/common/init.c// ) \\ | ||
+ | Menu Entry: Client > Configure > General "Map Width" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-mapsize]] | ||
+ | **Note**: The server has a maximum map size hardcoded to send to the client set as **25** by default. \\ | ||
+ | See topic [[:server:compiling_the_server:config_h#mapsize]] for MAP_CLIENT_X . | ||
==== mapscale ==== | ==== mapscale ==== | ||
+ | Range: **25** - **200** \\ | ||
+ | Default: **100** \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Map Scale (Takes effect next run)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-mapscale]] | ||
+ | |||
+ | Functions : | ||
+ | * init_client_vars() | ||
+ | * File: client/common/init.c | ||
+ | * want_config[CONFIG_MAPSCALE] = 100; | ||
+ | |||
+ | * CButtons cbuttons[MAX_BUTTONS] = { | ||
+ | * File: client/gtk/config.c | ||
+ | * {NULL, SPIN_SCALE, CONFIG_MAPSCALE, FLAG_MAPPANE, "Map Scale (Takes effect next run)"}, | ||
+ | |||
+ | * configdialog(GtkWidget *widget) | ||
+ | * File: client/gtk/config.c | ||
+ | * if (cbuttons[i].type == SPIN_SCALE) adj = (GtkAdjustment *) gtk_adjustment_new(want_config[cbuttons[i].config], 25, 200, 1, 5, 5); | ||
+ | |||
+ | * load_defaults() | ||
+ | * File client/gtk/config.c | ||
+ | * if (want_config[CONFIG_MAPSCALE]< 25 || want_config[CONFIG_MAPSCALE]>200) | ||
==== mapscroll ==== | ==== mapscroll ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: //not available// \\ | ||
+ | Command Line Parameter: [[optional_parameters#-mapscroll]] , [[optional_parameters#-nomapscroll]] | ||
==== message_timestamping ==== | ==== message_timestamping ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Timestamp Messages" \\ | ||
+ | Command Line Parameter: //None// | ||
+ | |||
+ | when set, adds a HH:MM Hour:Minute tag to each message printed in the informational window. | ||
==== nosplash ==== | ==== nosplash ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Splash Window" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-splash]] , [[optional_parameters#-nosplash]] | ||
==== popups ==== | ==== popups ==== | ||
Values : 0 or 1 -- 0 disables popup windows like a separate log-in window, 1 enables them. \\ | Values : 0 or 1 -- 0 disables popup windows like a separate log-in window, 1 enables them. \\ | ||
- | Default: 0 ( disabled ) | + | Default: 0 ( disabled ) \\ |
+ | Menu Entry: Client > Configure > General "Popup Windows" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-popups]] , [[optional_parameters#-nopopups]] | ||
The default is set to **0** inside the source code \\ | 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; . | + | in function init_client_vars() in file common/init.c as variable want_config[CONFIG_POPUPS] = FALSE; . |
- | + | ||
- | Command-line options : [[optional_parameters#-popups]] and [[optional_parameters#-nopopups]] | + | |
Behaviour: Most popup-windows might be annoying, while playing the game, but the log-on to a server had been impossible for versions 1.11.0 and below of the GTK-1 client, if that was unset ( 0 ) . To enter a user-name was not possible in the "traditional" Info-Message and Cmd-Line Pane on the right side of the client. \\ | Behaviour: Most popup-windows might be annoying, while playing the game, but the log-on to a server had been impossible for versions 1.11.0 and below of the GTK-1 client, if that was unset ( 0 ) . To enter a user-name was not possible in the "traditional" Info-Message and Cmd-Line Pane on the right side of the client. \\ | ||
- | See also | + | See also |
* ChangeLog [[changelog_0_92_1_70_0#Popups not the default anymore]] | * ChangeLog [[changelog_0_92_1_70_0#Popups not the default anymore]] | ||
* ChangeLog [[changelog_0_92_1_70_0#Popups @ v.1.12.0 client GTK1 mixed with GTK2 can not login]] | * ChangeLog [[changelog_0_92_1_70_0#Popups @ v.1.12.0 client GTK1 mixed with GTK2 can not login]] | ||
* ChangeLog [[changelog_0_92_1_70_0#Keyboard input impossible or confusing]] | * ChangeLog [[changelog_0_92_1_70_0#Keyboard input impossible or confusing]] | ||
- | * known_client_issues [[:known_client_issues#Keyboard input impossible or confusing]] | + | * bugs [[bugs#Pressing a keyboard key activates the command-line]] |
- | * bugs [[bugs#Pressing a keyboard key activates the command-line]] | + | |
==== port ==== | ==== port ==== | ||
+ | Range: \\ | ||
+ | Default: \\ | ||
+ | Menu Entry: //not available// \\ | ||
+ | Command Line Parameter: [[optional_parameters#-port]] | ||
==== resistances ==== | ==== resistances ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Display resistances in two columns rather than only one." \\ | ||
+ | Command Line Parameter: [[optional_parameters#-resists]] | ||
+ | |||
+ | The value **0** prints resistances in 1 column, the value **1** prints them in two columns. | ||
==== server ==== | ==== server ==== | ||
+ | Range: \\ | ||
+ | Default: \\ | ||
+ | Menu Entry: //not available// \\ | ||
+ | Command Line Parameter: [[optional_parameters#-server]] | ||
==== show_grid ==== | ==== show_grid ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 | ||
+ | Client Menu: Client > Configure > Map & Image > "Print Grid Overlay (SDL only, Slow, useful for debugging/development" \\ | ||
+ | Command Line Parameter: //None// | ||
+ | |||
This option is only available for the SDL [[#displaymode]] . \\ | This option is only available for the SDL [[#displaymode]] . \\ | ||
Purpose: It draws a red tile grid-overlay onto the map. \\ | Purpose: It draws a red tile grid-overlay onto the map. \\ | ||
- | Effect: But this grid vanishes as soon as the player moves. \\ | + | Effect: The grid vanishes as soon as the player moves. The player has to apply it each move in the configuration sub window. \\ |
Implemented: gridline options available under the client config window. //MSW 2001-06-17// \\ | Implemented: gridline options available under the client config window. //MSW 2001-06-17// \\ | ||
- | Client Menu: Client > Configure > Map & Image > Print Grid Overlay (SDL only, slow, useful for debugging, development) | ||
The GTK-2 client does not have such a Menu option to choose anymore; but still has this parameter entry in it's [[gdefaults2]] config file. | The GTK-2 client does not have such a Menu option to choose anymore; but still has this parameter entry in it's [[gdefaults2]] config file. | ||
+ | |||
==== showicon ==== | ==== showicon ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Show Inventory Icon" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-showicon]] | ||
+ | |||
+ | Adds a notebook tab to the inventory window, where the items in the inventory are just drawn without any text. | ||
==== sign_popups ==== | ==== sign_popups ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Popup Sign Windows (need [[#popups|Popup]] Windows checked to be used)" \\ | ||
+ | Command Line Parameter: //None// | ||
==== smoothing ==== | ==== smoothing ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > Map & Image "Enable smoothing - Use additionnal CPU (Take effect on next connection)." \\ | ||
+ | Command Line Parameter: [[optional_parameters#-smooth]] , [[optional_parameters#-nosmooth]] | ||
==== sound ==== | ==== sound ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Sound" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-sound]] , [[optional_parameters#-nosound]] | ||
+ | |||
+ | When enabled, raises a sound server, but sound had been broken for a long time. \\ | ||
+ | The server has to send sound effect commands to the client. | ||
==== sound_server ==== | ==== sound_server ==== | ||
+ | Range: \\ | ||
+ | Default: cfsndserv \\ | ||
+ | Menu Entry: //not available// \\ | ||
+ | Command Line Parameter: [[optional_parameters#-sound_server]] | ||
==== split ==== | ==== split ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Split Windows" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-split]] | ||
+ | |||
+ | When set, the client GUI will be split into several small windows, instead of one single window. | ||
==== splitinfo ==== | ==== splitinfo ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Split Information Window (Takes effect next run)" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-splitinfo]] | ||
+ | |||
+ | The information window to the right side of the GUI can be split into two areas. \\ | ||
+ | The upper area the usually draws coloured messages, while the lower part draws the common black messages. | ||
==== tooltips ==== | ==== tooltips ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: Client > Configure > General "Show Tooltips" \\ | ||
+ | Command Line Parameter: //None// | ||
- | ==== trim_info_window ==== | + | Tooltips are the small text popups that appear when hoovering with the mouse pointer about areas. |
- | + | ||
+ | ==== trim_info_window ==== | ||
+ | Range: 0 - 1 | False | True \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: Client > Configure > General "Trims text in the information window - " \\ | ||
+ | "improves performance but bugs in\n gtk make the client unstable if this is used." \\ | ||
+ | "This may work better with gtk 2.0" \\ | ||
+ | Command Line Parameter: [[optional_parameters#-triminfowindow]] , [[optional_parameters#-notriminfowindow]] | ||
+ | When set, limits the scrollback buffer of the information window to ~100 thousand chars. | ||