MPEG4 Cleanup (#88)

* Round one

* Round 2

* Fixing up mpeg4box file

* Fix names of box types to match style

* Fix names of box types to match style

* Separate boxes into separate files ... not working yet.

* Decomposing handler type to a bytevector. This is clumsy but will be cleaned up shortly

* Moving rendering to a utility class. Fixes cyclic dependencies

* Adding stuff to index and moving things around to let tests run

* Fixing iso handler box that was broken

* Public fields to properties

* Removing redundant variable typing

* Removing redundant casts

* Removing child factory from isoAudioSampleEntry.ts

* Removing child factory from appleAnnotationBox.ts

* Removing child factory from appleItemListBox.ts and isoMetaBox.ts

* Removing child factory from isoSampleDescriptionBox.ts

* Removing child factory from isoSampleTableBox.ts and isoUserDataBox.ts

* Child factories have been outlawed

* Introduce a handler type class

* Simplify the mpeg4boxtype class

* handler types in a different class

* Rewrite the get* methods

* Some tests

* Single itunes tag tests

* Performer roles (bug fixed), genres

* 99% coverage of appletag

* Pretty much the last cleanup I want to do before another release cycle.

* Leaving a todo

* Ok two more tweaks

Author: benrr101

src/byteVector.ts

@@ -35,18 +35,26 @@ export enum StringType {
     /**
      * @summary The string is to be UTF-16LE encoded.
      */
-    UTF16LE = 4
+    UTF16LE = 4,
+
+    /**
+     * @summary The string is to be encoded as a hex string for each byte (eg, 0x00, 0x12, 0xAF).
+     *     Intended to be used for debugging purposes, only.
+     */
+    Hex = 5
 }
 
 /**
  * Wrapper around the `iconv-lite` library to provide string encoding and decoding functionality.
  */
 export class Encoding {
+    private static readonly HEX_ENCODING_KEY = "hex";
     private static readonly ENCODINGS = new Map<StringType, Encoding>([
         [StringType.Latin1, new Encoding("latin1")],
         [StringType.UTF8, new Encoding("utf8")],
         [StringType.UTF16BE, new Encoding("utf16-be")],
-        [StringType.UTF16LE, new Encoding("utf16-le")]
+        [StringType.UTF16LE, new Encoding("utf16-le")],
+        [StringType.Hex, new Encoding(Encoding.HEX_ENCODING_KEY)]
     ]);
 
     /**
@@ -96,6 +104,13 @@ export class Encoding {
     }
 
     public decode(data: Uint8Array): string {
+        if (this._encoding === Encoding.HEX_ENCODING_KEY) {
+            // Special case for HEX string
+            return data.reduce<string>((accum: string, currentValue) => {
+                return accum + `0x${currentValue.toString(16).padStart(2, "0")} `;
+            }, "");
+        }
+
         // @TODO: The next version of iconv-lite will add Uint8Array to the types for decode. Until
         //    then, I have word it should work w/an 'unsafe' cast. See
         //    https://github.com/ashtuchkin/iconv-lite/issues/293

src/index.ts

@@ -146,7 +146,37 @@ export {default as MpegVideoHeader} from "./mpeg/mpegVideoHeader";
 export {default as MpegXingHeader} from "./mpeg/xingHeader";
 
 // MPEG4 ///////////////////////////////////////////////////////////////////
-export { default as Mpeg4File } from "./mpeg4/mpeg4File";
+export {default as Mpeg4File} from "./mpeg4/mpeg4File";
+export {default as Mpeg4AppleTag} from "./mpeg4/appleTag";
+
+// Boxes
+export {default as Mpeg4BoxType} from "./mpeg4/mpeg4BoxType";
+export {default as Mpeg4AppleAdditionalInfoBox} from "./mpeg4/boxes/appleAdditionalInfoBox";
+export {default as Mpeg4AppleAnnotationBox} from "./mpeg4/boxes/appleAnnotationBox";
+export {
+    AppleDataBox as Mpeg4AppleDataBox,
+    AppleDataBoxFlagType as Mpeg4AppleDataBoxFlagType
+} from "./mpeg4/boxes/appleDataBox";
+export {default as Mpeg4AppleElementaryStreamDescriptor} from "./mpeg4/boxes/appleElementaryStreamDescriptor";
+export {default as Mpeg4AppleItemListBox} from "./mpeg4/boxes/appleItemListBox";
+export {default as Mpeg4FullBox} from "./mpeg4/boxes/fullBox";
+export {default as Mpeg4IsoAudioSampleEntry} from "./mpeg4/boxes/isoAudioSampleEntry";
+export {default as Mpeg4IsoChunkLargeOffset} from "./mpeg4/boxes/isoChunkLargeOffsetBox";
+export {default as Mpeg4IsoChunkOffsetBox} from "./mpeg4/boxes/isoChunkOffsetBox";
+export {default as Mpeg4IsoFreeSpaceBox} from "./mpeg4/boxes/isoFreeSpaceBox";
+export {default as Mpeg4IsoHandlerBox} from "./mpeg4/boxes/isoHandlerBox";
+export {default as Mpeg4IsoMetaBox} from "./mpeg4/boxes/isoMetaBox";
+export {default as Mpeg4IsoMovieHeaderBox} from "./mpeg4/boxes/isoMovieHeaderBox";
+export {default as Mpeg4IsoSampleDescriptionBox} from "./mpeg4/boxes/isoSampleDescriptionBox";
+export {default as Mpeg4IsoSampleEntry} from "./mpeg4/boxes/isoSampleEntry";
+export {default as Mpeg4IsoSampleTableBox} from "./mpeg4/boxes/isoSampleTableBox";
+export {default as Mpeg4IsoUnknownSampleEntry} from "./mpeg4/boxes/isoUnknownSampleEntry";
+export {default as Mpeg4IsoUserDataBox} from "./mpeg4/boxes/isoUserDataBox";
+export {default as Mpeg4IsoVisualSampleEntry} from "./mpeg4/boxes/isoVisualSampleEntry";
+export {default as Mpeg4Box} from "./mpeg4/boxes/mpeg4Box";
+export {default as Mpeg4TextBox} from "./mpeg4/boxes/textBox";
+export {default as Mpeg4UnknownBox} from "./mpeg4/boxes/unknownBox";
+export {default as Mpeg4UrlBox} from "./mpeg4/boxes/urlBox";
 
 // OGG /////////////////////////////////////////////////////////////////////
 export {default as OggFile} from "./ogg/oggFile";