play

Animate FlightGear flight simulator using given position/angle time series

Syntax

play(h)

Description

play(h) animates the FlightGear flight simulator using the time series data specified in h.

Input Arguments

h — Aero.FlightGearAnimation object

Aero.FlightGearAnimation handle

Aero.FlightGearAnimation object. The time series dataset in h is determined by the property TimeSeriesSource.

More About

Algorithm

The time advancement algorithm used by play is based on animation frames counted by ticks:

ticks = ticks + 1;
time  = tstart + ticks*FramesPerSecond*TimeScaling;

where TimeScaling and FramesPerSecond are properties of Aero.FlightGearAnimation object.

For default TimeseriesReadFcn, the last frame played is the last time value.

Time is in seconds and position values are in the same unit as the geometry model to be used by FlightGear (see the property GeometryModelName), and all angles are in radians. Using incorrect units could result in the early termination of the FlightGear flight simulator.

Note

If there is a 15% difference between the expected time advance and the actual time advance, this method will generate this warning:

TimerPeriod has been set to <value>. You may wish to modify the animation
TimeScaling and FramesPerSecond properties to compensate for the 
millisecond limit of the TimerPeriod.  See documentation for details.

play supports FlightGear animation objects with custom timers.

Version History

Introduced in R2007a