Predefined/Automated Flight Paths

The Paths feature provides the ability to create, save, restore, and playback trajectories through the scene. Example uses would be flight logging or hands-free playback of interesting routes through a geographical area.

A new path is created by opening a new instance; there is only one path defined for a render thread at any one time. Successive viewpoints are added to the path to create its trajectory, each one indexed by its sequence number along the path. The client code may step through the path sequentially, go directly to the begining or end of a path, or go directly to an arbitrary index. The API also supports editing of existing paths.

Path creation and editing functions: PathNew(), PathAdd(), PathDelete(), PathUpdate(), PathDuplicate(), PathUp(), PathDown(), PathSetName(), PathSaveFile(), PathLoadFile(), PathReset().

Functions to control the playback of a path: PathPlay(), PathStop(), PathPause(), PathGoto(), PathGotoStart(), PathGotoEnd(), PathGotoNext(), PathGotoPrev(), PathSetInterpolate(), PathIsPlaying(), PathIsActive().

Miscellaneous functions: tvGetPath(), PathDraw2D().

(Issue: this is presently part of the external interface, called by from ViewPoint.c. Should it be? What is its intention? -- FlyToLocation())

API