AsuS Mta at 02:48, 9 December 2012

2012-12-09T02:48:14Z

← Older revision		Revision as of 02:48, 9 December 2012
Line 111:		Line 111:
	*Pekio123		*Pekio123

	[[es:~~cancelEvent~~]]		[[es:setElementPosition]]

AsuS Mta at 02:47, 9 December 2012

2012-12-09T02:47:56Z

← Older revision		Revision as of 02:47, 9 December 2012
Line 106:		Line 106:
	==See Also==		==See Also==
	{{Element functions}}		{{Element functions}}

			==Traductor==

			*Pekio123

			[[es:cancelEvent]]

AsuS Mta: Created page with "NOTOC {{Server client function}} Esta función cambia la posición del elemento a las coordenadas seleccionadas. ==Syntax== bool setElementPosition ( element ..."

2012-12-09T02:47:11Z

Created page with "__NOTOC__ {{Server client function}} Esta función cambia la posición del elemento a las coordenadas seleccionadas. ==Syntax== <syntaxhighlight lang="lua"> bool setElementPosition ( element ..."

New page

__NOTOC__
{{Server client function}}
Esta función cambia la posición del elemento a las coordenadas seleccionadas.

==Syntax==
<syntaxhighlight lang="lua">
bool setElementPosition ( element theElement, float x, float y, float z [, bool warp = true ] )
</syntaxhighlight>

===Argumentos obligatorios===
*'''theElement:''' El [Elemento] a mover
*'''x:''' La coordenada X de el destino
*'''y:''' La coordenada Y de el destino
*'''z:''' La coordenada Z de el destino

===Argumentos opcionales===
*'''warp:''' Teleportar a los jugador, esto hace que las animaciones ejecutadas en el momento de teleportacion se apaguen usar false para no paralas.

===Returns===
Envia ''true'' si la función se completo, ''false'' si no se completo.

==Example==
<section name="Example 1" class="server" show="true">
This example adds a "setpos" command to console, which allows setting of a player's position.
<syntaxhighlight lang="lua">
function consoleSetPlayerPosition ( source, commandName, posX, posY, posZ )
setElementPosition ( source, posX, posY, posZ )
end
addCommandHandler ( "setpos", consoleSetPlayerPosition )
</syntaxhighlight>
</section>
<section name="Example 2" class="client" show="false">
This example adds a "setpos" command to console, which allows setting of the local player's position.
<syntaxhighlight lang="lua">
function consoleSetPlayerPosition ( commandName, posX, posY, posZ )
setElementPosition ( getLocalPlayer(), posX, posY, posZ )
end
addCommandHandler ( "setpos", consoleSetPlayerPosition )
</syntaxhighlight>
</section>
<section name="Example 3" class="server" show="false">
This example enables a player to type /warpto <playername> to warp to them. If the player being warped to is in a vehicle with a free passenger seat, it will warp into the vehicle.
<syntaxhighlight lang="lua">
function consoleWarpTo ( sourcePlayer, commandName, player2nick )
-- Make sure required parameters are set
if ( not sourcePlayer or not player2nick ) then return end
-- Setup the variables we will be using for teleportation
local x, y, z, r, d = 0, 0, 0, 0, 2.5
-- Grab the element identifier of the player we are trying to warp to
local player2 = getPlayerFromNick ( player2nick )
-- Make sure it exists!
if ( player2 ) then
-- Is the player we're warping to in a vehicle?
if ( isPlayerInVehicle ( player2 ) ) then
-- Indeed they are, let's get the vehicle information such as the vehicle element itself, and the seats it's got.
local player2vehicle = getPlayerOccupiedVehicle ( player2 )
local numseats = getVehicleMaxPassengers ( player2vehicle )
local i = 0
-- Loop over the seats to see if there's a free one
while ( i < numseats ) do
if ( getVehicleOccupant ( player2vehicle, i ) ) then
-- This seat isn't free, go ahead and check the next one
i = i + 1
else
-- This seat is free, get out of the loop
break
end
end
-- Check if 'i' is lower than the number of seats. If it is, it means it's the number of a free seat
if ( i < numseats ) then
-- Teleport the player into the seat
warpPlayerIntoVehicle ( sourcePlayer, player2vehicle, i )
else
-- There are no free seats, tell the player that.
outputChatBox ( "Sorry, the player's vehicle is full (" .. getVehicleName ( player2vehicle ) .. " " .. i .. "/" .. numseats .. ")", sourcePlayer )
end
else
-- The player isn't in a vehicle, let's get the player's position and warp to them.
x, y, z = getElementPosition ( player2 )
r = getPlayerRotation ( player2 )
-- Make sure we get interior data, they might be inside one!
interior = getElementInterior ( player2 )
dimension = getElementDimension ( player2 )
-- Do some funky math to make sure that we dont teleport inside of them (get us both stuck inside each other)
x = x - ( ( math.cos ( math.rad ( r + 90 ) ) ) * d )
y = y - ( ( math.sin ( math.rad ( r + 90 ) ) ) * d )
-- Set a few timers for setting interiors, dimensions and positions
setTimer ( setElementInterior, 800, 1, sourcePlayer, interior )
setTimer ( setElementDimension, 900, 1, sourcePlayer, dimension )
setTimer ( setElementPosition, 1000, 1, sourcePlayer, x, y, z )
setTimer ( setPlayerRotation, 1000, 1, sourcePlayer, r )
-- Fade the camera to make it look nicer
fadeCamera ( sourcePlayer, false, 1, 0, 0, 0 )
-- Fade it back once it's all complete!
setTimer ( fadeCamera, 1000, 1, sourcePlayer, true, 1 )
end
else
-- No player by the specified name was found, tell the warper this.
outputChatBox ( "No such player.", sourcePlayer )
end
end
addCommandHandler ( "warpto", consoleWarpTo )
</syntaxhighlight>
</section>

==See Also==
{{Element functions}}

ES/SetElementPosition - Revision history

AsuS Mta at 02:48, 9 December 2012

AsuS Mta at 02:47, 9 December 2012

AsuS Mta: Created page with "__NOTOC__ {{Server client function}} Esta función cambia la posición del elemento a las coordenadas seleccionadas. ==Syntax== bool setElementPosition ( element ..."

AsuS Mta: Created page with "NOTOC {{Server client function}} Esta función cambia la posición del elemento a las coordenadas seleccionadas. ==Syntax== bool setElementPosition ( element ..."