Difference between revisions of "HPL3/Scripting/Scripting Guide/The Update method"

From Frictional Wiki
Jump to navigation Jump to search
Line 21: Line 21:
  
 
===Example===
 
===Example===
 +
If we wanted to increase the brightness of a light based on the distance of the player from that light, we could use the <code>Update</code> method to always update the brightness value at any given time:
  
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.
 
  
  

Revision as of 22:12, 12 August 2020


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

If we wanted to increase the brightness of a light based on the distance of the player from that light, we could use the Update method to always update the brightness value at any given time: