README.MacOS
author Sam Lantinga <slouken@libsdl.org>
Thu, 11 May 2006 03:45:55 +0000
changeset 1812 9c882e94b545
parent 172 37e3ca9254c7
permissions -rw-r--r--
Fixed bug #208

So, here's a patch with a reimplementation of QZ_SetIcon() that does what I
described above. I apologize for the delay, I've been quite busy in the last
few days.

It appears to work here on 10.4.5 PPC in the limited testing that I've done;
I'll try to test it on 10.3.9 and 10.2.8 as well, but that might take another
week or so. Please test on i386.

Regarding alpha channels, per-surface alpha, and color keys, the same semantics
as for regular blits to an RGB surface should apply (for the final icon
composited onto the dock), unless I made a mistake - except in one pathological
case: if the icon surface has an alpha channel, its SDL_SRCALPHA flag is not
set (i.e. it has been explicitly cleared, since it's on by default for RGBA
surfaces), and it has a color key, plus an explicit mask was specified (instead
of the one autogenerated from the colorkey), then the color-keyed areas appear
black instead of transparent. I found no elegant way of fixing this, was too
lazy to implement the inelegant one, and decided that it isn't worth the effort
(but if someone disagrees, I can do it).
     1 
     2 ==============================================================================
     3 Using the Simple DirectMedia Layer with MacOS 7,8,9 on PPC
     4 ==============================================================================
     5 
     6 These instructions are for people using the Apple MPW environment:
     7 http://developer.apple.com/tools/mpw-tools/
     8 
     9 CodeWarrior projects are available in the CWprojects directory.
    10 
    11 ==============================================================================
    12 I.  Building the Simple DirectMedia Layer libraries:
    13     (This step isn't necessary if you have the SDL binary distribution)
    14 
    15   First, unpack the MPWmake.sea.hqx archive and move SDL.make into the
    16   SDL directory.
    17 
    18   Start MPW
    19 
    20   Set the current directory within MPW to the SDL toplevel directory.
    21 
    22   Build "SDL"  (Type Command-B and enter "SDL" in the dialog)
    23 
    24   If everything compiles successfully, you now have the PPC libraries
    25   "SDL" and "SDLmain.o" in the 'lib' subdirectory.
    26 
    27 ==============================================================================
    28 II. Building the Simple DirectMedia Layer test programs:
    29 
    30   First, unpack the MPWmake.sea.hqx archive, move the new rsrc directory to
    31   the main SDL directory, and move the makefiles in the new test subdirectory
    32   to the SDL 'test' subdirectory.
    33 
    34   Start MPW
    35 
    36   Set the current directory within MPW to the SDL 'test' subdirectory.
    37 
    38   Build the programs that have an associated MPW makefile (file ending
    39   with .make), including "testwin", "testalpha", and "graywin".
    40 
    41   Copy the SDL library file into the test directory, and run!
    42 
    43 ==============================================================================
    44 III. Building the Simple DirectMedia Layer demo programs:
    45 
    46   Copy one of the test program Makefiles to the demo directory
    47   and modify it to match the sources in the demo.
    48 
    49 ==============================================================================
    50 IV.  Enjoy! :)
    51 
    52   If you have a project you'd like me to know about, or want to ask questions,
    53   go ahead and join the SDL developer's mailing list by sending e-mail to:
    54 
    55 	sdl-request@libsdl.org
    56 
    57   and put "subscribe" into the subject of the message. Or alternatively you
    58   can use the web interface:
    59 
    60 	http://www.libsdl.org/mailman/listinfo/sdl
    61   
    62 ==============================================================================
    63