mpv_kit_video 0.1.4
mpv_kit_video: ^0.1.4 copied to clipboard
Flutter video output for mpv_kit: zero-copy Vulkan rendering into Flutter textures (D3D11 shared textures on Windows, GL memory objects on Linux, IOSurface on macOS) with a software fallback.
0.1.4 #
- No code changes; version alignment with the provenance re-verification
release (see
native/patches/UPSTREAM.md).
0.1.3 #
- Validated on Dart 3.14.0 / Flutter 3.50.0; no runtime changes. The example
app migrated off the deprecated
package:flutter/material.darttopackage:material_ui(Flutter 3.50 ecosystem split). - Example cleanup: removed 8 unused dependencies (
cupertino_icons,path_provider,crypto,flutter_video_thumbnail_plus,xdg_directories,intl,logger,i18n) verified unreferenced by grep across the whole example;HudEventLog.capacitybecame private.Player.addSubtitlewas audited and kept: it is the only subtitle-load entry point (no plural variant), so removing it would drop functionality.
0.1.2 #
- Changed: depends on
mpv_kit ^0.1.2/mpv_kit_libs ^0.1.2. Verified to resolve together withpath_provider ^2.1.6,file_picker ^13.3.2,shared_preferences ^2.5.6(needs Dart 3.11 / Flutter 3.41 in the app),desktop_drop ^0.8.4,path,cross_file,intl,logger,xdg_directoriesandflutter_video_thumbnail_plus ^1.0.7(no Linux support in that package). - Example: file_picker open dialog, last-file memory (shared_preferences) and separator-safe file names in the drop notice.
0.1.1 #
- Internal: the three identical backend
RendererNameimplementations now shareActiveRendererName. No API or rendering behavior change.
0.1.0-dev.10 #
- Bundled libmpv moved to mpv 0.42.0 (client API 2.6) and libplacebo 7.387.0. The Windows D3D11 render API now comes from upstream, so the local backport patch was dropped; the D3D11 gpu-next path remains in patch 0004 and the public renderer/behavior is unchanged.
- Plugin headers were synchronized to client API 2.6.
- The renderer/candidate chain, frame ring, quarantine and publish gates are unchanged; the 0.42 rebase only adapts to upstream refactors.
0.1.0-dev.9 #
- Fixed: a render error on the D3D11 backend now records the slot's completion through its query before returning, so a slot is never published without a completion marker even if mpv ever reports an error after submitting drawing.
- Fixed: the destructor drains an armed fence completion before closing the
event handle;
WAIT_FAILEDno longer spins until the deadline; the query escalation counter is per backend, so three unusable completions report device loss instead of one per ring slot. - Added: debug injection
alloc-fail:<n>(plain allocation failure) andMpvVideo.capRenderSize;InitSynclogs why the fence path was skipped.
0.1.0-dev.8 #
- Fixed: a D3D11 device loss detected while allocating a new ring (resize) or
returning a render error now emits
deviceLostonce and stops rendering, instead of backing off forever while Dart'sisBrokenstayed false. - Fixed:
ID3D11Fence::Signalfailures are checked; that slot falls back to itsD3D11_QUERY_EVENTcompletion instead of waiting for a value that was never signalled. Three consecutive unusable query completions reportdeviceLostinstead of a 1 s timeout per frame. - Fixed: device creation retries with feature level 11_0 when the runtime
rejects 11_1 with
E_INVALIDARG(backend and interop devices). - Fixed: the Windows plugin no longer dereferences the platform texture
struct after
AcquireFrontreleased the renderer lock (RetainFramenow fillsFrame.handle/Frame.release_contextunder the lock), defersInstancedeletion in the plugin destructor throughUnregisterTexture, and reports a failed texture registration instead oftextureId: -1. - Added (test-only, Windows): injection modes
create-no-11-1,device-removed:alloc,device-removed:render:<n>,signal-fail:<n>,query-getdata-fail, andstats.sync.
0.1.0-dev.7 #
- Fixed: switching to another file no longer shows a black frame.
MpvVideokeeps the last frame's geometry and the texture mounted while mpv reportsvideo-paramsas unavailable, requests the new size at once after a switch instead of after the window-resize debounce, and resets its size state when a different controller is mounted at the same size. - Fixed: a resize that arrives before the previous resize published a frame (render failure or GPU timeout) no longer drops the only picture. The Vulkan, D3D11 and software backends keep their retired survivor until the first new-size frame and the compositor quarantine; backends that do not advertise the capability (OpenGL) keep the old behaviour.
- Added (test-only, Windows plugin): a
statsmethod with lifetimedescribes/nullDescribes/pixels/nullPixelscounters. No Dart public API change.
0.1.0-dev.6 #
- Depends on mpv_kit 0.1.0-dev.6 (8K software-decode thread cap). No changes to the renderer or the platform graphics backends.
0.1.0-dev.5 #
- Depends on mpv_kit / mpv_kit_libs 0.1.0-dev.5 (lower software-decode memory, demuxer cache state API, smaller bundles). No changes to the renderer or the platform graphics backends.
0.1.0-dev.4 #
- Fixed: a failed render no longer causes a false
gpuTimeouton the next frame (the unsignalled timeline value is rolled back). - Fixed: shared images use the external queue family from the first frame, pairing every Vulkan ownership transfer.
- Fixed: a host ICC profile set on the controller survives option changes with the gpu-next renderer.
- Fixed:
MpvVideoEventKind.softwareFallbackwas emitted before any listener could subscribe and so was always lost; it is now delivered to the first listener ofMpvVideoController.events. - Windows: new native Direct3D 11 backend (mpv's D3D11 render API on
Flutter's adapter).
autotriesvulkan/gpu-next,d3d11/gpu-next,vulkan/gpu,d3d11/gpu, then software, andMPV_KIT_VIDEO_API=d3d11forces it. It needs a libmpv built with the D3D11 render API (mpv_kit patch 0010). - Linux: new native OpenGL backend (mpv's OpenGL render API on Flutter's
EGLDisplay) that serves mpv'sgpurenderer.autotriesvulkan/gpu-next,opengl/gpu,vulkan/gpu, then software, andMPV_KIT_VIDEO_API=openglforces it. It needs a libmpv built with GL/EGL. MpvVideoController.reasonnames the API that won and lists oneunavailableentry per candidate tried before it;backendstill reports onlyvulkanorsoftware(ADR 0004). No public API changed.
0.1.0-dev.3 #
- Requires mpv_kit / mpv_kit_libs 0.1.0-dev.3: zero-copy Vulkan rendering works with the bundled libmpv on Windows (dev.1/dev.2 always used the software fallback there).
0.1.0-dev.2 #
- Requires mpv_kit / mpv_kit_libs 0.1.0-dev.2: macOS apps build again (the 0.1.0-dev.1 libraries could not be repackaged by Flutter) and listing audio devices no longer crashes on machines without audio output.
0.1.0-dev.1 #
MpvVideoController/MpvVideo: mpv's Vulkan render backend with zero-copy sharing on Windows (D3D11 shared textures), Linux (GL memory objects) and macOS (IOSurface via MoltenVK), software fallback everywhere.- Renderer choice
MpvVideoRenderer(auto,gpuNext,gpu,software) with the fallback chain gpu-next → gpu → software, the active path reported bybackend/reason, and theMPV_KIT_VIDEO_RENDERERenvironment override. - Dedicated native render thread with a quarantined frame ring, idle detection for hidden windows, and failure backoff.
eventsstream ofMpvVideoEventdiagnostics (resize, idle/active, render errors, GPU timeouts, recovery, device loss) andisBroken.setIccProfilefor display color management.- Persistent shader cache in a per-user directory by default;
display-fps-overrideset from Flutter's display refresh rate. - Render context disposed before the mpv core via
Player.addDisposeHook. - Re-exports
package:mpv_kitand depends onmpv_kit_libs.