Model::SetSkeleton

This method assigns a skeleton to a model. You can use this to share a skeleton across multiple models.

Syntax

• SetSkeleton(Skeleton skeleton)

Remarks

This method can be used to efficiently animate large crowds of characters. For example, if you have a horde of 1000 zombies, and 600 of them were running towards the player, you could set all 600 of those to use just a few skeletons that were playing the run animation. This would greatly reduce the number of skeletons that require animation updates while still providing some variation between different characters.

Example

--Get the displays
local displays = GetDisplays()

--Create window
local window = CreateWindow("Ultra Engine", 0, 0, 1280, 720, displays[1], WINDOW_CENTER | WINDOW_TITLEBAR)

--Create framebuffer
local framebuffer = CreateFramebuffer(window)

--Create world
local world = CreateWorld()

--Create camera
local camera = CreateCamera(world)
camera:SetClearColor(0.125)
camera:SetFov(70)
camera:SetRotation(0, 165, 0)
camera:Turn(15, 0, 0)
camera:Move(0, 1, -8)

--Create light
local light = CreateBoxLight(world)
light:SetRotation(45, 35, 0)
light:SetRange(-10, 10)

--Load FreeImage plugin
local plugin = LoadPlugin("Plugins/FITextureLoader")

--Load a model
local model = LoadModel(world, "https://github.com/UltraEngine/Documentation/raw/master/Assets/Models/Characters/Fox.glb")
model:SetScale(0.05)
model:SetPosition(-1.5, 0, 0)
model:Animate(1)

--Create an instance of the model
local model2 = Model(model:Instantiate(world)) -- copy and cast to the Model class
model2:SetPosition(1.5, 0, 0)

--Two foxes one skeleton
model2:SetSkeleton(model.skeleton)

--Main loop
while window:Closed() == false and window:KeyDown(KEY_ESCAPE) == false do
    world:Update()
    world:Render(framebuffer)
end