This command can be used to force a delay-loaded animation to load.
Delay loaded animations can be enabled through the avatar cfg file using the
delay_load option or by specifying the
viz.AVATAR_DELAY_LOAD flag when calling
<viz>.addAvatar. A delay loaded animation will only read the animation from file when it is played for the first time. This is useful for specifying many animations within the cfg file, but only loading the ones that are actually used.
Here is an example of how to use the
delay_load option within the avatar cfg file:
# Frequently used animations to always load
animation = male_idle.cafx
animation = male_walk.cafx
# Rarely used animations to delay load
delay_load = 1
animation = male_run.cafx
animation = male_talk.cafx
animation = male_dance.cafx
animation = male_sit_chair.cafx
True/False indicating whether the animation has been successfully loaded.