X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=README.hacking;h=72489a2d5504c065180a4ba2bfd5858e1bd829d8;hb=c1b9b55ad8d59dc05ef55e316aebf5863e7dfa56;hp=2b0db90af7cebe9386a807363a5db2da4320d622;hpb=49f5b54f312fe4ac2e9bc47581a72451bd0e8439;p=xscreensaver diff --git a/README.hacking b/README.hacking index 2b0db90a..72489a2d 100644 --- a/README.hacking +++ b/README.hacking @@ -56,9 +56,13 @@ The XScreenSaver API yoursavername_free -- Free everything you've allocated. yoursavername_reshape -- Called when the window is resized. yoursavername_event -- Called when a keyboard or mouse event happens. - The "reshape" and "event" functions are only - called when running in a window (not as a - screen saver). It's ok for them to do nothing. + + The "event" function will only be called when running in a window + (not as a screen saver). The "reshape" event will be called when the + window size changes, or (as a screen saver) when the display size + changes as a result of a RANDR event (e.g., plugging in a new monitor). + + It's ok for both the "event" and "resize" functions to do nothing. - All other functions should be static. @@ -94,7 +98,7 @@ The XLockMore API hacks like "Flag". The XLockMore ones are the ones that begin with "#ifdef STANDALONE" and #include "xlockmore.h". - All of the OpenGL screen savers follow the XLockMore API. + But, all OpenGL screen savers have to follow the XLockMore API. The XLockMore API is similar to the XScreenSaver API, in that you define (roughly) the same set of functions, but the naming conventions are @@ -157,7 +161,7 @@ The MacOS X Port To compile on MacOS, use the XCode project included in the source distribution. You shouldn't need to have X11 installed, and shouldn't - need to run "configure" first. MacOS 10.4.0 and XCode 2.2 or newer are + need to run "configure" first. MacOS 10.4.0 and XCode 2.5 or newer are required. ==========================================================================