<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<!DOCTYPE funcs SYSTEM "../../../clonk.dtd">
<?xml-stylesheet type="text/xsl" href="../../../clonk.xsl"?>
<funcs>
	<func>
		<title>SetPlrShowControl</title>
		<category>Spieler</category>
		<version>4.6.5.0 CP</version>
		<syntax>
			<rtype>bool</rtype>
			<params>
				<param><type>int</type><name>iPlr</name><desc>Spieler, dessen Tasten darzustellen sind.</desc></param>
				<param><type>string</type><name>szDefString</name><desc>Spezifikation der darzustellenden Tasten.</desc></param>
			</params>
		</syntax>
		<desc>Steuert die grafische Darstellung der Clonk-Steuerungstasten eines Spielers in seinem Sichtfenster.<br/><br/>
          Es können die folgenden Tasten angezeigt werden:
          <table>
            <rowh><col>Nummer</col><col>Bedeutung</col></rowh>
            <row><col>0</col><col>Cursor Rechts</col></row>
            <row><col>1</col><col>Cursor Umschalt</col></row>
            <row><col>2</col><col>Cursor Links</col></row>
            <row><col>3</col><col>Werfen</col></row>
            <row><col>4</col><col>Springen</col></row>
            <row><col>5</col><col>Graben</col></row>
            <row><col>6</col><col>Links</col></row>
            <row><col>7</col><col>Stopp</col></row>
            <row><col>8</col><col>Rechts</col></row>
            <row><col>9</col><col>Optionen</col></row>
          </table>
          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:
          <ul>
          	<li>Ob sie angezeigt werden soll</li>
          	<li>Ob die Taste beschriftet sein soll</li>
          	<li>Ob die Beschriftung blinken soll</li>
          </ul>
          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).
	    </desc>
		<examples>
			<example>
				<code>SetPlrShowControl(0, "____4_678_          __________");</code>
				<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>
				<code>SetPlrShowControl(0, "____4_678_    4 678 ____4_678_");</code>
				<text>Ergänzt die Darstellung um eine blinkende Beschriftung.</text>
				<code>SetPlrShowControl(0, "____4_678_    4 678 ____4_____");</code>
				<text>Nur die Beschriftung der Taste "Springen" blinkt.</text>
				<code>SetPlrShowControl(0, "01234567890123456789__________");</code>
				<text>Der gesamte Steuerungsblock wird mit Beschriftung angezeigt.</text>
			</example>
		</examples>
	    <related>
	      <funclink>SetPlrShowControlPos</funclink>
	      <funclink>SetPlrShowCommand</funclink>
	    </related>
	</func>
	<author>PeterW</author><date>Juni 2003</date>
</funcs>