-------------— animation graph functions ----------------------—
functions usable only from CommandHandler