Provided by: chocolate-doom_1.2.1-1_i386 bug

NAME

       chocolate-doom.cfg - Chocolate Doom configuration file

DESCRIPTION

       chocolate-doom.cfg is a configuration file for chocolate-doom(6).  This
       file acts as an auxiliary configuration file;  the  main  configuration
       options   are   stored   in   default.cfg,   which  contains  the  same
       configuration options as Vanilla Doom (for compatibility).   chocolate-
       doom.cfg  contains configuration options that are specific to Chocolate
       Doom only.

       chocolate-doom.cfg is normally stored in the user’s home directory,  as
       ~/.chocolate-doom/chocolate-doom.cfg.

       The  chocolate-setup(6)  tool  provides  a  simple to use front-end for
       editing chocolate-doom.cfg.

FILE FORMAT

       The file format is the same as that used for default.cfg(5).

CONFIGURATION VARIABLES

       autoadjust_video_settings
              If non-zero, video settings will  be  autoadjusted  to  a  valid
              configuration  when the screen_width and screen_height variables
              do not match any valid configuration.

       fullscreen
              If non-zero, the game will run in full screen  mode.   If  zero,
              the game will run in a window.

       aspect_ratio_correct
              If  non-zero, the screen will be stretched vertically to display
              correctly on a square pixel video mode.

       startup_delay
              Number of milliseconds to wait on startup after the  video  mode
              has  been  set,  before  the  game  will start.  This allows the
              screen to settle on some monitors that do not display  an  image
              for a brief interval after changing video modes.

       screen_width
              Screen width in pixels.  If running in full screen mode, this is
              the X dimension of  the  video  mode  to  use.   If  running  in
              windowed mode, this is the width of the window in which the game
              will run.

       screen_height
              Screen height in pixels.  If running in full screen  mode,  this
              is  the  Y  dimension  of  the video mode to use.  If running in
              windowed mode, this is the height of the  window  in  which  the
              game will run.

       grabmouse
              If this is non-zero, the mouse will be "grabbed" when running in
              windowed mode so that it can be used as an  input  device.  When
              running full screen, this has no effect.

       novert If  non-zero,  all  vertical  mouse  movement  is ignored.  This
              emulates the behavior of the "novert" tool available  under  DOS
              that performs the same function.

       mouse_acceleration
              Mouse  acceleration  factor.   When  the speed of mouse movement
              exceeds the threshold  value  (mouse_threshold),  the  speed  is
              multiplied by this value.

       mouse_threshold
              Mouse  acceleration threshold.  When the speed of mouse movement
              exceeds this threshold value, the  speed  is  multiplied  by  an
              acceleration factor (mouse_acceleration).

       snd_samplerate
              Sound  output  sample  rate,  in  Hz.  Typical values to use are
              11025, 22050, 44100 and 48000.

       show_endoom
              If non-zero, the ENDOOM screen is  displayed  when  exiting  the
              game.  If zero, the ENDOOM screen is not displayed.

       vanilla_savegame_limit
              If  non-zero,  the  Vanilla  savegame  limit is enforced; if the
              savegame exceeds 180224 bytes in size, the game will  exit  with
              an error.  If this has a value of zero, there is no limit to the
              size of savegames.

       vanilla_demo_limit
              If non-zero, the Vanilla demo size limit is enforced;  the  game
              exits  with  an  error  when  a demo exceeds the demo size limit
              (128KiB by default).  If this has a value of zero, there  is  no
              limit to the size of demos.

       vanilla_keyboard_mapping
              If non-zero, the game behaves like Vanilla Doom, always assuming
              an American keyboard mapping.  If this has a value of zero,  the
              native keyboard mapping of the keyboard is used.

       video_driver
              Name  of  the  SDL  video  driver  to  use.  If this is an empty
              string, the default video driver is used.

       player_name
              Name to use in network games for identification.  This  is  only
              used  on  the  "waiting"  screen  while  waiting for the game to
              start.

       joystick_index
              Joystick number to use; ’0’ is the first joystick.   A  negative
              value (’-1’) indicates that no joystick is configured.

       joystick_x_axis
              Joystick axis to use to for horizontal (X) movement.

       joystick_x_invert
              If  non-zero,  movement  on  the  horizontal  joystick  axis  is
              inverted.

       joystick_y_axis
              Joystick axis to use to for vertical (Y) movement.

       joystick_y_invert
              If non-zero, movement on the vertical joystick axis is inverted.

       joyb_strafeleft
              Joystick button to strafe left.

       joyb_straferight
              Joystick button to strafe right.

       mouseb_strafeleft
              Mouse button to strafe left.

       mouseb_straferight
              Mouse button to strafe right.

       mouseb_use
              Mouse button to "use" an object, eg. a door or switch.

       mouseb_backward
              Mouse button to move backwards.

       dclick_use
              If  non-zero,  double-clicking a mouse button acts like pressing
              the "use" key to use an object in-game, eg. a door or switch.

       use_libsamplerate
              Controls whether libsamplerate support is  used  for  performing
              sample rate conversions of sound effects.  Support for this must
              be compiled into the program. If zero, libsamplerate support  is
              disabled.   If  non-zero,  libsamplerate  is enabled. Increasing
              values roughly correspond  to  higher  quality  conversion;  the
              higher  the  quality, the slower the conversion process.  Linear
              conversion = 1; Zero order hold =  2;  Fast  Sinc  filter  =  3;
              Medium quality Sinc filter = 4; High quality Sinc filter = 5.

SEE ALSO

       chocolate-doom(6), default.cfg(5), chocolate-setup(6)

                                                         chocolate-doom.cfg(5)