Revert some word-splits to their normal form, e.g. InstallShield.
[wine] / 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 either the XFree86-DGA extension 
10 to get very fast access to the graphics card framebuffer and doublebuffering
11 features or Xlib, which is slower.
12 The implementation using XFree86-DGA is as fast as the MS equivalent for the
13 stuff that is implemented.
14
15 Several applications already work, see below.
16 Problems of the implementation using XFree86-DGA:
17
18         - XFree86 cannot switch depth on the fly.
19           This is a problem with X and unavoidable.
20           Current solution is to pop up a MessageBox with an error for 
21           mismatched parameters and advice the user to restart the X server
22           with the specified depth.
23         - The rest of the functionality that has to be implemented will have
24           to be done in software and will be very slow.
25         - This requires WINE to be run as root user so XF86DGA can mmap the
26           framebuffer into the addressspace of the process.
27         - Blocks all other X windowed applications.
28
29 Status:
30    - Diablo [640x480x8]:
31      No longer works. Unclear why. [WINE-990131, Marcus Meissner]
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      Keyboard input does not work. This seems to be a problem with the 
40      cooperative window and USER input handling in general.
41
42      -> Unable to test Gameplay.
43
44      The display is slower as before. Reason is unknown, but I suspect the 
45      communication between winserver,dsoundmixerthread,mainthread takes
46      up too much time.
47
48      [WINE-990131, Marcus Meissner]
49
50    - Monkey Island 3 [640x480x8]:
51      WINE-CVS-981116:
52         Works, using DGA and Xlib. (Mousecontrol is a bit off in windowed mode.)
53    
54    - DiscWorld 2 [640x480x8]:
55      Plays through nearly all intro movies. Sound and animation skip a lot of
56      stuff (possible DirectSound asynchronization problem).
57    
58    - Tomb Raider 2 Demo (using 8 bit renderer) [640x480x8]:
59      I have played nearly all of the DEMO level using Keyboard Controls.
60      Sound is a bit weird. Keyboard/Mouse handling too due to incomplete
61      DirectInput.
62   
63    - WingCommander Prophecy Demo (using software renderer) [640x480x16]:
64      Plays trailer, hangs in selection screen (no keyboard input, DirectInput
65      problem).