1 files changed, 57 insertions, 0 deletions
diff --git a/dom/media/encoder/fmp4_muxer/MuxerOperation.h b/dom/media/encoder/fmp4_muxer/MuxerOperation.h
new file mode 100644
index 000000000..0b83c89b0
--- /dev/null
+++ b/dom/media/encoder/fmp4_muxer/MuxerOperation.h
@@ -0,0 +1,57 @@
+/* -*- 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<RefPtr<MuxerOperation>>& aOperations) = 0;
+
+protected:
+  virtual ~MuxerOperation() {}
+};
+
+}
+#endif