CustomMessage

Aus Clonk Wiki

bool CustomMessage(string szText, object pObj, int iPlr, int iOffX, int iOffY, DWORD dwColor, id idMenuDecoId, string sSymbol, int iFlags);

Gibt eine benutzerdefinierte Textnachricht aus.

Parameter

szText: Nachricht, die ausgegeben wird.

pObj: Objekt, an dessen Position die Nachricht gezeichnet wird. Bei 0 ist dies die Mitte des Viewports des Angegebenen Spielers.

iPlr: Spieler, in dessen Viewport die Nachricht ausgegeben wird. Bei NO_OWNER erscheint die Nachricht für alle Spieler.

iOffX, iOffY: Verschiebung der Nachricht horizontal bzw. vertikal von Ursprungspunkt(pObj oder Mitte des Viewports) in Pixeln.

dwColor: Farbe der Nachricht. 0 für weiß (0xffffff). (Für schwarz muss also ein Wert leicht darüber angegeben werden, bespielsweise RGB(0, 0, 1))

idMenuDecoId: Id der Menüdekoration: Sie wird um die Nachricht gezeichnet.

sSymbol: Das Symbol der Nachricht. Entweder eine Id ("FLNT") oder Portrait ("Portrait:[C4ID]::[Farbe(hex.)]::[Nummer]")

iFlags: Zusätzliche Flags, z.B. MSG_NoLinebreak (Kein Auto-Zeilenumbruch)

Weitere Flags:

MSG_Bottom

MSG_Multiple

MSG_Top

MSG_Left

MSG_Right

MSG_HCenter

MSG_VCenter

MSG_DropSpeech

MSG_WidthRel

MSG_XRel

MSG_YRel

Beispiel

Zeigt "Hallo!" über dem Clonk des ersten Spielers für alle Spieler sichtbar an. Dieser Text ist um 20px von der "normalen" Position nach rechts verschoben und 5px nach unten. Außerdem ist sie rot und mit dem Symbol des Goldes versehen.

Anmerkung

Im Gegensatz zu den anderen Nachrichtenfunktionen können keine zusätzlichen Parameter als Format-Strings angegeben werden. Stattdessen kann die Funktion Format benutzt werden. CustomMessage ist eine Funktion die erst mit Clonk Rage zur Verfügung gestellt wurde.