AttachObjectToObject

From SA-MP Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 10:00, 21 August 2015
OstGot (Talk | contribs)

← Previous diff
Current revision
OstGot (Talk | contribs)

Line 32: Line 32:
{{RelatedFunctions}} {{RelatedFunctions}}
 +{{AttachObjectToPlayer}}
 +{{AttachObjectToVehicle}}
 +{{AttachPlayerObjectToPlayer}}
 +
{{CreateObject}} {{CreateObject}}
{{DestroyObject}} {{DestroyObject}}
Line 51: Line 55:
{{GetPlayerObjectPos}} {{GetPlayerObjectPos}}
{{GetPlayerObjectRot}} {{GetPlayerObjectRot}}
-{{AttachPlayerObjectToPlayer}} 
[[Category:Scripting Functions]] [[Category:Scripting Functions]]

Current revision



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