DE/setElementInterior: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(3 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==

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