warning Not Translated
This page has not been translated into the language that your browser requested yet. The English content is being shown as a fallback.
If you want to contribute a translation for 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.