Differences

This shows you the differences between two versions of the page.

--- client:gdefaults [2018/04/18 05:11]
karl [map_height] Add Range values, add where to find default value
+++ client:gdefaults [2018/04/19 07:04] (current)
karl [map_width] Add link to server::config_h for max supported mapsize
@@ Line 79: / Line 79: @@
 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"
+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 ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > Map & Image "Cache Images"
+Menu Entry: Client > Configure > Map & Image "Cache Images" \\
+Command Line Parameter: [[optional_parameters#-cache]] , [[optional_parameters#-nocache]]
 ==== command_window ====
-Range: \\
+Range: **1** - **127** \\
-Default: 10 \\
+Default: **10** \\
-Menu Entry: Client > Configure > General "Command Window"
+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 ====
 Range: 0 - 1 | False | True \\
 Default: 1 \\
-Menu Entry: Client > Configure > Map & Image "Enable darkness code - if off, all spaces will not be dimmed."
+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]]
+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.
+**Note**: Seems not to work to set the  [[#lighting]] value to  CFG_LT_NONE when function //applyconfig()// is called. \\
+The client handles the want_config[CONFIG_DARKNESS] value only at it's startup in //load_defaults()// . \\
+If the CONFIG_LIGHTING is set to greater than zero, then the darkness code will be always enabled. \\
+Since the user has no possibility to select CFG_LT_NONE in the configuration GUI, darkness will be always enabled. \\
+:!: BUG: The only possibility to disable the darkness code, is to set [[#lighting]] manually to False | 0 . \\
+CONFIG_DARKNESS is not used anywhere else in the code except while checking commandline parameters and loading defaults; \\
+while CONFIG_LIGHTING is applied in //client/common/mapdata.c// and //client/gtk/sdl.c// .
+Functions:
+  * init_client_vars()
+    * File: client/common/init.c
+    * want_config[CONFIG_DARKNESS] = TRUE;
+  * load_defaults()
+    * File: client/gtk/config.c
+    * want_config[i] = val;
+    *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;
-See also [[#lighting]]
 ==== displaymode ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > Map & Image "SDL Image Support (Take effect next run)"
+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:
@@ Line 130: / Line 175: @@
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > Map & Image "Download All Image Information (Takes effect on next server connection)"
+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 ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Echo Bound Commands"
+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.
@@ Line 142: / Line 189: @@
 ==== faceset ====
-Range: \\
+Range: standard | classic \\
 Default: standard \\
-Menu Entry: Client > Configure > Map & Image
+Menu Entry: Client > Configure > Map & Image \\
+Command Line Parameter: [[optional_parameters#-faceset]]
 ==== 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)"
+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 ====
 Range: 0 - 1 | False | True \\
 Default: 1 \\
-Menu Entry: Client > Configure > Map & Image "Fog of War"
+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, \\
@@ Line 162: / Line 212: @@
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Beep When Food is Low"
+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,
@@ Line 170: / Line 221: @@
 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."
+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 ====
-Range: \\
+Range: **25** - **200** \\
-Default: 100 \\
+Default: **100** \\
-Menu Entry: Client > Configure > Map & Image  "Icon Scale (Takes effect next run)"
+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 ====
-Range: \\
+Range: **0** - **3** \\
-Default: 1  \\
+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."
-  * "Best Per Pixel Lighting (slowest)"
+  * 0 : //set by darkness//
-  * "Fast Per Pixel Lighting"
+  * 1 : "Per Tile Lighting"
-  * "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.
+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 .. \\
+=== 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 ^
@@ Line 195: / Line 298: @@
 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 Height"
+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 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_width ====
-Range: \\
+Range: **9** - **31** ( see function //load_defaults()// in //client/gtk/config.c// ) \\
-Default: 11 \\
+Default: **11** ( see function //init_client_vars()// want_config[CONFIG_MAPWIDTH] = 11; in //client/common/init.c// ) \\
-Menu Entry: Client > Configure > General "Map Width"
+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 ====
-Range: \\
+Range: **25** - **200** \\
-Default: 100 \\
+Default: **100** \\
-Menu Entry: Client > Configure > Map & Image "Map Scale (Takes effect next run)"
+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 ====
 Range: \\
 Default: 1 \\
-Menu Entry: //not available//
+Menu Entry: //not available// \\
+Command Line Parameter: [[optional_parameters#-mapscroll]] , [[optional_parameters#-nomapscroll]]
 ==== message_timestamping ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Timestamp Messages"
+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.
@@ Line 224: / Line 356: @@
 Range: 0 - 1 | False | True \\
 Default: 1 \\
-Menu Entry: Client > Configure > General "Splash Window"
+Menu Entry: Client > Configure > General "Splash Window" \\
+Command Line Parameter: [[optional_parameters#-splash]] , [[optional_parameters#-nosplash]]
 ==== popups ====
 Values : 0 or 1 -- 0 disables popup windows like a separate log-in window, 1 enables them. \\
 Default: 0 ( disabled ) \\
-Menu Entry: Client > Configure > General "Popup Windows"
+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 \\
 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. \\
@@ Line 248: / Line 380: @@
 Range: \\
 Default: \\
-Menu Entry: //not available//
+Menu Entry: //not available// \\
+Command Line Parameter: [[optional_parameters#-port]]
 ==== resistances ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Display resistances in two columns rather than only one."
+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.
@@ Line 260: / Line 394: @@
 Range: \\
 Default: \\
-Menu Entry: //not available//
+Menu Entry: //not available// \\
+Command Line Parameter: [[optional_parameters#-server]]
 ==== 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]] . \\
 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// \\
-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.
@@ Line 277: / Line 413: @@
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Show Inventory Icon"
+Menu Entry: Client > Configure > General "Show Inventory Icon" \\
+Command Line Parameter: [[optional_parameters#-showicon]]
-Add a notebook tab to the inventory window, where the items in the inventory are just drawn without any text.
+Adds a notebook tab to the inventory window, where the items in the inventory are just drawn without any text.
 ==== 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)"
+Menu Entry: Client > Configure > General "Popup Sign Windows (need [[#popups|Popup]] Windows checked to be used)" \\
+Command Line Parameter: //None//
 ==== smoothing ====
 Range: 0 - 1 | False | True \\
 Default: 0   \\
-Menu Entry: Client > Configure > Map & Image "Enable smoothing - Use additionnal CPU (Take effect on next connection)."
+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 ====
 Range: 0 - 1 | False | True \\
 Default: 1 \\
-Menu Entry: Client > Configure > General "Sound"
+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. \\
@@ Line 302: / Line 442: @@
 Range: \\
 Default: cfsndserv \\
-Menu Entry: //not available//
+Menu Entry: //not available// \\
+Command Line Parameter: [[optional_parameters#-sound_server]]
 ==== split ====
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Split Windows"
+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.
@@ Line 314: / Line 456: @@
 Range: 0 - 1 | False | True \\
 Default: 0 \\
-Menu Entry: Client > Configure > General "Split Information Window (Takes effect next run)"
+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. \\
@@ Line 322: / Line 465: @@
 Range: 0 - 1 | False | True \\
 Default: 1 \\
-Menu Entry: Client > Configure > General  "Show Tooltips"
+Menu Entry: Client > Configure > General  "Show Tooltips" \\
+Command Line Parameter: //None//
 Tooltips are the small text popups that appear when hoovering with the mouse pointer about areas.
@@ Line 332: / Line 476: @@
  "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.

Crossfire Wiki

User Tools

Site Tools

Differences

Page Tools