Backends

From OHRRPGCE-Wiki
Jump to: navigation, search

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
gfx_sdl stable Simple DirectMedia Layer (SDL) graphics. This is the default backend Yes Yes
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
gfx_directx stable Windows-only Directx background. This backend exists as gfx_directx.dll - all builds therefore normally include support for it. Yes Yes (texture scaling)
gfx_alleg working, but very little testing Allegro backend. Yes No

[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:stable
Linux:experimental
Audiere and Native windows midi. On Linux, this backend uses timidity for MIDI. Windows:Yes
Linux:No
music_sdl stable SDL backend. This is the default on both Windows and Linux (May have problems on Windows Vista. More testing desired) No
music_allegro obsolete Allegro backend. Unmaintained; no longer works or even compiles. Only worked together with gfx_alleg No
music_native2 experimental, seems to be working (Windows-only) music_native variant with alternative, "better", 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 for out-of-bounds array access and null pointer dereferencing. 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.

[edit] See Also

Personal tools