Quelltext der Seite SDL SetColors

= SDL_SetColors =


== Name ==
'''SDL_SetColors''' - Setzt einen Teil der Farbpalette für eine gegebene 8-bit Surface


== Delphi-Spezifikation ==
 function '''SDL_SetColors'''(''surface'': PSDL_Surface; ''colors'': PSDL_Color; ''firstcolor'' : Integer; ''ncolors'': Integer) : Integer;



== Parameter ==

{| border="1" rules="all"
! ''surface'' 
| 8-Bit Surface
|-
! ''colors'' 
| Zeiger auf ein Array von PSDL_Color
|-
! ''firstcolor''
| Erster Eintrag der Palette welcher geändert werden soll.
|-
! ''ncolors'' 
| Anzahl der Einträge die ab ''firstcolor'' geändert werden sollen.
|}



== Beschreibung == 
Setzt einen Teil der Farbpalette für eine gegebene 8-bit Surface.

Falls ''surface'' die aktuelle Displaysurface ist, so wird die Displayfarbpalette auf die angeforderten Farben geänert. Falls SDL_HWPALETTE bei [[SDL_SetVideoMode]] gesetzt wurde, so wird SDL_SetColors immer 1 zurückgeben und es wird garantiert, dass die Palette wie gewünscht gesetzt wird, auch wenn die Displaypalette verbogen werden muss oder es unter Emulation laufen muss.

The Farbkomponenten einer [[SDL_Color]]-Struktur sind 8-Bit gross, womit man 256³ = 16777216 Farben zur Verfügung hat.

Palettierte (8-bit) Displaysurface mit SDL_HWPALETTE Flag haben zwei Paletten, eine logische Palette, welche für das Blitten aus/in die Surface benutzt wird, und eine physikalische Palette, welche bestimmt wie die Hardware die Farben auf das Display bringt. SDL_SetColors verändert beide Paletten (falls vorhanden), und ist äquivalent zu einem Aufruf von [[SDL_SetPalette]] mit (SDL_LOGPAL or SDL_PHYSPAL) als Flag.


==  Rückgabewert ==
Falls ''surface'' keine palettierte Surface ist, macht diese Funktion nichts und gibt 0 zurück. Falls alle Farben korrekt gesetzt wurden, wird 1 zurückgesetzt. Falls nicht alle Farbeinträge gesetzt werden konnten wird 0 zurückgegeben und man sollte sich die Surface-Palette anschauen um die aktuelle Palette festzustellen.


== Beispiel ==
<source lang="pascal">
// Erstellt eine Displaysurface mit einer Graufarbenpalette.
var
	screen: PSDL_Surface;
	colors: Array[0..255] of TSDL_Color;
	i: Integer;
begin
	.
	.
	.
	// Fülle colors mit den Farbinformationen
	for i:=0 to 255 do
	begin
		colors[i].r := i;
		colors[i].g := i;
		colors[i].b := i;
	end;

	// Erstelle das Display 
	screen := SDL_SetVideoMode(640, 480, 8, SDL_HWPALETTE);
	if not Assigned(screen) then
	begin
	  writeln('Couldn''t set video mode: ', SDL_GetError());
	  exit;
	end;

	// Setzt die Palette
	SDL_SetColors(screen, @colors[0], 0, 256);
	.
	.
	.
	.
</source>


== Siehe auch ==
[[SDL_Color]], [[SDL_Surface]], [[SDL_SetPalette]], [[SDL_SetVideoMode]]

[[Kategorie:SDL|SetColors]]