OpenGL preferences

From ZDoom Wiki
Jump to: navigation, search
Menus: Main menu → Options menu → Display options → OpenGL options
The OpenGL preferences menu in The Nadir.
Center Warning: This feature does not work in ZDoom but in its OpenGL children ports.

The OpenGL preferences menu allows to configure miscellaneous options of the OpenGL renderer. Its MENUDEF name is GLPrefOptions.

  • Sector light mode (Standard/Bright/Doom/Dark/Legacy)
gl_lightmode
Chooses which method to use for managing light diminishing of ambient light levels in sectors. Note that the choice made here can be overridden by the lightmode property in a MAPINFO map definition.
  • Standard: Uses a standard OpenGL formula.
  • Bright: Uses a weak fading keeping sectors relatively bright.
  • Doom: A close approximation to the software renderer's display. Uses MiniWikipediaLogoIcon.pngGLSL to handle the increased brightness around the player's viewpoint; otherwise identical to "dark".
  • Dark: Close approximation of the software renderer, but without the brightening of nearby areas.
  • Legacy: Emulates the lighting model of the Doom Legacy 1.42 OpenGL renderer.
  • Software: Uses MiniWikipediaLogoIcon.pngGLSL to replicate vanilla Doom's light diminishing algorithms, including the increased brightness around the player's viewpoint. Falls back to "dark" if shaders are unavailable.
  • Fog mode (Off/Standard/Radial)
gl_fogmode
Selects the fog mode.
  • Fog forces fullbright (Yes/No)
gl_brightfog
If this option is turned on, foggy sectors use full brightness and treat the light level as fog density. This is recommended for white fogs but should not be used for black fogs.
  • Weapon light strength (0—32, by 2 increments)
gl_weaponlight
(Need more info)
  • Environment map on mirrors (On/Off)
gl_mirror_envmap
Enables or disables the use of the mirror.png texture (contained in gzdoom.pk3) as an MiniWikipediaLogoIcon.pngenvironment map on mirrors.
  • Enhanced night vision mode (On/Off)
gl_enhanced_nightvision
Enables or disables the enhanced nightvision effect which changes how the PowerLightAmp and PowerTorch effects work. If "off", they behave like the software renderer and merely give full brightness to everything. If on, however, the light amplification visor shows the world geometry in green and the sprites of monsters and items are in inverted colors; while everything illuminated by the torch lies in a flickering golden light.
  • ENV shows stealth monsters (Never/Infrared only/Infrared and torch/Any fixed colormap)
gl_enhanced_nv_stealth
If enhanced night vision is on, monsters with the STEALTH flag can be seen while an effect altering vision with a fixed colormap is active. This option allows to fine-tune this effect to restrict it to light powerups (both infrared and torch) or just the infrared, and it can as well disable the sight of stealth monsters altogether.
  • Force brightness in fog (On/Off)
gl_spritebrightfog
The software renderer is unable to handle full brightness in foggy or faded areas, and by default the OpenGL renderer emulates this. This option allows to let fullbright or brightmapped sprites retain their brightness.
  • Adjust sprite clipping (Never/Smart/Always/Smarter)
gl_spriteclip
The OpenGL renderer clips off sprites when they go "within" a floor or ceiling; whereas the software renderer overdraws them, a fact which has been willfully exploited to fake certain perspective effects. The result is that many sprites are abruptly cut off when they shouldn't be. The adjustment cheats by adjusting their offset so that they are less cut off.
  • Never: Offsets are not adjusted at all.
  • Smart: Offsets are only adjusted if they meet certain criteria.
  • Always: Offsets are always adjusted if they make the sprite sink in the ground.
  • Smarter: Offsets are adjusted in a wider range of cases than with "smart", including if they sink in the ceiling. The amount by which they are adjusted is scaled according to the overall height of the sprite. Very small sprites (such as POB2A0) are visible, contrarily to "smart", even if they are offset in the ceiling (such as CDRP[ABCD]0); and tall sprites (such as TGRNA0) do not seem to hover above the floor, contrarily to "always".
  • Smooth sprite edges (On/Off)
gl_sprite_blend
Enables or disables blending the edges of the sprites into the background. Turning it on also sometimes solves graphical glitches that may seem unrelated.
Billboard axes illustrated.
  • Fuzz Style (Shadow/Pixel fuzz/Smooth fuzz/Swirly fuzz/Translucent fuzz/Noise/Smooth Noise)
gl_fuzztype
Selects how the fuzz effect is rendered in OpenGL mode. All options except "Shadow" require pixel shaders to be available.
  • Sprite billboard (Y Axis/X/Y Axis)
gl_billboard_mode
Chooses whether sprites, by default, are billboarded on the Y axis (and remain vertical, appearing paper-thin if viewed at an extreme angle) or on the X/Y axis (and remain always fully visible, but oddly rotated if viewed at an extreme angle). The FORCEYBILLBOARD and FORCEXYBILLBOARD flags allow to override the default. Note that X/Y billboarding suffers from a few minor glitches, especially when transparent 3D floors are involved.
  • Particle style (Square/Round/Smooth)
gl_particles_style
Selects how particles are rendered. The "smooth" option uses a texture with gradually increasing alpha toward its edges, whereas "square" and "round" use solid primitives and are therefore much faster to render.
  • Ambient light level (0—255.0, by 5.0 increments)
gl_light_ambient
Chooses the minimum value for ambient sector light.
  • Rendering quality (Speed/Quality)
gl_render_precise
If set on "speed", the renderer will sacrifice precision for performances and graphical artifacts (typically, tiny white dots at the edges of polygons in level geometry) may appear. If set on quality, the rendering should be free of such artifacts, but performances may suffer.
  • Use vertex buffer (Off/Static/Dynamic)
gl_usevbo
Selects if and how MiniWikipediaLogoIcon.pngvertex buffer objects are used by the renderer. Benchmarks have shown that this provides a small performance boost on Nvidia hardware. However, on ATI hardware, setting this on may cause glitches.