WineHQ

256 Color Mode

Revision as of 01:34, 30 March 2022 by Alex Henrie (talk | contribs) (replaced two references to xterm that I missed in my last edit)

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.

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.

Workarounds

There are at least three ways to provide 8bpp to applications. These include:

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


The instructions below allow you to create a new X11 display, with 256 colors, and with a Wine file explorer running within it. But bear in mind:

  • You must use a window manager, and the window manager must be one that supports color palettes (e.g. Openbox).
  • 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 wine explorer syntax, you may need to use something like env DISPLAY=:1 wine explorer instead.

Xephyr

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 openbox &
DISPLAY=:1 wine explorer

This will create a 800x600 display, in a window, with 8-bit color, and display a Wine file explorer in it.

In some cases, you may get better results by starting Xephyr with the parameter -cc 2 to use the default Xorg palette (StaticColor) instead of the default Windows palette (PseudoColor).

Xnest

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

Xnest :1 -depth 8 &
DISPLAY=:1 openbox &
DISPLAY=:1 wine explorer

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

xinit

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

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

Then in xterm:

openbox &
wine explorer

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.

Finishing Touches

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.

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.

If the colors in your Windows program still don't look right, you can try setting HKEY_CURRENT_USER\Software\Wine\X11 Driver\ClientSideGraphics to N in the registry (see Useful Registry Keys).


This page was last edited on 30 March 2022, at 01:34.