DASH Media Packaging SDK
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator
segmenter.h
1 // Copyright 2014 Google Inc. All rights reserved.
2 //
3 // Use of this source code is governed by a BSD-style
4 // license that can be found in the LICENSE file or at
5 // https://developers.google.com/open-source/licenses/bsd
6 
7 #ifndef MEDIA_FORMATS_MP4_SEGMENTER_H_
8 #define MEDIA_FORMATS_MP4_SEGMENTER_H_
9 
10 #include <map>
11 #include <memory>
12 #include <vector>
13 
14 #include "packager/media/base/fourccs.h"
15 #include "packager/media/base/status.h"
16 #include "packager/media/formats/mp4/box_definitions.h"
17 
18 namespace shaka {
19 namespace media {
20 
21 struct MuxerOptions;
22 
23 class BufferWriter;
24 class KeySource;
25 class MediaSample;
26 class MediaStream;
27 class MuxerListener;
28 class ProgressListener;
29 
30 namespace mp4 {
31 
32 class Fragmenter;
33 
40 class Segmenter {
41  public:
42  Segmenter(const MuxerOptions& options,
43  std::unique_ptr<FileType> ftyp,
44  std::unique_ptr<Movie> moov);
45  virtual ~Segmenter();
46 
72  Status Initialize(const std::vector<MediaStream*>& streams,
73  MuxerListener* muxer_listener,
74  ProgressListener* progress_listener,
75  KeySource* encryption_key_source,
76  uint32_t max_sd_pixels,
77  uint32_t max_hd_pixels,
78  uint32_t max_uhd1_pixels,
79  double clear_lead_in_seconds,
80  double crypto_period_duration_in_seconds,
81  FourCC protection_scheme);
82 
85  Status Finalize();
86 
92  Status AddSample(const MediaStream* stream,
93  std::shared_ptr<MediaSample> sample);
94 
97  virtual bool GetInitRange(size_t* offset, size_t* size) = 0;
98 
101  virtual bool GetIndexRange(size_t* offset, size_t* size) = 0;
102 
103  uint32_t GetReferenceTimeScale() const;
104 
106  double GetDuration() const;
107 
110  uint32_t sample_duration() const { return sample_duration_; }
111 
112  protected:
114  void UpdateProgress(uint64_t progress);
116  void SetComplete();
117 
118  const MuxerOptions& options() const { return options_; }
119  FileType* ftyp() { return ftyp_.get(); }
120  Movie* moov() { return moov_.get(); }
121  BufferWriter* fragment_buffer() { return fragment_buffer_.get(); }
122  SegmentIndex* sidx() { return sidx_.get(); }
123  MuxerListener* muxer_listener() { return muxer_listener_; }
124  uint64_t progress_target() { return progress_target_; }
125 
126  void set_progress_target(uint64_t progress_target) {
127  progress_target_ = progress_target;
128  }
129 
130  private:
131  virtual Status DoInitialize() = 0;
132  virtual Status DoFinalize() = 0;
133  virtual Status DoFinalizeSegment() = 0;
134 
135  Status FinalizeSegment();
136  uint32_t GetReferenceStreamId();
137 
138  Status FinalizeFragment(bool finalize_segment, Fragmenter* fragment);
139 
140  const MuxerOptions& options_;
141  std::unique_ptr<FileType> ftyp_;
142  std::unique_ptr<Movie> moov_;
143  std::unique_ptr<MovieFragment> moof_;
144  std::unique_ptr<BufferWriter> fragment_buffer_;
145  std::unique_ptr<SegmentIndex> sidx_;
146  std::vector<std::unique_ptr<Fragmenter>> fragmenters_;
147  std::vector<uint64_t> segment_durations_;
148  std::map<const MediaStream*, uint32_t> stream_map_;
149  MuxerListener* muxer_listener_;
150  ProgressListener* progress_listener_;
151  uint64_t progress_target_;
152  uint64_t accumulated_progress_;
153  uint32_t sample_duration_;
154 
155  DISALLOW_COPY_AND_ASSIGN(Segmenter);
156 };
157 
158 } // namespace mp4
159 } // namespace media
160 } // namespace shaka
161 
162 #endif // MEDIA_FORMATS_MP4_SEGMENTER_H_
void UpdateProgress(uint64_t progress)
Update segmentation progress using ProgressListener.
Definition: segmenter.cc:390
void SetComplete()
Set progress to 100%.
Definition: segmenter.cc:406
virtual bool GetInitRange(size_t *offset, size_t *size)=0
This structure contains the list of configuration options for Muxer.
Definition: muxer_options.h:18
uint32_t sample_duration() const
Definition: segmenter.h:110
This class listens to progress updates events.
Status Initialize(const std::vector< MediaStream * > &streams, MuxerListener *muxer_listener, ProgressListener *progress_listener, KeySource *encryption_key_source, uint32_t max_sd_pixels, uint32_t max_hd_pixels, uint32_t max_uhd1_pixels, double clear_lead_in_seconds, double crypto_period_duration_in_seconds, FourCC protection_scheme)
Definition: segmenter.cc:165
KeySource is responsible for encryption key acquisition.
Definition: key_source.h:30
double GetDuration() const
Definition: segmenter.cc:381
virtual bool GetIndexRange(size_t *offset, size_t *size)=0
Status AddSample(const MediaStream *stream, std::shared_ptr< MediaSample > sample)
Definition: segmenter.cc:323