From c33d64db57f3dd66d012c7d0dd27883beb1f2155 Mon Sep 17 00:00:00 2001 From: Kenneth Russel Date: Thu, 9 Jun 2005 15:18:44 +0000 Subject: Added documentation about -Dsun.java2d.noddraw=true git-svn-id: file:///usr/local/projects/SUN/JOGL/git-svn/svn-server-sync/jogl/trunk@298 232f8b59-042b-4e1e-8c03-345bb8c30851 --- doc/userguide/index.html | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) (limited to 'doc/userguide') diff --git a/doc/userguide/index.html b/doc/userguide/index.html index f25c72d16..1ef37540b 100644 --- a/doc/userguide/index.html +++ b/doc/userguide/index.html @@ -526,7 +526,27 @@ The following issues, among others, are outstanding on all platforms:

-No outstanding issues at this time. +For correct operation, it is necessary to specify the system property +-Dsun.java2d.noddraw=true when running JOGL applications +on Windows; this system property disables the use of DirectDraw by +Java2D. There are driver-level incompatibilities between DirectDraw +and OpenGL which manifest themselves as application crashes, poor +performance, bad flickering, and other artifacts. This poor behavior +may exhibit itself when OpenGL and DirectDraw are simply used in the +same application, not even just in the same window, so disabling +Java2D's DirectDraw pipeline and forcing it to use its GDI pipeline is +the only way to work around these issues. Java Web Start applications +may set this system property by adding the following line to the +<resources> section of the JNLP file: 

+<property name="sun.java2d.noddraw" value="true"/>
+ +

+

+ +JOGL currently does not interoperate well with the OpenGL pipeline for +Java2D available in JDK 5.0 and later. We will address this in a +future JOGL release and plan to have better interoperability by the +time JDK 6.0 is shipped.

-- cgit v1.2.3