OAA Interface

TerraVision supports interaction with SRI's OAA (Open Agent Architecture), and an API exists for application control over this interaction.

The host and port number of the OAA facilitator are set by calls to SetOAAHost() and SetOAAPort() respectively. A convenience function, SetOAAHostPort() allows both parameters to be set with a string argument of the form hostname:port.

Doodles drawn on the screen may be sent to the OAA facilitator for further interpretation. tvBeginStroke() marks the begining of a doodle. Additional coordinates are added incrementally to the doodle with calls to tvContinueStroke() and the collection is terminated with a call to tvEndStroke(). After a timeout period, the doodle is sent to the OAA facilitator and erased from the screen. That timeout duration is set and queried via SetDrawTimeout() and GetDrawTimeout(). The OAA notion of a sentence is cleared by calling ClearSentence().

The OAA facilitator may also control several aspects of a render thread's view. tvMoveViewpoint() can be called to set the viewpoint, while tvResetView() returns the view to the thread's initial view. The view may be rotated with tvRotate(), or translated via tvTranslate(). tvFlyTo() provides a convenient means to perform a smooth, animated flight to a specified point. Any animated motion in the scene is halted with tvStopMotion().
(ISSUE: how is motion established?).

API