From 1941df93b9590725bed06daa9d87e4df37129ce0 Mon Sep 17 00:00:00 2001
From: dcnieho
- FreeGLUT 3.0 introduces support for the Android platform. Check Check
+ freeglut 3.0 introduces support for the Android platform.
This platform is different than traditional desktop platforms, requiring cross-compilation, interfacing with a touchscreen, and ability for your application to be paused and resumed at any time.
@@ -50,7 +50,7 @@ generateHeader($_SERVER['PHP_SELF']);
-
@@ -111,7 +111,7 @@ generateHeader($_SERVER['PHP_SELF']);
make install
- progs/test-shapes-gles1/
in the FreeGLUT
+ progs/test-shapes-gles1/
in the freeglut
source distribution for a complete, stand-alone example.Compile your own project using the NDK build-system
@@ -120,7 +120,7 @@ generateHeader($_SERVER['PHP_SELF']);
mkdir freeglut-gles/
@@ -218,7 +218,7 @@ New functions will be necessary to :
ready to accept
onCreate
event to become active
again.
- By default, FreeGLUT exit()
s when the last window is
+ By default, freeglut exit()
s when the last window is
closed (without returning to your main
). But this
behavior can be changed
with glutSetOption(GLUT_ACTION_ON_WINDOW_CLOSE, ...)
,
@@ -240,7 +240,7 @@ New functions will be necessary to :
Real buttons such as the Back button appear to work correctly
(series of down events with proper getRepeatCount value).
- To work around this, FreeGLUT provides its own minimal virtual
+ To work around this, freeglut provides its own minimal virtual
keypad. It may be replaced by a virtual (touchscreen) joystick.
glutInitDisplayString support is limited: any of the tokens recognized -by GLUT are also recognized by FreeGLUT, but any statements with +by GLUT are also recognized by freeglut, but any statements with comparators cannot (yet: do help develop this!) be handled. Any spec (comparator and value) after the token is ignored. However, many of these values can be set with glutSetOption @@ -513,7 +513,7 @@ for now...
The glutInitErrorFunc and glutInitWarningFunc
functions specify callbacks that will be called upon warnings and errors
-issued from within FreeGLUT so that the user can deal with these.
+issued from within freeglut so that the user can deal with these.
Useful for rerouting to another output sink (e.g., logging) and also to
avoid exit(1) being called upon error. As with other glutInit*
functions, these can be set before glutInit is called, so any output
@@ -530,7 +530,7 @@ The users callback is passed a format string and a variable argument
list that can be passed to functions such as printf.
Note that there are the preprocessor definitions
FREEGLUT_PRINT_ERRORS and FREEGLUT_PRINT_WARNINGS,
-which affect FreeGLUT's warning and error behavior when no user
+which affect freeglut's warning and error behavior when no user
callback is defined. If defined at library (not client app!) compile
time--by default it is, warnings and errors are printed to
stderr. If not defined, warnings and errors are muted (not
@@ -559,7 +559,7 @@ the event loop (as invoked by the glutMainLoop function) to the
calling function. This prevented an application from having re-entrant
code, in which GLUT could be invoked from within a callback, and it prevented
the application from doing any post-processing (such as freeing allocated
-memory) after GLUT had closed down. Freeglut allows the application
+memory) after GLUT had closed down. freeglut allows the application
programmer to specify more direct control over the event loop by means of
two new functions. The first, glutMainLoopEvent, processes
a single iteration of the event loop and allows the application to use a different
@@ -592,7 +592,7 @@ and so on.
In GLUT, there was absolutely no way for the application programmer to have control return from the glutMainLoop function to the -calling function. Freeglut allows the programmer +calling function. freeglut allows the programmer to force this by setting the GLUT_ACTION_ON_WINDOW_CLOSE option and invoking the glutLeaveMainLoop function from one of the callbacks. Stopping the program this way is preferable to simply calling exit @@ -650,9 +650,9 @@ will exit.
If the application has two nested calls to glutMainLoop and calls glutLeaveMainLoop, the behaviour -of FreeGLUT is undefined. It may leave only the inner nested +of freeglut is undefined. It may leave only the inner nested loop or it may leave both loops. If the reader has a strong preference -for one behaviour over the other he should contact the FreeGLUT Programming +for one behaviour over the other he should contact the freeglut Programming Consortium and ask for the code to be fixed.
@@ -728,7 +728,7 @@ an iconified state respectively. Normally a window system displays a title for every top-level window in the system. The initial title is set when you call glutCreateWindow(). By means of the glutSetWindowTitle function you can set the -titles for your top-level FreeGLUT windows. If you just want one +titles for your top-level freeglut windows. If you just want one title for the window over the window's entire life, you should set it when you open the window with glutCreateWindow().Changes From GLUT
glutSetIconTitle does nothing in GLUT on Windows, but is -emulated on Windows by FreeGLUT.
+emulated on Windows by freeglut.-Freeglut does not allow overlays, although it does "answer the mail" +freeglut does not allow overlays, although it does "answer the mail" with function stubs so that GLUT-based programs can compile and link against freeglut without modification.
@@ -993,7 +993,7 @@ stroke font, or an unknown font.The glutIdleFunc function sets the global idle callback. -Freeglut calls the idle callback when there are no inputs from the user. +freeglut calls the idle callback when there are no inputs from the user.
Usage
@@ -1012,7 +1012,7 @@ specifies the function that freeglut will call to perform background processing tasks such as continuous animation when window system events are not being received. If enabled, this function is called continuously from freeglut while no events are received. The callback function -has no parameters and returns no value. Freeglut does not change +has no parameters and returns no value. freeglut does not change the current window or the current menu before invoking the idle callback; programs with multiple windows or menus must explicitly set the current window and current menu @@ -1056,7 +1056,7 @@ the idle callback.The glutPositionFunc function sets the window's position -callback. Freeglut calls the position callback when the window is +callback. freeglut calls the position callback when the window is repositioned/moved programatically or by the user.
@@ -1067,12 +1067,12 @@ repositioned/moved programatically or by the user.Description
-When FreeGLUT calls this callback, it provides the new +
When freeglut calls this callback, it provides the new position on the screen of the top-left of the non-client area, that is, the same coordinates used by glutInitPosition and glutPositionWindow. To get the position on the screen of the top-left of the client area, use glutGet(GLUT_WINDOW_X) and -glutGet(GLUT_WINDOW_Y). See FreeGLUT's +glutGet(GLUT_WINDOW_Y). See freeglut's conventions for more information.
Changes From GLUT
@@ -1083,7 +1083,7 @@ conventions for more information.The glutCloseFunc function sets the window's close -callback. Freeglut calls the close callback when the window is +callback. freeglut calls the close callback when the window is about to be destroyed.
@@ -1105,10 +1105,10 @@ window header (for top-level windows only), or due to a pending closure of a subwindow's parent window. In the first case, the closure callback is not invoked from the glutDestroyWindow call, but at a later time point.The glutSpecialFunc function sets the window's special key press -callback. Freeglut calls the special key press callback when the +callback. freeglut calls the special key press callback when the user presses a special key.
@@ -1153,7 +1153,7 @@ that freeglut will call when the user presses a special key on the keyboard. The callback function has one argument: the name of the function to be invoked ("called back") at the time at which the special key is pressed. The function returns no -value. Freeglut sets the current window to the window +value. freeglut sets the current window to the window which is active when the callback is invoked. "Special keys" are the function keys, the arrow keys, the Page Up and Page Down keys, and the Insert key. The Delete key is considered to be a regular key.The glutKeyboardUpFunc function sets the window's key release -callback. Freeglut calls the key release callback when the user releases +callback. freeglut calls the key release callback when the user releases a key.
@@ -1214,7 +1214,7 @@ for upper or lower case letters, it does not do so for non-alphabetical characters. Nor does it account for the Caps-Lock key being on. The operating system may send some unexpected characters to freeglut, such as "8" when the user is pressing the Shift -key. Freeglut also invokes the callback when the user +key. freeglut also invokes the callback when the user releases the Control, Alt, or Shift keys, among others. Releasing the Delete key causes this function to be invoked with a value of 127 for key.The glutSpecialUpFunc function sets the window's special key -release callback. Freeglut calls the special key release callback +release callback. freeglut calls the special key release callback when the user releases a special key.
@@ -1259,7 +1259,7 @@ The glutSpecialUpFuncfunction specifies the function that freeglut user releases a special key from the keyboard. The callback function has one argument: the name of the function to be invoked ("called back") at the time at which the special key is released. The function returns -no value. Freeglut sets the current window to the window +no value. freeglut sets the current window to the window which is active when the callback is invoked. "Special keys" are the function keys, the arrow keys, the Page Up and Page Down keys, and the Insert key. The Delete key is considered to be a regular key.The glutMouseWheelFunc function sets the window's mouse wheel -callback. Freeglut calls the mouse wheel callback when the user +callback. freeglut calls the mouse wheel callback when the user spins the mouse wheel.
@@ -1306,7 +1306,7 @@ direction, int x, int y ));Description
-If the mouse wheel is spun over your (sub)window, FreeGLUT +
If the mouse wheel is spun over your (sub)window, freeglut
will report this via the MouseWheel callback. wheel is the wheel
number, direction is +/- 1, and x and y are
the mouse coordinates.
@@ -1330,7 +1330,7 @@ The glutSpaceballMotionFunc function is implemented in
provided so that GLUT-based programs can compile and link against
freeglut without modification.
The glutSpaceballMotionFunc function sets the window's Spaceball motion callback. Freeglut invokes this callback when the user push/pull Spaceball cap in x, y, and z directions. +
The glutSpaceballMotionFunc function sets the window's Spaceball motion callback. freeglut invokes this callback when the user push/pull Spaceball cap in x, y, and z directions.
Usage
@@ -1350,7 +1350,7 @@ The glutSpaceballRotateFunc function is implemented in provided so that GLUT-based programs can compile and link against freeglut without modification. -The glutSpaceballRotateFunc function sets the window's Spaceball rotation callback. Freeglut invokes this callback when the user rotates/twists Spaceball cap. +
The glutSpaceballRotateFunc function sets the window's Spaceball rotation callback. freeglut invokes this callback when the user rotates/twists Spaceball cap.
Usage
@@ -1371,7 +1371,7 @@ provided so that GLUT-based programs can compile and link against freeglut without modification.-The glutSpaceballButtonFunc function sets the window's Spaceball button callback. Freeglut invokes this callback when the user presses/releases one of the Spaceball buttons. +The glutSpaceballButtonFunc function sets the window's Spaceball button callback. freeglut invokes this callback when the user presses/releases one of the Spaceball buttons.
Usage
@@ -1409,7 +1409,7 @@ are the same.-The glutDialsFunc function sets the global dials&buttons box callback. Freeglut calls the callback when there is input from the box buttons. +The glutDialsFunc function sets the global dials&buttons box callback. freeglut calls the callback when there is input from the box buttons.
Usage
@@ -1434,7 +1434,7 @@ for instance.-The glutDialsFunc function sets the global dials&buttons box callback. Freeglut calls the callback when there is input from the box dials. +The glutDialsFunc function sets the global dials&buttons box callback. freeglut calls the callback when there is input from the box dials.
Usage
@@ -1507,7 +1507,7 @@ is not implemented in freeglut.The glutVisibilityFunc and the glutWindowStatusFunc functions set the window's visibility and windowStatus callbacks for the -current window. Setting one overwrites the other. Freeglut calls +current window. Setting one overwrites the other. freeglut calls these callbacks when the visibility status of a window changes.
@@ -1555,7 +1555,7 @@ discarded.-Freeglut supports two types of font rendering: bitmap fonts, +freeglut supports two types of font rendering: bitmap fonts, which are rendered using the glBitmap function call, and stroke fonts, which are rendered as sequences of OpenGL line segments. Because they are rendered as bitmaps, the bitmap fonts tend to render more quickly @@ -1757,7 +1757,7 @@ At the moment, freeglut fonts do not support the "`" (backquote) and
-Freeglut supports the following bitmap fonts: +freeglut supports the following bitmap fonts:
-Freeglut calls glRasterPos4v to advance the cursor by +freeglut calls glRasterPos4v to advance the cursor by the width of a character and to render carriage returns when appropriate. It does not use any display lists in it rendering in bitmap fonts.
-Freeglut supports +freeglut supports the following stroke fonts:
@@ -1787,7 +1787,7 @@ the following stroke fonts:-Freeglut does not use any display lists in its rendering of stroke +freeglut does not use any display lists in its rendering of stroke fonts. It calls glTranslatef to advance the cursor by the width of a character and to render carriage returns when appropriate.
@@ -1814,7 +1814,7 @@ code of the character to be renderedThe glutBitmapCharacter function renders the given character in the specified bitmap font. -Freeglut automatically sets the necessary +freeglut automatically sets the necessary pixel unpack storage modes and restores the existing modes when it has finished. Before the first call to glutBitMapCharacter the application program should call glRasterPos* to set the position of the character @@ -1853,7 +1853,7 @@ of characters to be rendered
The glutBitmapString function renders the given character string in the specified bitmap font. -Freeglut automatically sets the necessary +freeglut automatically sets the necessary pixel unpack storage modes and restores the existing modes when it has finished. Before calling glutBitMapString the application program should call glRasterPos* to set the position of the string in the window. @@ -2110,7 +2110,7 @@ whose width is to be calculated
The glutStrokeLength function returns the width in model units of the given character string in the specified stroke font. Because the font is a stroke font, the width -of an individual character is a floating-point number. Freeglut +of an individual character is a floating-point number. freeglut adds the floating-point widths and rounds the final result to return the integer value. Thus the return value may differ from the sum of the character widths returned by a series of calls to glutStrokeWidth. @@ -2184,7 +2184,7 @@ are designed such that all characters have (nominally) the same height.
-Freeglut includes twenty two routines for generating +freeglut includes twenty two routines for generating easily-recognizable 3-d geometric objects. These routines are effectively the same ones that are included in the GLUT library, and reflect the functionality available in the aux toolkit described @@ -2566,7 +2566,7 @@ To draw shapes with shaders (OpenGL 2 and later), one need to upload vertices and associated normal vectors and texture coordinates to vertex attributes of your shaders. Use these functions to set the indices (addresses) of the vertex attributes in your currently active -shaders before calling the above geometry functions, and FreeGLUT +shaders before calling the above geometry functions, and freeglut will upload the object geometry there. Texture coordinates are only generated for the teapot, teacup and teaspoon.
@@ -2786,7 +2786,7 @@ the windows for which you don't want it.Changes From GLUT
Nate Robbins' port of GLUT to win32 did not implement -glutSetKeyRepeat, but FreeGLUT's behavior should conform on all +glutSetKeyRepeat, but freeglut's behavior should conform on all platforms to GLUT's behavior on X11.
Application programmers who are porting their GLUT programs to freeglut may continue
@@ -2843,7 +2843,7 @@ Programs which use the freeglut-specific extensions to GLUT should includ
It was initially planned to
define FREEGLUT_VERSION_2_0
, FREEGLUT_VERSION_2_1
, FREEGLUT_VERSION_2_2
,
etc., but this was only done for FREEGLUT_VERSION_2_0
.
-This constant still exist in current FreeGLUT releases but is
+This constant still exist in current freeglut releases but is
deprecated.
FreeGLUT can initialize an OpenGL ES (GLES) context. It works under platforms that supports EGL:
+freeglut can initialize an OpenGL ES (GLES) context. It works under platforms that supports EGL:
FreeGLUT ES is provided as a separate library, because OpenGL ES +
freeglut ES is provided as a separate library, because OpenGL ES has a distinct library from plain OpenGL (-lGLESv1_CM -lGLESv2 instead of -lGL, and different headers too). We could consider dynamically loading the OpenGL symbols we need, @@ -44,7 +44,7 @@ window.
The following explains how to use FreeGLUT ES for Mesa EGL.
+
The following explains how to use freeglut ES for Mesa EGL.
See also the Android page.
First, check README.cmake to install the dependencies for your system.
@@ -95,7 +95,7 @@ PKG_CONFIG_PATH=/tmp/freeglut-native-gles/share/pkgconfig/ cmake .. tut04_transform-gles2 example: it uses a basic Makefile targeting freeglut-glesFreeGLUT started out as a GLUT clone, but now it's something much +
freeglut started out as a GLUT clone, but now it's something much better than that. It's a GLUT replacement. Here are the features you have wanted -- and if you have ideas for more, share them (see below), or fork our github -repository and implement them! FreeGLUT is under continuous +repository and implement them! freeglut is under continuous development. Currently, work on 3.0 is in full swing. See here for the list of work that is still to be done.
@@ -51,10 +51,10 @@ But simply, become involved! The project is not just software, it's the people that contribute, too. -Click here for an overview of the major work, -its status and planned milestones for FreeGLUT 3.0 and beyond. Help on +its status and planned milestones for freeglut 3.0 and beyond. Help on any of these plans, as well as suggestions and/or patches for anything else are very welcome!
diff --git a/freeglut/web-src/index.php b/freeglut/web-src/index.php index f45727a..fc766cb 100644 --- a/freeglut/web-src/index.php +++ b/freeglut/web-src/index.php @@ -10,24 +10,24 @@ generateHeader($_SERVER['PHP_SELF']);FreeGLUT is a free-software/open-source alternative to the OpenGL Utility +
freeglut is a free-software/open-source alternative to the OpenGL Utility Toolkit (GLUT) library. GLUT was originally written by Mark Kilgard to support the sample programs in the second edition OpenGL 'RedBook'. Since then, GLUT has been used in a wide variety of practical applications because it is simple, widely available and highly portable.
-GLUT (and hence FreeGLUT) takes care of all the system-specific chores +
GLUT (and hence freeglut) takes care of all the system-specific chores required for creating windows, initializing OpenGL contexts, and handling input events, to allow for trully portable OpenGL programs.
-FreeGLUT is released under the X-Consortium license.
+freeglut is released under the X-Consortium license.
FreeGLUT was originally written by Pawel W. Olszta with contributions from +
freeglut was originally written by Pawel W. Olszta with contributions from Andreas Umbach and Steve Baker.
John F. Fay, John Tsiombikas, and Diederick C. Niehorster are the current -maintainers of the FreeGLUT project.
+maintainers of the freeglut project.Pawel started FreeGLUT development on December 1st, 1999. The project is now +
Pawel started freeglut development on December 1st, 1999. The project is now virtually a 100% replacement for the original GLUT with only a few departures (such as the abandonment of SGI-specific features such as the Dials&Buttons box and Dynamic Video Resolution) and a shrinking set of bugs.
-FreeGLUT adds some additional features over the basic GLUT functionality, +
freeglut adds some additional features over the basic GLUT functionality, such as a larger set of predefined objects to use, the ability to run single iterations of the event loop, or exit from it gracefully, mousewheel input callbacks, optional OpenGL core/compatibility profile context creation, @@ -79,7 +79,7 @@ href="mailto:freeglut-developer@lists.sourceforge.net">freeglut-developer mailing list.
-Below are file links for the FreeGLUT project. README files are included. Have fun!
+Below are file links for the freeglut project. README files are included. Have fun!
There are no presently active testing releases.
- Freeglut 3.0.0 [Released: 7 March 2015]
- Freeglut 2.8.1 [Released: 5 April 2013]
- Freeglut 2.8.0 [Released: 2 January 2012]
- Freeglut 2.6.0 [Released: 27 November 2009]
- Freeglut 2.4.0 [Released: 9 June 2005]
- Freeglut 2.2.0 [Released: 12 December 2003]
- Freeglut 2.0.1 [Released: 23 October 2003]
+ freeglut 3.0.0 [Released: 7 March 2015]
+ freeglut 2.8.1 [Released: 5 April 2013]
+ freeglut 2.8.0 [Released: 2 January 2012]
+ freeglut 2.6.0 [Released: 27 November 2009]
+ freeglut 2.4.0 [Released: 9 June 2005]
+ freeglut 2.2.0 [Released: 12 December 2003]
+ freeglut 2.0.1 [Released: 23 October 2003]
The FreeGLUT project does not support packaged versions of FreeGLUT +
The freeglut project does not support packaged versions of freeglut excepting, of course, the tarballs distributed here. However, various members of the community have put time and effort into providing source or binary rollups, and we thank them for their efforts. Here's a list which is likely @@ -124,7 +124,7 @@ incomplete:
Florian Echtler's MPX Patch -If you have problems with these packages, please contact their maintainers - we of the FreeGLUT team probably can't help.
+If you have problems with these packages, please contact their maintainers - we of the freeglut team probably can't help.
@@ -135,7 +135,7 @@ incomplete:
Don't be afraid to ask for help. We don't bite. Much.
-Send FreeGLUT related questions to the appropriate FreeGLUT mailing list:
+Send freeglut related questions to the appropriate freeglut mailing list:
Major work, its status and planned milestone. Help on any of these plans is very welcome! Fork the @@ -37,7 +37,7 @@ invocation.