Improved documentation for single screen use with Xinerama
|Reported by:||SF/rrt||Owned by:||csnover|
FAQ 5.18 says:
5.18. ScummVM starts somewhere in the middle of my two Xinerama monitors in fullscreen mode. Help!
In fact, this is SDL problem. SDL does by default has xinerama support enabled. Set the SDL_VIDEO_FULLSCREEN_HEAD environment variable to "1" to start ScummVM (and other SDL applications) in fullscreen on only one monitor. If this does not work make sure your SDL library does have Xinerama support compiled in.
Here's a re-edited version that fixes the English and corrects the information about the environment variable:
This is an SDL problem: SDL has Xinerama support, and by default uses the entire Xinerama display. To use only one screen, set the SDL_VIDEO_FULLSCREEN_HEAD environment variable to the number of the screen on which you want to start ScummVM (and other SDL applications). If this does not work make sure your SDL library does have Xinerama support compiled in. Note that video mode changing only works on screen 0.
I got the information about SDL_VIDEO_FULLSCREEN_HEAD from the SDL release notes at https://www.libsdl.org/release/changes-1.2.html which say:
Xinerama multi-head displays are properly handled now, and the SDL_VIDEO_FULLSCREEN_HEAD environment variable can be used to select the screen used for fullscreen video modes. Note that changing the video modes only works on screen 0.
This contradicts the previous FAQ entry, which merely suggests setting SDL_VIDEO_FULLSCREEN_HEAD to 1, as if it was an on/off toggle.
Ticket imported from: bugs/7128.