SetPlayerAttachedObject FR

From SA-MP Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 19:49, 5 January 2013
Connor Mead (Talk | contribs)

← Previous diff
Revision as of 20:13, 6 January 2013
Connor Mead (Talk | contribs)

Next diff →
Line 1: Line 1:
 +{{ScriptingFR}}
 +{{Title}}
 +
 +{{AddedIn0.3cFR|fonction}}
 +
 +{{Description|Attach an object to a specific bone on a player.}}
 +
 +{{ParametersFR|playerid, index, modelid, bone, Float:fOffsetX, Float:fOffsetY, Float:fOffsetZ, Float:fRotX, Float:fRotY, Float:fRotZ, Float:fScaleX, Float:fScaleY, Float:fScaleZ, materialcolor1, materialcolor2}}
 +{{Param|playerid|The ID of the player to attach the object to.}}
 +{{Param|index|The index (slot) to assign the object to (0-9 since 0.3d, 0-4 in previous versions).}}
 +{{Param|modelid|The [[Objects|model]] to attach.}}
 +{{Param|bone|The [[Bone_IDs|bone]] to attach the object to.}}
 +{{Param|fOffsetX|(optional) X axis offset for the object position.}}
 +{{Param|fOffsetY|(optional) Y axis offset for the object position.}}
 +{{Param|fOffsetZ|(optional) Z axis offset for the object position.}}
 +{{Param|fRotX|(optional) X axis rotation of the object.}}
 +{{Param|fRotY|(optional) Y axis rotation of the object.}}
 +{{Param|fRotZ|(optional) Z axis rotation of the object.}}
 +{{Param|fScaleX|(optional) X axis scale of the object.}}
 +{{Param|fScaley|(optional) Y axis scale of the object.}}
 +{{Param|fScalez|(optional) Z axis scale of the object.}}
 +{{Param|materialcolor1|(optional) The first object color to set, as an integer or hex in '''ARGB''' color format.}}
 +{{Param|materialcolor2|(optional) The second object color to set, as an integer or hex in '''ARGB''' color format}}
 +
 +{{ReturnsFR|1 on success, 0 on failure.}}
 +
 +{{note2FR|No more than 10 objects can be attached to a single player in 0.3d (5 in previous versions). Index must be 0-9 (0-4 in previous versions)).}}
 +{{note|This function is seperate from the CreateObject / CreatePlayerObject pools.}}
 +
 +
 +<pawn>
 +public OnPlayerSpawn(playerid)
 +{
 + SetPlayerAttachedObject(playerid, 3, 1609, 2); //Attach a turtle to the playerid's head, in slot 3
 +
 + // example of using colors on an object being attached to the player:
 + SetPlayerAttachedObject(playerid, 3, 19487, 2, 0.101, -0.0, 0.0, 5.50, 84.60, 83.7, 1, 1, 1, 0xFF00FF00);
 + // Attach a white hat to the head of the player and paint it green
 + return 1;
 +}
 +</pawn>
 +
 +
 +Useful defines for updating to 0.3c
 +<pawn>
 +#define SetPlayerHoldingObject(%1,%2,%3,%4,%5,%6,%7,%8,%9) SetPlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1,%2,%3,%4,%5,%6,%7,%8,%9)
 +#define StopPlayerHoldingObject(%1) RemovePlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)
 +#define IsPlayerHoldingObject(%1) IsPlayerAttachedObjectSlotUsed(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)
 +</pawn>
 +
 +{{RelatedFunctionsFR}}
 +*[[RemovePlayerAttachedObject_FR|RemovePlayerAttachedObject:]]
 +*[[IsPlayerAttachedObjectSlotUsed_FR|IsPlayerAttachedObjectSlotUsed:]] Vérifier si une partie du corps d'un joueur est occupée par un objet
 +*[[EditAttachedObject_FR|EditAttachedObject:]] Modifier un objet attaché
 +
[[Category:Scripting Functions FR]] [[Category:Scripting Functions FR]]

Revision as of 20:13, 6 January 2013




Cette fonction a été ajoutée dans SA-MP 0.3c et n'est pas utilisable dans les versions antérieures!


Description:

Attach an object to a specific bone on a player.


Paramètres:
(playerid, index, modelid, bone, Float:fOffsetX, Float:fOffsetY, Float:fOffsetZ, Float:fRotX, Float:fRotY, Float:fRotZ, Float:fScaleX, Float:fScaleY, Float:fScaleZ, materialcolor1, materialcolor2)
playeridThe ID of the player to attach the object to.
indexThe index (slot) to assign the object to (0-9 since 0.3d, 0-4 in previous versions).
modelidThe model to attach.
boneThe bone to attach the object to.
fOffsetX(optional) X axis offset for the object position.
fOffsetY(optional) Y axis offset for the object position.
fOffsetZ(optional) Z axis offset for the object position.
fRotX(optional) X axis rotation of the object.
fRotY(optional) Y axis rotation of the object.
fRotZ(optional) Z axis rotation of the object.
fScaleX(optional) X axis scale of the object.
fScaley(optional) Y axis scale of the object.
fScalez(optional) Z axis scale of the object.
materialcolor1(optional) The first object color to set, as an integer or hex in ARGB color format.
materialcolor2(optional) The second object color to set, as an integer or hex in ARGB color format


Retourne:

1 on success, 0 on failure.


Image:32px-Circle-style-warning.png

Note
Importante

No more than 10 objects can be attached to a single player in 0.3d (5 in previous versions). Index must be 0-9 (0-4 in previous versions)).


Image:32px-Ambox_warning_orange.png

Note

This function is seperate from the CreateObject / CreatePlayerObject pools.


public OnPlayerSpawn(playerid)
{
    SetPlayerAttachedObject(playerid, 3, 1609, 2); //Attach a turtle to the playerid's head, in slot 3
 
    // example of using colors on an object being attached to the player:
    SetPlayerAttachedObject(playerid, 3, 19487, 2, 0.101, -0.0, 0.0, 5.50, 84.60, 83.7, 1, 1, 1, 0xFF00FF00);
    // Attach a white hat to the head of the player and paint it green
    return 1;
}


Useful defines for updating to 0.3c

#define SetPlayerHoldingObject(%1,%2,%3,%4,%5,%6,%7,%8,%9) SetPlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1,%2,%3,%4,%5,%6,%7,%8,%9)
#define StopPlayerHoldingObject(%1) RemovePlayerAttachedObject(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)
#define IsPlayerHoldingObject(%1) IsPlayerAttachedObjectSlotUsed(%1,MAX_PLAYER_ATTACHED_OBJECTS-1)

Fonctions Relatives

Les fonctions suivantes peuvent être utiles car elles sont indirectement ou directement liées a cette fonction.