2 Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 /** @file src/decoder.h
21 * @brief Parent class for decoders of content.
24 #ifndef DVDOMATIC_DECODER_H
25 #define DVDOMATIC_DECODER_H
30 #include <boost/shared_ptr.hpp>
31 #include <boost/signals2.hpp>
46 * @brief Parent class for decoders of content.
48 * These classes can be instructed run through their content
49 * (by calling ::go), and they emit signals when video or audio data is ready for something else
55 Decoder (boost::shared_ptr<Film>, boost::shared_ptr<const Options>, Job *);
58 /* Methods to query our input video */
60 /** @return video frames per second, or 0 if unknown */
61 virtual float frames_per_second () const = 0;
62 /** @return native size in pixels */
63 virtual Size native_size () const = 0;
65 virtual int time_base_numerator () const = 0;
66 virtual int time_base_denominator () const = 0;
67 virtual int sample_aspect_ratio_numerator () const = 0;
68 virtual int sample_aspect_ratio_denominator () const = 0;
70 void process_begin ();
71 virtual bool pass () = 0;
75 SourceFrame video_frame () const {
79 virtual void set_audio_stream (boost::optional<AudioStream>);
80 virtual void set_subtitle_stream (boost::optional<SubtitleStream>);
82 boost::optional<AudioStream> audio_stream () const {
86 boost::optional<SubtitleStream> subtitle_stream () const {
87 return _subtitle_stream;
90 std::vector<AudioStream> audio_streams () const {
91 return _audio_streams;
94 std::vector<SubtitleStream> subtitle_streams () const {
95 return _subtitle_streams;
98 /** Emitted when a video frame is ready.
99 * First parameter is the frame within the source.
100 * Second parameter is its index within the content.
101 * Third parameter is either 0 or a subtitle that should be on this frame.
103 boost::signals2::signal<void (boost::shared_ptr<Image>, SourceFrame, boost::shared_ptr<Subtitle>)> Video;
105 /** Emitted when some audio data is ready */
106 boost::signals2::signal<void (boost::shared_ptr<AudioBuffers>, int64_t)> Audio;
110 virtual PixelFormat pixel_format () const = 0;
112 void process_video (AVFrame *);
113 void process_audio (boost::shared_ptr<AudioBuffers>);
114 void process_subtitle (boost::shared_ptr<TimedSubtitle>);
115 void repeat_last_video ();
118 boost::shared_ptr<Film> _film;
120 boost::shared_ptr<const Options> _opt;
121 /** associated Job, or 0 */
124 boost::optional<AudioStream> _audio_stream;
125 boost::optional<SubtitleStream> _subtitle_stream;
127 std::vector<AudioStream> _audio_streams;
128 std::vector<SubtitleStream> _subtitle_streams;
131 void emit_video (boost::shared_ptr<Image>, boost::shared_ptr<Subtitle>);
132 void emit_audio (boost::shared_ptr<AudioBuffers>);
134 SourceFrame _video_frame;
135 int64_t _audio_frame;
137 std::list<boost::shared_ptr<FilterGraph> > _filter_graphs;
139 DelayLine* _delay_line;
140 int _delay_in_frames;
142 boost::shared_ptr<TimedSubtitle> _timed_subtitle;
144 boost::shared_ptr<Image> _last_image;
145 boost::shared_ptr<Subtitle> _last_subtitle;