blob: 944811e39e38c6ec78f2b43415663d8ae73dd2f4 [file] [log] [blame]
Zesstra3a261e52022-02-10 14:00:31 +01001Farben im Mud
2=============
3
4 Farben in der Ausgabe werden im MorgenGrauen bislang eher selten verwendet und die Einfaerbung meistens den Triggern des Clients ueberlassen.
5 Moechte man allerdings direkt etwas (farblich) markieren, stehen hierfuer einige Hervorhebungs-Tags zur Verfuegung, welche in ReceiveMsg() durch die passenden Steuercodes fuer den Terminaltypen des Clients ersetzt werden.
6
7 Hierfuer muss die Ausgabe lediglich durch ReceiveMsg() und deren Wrapper erfolgen, weitere Massnahmen sind weder noetig noch empfohlen.
8
9 Benutzt werden diese Tags, indem die in den auszugebenden Text zwischen zwei "%^" gesetzt werden: ```%^tag%^markierter Text%^endetag%^```. Hierbei sollte dann ReceiveMsg() allerdings auch der Zeilenumbruch ueberlassen werden.
10
11 Zu beachten ist, dass je nach Client bzw. seinem Terminaltyp nicht alle Tags benutzbar sind. Falls z.B. der Client kein ANSI untertuetzt und die Spielerin dieses abgeschaltet hat, werden diese Tags nicht gesendet oder als Tag "normal" behandelt.
12
13 Technisch erfolgt die Ersetzung mittels terminal_colour(), welches man nutzen koennte, um Farben in eine Ausgabe zu bringen, ohne ReceiveMsg & Co zu nutzen. Allerdings ist aktuell die Farbtabelle des Spielerobjekts nicht abfragbar.
14
15
16Tag-Liste
17---------
18
19Logische Hervorhebungen
20________________________
21
22 Zusaetzlich zu den direkt physischen Hervorhebungen (s.u.) gibt es noch logische Hervorhebungen, welche zu einer vom Spieler konfigurierbaren (TODO) Darstellung fuehren:
23
24 mention
25 Erwaehnungen eines Charnamens mit @Charname
26
27 normal
28 Normale Darstellung des Clients
29
30Physische Hervorhebungen
31________________________
32
33 Diese Hervorhebungen stellen direkt eine bestimmte Farbe oder Darstellung ein.
34
35 Vordergrundfarben (ANSI)
36 black, red, green, yellow, blue, purple, cyan, white
37
38 Hintergrundfarben (ANSI)
39 bg_black, bg_red, bg_green, bg_yellow, bg_blue, bg_purple, bg_cyan, bg_white
40
41 Sonstiges (VT100, ANSI)
42 bold (fettgedruckt), underlined (unterstrichen), blink (blinkend), invers (Vorder- und Hintergrundfarbe invertiert)
43
44
45Beispiel
46--------
47
48 .. code-block:: pike
49
50 this_player().ReceiveMsg(
51 "Zesstra wirft Dir einen %^red%^roten Eimer%^normal%^ an den Kopf.",
52 MT_LOOK, MA_EMOTE);
53
54
55SIEHE AUCH
56----------
57
58 :doc:`../lfun/ReceiveMsg`,
59 :doc:`../efun/terminal_colour`,
60 :doc:`../props/P_TTY`, :doc:`../props/P_TTY_TYPE`
61
62Letzte Aenderung: 10.22.2022
63