filmopen_engine_android

A snapshot

This specification is a copy of docs/software/packages/filmopen_engine_android.md in the application’s repository, taken at commit 0b4fe88 of 11 November 2026. It is imported byte for byte and is not edited here; a change is made there, and arrives with the next snapshot.

Generated by scripts/package_digest.py; regenerate, never edit.

An Android-only TimelineEngine using Media3 CompositionPlayer on Flutter’s SurfaceProducer. It plays clips, sounds and scene compositions: trimmed videos, stills and black, with an extracted last-frame hold beyond a video’s source, and audio lanes at their absolute placements and gains. Subtitles are burnt over the picture; markers belong to the dock. Export is unavailable.

Flutter. 4 files, 530 lines under lib/; 32 tests in 3 files. Barrel: lib/filmopen_engine_android.dart.

Depends on

• filmopen_engine — uses EngineCapabilities, EngineClock, EngineEvent, EngineException, EngineItem, EngineOutcome, EnginePresented, EngineTimeline, ExportJob, ExportSettings, ItemKind, MediaProbe, TimelineEngine, TrackKind, frameAt, frameStart

Third-party: ffi.

Used by

filmopen_app

Public API

What the barrel exports, file by file. A name is class, enum, mixin, extension, typedef, a top-level function, getter, setter or variable; under a class, its public constructors, fields, getters, setters and methods.

lib/src/android_engine.dart

• class AndroidEngine — An Android Media3 engine for clips, sounds and scene compositions.
  • AndroidEngine() — Makes an isolated engine without opening a native session.

Internal

Files under lib/ the barrel does not reach; nothing outside the package may import them.

• lib/src/clock_io.dart: _Timespec, _read, _watch, clockChoice, monotonicUs
• lib/src/clock_stub.dart: _watch, monotonicUs, clockChoice