Version vom 14. September 2005, 19:15 Uhr

SDL_WM_SetIcon

Name

SDL_WM_SetIcon - Setzt das Icon für das Displayfenster

Delphi-Spezifikation

procedure SDL_WM_SetIcon(icon : PSDL_Surface; mask : Uint8)

Parameter

Beschreibung

Setzt das Icon für das Displayfenster. Bei Windows muss dieses 32*32 Pixel gross sein.
Die Maske beschreibt die Gestalt des Icons. Wenn diese 0 ist, wird der Farbschlüssel oder der Alphakanal für die Transparenz benutzt. Wenn beide nicht vorhanden sind wird das Icon undurchsichtig.
Wenn die Maske gesetzt ist, zeigt sie auf ein Bild mit folgenden Eigenschaften:
Jede Scanline besteht aus (Breite/8) Bytes, aufgerundet. Der entscheidende Bit jedes Bytes ist der linkste. Dieser entscheidet ob sichtbar oder nicht sichtbar.

Hinweise

Die Procedure muss vor SDL_SetVideoMode aufgerufen werden.
Der Sinn bzw. die Funktion der Maske ist nicht klar. Einige Dokumentationen geben unterschiedliche Hinweise. Sicherer ist es mit dem Colorkey (siehe Beispiel).

Beispiel

//einfaches Beispiel
SDL_WM_SetIcon(SDL_LoadBMP('icon.bmp'), 0);

//weiteres Beispiel mit Setzen des Farbschlüssels (hier lila)
var colorkey: Uint32;
    image: PSDL_Surface;
begin
  image:=SDL_LoadBMP('icon.bmp');

  colorkey:=SDL_MapRGB(image.format, 255, 0, 255);

  SDL_SetColorKey(image, SDL_SRCCOLORKEY, colorkey);              

  SDL_WM_SetIcon(image,0);
end;

Siehe auch

SDL_SetVideoMode, SDL_WM_SetCaption