SetObjectRotation

From Multi Theft Auto: Wiki
Revision as of 08:12, 9 September 2006 by Ransom (talk | contribs)
Jump to navigation Jump to search


Allows you to change an objects rotation while playing a map. The object can be from the map file or created in a script.

Syntax

bool setObjectRotation ( element object, float rx, float ry, float rz )        

Required Arguments

  • Object: The object to be rotated
  • rx: Rotation X value
  • ry: Rotation Y value
  • rz: Rotation Z value

Returns

Returns true if successful, false otherwise.

Example

In this example, I refer to an object in the mapfile with the ID "pirateship":

<object id="Pirate Ship" posX="-1627.319092" posY="128.543411" posZ="6.581001" rotX="-0.760854" rotY="2.421000" rotZ="0.851000" model="8493"/>
addEventHandler ( "onMapLoad", root, "onMapLoad" )
function onMapLoad ( name, root ) 
rx = 0
ry = 0
rz = 0 -- predefined varibles, for math code below
pirateship = getElementByID ( "pirateship" ) --assign element named 'pirateship' in map file to varible              
end

addCommandHandler ( "increaserotations", "chatboxShipRotateLeft" ) --On console command 'increaserotations', execute code
function chatboxShipRotateLeft ( playerSource, commandName )
outputChatBox ( "Rotational values increased" )
rx = rx + 10
ry = ry + 10
rz = rz + 10 -- rotations = rotations + 10
setObjectRotation ( pirateship, rx, ry, rz ) --Changed rotation is applied
end      

addCommandHandler ( "decreaserotations", "chatboxShipRotateRight" ) --Repeat and subtracted values to decrease rotations
function chatboxShipRotateRight ( playerSource, commandName )
outputChatBox ( "Rotational values decreased" ) 
rx = rx - 10
ry = ry - 10
rz = rz - 10 
setObjectRotation ( pirateship, rx, ry, rz )
end

See Also