IsElementWithinColShape: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(11 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Server client function}}
__NOTOC__
__NOTOC__
This function is used to tell if an element is within a collision shape.
This function is used to determine if an element is within a collision shape. Please note that for legacy reasons, a colshape created on the client does not collide with elements already existing at that location until they first move. Please also note that before 1.0.3, this did not function correctly when moving a colshape.
 
Please note that this function doesn't verify whether element is in the same dimension and interior, additional checks could be implemented manually if they are needed.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">bool isElementWithinColShape ( element theElement, colshape theShape )</syntaxhighlight>
<syntaxhighlight lang="lua">bool isElementWithinColShape ( element theElement, colshape theShape )</syntaxhighlight>
{{OOP||[[element]]:isWithinColShape}}


===Required Arguments===
===Required Arguments===
Line 10: Line 14:


===Returns===
===Returns===
Returns ''true'' if the element is within the colshape, false otherwise
Returns ''true'' if the element is within the colshape, ''false'' otherwise


==Example==
==Example==
This small script is an example of detecting if a player is within a certain defined colshape. This could serve as a base to perform many functions, rather than just an output.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onColShapeHit", getRootElement(), "ColShapeHit" )
local circlearea = createColCircle ( 0, 0, 10 )
function ColShapeHit ( player, matchingDimension )
 
detection = isElementWithinColShape ( player, circlearea )
function ColShapeHit ( thePlayer, matchingDimension )
--A varible called 'detection' stores the result of asking if the player
local detection = isElementWithinColShape ( thePlayer, circlearea )
--who entered a colshape is within the specific colshape called 'circlearea'.
--A variable called 'detection' stores the result of asking if the player
--The result is either true or false.
--who entered a colshape is within the specific colshape called 'circlearea'.
if detection == true then
--The result is either true or false.
outputChatBox ( "Player is in the 'circle area' col shape" )
detection = detection and getElementDimension( thePlayer ) == getElementDimension( circlearea )
--Let's additionally check element dimensions.
if detection then
outputChatBox ( getPlayerName(thePlayer).." is in the 'circle area' col shape" )
end
end
--if detection was true then the player is in the col shape. Output a
--if detection was true then the player is in the col shape. Output a
--message to confirm this
--message to confirm this
end
end
addEventHandler ( "onColShapeHit", root, ColShapeHit )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{element functions}}
{{element functions}}
[[hu:isElementWithinColShape]]

Latest revision as of 12:06, 10 October 2018

This function is used to determine if an element is within a collision shape. Please note that for legacy reasons, a colshape created on the client does not collide with elements already existing at that location until they first move. Please also note that before 1.0.3, this did not function correctly when moving a colshape.

Please note that this function doesn't verify whether element is in the same dimension and interior, additional checks could be implemented manually if they are needed.

Syntax

bool isElementWithinColShape ( element theElement, colshape theShape )

OOP Syntax Help! I don't understand this!

Method: element:isWithinColShape(...)


Required Arguments

  • theElement: The element you're checking.
  • theShape: The colshape you're checking

Returns

Returns true if the element is within the colshape, false otherwise

Example

This small script is an example of detecting if a player is within a certain defined colshape. This could serve as a base to perform many functions, rather than just an output.

local circlearea = createColCircle ( 0, 0, 10 )

function ColShapeHit ( thePlayer, matchingDimension )
	local detection = isElementWithinColShape ( thePlayer, circlearea )
	--A variable called 'detection' stores the result of asking if the player
	--who entered a colshape is within the specific colshape called 'circlearea'.
	--The result is either true or false.
	detection = detection and getElementDimension( thePlayer ) == getElementDimension( circlearea )
	--Let's additionally check element dimensions.
	if detection then
		outputChatBox ( getPlayerName(thePlayer).." is in the 'circle area' col shape" )
	end
	--if detection was true then the player is in the col shape. Output a
	--message to confirm this
end
addEventHandler ( "onColShapeHit", root, ColShapeHit )

See Also