GetGoalFrame
GetGoalFrame() returns the frame that a path-controlled object is moving to - not counting intermediate
frames. The goal_frame is 0 when the object is not moving to a frame.
Use IsThingMoving() to see if the object is moving
to frame 0 or if the object is not moving but has a goal_frame of 0. Syntax:
goal_frame=GetGoalFrame(object);