GetElementDimension: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
Line 14: | Line 14: | ||
==Example== | ==Example== | ||
This example | This example puts all vehicles with drivers in dimension 1, while all other vehicles are in dimension 0. This would have the effect of making on-foot players invisible to drivers, and vice versa. It'd also make entering a vehicle as passenger after the driver has entered impossible, as the vehicle would appear to vanish to any on foot players. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function onPlayerEnterVehicle ( theVehicle, seat, jacked ) | function onPlayerEnterVehicle ( theVehicle, seat, jacked ) | ||
if ( getElementDimension ( source ) == 0 and seat == 0 ) then -- if the player is in dimension 0 and is entering the driver seat | if ( getElementDimension ( source ) == 0 and seat == 0 ) then -- if the player is in dimension 0 and is entering the driver seat | ||
Line 23: | Line 22: | ||
end | end | ||
end | end | ||
addEventHandler ( "onPlayerEnterVehicle", getRootElement(), onPlayerEnterVehicle ) | |||
function onPlayerExitVehicle ( theVehicle, seat, jacker ) | function onPlayerExitVehicle ( theVehicle, seat, jacker ) | ||
if ( getElementDimension ( source ) == 1 and seat == 0 ) then -- if the player is in dimension 1 and was in the driver's seat | if ( getElementDimension ( source ) == 1 and seat == 0 ) then -- if the player is in dimension 1 and was in the driver's seat | ||
Line 31: | Line 31: | ||
end | end | ||
end | end | ||
addEventHandler ( "onPlayerExitVehicle", getRootElement(), onPlayerExitVehicle ) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Element functions}} | {{Element functions}} |
Revision as of 23:43, 28 July 2007
This function allows you to retrieve the dimension of any element. The dimension determines what/who the element is visible to.
Syntax
int getElementDimension ( element theElement )
Required Arguments
- theElement: The element in which you'd like to retrieve the dimension of.
Returns
Returns an integer for the dimension if 'theElement' is valid, 'false' otherwise.
Example
This example puts all vehicles with drivers in dimension 1, while all other vehicles are in dimension 0. This would have the effect of making on-foot players invisible to drivers, and vice versa. It'd also make entering a vehicle as passenger after the driver has entered impossible, as the vehicle would appear to vanish to any on foot players.
function onPlayerEnterVehicle ( theVehicle, seat, jacked ) if ( getElementDimension ( source ) == 0 and seat == 0 ) then -- if the player is in dimension 0 and is entering the driver seat setElementDimension ( source, 1 ) -- set his dimension to 1 setElementDimension ( theVehicle, 1 ) -- set his vehicle's dimension to 1 aswell end end addEventHandler ( "onPlayerEnterVehicle", getRootElement(), onPlayerEnterVehicle ) function onPlayerExitVehicle ( theVehicle, seat, jacker ) if ( getElementDimension ( source ) == 1 and seat == 0 ) then -- if the player is in dimension 1 and was in the driver's seat setElementDimension ( source, 0 ) -- set his dimension back to 0 setElementDimension ( theVehicle, 0 ) -- set his vehicle's dimension back to 0 aswell end end addEventHandler ( "onPlayerExitVehicle", getRootElement(), onPlayerExitVehicle )
See Also
- attachElements
- createElement
- destroyElement
- detachElements
- getAttachedElements
- getElementAlpha
- getElementAttachedOffsets
- getElementAttachedTo
- getElementByIndex
- getElementByID
- getElementChild
- getElementChildren
- getElementChildrenCount
- getElementCollisionsEnabled
- getElementColShape
- getElementData
- getAllElementData
- hasElementData
- getElementDimension
- getElementHealth
- getElementID
- getElementInterior
- getElementMatrix
- getElementModel
- getElementParent
- getElementPosition
- getElementRotation
- getElementsByType
- getElementsWithinColShape
- getElementsWithinRange
- getElementType
- getElementVelocity
- getLowLODElement
- getRootElement
- isElement
- isElementAttached
- isElementCallPropagationEnabled
- isElementDoubleSided
- isElementFrozen
- isElementInWater
- isElementLowLOD
- isElementWithinColShape
- isElementWithinMarker
- setElementAlpha
- setElementAngularVelocity
- getElementAngularVelocity
- setElementAttachedOffsets
- setElementCallPropagationEnabled
- setElementCollisionsEnabled
- setElementData
- setElementDimension
- setElementDoubleSided
- setElementFrozen
- setElementHealth
- setElementID
- setElementInterior
- setElementModel
- setElementParent
- setElementPosition
- setElementRotation
- setElementVelocity
- setLowLODElement
- getPedContactElement
- getResourceDynamicElementRoot
- getResourceRootElement