liquid_glass_plus 0.3.1

liquid_glass_plus: ^0.3.1 copied to clipboard

Note: This release has breaking changes.

This is the first stable release of liquid_glass_plus, ready for production use.

Breaking Changes #

• BREAKING REFACTOR: removed experimental Glassify widget and experimental.dart exports.

  The Glassify widget was marked experimental with known performance and quality issues. Use LiquidGlass with standard shapes (RoundedRectangle, Oval, Superellipse) instead.

• BREAKING REFACTOR: removed experimental LiquidGlassFilter widget.

  This widget was marked as "might be completely broken" and has been removed.

• BREAKING REFACTOR: removed apple_liquid_glass package.

  This package only re-exported liquid_glass_plus. Use liquid_glass_plus directly.

• BREAKING REFACTOR: LiquidGlassSettings.flat is now a named constructor LiquidGlassSettings.flat() for consistency with other presets.

Features #

• FEAT: added LiquidGlassSettings.minimal() and LiquidGlassSettings.subtle() presets.

  Convenience constructors for common glass effect configurations.

• FEAT: added implicit animations for shape and settings changes.

  Changes to LiquidShape and LiquidGlassSettings now animate smoothly by default. Set animationDuration to Duration.zero to disable.

Improvements #

• DOCS: improved library documentation with quick start example.
• DOCS: clarified LiquidStretch as optional feature with disable instructions.
• DOCS: updated LiquidRoundedSuperellipse documentation to be platform-neutral.
• DOCS: improved glassContainsChild documentation to clarify behavior.
• CHORE: cleaned up dead shader references from codebase.
• CHORE: removed debug print statements from production code.
• CHORE: added parameter validation assertions.

Note: This release has breaking changes.

• BREAKING REFACTOR: removed experimental Glassify widget and experimental.dart exports.

  The Glassify widget was marked experimental with known performance and quality issues. Use LiquidGlass with standard shapes (RoundedRectangle, Oval, Superellipse) instead.

• BREAKING REFACTOR: removed experimental LiquidGlassFilter widget.

  This widget was marked as "might be completely broken" and has been removed.

• BREAKING REFACTOR: removed apple_liquid_glass package.

  This package only re-exported liquid_glass_plus. Use liquid_glass_plus directly.

• FEAT: added LiquidGlassSettings.minimal() and LiquidGlassSettings.subtle() presets.

  Convenience constructors for common glass effect configurations.

• DOCS: improved library documentation with quick start example.

• DOCS: clarified LiquidStretch as optional feature with disable instructions.

• DOCS: updated LiquidRoundedSuperellipse documentation to be platform-neutral.

• CHORE: cleaned up dead shader references from codebase.

Note: This release has breaking changes.

• BREAKING FIX: fake glass didn't render properly on skia and had bad specular highlights (#119).

• FIX: improve logging readability and names.

• FIX: don't create intermediate images for geometry until it's settled.

  This should decrease memory consumption somewhat, as a layer with one animating geometry would create 2 images per frame before

• FEAT: export debugPaintLiquidGlassGeometry (#111).

• FIX: glass was always grouped no matter which constructor was used.
• FIX: one frame delay in geometry mattes.
• FIX: link doesn't need to notify listeners, we can mark it dirty.

Note: This release has breaking changes.

• FIX: adjust LiquidGlassSettings defaults to match the look more closely.

• FEAT: cache geometry images as well to make sure we only run the geometry shader when absolutely necessary.

• DOCS: mention Impeller requirement earlier in README.

• DOCS: update README with newest changes and performance tips.

• BREAKING REFACTOR: renamed many constructors and default LiquidGlass to not creating its own layer.

  Please read the README to understand how to use this package.

• BREAKING REFACTOR: LiquidGlassShapes now take a simple double as radius.

• BREAKING FEAT: adjust fake glass light intensity.

• BREAKING FEAT: rewrote rendering pass to use two passes.

  We now cache all geometry into textures first, then render liquid glass in a second pass. This allows us to save a lot of cycles while glass shapes are static.

Note: This release has breaking changes.

• FIX: only run shader on bounding box pixels.

• FIX: set alwaysNeedsCompositing correctly on FakeGlass.

• BREAKING REFACTOR: change default blend value to 0 in LiquidGlassSettings.

• BREAKING REFACTOR: move fake parameter to LiquidGlassLayer and make entire layer fall back to fake glass on Skia.

• BREAKING FEAT: visibility parameter in LiquidGlassSettings.

  This can be used to scale all relevant properties of the liquid glass effect at once.

  If you have made glass appear and disappear manually before, you can now simply animate the visibility between 0 and 1.

• FEAT: add fake parameter to LiquidGlass to enable it to turn into FakeGlass dynamically (#103).

• FIX: import @internal from meta again (#102).
• FIX: scrolling elements work again.
• FEAT: add FakeGlass.inLayer which adopts settings from the nearest ancestor layer.

Note: This release has breaking changes.

• BREAKING FEAT: re-use generated geometry more aggressively (#98).

Note: This release has breaking changes.

• FIX: reduce texture samples (#94).

• FEAT: small performance wins in shader (#91).

• BREAKING REFACTOR: remove restrictThickness.

• BREAKING FEAT: rewrote the rendering process to use two passes.

  This significantly improves performance while glass elements are static on screen. Moving glass elements will still induce the same performance cost as before.

Note: This release has breaking changes.

• BREAKING FIX: drop support for blur in Glassify for significant performance gains (#90).

• FIX: resistance parameter didn't actually get used.

Note: This release has breaking changes.

• FIX: revert matrix methods to support older Flutter versions again.
• FIX: TileMode.mirror in FakeGlass blur.
• FEAT: allow customizing resistance in LiquidStretch.
• FEAT: expose RawLiquidStretch for custom pixel-based stretching.
• FEAT: expose Offset.withResistance extension method.
• BREAKING REFACTOR: move Glassify to an experimental.dart import.
• BREAKING FEAT: LiquidStretch now bases its stretch on the child's size.

• FIX: removed unused transform from shader (#88).
• FIX: render liquid glass correctly on all Android devices (#82 by @teociaps).

• FEAT: tried to improve the fidelity of fake light once more.

• FIX: import annotations from package:meta again.

Note: This release has breaking changes.

• FIX: settling springs.
• FIX: optimize some painting and transformations with early return.
• FEAT: better specular on all platforms for FakeGlass (#83).
• BREAKING REFACTOR: rename StretchGlass to LiquidStretch.

• FIX: LiquidGlassLayer breaks when no child glass widgets are found.

• DOCS: update README and add better disclaimer (#80).

Note: This release has breaking changes.

• FIX: regression in how LiquidGlass applies transform to children.
• FEAT: add GlassGlowLayer and GlassGlow widget for glow effects.
• FEAT: add StretchGlass widget that can stretch its child with user gestures.
• FEAT: add FakeGlass widget that aims to match LiquidGlass appearance while being much more performant.
• BREAKING REFACTOR: remove useless lightness parameter from shader and LiquidGlassSettings.
• BREAKING REFACTOR: change default value of glassContainsChild to false.

Note: This release has breaking changes.

• BREAKING FEAT: performance gains and too many changes to cover one by one (#72).

Note: This release has breaking changes.

• REFACTOR: move shader to uniform arrays for better shape support.
• FIX: transform children of liquid glass correctly.
• FEAT: add saturation and brightness controls (#47).
• FEAT: better light dispersion.
• FEAT: support up to 64 shapes per layer.
• FEAT: specular highlights now take the background color into account (#43).
• DOCS: updated README with new parameters (#56).
• DOCS: updated example gif (#55).
• BREAKING FEAT: cheat lighting that is independent from thickness.

• DOCS: fix errors in README (#31).

• FEAT: added experimental Glassify widget that turns any child shape into liquid glass.
• FIX: glass now also renders when blend is set to 0.
• FIX: sharper glass edges whithout background shining through.
• FEAT: added refractive index to settings and show values in example.
• FEAT: nicer specular highlights.
• DOCS: update README.md and add better examples (#28)

• FIX: throw AssertionError when used without Impeller.
• DOCS: update pubspec.yaml to reflect minimum SDK and supported platforms.

• FIX: liquid glass not repainting in route transitions (#16).

Note: This release has breaking changes.

• FEAT: decrease precision in shader to mediump, which should increase performance.
• BREAKING FIX: shader compilation and removed unused outline strength parameter.

• FIX: fix shader on flutter stable.
• DOCS: new shape names.

• DOCS: new shape names.

Note: This release has breaking changes.

• REFACTOR: cleaned up shaders.
• FIX: squircle can handle zero radius.
• FEAT: add clipBehavior to LiquidGlass.
• FEAT: flutter-approved SDF for squircles.
• FEAT: support three shapes per layer.
• FEAT: support all shapes.
• FEAT: better chromatic abberation.
• DOCS: added pub badge to README.
• BREAKING FEAT: renamed liquid glass shapes to match their OutlinedBorder counterparts.

• DOCS: update pubspec and readme.

• FEAT: initial release.

• feat: initial commit 🎉