blob: d304bf8dd272c8cec894b74229823911b1284a96 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001P_SHORT
2=======
3
4NAME
5----
Zesstra18626972017-01-31 10:38:27 +01006
Zesstrad8673202020-06-13 16:26:59 +02007 P_SHORT
8 "short"
Zesstra18626972017-01-31 10:38:27 +01009
10DEFINIERT IN
11------------
Zesstra18626972017-01-31 10:38:27 +010012
Zesstrad8673202020-06-13 16:26:59 +020013 /sys/thing/description.h
Zesstra18626972017-01-31 10:38:27 +010014
15BESCHREIBUNG
16------------
Zesstra18626972017-01-31 10:38:27 +010017
Zesstrad8673202020-06-13 16:26:59 +020018 Diese Property enthaelt die Kurzbeschreibung eines Objektes bei Ansicht
19 *von aussen* als String. Fuer die Innen(kurz)ansicht von Raeumen muss man
20 P_INT_SHORT benutzen.
Zesstra18626972017-01-31 10:38:27 +010021
Zesstrad8673202020-06-13 16:26:59 +020022 Die Kurzbeschreibung darf *nicht* mit einem "\n" abgeschlossen sein (dies
23 wird von den zustaendigen Funktionen erledigt).
24 Aus historischen Gruenden wird ein Punkt ergaenzt, wenn das letzte
25 Zeichen kein Punkt, Ausrufezeichen oder Fragezeichen ist.
Zesstra18626972017-01-31 10:38:27 +010026
Zesstra90700fc2020-06-13 16:51:12 +020027 Setzt man diese Property auf 0, so wird das Objekt von Spielern nicht mehr
28 wahrgenommen (es wird in Inventaren nicht mehr angezeigt). Der Effekt ist
29 der eines "PAL-Feldes" ("Problem anderer Leute"). Es bleibt allerdings
30 ansprechbar, wenn Spieler eine ID des Objektes kennen. Diese koennen dann
31 damit alles anstellen, was sie sonst auch koennten. D.h. Objekte koennen
32 insb. mitgenommen, weggeworfen, untersucht oder ggf. auch angegriffen
33 werden und es kann angreifen.
34 Will man dies nicht, muss man das Objekt mit P_INVIS richtig unsichtbar
35 machen.
Zesstra18626972017-01-31 10:38:27 +010036
37BEMERKUNGEN
38-----------
Zesstra18626972017-01-31 10:38:27 +010039
Zesstrad8673202020-06-13 16:26:59 +020040 * In altem Code wird manchmal eine Closure als Wert (nicht als
41 Querymethode) eingetragen, welche einen String zurueckgibt. Dies ist
42 *deprecated* und sollte nicht mehr formuliert werden.
43
44 * Die Funktion, die die Kurzbeschreibung ausgibt (short()), filtert P_SHORT
45 durch process_string(). Dieses Feature ist *deprecated* und von der
46 Nutzung wird in neuem Code abgeraten.
47
48 * Soll eine dyn. Kurzbeschreibung geschaffen werden, bitte eine
Zesstra18626972017-01-31 10:38:27 +010049 F_QUERY_METHOD einsetzen oder short() passend ueberschreiben.
50
51BEISPIELE
52---------
Zesstrad8673202020-06-13 16:26:59 +020053
54.. code-block:: pike
Zesstra18626972017-01-31 10:38:27 +010055
56 // eine Axt sieht natuerlich so aus:
57 SetProp(P_SHORT, "Eine Axt");
58
59SIEHE AUCH
60----------
Zesstra18626972017-01-31 10:38:27 +010061
Zesstra90700fc2020-06-13 16:51:12 +020062 Aehnliches
63 :doc:`P_LONG`, :doc:`P_INT_SHORT`, :doc:`P_INVIS`,
64 :doc:`../lfun/short`
Zesstra18626972017-01-31 10:38:27 +010065
66
Zesstrad8673202020-06-13 16:26:59 +02006713.06.2020, Zesstra
Zesstra18626972017-01-31 10:38:27 +010068