blob: df83b42279e60ab23a13f95169873b8fac4e1201 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001AddSounds()
2===========
3
4FUNKTION
5--------
6::
7
8 void AddSounds(string|string* keys, string|string*|mapping|closure desc);
9
10DEFINIERT IN
11------------
12::
13
14 /std/thing/description.c
15
16ARGUMENTE
17---------
18::
19
20 keys
21 String oder Array von Strings mit den Namen der Details.
22 desc
23 String, Mapping, String-Array oder Closure mit/zur Beschreibung.
24
25BESCHREIBUNG
26------------
27::
28
29 Diese Funktion entspricht dem AddDetail() fuer Standarddetails, nur
30 koennen hiermit Geraeusche realisiert werden:
31 Die Beschreibung der Details <keys> wird gesetzt. Wie die Details
32 bei der Untersuchung aussehen, haengt im wesentlichen vom Typ der
33 Beschreibung <desc> ab:
34 <desc> ist ein String.
35 Beim Untersuchen wird dieser String zurueckgegeben.
36 <desc> ist ein String-Array.
37 Beim Untersuchen wird zufaellig einer der Strings zurueckgegeben.
38 <desc> ist ein Mapping.
39 Das Mapping muss folgenden Aufbau haben:
40 ([0: "Defaulttext",
41 "rasse1": "r1text", ...]).
42
43 Falls fuer die Rasse des das Detail untersuchenden Spielers ein
44 Eintrag im Mapping existiert, wird der entsprechende Text
45 zurueckgegeben, ansonsten der Defaulttext. Auf diese Weise sind
46 rassenabhaengige Details moeglich. Siehe auch die Beispiele.
47 <desc> ist eine Closure.
48 In diesem Fall wird die Closure ausgefuehrt und das Ergebnis
49 zurueckgegeben. Die Closure bekommt dabei den Namen des Details
50 als Parameter uebergeben.
51
52 Fuer Geraeuschdetails koennen Forscherpunkte eingetragen werden.
53
54 Gerauesche koennen allgemein einen Raum oder Objekt zugeordnet werden:
55 dafuer muss man als <key> SENSE_DEFAULT uebergeben.
56
57 Spielerkommandos: "lausche", "lausch", "hoer", "hoere"
58
59BEISPIELE
60---------
61::
62
63 Ein kleines Beispiel fuer rassenabhaengige Gerauesche
64 AddSounds(SENSE_DEFAULT, "Die Zwergenmusik uebertoent alles!\n");
65 AddSounds(({"zwergenmusik","musik"}),
66 ([0 : "Seltsamer Krach!\n",
67 "zwerg": "Das klingt einfach fantastisch!\n"]));
68
69SIEHE AUCH
70----------
71::
72
73 Setzen: AddDetail(), AddReadDetail(), AddSmells(),
74 AddTouchDetail()
75 Loeschen: RemoveDetail(), RemoveReadDetail(), RemoveSmells(),
76 RemoveSounds(), RemoveTouchDetail()
77 Daten: P_DETAILS, P_READ_DETAILS, P_SMELLS, P_SOUNDS, P_TOUCH_DETAILS
78 Veraltet: AddSpecialDetail(), RemoveSpecialDetail(), P_READ_MSG
79 Sonstiges: GetDetail(), break_string()
80
8120.01.2015, Zesstra
82