documentation/status/directdraw

   1 This file contains information on the current implementation of the DirectDraw
   2 API. Information specific to Direct3D is in the direct3D file.
   3
   4 The DirectDraw API is being used in a lot of current computergames. Its API
   5 layer is represented by the functions in the Win32 DLL ddraw.dll and the
   6 IDirectDraw* interfaces (that can be created using the API functions).
   7
   8 WINE currently implements a very basic set of the DirectDraw functionality
   9 in graphics/ddraw.c. This implementation uses the XFree86-DGA extension
  10 to get very fast access to the graphics card framebuffer and doublebuffering
  11 features. It is as fast as the MS equivalent for the stuff that is implemented.
  12 Several applications already work, see below.
  13 Problems of the implementation using XFree86-DGA:
  14
  15         - XFree86 cannot switch resolution nor depth on the fly.
  16           This is a problem with X and unavoidable.
  17           Current solution is to pop up a MessageBox with an error for
  18           mismatched parameters and advice the user to restart the X server
  19           with the specified depth and/or screensize.
  20         - The rest of the functionality that has to be implemented will have
  21           to be done in software and will be very slow.
  22         - This requires WINE to be run as root user so XF86DGA can mmap the
  23           framebuffer into the addressspace of the process.
  24         - Blocks all other X windowed applications.
  25
  26 Status:
  27    - Diablo [640x480x8]:
  28      The movies play with speed comparable to the MS DDRAW one.
  29      The game doesn't work, it somehow tries to write into 2 lines _BEFORE_
  30      the start of the surface. I have tried to investigate this, but it is
  31      in code that is automatically generated.
  32
  33    - WingCommander 4 / Win95 Patch [640x480x8]:
  34      The intromovie plays, in 8 bit mode (to reconfigure wc4, run wine
  35      "wc4w.exe -I"). The 16bit mode looks broken on Mystique, but I think
  36      this is due to the unusual colorweight (565 rgb) of the Mystique in 16bit
  37      mode. [Specifying it in DDPIXELFORMAT didn't help.]
  38
  39      Requires to be run in 640x480xdepth mode (doesn't seem to heed
  40      DDSURFACEDESC.lPitch).
  41      You can even fly the first mission with Maniac (ignore the weird sounds),
  42      but it crashes as soon as you arrive at Blue Point Station...
  43
  44    - Monkey Island 3 [640x480x8]:
  45      WINE-CVS-981116:
  46         Works, using DGA and Xlib. (Mousecontrol is a bit off in windowed mode.)
  47
  48    - DiscWorld 2 [640x480x8]:
  49      Plays through nearly all intro movies. Sound and animation skip a lot of
  50      stuff (possible DirectSound asynchronization problem).
  51
  52    - XvT [640x480x16]:
  53      Shows the splash screen, then fails with missing Joystick. I have
  54      investigated but failed to find a reason for this.
  55
  56    - Tomb Raider 2 Demo (using 8 bit renderer) [640x480x8]:
  57      I have played nearly all of the DEMO level using Keyboard Controls.
  58      Sound is a bit weird. Keyboard/Mouse handling too due to incomplete
  59      DirectInput.
  60
  61    - WingCommander Prophecy Demo (using software renderer) [640x480x16]:
  62      Plays trailer, hangs in selection screen (no keyboard input, DirectInput
  63      problem).