Differences

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

--- client:gdefaults2 [2018/04/17 05:29] – Add full context (stubs) karl
+++ client:gdefaults2 [2025/04/18 13:09] (current) – external edit 127.0.0.1
@@ Line 16: / Line 16: @@
 # sensitive.  'True' and 'False' are the proper case, but
 # have been replaced with 1 and 0 respectively.
 </code>
 <del>Where the part '' 'True' and 'False' are the proper case''</del> \\
 <del>once applied to the X11 cfclient configuration file [[defaults]] .</del>
@@ Line 44: / Line 44: @@
 See also the gtk-1 [[gdefaults]] configfile, since the gdefaults2 does not differ much.
-  * [[#auto_apply_container]]: < 0 | 1 >  Default: 1
+  * [[#auto_apply_container]]: < 0 | 1 >
-  * [[#cacheimages]]: < 0 | 1 >  Default: 0
+  * [[#cacheimages]]: < 0 | 1 >
-  * [[#command_window]]: < 0 | 1 >  Default: 10
+  * [[#command_window]]: < 0 | 1 >
-  * [[#darkness]]: < 0 | 1 >  Default: 1
+  * [[#darkness]]: < 0 | 1 >
   * [[#displaymode]]: < 0 | 1 | 2 >   CFG_DM_PIXMAP , CFG_DM_SDL , CFG_DM_OPENGL
-  * [[#download_all_images]]: < 0 | 1 >  Default: 0
+  * [[#download_all_images]]: < 0 | 1 >
-  * [[#echo_bindings]]: < 0 | 1 >  Default: 0
+  * [[#echo_bindings]]: < 0 | 1 >
-  * [[#faceset]]:   Default: (null)
+  * [[#faceset]]:
-  * [[#fasttcpsend]]: < 0 | 1 >  Default: 1
+  * [[#fasttcpsend]]: < 0 | 1 >
-  * [[#fog_of_war]]: < 0 | 1 >  Default: 1
+  * [[#fog_of_war]]: < 0 | 1 >
-  * [[#foodbeep]]: < 0 | 1 >  Default: 0
+  * [[#foodbeep]]: < 0 | 1 >
-  * [[#grad_color_bars]]: < 0 | 1 >  Default: 0
+  * [[#grad_color_bars]]: < 0 | 1 >
-  * [[#iconscale]]: <  >  Default: 100
+  * [[#iconscale]]: <  >
-  * [[#lighting]]: < 0 | 1 >  Default: 1
+  * [[#lighting]]: < 0 | 1 >
-  * [[#map_height]]: <  >  Default: 25
+  * [[#map_height]]: <  >
-  * [[#mapscale]]: <  >  Default: 100
+  * [[#mapscale]]: <  >
-  * [[#mapscroll]]: < 0 | 1 >  Default: 1
+  * [[#mapscroll]]: < 0 | 1 >
-  * [[#map_width]]: <  >  Default: 25
+  * [[#map_width]]: <  >
-  * [[#message_timestamping]]: < 0 | 1 >  Default: 0
+  * [[#message_timestamping]]: < 0 | 1 >
-  * [[#nosplash]]: < 0 | 1 >  Default: 1
+  * [[#nosplash]]: < 0 | 1 >
-  * [[#popups]]: < 0 | 1 >  Default: 0
+  * [[#popups]]: < 0 | 1 >
-  * [[#port]]: <  >  Default: 13327
+  * [[#port]]: <  >
-  * [[#resistances]]: <  >  Default: 0
+  * [[#resistances]]: <  >
-  * [[#server]]: <  >  Default: (null)
+  * [[#server]]: <  >
-  * [[#show_grid]]: < 0 | 1 >  Default: 0
+  * [[#show_grid]]: < 0 | 1 >
-  * [[#showicon]]: < 0 | 1 >  Default: 0
+  * [[#showicon]]: < 0 | 1 >
-  * [[#sign_popups]]: < 0 | 1 >  Default: 1
+  * [[#sign_popups]]: < 0 | 1 >
-  * [[#smoothing]]: < 0 | 1 >  Default: 0
+  * [[#smoothing]]: < 0 | 1 >
-  * [[#sound]]: < 0 | 1 >  Default: 1
+  * [[#sound]]: < 0 | 1 >
-  * [[#split]]: < 0 | 1 >  Default: 0
+  * [[#split]]: < 0 | 1 >
-  * [[#splitinfo]]: < 0 | 1 >  Default: 0
+  * [[#splitinfo]]: < 0 | 1 >
-  * [[#theme]]: < 0 | 1 >  Default: Standard
+  * [[#theme]]: < 0 | 1 >
-  * [[#tooltips]]: < 0 | 1 >  Default: 1
+  * [[#tooltips]]: < 0 | 1 >
-  * [[#trim_info_window]]: < 0 | 1 >  Default: 0
+  * [[#trim_info_window]]: < 0 | 1 >
-  * [[#window_layout]]: <  >  Default: gtk-v1.glade
+  * [[#window_layout]]: <  >
 ----
@@ Line 84: / Line 84: @@
 ==== auto_apply_container ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== cacheimages ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== command_window ====
 Range: \\
-Default: \\
+Default: 10 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== darkness ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== displaymode ====
-Range: \\
+Range: 0 - 2 \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
+The displaymode entry can have three values for drawing the map:
+  * 0 : Pixmap
+  * 1 : SDL ; command line option [[optional parameters#-sdl]]
+  * 2 : OpenGL ; command line option [[optional parameters#-opengl]]
+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.
+=== SDL ===
+If the SDL libraries were not available at [[client compiling]] time, then the displaymode would fall back to Pixmap mode. \\
+The client then should print to stderr from function //load_defaults()// in //client/gtk-v2/config.c//
+<code c>
+#if !defined(HAVE_SDL)
+    if (want_config[CONFIG_DISPLAYMODE] == CFG_DM_SDL) {
+        want_config[CONFIG_DISPLAYMODE] = CFG_DM_PIXMAP;
+        LOG(LOG_ERROR, "config.c::load_defaults", "Display mode is set to SDL, but client "
+            "is not compiled with SDL support.  Reverting to pixmap mode.");
+    }
+#endif
+</code>
+See also [[#lighting]] modes for SDL.
+=== OpenGL ===
+The OpenGL mode is available on Linux, if the MESA package is found at compilation time. \\
+If the gdefaults2 entry is set to 2, and MESA was not found at compilation time, \\
+<del>the client acts differently than started with the -opengl parameter.</del> \\
+the client prints \\
+''[ ERROR  ] (config.c::load_defaults) Display mode is set to OpenGL, but client is not compiled with OpenGL support.  Reverting to pixmap mode.'' \\
+to the logging output.
+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 ) .
+Special kdrive X-Servers disbanded after version 1.4.x of the Xorg R7 release like Xvesa, \\
+likely will not work with MESA and DRI. \\
+The Xorg's own driver vesa_drv.so and probably some special framebuffer drivers will also not work \\
+with OpenGL / MESA.
+Screenshot of Scorn at nighttime of the client's opengl mode for the intel_drv.so driver: \\
+{{opengl_scorn-400.jpg}}
 ==== download_all_images ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== echo_bindings ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== faceset ====
 Range: \\
-Default: \\
+Default: (null) \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== fasttcpsend ====
 Range: \\
-Default: \\
+Default: 1 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== fog_of_war ====
 Range: \\
-Default: \\
+Default: 1 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== foodbeep ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== grad_color_bars ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== iconscale ====
 Range: \\
-Default: \\
+Default: 100 , until version 1.11.0 '90' \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== lighting ====
 Range: \\
-Default: \\
+Default: 1 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== map_height ====
-Range: \\
+Range: **11** - **25** \\
-Default: \\
+Default: **25** , until version 1.11.0 "15" \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
+Functions: See //client/gtk-v2/glade/dialogs.glade//
+  * <widget class="GtkSpinButton" id="config_spinbutton_mapheight">
+  * <property name="adjustment">25 11 25 1 0 0</property>
+**Note**: The code in function //load_defaults()// in //client/gtk-v2/src/config.c// still has as frame \\
+a lower limit of **9** and an upper limit of MAP_MAX_SIZE set. \\
+MAX_MAP_SIZE is defined in //client/common/client.h// as ''#define MAP_MAX_SIZE 31'' still in version 1.70.0 of the client. \\
+The user should be able to use the command line parameter [[optional_parameters#-mapsize]] to use the full range of "supported" map sizes.
+<WRAP lo>
+**Note**: The **old gcfclients2** had an //client/gtk-v2/interface.c// file likely made by some GLADE-designer-UI, with settings as follows: \\
+''gtk_adjustment_new (25, 11, 25, 1, 10, 10);'' , which according to https://developer.gnome.org/gtk2/stable/GtkAdjustment.html \\
+consist of 6 variables (value, lower, upper, step_increment, page_increment, page_size) . \\
+The setting of '10' for the “page-size” property seems to limit the upper max value to '15' , since the above gnome.org page says
+>The page size of the adjustment. Note that the page-size is irrelevant and should be set to zero if the adjustment is used for a simple scalar value, e.g. in a GtkSpinButton.
+Therefore the user would have had the chance to spin from 11 - 15 . \\
+GTK-2 has changed from version 2.4 to 2.14, and maybe "fixed" the proper handling of "page_size" . \\
+Between GTK-2 versions 2.4 and 2.13 the code could have worked "flawlessly" .
+</WRAP>
 ==== mapscale ====
 Range: \\
-Default: \\
+Default: 100 , until version 1.11.0 '90'  \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== mapscroll ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== map_width ====
-Range: \\
+Range: **11** - **25** ( offered by the GUI, real 9 - 31 ) \\
-Default: \\
+Default: **25** , until version 1.11.0 "15" \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
+Functions: See //client/gtk-v2/glade/dialogs.glade//
+  * <widget class="GtkSpinButton" id="config_spinbutton_mapwidth">
+  * <property name="adjustment">25 11 25 1 0 0</property>
+**Note**: The code in function //load_defaults()// in //client/gtk-v2/src/config.c// still has as frame \\
+a lower limit of **9** and an upper limit of MAP_MAX_SIZE set. \\
+MAX_MAP_SIZE is defined in //client/common/client.h// as ''#define MAP_MAX_SIZE 31'' still in version 1.70.0 of the client. \\
+The user should be able to use the command line parameter [[optional_parameters#-mapsize]] to use the full range of "supported" map sizes.
+<WRAP lo>
+**Note**: The **old gcfclients2** had an //client/gtk-v2/interface.c// file likely made by some GLADE-designer-UI, with settings as follows: \\
+''config_spinbutton_mapwidth_adj =  gtk_adjustment_new (25, 11, 25, 1, 10, 10);'' , which according to https://developer.gnome.org/gtk2/stable/GtkAdjustment.html \\
+consist of 6 variables (value, lower, upper, step_increment, page_increment, page_size) . \\
+The setting of '10' for the “page-size” property seems to limit the upper max value to '15' , since the above gnome.org page says
+>The page size of the adjustment. Note that the page-size is irrelevant and should be set to zero if the adjustment is used for a simple scalar value, e.g. in a GtkSpinButton.
+Therefore the user would have had the chance to spin from 11 - 15 . \\
+GTK-2 has changed from version 2.4 to 2.14, and maybe "fixed" the proper handling of "page_size" . \\
+Between GTK-2 versions 2.4 and 2.13 the code could have worked "flawlessly" .
+</WRAP>
 ==== message_timestamping ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== nosplash ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== popups ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== port ====
 Range: \\
 Default: \\
 Menu Entry:
 ==== resistances ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== server ====
 Range: \\
-Default: \\
+Default: (null) \\
 Menu Entry:
 ==== show_grid ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== showicon ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== sign_popups ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== smoothing ====
 Range: \\
-Default: \\
+Default: 0 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
 ==== sound ====
 Range: \\
-Default: \\
+Default: 1 \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > General Options
 ==== split ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
+That leftover from the gtk-1 client does not work for the gtk-2 client.
 ==== splitinfo ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
+That leftover from the gtk-1 client does not work for the gtk-2 client.
 ==== theme ====
 Range: \\
-Default: \\
+Default:Standard \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
+Implemented since version 1.12
 ==== tooltips ====
 Range: \\
-Default: \\
+Default: 1 \\
 Menu Entry:
 ==== trim_info_window ====
 Range: \\
-Default: \\
+Default: 0 \\
 Menu Entry:
 ==== window_layout ====
 Range: \\
-Default: \\
+Default: gtk-v1.glade \\
-Menu Entry:
+Menu Entry: (Old) Client > Configure > Map & Image Options
+Implemented since version 1.12