mandude / drnsf

Up-and-coming level editor for the Crash Bandicoot video game trilogy

DRNSF

Copyright (C) 2017-2020 DRNSF contributors

DRNSF is an unofficial level editor for the original Crash Bandicoot video game trilogy.

Pre-Release Details

This is a prerelease version of DRNSF.

This software is not "release-ready" so-to-speak, but is being made available so that it can be read, observed, critiqued, contributed to, etc.

Author

See the AUTHORS.md file for a list of contributors.

License

DRNSF is made available to you under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

DRNSF is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See LICENSE.txt for more details.

If you have received DRNSF in source code form, then it includes some additional software which is available under other GPL-compatible licenses.

• GLM: see glm/manual.md section 0.
• Dear ImGui: see imgui/LICENSE.txt.
• Google Test: see googletest/LICENSE.

If you are building the source code on Windows and choose to enable the automatic dependency system (see docs/automatic_deps.md), additional software will be automatically downloaded and utilized on your behalf. Some of this software is available under other GPL-compatible licenses:

• zlib: see extra/autodep_licenses/zlib.txt
• libpng: see extra/autodep_licenses/libpng.txt
• Pixman: see extra/autodep_licenses/pixman.txt
• Cairo: see extra/autodep_licenses/cairo.txt
• libepoxy: see extra/autodep_licenses/libepoxy.txt
• PkgConfig: see extra/autodep_licenses/pkg-config-with-glib.txt

DRNSF includes three system information files which are used to build PlayStation-compatible game disc images. These three files may be subject to copyright not covered by the GNU General Public License.

Building

You will need the following dependencies to build DRNSF:

• CMake >= 3.12
• PkgConfig
• Python 3
• libepoxy (recommended >= 1.3.1)
• Cairo (recommended >= 1.14.12)
• C++17 compiler and toolset; specifically supported are:
  • GCC >= 7.4.0
  • Visual Studio 2017 (requires "Desktop development with C++")

If you are using Ubuntu 18.10 or Debian Buster, you can install these dependencies with:

$ sudo apt install build-essential git cmake pkg-config libx11-dev libgl1-mesa-dev libepoxy-dev libcairo2-dev

Depending on your selected frontend and features, you may need more dependencies. See docs/build_options.md for more details.

Building is done using cmake. This should be done out-of-tree. The build/ directory is reserved in .gitignore for this purpose so it will not be included in git commits.

Retrieving and building drnsf can be done like so:

/$ git clone https://github.com/cbhacks/drnsf
/$ cd drnsf
/drnsf$ mkdir build
/drnsf$ cd build
/drnsf/build$ cmake ..
/drnsf/build$ make
/drnsf/build$ make test #if desired

Installing

At this time, DRNSF is not intended to be installed to any system directories.