Skip to content

feat: add disable_dirty_region_management option to fix flickering on iMX8MP (#334)#448

Closed
aki1770-del wants to merge 26 commits intosony:masterfrom
aki1770-del:fix/disable-dirty-region-management-334
Closed

feat: add disable_dirty_region_management option to fix flickering on iMX8MP (#334)#448
aki1770-del wants to merge 26 commits intosony:masterfrom
aki1770-del:fix/disable-dirty-region-management-334

Conversation

@aki1770-del
Copy link
Copy Markdown

Problem

Issue #334 reported display flickering at 1920×1080 on iMX8MP + Weston since flutter-elinux 3.7.6. Two converging causes:

  1. GPU driver alignment: The NXP Vivante GC7000L on iMX8MP mishandles EGL_KHR_partial_update — partial damage rects cause incorrect compositor behaviour, leaving stale regions unredrawn.
  2. Flutter engine bug (#119601): embedder_surface_gl.cc hardcodes supports_partial_repaint = true, so the build-time USE_OPENGL_DIRTY_REGION_MANAGEMENT=OFF flag is overridden by the engine — partial repaints remain active regardless.

The reporter confirmed in #334 (comment) that returning full-screen damage from PopulateExistingDamage eliminates the flickering. @HidenoriMatsubayashi suggested in #334 (comment) that a runtime option to disable dirty region management was the right approach.

Solution

Add disable_dirty_region_management to FlutterDesktopViewProperties. When true:

  • EGL damage extensions (EGL_KHR_partial_update, EGL_EXT/KHR_swap_buffers_with_damage) are not loaded at ELinuxEGLSurface construction — eglSwapBuffers always performs a full swap.
  • PopulateExistingDamage returns full-screen damage immediately, so the Flutter engine schedules a full repaint every frame.
  • Frame damage history is not accumulated (no-op when disabled).

Default is false (zero-initialised) — existing behaviour is fully preserved for all users who do not set this field.

Usage

FlutterDesktopViewProperties props = {};
props.width  = 1920;
props.height = 1080;
// ...
props.disable_dirty_region_management = true;  // iMX8MP workaround

Files changed

File Change
public/flutter_elinux.h Add disable_dirty_region_management field to FlutterDesktopViewProperties
window/native_window.h Add IsDirtyRegionManagementDisabled() accessor + protected field
window/native_window_wayland.h/.cc Thread flag through constructor
window/elinux_window_wayland.cc Pass view_properties_.disable_dirty_region_management to NativeWindowWayland
surface/context_egl.cc Pass flag to ELinuxEGLSurface in both surface creation paths
surface/elinux_egl_surface.h/.cc Implement conditional extension loading, damage history, and early return in PopulateExistingDamage

Fixes #334

lhoward and others added 26 commits December 18, 2025 16:51
The DRM backend failed to translate between view property dimensions (specified
in scaled pixels) and Flutter window mentrics (specified in physical pixels).

This patch fixes two issues: first, given the DRM backend (questionably)
overrides the dimensions specified by the application with the native window
dimensions but neglects to compensate for the current scaling factor.

Secondly, cursor and touch events are not correctly mapped from physical pixels
to scaled pixels.

Signed-off-by: Luke Howard <lukeh@padl.com>
These scripts are heavily based on what sony provided in [1],
with the container environment / cross compilation and some details
fixed up to allow rebuilding an older version more easily.

If these scripts live in the source repo further improvements can be
made to avoid cloning flutter-embedded-linux twice more, but they are
good enough for now, so let's start with what we have.

Link: sony/flutter-elinux#289 (comment) [1]
Build broke with gcc-15 due to `error: unknown type name 'uint8_t'`

Adding cstdint fixes that.
issues do not exist in flutter-elinux repo, so original sony links were kept

Also give thanks to sony for creating the fork
fix: add missing cstdint header
Fix DRM backend dimension scaling
flutter-elinux fork: update most URLs to github.com/flutter-elinux
When building with mesa 20 (debian bullseye) this define is missing,
so backport it.
Building with trixie requires a recent glibc/stdc++ environment
(GLIBC_2.38 / GLIBCXX_3.4.32), which might not be available on the
target environment.

Conversely, as far as libc/stdlib are concerned we are guarnateed to be
able to run an old binary on a newer system, so building on a system as
old as possible should address this particular issue.

Unfortunately libflutter*so also link against system libraries
(GL, X, wayland, fontconfig and many others), so if there is any so bump
or imcompatible ABI then this is still far from perfect:
future improvement should rebuild flutter-embedded-linux on demand for
the required target, from flutter-elinux's CMake configuration

The elinux embedded itself is not hard to build but libflutter_engine.so
will be more work, so settle with "back to the old state" level for now.
required if mutiple platforms are available, otherwise egl may call into
x11 and crash even if gbm is desired. tested on rk3588
Handle zwp_text_input_v1 and zwp_text_input_v3 purpose and hints based
on flutter's TextInputType settings.

This allows on-screen keyboards to adapt and e.g. display a number
keypad on number input.
release build got much bigger since flutter 3.32 (for debug it went from
83MB to 385MB)
This is apparently just because the lib is no longer stripped since [1]

This looks like a bug since we don't target android (tentative fix in
[2]), but until that lands just set --stripped manually.
Even if there is no C symbol dart stacktraces are available so most
people don't need these.

Link: flutter/flutter#161546 [1]
Link: flutter/flutter#181984 [2]
This allows compiling each individual file manually, so should fix any
problem with external projects using our includes in different orders.

Reported-by: Frede Hoey Braendstrup <frede@vokalo.io>
This was rebased manually but the code itself is verbatim.

Tested with squeekboard/niri using the text input v3 protocol.
includes: Add missing dependent headers
release: use old bullseye container for release build
release: strip flutter engine .so again
Previous commit typo'd the ifdef, which made it have no effect.

Since the define is identical the build didn't break for newer versions
and CI didn't complain, but bullseye wasn't fixed as it should have, so
address this.

Fixes: 3ac3f1a ("drm: add DRM_MODE_CONNECTOR_USB define for old releases")
Prevents crashes by clearing cursor_info_.pointer when the pointer
device (e.g., a mouse) disconnects and adding null check in
UpdateFlutterCursor.

Changes:
- Clear cursor_info_.pointer when WL_SEAT_CAPABILITY_POINTER is removed
- Add null check in UpdateFlutterCursor before accessing pointer

Fixes: 434d509 ("Multiple seats (sony#417)")
…e-dangling-ref

Fix cursor_info_.pointer dangling pointer on device disconnect (wayland)
Early fail if we are unable to create a render surface to avoid nullptr
dereference crashes further down the track.

Fixes: sony#14

Signed-off-by: Luke Howard <lukeh@padl.com>
Check CreateRenderSurface() return value
… iMX8MP (sony#334)

Some GPU drivers (e.g. iMX8MP / NXP Vivante GC7000L) mishandle
EGL_KHR_partial_update, causing display flickering when dirty region
management is active. The Flutter engine's embedder_surface_gl.cc
also hardcodes supports_partial_repaint=true (issue #119601), making
the build-time USE_OPENGL_DIRTY_REGION_MANAGEMENT=OFF insufficient.

Add disable_dirty_region_management to FlutterDesktopViewProperties.
When set to true:
- EGL damage extensions (EGL_KHR_partial_update,
  EGL_EXT/KHR_swap_buffers_with_damage) are not loaded at
  ELinuxEGLSurface construction time, so eglSwapBuffers always
  performs a full swap.
- PopulateExistingDamage returns full-screen damage immediately,
  so the Flutter engine schedules a full repaint every frame.
- Frame damage history is not accumulated (no-op when disabled).

Existing behavior is fully preserved for all users who do not set
this flag (zero-initialised = false = management enabled).

Signed-off-by: Akihiko Komada <aki1770@gmail.com>
@aki1770-del aki1770-del force-pushed the fix/disable-dirty-region-management-334 branch from 0919589 to 131c52f Compare April 2, 2026 07:15
@aki1770-del
Copy link
Copy Markdown
Author

Repo has migrated to flutter-elinux/flutter-embedded-linux. Re-opening at https://github.com/flutter-elinux/flutter-embedded-linux.

@aki1770-del aki1770-del closed this Apr 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Flickering occurs since flutter-elinux 3.7.6

8 participants