MoveObject: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{Server client function}} | {{Server client function}} | ||
__NOTOC__ | __NOTOC__ | ||
This function will smoothly move an object from its current position | This function will smoothly move an object from its current position to a specified rotation and position. | ||
==Syntax== | ==Syntax== | ||
| Line 28: | Line 26: | ||
==Example== | ==Example== | ||
< | '''Example 1:''' This example moves every object in the game up 100 places in ten seconds. | ||
This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds. | <syntaxhighlight lang="lua"> | ||
allObjects = getElementsByType ( "object" ) | |||
for key,object in pairs(allObjects) do | |||
local origX,origY,origZ = getElementPosition ( object ) --get the origanal position | |||
local newZ = origZ + 100 --make a new z position | |||
moveObject ( object, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds. | |||
end | |||
</syntaxhighlight> | |||
'''Example 2:''' This example created a model (of a bed) near a player called ''someguy'', if they exist in the game. It will then move the model towards the player over 3 seconds. | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- Find a player called 'someguy' | -- Find a player called 'someguy' | ||
| Line 48: | Line 55: | ||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Object functions}} | {{Object functions}} | ||
Revision as of 17:09, 29 August 2007
This function will smoothly move an object from its current position to a specified rotation and position.
Syntax
bool moveObject ( object theObject, int time, float targetx, float targety, float targetz, [ float moverx, float movery, float moverz ] )
Required Arguments
- theObject: The object that will be moved.
- time: The time in milliseconds the object will arrive at the destination.
- targetx: The X value of the target position
- targety: The Y value of the target position
- targetz: The Z value of the target position
Optional Arguments
- moverx: The X value of the rotation relative to its current rotation, which will be added on.
- movery: The Y value of the relative to its current rotation, which will be added on.
- moverz: The Z value of the relative to its current rotation, which will be added on.
Relative rotation arguments allow for an object to spin multiple times within a single move.
Returns
Returns true if the function moved the object succesfully, and returns false otherwise.
Example
Example 1: This example moves every object in the game up 100 places in ten seconds.
allObjects = getElementsByType ( "object" ) for key,object in pairs(allObjects) do local origX,origY,origZ = getElementPosition ( object ) --get the origanal position local newZ = origZ + 100 --make a new z position moveObject ( object, 10000, origX, origY, newZ ) --move the object to this position in 10 seconds. end
Example 2: This example created a model (of a bed) near a player called someguy, if they exist in the game. It will then move the model towards the player over 3 seconds.
-- Find a player called 'someguy' someGuy = getPlayerFromNick ( "someguy" ) -- If a player called someguy was found then if ( someGuy ) then -- Get the player's position x, y, z = getElementPosition ( someGuy ) -- Create a bed (1700) object near to the player bed = createObject ( 1700, x + 5, y, z ) -- Move the bed towards the player over 3 seconds (3000 milliseconds) moveObject ( bed, 3000, x, y, z ) -- Tell the player in the chat box outputChatBox ( "Moving a bed towards you!", someGuy ) else -- Tell everyone that a player called 'someguy' could not be found outputChatBox ( "Player someguy doesn't exist" ) end
See Also