Kategorie: Objekte
/ Darstellung
Ab Engineversion: 1.0 OC
GetClrModulation
Beschreibung
Fragt die Farbmodulation des aufrufenden Objekts ab. Diese ist ein Farbwert, der multiplikativ (oder auch additiv, bei entsprechend aktiviertem BlitMode in der DefCore) aufgerechnet wird. Für weitere Hinweise siehe auch SetClrModulation().
Syntax
int GetClrModulation(int overlay_id);
Parameter
- overlay_id:
- [opt] Wenn angegeben, wird stattdessen die Farbmodulation dieses Grafikoverlays abgefragt. Das Overlay muss vorher mit SetGraphics erstellt worden sein.
Anmerkung
Wurde keine Modulation durchgeführt, so ist der Rückgabewert dieser Funktion -1 (analog zu RGBa(255,255,255,255)).
Beispiel
global func SetObjAlpha(byAlpha, obj)
{
var dwClrMod = obj->GetClrModulation();
if (!dwClrMod)
dwClrMod = byAlpha << 24;
else
dwClrMod = dwClrMod & RGB(255,255,255) | byAlpha << 24;
return(obj->SetClrModulation(dwClrMod));
}
Globale Funktion: Setzt nur den Alphawert der Farbmodulation eines Objekts.