Fixed bug #526 Comment #1 From Simon Howard 2009-03-20 16:50:56 Hi, I'm the author of Chocolate Doom, one of the other source ports that James mentioned. This is a patch against the current SVN version of SDL 1.2 that fixes the bug. It has been tested and hopefully should be obviously correct from examining the changes. I'll give a brief explanation. When the palette is set with SDL_SetPalette, the IDirectDrawPalette_SetEntries DirectX function is invoked. However, when this happens, a WM_PALETTECHANGED message is sent to the window. A WM_PALETTECHANGED message can also be received if the palette is changed for some other reason, like if the system palette is changed. Therefore, the palette change handler (DX5_PaletteChanged) has code to deal with this case. It distinguishes "expected" palette changes (set with SDL_SetPalette) from "unexpected" palette changes using the colorchange_expected variable, which is set before calling IDirectDrawPalette_SetEntries. However, the code to set this variable is missing in the fullscreen code path. By setting this variable, the palette change is handled properly and the freezes go away.

.TH "SDL_Init" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" 
.SH "NAME"
SDL_Init \- Initializes SDL
.SH "SYNOPSIS"
.PP
\fB#include "SDL\&.h"
.sp
\fBint \fBSDL_Init\fP\fR(\fBUint32 flags\fR);
.SH "DESCRIPTION"
.PP
Initializes SDL\&. This should be called before all other SDL functions\&. The \fBflags\fR parameter specifies what part(s) of SDL to initialize\&.
.TP 20
\fBSDL_INIT_TIMER\fP
Initializes the \fItimer\fR subsystem\&.
.TP 20
\fBSDL_INIT_AUDIO\fP
Initializes the \fIaudio\fR subsystem\&.
.TP 20
\fBSDL_INIT_VIDEO\fP
Initializes the \fIvideo\fR subsystem\&.
.TP 20
\fBSDL_INIT_CDROM\fP
Initializes the \fIcdrom\fR subsystem\&.
.TP 20
\fBSDL_INIT_JOYSTICK\fP
Initializes the \fIjoystick\fR subsystem\&.
.TP 20
\fBSDL_INIT_EVERYTHING\fP
Initialize all of the above\&.
.TP 20
\fBSDL_INIT_NOPARACHUTE\fP
Prevents SDL from catching fatal signals\&.
.TP 20
\fBSDL_INIT_EVENTTHREAD\fP
.SH "RETURN VALUE"
.PP
Returns \fB-1\fR on an error or \fB0\fR on success\&.
.SH "SEE ALSO"
.PP
\fI\fBSDL_Quit\fP\fR, \fI\fBSDL_InitSubSystem\fP\fR
...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00