Difference between revisions of "PrBoom+"

From DoomWiki.org

[checked revision][unchecked revision]
m (PrBoom+ um)
(Freelook is available in software too, and freeaim when not recording.)
Line 33: Line 33:
 
* Video capture with the [[Source port parameters#-viddump <filename>|<tt>-viddump</tt>]] [[source port parameters|parameter]] (requires external programs)
 
* Video capture with the [[Source port parameters#-viddump <filename>|<tt>-viddump</tt>]] [[source port parameters|parameter]] (requires external programs)
 
* Support for [[jumping]] when not recording demos
 
* Support for [[jumping]] when not recording demos
 +
* Optional [[free look]] (though, by default, aiming is not affected and [[autoaim]] behaves as if the line of sight remained horizontal. Free aim can be enabled when not recording demos)
 
===OpenGL mode features===
 
===OpenGL mode features===
 
In OpenGL mode PrBoom+ offers three rendering paths:
 
In OpenGL mode PrBoom+ offers three rendering paths:
Line 44: Line 45:
 
* [[GZDoom]]-style [[skybox]]es through the GLDEFS lump (or its alias GLBDEFS)
 
* [[GZDoom]]-style [[skybox]]es through the GLDEFS lump (or its alias GLBDEFS)
 
* Optional animation blending for animated flats and textures, similar to [[ZDoomGL (v1)]]
 
* Optional animation blending for animated flats and textures, similar to [[ZDoomGL (v1)]]
* Optional [[free look]] (though aiming is not affected and [[autoaim]] behaves as if the line of sight remained horizontal)
 
 
* Details textures (also defined in GLDEFS lump)
 
* Details textures (also defined in GLDEFS lump)
 
* Optional textured [[automap]]
 
* Optional textured [[automap]]

Revision as of 02:10, 7 July 2021

PrBoom+
PrBoom+ logo.png
Standard Doom, Boom, MBF
Codebase PrBoom
Developer(s) Andrey Budko (entryway), Christoph Oelckers (Graf Zahl), Fabian Greffrath
Initial release 2.2.6.3
Latest release 2.6.66 (2023-06-20, 9 months ago)
Development status Active
Written in C
Target Platform Cross-Platform
License GNU General Public License v2+
Website http://prboom-plus.sourceforge.net/
Source Repository

(Git)

GitHub
PrBoom+ (also PrBoom-plus) is a source port based on PrBoom. GLBoom+ is a common name for a build of PrBoom+ compiled with OpenGL support. It is developed by Andrey Budko (entryway).

PrBoom+ is based on the PrBoom 2.5.x line of development. It can currently be compiled in POSIX, Windows and Mac OS X environments. The current version is 2.6.66, released on 2023-06-20. The project saw its first developments in 2004, starting off as an unnamed PrBoom modification, but after gaining numerous additions over PrBoom it eventually adopted the separate PrBoom+ title in 2005.

Since version 2.5.1.5, PrBoom+ is released with support for the UMAPINFO standard, retaining the same name, but visually separated in version number with the letters um, referring to the initials of the standard.

PrBoom+ features

In addition to all PrBoom features, PrBoom+ offers

  • Chasecam for demo playbacks
  • Changing the speed of the game in-game (for demo playback, recoding TAS demos, and for just playing at different speed)
  • Automatic loading of WADs necessary for playback, chosen by demo name or by information present in demo file (if recorded with PrBoom+)
  • Accurate Doom v1.2 emulation if needed during demo playback or requested by user
  • Support for DeePBSP and ZDBSP extended nodes
  • Support for the MUSINFO lump shared with Risen3D, ZDoom and GZDoom
  • MIDI output with OPL emulation, FluidSynth, PortMidi, or SDL
  • Ogg Vorbis and MP3 playback
  • Speed optimisations for very large levels, compared to PrBoom
  • Customizable HUD with the -PRBHUD- lump
  • Video capture with the -viddump parameter (requires external programs)
  • Support for jumping when not recording demos
  • Optional free look (though, by default, aiming is not affected and autoaim behaves as if the line of sight remained horizontal. Free aim can be enabled when not recording demos)

OpenGL mode features

In OpenGL mode PrBoom+ offers three rendering paths:

  • OpenGL 2.0. The shader mode. This includes support for shaders using the ARB assembly language.
  • OpenGL 1.2 (Will detect OpenGL 1.3 as well)

Both these are considered the main support levels. One additional rendering path is also supported:

  • OpenGL 1.1. This is used as a compatibility mode in case the videocard does not support the previously mentioned render paths.

In addition to all aforementioned PrBoom+ features, in OpenGL mode PrBoom+ can also use:

  • ZDoom-style high-resolution textures/flats/sprites (replacements located between HI_START and HI_END markers)
  • Support for PNG and DDS formats for high-res textures
  • GZDoom-style skyboxes through the GLDEFS lump (or its alias GLBDEFS)
  • Optional animation blending for animated flats and textures, similar to ZDoomGL (v1)
  • Details textures (also defined in GLDEFS lump)
  • Optional textured automap

Detail texture definition

A detail texture is defined in a GLDEFS text lump. The syntax is as follows:

detail
{
  (walls | flats) [default_detail_name [width [height [offset_x [offset_y]]]]]
  {
    texture_name [detail_name [width [height [offset_x [offset_y]]]]]
  }
}

Where detail_name is a bmp/png/tga/jpg/pcx/gif lump between the HI_START/HI_END markers. You do not need to add the texture to TEXTURES1. Default values are (width:16 height:16 offset_x:0 offset_y:0)

Example:

detail
{
  walls smooth01 32.0 //default detail for walls (width = 32, height = 16, offset_x/y = 0)
  {
    brick7  detstone 64.0 64 10.532
    brick8  detail02 // detail02 16 16 0 0
    water1 // do not apply default detail to water
    water2
    water3
    water4
  }
  flats // no default detail for flats
  {
    grass1 Grass01 32 32
    NUKAGE1 detslime 16 16 0 0 // different offsets for animated flats make sense
    NUKAGE2 detslime 16 16 4 4
    NUKAGE3 detslime 16 16 8 8
  }
}

PrBoom+um

Version 2.5.1.5 was released as a test version by the PrBoom+ team, but was also the first official release of PrBoom+ with UMAPINFO support. Initially created by Graf Zahl, his branch was first build upon PrBoom+ 2.5.1.4, with a first release on April 22, 2017.

Since 2.5.1.5, every version since of PrBoom is of the UMAPINFO branch, with the original creator of PrBoom+, Andrey Budko (entryway) declaring it as its successor.

Compatibility modes

PrBoom+ supports various of compatibility settings to adjust its behavior, much like those initially implemented for MBF. In addition to individual settings for each difference in behavior, it allows the user to set compatibility levels to behave like earlier versions and modifications of the Doom engine. With the compatibility levels PrBoom+ may provide almost flawless compatibility with regular demos, as well as those recorded with Boom engines.

To change compatibility levels, the cheat code tntcomp can be used ingame. The game can also be launched with the -complevel parameter, or with default_compatibility_level in the config file, followed by one of the following numbers:

Level Emulated engine
-1 Current PrBoom-plus
0 Doom v1.2
1 Doom v1.666
2 Doom v1.9
3 Ultimate Doom & Doom95
4 Final Doom (emulates exclusively the release with bugged teleports)
5 DOSDoom
6 TASDoom
7 Boom's compatibility mode (emulates the inaccurate vanilla mode of Boom)
8 Boom v2.01
9 Boom v2.02
10 LxDoom v1.4.x
11 MBF
12—16 PrBoom (old versions)
17 Current PrBoom-plus
  • If a custom wad has "BOOM compatible" in its description, use "9 - Boom v2.02".
  • If a custom wad has "MBF compatible" in its description, use "11 - MBF".

Launchers

Trivia

  • A fork of PrBoom+, known as the UMAPINFO branch by Graf Zahl, includes support for the DEHEXTRA standard, supporting many more additional states, things and codepointers.

See also

External links

Source code genealogy
Based on
PrBoom
PrBoom+ Active