GetClrModulation

Kategorie: Objekte / Darstellung
Ab Engineversion: 4.9.5.0 CE (erweitert ab 4.9.6.0 CR)

Beschreibung

Fragt die Farbmodulation eines 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 (object pObj, int iOverlayID);

Parameter

pObj:
Objekt, dessen Färbung abgefragt werden soll. 0 bei lokalen Aufruf.
iOverlayID:
[opt] Wenn angegeben, wird stattdessen die Farbmodulation dieses Grafikoverlays abgefragt. Das Overlay muss vorher mit SetGraphics erstellt worden sein. Ab CR.

Anmerkung

Ist der Rückgabewert dieser Funktion 0, so wurde keine Farbmodulation durchgeführt (analog zu RGBa(255,255,255,0)).

Beispiel

global func SetObjAlpha(var byAlpha, pObj)
  {
  var dwClrMod=GetClrModulation(pObj);
  if (!dwClrMod) dwClrMod = byAlpha<<24; else dwClrMod = dwClrMod & 16777215 | byAlpha<<24;
  return(SetClrModulation(dwClrMod, pObj));
  }
Globale Funktion: Setzt nur den Alphawert der Farbmodulation eines Objekts.
Siehe auch: GetColorDw, RGB, RGBa, SetClrModulation, SetGamma
Sven2, Fabruar 2004