HU/setElementDimension
Jump to navigation
Jump to search
This function allows you to set the dimension of any element. The dimension determines what/who the element is visible to.
Syntax
bool setElementDimension ( element theElement, int dimension )
OOP Syntax Help! I don't understand this!
- Method: element:setDimension(...)
- Variable: .dimension
- Counterpart: getElementDimension
Required Arguments
- theElement: The element in which you'd like to set the dimension of.
- dimension: An integer representing the dimension ID. You can also use -1 to make the element visible in all dimensions (only valid to objects). Valid values are 0 to 65535.
Returns
Returns true if theElement and dimension are valid, false otherwise. Also returns false if theElement is a player and it's not alive.
Example
Click to collapse [-]
ServerIn this example the player's dimension is set to ID 1 when they enter a vehicle, and set back to dimension 0 when they exit the vehicle.
function onPlayerEnterVehicle ( theVehicle, seat, jacked ) if ( getElementDimension ( source ) == 0 ) then -- if the player is in dimension 0 setElementDimension ( source, 1 ) -- set his dimension to 1 setElementDimension ( theVehicle, 1 ) -- set his vehicle's dimension to 1 as well end end addEventHandler ( "onPlayerVehicleEnter", root, onPlayerEnterVehicle ) function onPlayerExitVehicle ( theVehicle, seat, jacker ) if ( getElementDimension ( source ) == 1 ) then -- if the player is in dimension 1 setElementDimension ( source, 0 ) -- set his dimension back to 0 setElementDimension ( theVehicle, 0 ) -- set his vehicle's dimension back to 0 as well end end addEventHandler ( "onPlayerVehicleExit", root, 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