ImageFilter.blur default tile mode automatic selection.

The ui.ImageFilter.blur's default tile mode is now automatically selected by the backend. Previously TileMode.clamp was used unless a different tile mode was specified. Now, the default is null and specifies automatic selection unless a specific tile mode is specified.

ImageFilter.blur's tile mode specifies what happens to edge pixels for the applied filter. There are four options, TileMode.clamp (the previous default), Tilemode.repeated, TileMode.mirror, and TileMode.decal. Previously, ImageFilter defaulted to clamp mode if the behavior wasn't specified, which sometimes surprised developers as it didn't always match expectations.

As of this change, the filter automatically selects the following tile modes based on context:

• decal with save layers and when applied to individual shape draws (drawRect, drawPath, ...)
• mirror with backdrop filters.
• clamp for drawImage.

Only blur image filters that don't specify an explicit tile mode are impacted by this change. We believe that the new defaults are generally better and would recommend removing any specified blur tile modes.

Code before migration:

var filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4, tileMode: TileMode.decal);

Code after migration:

var filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4);

Landed in version: 3.27.0-1.0.pre.30 In stable release: Not yet

API documentation:

• ImageFilter
• TileMode

Relevant issues:

• Issue #154935
• Issue #110318
• Issue #157693

Relevant PRs:

• Change default TileMode for blur ImageFilter objects to null

Unless stated otherwise, the documentation on this site reflects the latest stable version of Flutter. Page last updated on 2024-11-01. View source or report an issue.