The continuing development of the legendary VBA gameboy advance emulator.
Go to file
Fabrice de Gans c4d46a713f [options] Refactor INI options
This change introduces a new class to handle all of the INI options
data, VbamOption. A VbamOption represents a single option in the INI
file. It is not constructible outside of its implementation, which
prevents the initialization of incorrectly formatted options.

Internally, a VbamOption points to a global variable in memory, which
holds the value used at runtime. This is because various parts of the
codebase edit the global variable rather than going through a central
registry. This also means we need to separately update the INI values.

In the future, we may be able to convert all existing reads and writes
to the global variable to go through VbamOption. Individual UX elements
could link directly to getters/setters for a specific VbamOption rather
than have duplicate data.

VbamOption replaces the opt_desc struct and the global opts array. All
users of opt_desc and the global opts array have been updated.

This is a necessary preliminary change to better support a refactor of
accelerators, through wxUserInput.

Issue: #745, #158
2022-09-25 05:47:34 +00:00
.github Add before creating request to feature.yml 2022-06-05 02:10:54 -04:00
.tx Updated Translations, finally added transifex support to pull in new translations 2018-07-31 06:54:10 -04:00
cmake Fix Wx OpenGL and ABI checks for MSYS2 CLANG64. 2022-02-05 01:00:25 +00:00
data [Windows] Enable winsparkle update checker. 2019-11-09 22:47:34 +00:00
dependencies@a39ddbb983 Use vcpkg installed wxrc, support mingw triplet. 2020-08-14 13:16:37 +00:00
doc Fix some lintian warnings. Patch by sergio-br2. 2015-05-29 22:11:38 +00:00
fex cmake: Silence cmake policy warning CMP0058. 2019-10-05 18:33:44 -07:00
po [options] Refactor INI options 2022-09-25 05:47:34 +00:00
src [options] Refactor INI options 2022-09-25 05:47:34 +00:00
third_party/include build: fix tests build on Linux by doctest update 2022-08-09 14:18:40 +00:00
tools builder: update automake 1.15.1 -> 1.16.5 2022-03-18 18:57:58 +00:00
.appveyor.yml Add Catch2 unit testing framework + some tests. 2020-07-10 13:43:48 +00:00
.gitignore Update .gitignore. 2020-08-28 04:57:35 +00:00
.gitlab-ci.yml Add ios-arm64/tvos-arm64 2021-03-14 11:50:23 +01:00
.gitmodules Make win32 dependencies submodule point to master. 2020-02-08 21:46:22 +00:00
.travis.yml Switch to C++17 for GUI. 2020-09-28 12:09:54 +00:00
CHANGELOG.md release v2.1.4 2019-10-02 14:17:30 +00:00
CMakeLists.txt build: check that -mtune=znver3 is supported 2022-08-26 17:12:09 +00:00
CMakeSettings.json cmake: Visual Studio support improvements. 2019-12-10 11:13:58 +00:00
DEVELOPER-MANUAL.md Regenerate dev guide TOC. 2021-11-10 23:08:25 +00:00
README.md change invite code 2022-09-02 17:57:38 -04:00
default.nix Update builder for mac build. 2021-10-30 22:24:40 -07:00
installdeps installdeps: remove wxgtk2 for Arch on failure 2022-09-03 09:34:05 +00:00
snapcraft.yaml [snap] Fix snapcraft build for core20 2022-09-03 19:01:17 -04:00
todo.md msys2 build improvements 2016-11-14 10:56:50 -08:00

README.md

Join the chat at https://gitter.im/visualboyadvance-m/Lobby

Our bridged Discord server is Here.

We are also on #vba-m on Libera IRC which has a Web Chat.

Get it from the Snap Store

Visual Boy Advance - M

Game Boy and Game Boy Advance Emulator

The forums are here.

Windows and Mac builds are in the releases tab.

Nightly builds for Windows and macOS are at https://nightly.vba-m.com/.

PLESE TEST THE NIGHTLY OR MASTER WITH A FACTORY RESET BEFORE REPORTING ISSUES

Your distribution may have packages available as well, search for visualboyadvance-m or vbam.

It is also generally very easy to build from source, see below.

If you are using the windows binary release and you need localization, unzip the translations.zip to the same directory as the executable.

If you are having issues, try resetting the config file first, go to Help -> Factory Reset.

Building

The basic formula to build vba-m is:

cd ~ && mkdir src && cd src
git clone https://github.com/visualboyadvance-m/visualboyadvance-m.git
cd visualboyadvance-m
./installdeps

# ./installdeps will give you build instructions, which will be similar to:

mkdir build && cd build
cmake .. -G Ninja
ninja

./installdeps is supported on MSys2, Linux (Debian/Ubuntu, Fedora, Arch, Solus, OpenSUSE, Gentoo and RHEL/CentOS) and Mac OS X (homebrew, macports or fink.)

Building a Libretro core

Clone this repo and then,

cd src/libretro
make -j`nproc`

Copy vbam_libretro.so to your RetroArch cores directory.

Visual Studio Support

For visual studio, dependency management is handled automatically with vcpkg, From the Visual Studio GUI, just clone the repository with git and build with the cmake configurations provided.

If the GUI does not detect cmake, go to File -> Open -> CMake and open the CMakeLists.txt.

If you are using 2017, make sure you have all the latest updates, some issues with cmake projects in the GUI have been fixed.

You can also build from the developer command prompt or powershell with the environment loaded.

Using your own user-wide installation of vcpkg is supported, just make sure the environment variable VCPKG_ROOT is set.

To build in the visual studio command prompt, use something like this:

mkdir build
cd build
cmake .. -DVCPKG_TARGET_TRIPLET=x64-windows-static -DCMAKE_BUILD_TYPE=Debug -G Ninja
ninja

Dependencies

If your OS is not supported, you will need the following:

And the following development libraries:

  • zlib (required)
  • mesa (if using X11 or any OpenGL otherwise)
  • ffmpeg (optional, at least version 4.0.4, for game recording)
  • gettext and gettext-tools (optional, with ENABLE_NLS)
  • SDL2 (required)
  • SFML (optional, for link)
  • OpenAL or openal-soft (optional, a sound interface)
  • wxWidgets (required for GUI, 2.8 and non-stl builds are no longer supported)

On Linux and similar, you also need the version of GTK your wxWidgets is linked to (usually 2 or 3) and the xorg development libraries.

Support for more OSes/distributions for ./installdeps is planned.

Cross compiling for 32 bit on a 64 bit host

./installdeps m32 will set things up to build a 32 bit binary.

This is supported on Fedora, Arch, Solus and MSYS2.

Cross Compiling for Win32

./installdeps takes one optional parameter for cross-compiling target, which may be win32 which is an alias for mingw-w64-i686 to target 32 bit Windows, or mingw-gw64-x86_64 for 64 bit Windows targets.

The target is implicit on MSys2 depending on which MINGW shell you started (the value of $MSYSTEM.)

On Debian/Ubuntu this uses the MXE apt repository and works quite well.

On Fedora it can build using the Fedora MinGW packages, albeit with wx 2.8, no OpenGL support, and no Link support for lack of SFML.

On Arch it currently doesn't work at all because the AUR stuff is completely broken, I will at some point redo the arch stuff to use MXE as well.

CMake Options

The CMake code tries to guess reasonable defaults for options, but you can override them, for example:

cmake .. -DENABLE_LINK=NO -G Ninja

Of particular interest is making Release or Debug builds, the default mode is Release, to make a Debug build use something like:

cmake .. -DCMAKE_BUILD_TYPE=Debug -G Ninja

Here is the complete list:

CMake Option What it Does Defaults
ENABLE_SDL Build the SDL port OFF
ENABLE_WX Build the wxWidgets port ON
ENABLE_DEBUGGER Enable the debugger ON
ENABLE_NLS Enable translations ON
ENABLE_ASM_CORE Enable x86 ASM CPU cores (BUGGY AND DANGEROUS) OFF
ENABLE_ASM Enable the following two ASM options ON for 32 bit builds
ENABLE_ASM_SCALERS Enable x86 ASM graphic filters ON for 32 bit builds
ENABLE_MMX Enable MMX ON for 32 bit builds
ENABLE_LINK Enable GBA linking functionality (requires SFML) AUTO
ENABLE_LIRC Enable LIRC support OFF
ENABLE_FFMPEG Enable ffmpeg A/V recording AUTO
ENABLE_ONLINEUPDATES Enable online update checks ON
ENABLE_LTO Compile with Link Time Optimization (gcc and clang only) ON for release build
ENABLE_GBA_LOGGING Enable extended GBA logging ON
ENABLE_DIRECT3D Direct3D rendering for wxWidgets (Windows, NOT IMPLEMENTED!!!) ON
ENABLE_XAUDIO2 Enable xaudio2 sound output for wxWidgets (Windows only) ON
ENABLE_OPENAL Enable OpenAL for the wxWidgets port AUTO
ENABLE_SSP Enable gcc stack protector support (gcc only) OFF
ENABLE_ASAN Enable libasan sanitizers (by default address, only in debug mode) OFF
UPSTREAM_RELEASE Do some release tasks, like codesigning, making zip and gpg sigs. OFF
BUILD_TESTING Build the tests and enable ctest support. ON
VBAM_STATIC Try link all libs statically (the following are set to ON if ON) OFF
SDL2_STATIC Try to link static SDL2 libraries OFF
SFML_STATIC_LIBRARIES Try to link static SFML libraries OFF
FFMPEG_STATIC Try to link static ffmpeg libraries OFF
SSP_STATIC Try to link static gcc stack protector library (gcc only) OFF except Win32
OPENAL_STATIC Try to link static OpenAL libraries OFF
SSP_STATIC Link gcc stack protecter libssp statically (gcc, with ENABLE_SSP) OFF
TRANSLATIONS_ONLY Build only the translations.zip and nothing else OFF

Note for distro packagers, we use the CMake module GNUInstallDirs to configure installation directories.

On Unix to use a different version of wxWidgets, set wxWidgets_CONFIG_EXECUTABLE to the path to the wx-config script you want to use.

MSys2 Notes

To run the resulting binary, you can simply type:

./visualboyadvance-m

in the shell where you built it.

If you built with -DCMAKE_BUILD_TYPE=Debug, you will get a console app and will see debug messages, even in mintty.

If you want to start the binary from e.g. a shortcut or Explorer, you will need to put c:\msys64\mingw32\bin for 32 bit builds and c:\msys64\mingw64\bin for 64 bit builds in your PATH (to edit system PATH, go to Control Panel -> System -> Advanced system settings -> Environment Variables.)

If you want to package the binary, you will need to include the MinGW DLLs it depends on, they can install to the same directory as the binary.

Our own builds are static.

Debug Messages

We have an override for wxLogDebug() to make it work even in non-debug builds of wx and on windows, even in mintty.

It works like printf(), e.g.:

int foo = 42;
wxLogDebug(wxT("the value of foo = %d"), foo);

From the core etc. the usual:

fprintf(stderr, "...", ...);

will work fine.

You need a debug build for this to work or to even have a console on Windows. Pass -DCMAKE_BUILD_TYPE=Debug to cmake.

Reporting Crash Bugs

If the emulator crashes and you wish to report the bug, a backtrace made with debug symbols would be immensely helpful.

To generate one (on Linux and MSYS2) first build in debug mode by invoking cmake as:

cmake .. -DCMAKE_BUILD_TYPE=Debug

After you've reproduced the crash, you need the core dump file, you may need to do something such as:

ulimit -c unlimited

in your shell to enable coredump files.

This post explains how to retrieve core dump on Fedora Linux (and possibly other distributions.)

Once you have the core dump file, open it with gdb, for example:

gdb -c core ./visualboyadvance-m

In the gdb shell, to print the backtrace, type:

bt

This may be a bit of a hassle, but it helps us out immensely.

Contributing

See the Developer Manual.