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.
AttachPlayerObjectToObject
warning
This function was added in omp v1.1.0.2612 and will not work in earlier versions!
Description
You can use this function to attach player-objects to other player-objects. The objects will follow the main object.
| Name | Description |
|---|---|
| playerid | The ID of the player. |
| objectid | The player-object to attach to another player-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:RotX | The X rotation between the object and the main object. |
| Float:RotY | The Y rotation between the object and the main object. |
| Float:RotZ | The Z rotation between the object and the main object. |
| bool:syncRotation | If set to false, objectid's rotation will not change with parentid'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 (parentid) exists.
Examples
new objectid = CreatePlayerObject(...);
new parentid = CreatePlayerObject(...);
AttachPlayerObjectToObject(playerid, objectid, parentid, 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.
Related Functions
- AttachObjectToObject: Attach an object to other object.
- AttachObjectToPlayer: Attach an object to a player.
- AttachObjectToVehicle: Attach an object to a vehicle.
- AttachPlayerObjectToPlayer: Attach a player object to a player.
- 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.