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 <sigc++/sigc++.h>
33 #include <libswresample/swresample.h>
45 * @brief Parent class for decoders of content.
47 * These classes can be instructed run through their content
48 * (by calling ::go), and they emit signals when video or audio data is ready for something else
54 Decoder (boost::shared_ptr<const FilmState>, boost::shared_ptr<const Options>, Job *, Log *, bool, bool);
57 /* Methods to query our input video */
59 /** @return length in video frames */
60 virtual int length_in_frames () const = 0;
61 /** @return video frames per second, or 0 if unknown */
62 virtual float frames_per_second () const = 0;
63 /** @return native size in pixels */
64 virtual Size native_size () const = 0;
65 /** @return number of audio channels */
66 virtual int audio_channels () const = 0;
67 /** @return audio sampling rate in Hz */
68 virtual int audio_sample_rate () const = 0;
69 /** @return format of audio samples */
70 virtual AVSampleFormat audio_sample_format () const = 0;
71 virtual int64_t audio_channel_layout () const = 0;
73 void process_begin ();
78 /** @return the index of the last video frame to be processed */
79 int last_video_frame () const {
83 int decoding_frames () const;
85 /** Emitted when a video frame is ready.
86 * First parameter is the frame.
87 * Second parameter is its index within the content.
89 sigc::signal<void, boost::shared_ptr<Image>, int> Video;
91 /** Emitted when some audio data is ready.
92 * First parameter is the interleaved sample data, format is given in the FilmState.
93 * Second parameter is the size of the data.
95 sigc::signal<void, uint8_t *, int> Audio;
98 /** perform a single pass at our content */
99 virtual bool do_pass () = 0;
100 virtual PixelFormat pixel_format () const = 0;
101 virtual int time_base_numerator () const = 0;
102 virtual int time_base_denominator () const = 0;
103 virtual int sample_aspect_ratio_numerator () const = 0;
104 virtual int sample_aspect_ratio_denominator () const = 0;
106 void process_video (AVFrame *);
107 void process_audio (uint8_t *, int);
110 boost::shared_ptr<const FilmState> _fs;
112 boost::shared_ptr<const Options> _opt;
113 /** associated Job, or 0 */
115 /** log that we can write to */
118 /** true to do the bare minimum of work; just run through the content. Useful for acquiring
119 * accurate frame counts as quickly as possible. This generates no video or audio output.
123 /** ignore_length Ignore the content's claimed length when computing progress */
127 void setup_video_filters ();
129 /** last video frame to be processed */
132 AVFilterContext* _buffer_src_context;
133 AVFilterContext* _buffer_sink_context;
135 SwrContext* _swr_context;
137 bool _have_setup_video_filters;
138 DelayLine* _delay_line;
141 /* Number of audio frames that we have pushed to the encoder
142 (at the DCP sample rate).
144 int _audio_frames_processed;