cvs rm -f documentation/status/directdraw
ChangeLog
Dimitrie O. Paun <dpaun@rogers.com>
Merge documentation/status/directdraw into the code.
Index: dlls/ddraw/ddraw/main.c
===================================================================
RCS file: /var/cvs/wine/dlls/ddraw/ddraw/main.c,v
retrieving revision 1.45
diff -u -r1.45 main.c
--- dlls/ddraw/ddraw/main.c 5 Sep 2003 23:08:40 -0000 1.45
+++ dlls/ddraw/ddraw/main.c 26 Sep 2003 19:03:26 -0000
@@ -17,9 +17,30 @@
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
- */
-
-/*
+ *
+ * NOTES
+ *
+ * WINE currently implements a very basic set of the DirectDraw functionality
+ * in graphics/ddraw.c. This implementation uses either the XFree86-DGA extension
+ * to get very fast access to the graphics card framebuffer and doublebuffering
+ * features or Xlib, which is slower.
+ * The implementation using XFree86-DGA is as fast as the MS equivalent for the
+ * stuff that is implemented.
+ *
+ * Several applications already work, see below.
+ * Problems of the implementation using XFree86-DGA:
+ *
+ * - XFree86 cannot switch depth on the fly.
+ * This is a problem with X and unavoidable.
+ * Current solution is to pop up a MessageBox with an error for
+ * mismatched parameters and advice the user to restart the X server
+ * with the specified depth.
+ * - The rest of the functionality that has to be implemented will have
+ * to be done in software and will be very slow.
+ * - This requires WINE to be run as root user so XF86DGA can mmap the
+ * framebuffer into the addressspace of the process.
+ * - Blocks all other X windowed applications.
+ *
* This file contains all the interface functions that are shared between
* all interfaces. Or better, it is a "common stub" library for the
* IDirectDraw* objects
--
Dimi.
