|
1
|
1 #pragma once
|
|
|
2 #include "event_logger.h"
|
|
|
3 #include "audio_chunk.h"
|
|
|
4
|
|
|
5 //! Provides interface to decode various audio data types to PCM. Use packet_decoder_factory_t template to register.
|
|
|
6 class NOVTABLE packet_decoder : public service_base {
|
|
|
7 protected:
|
|
|
8 //! Prototype of function that must be implemented by packet_decoder implementation but is not accessible through packet_decoder interface itself.
|
|
|
9 //! Determines whether specific packet_decoder implementation supports specified decoder setup data.
|
|
|
10 static bool g_is_our_setup(const GUID& p_owner, t_size p_param1, const void* p_param2, t_size p_param2size) { (void)p_owner; (void)p_param1; (void)p_param2; (void)p_param2size; return false; }
|
|
|
11
|
|
|
12 //! Prototype of function that must be implemented by packet_decoder implementation but is not accessible through packet_decoder interface itself.
|
|
|
13 //! Initializes packet decoder instance with specified decoder setup data. This is called only once, before any other methods.
|
|
|
14 //! @param p_decode If set to true, decode() and reset_after_seek() calls can be expected later. If set to false, those methods will not be called on this packet_decoder instance - for an example when caller is only retrieving information about the file rather than preparing to decode it.
|
|
|
15 void open(const GUID& p_owner, bool p_decode, t_size p_param1, const void* p_param2, t_size p_param2size, abort_callback& p_abort) { (void)p_owner; (void)p_decode; (void)p_param1; (void)p_param2; (void)p_param2size; (void)p_abort; throw exception_io_data(); }
|
|
|
16 public:
|
|
|
17
|
|
|
18 //! Prototype of function that must be implemented by packet_decoder implementation but is not accessible through packet_decoder interface itself.
|
|
|
19 //! Returns true if this is not the preferred decoder for this format, another one should be used if found.
|
|
|
20 static bool g_is_supported_partially(const GUID& p_owner, t_size p_param1, const void* p_param2, t_size p_param2size) { (void)p_owner; (void)p_param1; (void)p_param2; (void)p_param2size; return false; }
|
|
|
21
|
|
|
22
|
|
|
23 //! Forwards additional information about stream being decoded. \n
|
|
|
24 //! Calling: this must be called immediately after packet_decoder object is created, before any other methods are called.\n
|
|
|
25 //! Implementation: this is called after open() (which is called by implementation framework immediately after creation), and before any other methods are called.
|
|
|
26 virtual t_size set_stream_property(const GUID & p_type,t_size p_param1,const void * p_param2,t_size p_param2size) = 0;
|
|
|
27
|
|
|
28
|
|
|
29 //! Retrieves additional user-readable tech infos that decoder can provide.
|
|
|
30 //! @param p_info Interface receiving information about the stream being decoded. Note that it already contains partial info about the file; existing info should not be erased, decoder-provided info should be merged with it.
|
|
|
31 virtual void get_info(file_info & p_info) = 0;
|
|
|
32
|
|
|
33 //! Returns many frames back to start decoding when seeking.
|
|
|
34 virtual unsigned get_max_frame_dependency()=0;
|
|
|
35 //! Returns much time back to start decoding when seeking (for containers where going back by specified number of frames is not trivial).
|
|
|
36 virtual double get_max_frame_dependency_time()=0;
|
|
|
37
|
|
|
38 //! Flushes decoder after seeking.
|
|
|
39 virtual void reset_after_seek()=0;
|
|
|
40
|
|
|
41 //! Decodes a block of audio data.\n
|
|
|
42 //! It may return empty chunk even when successful (caused by encoder+decoder delay for an example), caller must check for it and handle it appropriately.
|
|
|
43 //! Called with 0 bytes at the end of stream - if the decoder introduces a delay between input/output, any buffered data should be passed back then.
|
|
|
44 virtual void decode(const void * p_buffer,t_size p_bytes,audio_chunk & p_chunk,abort_callback & p_abort)=0;
|
|
|
45
|
|
|
46 //! Returns whether this packet decoder supports analyze_first_frame() function.
|
|
|
47 virtual bool analyze_first_frame_supported() = 0;
|
|
|
48 //! Optional. Some codecs need to analyze first frame of the stream to return additional info about the stream, such as encoding setup. This can be only called immediately after instantiation (and set_stream_property() if present), before any actual decoding or get_info(). Caller can determine whether this method is supported or not by calling analyze_first_frame_supported(), to avoid reading first frame when decoder won't utiilize the extra info for an example. If particular decoder can't utilize first frame info in any way (and analyze_first_frame_supported() returns false), this function should do nothing and succeed.
|
|
|
49 virtual void analyze_first_frame(const void * p_buffer,t_size p_bytes,abort_callback & p_abort) = 0;
|
|
|
50
|
|
|
51 //! Static helper, creates a packet_decoder instance and initializes it with specific decoder setup data.
|
|
|
52 static void g_open(service_ptr_t<packet_decoder> & p_out,bool p_decode,const GUID & p_owner,t_size p_param1,const void * p_param2,t_size p_param2size,abort_callback & p_abort);
|
|
|
53
|
|
|
54 static const GUID owner_MP4,owner_matroska,owner_MP3,owner_MP2,owner_MP1,owner_MP4_ALAC,owner_ADTS,owner_ADIF, owner_Ogg, owner_MP4_AMR, owner_MP4_AMR_WB, owner_MP4_AC3, owner_MP4_EAC3, owner_MP4_FLAC, owner_MP4_Opus, owner_MP4_MPEGH;
|
|
|
55
|
|
|
56 struct matroska_setup
|
|
|
57 {
|
|
|
58 const char * codec_id;
|
|
|
59 uint32_t sample_rate,sample_rate_output;
|
|
|
60 uint32_t channels;
|
|
|
61 size_t codec_private_size;
|
|
|
62 const void * codec_private;
|
|
|
63 };
|
|
|
64 //owner_MP4: param1 - codec ID (MP4 audio type), param2 - MP4 codec initialization data
|
|
|
65 //owner_MP3: raw MP3/MP2 file, parameters ignored
|
|
|
66 //owner_matroska: param2 = matroska_setup struct, param2size size must be equal to sizeof(matroska_setup)
|
|
|
67
|
|
|
68
|
|
|
69 //these are used to initialize PCM decoder
|
|
|
70 static const GUID property_samplerate,property_bitspersample,property_channels,property_byteorder,property_signed,property_channelmask, property_bufferpadding, property_eventlogger, property_checkingintegrity, property_samples_per_frame;
|
|
|
71 //property_samplerate : param1 == sample rate in hz
|
|
|
72 //property_bitspersample : param1 == bits per sample
|
|
|
73 //property_channels : param1 == channel count
|
|
|
74 //property_byteorder : if (param1) little_endian; else big_endian;
|
|
|
75 //property_signed : if (param1) signed; else unsigned;
|
|
|
76 //propery_bufferpadding : param1 == padding of each passed buffer in bytes; retval: decoder's preferred padding
|
|
|
77 //property_eventlogger : param2 = event logger ptr, NULL to disable, param2size 0 always
|
|
|
78 //property_checkingintegrity : param1 = checking integrity bool flag
|
|
|
79 //property_samples_per_frame : param1 = samples per frame
|
|
|
80
|
|
|
81
|
|
|
82
|
|
|
83 //property_ogg_header : p_param1 = unused, p_param2 = ogg_packet structure, retval: 0 when more headers are wanted, 1 when done parsing headers
|
|
|
84 //property_ogg_query_sample_rate : returns sample rate, no parameters
|
|
|
85 //property_ogg_packet : p_param1 = unused, p_param2 = ogg_packet strucute
|
|
|
86 //property_ogg_qury_preskip : returns preskip samples (Opus)
|
|
|
87 static const GUID property_ogg_header, property_ogg_query_sample_rate, property_ogg_packet, property_ogg_query_preskip;
|
|
|
88
|
|
|
89 //property_mp4_esds : p_param2 = MP4 ESDS chunk content as needed by some decoders
|
|
|
90 static const GUID property_mp4_esds;
|
|
|
91
|
|
|
92 // DEPRECATED
|
|
|
93 static const GUID property_allow_delayed_output;
|
|
|
94
|
|
|
95 // property_mp3_delayless : return non-zero if this codec drops MP3 delay by itself
|
|
|
96 static const GUID property_mp3_delayless;
|
|
|
97
|
|
|
98 // property_query_delay_samples :
|
|
|
99 // Return non-zero if this codec has a decoder delay that the caller should deal with.
|
|
|
100 // Param1 signals sample rate used by input - should always match decoder's sample rate - return zero if it does not match.
|
|
|
101 static const GUID property_query_delay_samples;
|
|
|
102
|
|
|
103 size_t initPadding();
|
|
|
104 void setEventLogger(event_logger::ptr logger);
|
|
|
105 void setCheckingIntegrity(bool checkingIntegrity);
|
|
|
106 void setAllowDelayed( bool bAllow = true );
|
|
|
107
|
|
|
108 FB2K_MAKE_SERVICE_INTERFACE(packet_decoder,service_base);
|
|
|
109 };
|
|
|
110
|
|
|
111 class NOVTABLE packet_decoder_streamparse : public packet_decoder
|
|
|
112 {
|
|
|
113 public:
|
|
|
114 virtual void decode_ex(const void * p_buffer,t_size p_bytes,t_size & p_bytes_processed,audio_chunk & p_chunk,abort_callback & p_abort) = 0;
|
|
|
115 virtual void analyze_first_frame_ex(const void * p_buffer,t_size p_bytes,t_size & p_bytes_processed,abort_callback & p_abort) = 0;
|
|
|
116
|
|
|
117 FB2K_MAKE_SERVICE_INTERFACE(packet_decoder_streamparse,packet_decoder);
|
|
|
118 };
|
|
|
119
|
|
|
120 class NOVTABLE packet_decoder_entry : public service_base {
|
|
|
121 FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(packet_decoder_entry);
|
|
|
122 public:
|
|
|
123 virtual bool is_our_setup(const GUID & p_owner,t_size p_param1,const void * p_param2,t_size p_param2size) = 0;
|
|
|
124 virtual void open(service_ptr_t<packet_decoder> & p_out,bool p_decode,const GUID & p_owner,t_size p_param1,const void * p_param2,t_size p_param2size,abort_callback & p_abort) = 0;
|
|
|
125
|
|
|
126 //! Returns true if this is not the preferred decoder for this format, another one should be used if found.
|
|
|
127 bool is_supported_partially_(const GUID& p_owner, t_size p_param1, const void* p_param2, t_size p_param2size);
|
|
|
128 };
|
|
|
129
|
|
|
130 class NOVTABLE packet_decoder_entry_v2 : public packet_decoder_entry {
|
|
|
131 FB2K_MAKE_SERVICE_INTERFACE(packet_decoder_entry_v2, packet_decoder_entry);
|
|
|
132 public:
|
|
|
133 //! Returns true if this is not the preferred decoder for this format, another one should be used if found.
|
|
|
134 virtual bool is_supported_partially(const GUID& p_owner, t_size p_param1, const void* p_param2, t_size p_param2size) = 0;
|
|
|
135 };
|
|
|
136
|
|
|
137
|
|
|
138 template<class T>
|
|
|
139 class packet_decoder_entry_impl_t : public packet_decoder_entry_v2
|
|
|
140 {
|
|
|
141 public:
|
|
|
142 bool is_our_setup(const GUID & p_owner,t_size p_param1,const void * p_param2,t_size p_param2size) override {
|
|
|
143 return T::g_is_our_setup(p_owner,p_param1,p_param2,p_param2size);
|
|
|
144 }
|
|
|
145 void open(service_ptr_t<packet_decoder> & p_out,bool p_decode,const GUID & p_owner,t_size p_param1,const void * p_param2,t_size p_param2size,abort_callback & p_abort) override {
|
|
|
146 PFC_ASSERT(is_our_setup(p_owner,p_param1,p_param2,p_param2size));
|
|
|
147 service_ptr_t<T> instance = new service_impl_t<T>();
|
|
|
148 instance->open(p_owner,p_decode,p_param1,p_param2,p_param2size,p_abort);
|
|
|
149 p_out = instance.get_ptr();
|
|
|
150 }
|
|
|
151 bool is_supported_partially(const GUID& p_owner, t_size p_param1, const void* p_param2, t_size p_param2size) override {
|
|
|
152 return T::g_is_supported_partially(p_owner, p_param1, p_param2, p_param2size);
|
|
|
153 }
|
|
|
154 };
|
|
|
155
|
|
|
156 template<typename T>
|
|
|
157 class packet_decoder_factory_t : public service_factory_single_t<packet_decoder_entry_impl_t<T> > {};
|
