Descent 3 by Outrage Entertainment
Go to file
Ryan C. Gordon 65b1a7dc3b
sdl2: Fix broken audio in MVE playback.
This doesn't fix the audio gaps, just the static introduced in the SDL2 port.

SDL2 does not initialize the audio callback's buffer, unlike SDL 1.2, under
the assumption the callback is going to fully write it anyhow. But since
the movie player wants to mix against the current contents of the buffer,
we need to explicitly initialize it to silence first.
2024-05-05 10:14:50 -04:00
.github Make sure Mac and Linux builds have SDL2 available. 2024-05-02 08:30:46 -04:00
2dlib misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
acmlib Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
AudioEncode Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
bitmap Move debug functions to own module 2024-04-30 00:58:34 +03:00
cfile Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
cmake Introducing git revision in source code 2024-04-28 22:05:26 +03:00
czip Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
d3music Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
dd_grwin32 misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
dd_lnxsound Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
dd_sndlib misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
dd_vidwin32 Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
ddebug [Build] Fixed Windows debug build when ENABLE_LOGGER is active. 2024-05-01 14:26:33 +02:00
ddio_common Remove MacOS (Classic) code and all references (1/3) 2024-04-27 07:38:14 -07:00
ddio_lnx Some more SDL1.2 -> SDL2 work. Mouse input doesn't suck now! 2024-05-02 08:29:23 -04:00
ddio_win misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
ddvid_lnx Fix -Wcomment 2024-04-21 20:24:31 +02:00
Descent3 Quit immediately if we get an SDL_QUIT event. 2024-05-02 08:29:23 -04:00
fix Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
grtext misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
legacy More X11 removal. 2024-04-30 13:04:15 -04:00
lib Use SDL_assert on Linux/Mac. 2024-05-02 08:29:23 -04:00
libacm Remove comment about decoding ACMs as stereo in libacm/adecode.cpp 2024-04-28 15:01:02 +02:00
libmve sdl2: Fix broken audio in MVE playback. 2024-05-05 10:14:50 -04:00
linux Initial migration from SDL 1.2 to SDL2. 2024-05-02 08:29:21 -04:00
lnxcontroller Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
lnxmvelib Initial migration from SDL 1.2 to SDL2. 2024-05-02 08:29:21 -04:00
manage misc: pstring: Refactor dependents. 2024-04-29 10:01:33 +02:00
md5 Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
mem Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
misc Unittests for misc 2024-05-01 02:46:20 +03:00
model Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
module Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
movie Some more CMake white space formatting 2024-04-21 11:46:32 +02:00
music Add BUILD_INTERFACE to cfile module 2024-04-24 00:41:02 +03:00
netcon Initial migration from SDL 1.2 to SDL2. 2024-05-02 08:29:21 -04:00
netgames Add virtual default destructors on a few abstract classes. 2024-04-29 15:28:30 +00:00
networking Initial migration from SDL 1.2 to SDL2. 2024-05-02 08:29:21 -04:00
physics Fix controls on aarch64 2024-04-26 17:07:24 -04:00
renderer Some more SDL1.2 -> SDL2 work. Mouse input doesn't suck now! 2024-05-02 08:29:23 -04:00
rtperformance Remove MacOS (Classic) code and all references (1/3) 2024-04-27 07:38:14 -07:00
scripts Replace sprintf with snprintf in the merc missions. 2024-05-01 17:26:57 -06:00
sndlib Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
stream_audio Remove MacOS (Classic) code and all references (1/3) 2024-04-27 07:38:14 -07:00
tests Enable unittests on CI 2024-04-26 10:19:41 +03:00
tools Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
ui Heavy patching for compiler warnings. 2024-04-29 00:18:56 -04:00
unzip unzip: Link against real zlib. 2024-04-24 08:22:13 +02:00
vecmat Remove MacOS (Classic) code and all references (1/3) 2024-04-27 07:38:14 -07:00
win32 Move debug functions to own module 2024-04-30 00:58:34 +03:00
.clang-format Additional clang-format 2024-04-17 00:25:04 +03:00
.clang-format-ignore Import source of libacm 1.3, integrate it into CMake build 2024-04-21 18:25:45 +02:00
.gitignore Introducing git revision in source code 2024-04-28 22:05:26 +03:00
Brewfile Make sure Mac and Linux builds have SDL2 available. 2024-05-02 08:30:46 -04:00
CMakeLists.txt Make sure Mac and Linux builds have SDL2 available. 2024-05-02 08:30:46 -04:00
CMakePresets.json Enable unittests on CI 2024-04-26 10:19:41 +03:00
gpl.sh Updated source to reflect the license that this code is released under. 2024-04-20 09:57:49 -06:00
gplheader Updated source to reflect the license that this code is released under. 2024-04-20 09:57:49 -06:00
LICENSE Updated source to reflect the license that this code is released under. 2024-04-20 09:57:49 -06:00
README.md Fix variable name in Linux build instructions 2024-05-02 07:56:21 -04:00
vcpkg.json Introduce spdlog logging system 2024-04-30 14:27:38 -04:00

d3 (1)

This is the Descent 3 open source engine, licensed under GPL-3.0. It includes the '1.5' patch written by Kevin Bentley and Jeff Slutter several years ago and brought to a stable condition by the Descent community.

In order to use this, you must provide your own game files. See the Usage section for details.

Version 1.5 Notes

There is no "release" yet. The current milestone is "1.5 Stable", which is meant to more or less be Descent 3 as it might have been if the 1.5 patch had made it to retail years ago. Artifacts can be downloaded from the Actions tab. The milestone needs testing on all platforms. Please report issues when found.

Usage

Purchase Descent 3 from a reputable source and install it, then replace the main binary with the newly built Descent3 binary under ${CMAKE_BINARY_DIR}/Descent3/*/Descent3[.exe]. See your platform below:

Windows

In the install folder, rename main.exe to main.old and take your built Descent3.exe, name it main.exe, and add it to the install folder.

MacOS

Right-click Descent3.app, click Show Package Contents. Back up your Descent3 binary and drop your built Descent3 binary into the install (Contents/MacOS) folder.

Linux

Back up your Descent3 binary and drop your built Descent3 binary into the install folder.

Building

Build steps below assume you have already cloned the repository and entered it locally.

Building - Windows

Requires Visual Studio 2022 and C++ Tools (cmake and vcpkg)

Install and configure vcpkg:

git clone https://github.com/microsoft/vcpkg.git
cd vcpkg && bootstrap-vcpkg.bat
setx VCPKG_ROOT="C:\path\to\vcpkg"
setx PATH=%VCPKG_ROOT%;%PATH%

Build Descent 3:

cmake --preset win -D ENABLE_LOGGER=[ON|OFF]
cmake --build --preset win --config [Debug|Release]

Building - MacOS

brew bundle install
cmake --preset mac -D ENABLE_LOGGER=[ON|OFF]
cmake --build --preset mac --config [Debug|Release]

Building - Linux (Ubuntu)

sudo apt update
sudo apt install -y --no-install-recommends ninja-build cmake g++ libsdl1.2-dev libsdl-image1.2-dev libncurses-dev zlib1g-dev libspdlog-dev
cmake --preset linux -D ENABLE_LOGGER=[ON|OFF]
cmake --build --preset linux --config [Debug|Release]

Building - Linux (Fedora)

sudo dnf update --refresh
sudo dnf install -y ninja-build cmake gcc-c++ SDL-devel SDL_image-devel ncurses-devel zlib-devel spdlog-devel
cmake --preset linux -D ENABLE_LOGGER=[ON|OFF]
cmake --build --preset linux --config [Debug|Release]

Contributing

Anyone can contribute! We have an active Discord presence at Descent Developer Network. If you are interested in maintaining the project on a regular basis, please contact Kevin Bentley.