This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
client:gdefaults2 [2018/04/15 14:19] karl [Crossfire Client configuration file gdefaults2] Add description about the code parsing by load_defaults() |
client:gdefaults2 [2018/04/17 20:49] karl [displaymode] Move the opengl content from gdefaults here |
||
---|---|---|---|
Line 4: | Line 4: | ||
This file applies to the new **gtk-2** client for crossfire, \\ | This file applies to the new **gtk-2** client for crossfire, \\ | ||
The older gtk-1 client used the [[gdefaults]] file as configuration file. \\ | The older gtk-1 client used the [[gdefaults]] 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 under Menubar > Client > Configure . | ||
At the top of the file one reads : | At the top of the file one reads : | ||
Line 12: | Line 16: | ||
# sensitive. 'True' and 'False' are the proper case, but | # sensitive. 'True' and 'False' are the proper case, but | ||
# have been replaced with 1 and 0 respectively. | # have been replaced with 1 and 0 respectively. | ||
- | </code> | + | </code> |
<del>Where the part '' 'True' and 'False' are the proper case''</del> \\ | <del>Where the part '' 'True' and 'False' are the proper case''</del> \\ | ||
<del>once applied to the X11 cfclient configuration file [[defaults]] .</del> | <del>once applied to the X11 cfclient configuration file [[defaults]] .</del> | ||
Line 34: | Line 38: | ||
and still recognizes **True** or **False** in case sensitive string comparison. | and still recognizes **True** or **False** in case sensitive string comparison. | ||
- | ===== Entries ===== | + | ---- |
===== Entries == | ===== Entries == | ||
- | See the [[gdefaults]] configfile, since the gdefaults2 does not differ much. | + | See also the gtk-1 [[gdefaults]] configfile, since the gdefaults2 does not differ much. |
+ | |||
+ | * [[#auto_apply_container]]: < 0 | 1 > | ||
+ | * [[#cacheimages]]: < 0 | 1 > | ||
+ | * [[#command_window]]: < 0 | 1 > | ||
+ | * [[#darkness]]: < 0 | 1 > | ||
+ | * [[#displaymode]]: < 0 | 1 | 2 > CFG_DM_PIXMAP , CFG_DM_SDL , CFG_DM_OPENGL | ||
+ | * [[#download_all_images]]: < 0 | 1 > | ||
+ | * [[#echo_bindings]]: < 0 | 1 > | ||
+ | * [[#faceset]]: | ||
+ | * [[#fasttcpsend]]: < 0 | 1 > | ||
+ | * [[#fog_of_war]]: < 0 | 1 > | ||
+ | * [[#foodbeep]]: < 0 | 1 > | ||
+ | * [[#grad_color_bars]]: < 0 | 1 > | ||
+ | * [[#iconscale]]: < > | ||
+ | * [[#lighting]]: < 0 | 1 > | ||
+ | * [[#map_height]]: < > | ||
+ | * [[#mapscale]]: < > | ||
+ | * [[#mapscroll]]: < 0 | 1 > | ||
+ | * [[#map_width]]: < > | ||
+ | * [[#message_timestamping]]: < 0 | 1 > | ||
+ | * [[#nosplash]]: < 0 | 1 > | ||
+ | * [[#popups]]: < 0 | 1 > | ||
+ | * [[#port]]: < > | ||
+ | * [[#resistances]]: < > | ||
+ | * [[#server]]: < > | ||
+ | * [[#show_grid]]: < 0 | 1 > | ||
+ | * [[#showicon]]: < 0 | 1 > | ||
+ | * [[#sign_popups]]: < 0 | 1 > | ||
+ | * [[#smoothing]]: < 0 | 1 > | ||
+ | * [[#sound]]: < 0 | 1 > | ||
+ | * [[#split]]: < 0 | 1 > | ||
+ | * [[#splitinfo]]: < 0 | 1 > | ||
+ | * [[#theme]]: < 0 | 1 > | ||
+ | * [[#tooltips]]: < 0 | 1 > | ||
+ | * [[#trim_info_window]]: < 0 | 1 > | ||
+ | * [[#window_layout]]: < > | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== auto_apply_container ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== cacheimages ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== command_window ==== | ||
+ | Range: \\ | ||
+ | Default: 10 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== darkness ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== displaymode ==== | ||
+ | Range: 0 - 2 \\ | ||
+ | Default: 0 \\ | ||
+ | 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: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== echo_bindings ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== faceset ==== | ||
+ | Range: \\ | ||
+ | Default: (null) \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== fasttcpsend ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== fog_of_war ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== foodbeep ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== grad_color_bars ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== iconscale ==== | ||
+ | Range: \\ | ||
+ | Default: 100 , until version 1.11.0 '90' \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== lighting ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== map_height ==== | ||
+ | Range: \\ | ||
+ | Default: 25 , until version 1.11.0 '15' \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== mapscale ==== | ||
+ | Range: \\ | ||
+ | Default: 100 , until version 1.11.0 '90' \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== mapscroll ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== map_width ==== | ||
+ | Range: \\ | ||
+ | Default: 25 , until version 1.11.0 '15' \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== message_timestamping ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== nosplash ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== popups ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== port ==== | ||
+ | Range: \\ | ||
+ | Default: \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== resistances ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== server ==== | ||
+ | Range: \\ | ||
+ | Default: (null) \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== show_grid ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== showicon ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== sign_popups ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== smoothing ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | ==== sound ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: (Old) Client > Configure > General Options | ||
+ | |||
+ | ==== split ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | That leftover from the gtk-1 client does not work for the gtk-2 client. | ||
+ | |||
+ | ==== splitinfo ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | That leftover from the gtk-1 client does not work for the gtk-2 client. | ||
+ | |||
+ | ==== theme ==== | ||
+ | Range: \\ | ||
+ | Default:Standard \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | Implemented since version 1.12 | ||
+ | |||
+ | ==== tooltips ==== | ||
+ | Range: \\ | ||
+ | Default: 1 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== trim_info_window ==== | ||
+ | Range: \\ | ||
+ | Default: 0 \\ | ||
+ | Menu Entry: | ||
+ | |||
+ | ==== window_layout ==== | ||
+ | Range: \\ | ||
+ | Default: gtk-v1.glade \\ | ||
+ | Menu Entry: (Old) Client > Configure > Map & Image Options | ||
+ | |||
+ | Implemented since version 1.12 | ||