sofia

README

sofia

And, in the dream, I knew that he was, going on ahead. He was fixin' to make a fire somewhere out there in all that dark and cold. And I knew that whenever I got there, he'd be there. And then I woke up.

No Country for Old Men (2007)

ISOBMFF

library for reading and writing MP4

prior art

1. https://github.com/mozilla/mp4parse-rust/issues/415
2. https://github.com/Eyevinn/mp4ff/issues/311
3. https://github.com/alfg/mp4-rust/issues/132
4. https://github.com/yapingcat/gomedia/issues/115
5. https://github.com/alfg/mp4/issues/27
6. https://github.com/abema/go-mp4/issues/13
7. https://github.com/garden4hu/fmp4parser-go/issues/4
8. https://github.com/eswarantg/mp4box/issues/3
9. https://github.com/miquels/mp4/issues/2

progress

• 1 enca
• 2 encv
• 3 frma
• 4 mdat
• 5 mdia
• 6 minf
• 7 moof
• 8 moov
• 9 pssh
• 10 schi
• 11 senc
• 12 sidx
• 13 sinf
• 14 stbl
• 15 stsd
• 16 tenc
• 17 tfhd
• 18 traf
• 19 trak
• 20 trun

Documentation

Index

• type Appender
• type Box
  • func (b *Box) Append(buf []byte) ([]byte, error)
  • func (b *Box) Read(buf []byte) error
• type BoxHeader
  • func (b *BoxHeader) Append(buf []byte) ([]byte, error)
  • func (b *BoxHeader) Decode(buf []byte) (int, error)
  • func (b *BoxHeader) GetSize() int
• type Decoder
• type Error
  • func (e *Error) Error() string
• type FullBoxHeader
  • func (f *FullBoxHeader) Append(buf []byte) ([]byte, error)
  • func (f *FullBoxHeader) Decode(buf []byte) (int, error)
  • func (f *FullBoxHeader) GetFlags() uint32
• type Reader
• type SampleEntry
  • func (s *SampleEntry) Append(buf []byte) ([]byte, error)
  • func (s *SampleEntry) Decode(buf []byte) (int, error)
• type Type
  • func (t Type) String() string
• type Uuid
  • func (u Uuid) String() string

Types

type Appender

type Appender interface {
	Append([]byte) ([]byte, error)
}

type Box

type Box struct {
	BoxHeader BoxHeader
	Payload   []byte
}

ISO/IEC 14496-12

aligned(8) class Box (
   unsigned int(32) boxtype,
   optional unsigned int(8)[16] extended_type
) {
   BoxHeader(boxtype, extended_type);
   // the remaining bytes are the BoxPayload
}

func (*Box) Append

func (b *Box) Append(buf []byte) ([]byte, error)

func (*Box) Read

func (b *Box) Read(buf []byte) error

type BoxHeader

type BoxHeader struct {
	Size     uint32
	Type     Type
	UserType Uuid
}

ISO/IEC 14496-12

aligned(8) class BoxHeader (
   unsigned int(32) boxtype,
   optional unsigned int(8)[16] extended_type
) {
   unsigned int(32) size;
   unsigned int(32) type = boxtype;
   if (size==1) {
      unsigned int(64) largesize;
   } else if (size==0) {
      // box extends to end of file
   }
   if (boxtype=='uuid') {
      unsigned int(8)[16] usertype = extended_type;
   }
}

func (*BoxHeader) Append

func (b *BoxHeader) Append(buf []byte) ([]byte, error)

func (*BoxHeader) Decode

func (b *BoxHeader) Decode(buf []byte) (int, error)

func (*BoxHeader) GetSize

func (b *BoxHeader) GetSize() int

type Decoder

type Decoder interface {
	Decode([]byte) (int, error)
}

type Error

type Error struct {
	Container BoxHeader
	Box       BoxHeader
}

func (*Error) Error

func (e *Error) Error() string

type FullBoxHeader

type FullBoxHeader struct {
	Version uint8
	Flags   [3]byte
}

ISO/IEC 14496-12

aligned(8) class FullBoxHeader(unsigned int(8) v, bit(24) f) {
   unsigned int(8) version = v;
   bit(24) flags = f;
}

func (*FullBoxHeader) Append

func (f *FullBoxHeader) Append(buf []byte) ([]byte, error)

func (*FullBoxHeader) Decode

func (f *FullBoxHeader) Decode(buf []byte) (int, error)

func (*FullBoxHeader) GetFlags

func (f *FullBoxHeader) GetFlags() uint32

type Reader

type Reader interface {
	Read([]byte) error
}

type SampleEntry

type SampleEntry struct {
	BoxHeader          BoxHeader
	Reserved           [6]uint8
	DataReferenceIndex uint16
}

ISO/IEC 14496-12

aligned(8) abstract class SampleEntry(
   unsigned int(32) format
) extends Box(format) {
   const unsigned int(8)[6] reserved = 0;
   unsigned int(16) data_reference_index;
}

func (*SampleEntry) Append

func (s *SampleEntry) Append(buf []byte) ([]byte, error)

func (*SampleEntry) Decode

func (s *SampleEntry) Decode(buf []byte) (int, error)

type Type

type Type [4]uint8

func (Type) String

func (t Type) String() string

type Uuid

type Uuid [16]uint8

func (Uuid) String

func (u Uuid) String() string