Eyevinn / mp4ff
82%
master: 82%

LAST BUILD BRANCH: sphericalv1
DEFAULT BRANCH: master
Repo Added
Files 169
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

LAST BUILD ON BRANCH stream-process
branch: stream-process
CHANGE BRANCH
x

coverage: 81.601% (+0.1%) from 81.501%
18874849030

Pull #465

github

tobbee 
feat: add streaming/incremental processing for fragmented MP4 files.

Add Copy method for StypBox and FtypBox.

Implements support for processing fragmented MP4 files incrementally without
loading entire files into memory. This is essential for handling large media
files, live streaming scenarios, and network streams where fragments arrive
over time.

Key components:

1. StreamFile API (stream.go)
   - DecodeStream/InitDecodeStream: Reads init segment (ftyp, moov) and stops
   - ProcessFragments: Iteratively processes fragments with callbacks
   - Sliding window memory management with configurable retention
   - Fragment lifecycle callbacks for processing and cleanup control

2. BoxSeekReader (boxseekreader.go)
   - Emulates seeking on non-seekable streams using buffered reading
   - Auto-growing buffer sized for current needs
   - Peek operations for looking ahead without consuming data

3. SampleAccessor interface
   - GetSample: Fetch individual samples (1-based indexing)
   - GetSampleRange: Fetch ranges of samples efficiently
   - GetSamples: Fetch all samples for a track

Buffer management:
- ReadFullBox returns a slice view of the buffer (no copy for performance)
- Callers must use data immediately before next operation
- ResetBuffer() explicitly clears buffer after parsing is complete
- Buffer clearing happens after box parsing, not during ReadFullBox
- For mdat seeks, ResetBuffer() called after seek to avoid buffer corruption

Testing:
- Comprehensive test suite using external black-box testing (mp4_test package)
- Tests cover streaming, callbacks, sliding windows, retention, sample access
- All tests use public API only per project guidelines
Pull Request #465: Stream process support with example for on-the-fly MP4 encryption and refragmentation

806 of 962 new or added lines in 7 files covered. (83.78%)

18015 of 22077 relevant lines covered (81.6%)

0.9 hits per line

Relevant lines Covered
22077 RELEVANT LINES 18015 COVERED LINES
0.9 HITS PER LINE
Source Files on stream-process

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
18874849030 stream-process feat: add streaming/incremental processing for fragmented MP4 files. Add Copy method for StypBox and FtypBox. Implements support for processing fragmented MP4 files incrementally without loading entire files into memory. This is essential for ha... Pull #465 tobbee github
81.6
18775892352 stream-process fix: Add trun.AddSampleDefaultValues before extracting samples, add input file option to stream-encrypt Pull #465 tobbee github
81.6
18225472042 stream-process better test coverage Pull #465 tobbee github
81.59
18224928217 stream-process docs: update CHANGELOG.md Pull #465 tobbee github
81.47
See All Builds (182)