49298aaa945d50f068bcd4fb840c46928796cc49
[freeglut] / ChangeLog
1 Changes to Freeglut:
2
3 Before and on October 22, 2002:
4
5 (1) Many trivial changes (changing floating-point numbers to integers, for example) to reduce the number of compiler warnings
6
7 (2) Removing "strlen" calls from for-loop headers to make things execute ever-so-slightly faster
8
9 (3) Slight changes to the "glutSolidSphere" and "glutWireSphere" functions to reduce the number of calls to the sine and cosine functions and otherwise make it slightly more efficient
10
11 (4) Added wire and solid torus, wire and solid dodecahedron, wire and solid octahedron, wire and solid tetrahedron, and wire and solid icosahedron
12
13 (5) Fixed a bug by which the GLUT menu now draws even when nothing else is happening in the window
14
15 (6) Fixed a bug by which freeglut now tracks which window text is being entered into
16
17 (7) Added code to adjust for the thickness of the window borders and header bar when resizing and repositioning a window
18
19 October 23, 2002:
20
21 (8) Added a window destroy callback for freeglut to call the application when a window is closed.  Made freeglut call "exit" if there is no window destroy callback.
22
23 October 24, 2002:
24
25 (8b)  Also started working on the code to implement the other behaviors when the user clicks on the "x" on the window header bar.
26
27 (9) Added the "glutSetOption" function, the "GLUT_ACTION_ON_WINDOW_CLOSE" enumeration, and its allowed values
28
29 (10) Added code to check whether a window is a subwindow in the reposition and reshape functions.  If it is a subwindow, do not adjust the position and size for the window border.
30
31 (11) Added code to fix the drawing of subwindows inside of windows.  The Windows implementation uses "GetWindowRect" which uses coordinates relative to the screen corner, not the parent window corner.
32
33 (12) Modified the code to open a window so that the freeglut window now matches the GLUT window.
34
35 (13) Added an ugly hack to the main loop function to call each window's visibility callback before jumping into the main loop.  This fixes the behaviour of several of the demo programs.
36
37
38
39 *******************************************************************************************
40 * Sent a copy of the files to Steve Baker 10/24/02.
41 *******************************************************************************************
42
43 (14) Reworked the "freeglut_font.c" file pretty thoroughly to speed things up a bit, to add the "glutStrokeString" function, and to make the "glutStrokeLength" function return an accurate value for long strings.  Also allowed the string functions to handle character strings containing carriage returns.
44
45 (15) Moved the "fgState" structure initialization in "freeglut_init.c" out of "fgInitialize" to set them at compile time.  Also added it to "fgDeinitialize" to reset the state.
46
47 (16) Recoded a bit in "glutInit" to speed things up slightly
48
49 (17) Added "#pragma warning ( once: 4305 )" directives to the stroke font files so that I don't get 4000 compiler warnings about assigning double precision constants to single precision variables
50
51 (18) Added a state enumeration (initializing, running, stopping) and flag to the "fgState" structure.  Modified the window closure and main loop code to use the enumeration instead of local variables.
52
53 (19) Fixed the "glutPositionWindow" so that if you get and retrieve the window position twenty times in a row the window won't slide down the screen.
54
55 (20) Recoded the "glut*Cone" functions so that they have normals on the curved surface and so that the "base" argument is really the radius of the base of the cone.
56
57 (21) Added code to render a rhombic dodecahedron in the geometry library.
58
59 (22) Started work on a "glutInitDisplayString" function.  I have provided a framework; I will need some serious help in interpreting the results.
60
61 (23) Modified the "fgDisplayMenu" so that the matrix mode is GL_MODELVIEW instead of GL_PROJECTION when execution returns to its calling function.  I have no idea why, but this fixes some display problems in some of the demos.  Part (or all) of the display was blanking out when the user brought up a menu.
62
63 (24) Added four "pragma comment" lines to "freeglut.h" so that freeglut will automatically (under Windows) include "winmm.lib", "opengl32.lib", "glu32.lib", and "freeglut.lib".  This way the application doesn't have to do this by hand.
64
65 (25) Fixed the window positioning code so that if the border is going to extend above the top of the screen, it gets set to the top of the screen.
66
67 (26) Added right-arrows to menu entries which have submenus.  Also modified the submenu position so that it comes down to the right or to the left of the parent menu.
68
69 (27) Recoded a good bit of the menu processing to make the menus behave more like GLUT menus.
70
71 *******************************************************************************************
72 * Sent a copy of the files to Steve Baker 10/31/02.  Also posted these on the reflector.
73 *******************************************************************************************
74
75 (28) Added parentheses to the Windows version of setting the "State.Modifiers" to allow for precedence of operators.  Also modified the code so that it follows the "getKeyState" return value specification.
76
77 (29) Made the window event handler check for the existence of a window for all messages except the "create" message
78
79 (30) Changed the order of events in the window closure function so that the window would still be in the windows structure when the closure message to Windows was sent.
80
81 (31) Made some more changes to the window closure code so that it works from both clicking on the "x" and from a "glutDestroyWindow" call
82
83 *******************************************************************************************
84 * Sent a copy of the files to Steve Baker 10/31/02 as an update.  Also posted these on the reflector.
85 *******************************************************************************************
86
87 (32) Added "glutLeaveMainLoop" function.
88
89 (33) Added "glutMainLoopEvent" function.  This processes a single iteration through the "glutMainLoop" and is (theoretically) usable for re-entrant GLUT code.
90
91 (34) Implemented the "WM_KEYUP" and "WM_SPECIALKEYUP" callbacks in the Windows version.
92
93 (35) Added normals to the "glutWireCube" function
94
95 (36) Recoded "glutGetExtension" to remove a <Steve, cover your eyes> "goto" statement </Steve, cover your eyes> from the code.
96
97 (37) Marked the "glutSetKeyRepeat" function as deprecated.
98
99 (38) Implemented most of the Windows version of the "fghGetConfig" function.
100
101 *******************************************************************************************
102 * Took up the project again November 19.
103 *******************************************************************************************
104
105 (39) Added two missing characters to each of the bitmapped fonts.
106
107 (40) Added "glutSierpinskiSponge" to the geometry file.  I can take it out if people object.
108
109 (41) Added a linked list of windows to close so that if you destroy a window from within its callback the program won't terminate on error.
110
111 (42) Added a call to "free" in the joystick code so we wouldn't have a memory leak.  Also fixed another memory leak.
112
113 (43) Fixed the bitmapped Helvetica 12 and Helvetica 18 fonts so they now match the GLUT fonts.
114
115 *******************************************************************************************
116 * Sent the files to Don Heyse on November 27 for inclusion in CVS.
117 *******************************************************************************************
118
119 (44) Fixed the other bitmapped fonts so they now match the GLUT fonts.  There are some differences in the placement of the bit patterns within the characters, but the greatest difference is only a pixel or two.
120
121 (45) Added DLL capability.  Changed the names of the outputs so that the static library is "freeglut_static.lib" and the names of the DLL file and its interface file are "freeglut.dll" and "freeglut.lib".
122
123 (46) Moved the "freeglut_internal.h" file from the public include directory to the private source code directory.
124
125 (47) Split the "freeglut.h" file into a "glut.h" file that is compatible with GLUT and a "freeglut_ext.h" file that contains the new extensions.
126
127 *******************************************************************************************
128 * Changes starting in May 2003
129 *******************************************************************************************
130
131 (48) Changed "freeglut_main.c" to allow the Windows version to pass the mouse position to the keystroke callbacks
132
133 (49) Changed "freeglut_main.c" in the Unix section to move the call to find the event's window to before the "switch" statement.
134
135 (50) Changed "freeglut_main.c" in the Unix section to modify the window closure sequence of events slightly.
136
137 (51) Changed "freeglut_state.c" so the "glutGet" calls with window position and size don't move the windows down and to the right one pixel.
138
139 *******************************************************************************************
140 * Changes starting in May 2003
141 *******************************************************************************************
142
143 (52) Implement single-buffered rendering (or its emulation) in Windows.
144
145 (53) Implement Eero Pajarre's "GLUT_ICON" code.
146
147 (54) Fixes for the window positioning problem.
148
149 (55)  Fixed a couple of compiler warnings and other bugs. Changed "freeglut_main.c" to remove a compiler warning. Changed "freeglut_structure.c" to set the current window before calling the window closure callback.