A LoDModel can be used to create a PineObject in the same way as a normal Model and can be created from a Model. However, the difference is that the LoDModel stores lower quality (fewer polys) versions of the initial Model. It uses the lower quality versions of the model for when the camera is further away to increase the performance, without sacrificing quality when close to the camera.

Creating an LoDModel

-- load pinetree model
local pinetree = Pine3D.loadModel("models/pinetree"):alignBottom():normalizeScaleY()

-- we can easily convert the model to an LoDModel:
-- local pinetreeLoD = pinetree:toLoD()

-- or we can specify settings for the Level of Detail:
local pinetreeLoD = pinetree:toLoD({
  minQuality = 0.1, -- default: 0.1 (optional)
  variantCount = 5, -- default: 4 (optional)
  qualityHalvingDistance = 8, -- default: 5 (optional)
  quickInitWorseRuntime = false, -- default: false (optional)
})

-- we create a table for our objects
local objects = {}

-- simply create a new objects with the LoDModel
for i = 1, 100 do -- how many pinetrees
  local x = math.random(1, 20)
  local z = math.random(1, 20)
  local pinetree = ThreeDFrame:newObject(pinetreeLoD, x, 0, z)
  objects[i] = pinetree
end