Backends
From OHRRPGCE-Wiki
(Redirected from Backend)
The OHRRPGCE uses several different backends for graphics and music.
[edit] gfx
gfx backends provide the graphics and user-input. The OHRRPGCE can be compiled with any combination of graphics backends, and the one to use selected with a commandline switch. Run with commandline option "/?" (or "--help") for usage information. The default graphics backend is always the first named, for example, ohrrpgce-wip-gfx-music.zip.
| name | status | description | fullscreen | smoothing | platforms |
|---|---|---|---|---|---|
| gfx_sdl | stable | Simple DirectMedia Layer (SDL) graphics. This is the default backend on GNU/Linux and Macintosh | Yes | Yes | Linux, Mac, Windows |
| gfx_directx | stable | This backend exists as gfx_directx.dll - all Windows builds normally include support for it even if the .dll isn't included. This is the default backend on Windows | Yes | Yes (texture scaling) | Windows |
| gfx_fb | stable | Freebasic graphics. This backend is well-tested, but due to a few minor unsolveable problems is no longer the default | Windows:Yes Linux:Maybe |
Yes | Linux, Windows |
| gfx_alleg | working, but very little testing | Allegro backend. | Yes | No | (Mac?, Linux?), Windows |
| gfx_console | diagnostic | Curses-based backend (no graphics). For testing only; no builds available | NA | NA | All |
[edit] music
music backends provide the music and sound effects. The music backend is always the second named, for example, ohrrpgce-wip-gfx-music.zip
| name | status | description | advanced MIDI looping |
|---|---|---|---|
| music_native | Windows:mostly-stable (but buggy) Linux:No MIDI support |
Audiere and Native windows midi. MIDI playback is very buggy. Frequently does not work on Linux because it uses OSS | Windows:Yes Linux:No |
| music_sdl | stable (crashy on Windows) | SDL+SDL_mixer backend. This is the default on Windows, Linux and Mac. MIDI playback on Windows is buggy and sometimes crashes | No |
| music_allegro | obsolete | Allegro backend. Unmaintained; no longer works or even compiles. Only worked together with gfx_alleg | No |
| music_native2 | mostly-stable (but buggy) | (Windows-only) music_native variant with alternative, "better" (but still pretty buggy) MIDI implementation. Identical Audiere sound effects implementation | Controller 111 loop points only |
| music_silence | diagnostic | Does not play any music or sound at all. Useful for checking whether or not a bug is related to music. | No |
[edit] other builds
| name | status | description |
|---|---|---|
| -debug | diagnostic | Any nightly build with -debug in the filename has been compiled with -g which adds debugging symbols for use with the GNU Debugger |
| -exx | diagnostic | Any nightly build with -exx in the filename has been compiled with -exx which adds extra error checking (asserts) for out-of-bounds array access and null pointer dereferencing. Failed asserts cause the program to instantly exit. These builds are many times slower, something which might be noticeable on very old computers. |
| -scriptprofile | diagnostic | Any nightly build with -profile in the filename has been compiled with -d SCRIPTPROFILE to perform script profiling; when you exit a game, Game prints a whole lot of statistics to g_debug.txt about how much time each script took to run. |