Skip to content

Commit

Permalink
COMPATIBILITY.md: added notes about several apps.
Browse files Browse the repository at this point in the history
Fixes #197.
  • Loading branch information
icculus committed Sep 1, 2022
1 parent e8ef34f commit 6282982
Showing 1 changed file with 46 additions and 1 deletion.
47 changes: 46 additions & 1 deletion COMPATIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ https://docs.google.com/spreadsheets/d/1u8Rq3LVQYYgu28sBuxrZ371QolbiZu5z_LjENc4d
## Dynamite Jack (Linux)

More modern builds are ported to SDL2, but the older 1.2 binaries will work
on X11 if you turn off OpenGL Scaling
on X11 if you turn off OpenGL Scaling.

export SDL12COMPAT_OPENGL_SCALING=0

Expand Down Expand Up @@ -64,3 +64,48 @@ will cause. The app is perfectly usable in this configuration (and largely
matches how they expected you to use it with SDL 1.2 anyhow).


## Awesomenauts (Linux)

Awesomenauts requires X11 because it talks directly to glX, can't use our
scaling code because it uses framebuffer objects without going through
SDL_GL_GetProcAddress() to get entry points, and does something weird with
OpenGL contexts on multiple threads. sdl12-compat detects this and forces
on the correct hints to make this work, but it limits how one can use the
game.

This game will work in a Wayland environment, but only as an X11 app through
XWayland.


## Braid (Linux)

Braid requires X11 because it talks directly to glX, and can't use our
scaling code because it uses framebuffer objects without going through
SDL_GL_GetProcAddress() to get entry points. sdl12-compat detects this
and forces on the correct hints to make this work, but it limits how
one can use the game.

This game will work in a Wayland environment, but only as an X11 app through
XWayland.


## DOSBox (Linux)

DOSBox has some pretty strict requirements for keyboard input. We detect
some common names for DOSBox binaries ("dosbox", "dosbox_i686", etc), and
force the correct hints to make it work, but if you have an uncommon binary
name and keyboard input isn't working as you expect, try exporting this
environment variable:

export SDL12COMPAT_USE_KEYBOARD_LAYOUT=0


## Multiwinia (Linux)

Multiwinia calls SDL_Quit() when changing video modes but doesn't
reinitialize SDL before using it further. We detect this binary and force
the correct hints to make it work, but if you have an uncommon binary
name and the game isn't working, try this environment variable:

export SDL12COMPAT_NO_QUIT_VIDEO=1

0 comments on commit 6282982

Please sign in to comment.