Resource:Bone attach - Revision history

LuXorioN: Fixed available bone IDs being incorrect

2019-05-28T09:49:09Z

Fixed available bone IDs being incorrect

← Older revision		Revision as of 09:49, 28 May 2019
Line 17:		Line 17:
	[[Image:Bones.jpg\|thumb\|Bone numbers]]		[[Image:Bones.jpg\|thumb\|Bone numbers]]
	<div style="border: 3px red solid; margin-bottom:3px; padding-left:5px;">		<div style="border: 3px red solid; margin-bottom:3px; padding-left:5px;">
	*'''1:''' ~~BONE_PELVIS1~~
	*'''2:''' ~~BONE_PELVIS~~		*'''1:''' head
	*'''3:''' ~~BONE_SPINE1~~		*'''2:''' neck
	*'''4:''' ~~BONE_UPPERTORSO~~		*'''3:''' spine
	*'''5:''' ~~BONE_NECK~~		*'''4:''' pelvis
	*'''6:''' ~~BONE_HEAD2~~		*'''5:''' left clavicle
	*'''7:''' ~~BONE_HEAD1~~		*'''6:''' right clavicle
	*'''8:''' ~~BONE_HEAD~~		*'''7:''' left shoulder
	*'''21:''' BONE_RIGHTUPPERTORSO		*'''8:''' right shoulder
	*'''22:''' BONE_RIGHTSHOULDER		*'''9:''' left elbow
	*'''23:''' BONE_RIGHTELBOW		*'''10:''' right elbow
	*'''24:''' BONE_RIGHTWRIST		*'''11:''' left hand
	*'''25:''' BONE_RIGHTHAND		*'''12:''' right hand
	*'''26:''' BONE_RIGHTTHUMB		*'''13:''' left hip
	*'''31:''' BONE_LEFTUPPERTORSO		*'''14:''' right hip
	*'''32:''' BONE_LEFTSHOULDER		*'''15:''' left knee
	*'''33:''' ~~BONE_LEFTELBOW~~		*'''16:''' right knee
	*'''34:''' ~~BONE_LEFTWRIST~~		*'''17:''' left ankle
	*'''35:''' ~~BONE_LEFTHAND~~		*'''18:''' right ankle
	*'''36:''' ~~BONE_LEFTTHUMB~~		*'''19:''' left foot
	*'''41:''' ~~BONE_LEFTHIP~~		*'''20:''' right foot
	*'''42:''' ~~BONE_LEFTKNEE~~
	*'''43:''' ~~BONE_LEFTANKLE~~
	*'''44:''' ~~BONE_LEFTFOOT~~
	*'''51:''' ~~BONE_RIGHTHIP~~
	*'''52:''' ~~BONE_RIGHTKNEE~~
	*'''53:''' ~~BONE_RIGHTANKLE~~
	*'''54:''' ~~BONE_RIGHTFOOT~~
	</div>		</div>
	====Optional arguments====		====Optional arguments====
Line 129:		Line 122:
	Returns bone x, y, z position and rotation if ped is streamed in and bone number is valid, false otherwise.		Returns bone x, y, z position and rotation if ped is streamed in and bone number is valid, false otherwise.
	</section>		</section>

	==Example==		==Example==
	<section name="Example 1" class="server" show="true">		<section name="Example 1" class="server" show="true">

LordHenry at 13:23, 27 January 2019

2019-01-27T13:23:38Z

← Older revision		Revision as of 13:23, 27 January 2019
Line 3:		Line 3:
	This resource lets you attach elements to players/peds bones using its exported functions.		This resource lets you attach elements to players/peds bones using its exported functions.
	Download can be found at the [https://community.multitheftauto.com/index.php?p=resources&s=details&id=2540 MTA community page].<br>		Download can be found at the [https://community.multitheftauto.com/index.php?p=resources&s=details&id=2540 MTA community page].<br>
	Resource developed by: [https://community.multitheftauto.com/index.php?p=profile&id=5138 Devan_LT]		Resource developed by: [https://community.multitheftauto.com/index.php?p=profile&id=5138 Devan_LT] (also known as [https://forum.mtasa.com/profile/1985-crystalmv/ CrystalMV])

	==Exported functions/events==		==Exported functions/events==

LordHenry: Added developer credits

2019-01-27T12:26:45Z

Added developer credits

← Older revision		Revision as of 12:26, 27 January 2019
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This resource lets you attach elements to players/peds bones using its exported functions.		This resource lets you attach elements to players/peds bones using its exported functions.
	Download can be found at the [https://community.multitheftauto.com/index.php?p=resources&s=details&id=2540 MTA community page].		Download can be found at the [https://community.multitheftauto.com/index.php?p=resources&s=details&id=2540 MTA community page].<br>
			Resource developed by: [https://community.multitheftauto.com/index.php?p=profile&id=5138 Devan_LT]

	==Exported functions/events==		==Exported functions/events==

LordHenry at 16:27, 11 August 2018

2018-08-11T16:27:26Z

@@ Line 127: / Line 127: @@
 ====Returns====
 Returns bone x, y, z position and rotation if ped is streamed in and bone number is valid, false otherwise.
 </section>

LordHenry: Created page with "{{Resource page}} NOTOC This resource lets you attach elements to players/peds bones using its exported functions. Download can be found at the [https://community.multithe..."

2018-08-10T18:17:04Z

Created page with "{{Resource page}} __NOTOC__ This resource lets you attach elements to players/peds bones using its exported functions. Download can be found at the [https://community.multithe..."

New page

{{Resource page}}
__NOTOC__
This resource lets you attach elements to players/peds bones using its exported functions.
Download can be found at the [https://community.multitheftauto.com/index.php?p=resources&s=details&id=2540 MTA community page].

==Exported functions/events==
<section name="Server or Client" class="both" show="true">
This function attaches element to the bone of the ped or player.
<syntaxhighlight lang="lua">
bool attachElementToBone (element theElement, element theAttachToPed, int theBone[, float xPosOffset = 0, float yPosOffset = 0, float zPosOffset = 0, float xRotOffset = 0, float yRotOffset = 0, float zRotOffset = 0])
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to attach..
*'''theAttachToPed:''' The ped or player which you want to attach element to.
*'''theBone:''' The number of the ped or player's bone which you want to attach element to.
[[Image:Bones.jpg|thumb|Bone numbers]]
<div style="border: 3px red solid; margin-bottom:3px; padding-left:5px;">
*'''1:''' BONE_PELVIS1
*'''2:''' BONE_PELVIS
*'''3:''' BONE_SPINE1
*'''4:''' BONE_UPPERTORSO
*'''5:''' BONE_NECK
*'''6:''' BONE_HEAD2
*'''7:''' BONE_HEAD1
*'''8:''' BONE_HEAD
*'''21:''' BONE_RIGHTUPPERTORSO
*'''22:''' BONE_RIGHTSHOULDER
*'''23:''' BONE_RIGHTELBOW
*'''24:''' BONE_RIGHTWRIST
*'''25:''' BONE_RIGHTHAND
*'''26:''' BONE_RIGHTTHUMB
*'''31:''' BONE_LEFTUPPERTORSO
*'''32:''' BONE_LEFTSHOULDER
*'''33:''' BONE_LEFTELBOW
*'''34:''' BONE_LEFTWRIST
*'''35:''' BONE_LEFTHAND
*'''36:''' BONE_LEFTTHUMB
*'''41:''' BONE_LEFTHIP
*'''42:''' BONE_LEFTKNEE
*'''43:''' BONE_LEFTANKLE
*'''44:''' BONE_LEFTFOOT
*'''51:''' BONE_RIGHTHIP
*'''52:''' BONE_RIGHTKNEE
*'''53:''' BONE_RIGHTANKLE
*'''54:''' BONE_RIGHTFOOT
</div>
====Optional arguments====
{{OptionalArg}}
*'''xPosOffset:''' The x offset, if you want the elements to be a certain distance from one another (default 0).
*'''yPosOffset:''' The y offset (default 0).
*'''zPosOffset:''' The z offset (default 0).
*'''xRotOffset:''' The x rotation offset (default 0).
*'''yRotOffset:''' The y rotation offset (default 0).
*'''zRotOffset:''' The z rotation offset (default 0).
====Returns====
Returns true if element was successfully attached, false otherwise.

----

This function detaches element from the bone of the ped.
<syntaxhighlight lang="lua">
bool detachElementFromBone (element theElement)
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to detach.
====Returns====
Returns true if element was successfully detached, false otherwise.

----

This function checks if element is attached to a bone.
<syntaxhighlight lang="lua">
bool isElementAttachedToBone (element theElement)
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to check.
====Returns====
Returns true if element is attached to a bone, false otherwise.

----

This function gets ped, bone and offset details of attached element.
<syntaxhighlight lang="lua">
bool getElementBoneAttachmentDetails (element theElement)
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to get attachment details of.
====Returns====
Returns ped, bone, x, y, z, rx, ry, rz used in attachElementToBone if element is attached, false otherwise.

----

This function changes position offset of attached element.
<syntaxhighlight lang="lua">
bool setElementBonePositionOffset (element theElement, float xPosOffset, float yPosOffset, float zPosOffset)
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to change offset of.
*'''xPosOffset:''' New x position offset.
*'''yPosOffset:''' New y position offset.
*'''zPosOffset:''' New z position offset.
====Returns====
Returns true if position set successfully, false otherwise.

----

This function changes rotation offset of attached element.
<syntaxhighlight lang="lua">
bool setElementBoneRotationOffset (element theElement, float xRotOffset, float yRotOffset, float zRotOffset)
</syntaxhighlight>
====Required Arguments====
*'''theElement:''' Element which you want to change offset of.
*'''xRotOffset:''' New x rotation offset.
*'''yRotOffset:''' New y rotation offset.
*'''zRotOffset:''' New z rotation offset.
====Returns====
Returns true if rotation set successfully, false otherwise.
</section>
<section name="Client-Only" class="client" show="true">
This function gets position and rotation of the ped bone.
<syntaxhighlight lang="lua">
bool getBonePositionAndRotation (element theAttachToPed, int theBone)
</syntaxhighlight>
====Required Arguments====
*'''theAttachToPed:''' The ped or player which bone you want to get position.
*'''theBone:''' The number of the ped or player's bone which you want to get position.
====Returns====
Returns bone x, y, z position and rotation if ped is streamed in and bone number is valid, false otherwise.
</section>

Resource:Bone attach - Revision history

LuXorioN: Fixed available bone IDs being incorrect

LordHenry at 13:23, 27 January 2019

LordHenry: Added developer credits

LordHenry at 16:27, 11 August 2018

LordHenry: Created page with "{{Resource page}} __NOTOC__ This resource lets you attach elements to players/peds bones using its exported functions. Download can be found at the [https://community.multithe..."

LordHenry: Created page with "{{Resource page}} NOTOC This resource lets you attach elements to players/peds bones using its exported functions. Download can be found at the [https://community.multithe..."