StopObject
Jump to navigation
Jump to search
This will allow you to stop an object that is currently moving.
Syntax
bool stopObject ( element object )
Required Arguments
- theobject: This is the object whose movement you wish to stop
Returns
Returns true if successful, false otherwise.
Example
This will allow you to toggle the random movement of a staircase object model and stop it immediately with the stopObject command.
addCommandHandler ( "toggleobjectmove", "objectMoveControl" )
function objectMoveControl ( player, commandName, state )
--This command handler activate on text "toggleobjectmove" in
--the console. It also asks that the player define the varible
--'state' after the commandname
if state == "on" then
outputChatBox ( "Moving object randomly" )
mytimer = setTimer ( "randomObjectMovement", 2250, 0 )
--if player type "on" for state, then we turn on the timer that
--triggers the function randomObjectMovement. It triggers the
--function every 2 1/4 seconds for an infinite amount of times,
--since times is defined as 0.
elseif state == "off" then
outputChatBox ( "Stopping object movement" )
killTimer ( mytimer )
stopObject ( myobject )
--If player typed "off" for state, then stop the object movement
--immediately and kill the random object movement timer, which
--triggers the randomObjectMovement function
else
outputChatBox ( "must define object state as 'on' or 'off'" )
--If player said something besides "on" or "off" for state, do nothing
end
end
function randomObjectMovement ()
curx, cury, curz = getElementPosition ( myobject )
--Get the xyz position of myobject
xmath = randInt(1,2)
if xmath == 1 then
newx = curx + randInt(1,3)
else
newx = curx - randInt(1,3)
end
ymath = randInt(1,2)
if ymath == 1 then
newy = cury + randInt(1,3)
else
newy = cury - randInt(1,3)
end
zmath = randInt(1,2)
if zmath == 1 then
newz = curz + randInt(1,3)
else
newz = curz - randInt(1,3)
end
--Decide randomly whether to add or subtract from the coordinates,
--and randomly add or subtract 1, 2, or 3
moveObject ( myobject, 2000, newx, newy, newz )
--Tell the object to move to our new coordinates in 2 seconds time
end
See Also
- attachElements
- createElement
- destroyElement
- detachElements
- getAttachedElements
- getElementAlpha
- getElementAttachedOffsets
- getElementAttachedTo
- getElementByIndex
- getElementByID
- getElementChild
- getElementChildren
- getElementChildrenCount
- getElementCollisionsEnabled
- getElementColShape
- getElementData
- getAllElementData
- hasElementData
- getElementDimension
- getElementHealth
- getElementID
- getElementInterior
- getElementMatrix
- getElementModel
- getElementParent
- getElementPosition
- getElementRotation
- getElementsByType
- getElementsWithinColShape
- getElementsWithinRange
- getElementType
- getElementVelocity
- getLowLODElement
- getRootElement
- isElement
- isElementAttached
- isElementCallPropagationEnabled
- isElementDoubleSided
- isElementFrozen
- isElementInWater
- isElementLowLOD
- isElementWithinColShape
- isElementWithinMarker
- setElementAlpha
- setElementAngularVelocity
- getElementAngularVelocity
- setElementAttachedOffsets
- setElementCallPropagationEnabled
- setElementCollisionsEnabled
- setElementData
- setElementDimension
- setElementDoubleSided
- setElementFrozen
- setElementHealth
- setElementID
- setElementInterior
- setElementModel
- setElementParent
- setElementPosition
- setElementRotation
- setElementVelocity
- setLowLODElement
- getPedContactElement
- getResourceDynamicElementRoot
- getResourceRootElement
-- leave this unless you complete the function