SetClrModulation

Kategorie: Objekte / Darstellung
Ab Engineversion: 4.9.1.0 GWE (erweitert ab 4.9.6.0 CR)

Beschreibung

Ändert die Farbmodulation eines Objekts. Diese ist ein Farbwert, der multiplikativ aufgerechnet wird. Bei RGB(255,0,0) würden also nur die Rotanteile der Grafik gezeichnet werden. RGBa(255,255,255,128) würde die Grafik halbtransparent machen (sofern Alphaaddition nicht in den Grafikoptionen deaktiviert ist).

Syntax

bool SetClrModulation (int dwClr, object pObj, int iOverlayID);

Parameter

dwClr:
Neue Farbe, mit der moduliert wird. Wenn 0 angegeben wird, wird die Modulation deaktiviert. Für eine völlige Schwarzfärbung sollte also ein knapp darüber liegender Wert wie RGB(0,0,1); verwendet werden.
pObj:
Objekt, dessen Färbung verändert werden soll. 0 bei lokalem Aufruf.
iOverlayID:
[opt] Wenn angegeben, wird stattdessen die Farbmodulation dieses Grafikoverlays gesetzt. Das Overlay muss vorher mit SetGraphics erstellt worden sein. Ab CR.

Beispiel

SetClrModulation(RGBa(128,128,255,128), GetCursor());
Färbt den ausgewählten Clonk des ersten Spielers leicht bläulich ein und macht ihn halbtransparent.
Siehe auch: GetClrModulation, RGB, RGBa, SetColorDw, SetGamma, SetObjectBlitMode
Sven2, April 2002