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).
slouken@0
     1
slouken@0
     2
==============================================================================
slouken@0
     3
Using the Simple DirectMedia Layer with MacOS 7,8,9 on PPC
slouken@0
     4
==============================================================================
slouken@0
     5
slouken@0
     6
These instructions are for people using the Apple MPW environment:
slouken@0
     7
http://developer.apple.com/tools/mpw-tools/
slouken@0
     8
slouken@0
     9
CodeWarrior projects are available in the CWprojects directory.
slouken@0
    10
slouken@0
    11
==============================================================================
slouken@0
    12
I.  Building the Simple DirectMedia Layer libraries:
slouken@0
    13
    (This step isn't necessary if you have the SDL binary distribution)
slouken@0
    14
slouken@0
    15
  First, unpack the MPWmake.sea.hqx archive and move SDL.make into the
slouken@0
    16
  SDL directory.
slouken@0
    17
slouken@0
    18
  Start MPW
slouken@0
    19
slouken@0
    20
  Set the current directory within MPW to the SDL toplevel directory.
slouken@0
    21
slouken@0
    22
  Build "SDL"  (Type Command-B and enter "SDL" in the dialog)
slouken@0
    23
slouken@0
    24
  If everything compiles successfully, you now have the PPC libraries
slouken@0
    25
  "SDL" and "SDLmain.o" in the 'lib' subdirectory.
slouken@0
    26
slouken@0
    27
==============================================================================
slouken@0
    28
II. Building the Simple DirectMedia Layer test programs:
slouken@0
    29
slouken@0
    30
  First, unpack the MPWmake.sea.hqx archive, move the new rsrc directory to
slouken@0
    31
  the main SDL directory, and move the makefiles in the new test subdirectory
slouken@0
    32
  to the SDL 'test' subdirectory.
slouken@0
    33
slouken@0
    34
  Start MPW
slouken@0
    35
slouken@0
    36
  Set the current directory within MPW to the SDL 'test' subdirectory.
slouken@0
    37
slouken@0
    38
  Build the programs that have an associated MPW makefile (file ending
slouken@0
    39
  with .make), including "testwin", "testalpha", and "graywin".
slouken@0
    40
slouken@0
    41
  Copy the SDL library file into the test directory, and run!
slouken@0
    42
slouken@0
    43
==============================================================================
slouken@0
    44
III. Building the Simple DirectMedia Layer demo programs:
slouken@0
    45
slouken@0
    46
  Copy one of the test program Makefiles to the demo directory
slouken@0
    47
  and modify it to match the sources in the demo.
slouken@0
    48
slouken@0
    49
==============================================================================
slouken@0
    50
IV.  Enjoy! :)
slouken@0
    51
slouken@0
    52
  If you have a project you'd like me to know about, or want to ask questions,
slouken@0
    53
  go ahead and join the SDL developer's mailing list by sending e-mail to:
slouken@0
    54
slouken@172
    55
	sdl-request@libsdl.org
slouken@0
    56
slouken@172
    57
  and put "subscribe" into the subject of the message. Or alternatively you
slouken@172
    58
  can use the web interface:
slouken@172
    59
slouken@172
    60
	http://www.libsdl.org/mailman/listinfo/sdl
slouken@0
    61
  
slouken@0
    62
==============================================================================
slouken@0
    63