Pair: getLowLODElement

This function assigns a low LOD element to an element. The low LOD element is displayed when its associated element is not fully visible. If a low LOD element is assigned to several elements, it will be displayed when any of these elements are not fully visible.

Note

The only valid elements types for assigning LODs with this function are object and building.

OOP Syntax Help! I don't understand this!

• Method:element:setLowLOD(...)
• Variable: .lowLOD

Syntax

​bool setLowLODElement ( ​element theElement, ​element lowLODElement )

Required Arguments

• theElement: The element whose low LOD version we want to change.
• lowLODElement: A low LOD element to display when the first element is not fully visible.

Returns

• bool: result

Returns true if the assignment was successful, false otherwise.

Code Examples

Example 1 Example 2 (OOP) Example 3

client

This example shows how to create and link a normal and low LOD object:

-- Create a normal object
local objNormal = createObject(3620, x, y, z, 0, 0, 0)

-- Create a low LOD object
local objLowLOD = createObject(5154, x, y, z, 0, 0, 0, true)

-- Assign the LOD object with the Normal object
setLowLODElement(objNormal, objLowLOD)
-- Set the LOD object's parent to the Normal object so it is destroyed together
setElementParent(objLowLOD, objNormal)

-- Set the draw distance for the model we are using for low LOD to maximum
engineSetModelLODDistance(5154, 300)

client

OOP Required

This example shows how to create and link a normal and low LOD object:

-- Create a normal object
local objNormal = Object(3620, x, y, z, 0, 0, 0)

-- Create a low LOD object
local objLowLOD = Object(5154, x, y, z, 0, 0, 0, true)

-- Assign the LOD object with the Normal object
objNormal.lowLOD = objLowLOD
-- Set the LOD object's parent to the Normal object so it is destroyed together
objLowLOD.parent = objNormal

-- Set the draw distance for the model we are using for low LOD to maximum
Engine.setModelLODDistance(5154, 300)

server

This example shows how to create and link a composite object.

-- Create composite object
local objMainBit = createObject(3620, x, y, z)
local objLeftBit = createObject(5158, x, y, z)
local objRightBit = createObject(5158, x, y, z)
local objDetailBit1 = createObject(1337, x, y, z)
local objDetailBit2 = createObject(1337, x, y, z)
local objInternalBit = createObject(1337, x, y, z)
attachElements(objLeftBit, objMainBit, -10, 0, 0)
attachElements(objRightBit, objMainBit, 10, 0, 0)
attachElements(objDetailBit1, objMainBit, 5, 0, 0)
attachElements(objDetailBit2, objLeftBit, 5, 5, 0)
attachElements(objInternalBit, objRightBit, 5, 7, 0)

-- Create low LOD object (which represents the whole composite model)
local objLowLOD = createObject(5154, x, y, z, 0, 0, 0, true)

-- Attach low LOD object so it moves with the main model
attachElements(objLowLOD, objMainBit, 0, 0, 0)

-- Set the low LOD object's parent to the main object so it is destroyed together
setElementParent(objLowLOD, objMainBit)

-- Set associations so the low LOD model is displayed when the main parts are not full visible
setLowLODElement(objMainBit, objLowLOD)
setLowLODElement(objLeftBit, objLowLOD)
setLowLODElement(objRightBit, objLowLOD)

-- Note that the detail and internal parts have not been associated to the low LOD object

See Also

Element Functions

• addElementDataSubscriber
• attachElements
• clearElementVisibleTo
• cloneElement
• createElement
• destroyElement
• detachElements
• getAllElementDataUpdated
• getAttachedElements
• getElementAlpha
• getElementAngularVelocity
• getElementAttachedOffsets
• getElementAttachedTo
• getElementBonePosition
• getElementBoneQuaternionNew
• getElementBoneRotation
• getElementBoundingBox
• getElementByID
• getElementByIndex
• getElementChild
• getElementChildren
• getElementChildrenCount
• getElementCollisionsEnabled
• getElementColShape
• getElementData
• getElementDimension
• getElementDistanceFromCentreOfMassToBaseOfModel
• getElementHealth
• getElementID
• getElementInterior
• getElementLighting
• getElementMatrix
• getElementModel
• getElementParent
• getElementPosition
• getElementRadius
• getElementRotation
• getElementsByType
• getElementsWithinColShape
• getElementsWithinRange
• getElementSyncer
• getElementType
• getElementVelocity
• getElementZoneName
• getLowLODElement
• getRootElement
• hasElementData
• hasElementDataSubscriber
• isElement
• isElementAttached
• isElementCallPropagationEnabled
• isElementCollidableWith
• isElementDoubleSided
• isElementFrozen
• isElementInWater
• isElementLocal
• isElementLowLOD
• isElementOnFireNew
• isElementOnScreen
• isElementStreamable
• isElementStreamedIn
• isElementSyncer
• isElementVisibleTo
• isElementWaitingForGroundToLoad
• isElementWithinColShape
• isElementWithinMarker
• removeElementData
• removeElementDataSubscriber
• setElementAlpha
• setElementAngularVelocity
• setElementAttachedOffsets
• setElementBonePosition
• setElementBoneQuaternionNew
• setElementBoneRotation
• setElementCallPropagationEnabled
• setElementCollidableWith
• setElementCollisionsEnabled
• setElementDataUpdated
• setElementDimension
• setElementDoubleSided
• setElementFrozen
• setElementHealth
• setElementID
• setElementInterior
• setElementLightingNew
• setElementMatrix
• setElementModel
• setElementOnFireNew
• setElementParent
• setElementPosition
• setElementRotation
• setElementStreamable
• setElementSyncer
• setElementVelocity
• setElementVisibleTo
• setLowLODElement
• updateElementRpHAnim

Element Events

• onClientElementColShapeHit
• onClientElementColShapeLeave
• onClientElementDataChange
• onClientElementDestroy
• onClientElementDimensionChange
• onClientElementInteriorChange
• onClientElementModelChange
• onClientElementStreamIn
• onClientElementStreamOut
• onElementClicked
• onElementColShapeHit
• onElementColShapeLeave
• onElementDataChange
• onElementDestroy
• onElementDimensionChange
• onElementInteriorChange
• onElementModelChange
• onElementStartSync
• onElementStopSync

Reference

• Scripting Functions