256 Color Mode

From WineHQ Wiki
Revision as of 02:13, 13 November 2019 by Alex Henrie (talk | contribs) (→‎Workarounds: added instructions for how to work around Bug 48088)
Jump to: navigation, search

The X server can't switch from 24bpp* mode to 8bpp** mode. Nevertheless, Wine (in general) can run software that uses 8bpp graphics by internally converting bitmaps to formats compatible with the current X server mode (e.g. 24bpp). This is also true for 8bpp DirectDraw games such as Starcraft, C&C Red Alert and Total Annihilation. Such games will output a fixme message

fixme:x11drv:X11DRV_desktop_SetCurrentMode Cannot change screen BPP from 32 to 8

but for practical purposes it can be ignored. Although the general support for such conversion is there, there may be bugs affecting specific software, and performance is often not on par with native Windows installations. Search Bugzilla and the AppDB for known issues with individual applications.

  • "24bpp" = 24-bit color = 16 million colors = Truecolor
  • "8bpp" = 8-bit color = 256 colors = color index mode


If your application says that it needs 8bpp or 256 colors even though you have millions of colors available, you may be able to get it working with one of the workarounds below. Any of four major methods are suggested to provide 8bpp to applications. These include:

  • Xephyr (preferred)
  • Xnest
  • VNC
  • Xinit
  • Change Preferences (Mac OS X only)

IMPORTANT: For 256-color mode to work correctly, you must set HKEY_CURRENT_USER\Software\Wine\X11 Driver\ClientSideGraphics to N in the registry (see Useful Registry Keys and Bug 48088).

Stage 1: Creating a new X11 display

The instructions below allow you to create a new X11 display, with 256 colors, and with an xterm running within it. But:

  • Wherever :1 is written you may use :n instead, where n is an unused display number. The default display is usually :0.
  • If your shell doesn't accept the DISPLAY=:1 xterm syntax, you may need to use something like env DISPLAY=:1 xterm instead.
  • See also bug 7334.


Once you have installed Xephyr (Ubuntu: package xserver-xephyr, in universe), you should be able to run something like the following:

Xephyr :1 -ac -screen 800x600x8 &
DISPLAY=:1 xterm

This will create a 800x600 display, in a window, with 8-bit color, and display an xterm in it.


Once you have installed Xnest (Ubuntu: package xnest, in main), you should be able to run the following:

Xnest :1 -depth 8 &
DISPLAY=:1 xterm

This will create a display in a window, with 8-bit color, and display an xterm in it. Xnest depends on the parent X11 for various things; in some cases Xnest won't work (-depth 8 fails on many systems).


Once you have installed VNC (Ubuntu: packages vnc4server and xvnc4viewer, in universe), you should be able to run the following:

vnc4server :1 -cc 3 -depth 8 -geometry 640x480 -localhost}

Then issue the command:

xvnc4viewer :1

This will create a virtual 8bpp display (in this example, a 640x480 window containing the virtual screen). This is known as !PseudoColor mode in the VNC documentation.


Of course you can use just plain ol' X, but that will only work if your modern video card still supports palettized 8bpp displays.

cd "~/.wine/drive_c/Program Files/My game/"
xinit /usr/bin/wine "my game.exe" -- :1 -ac -depth 8

Or for something more sophisticated use xterm:

xinit /usr/bin/xterm -- :1 -ac -depth 8

You can switch between several running X servers and consoles by using the Ctrl+Alt+F1 ... Ctrl+Alt+F10 keyboard shortcuts. On Ubuntu, the initial X server is on tty7 (Ctrl+Alt+F7), and the new X server will be on tty9 (Ctrl+Alt+F9).

Note: You may get a "user not authorized to run the X server, aborting" error message (this happens on Debian and Ubuntu). To work around this, either run xinit as root (or with sudo), or change the "allowed_users=console" line in /etc/X11/Xwrapper.config to read "allowed_users=anybody". If you run xinit as root, a root shell will be running in the xterm, so you need to start another xterm as your normal user (switch back to your main X server, and run {{{DISPLAY=:1 xterm}}} in a non-root shell). Remember: Don't run Wine as root!

Change Preferences (Mac OS X only)

The X server that ships with MacOS X has a preferences setting for the color depth, simply set it where you want it and restart the X server. Done.

Stage 2: Using the new display

To run commands in the xterm on the new display, you need to move the mouse cursor over its window (without a window manager, X11 uses focus-follows-mouse). It is a good idea to run the following commands in the new xterm, as the variable $DISPLAY will be set correctly. You can run commands from another terminal, but be sure to prepend "{{{DISPLAY=:1 }}}" to them.

First, you need a window manager.

metacity &

You can of course use another window manager, but note that compositing WMs like compiz may not work. The default background is either an eye-watering mesh pattern or a solid black. You can change it to gray with:

xsetroot -solid gray50

Instead of gray50, you can use any X11 color name or a hex color value rgb:RR/GG/BB. You can start Wine in the new display with:

cd "$HOME/.wine/drive_c/Program Files/<etc>"
wine <program> <etc>

When you're finished, you can close the new display. This will kill all programs that were running in it. If you used Xinit, type exit in the xterm that appeared initially.