[svn:parrot] r42223 - trunk/config/auto

japhb at svn.parrot.org japhb at svn.parrot.org
Mon Nov 2 17:21:55 UTC 2009


Author: japhb
Date: Mon Nov  2 17:21:46 2009
New Revision: 42223
URL: https://trac.parrot.org/parrot/changeset/42223

Log:
[OpenGL] Document Cygwin native v. X conflicts to resolve RT 56628

Modified:
   trunk/config/auto/opengl.pm

Modified: trunk/config/auto/opengl.pm
==============================================================================
--- trunk/config/auto/opengl.pm	Mon Nov  2 16:32:07 2009	(r42222)
+++ trunk/config/auto/opengl.pm	Mon Nov  2 17:21:46 2009	(r42223)
@@ -85,8 +85,13 @@
 
 =head2 Windows
 
-On Windows, Parrot supports three different compiler environments, each of
-which has different requirements for OpenGL support:
+On Windows, Parrot supports four different compiler environments, each of
+which has different requirements for OpenGL support.  Generally you should not
+attempt to mix the Cygwin variants (installing some X OpenGL libs and some
+w32api OpenGL libs) as this will almost certainly result in runtime errors
+like this one:
+
+    freeglut ERROR: Function <glutDisplayFunc> called without first calling 'glutInit'.
 
 
 =head3 MSVC
@@ -117,17 +122,17 @@
 
 This is tried first.
 
+
 =head3 Cygwin/w32api
 
-The Cygwin/w32api for native opengl support is only tried if
-F</usr/include/GL> does not exist.
+Requires the F<opengl> and F<w32api> packages.
 
-The problem is that the L<NCI|pdds/draft/pdd16_native_call.pod>
-tries the header files to create the imports and not the libraries,
-and if the F</usr/include/GL> headers are found these are used, despite
-the w32api GLUT libraries are defined.
+Cygwin/w32api for native opengl support is only tried if
+F</usr/include/GL> does not exist.  The problem is that the OpenGL header files
+are used to create the OpenGL function list, and not the libraries themselves.
+If the F</usr/include/GL> headers are found these are used, even if the w32api
+GLUT libraries are defined.
 
-F<opengl>, F<w32api>
 
 =cut
 


More information about the parrot-commits mailing list