note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
AttachObjectToObject
Description
You can use this function to attach objects to other objects. The objects will follow the main object.
| Name | Description |
|---|---|
| objectid | The object to attach to another object. |
| parentid | The object to attach the object to. |
| Float:offsetX | The distance between the main object and the object in the X direction. |
| Float:offsetY | The distance between the main object and the object in the Y direction. |
| Float:offsetZ | The distance between the main object and the object in the Z direction. |
| Float:rotationX | The X rotation between the object and the main object. |
| Float:rotationY | The Y rotation between the object and the main object. |
| Float:rotationZ | The Z rotation between the object and the main object. |
| bool:syncRotation | If set to false, objectid's rotation will not change with attachtoid's. |
Returns
true - The function executed successfully.
false - 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.
Examples
new gObjectId = CreateObject(...);
new gAttachToId = CreateObject(...);
AttachObjectToObject(gObjectId, gAttachToId, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, true);
Notes
tip
Both objects need to be created before attempting to attach them.
tip
There is no player-object version of this function in SA-MP.
But there is AttachPlayerObjectToObject in open.mp
Related Functions
- AttachObjectToPlayer: Attach an object to a player.
- AttachObjectToVehicle: Attach an object to a vehicle.
- AttachPlayerObjectToPlayer: Attach a player object to a player.
- CreateObject: Create an object.
- DestroyObject: Destroy an object.
- IsValidObject: Checks if a certain object is vaild.
- MoveObject: Move an object.
- StopObject: Stop an object from moving.
- SetObjectPos: Set the position of an object.
- SetObjectRot: Set the rotation of an object.
- GetObjectPos: Locate an object.
- GetObjectRot: Check the rotation of an object.
- CreatePlayerObject: Create an object for only one player.
- DestroyPlayerObject: Destroy a player object.
- IsValidPlayerObject: Checks if a certain player object is vaild.
- MovePlayerObject: Move a player object.
- StopPlayerObject: Stop a player object from moving.
- SetPlayerObjectPos: Set the position of a player object.
- SetPlayerObjectRot: Set the rotation of a player object.
- GetPlayerObjectPos: Locate a player object.
- GetPlayerObjectRot: Check the rotation of a player object.