Mailing-List: contact cygwin-announce-help AT sourceware DOT cygnus DOT com; run by ezmlm
Sender: cygwin-announce-owner AT sources DOT redhat DOT com
Message-Id: <4.3.2.7.0.20001003093941.00b638c8@courriel.polymtl.ca>
Date: Tue, 03 Oct 2000 16:08:19 -0400
To: cygwin-announce AT sources DOT redhat DOT com
From: Andre Bleau <andre DOT bleau AT courriel DOT polymtl DOT ca>
Subject: OpenGL 1.1.0-2 for Cygwin 1.1.4
Mime-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"; format=flowed
Content-Transfer-Encoding: 8bit


----------------------------------------------------------------------
PLEASE READ THIS MAIL CAREFULLY. IT CONTAINS IMPORTANT INFORMATION FOR
INSTALLING THE OPENGL PACKAGE. A COPY OF THE README FILE CAN BE FOUND AT 
THE END OF THIS MESSAGE.
----------------------------------------------------------------------

This is the new OpenGL package for Cygwin. It replaces OpenGL-1.2.1-1, 
which was older, despites the version number. Because of version number 
confusion, you must perform some steps prior to running setup, if you had 
OpenGL-1.2.1-1 installed previously.

1- In /etc/setup, edit installed.db to remove the line about opengl.
2- In /etc/setup, remove the file named opengl.lst.gz.
3- If you plan to use the "Download form Internet" option of setup, go to 
the latest subdirectory of your download directory and remove the opengl 
directory.
4- Proceed with setup as follow:

To update your installation, click on the "Install Cygwin now" link on
the http://sources.redhat.com/cygwin web page.  This downloads setup.exe
to your system.

Run setup and answer all of the questions.  PLEASE, PLEASE, PLEASE
choose a mirror site for your download.  The 'sources.redhat.com' site
is badly overloaded.  The mirrors below have the latest version of this
package:

ftp://ftp.sunsite.utk.edu/pub/cygwin/ (US)
ftp://gd.tuwien.ac.at/gnu/cygwin (Austria)
ftp://ftp.u-aizu.ac.jp/pub/gnu/gnu-win32/ (Japan)

Note that if this is the first time that you've run the new GUI version
of setup, it will currently download the whole cygwin net release again.
After this point it will only download and install what is needed.

If you have questions or comments, please send them to the Cygwin
mailing list at:  cygwin AT sources DOT redhat DOT com .  I would appreciate if you
would use this mailing list rather than emailing me directly. This
includes ideas and comments about the setup utility or Cygwin general.

If you want to make a point or ask a question the Cygwin mailing list is
the appropriate place.

------------------- READMEopengl-1.1.0-2.txt ----------------------------

GLUT, GLU and OpenGL header files; GLUI header file and library
---------------------------------------------------------------

André Bleau, andre DOT bleau AT courriel DOT polymtl DOT ca

Package opengl-1.1.0-2 updated 29/09/2000


*** WARNING ***
---------------

This package does _not_ contain a complete set of files for building Open 
GL -based programs. It contains only the missing pieces in the Cygwin 
environment to build programs calling functions from opengl32.dll and 
glu32.dll provided by Microsoft in Windows NT 4.0 and Windows 2000. I don't 
know about Windows 95/98.

There is also an include file and a DLL for GLUT-based for building 
programs and an include file and a static library for GLUI-based programs.


Installation
------------

If you have a /usr/include/GL directory containing .h files from another 
distribution, rename that directory /usr/include/oldGL . Otherwise, the .h 
files in /usr/include/GL will mask the ones in /usr/local/include from this 
package.


Compilation of code calling OpenGL, GLU, GLUT, GLUI
---------------------------------------------------

Add -I/usr/local/include to your compilation command.


Linking of code calling OpenGL, GLU, GLUT
-----------------------------------------

Add -lglut32 -lglu32 -lopengl32 to your link command.

libglui.a is a static library.


Linking of code calling OpenGL, GLU, GLUT and GLUI
--------------------------------------------------

Add -L/usr/local/lib -lglui -lglut32 -lglu32 -lopengl32 to your link command.

libglut32.a, libglu32.a and libopengl32.a interface with Windows NT/2000. I 
don't know about Windows 95/98. They are part of Cygwin 1.1.x.


Running of programs calling GLUT and/or GLUI
--------------------------------------------

Add /usr/local/bin to your PATH, or move the file /usr/local/bin/glut32.dll 
to some directory in your PATH. No X server is required.


Content of the tar ball
-----------------------

	READMEopengl-1.1.0-2.txt
This file.

         usr/local/include/GL/glut.h
For GLUT 3.7.
 From http://reality.sgi.com/mjk_asd/glut3/glut3.html; modified to add 
__attribute__ ((__stdcall__)) to the declaration of functions to enable 
linking with glut32.dll via usr/lib/libglut32.a . Jerome G. Benoit provided 
hints about how to do it and provided an example; thanks Jerome!

         usr/local/bin/glut32.dll
For GLUT 3.7.
 From http://reality.sgi.com/mjk_asd/glut3/glut3.html; not modified. Move 
to some directory in your path or add usr/local/bin to your path.

	usr/local/doc/glut-3.spec.pdf
For GLUT 3.7
 From http://reality.sgi.com/mjk_asd/glut3/glut3.html . Documentation for 
GLUT 3.7.

         usr/local/include/GL/glu.h
For GLU 1.2.2.
Modified version of usr/X11R6/include/GL/glu.h from 
ftp://sourceware.cygnus.com/pub/cygwin/xfree/xc-4-binaries/xfree86-4.0-devel.tar.bz2 

to add __attribute__ ((__stdcall__)) to the declaration of functions to 
enable linking with glu32.dll via usr/lib/libglu32.a .

         usr/local/include/GL/gl.h
For OpenGL 1.1.0.
Modified version of usr/X11R6/include/GL/gl.h from 
ftp://sourceware.cygnus.com/pub/cygwin/xfree/xc-4-binaries/xfree86-4.0-devel.tar.bz2 

to add __attribute__ ((__stdcall__)) to the declaration of functions to 
enable linking with opengl32.dll via usr/lib/libopengl32.a .

         usr/local/include/glui.h
For GLUI 2.0 beta.
 From http://www.cs.unc.edu/~rademach/glui/; not modified. Header file for 
the GLUI tool kit version 2.0 beta.

         usr/local/lib/libglui.a
For GLUI 2.0 beta.
A static library compiled from unmodified sources of the GLUI tool kit 
version 2.0 beta, found at http://www.cs.unc.edu/~rademach/glui/. 
Compilation with -O3 optimization. I highly recommend this very useful tool 
kit.

	usr/local/doc/glui_manual_v2_beta.pdf
For GLUI 2.0 beta.
 From http://www.cs.unc.edu/~rademach/glui/ . Documentation for GLUI 2.0 beta.

Modified sections of the .h files are bracketed by
#ifdef (__CYGWIN__)
#endif


What has changed since opengl-1.2.1-1
-------------------------------------

The previous package name erroneously suggested that it was for Open GL 
1.2.1 while it is in fact for the Open GL 1.1.0 DLL provided by Microsoft.

The declaration of glGetString in gl.h has been corrected to include the 
APIENTRY qualifier.

------------------- READMEopengl-1.1.0-2.txt ----------------------------

André Bleau, ing., analyste
bleau AT courriel DOT polymtl DOT ca

Département de génie électrique et         Electric Engineering and
de génie informatique                      Computer Engineering department
École Polytechnique de Montréal            Montreal Polytechnic School