 |
Implemented SVN revision 6931. Added idCinematic::GetStatus virtual function, which returns whether the video is playing (FMV_PLAY), has not started playing yet (FMV_IDLE), or has finished playing already (FMV_EOF). Note that this function simply returns FMV_PLAY for legacy ROQ cinematics implementation. Previously this status could only be obtained from the result of ImageForTime call, but that call needs proper renderer backend time argument, and in any case it might have side effects. Each GUI window regularly checks status of its background cinematics in its "time" function (idWindow::Time). If status is FMV_EOF, then named event "CinematicEnd" of the window is triggered immediately. This allows to change GUI exactly when the video ends without the need to hard-code video duration. Note that the video is also closed (idCinematic::Close) when CinematicEnd is issued. This is necessary for idCinematicFFmpeg for two reasons: 1. Avoid triggering the event again during next frames (because status changes to FMV_IDLE after idCinematic::Close). 2. Avoid triggering the event when the video is restarted. The problem here is that when video is restarted, idWindow::Time happens before idCinematic::ResetTime method is called. At that moment cinematics is still in FMV_EOF state if we do not call idCinematic::Close explicitly. It is worth noting that calling idCinematic::Close for legacy ROQ cinematic prevents the video from being played ever in future, because it cleans even the filename. Luckily, we call idCinematic::Close only when idCinematic::GetStatus returns FMV_EOF, and legavy ROQ cinematic always returns FMV_PLAY status. |
|
|
This forum post describes well how to use the feature from GUI scripts: http://forums.thedarkmod.com/topic/18820-why-roq/?p=407624 |
|
|
Due to related issue 4547, now Close method is called only when CinematicEnd event handler is actually present. If no one listens to this event, then cinematics is not closed. |
- Anonymous
