/docs/sdk/script/fn/SetPlrShowControl.xml
XML | 57 lines | 57 code | 0 blank | 0 comment | 0 complexity | 611028a6ac75af13af8e344fec414203 MD5 | raw file
Possible License(s): WTFPL, 0BSD, LGPL-2.1, CC-BY-3.0
1<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
2<!DOCTYPE funcs SYSTEM "../../../clonk.dtd">
3<?xml-stylesheet type="text/xsl" href="../../../clonk.xsl"?>
4<funcs>
5 <func>
6 <title>SetPlrShowControl</title>
7 <category>Spieler</category>
8 <version>4.6.5.0 CP</version>
9 <syntax>
10 <rtype>bool</rtype>
11 <params>
12 <param><type>int</type><name>iPlr</name><desc>Spieler, dessen Tasten darzustellen sind.</desc></param>
13 <param><type>string</type><name>szDefString</name><desc>Spezifikation der darzustellenden Tasten.</desc></param>
14 </params>
15 </syntax>
16 <desc>Steuert die grafische Darstellung der Clonk-Steuerungstasten eines Spielers in seinem Sichtfenster.<br/><br/>
17 Es k�nnen die folgenden Tasten angezeigt werden:
18 <table>
19 <rowh><col>Nummer</col><col>Bedeutung</col></rowh>
20 <row><col>0</col><col>Cursor Rechts</col></row>
21 <row><col>1</col><col>Cursor Umschalt</col></row>
22 <row><col>2</col><col>Cursor Links</col></row>
23 <row><col>3</col><col>Werfen</col></row>
24 <row><col>4</col><col>Springen</col></row>
25 <row><col>5</col><col>Graben</col></row>
26 <row><col>6</col><col>Links</col></row>
27 <row><col>7</col><col>Stopp</col></row>
28 <row><col>8</col><col>Rechts</col></row>
29 <row><col>9</col><col>Optionen</col></row>
30 </table>
31 F�r jede Taste kann einzeln angegeben werden, ob und wie sie angezeigt werden soll. Dabei gibt es f�r jede Taste drei Optionen, die angegeben werden k�nnen:
32 <ul>
33 <li>Ob sie angezeigt werden soll</li>
34 <li>Ob die Taste beschriftet sein soll</li>
35 <li>Ob die Beschriftung blinken soll</li>
36 </ul>
37 Entsprechend gibt es 3 Blocks von Optionen. Jeder dieser Blocks besteht dabei aus 10 Buchstaben, wobei "_" und " " f�r "Nein" und jeder andere Buchstabe f�r "Ja" steht (siehe Beispiel).
38 </desc>
39 <examples>
40 <example>
41 <code>SetPlrShowControl(0, "____4_678_ __________");</code>
42 <text>Zeigt f�r Spieler 0 die Tasten "Springen", "Links", "Stopp" und "Rechts" an. Die Nummern werden zur Verdeutlichung der angezeigten Tasten verwendet (vergleiche Tabelle). Um die Bl�cke voneinander abzuheben, wird im 1. und 3. "_", im 2. dagegen " " benutzt.</text>
43 <code>SetPlrShowControl(0, "____4_678_ 4 678 ____4_678_");</code>
44 <text>Erg�nzt die Darstellung um eine blinkende Beschriftung.</text>
45 <code>SetPlrShowControl(0, "____4_678_ 4 678 ____4_____");</code>
46 <text>Nur die Beschriftung der Taste "Springen" blinkt.</text>
47 <code>SetPlrShowControl(0, "01234567890123456789__________");</code>
48 <text>Der gesamte Steuerungsblock wird mit Beschriftung angezeigt.</text>
49 </example>
50 </examples>
51 <related>
52 <funclink>SetPlrShowControlPos</funclink>
53 <funclink>SetPlrShowCommand</funclink>
54 </related>
55 </func>
56 <author>PeterW</author><date>Juni 2003</date>
57</funcs>