StopObject: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Ransom's correction was fine)
Line 1: Line 1:
{{Needs_Checking|This had stuff put by someone else that said it stops elements but its called stopobject so I wrote it for objects and see also is defined as object category. Not sure? --[[User:Ransom|Ransom]] 20:54, 11 April 2007 (CDT)}}
__NOTOC__  
__NOTOC__  
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->

Revision as of 16:04, 8 July 2007

This will allow you to stop an object that is currently moving.

Syntax

bool stopObject ( object theobject )

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 )
--On "toggleobjectmove" in console, activate this command, which also asks the player to define the value for the varible 'state'. 
	if state == "on" then
	outputChatBox ( "Moving object randomly" )
	mytimer = setTimer ( "randomObjectMovement", 2250, 0 )
	--if player types "on" for the state varible, turn on the timer, which triggers a funciton called randomObjectMovement that asks the object to move whenever it is called (not included for this example). The timer runs every 2 1/4 seconds for 0 times, which means it runs infintely.
	elseif state == "off" then
	outputChatBox ( "Stopping object movement" )
	killTimer ( mytimer )
	stopObject ( myobject )
	--If player typed "off" for state, stop the object movement immediately and kill the randomObjectMovement 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

See Also