mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-06 17:16:12 +00:00
57 lines
2.1 KiB
C++
57 lines
2.1 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-*/
|
||
/* 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 http://mozilla.org/MPL/2.0/. */
|
||
|
||
#include "nsString.h"
|
||
#include "nsTArray.h"
|
||
|
||
#ifndef MuxerOperation_h_
|
||
#define MuxerOperation_h_
|
||
|
||
namespace mozilla {
|
||
|
||
/**
|
||
* The interface for ISO box. All Boxes inherit from this interface.
|
||
* Generate() and Write() are needed to be called to produce a complete box.
|
||
*
|
||
* Generate() will generate all the data structures and their size.
|
||
*
|
||
* Write() will write all data into muxing output stream (ISOControl actually)
|
||
* and update the data which can't be known at Generate() (for example, the
|
||
* offset of the video data in mp4 file).
|
||
*
|
||
* ISO base media format is composed of several container boxes and the contained
|
||
* boxes. The container boxes hold a list of MuxerOperation which is implemented
|
||
* by contained boxes. The contained boxes will be called via the list.
|
||
* For example:
|
||
* MovieBox (container) ---> boxes (array of MuxerOperation)
|
||
* |---> MovieHeaderBox (full box)
|
||
* |---> TrakBox (container)
|
||
* |---> MovieExtendsBox (container)
|
||
*
|
||
* The complete box structure can be found at 14496-12 E.2 "The‘isom’brand".
|
||
*/
|
||
class MuxerOperation {
|
||
public:
|
||
NS_INLINE_DECL_THREADSAFE_REFCOUNTING(MuxerOperation)
|
||
|
||
// Generate data of this box and its contained box, and calculate box size.
|
||
virtual nsresult Generate(uint32_t* aBoxSize) = 0;
|
||
|
||
// Write data to stream.
|
||
virtual nsresult Write() = 0;
|
||
|
||
// Find the box type via its name (name is the box type defined in 14496-12;
|
||
// for example, 'moov' is the name of MovieBox).
|
||
// It can only look child boxes including itself and the box in the boxes
|
||
// list if exists. It can't look parent boxes.
|
||
virtual nsresult Find(const nsACString& aType,
|
||
nsTArray<nsRefPtr<MuxerOperation>>& aOperations) = 0;
|
||
|
||
virtual ~MuxerOperation() {}
|
||
};
|
||
|
||
}
|
||
#endif
|