AttachObjectToObject

From SA-MP Wiki

Jump to: navigation, search


AttachObjectToObject was added in SA-MP 0.3d This function was added in SA-MP 0.3d and will not work in earlier versions!


Description:

You can use this function to attach objects to other objects. The objects will folow the main object.


Parameters:
(objectid, attachtoid, Float:OffsetX, Float:OffsetY, Float:OffsetZ, Float:RotX, Float:RotY, Float:RotZ, SyncRotation = 1)
objectidThe object to attach to another object.
attachtoidThe object to attach the object to.
Float:OffsetXThe distance between the main object and the object in the X direction.
Float:OffsetYThe distance between the main object and the object in the Y direction.
Float:OffsetZThe distance between the main object and the object in the Z direction.
Float:RotXThe X rotation between the object and the main object.
Float:RotYThe Y rotation between the object and the main object.
Float:RotZThe Z rotation between the object and the main object.
SyncRotation If set to 0, objectid's rotation will not change with attachtoid's.


Return Values:

  • 1: The function executed successfully.
  • 0: The function failed to execute. This means the first object (objectid) does not exist. There are no internal checks to verify that the second object (attachtoid) exists.


Image:32px-Ambox_warning_orange.png

Notes

  • Both objects need to be created before attempting to attach them.
  • There is no player-object version of this function (AttachPlayerObjectToObject), meaning it will not be supported by streamers.


Example Usage:

new objectid = CreateObject(...);
new attachtoid = CreateObject(...);
 
AttachObjectToObject(objectid, attachtoid, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1);

Related Functions

The following functions may be useful, as they are related to this function in one way or another.


Personal tools
In other languages