-/** Get all frames which exist in the content at a given frame index.
- * @param frame Frame index.
- * @param accurate true to try hard to return frames at the precise time that was requested, otherwise frames nearby may be returned.
- * @return Frames; there may be none (if there is no video there), 1 for 2D or 2 for 3D.
- */
-list<ContentVideo>
-VideoDecoder::get_video (Frame frame, bool accurate)
-{
- if (_no_data_frame && frame >= _no_data_frame.get()) {
- return list<ContentVideo> ();
- }
-
- /* At this stage, if we have get_video()ed before, _decoded_video will contain the last frame that this
- method returned (and possibly a few more). If the requested frame is not in _decoded_video and it is not the next
- one after the end of _decoded_video we need to seek.
- */
-
- _video_content->film()->log()->log (String::compose ("VD has request for %1", frame), LogEntry::TYPE_DEBUG_DECODE);
-
- if (_decoded_video.empty() || frame < _decoded_video.front().frame || frame > (_decoded_video.back().frame + 1)) {
- seek (ContentTime::from_frames (frame, _video_content->video_frame_rate()), accurate);
- }
-
- list<ContentVideo> dec;
-
- /* Now enough pass() calls should either:
- * (a) give us what we want, or
- * (b) give us something after what we want, indicating that we will never get what we want, or
- * (c) hit the end of the decoder.
- */
- if (accurate) {
- /* We are being accurate, so we want the right frame.
- * This could all be one statement but it's split up for clarity.
- */
- while (true) {
- if (!decoded_video(frame).empty ()) {
- /* We got what we want */
- break;
- }
-
- if (pass (PASS_REASON_VIDEO, accurate)) {
- /* The decoder has nothing more for us */
- _no_data_frame = frame;
- break;
- }
-
- if (!_decoded_video.empty() && _decoded_video.front().frame > frame) {
- /* We're never going to get the frame we want. Perhaps the caller is asking
- * for a video frame before the content's video starts (if its audio
- * begins before its video, for example).
- */
- break;
- }
- }
-
- dec = decoded_video (frame);
- } else {
- /* Any frame will do: use the first one that comes out of pass() */
- while (_decoded_video.empty() && !pass (PASS_REASON_VIDEO, accurate)) {}
- if (!_decoded_video.empty ()) {
- dec.push_back (_decoded_video.front ());
- }
- }