DE/setElementInterior: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Server client function}} __NOTOC__ Diese Funktion dient dazu, das Interior eines Elements zu bestimmen. Ein Interior ist der aktuelle Platz (Innenräume), 0 ist...")
 
 
(4 intermediate revisions by the same user not shown)
Line 5: Line 5:
==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setElementInterior ( element dasElement, int Interior [, float x, float y, float z] )
bool setElementInterior ( element theElement, int Interior [, float x, float y, float z] )
</syntaxhighlight>
</syntaxhighlight>


===Benötigte Argumente===
===Benötigte Argumente===
*'''dasElement:''' Das Element, für welches das Interior bestimmt werden soll.
*'''theElement:''' Das Element, für welches das Interior bestimmt werden soll.
*'''Interior:''' Das Interior, welches für das Element gesetzt werden soll. Gültige Werte sind 0 bis 255.
*'''Interior:''' Das Interior, welches für das Element gesetzt werden soll. Gültige Werte sind 0 bis 255.


===Optionale Argumente===
===Optionale Argumente===
HINWEIS: Bei der Verwendung von optionalen Argumenten, müssen alle Argumente vor dem gewünschten Argument bestimmt werden. Mehr Informationen unter [[DE/Optionale_Argumente|Optionale Argumente]].
{{DE/OptionalArg}}
* '''x:''' Eine [[DE/Float|Gleitkomma-Zahl]], welche die X-Koordinate der Map repräsentiert.
* '''x:''' Eine [[DE/Float|Gleitkomma-Zahl(Float)]], welche die X-Koordinate der Map repräsentiert.
* '''y:''' Eine [[DE/Float|Gleitkomma-Zahl]], welche die Y-Koordinate der Map repräsentiert.
* '''y:''' Eine [[DE/Float|Gleitkomma-Zahl(Float)]], welche die Y-Koordinate der Map repräsentiert.
* '''z:''' Eine [[DE/Float|Gleitkomma-Zahl]], welche die Z-Koordinate der Map repräsentiert.
* '''z:''' Eine [[DE/Float|Gleitkomma-Zahl(Float)]], welche die Z-Koordinate der Map repräsentiert.


===Rückgaben===
===Rückgaben===
Die Rückgabe ist ''true'', wenn '''dasElement''' und '''Interior''' gültige Werte sind, ansonsten ist die Rückgabe ''false''.
Die Rückgabe ist ''true'', wenn '''theElement''' und '''Interior''' gültige Werte sind, ansonsten ist die Rückgabe ''false''.


==Beispiel==
==Beispiel==
Line 25: Line 25:
In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.
In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function interior ( source, befehlName, interior ) -- source ist der Spieler, befehlName entspricht dem Befehlsname (interior), interior ist die gewuenschte Interior-ID.
function interior ( source, commandName, interior ) -- source ist der Spieler, commandName entspricht dem Befehlsname (interior), interior ist die gewuenschte Interior-ID.
   --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
   --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
   if ( interior ) then
   if ( interior ) then
Line 42: Line 42:
In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.
In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function interior ( befehlName, interior ) -- Der Spieler wird nicht angegeben, da er weiter unten mit getLocalPlayer() bestimmt wird, interior ist die gewuenschte Interior-ID.
function interior ( commandName, interior ) -- Der Spieler wird nicht angegeben, da er weiter unten mit getLocalPlayer() bestimmt wird, commandName entspricht dem Befehlsname (interior), interior ist die gewuenschte Interior-ID.
   --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
   --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
   if ( interior ) then
   if ( interior ) then

Latest revision as of 12:00, 17 September 2012

Diese Funktion dient dazu, das Interior eines Elements zu bestimmen. Ein Interior ist der aktuelle Platz (Innenräume), 0 ist die standard GTA-Map.

Syntax

bool setElementInterior ( element theElement, int Interior [, float x, float y, float z] )

Benötigte Argumente

  • theElement: Das Element, für welches das Interior bestimmt werden soll.
  • Interior: Das Interior, welches für das Element gesetzt werden soll. Gültige Werte sind 0 bis 255.

Optionale Argumente

HINWEIS: Bei der Verwendung von optionalen Argumenten, müssen alle Argumente vor dem gewünschten Argument bestimmt werden. Mehr Informationen unter Optionale Argumente.

Rückgaben

Die Rückgabe ist true, wenn theElement und Interior gültige Werte sind, ansonsten ist die Rückgabe false.

Beispiel

Click to collapse [-]
Server

In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.

function interior ( source, commandName, interior ) -- source ist der Spieler, commandName entspricht dem Befehlsname (interior), interior ist die gewuenschte Interior-ID.
  --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
  if ( interior ) then
    --Der Wert von interior ist gueltig, also wird der Spieler in das gewaehlte Interior teleportiert.
    setElementInterior ( source, interior, 2233.91, 1714.73, 1011.38 )
  else
    --Der Wert von interior ist ungueltig, also wird der Spieler in das Interior 0 gesetzt, jedoch nicht an eine neue Stelle teleportiert.
    setElementInterior ( source, 0 )
  end
end
addCommandHandler ( "interior", interior )
Click to collapse [-]
Client

In diesem Beispiel wird ein Spieler in das gewählte Interior (1) teleportiert, wenn er /interior 1 eintippt.

function interior ( commandName, interior ) -- Der Spieler wird nicht angegeben, da er weiter unten mit getLocalPlayer() bestimmt wird, commandName entspricht dem Befehlsname (interior), interior ist die gewuenschte Interior-ID.
  --Ueberpruefung, ob eine Interior-ID gesetzt wurde.
  if ( interior ) then
    --Der Wert von interior ist gueltig, also wird der Spieler in das gewaehlte Interior teleportiert.
    setElementInterior ( getLocalPlayer(), interior, 2233.91, 1714.73, 1011.38 )
  else
    --Der Wert von interior ist ungueltig, also wird der Spieler in das Interior 0 gesetzt, jedoch nicht an eine neue Stelle teleportiert.
    setElementInterior ( getLocalPlayer(), 0 )
  end
end
addCommandHandler ( "interior", interior )

Siehe auch