No description
Find a file
Sam Lantinga 31d40ce879 Date: Tue, 15 Feb 2005 21:28:48 +0900 (JST)
From: "Michael Leonhard"
Subject: [SDL] resize bug on Win32 and patch

This is my first post to this mailing list.  In this email I will detail a
bug in the behavior of resizable SDL windows on Win32.  Then I will
explain the solution and provide a patch.

Symptoms:

Under Windows, an SDL display created with the SDL_RESIZABLE flag exhibits
quirky behavior when being maximized.  The window is resized to the proper
size, but it is shifted upwards about half the height of the title bar.
Similarly, a window whose origin is above the top of the screen will
spontaneously move its upper-left origin upon being resized.  After two
such resize-induced moves, the title bar will be entirely off the top edge
of the screen.  Subsequently, when the mouse is clicked and released on
the window border, the window will shrink its height spontaneously.  This
height shrinkage occurs even if the user did not resize the border.

To observe this curious situation, please invoke:
SDL-1.2.8/test/testwm.exe -resize

Cause:

A pair of integers, SDL_windowX and SDL_windowY, are defined in
video/wincommon/SDL_sysevents.c.  They are used by the DirectX video
driver and the DIB video driver:
video/windx5/SDL_dx5video.c
video/windib/SDL_dibvideo.c
As I understand the source code, the primary use of these variables is to
create a rectangle that represents the surface area in CLIENT SPACE.
Client space refers to a coordinate system that originates at the upper
left corner of a Win32 Window's drawable area.  This is just inside the
window border and title bar.  This client space rectangle, called bounds,
is subsequently converted to screen space with a call to
AdjustWindowRectEx.  The problem is found in SDL's handling of the
WM_WINDOWPOSCHANGED message.  According to MSDN,

  "The WM_WINDOWPOSCHANGED message is sent to a window whose
   size, position, or place in the Z order has changed as a
   result of a call to the SetWindowPos function or another
   window-management function."

I have confirmed that this message is indeed being sent to the SDL window
when the mouse is clicked on the window border, even if the window border
is not dragged.

In video/wincommon/SDL_sysevents.c, on line 464, in response to the
WM_WINDOWPOSCHANGED message, the (potentially) new client rectangle is
obtained.  This rectangle is translated into screen coordinates and THEN
assigned to the SDL_windowX and Y variables.  Thus screen coordinates are
being assigned to client coordinate variables.  Once this is understood,
the solution is apparent:  assign SDL_windowX and Y before translating the
rectangle to screen coordinates.  This is accomplished by the following
patch.

-Mike_L

--HG--
extra : convert_revision : svn%3Ac70aab31-4412-0410-b14c-859654838e24/trunk%401290
2006-01-29 08:50:06 +00:00
docs *** empty log message *** 2006-01-28 05:47:11 +00:00
include *** empty log message *** 2006-01-27 08:47:15 +00:00
src Date: Tue, 15 Feb 2005 21:28:48 +0900 (JST) 2006-01-29 08:50:06 +00:00
test *** empty log message *** 2006-01-29 08:19:27 +00:00
.cvsignore *** empty log message *** 2004-12-16 05:29:55 +00:00
acinclude.m4 Don't fail if we don't have ALSA available 2004-08-24 06:32:50 +00:00
autogen.sh Date: Fri, 2 Sep 2005 21:56:50 -0400 2005-09-11 04:15:44 +00:00
Borland.html *** empty log message *** 2003-07-01 01:18:27 +00:00
Borland.zip *** empty log message *** 2003-07-01 01:18:27 +00:00
BUGS Real Unicode support for X11. Based on updated version of this patch: 2005-11-21 00:16:34 +00:00
config.guess Updated config* from CVS 2006-01-26 07:33:57 +00:00
config.sub Updated config* from CVS 2006-01-26 07:33:57 +00:00
configure.in Updated Windows CE/PocketPC support...adds GAPI driver, landscape mode, 2006-01-19 08:43:00 +00:00
COPYING Initial revision 2001-04-26 16:45:43 +00:00
CREDITS Lots of people have contributed cash. :) 2004-02-15 22:04:46 +00:00
CWprojects.sea.bin Updated version number 2005-08-24 05:49:57 +00:00
docs.html *** empty log message *** 2005-08-21 08:02:23 +00:00
EpocBuildFiles.zip Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!) 2001-12-14 12:37:34 +00:00
INSTALL Date: Tue, 2 Mar 2004 11:34:54 +0100 2004-03-02 13:01:02 +00:00
ltmain.sh Updated libtool support for libtool 1.5.8 2004-08-21 20:35:50 +00:00
Makefile.am Merged the Visual C++ 6 and 7 projects so all Visual C++ users unpack the same set of projects to get started. 2005-08-24 21:57:48 +00:00
Makefile.dc Added initial support for Dreamcast (thanks HERO!) 2002-10-05 16:50:56 +00:00
MPWmake.sea.bin Fixed MPW include file order 2006-01-19 12:05:14 +00:00
PBProjects.tar.gz The tenth time is the charm... 2004-05-20 10:05:59 +00:00
README Wacky! :) 2006-01-27 07:02:19 +00:00
README-SDL.txt Initial revision 2001-04-26 16:45:43 +00:00
README.AmigaOS Updated the Amiga OS port of SDL (thanks Gabriele) 2001-05-10 20:13:29 +00:00
README.CVS *** empty log message *** 2004-05-16 22:37:59 +00:00
README.DC Added initial support for Dreamcast (thanks HERO!) 2002-10-05 16:50:56 +00:00
README.Epoc Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!) 2001-12-14 12:37:34 +00:00
README.MacOS Date: Sat, 8 Sep 2001 04:42:23 +0200 2001-09-11 19:00:18 +00:00
README.MacOSX Updated SDL for MacOS X Xcode support 2004-12-06 04:17:56 +00:00
README.MiNT Disable XBIOS driver for mouse and joystick under MiNT. Will write a driver for /dev/mouse later. 2006-01-06 22:24:09 +00:00
README.NanoX Date: Sat, 24 Aug 2002 22:20:01 -0600 2002-08-25 06:21:49 +00:00
README.OS2 OS/2 port! 2005-11-23 07:29:56 +00:00
README.PicoGUI Added initial support for PicoGUI (thanks Micah!) 2002-08-01 23:24:13 +00:00
README.QNX Date: Sat, 24 Apr 2004 15:13:32 +0300 2004-05-06 15:55:06 +00:00
README.Qtopia Added a README for Qtopia 2002-06-01 18:43:51 +00:00
README.RISCOS Date: Wed, 26 Jan 2005 13:37:09 GMT 2005-02-12 18:01:31 +00:00
README.WinCE Updated Windows CE/PocketPC support...adds GAPI driver, landscape mode, 2006-01-19 08:43:00 +00:00
README.wscons To: sdl@libsdl.org 2005-11-22 15:19:50 +00:00
sdl-config.in Fixed static linking on MacOS X (thanks Max!) 2004-02-11 07:09:11 +00:00
sdl.m4 Date: Wed, 17 Aug 2005 11:23:40 -0400 2005-08-18 06:06:02 +00:00
SDL.qpg.in Date: Tue, 2 Mar 2004 08:52:20 +0200 2004-03-02 12:38:27 +00:00
SDL.spec.in The MacOSX Carbon/Cocoa/X11 all in one library patch. Relevant emails: 2005-09-08 06:16:14 +00:00
setvars.cmd OS/2 port! 2005-11-23 07:29:56 +00:00
strip_fPIC.sh Fixed to work on Solaris x86 2001-05-10 20:19:50 +00:00
TODO *** empty log message *** 2001-08-18 10:33:55 +00:00
VisualC.html Merged the Visual C++ 6 and 7 projects so all Visual C++ users unpack the same set of projects to get started. 2005-08-24 21:57:48 +00:00
VisualC.zip Avoid warnings in Visual C++ 2005 2006-01-27 08:51:27 +00:00
VisualCE.zip Updated Windows CE/PocketPC support...adds GAPI driver, landscape mode, 2006-01-19 08:43:00 +00:00
Watcom.mif OS/2 port! 2005-11-23 07:29:56 +00:00
WhatsNew *** empty log message *** 2004-01-08 16:01:07 +00:00

                         Simple DirectMedia Layer

                                  (SDL)

                                Version 1.2

---
http://www.libsdl.org/

This is the Simple DirectMedia Layer, a general API that provides low
level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL,
and 2D framebuffer across multiple platforms.

SDL is written in C, but works with C++ natively, and has bindings to
several other languages, including Ada, C#, Eiffel, Java, Lua, ML,
Objective C, Perl, PHP, Pike, Python, and Ruby.

The current version supports Linux, Windows, BeOS, MacOS, MacOS X,
FreeBSD, OpenBSD, BSD/OS, Solaris, IRIX, and QNX.  The code contains
support for Windows CE, AmigaOS, Dreamcast, Atari, NetBSD, AIX, OSF/Tru64,
RISC OS, SymbianOS, and OS/2, but these are not officially supported.

This library is distributed under GNU LGPL version 2, which can be
found in the file  "COPYING".  This license allows you to use SDL
freely in commercial programs as long as you link with the dynamic
library.

The best way to learn how to use SDL is to check out the header files in
the "include" subdirectory and the programs in the "test" subdirectory.
The header files and test programs are well commented and always up to date.
More documentation is available in HTML format in "./docs/index.html"

The test programs in the "test" subdirectory are in the public domain.

Frequently asked questions are answered online:
	http://www.libsdl.org/faq.php

If you need help with the library, or just want to discuss SDL related
issues, you can join the developers mailing list:
	http://www.libsdl.org/mailing-list.php

Enjoy!
	Sam Lantinga				(slouken@libsdl.org)