Coverage Report

Created: 2018-09-25 14:53

/src/mozilla-central/dom/media/ogg/OggWriter.cpp
Line
Count
Source (jump to first uncovered line)
1
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-*/
2
/* This Source Code Form is subject to the terms of the Mozilla Public
3
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
4
 * You can obtain one at http://mozilla.org/MPL/2.0/. */
5
#include "OggWriter.h"
6
#include "prtime.h"
7
#include "GeckoProfiler.h"
8
9
#undef LOG
10
#define LOG(args, ...)
11
12
namespace mozilla {
13
14
OggWriter::OggWriter()
15
  : ContainerWriter()
16
  , mOggStreamState()
17
  , mOggPage()
18
  , mPacket()
19
0
{
20
0
  if (NS_FAILED(Init())) {
21
0
    LOG("ERROR! Fail to initialize the OggWriter.");
22
0
  }
23
0
}
24
25
OggWriter::~OggWriter()
26
0
{
27
0
  if (mInitialized) {
28
0
    ogg_stream_clear(&mOggStreamState);
29
0
  }
30
0
  // mPacket's data was always owned by us, no need to ogg_packet_clear.
31
0
}
32
33
nsresult
34
OggWriter::Init()
35
0
{
36
0
  MOZ_ASSERT(!mInitialized);
37
0
38
0
  // The serial number (serialno) should be a random number, for the current
39
0
  // implementation where the output file contains only a single stream, this
40
0
  // serialno is used to differentiate between files.
41
0
  srand(static_cast<unsigned>(PR_Now()));
42
0
  int rc = ogg_stream_init(&mOggStreamState, rand());
43
0
44
0
  mPacket.b_o_s = 1;
45
0
  mPacket.e_o_s = 0;
46
0
  mPacket.granulepos = 0;
47
0
  mPacket.packet = nullptr;
48
0
  mPacket.packetno = 0;
49
0
  mPacket.bytes = 0;
50
0
51
0
  mInitialized = (rc == 0);
52
0
53
0
  return (rc == 0) ? NS_OK : NS_ERROR_NOT_INITIALIZED;
54
0
}
55
56
nsresult
57
OggWriter::WriteEncodedTrack(const EncodedFrameContainer& aData,
58
                             uint32_t aFlags)
59
0
{
60
0
  AUTO_PROFILER_LABEL("OggWriter::WriteEncodedTrack", OTHER);
61
0
62
0
  uint32_t len = aData.GetEncodedFrames().Length();
63
0
  for (uint32_t i = 0; i < len; i++) {
64
0
    if (aData.GetEncodedFrames()[i]->GetFrameType() != EncodedFrame::OPUS_AUDIO_FRAME) {
65
0
      LOG("[OggWriter] wrong encoded data type!");
66
0
      return NS_ERROR_FAILURE;
67
0
    }
68
0
69
0
    // only pass END_OF_STREAM on the last frame!
70
0
    nsresult rv = WriteEncodedData(aData.GetEncodedFrames()[i]->GetFrameData(),
71
0
                                   aData.GetEncodedFrames()[i]->GetDuration(),
72
0
                                   i < len-1 ? (aFlags & ~ContainerWriter::END_OF_STREAM) :
73
0
                                   aFlags);
74
0
    if (NS_FAILED(rv)) {
75
0
      LOG("%p Failed to WriteEncodedTrack!", this);
76
0
      return rv;
77
0
    }
78
0
  }
79
0
  return NS_OK;
80
0
}
81
82
nsresult
83
OggWriter::WriteEncodedData(const nsTArray<uint8_t>& aBuffer, int aDuration,
84
                            uint32_t aFlags)
85
0
{
86
0
  if (!mInitialized) {
87
0
    LOG("[OggWriter] OggWriter has not initialized!");
88
0
    return NS_ERROR_FAILURE;
89
0
  }
90
0
91
0
  MOZ_ASSERT(!ogg_stream_eos(&mOggStreamState),
92
0
             "No data can be written after eos has marked.");
93
0
94
0
  // Set eos flag to true, and once the eos is written to a packet, there must
95
0
  // not be anymore pages after a page has marked as eos.
96
0
  if (aFlags & ContainerWriter::END_OF_STREAM) {
97
0
    LOG("[OggWriter] Set e_o_s flag to true.");
98
0
    mPacket.e_o_s = 1;
99
0
  }
100
0
101
0
  mPacket.packet = const_cast<uint8_t*>(aBuffer.Elements());
102
0
  mPacket.bytes = aBuffer.Length();
103
0
  mPacket.granulepos += aDuration;
104
0
105
0
  // 0 returned on success. -1 returned in the event of internal error.
106
0
  // The data in the packet is copied into the internal storage managed by the
107
0
  // mOggStreamState, so we are free to alter the contents of mPacket after
108
0
  // this call has returned.
109
0
  int rc = ogg_stream_packetin(&mOggStreamState, &mPacket);
110
0
  if (rc < 0) {
111
0
    LOG("[OggWriter] Failed in ogg_stream_packetin! (%d).", rc);
112
0
    return NS_ERROR_FAILURE;
113
0
  }
114
0
115
0
  if (mPacket.b_o_s) {
116
0
    mPacket.b_o_s = 0;
117
0
  }
118
0
  mPacket.packetno++;
119
0
  mPacket.packet = nullptr;
120
0
121
0
  return NS_OK;
122
0
}
123
124
void
125
OggWriter::ProduceOggPage(nsTArray<nsTArray<uint8_t> >* aOutputBufs)
126
0
{
127
0
  aOutputBufs->AppendElement();
128
0
  aOutputBufs->LastElement().SetLength(mOggPage.header_len +
129
0
                                       mOggPage.body_len);
130
0
  memcpy(aOutputBufs->LastElement().Elements(), mOggPage.header,
131
0
         mOggPage.header_len);
132
0
  memcpy(aOutputBufs->LastElement().Elements() + mOggPage.header_len,
133
0
         mOggPage.body, mOggPage.body_len);
134
0
}
135
136
nsresult
137
OggWriter::GetContainerData(nsTArray<nsTArray<uint8_t> >* aOutputBufs,
138
                            uint32_t aFlags)
139
0
{
140
0
  int rc = -1;
141
0
  AUTO_PROFILER_LABEL("OggWriter::GetContainerData", OTHER);
142
0
  // Generate the oggOpus Header
143
0
  if (aFlags & ContainerWriter::GET_HEADER) {
144
0
    OpusMetadata* meta = static_cast<OpusMetadata*>(mMetadata.get());
145
0
    NS_ASSERTION(meta, "should have meta data");
146
0
    NS_ASSERTION(meta->GetKind() == TrackMetadataBase::METADATA_OPUS,
147
0
                 "should have Opus meta data");
148
0
149
0
    nsresult rv = WriteEncodedData(meta->mIdHeader, 0);
150
0
    NS_ENSURE_SUCCESS(rv, rv);
151
0
152
0
    rc = ogg_stream_flush(&mOggStreamState, &mOggPage);
153
0
    NS_ENSURE_TRUE(rc > 0, NS_ERROR_FAILURE);
154
0
    ProduceOggPage(aOutputBufs);
155
0
156
0
    rv = WriteEncodedData(meta->mCommentHeader, 0);
157
0
    NS_ENSURE_SUCCESS(rv, rv);
158
0
159
0
    rc = ogg_stream_flush(&mOggStreamState, &mOggPage);
160
0
    NS_ENSURE_TRUE(rc > 0, NS_ERROR_FAILURE);
161
0
162
0
    ProduceOggPage(aOutputBufs);
163
0
    return NS_OK;
164
0
165
0
  // Force generate a page even if the amount of packet data is not enough.
166
0
  // Usually do so after a header packet.
167
0
  } else if (aFlags & ContainerWriter::FLUSH_NEEDED) {
168
0
    // rc = 0 means no packet to put into a page, or an internal error.
169
0
    rc = ogg_stream_flush(&mOggStreamState, &mOggPage);
170
0
  } else {
171
0
    // rc = 0 means insufficient data has accumulated to fill a page, or an
172
0
    // internal error has occurred.
173
0
    rc = ogg_stream_pageout(&mOggStreamState, &mOggPage);
174
0
  }
175
0
176
0
  if (rc) {
177
0
    ProduceOggPage(aOutputBufs);
178
0
  }
179
0
  if (aFlags & ContainerWriter::FLUSH_NEEDED) {
180
0
    mIsWritingComplete = true;
181
0
  }
182
0
  return (rc > 0) ? NS_OK : NS_ERROR_FAILURE;
183
0
}
184
185
nsresult
186
OggWriter::SetMetadata(TrackMetadataBase* aMetadata)
187
0
{
188
0
  MOZ_ASSERT(aMetadata);
189
0
190
0
  AUTO_PROFILER_LABEL("OggWriter::SetMetadata", OTHER);
191
0
192
0
  if (aMetadata->GetKind() != TrackMetadataBase::METADATA_OPUS) {
193
0
    LOG("wrong meta data type!");
194
0
    return NS_ERROR_FAILURE;
195
0
  }
196
0
  // Validate each field of METADATA
197
0
  mMetadata = static_cast<OpusMetadata*>(aMetadata);
198
0
  if (mMetadata->mIdHeader.Length() == 0) {
199
0
    LOG("miss mIdHeader!");
200
0
    return NS_ERROR_FAILURE;
201
0
  }
202
0
  if (mMetadata->mCommentHeader.Length() == 0) {
203
0
    LOG("miss mCommentHeader!");
204
0
    return NS_ERROR_FAILURE;
205
0
  }
206
0
207
0
  return NS_OK;
208
0
}
209
210
} // namespace mozilla