FinalBurn Neo
Official Forum: https://neo-source.com
This is the official repository of FinalBurn Neo, an Emulator for Arcade Games & Select Consoles. It is based on the emulators FinalBurn and old versions of MAME
Use of this program and its source code is subject to the license conditions provided in the license.txt file in the src folder.
Work in Progress builds
If the below build status badge is green, you can download the latest builds from this repository. Please note that if the below build status badge is not green then the build will be out of date. As this build is of the last commit occasionally you might run into incomplete code, crashes or other issues that official releases will not have. Also note that the dates might be wrong against the downloads, but if the badge is green the downloads will be of the latest commit.
Here is the build status of the other versions for which we don't supply a binary directly. A red badge against a platform will indicate that something is wrong with that build. Currenty Raspberry Pi builds are missing from CI, but will one day be added:
Ports
Raspberry Pi build instructions.
macOS build instructions and releases.
LibRetro port with builds availble via RetroArch for most platforms.
For SDL1.2 builds just type make sdl (requires SDL1.2 and GCC, make, perl and nasm)
For SDL2 builds just type make sdl2 (requires SDL2, SDL2_image, gcc, make, perl and nasm)
Reporting Issues
Please raise an issue on the project GitHub or report on the forums at Neosource
What about FB Alpha?
Many of the developers of this project also worked on FB Alpha. Due to a controversy, we no longer do, and recommend that everyone use this emulator instead.
Contributing
We welcome pull requests and other submissions from anyone. We maintain a list of known bugs and features that would be nice to add on the issue tracker, some of which would be a good starting point for new contributors.
One of the focuses of FBNeo is ensuring that the codebase is compilable on older systems. This is for many reasons, not least because older hardware still has a use outside of landfill or being stored in a recycling center, but also it can be a lot of fun porting and running FBNeo to other platforms. Currently, this means we will always aim for C++03 compliance as a minimum. Any pull requests should keep this in mind!
Notes on Contributions
In the root of the source tree there is an .editorconfig that mandates:
- tabs for indentation
- tabs use 4 columns
Please see the following function for some ideas on how naming, brackets and braces should be
void FunctionName(UINT8 var1, UINT16 var2)
{
UINT64 result;
if (var1 * var2 >= 10) {
result = var1 * var2;
} else {
result = var1;
}
}
Source tree structure
The source for FBNeo is layed out in a similar way to how things were in the days of the original FinalBurn. It's just that there are now more directories and source files as the emulator has grown significantly.
src/
--/burn <-- This is where the emulation code lives
----/devices <-- This is where emulated devices (EEPROMS, etc) live
----/drv <-- This is where the drivers for Games and Systems live
----/snd <-- This is where the emulation for sound chips and other sound generating devices live
--/burner <-- This is where the frontend code lives
--/cpu <-- This is where the CPU emulation lives
--/dep <-- This is where external dependencies live (such as libpng)
--/intf <-- This is where the platform specific code for each platform that FBNeo supports live (e.g. Video and Sound output)
Porting FBNeo to different systems
In the main source tree, you will see in the intf directory various implementations for different platforms. You should look in here when porting to new platforms. We also encourage new ports, and are happy to have them merged in to the main sourcetree. There is probably a project there for someone to re-implement some of the older ports using the intf standard, should they want to.
For portability we define the following types
unsigned char UINT8;
signed char INT8;
unsigned short UINT16;
signed short INT16;
unsigned int UINT32;
signed int INT32;
signed int64 INT64;
unsigned int64 UINT64;
It is recommended that you take a look at the other #defines and things in the header files in Burn and Burner, and don't forget that some of the existing code in the intf directory will come in handy for new ports.