diff options
| author | Onur Gündüz <ogunduz@gmail.com> | 2026-02-16 06:56:58 +0100 |
|---|---|---|
| committer | Onur Gündüz <ogunduz@gmail.com> | 2026-02-16 06:56:58 +0100 |
| commit | 1034f4d97732e3788dc67edae97ca6030b2934c8 (patch) | |
| tree | 3270deaf4d7fa89ea0cb763ac9d0d7e9b258fd80 /reader.go | |
| parent | 7366f91c9a735b16c70dfc2c5c65ba6651497ecc (diff) | |
| download | mp4-1034f4d97732e3788dc67edae97ca6030b2934c8.tar.gz mp4-1034f4d97732e3788dc67edae97ca6030b2934c8.zip | |
Improve documentation
Diffstat (limited to 'reader.go')
| -rw-r--r-- | reader.go | 45 |
1 files changed, 43 insertions, 2 deletions
@@ -1,4 +1,4 @@ -package bmff +package mp4 // maxDepth limits the reader/writer nesting stack. const maxDepth = 16 @@ -9,7 +9,48 @@ type readerFrame struct { boxEnd int // position to resume after exiting this container } -// Reader provides streaming parsing of ISOBMFF boxes. +// Reader provides hierarchical, in-memory parsing of box data. After loading +// a box's bytes (e.g., from Scanner), create a Reader to iterate children, +// descend into containers, and extract typed fields. +// +// Iterating over top-level boxes: +// +// r := mp4.NewReader(buf) +// for r.Next() { +// fmt.Printf("box: %s size: %d\n", r.Type(), r.Size()) +// } +// +// For container boxes, use Enter/Exit to descend into children: +// +// for r.Next() { +// if r.Type() == mp4.TypeMoov { +// r.Enter() // descend into moov +// for r.Next() { // iterate moov children +// // process trak, mvhd, etc. +// } +// r.Exit() // return to top level +// } +// } +// +// Some boxes have an entry count before child boxes (stsd, dref). +// Use Skip(4) after Enter to skip past the count field: +// +// r.Enter() +// r.Skip(4) // skip entry count +// for r.Next() { +// // process entries +// } +// r.Exit() +// +// Sample entry boxes have fixed-size headers before child boxes. +// Use Skip with the header size (avc1=78, mp4a=28): +// +// r.Enter() +// r.Skip(78) // skip avc1 fixed header +// for r.Next() { +// // process avcC, pasp, etc. +// } +// r.Exit() type Reader struct { buf []byte pos int // next position to parse from |
