Source code

Revision control

Other Tools

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim:set ts=2 sw=2 sts=2 et cindent: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at */
#ifndef BOX_H_
#define BOX_H_
#include <stdint.h>
#include "nsTArray.h"
#include "MediaResource.h"
#include "mozilla/EndianUtils.h"
#include "AtomType.h"
#include "BufferReader.h"
namespace mozilla {
class ByteStream;
class BumpAllocator {
uint8_t* Allocate(size_t aNumBytes);
nsTArray<nsTArray<uint8_t>> mBuffers;
class BoxContext {
BoxContext(ByteStream* aSource, const MediaByteRangeSet& aByteRanges)
: mSource(aSource), mByteRanges(aByteRanges) {}
RefPtr<ByteStream> mSource;
const MediaByteRangeSet& mByteRanges;
BumpAllocator mAllocator;
struct ByteSlice {
const uint8_t* mBytes;
size_t mSize;
class Box {
Box(BoxContext* aContext, uint64_t aOffset, const Box* aParent = nullptr);
bool IsAvailable() const { return !mRange.IsEmpty(); }
uint64_t Offset() const { return mRange.mStart; }
uint64_t Length() const { return mRange.mEnd - mRange.mStart; }
uint64_t NextOffset() const { return mRange.mEnd; }
const MediaByteRange& Range() const { return mRange; }
const Box* Parent() const { return mParent; }
bool IsType(const char* aType) const { return mType == AtomType(aType); }
Box Next() const;
Box FirstChild() const;
// Reads the box contents, excluding the header.
nsTArray<uint8_t> Read() const;
// Reads the complete box; its header and body.
nsTArray<uint8_t> ReadCompleteBox() const;
// Reads from the content of the box, excluding header.
bool Read(nsTArray<uint8_t>* aDest, const MediaByteRange& aRange) const;
static const uint64_t kMAX_BOX_READ;
// Returns a slice, pointing to the data of this box. The lifetime of
// the memory this slice points to matches the box's context's lifetime.
ByteSlice ReadAsSlice();
bool Contains(MediaByteRange aRange) const;
BoxContext* mContext;
mozilla::MediaByteRange mRange;
uint64_t mBodyOffset;
uint64_t mChildOffset;
AtomType mType;
const Box* mParent;
// BoxReader serves box data through an AutoByteReader. The box data is
// stored either in the box's context's bump allocator, or in the ByteStream
// itself if the ByteStream implements the Access() method.
// NOTE: The data the BoxReader reads may be stored in the Box's BoxContext.
// Ensure that the BoxReader doesn't outlive the BoxContext!
class MOZ_RAII BoxReader {
explicit BoxReader(Box& aBox)
: mData(aBox.ReadAsSlice()), mReader(mData.mBytes, mData.mSize) {}
BufferReader* operator->() { return &mReader; }
ByteSlice mData;
BufferReader mReader;
} // namespace mozilla