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