The Update method

Update

Update is one of the most commonly used methods in HPL3. It’s called once per-frame in every script that uses it. Almost anything that needs to be changed or adjusted regularly happens here.

The Update method gets called on a fixed timeline and has the same time between calls. Immediately after Update is called, any necessary calculations are made, such as physics or dynamic value changes. Anything that affects rigid bodies, meaning a physics object, should be executed in this method.

Below is the default code in a map script file for Update:

void Update(float afTimeStep) 
{
}

Breakdown

afTimeStep represents the time (in seconds) which takes the function to get called. It is called every frame, and the game can run up to 60 frames per seconds. Therefore, the value of afTimeStep will almost always be 0.0167 seconds (60 fps in seconds).

However, we can also use it to calculate different things that aren’t related to physics.

Example

For example, if we wanted to increase a value based on the distance from a certain entity, we could use the Update method to always update the value at any given time.

Let’s look at a quick example of what we can achieve with an update function.

---

HPL3 Scripting Guide

← The OnAction method

Trigger Areas →