AttachEffect - Revision history

IManGaaX: add section, change code style

2023-10-29T10:41:51Z

add section, change code style

← Older revision		Revision as of 10:41, 29 October 2023
Line 17:		Line 17:

	==Code==		==Code==
			<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local attachedEffects = {}		local attachedEffects = {}
Line 22:		Line 23:
	-- Taken from https://wiki.multitheftauto.com/wiki/GetElementMatrix example		-- Taken from https://wiki.multitheftauto.com/wiki/GetElementMatrix example
	function getPositionFromElementOffset(element,offX,offY,offZ)		function getPositionFromElementOffset(element,offX,offY,offZ)
	local m = getElementMatrix ( element ) -- Get the matrix		local m = getElementMatrix ( element ) -- Get the matrix
	local x = offX * m[1][1] + offY * m[2][1] + offZ * m[3][1] + m[4][1] -- Apply transform		local x = offX * m[1][1] + offY * m[2][1] + offZ * m[3][1] + m[4][1] -- Apply transform
	local y = offX * m[1][2] + offY * m[2][2] + offZ * m[3][2] + m[4][2]		local y = offX * m[1][2] + offY * m[2][2] + offZ * m[3][2] + m[4][2]
	local z = offX * m[1][3] + offY * m[2][3] + offZ * m[3][3] + m[4][3]		local z = offX * m[1][3] + offY * m[2][3] + offZ * m[3][3] + m[4][3]
	return x, y, z -- Return the transformed point		return x, y, z -- Return the transformed point
	end		end

	function attachEffect(effect, element, pos)		function attachEffect(effect, element, pos)
	attachedEffects[effect] = { effect = effect, element = element, pos = pos }		attachedEffects[effect] = { effect = effect, element = element, pos = pos }
	addEventHandler("onClientElementDestroy", effect, function() attachedEffects[effect] = nil end)		addEventHandler("onClientElementDestroy", effect, function() attachedEffects[effect] = nil end)
	addEventHandler("onClientElementDestroy", element, function() attachedEffects[effect] = nil end)		addEventHandler("onClientElementDestroy", element, function() attachedEffects[effect] = nil end)
	return true		return true
	end		end

	addEventHandler("onClientPreRender", root,		addEventHandler("onClientPreRender", root, function()
	function()		for fx, info in pairs(attachedEffects) do
	for fx, info in pairs(attachedEffects) do		local x, y, z = getPositionFromElementOffset(info.element, info.pos.x, info.pos.y, info.pos.z)
	local x, y, z = getPositionFromElementOffset(info.element, info.pos.x, info.pos.y, info.pos.z)		setElementPosition(fx, x, y, z)
	setElementPosition(fx, x, y, z)		end
	end		end)
	end
	)

	</syntaxhighlight>		</syntaxhighlight>
			</section>

	==Example==		==Example==

Walid: Client side not server side (wrong class)

2016-08-05T18:36:14Z

Client side not server side (wrong class)

← Older revision		Revision as of 18:36, 5 August 2016
Line 48:		Line 48:

	==Example==		==Example==
	<section name="~~Example~~" class="~~server~~" show="true">		<section name="Client" class="client" show="true">
	This example attachs a fire on top of the local player's vehicle.		This example attachs a fire on top of the local player's vehicle.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

Sbx320: Created page with "{{Useful Function}} NOTOC This function allows you to attach an effect to an element. ==Syntax== bool attachEffect(effect theEffect, element..."

2014-07-04T02:44:41Z

Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ This function allows you to attach an effect to an element. ==Syntax== <syntaxhighlight lang="lua">bool attachEffect(effect theEffect, element..."

New page

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
This function allows you to attach an effect to an element.
==Syntax==
<syntaxhighlight lang="lua">bool attachEffect(effect theEffect, element theElement, [vector3 vecOffset])</syntaxhighlight>

===Required arguments===
* '''theEffect''': The effect which should be attached.
* '''theElement''': The element, which the effect should be attached to.

===Optional arguments===
* '''vecOffset''': a Vector3 describing the offset position similar to attachElements.

===Return===
Returns true

==Code==
<syntaxhighlight lang="lua">
local attachedEffects = {}

-- Taken from https://wiki.multitheftauto.com/wiki/GetElementMatrix example
function getPositionFromElementOffset(element,offX,offY,offZ)
local m = getElementMatrix ( element ) -- Get the matrix
local x = offX * m[1][1] + offY * m[2][1] + offZ * m[3][1] + m[4][1] -- Apply transform
local y = offX * m[1][2] + offY * m[2][2] + offZ * m[3][2] + m[4][2]
local z = offX * m[1][3] + offY * m[2][3] + offZ * m[3][3] + m[4][3]
return x, y, z -- Return the transformed point
end

function attachEffect(effect, element, pos)
attachedEffects[effect] = { effect = effect, element = element, pos = pos }
addEventHandler("onClientElementDestroy", effect, function() attachedEffects[effect] = nil end)
addEventHandler("onClientElementDestroy", element, function() attachedEffects[effect] = nil end)
return true
end

addEventHandler("onClientPreRender", root,
function()
for fx, info in pairs(attachedEffects) do
local x, y, z = getPositionFromElementOffset(info.element, info.pos.x, info.pos.y, info.pos.z)
setElementPosition(fx, x, y, z)
end
end
)

</syntaxhighlight>

==Example==
<section name="Example" class="server" show="true">
This example attachs a fire on top of the local player's vehicle.
<syntaxhighlight lang="lua">
local pov = getPedOccupiedVehicle(localPlayer)
local fx = createEffect("fire", pov.position)
attachEffect(fx, pov, Vector3(0, 0, 2))
</syntaxhighlight>
</section>

==See Also==
{{Useful_Functions}}

AttachEffect - Revision history

IManGaaX: add section, change code style

Walid: Client side not server side (wrong class)

Sbx320: Created page with "{{Useful Function}} __NOTOC__ This function allows you to attach an effect to an element. ==Syntax== bool attachEffect(effect theEffect, element..."

Sbx320: Created page with "{{Useful Function}} NOTOC This function allows you to attach an effect to an element. ==Syntax== bool attachEffect(effect theEffect, element..."