0.79.0 Release Notes

1. Table of Contents

2. Introduction

Get started by downloading the latest version and updating your configuration file:

Downloads:

Configuration file upgrade:

  1. Launch the new version.
  2. At theZ:\> prompt, run: config -wc to write the new configuration file. Any existing settings will be retained, however, extraneous comments will be dropped.

What you can expect:

3. Audio Improvements

3.1. AdLib Gold Surround Module Emulation

The ultra-rare AdLib Gold surround sound daughterboard is now emulated, which makes it possible to finally enjoy the Dune soundtrack in its full glory! That's the only game in existence that makes use of the surround module.

The following config is recommended for Dune. The setup utility should auto-detect AdLib Gold and the surround module correctly with these settings.

[sblaster]
sbtype = sb16
oplmode = opl3gold

3.2. Sound Card Output Filter Emulation

Most DOS-era sound cards feature an output low-pass filter (and sometimes a high-pass filter too) that play an important role in giving their sound its character. DOSBox Staging can now accurately emulate these analog output stage filters for all supported sound devices.

Sound Blaster

For backward compatibility reasons, the sb_filter config parameter defaults to the newly introduced modern filter, which uses the simple linear interpolation method of previous DOSBox versions. To turn on accurate analog output filter emulation, set the sb_filter to auto. This will set the correct filters for each Sound Blaster model depending on the sb_type value. You can also set a model-specific filter manually if you wish, e.g. this is how to use a Sound Blaster 16 but with Sound Blaster Pro filters:

[sblaster]
sbtype = sb16
sb_filter = sbpro1

Some Sound Blaster models can toggle the filter on and off in software; you can force the filter to be always on by setting sb_filter_always_on to true.

OPL and CMS filters are also accurately emulated; please refer to the descriptions of the opl_filter and cms_filter config parameters for further details.

Small-speaker Systems

Filters are enabled by default for all small-speaker audio systems (PC Speaker, PS/1 Audio, Tandy, and the various LPT DAC options). Depending on the particular device, these filters either emulate the analog output filters of the original device, or the sound coming out of a small band-limited speaker in an acoustic environment. Either way, the result is a more period-accurate and pleasant listening experience, especially on headphones.

Small-speaker filters are controlled by the following config parameters:

Custom Filters

Advanced users can specify custom filter settings for any of the supported sound devices. You can specify either a high-pass filter, a low-pass filter, or both at the same time using the following format

TYPE ORDER FREQ [TYPE ORDER FREQ]

where TYPE can be hpf (high-pass) or lpf (low-pass), ORDER is the order of the filter from 1 to 16 (1st order results in a 6dB per octave slope, 2nd order in a 12dB per octave slope, etc.), and FREQ is the filter's cutoff frequency in Hz.

For example, to use a 2nd order (12dB/oct) low-pass filter at 8 kHz for the Sound Blaster:

sb_filter = lpf 2 8000

To use a 3rd order (18dB/oct) high-pass filter at 120 Hz, and a 1st order (6dB/oct) low-pass filter at 6.5 kHz for the PC Speaker:

pcspeaker_filter = hpf 3 120 lfp 1 6500

In addition to the sound devices mentioned above, you use custom filters even with devices that don't filter the output in the original hardware (e.g. GUS, MT-32), and the FluidSynth virtual MIDI device via the following config parameters:

3.3. Crossfeed

Listening to audio material on headphones where certain sounds are only present in either the left or the right channel can be a rather distracting and unpleasant experience. This is most noticeable on certain Dual OPL game soundtracks and tracker music (e.g. MOD, XM, S3M, IT, etc.)

The new crossfeed feature remedies that; by enabling crossfeed in the [mixer] section, a certain percentage of the left channel is mixed into the right, and vice versa. The default crossfeed strength is 40% which is a good general setting, but you can provide a custom percentage value as well (e.g. crossfeed = 55).

The amount of crossfeed can be fine-tuned per individual channels via mixer commands; please type MIXER /? in the DOSBox prompt for further details.

3.4. Reverb and Chorus

Reverb

One of the most exciting new audio features is the ability to add reverb (the emulation of real acoustic spaces) and chorus effects to any mixer channel. This can add a lot of atmosphere to dry-sounding synth soundtracks (typically OPL music) and elevate them to a whole new level! Enabling reverb and chorus processing is especially useful for headphone-listening.

The quickest way to enable the reverb effect globally is to put reverb = on in the [mixer] config section. This will add reverb to all synth channels (e.g. PC Speaker, OPL, CMS), and a lesser amount to digital audio channels (e.g. Sound Blaster, GUS). While the default setting works well in most games, it's highly recommended to experiment with the five available reverb presets to find the optimal setting for each game:

Chorus

Another way to add a sense of space to the sound is by enabling the chorus effect. This adds stereo movement and increases the perceived stereo width, which is especially noticeable on purely mono signals on headphones (e.g. PC Speaker or OPL2 music). To enable it, just put chorus = on into the [mixer] config section, or select one of three predefined chorus strength presets, light, normal or strong.

Similarly to crossfeed, per-channel reverb and chorus settings can be tweaked by mixer commands; please type MIXER /? in the DOSBox prompt for details.

Audio Examples

Naturally, you can combine chorus and reverb, and it's not only possible to do so, but highly recommended for achieving the best results! The below recordings showcase how crossfeed, reverb, chorus, and output stage filters can work in tandem to give old DOS game soundtracks a new life.

The exact settings used for these recordings are documented on the Wiki, along with suggested audio configs for many other games. Make sure to check them out and experiment with the settings yourself! :sunglasses: :speaker: :headphones:

Alone in the Dark intro (floppy version)

GameTypeAudio Example
Alone in the Dark
(floppy version)
OPL2
Warcraft: Orcs & HumansOPL3
Dungeon Master II:
The Legend of Skullkeep
Dual OPL2
Ultima Underworld I: The Stygian AbyssDual OPL2
Elvira: Mistress of the DarkDual OPL2
Skate or Die!Tandy
Zak McKracken and the Alien MindbendersTandy
Budokan: The Martial SpiritCMS
The Secret of Monkey IslandCMS

3.5. Master Compressor

An auto-levelling dynamic range compressor has been introduced to the master channel to ensure that the audio output never gets distorted, no matter how high the volume levels are. This is on by default and is virtually transparent when the output is not driven into clipping. However, purists can disable it by setting compressor to off, and then ensure correct non-clipping output levels manually.

3.6. General Mixer Improvements

3.7. "One OPL mode to rule them all" 💍

NukedOPL has long been the default OPL mode in Staging. As it's basically a bit-perfect emulation of the Yamaha YMF262 OPL3 chip, and it runs fast enough even on low-end hardware such as the Raspberry Pi 4, all other less accurate OPL emulation modes have been removed.

3.8. FluidSynth Configuration Changes

FluidSynth Reverb and Chorus

Due to the introduction of the new mixer-level reverb and chorus effects, the FluidSynth reverb and chorus config parameters have been renamed to fsynth_reverb and fsynth_chorus, respectively.

To maintain backward compatibility with existing configurations, the FluidSynth reverb and chorus effects are enabled by default, so all your SoundFonts will sound just like in previous DOSBox versions. If you enable the mixer-level reverb (or chorus) as well (e.g. by putting reverb = on in the [mixer] section), you would get a second round of reverb (or chorus) processing on the FluidSynth output. This is by design as it allows users the greatest level of control over customising SoundFonts (e.g. some would sound best with the FluidSynth reverb only, some with both, etc.)

Note that in the SF2 format the reverb and chorus amounts are specified on a per-instrument basis, while the mixer-level effects are applied "globally" to all instruments in the summed FluidSynth output. Therefore, what works best really depends on the particular SoundFont in question and on individual user preference (see this discussion for further technical details).

Volume Scaling

Previously, it was possible to specify a percentage after the SoundFont's name in the config to adjust its volume (e.g. soundfont = way_too_loud.sf2 30). This was introduced as a workaround for certain loud SoundFonts that tended to clip the mixer channel internally.

With the floating-pointing mixer signal path, it's no longer possible to drive any of the mixer channels into clipping, therefore this workaround has been deprecated. Please use standard mixer commands to lower the volume of the FSYNTH channel if you wish to do so.

3.9. ripa's PC speaker Patch

We've integrated ripa's impulse-model PC speaker patch alongside DOSBox's existing (discrete-model) PC speaker implementation, which is still the default.

To use it, set the pcspeaker conf setting to impulse (or go back to default with discrete).

James-F and VileRancour have mentioned in the linked thread that it generally improves the accuracy of square-wave effects, such as in Commander Keen and Duke Nukem (2D). This patch also can produce sounds when none previously existed, such as in Wizball, as noted by ripsaw8080.

For example, here's Wizball using the settings below:

[mixer]
rate = 32000

[speaker]
pcspeaker = discrete

Wizball

Note: There are some audible regressions and harmonics that still exist in some games, so that's why this is an alternative and not the default.

3.10. Parallel Port DAC Models: Disney, Covox, and Stereo-On-1

Those familiar with DOSBox know that these three devices are emulated with the universal disney = true setting.

Like sbtype =, we wanted the model of LPT DAC to be configurable, and so Staging's deprecated the disney setting in favour of lpt_dac = that takes any of the following:

This is paired with a corresponding filter setting, lpt_dac_filter, which approximates how the original device sounded. This means that the Disney Sound Source (which included a little speaker inside it) will sound a lot like you might remember.

lpt_dac =Examples (ModPlay Pro & Star Control II's 8-bit Pkunk MOD)
"disney"
"covox"
"ston1"

Like the other audio filters settings, the lpt_dac_filter can be toggled on, off, or customised.

3.11. Audio Mute and Pause

The audio stream can now be manually muted with Ctrl + F8 (or Cmd + F8 on macOS).

You can also mute the audio automatically when DOSBox Staging goes to the background with this conf setting:

[sdl]
mute_when_inactive = true

Or you can pause emulation entirely when in the background with:

[sdl]
pause_when_inactive = true

4. Graphical Improvements

4.1. Shader Reload Shortcut

As DOSBox Staging currently lacks a shader preset system, tweaking shader parameters can only be accomplished by making changes to the shader source files themselves. Previously, you had to restart DOSBox to see the effects of such changes, which made fine-tuning shaders quite cumbersome, to say the least.

Now you can just use the Ctrl + F2 shortcut (Cmd + F2 on macOS) to reload the current shader at any time. Progress! :sunglasses:

4.2. CGA Palette Override

Now it is possible to override the default, canonical interpretation of the 16-colour CGA/EGA RGBI palette. The feature overrides the CGA colours in any CGA/EGA-like mode, so it even works in CGA/EGA modes with an emulated VGA or TGA (Tandy) graphics adapter.

Several presets have been included (e.g. Amiga and Atari ST colours for Sierra games, and various CGA/EGA monitor emulations), and you can specify custom palettes as well. Make sure to check out the description of the cga_colors config parameter for the list of available presets (you can read more about them here).

Defender of the Crown

tandy-warm emulates the colours as they appear on an actual Tandy monitor, which results in more subdued and pleasant colours. This is especially apparent on the greens.

defaulttandy-warm
Defender of the Crown (default)Defender of the Crown (tandy-warm)

Gold Rush

The Amiga/Atari ST ports of Sierra AGI games feature a tweaked CGA palette with improved skin tones and sky colours.

defaultagi-amigaish
Gold Rush! (default)Gold Rush! (agi-amigaish)

Zak McKracken and the Alien Mindbenders

Now you can play the PC version of this classic adventure with Tandy sound and Commodore 64 colours!

defaultcolodore
Zak McKracken (default)Zak McKracken (colodore)

4.3. Scaled Image Quality Improvements

When the image is scaled by non-integer ratios (e.g. when aspect correction is enabled with the default sharp OpenGL shader), previously the interpolation was performed in a gamma-incorrect way, leading to various unwanted artifacts. These were most noticeable on checkerboard dither patterns (used frequently in EGA games), appearing as interference (moiré) patterns, and on high-contrast antialiased text (e.g. regular black text on white background appeared bold).

(Note for Mac users: All Mac browsers tend to display the below images with incorrect gamma on the built-in MacBook displays, which makes the "bad" images look less wrong, and there are slight interference patterns on the "good" images. Please download the images and view them in the Preview app instead, which displays them correctly.)

Time Quest

goodbad
Timequest (good)Timequest (bad)

Space Quest III: The Pirates of Pestulon

goodbad
Space Quest III (good)Space Quest III (bad)

Windwalker

goodbad
Windwalker (good)Windwalker (bad)

4.4. High DPI on macOS

The backstory: DOSBox Staging uses OpenGL output with the sharp bilinear scaling shader to keep the picture crisp no matter how big or small the image is, and minimise blurring on pixel transitions.

Due to the way macOS handles DPI scaling, the image was drawn at a much lower resolution, usually just a quarter of the window size. Then it was stretched by the system, producing an unpleasantly mushy presentation. But we want our pixels to be so sharp they could cut one's eyes.

BeforeAfter
DOSBox Staging on macOS without hiDPI supportDOSBox Staging on macOS with hiDPI support

Now DOSBox Staging can handle high DPI displays, be it Retina or not, so you and shaders alike can see all the (physical) pixels.

Please note that this is currently experimental: only macOS is currently supported, and we haven't thoroughly tested multi-display setups. Please report any weird behaviour! Support for Windows will come in the future, and for Linux, it is still uncertain. Also note that due to the way rendering is currently implemented, you may observe lowered performance on higher resolution displays, especially when running off integrated graphics. This might be remedied in the future as well.

4.5. Window Transparency Support

There might be situations where you want to place the DOSBox Staging window on top of another window while seeing both windows at the same time. Indeed, you can now set the DOSBox Staging window as transparent, with a customised level of window transparency, so that you can see the background window as well. There is a new config option transparency for this, whose valid values are between 0 (no transparency; default) to 90 (high transparency).

Transparent window

4.6. Frame Presentation Modes

DOSBox presents frames when new content is available, which means that sometimes the effective frame rate can vary between 0 FPS (if the screen content isn't changing) and as fast as the DOS vertical refresh (vblank) rate (typically up to ~70 Hz). We'll call this presentation mode Variable Frame Rate or VFR.

In addition to VFR, DOSBox Staging supports a Constant Frame Rate (CFR) presentation mode, which presents a constant frame rate defined by the emulated DOS rate, as well as variations on both:

By default, DOSBox Staging inspects runtime conditions and picks the optimal presentation mode.

Earthworm Jim (synced CFR)

Synced CFR mode selected due to vsync-enforced video drivers

Although typically not needed, power users might be interested in forcing a given mode or rate, which can be done using the following conf settings (which includes detailed descriptions in the conf):

[sdl]
presentation_mode = auto | cfr | vfr
host_rate = auto | sdi | vrr | custom-rate

[dosbox]
dos_rate = default | host | custom-rate

5. DOS Shell Improvements

5.1. Piping from the DOS Prompt or Batch Files

DOSBox did not support the piping operation previously, but DOSBox Staging now brings piping support as how it has worked in DOS and most other operating systems. This allows two or more commands to communicate by passing the output text of one command to another as its input text. For example, commands like ECHO Y | CHOICE will work, so that the Y option will be passed as the input of CHOICE command. Chained piping is also supported, such as DIR | SORT | MORE for displaying sorted directory output one screen at a time (provided that you have the SORT and MORE commands from MS-DOS or FreeDOS in your path). If the current directory and C:\ are both read-only, the environment variable %TEMP% (or %TMP%) needs to be set within DOS pointing to a writable directory so that piping will work properly (e.g. SET TEMP=C:\TEMP).

5.2. File Attribute Support and ATTRIB Command

File attributes contain information about how the files should be used, and in DOS these correspond to Archive (A), Read-only (R), Hidden (H), and System (S) attributes. DOSBox Staging now adds support for file attributes through ATTRIB command (type ATTRIB /? for more information about this command) or through DOS API that accesses to file attributes. For example, some game installers and applications make use of file attributes. All file attributes are currently supported except for system and hidden attributes on mounted local drives for non-Windows platforms.

ATTRIB command help

5.3. Default Choices for the CHOICE Command

The CHOICE command allows you to choose from a list of options, but sometimes you want to have some default choice if no selection is made within the specific time period. DOSBox Staging now allows you to do this, by specifying the /T option which includes a default choice and the time period in seconds. For example, CHOICE /C:ABC /T:B,2 will default to the choice B (among A, B, and C) if no key press is made within 2 seconds.

6. Mount Improvements

6.1. Physical CD-ROM Mount Support

Mounting physical CDs is now (re-)implemented in DOSBox Staging for better compatibility with games like Under a Killing Moon, System Shock, and The Pandora Directive. The feature is supported in DOSBox SVN but was forced to be dropped from DOSBox Staging earlier during the SDL2 migration process. We've brought it back by using the SDL1 CD support code as an external library, plus restoring the main SDL CD interface from DOSBox.

To use the feature, execute the command mount -cd to list all CD drives and their numbers, and use -usecd NUMBER parameter to specify a CD drive NUMBER, just like you would do in DOSBox SVN. Playing CD audio tracks from physical discs is also supported in Windows as with DOSBox SVN.

Mount support for Physical CD

6.2. Read-Only Disk Image Mount Support

You might have encountered the problem previously that you could not mount write-protected disk images, which happened simply because DOSBox Staging required write access to mount disk images. Sometimes the user may also want to mount a disk image in a read-only manner (so that the content in the disk image will not be changed inside the emulator), even if the disk image itself is not write-protected. We have realised that in either case the requirement for write access is not needed for mounting disk images, so we have added support for mounting them in a read-only manner, either when the disk image files are read-only or when the -ro flag is specified by the users.

6.3. Z Drive Customisation and Directory Support

The internal Z drive that is automatically mounted when you launch DOSBox Staging is now fully customisable, allowing users to add their own files or programs to the drive by putting them in the drivez subdirectory inside the DOSBox Staging program directory. Files already existing on the Z drive will be replaced by the user-provided ones, e.g. you can use your own MEM.COM or KEYB.COM commands instead of the default ones on the Z drive. Moreover, support for one-level subdirectories has been added, allowing users to better organise their files, resulting in a cleaner-looking Z drive. The drive's contents can be refreshed via the RESCAN command to reflect any changes made to it at the host OS level.

6.4. IMGMOUNT Wildcard Support

The IMGMOUNT command allows you to mount disk or CD images, but sometimes you may want to mount multiple images to a single drive, swappable via a keyboard shortcut. Previously you had to specify the names of the all the image files one by one, even if they have some patterns in common (like DISK1.IMG, DISK2.IMG, DISK3.IMG, etc). IMGMOUNT command now supports wildcards for mounting image files, so that you can just specify a file pattern that matches all the image files that you want to include. For example, the command IMGMOUNT a d:\*.img -t floppy will mount all image files with the IMG extension on D:\ as floppy images.

Mount images with wildcard

6.5. Automount of Resource Drives

Directories can now be automounted, provided the automount conf setting is enabled (which it is, by default).

These automount directories are single-letter directories, a through y representing the mounted drive letter (where z is reserved for DOSBox's drive) placed inside a local drives/ directory, relative to the startup location. This drives/ directory can also be placed in a scanned resource location, like your dosbox conf directory or the release package's resources/ area.

Each drive can be customised with an accompanying <letter>.conf to define its mount type, label, and path. For example, to mount a local drives/d/ directory as a D: CD-ROM with the label SIERRA, the accompanying d.conf would contain:

[drive]
type = cdrom
label = SIERRA

A bundled Y: automount is provided in the release's resources/ directory that bundles a couple FreeDOS 3rd party tools (XCOPY.COM, DELTREE.COM, DEBUG.COM) along with an accompanying y.conf to add it to the PATH.

Note that this feature doesn't yet support image mounts, such as .img, .bin/cue, or .iso.

7. Localisation Improvements

7.1. Code Pages and Keyboard Layouts

The 20-year-old FreeDOS code pages (screen fonts) and keyboard layouts were updated to the latest versions, offering countless new definitions for use. See the full list in the following documentation:

Some notable examples:

7.2. Country Support for Different Date, Time, and Decimal Formats

The display formats for dates, times, and decimals were previously fixed to the United States style, but this is no longer the case with this new version. Indeed, DOSBox Staging can now display date, time, and decimal formats according to the system locale and country settings, and for example, in the Canadian French locale (country code 2) the date and time will be displayed as 2002-10-01 12:34 instead of 10-01-2002 12:34p as displayed in the United States locale (country code 1). There is a new config option country which allows you to manually specify the country code for the date, time, and decimal formats.

Canadian French localeUnited States locale
DIR command (CF)DIR command (US)

7.3. Local Language and Keyboard Layout Detection Improvements

On macOS and Windows systems, local languages now are more robustly detected and applied.

Note that these can still be manually set using the language and keyboardlayout conf settings when needed, or via the KEYB command as mentioned above.

8. Input Improvements

8.1. Mouse-Wheel Emulation

The built-in mouse driver now provides a wheel support for application aware of CuteMouse extensions; examples include Necromancer's DOS Navigator and Mpxplay.

The original CuteMouse driver version 2.1 is also able to use the PS/2 mouse wheel, just start it with CTMOUSE /o.

8.2. Serial Mice Emulation

Numerous serial (COM port) mice are now emulated:

To enable serial mouse, user the SERIAL 1 mouse command (this will attach it to the COM1 port), or edit the [serial] section of the configuration file. By default, DOSBox Staging tries to determine what kind of mouse the game or application expects.

With serial mouse emulation, Windows 1.01 is finally usable!

8.3. Windows 3.1 Seamless Mouse Integration

It is now possible to have a seamless mouse integration using one of the following 3rd party VMware-compatible Windows 3.1 mouse drivers:

For now, only the mouse is supported (no VMware directory sharing, etc.), only using VMware protocol (no VirtualBox-only drivers). Windows 9x VMware mouse driver is not supported.

8.4. Joystick Calibration Hotkeys

Most DOS games that offer analog joystick control include some form of calibration. However, some games have poor or limited calibration resulting in the joystick's position drifting or being offset, despite calibration attempts.

To compensate for these rare cases, DOSBox Staging lets you adjust the joystick's X and Y position parameters in real time by enabling the use_joy_calibration_hotkeys setting in [joystick] conf section.

Once activated, you can tap Ctrl + Arrow-keys or Alt + Arrow-keys to adjust either the joystick's scalar multiplier or absolute offset position, respectively. These let you "counterbalance" calibration issues in real time.

Each tap of the hotkeys will log the calibration values for the given axis. For example:

x_calibration = 0.576211,0.02
y_calibration = 0.5474,-0.005

Once you've found the optimal settings for a game, the logged calibration values can be placed in the game's local conf file (so the setting are only active for the affected game). Using the above as an example:

[joystick]
use_joy_calibration_hotkeys = false
joy_x_calibration           = 0.576211,0.02
joy_y_calibration           = 0.5474,-0.005

Note that you can disable the calibration hotkeys once you've found settings that work for a problematic game.

Here's a video showing how the calibration hotkeys "pull" the joystick in various directions:

9. General Improvements

9.1. Command-line Setting of Conf Options

Some people may want to temporarily run DOSBox Staging with specified config option(s), and in this new version you can do this with the new -set command-line option when launching DOSBox Staging, instead of having to modify the configuration file before you start DOSBox Staging.

For example, the user can temporarily run DOSBox Staging with the EMS memory disabled with the command line dosbox -set ems=false, overriding the setting in the configuration file.

The -set option can be specified multiple times for different config options, similar to the -c option which can be used multiple times to run multiple commands after DOSBox Staging starts.

9.2. Windows Installer for Windows Users

Previously DOSBox Staging was only available as portable zip packages for Windows users, but this has changed in this new version - as a Windows user you can now install DOSBox Staging more easily with the installer, which is especially recommended for new and first-time users. When the installer is used the installation process will be automated while allowing you to change certain things like the installation folder, and you will be able to launch DOSBox Staging as soon as the installation ends. Shell context menus can also be automatically added for a faster launch of DOSBox Staging from Windows Explorer.

Welcome pageIcons after installation
Windows installer welome pageIcons after installation

9.3. Configurable Modem Connect Speeds

The soft-modem's reported connect speed can be customised using the serial port's baudrate: setting. for example:

serial1 = modem baudrate:2400

Although this doesn't change the underlying baud rate, it can help satisfy old modem software if it's unable to handle (or parse) the larger connect values.

9.4. Handling Options for Memory Faults in Buggy Games

Extremely rare programming bugs :smirk: in some DOS games (and programs) may cause them to accidentally write data beyond their allocated memory region, similar to "painting outside the lines". DOSBox is great at catching these instances: it flags the corruption and quits, preventing the program from barreling on and possibly doing more harm such as writing corrupt save games, documents, and so on.

DOSBox Staging defaults to this same behaviour, but adds the [dosbox] mcb_fault_strategy conf setting:

mcb_fault_strategyBehaviourHow it affects the buggy game
denyReport and quit as soon as a fault is detected (default)Game terminates, no risk of subsequent file corruption
repairReport and repair up to 100 sequential faultsGame continues, but may still be unstable if its developers expected the corruption
reportReport the corruption and carry onGame continues, but risks further instability and file corruption
allowCarry on without reportingGame continues, but risks further instability and file corruption

Only consider this if your game is prone to crashing with MCB chain corruption errors reported in the console log.

10.1. Self-Documenting Bit Twiddling with bit_view

We've implemented a bit_view C++ class using constant expressions to access a subset of a data-field's bits, allowing them to be read, written, assigned, flipped, cleared, and tested, without the need to for the usual twiddling operations.

Constructing a bit_view is similar to a C bitfield, however unlike C bitfields, bit_views are free from undefined behaviour and have been proven using GCC's and Clang's undefined behaviour sanitisers.

There's more detail and some code examples here.

10.2. Memory Block and Type Size Simplification

DOS's emulated main memory (up to 64 MiB) and the video card's memory (to up 8 MiB) are both now allocated statically to reduce pressure on heap storage Ref: PR1714.

More progress has been made in reducing the use of large variables type-sizes down to purpose-fit sizes per the DOS/hardware specification (typically 8 or 16-bit) Ref: PR1721.

10.3. Tracy Profiler Integration

The Tracy event profiler has been integrated into the build system and basic hooks are in place to log frames and tics. These are only active (and not compiled in) unless Tracy is enabled.

Here's what it looks like:

tracy

Tracy runtime-profiling DOSBox Staging

It can be enabled at build-time with -Dtracy=true. Learn more about it, and how to build the server-side component here: Ref: PR1749.

10.4. Continuous Integration MSYS2 Workflow Improvements

The MSYS2-based workflow has been brought in line with current best practices, which dramatically improved its build time and lead to us now using it to generate the default Windows release binaries.

10.5. Release-package Shell Script

Release packages are now generated using a cross-platform POSIX-compliant shell script. With this logic moved into a script, developers can now easily test the creation of a release package locally, which was previously impossible as that logic only lived in a GitHub-syntax YAML.

10.6. Static Analysis

The team continues to fix and address static analysis issues as flagged by various analysers. Here are our Coverity Scan metrics to-date:

Coverity metrics)

Coverity graph)

11. Translation Status

The 0.79.0 configuration file is also in UTF-8 format for the German, Italian, and Polish languages under the package's "resources/translated-0.79-conf-files" directory.

The messaging system now supports self-documenting markup syntax, which is much easier to read and maintain compared to the previous ANSI escape sequences.

Old escape-code styleNew markup style
Escribiendo ^[[34;1mdir^[[0m all� mostrar� su contenido.Digita [color=blue]dir[reset] per visualizzarne il contenuto.

12. Notable Fixes

13. Special Thanks

14. Contributors

0.79 Maintainers

0.79 Authors

0.79 Translators

0.79 Sponsors

0.79 Backers

Thank you to our financial contributors who allow us to purchase hardware, licenses, and other non-trivial expenses to keep the team and project going.

To support our work, donate to our GitHub Sponsors or Open Collective.

15. Thank You

We are extremely grateful for all contributions, including the invaluable improvements merged in from the DOSBox project.

Creative Commons License Creative Commons License Creative Commons License
Content on this site is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
DOSBox Staging is licensed under a GNU GPL version 2 or later.