surface library
🌟 Surface Library
A shapeable, layered, intrinsincally animated container Widget
offering convenient access to blurring ImageFilters,
Material InkResponse, and HapticFeedback.
+ 🏓 BouncyBall
A delightfully bouncy and position-mirroring reaction to user input on a piece of Material.
References
- 🌟 Surface - A shapeable, layered, animated container widget
- 🔰 SurfaceShape from Shape
- Defined by 📐 CornerSpec
- 🔲 Peek - Parameter object to customize 📚
BASE"peek" - 👆 TapSpec - Parameter object to customize tap appearance & behavior
- 🔬 Filter - Parameter object to customize 🤹♂️ filters/effects!
- 🤹♂️ SurfaceFX
Function typedef
- 🤹♂️ SurfaceFX
📚 SurfaceLayer container layering offers robust customization.
- Support for both
Colors andGradients in both 📚 SurfaceLayerBASEandMATERIALlayers. - Support for three different Filter.effects and their strengths.
🔰 Shape customized SurfaceShapes
-
📐 CornerSpec
Shapedescription- Use
cornersto customize all four corners in a Shape and their 🔘radius. - Specify
baseCornersseparately if desired. constCornerSpecs with pre-set configurations available:
- Use
-
➖
BorderSideborders- Add a BorderSide decoration to the edges of this Shape.
- Specify
baseBorderseparately if desired.
-
🔘
CornerBorderRadiusradius- Defers to any Shape.corners or Shape.baseCorners supplied 🔘 CornerSpec.radius, if available.
-
🔛
SurfaceLayerpadLayer- Specify a 📚 SurfaceLayer to receive Surface.padding value.
- Default is 📚
SurfaceLayer.CHILD
-
📏
Shapescaling- See
doublesshapeScaleChild,shapeScaleMaterial,shapeScaleBase
- See
A 🔲 Peek may be provided to alter the Surface "peek"
(MATERIAL inset or "border") with parameter 🔲 Peek.peek.
- Give special treatment, generally a thicker appearance, to selected side(s) by passing 🔲 Peek.alignment and tuning with 🔲 Peek.ratio.
- Note: for true BorderSides, see 🔰 Shape.border.
Specify a 🔬 Filter with options to render 🤹♂️ SurfaceFX backdrop ImageFilters
- In configured 👓 Filter.filteredLayers
Set - Whose radii (🤹♂️
effectstrength) are mapped with 📊 Filter.radiusMap- A 📚 SurfaceLayer.BASE filter may be extended through the Surface.margin with Filter.extendBaseFilter
A 👆 TapSpec offers TapSpec.onTap VoidCallback,
InkResponse customization, and a HapticFeedback shortcut.
References, continued
🏓 BouncyBall
A delightfully bouncy and position-mirroring reaction to user input on a piece of Material.
Turn ink splashes for an InkWell, InkResponse or material Theme
into 🏓 BouncyBalls or 🔮 Glass BouncyBalls
with the built-in InteractiveInkFeatureFactorys,
or design your own with 🪀 BouncyBall.mold.
🎊 Extra Goodies
- 🔦 Shading
Colorextension- ⬛
withBlack.withBlack(int subtract) - ⬜
withWhite.withWhite(int add)
- ⬛
- 🤚 DragNub A small, round "handle" indicator used to visualize impression of draggable material
❗ Consideration
With default 🤹♂️ SurfaceFX 💧 Fx.blurry, only provide
👓 Filter.filteredLayers value for which you intend on
passing each relevant 💧 Filter.radiusMap map parameter.
- Not only are the blurry BackdropFilters expensive, but the inheritance/ancestry behavior is strange.
- If all three filters are active via 👓 Filter.filteredLayers, passing
📊
baseRadius: 0eliminates the remaining children filters, regardless of their passed 📊radius.- This behavior can be worked-around by setting any parent 📚
Layer'sradiusto just above0, specificallyradius > (_MINIMUM_BLUR == 0.0003) 📚 BASE > 📚 MATERIAL > 📚 CHILD- But in this case a different 👓
FilterSpec.filteredLayersSetshould be passed anyway that only activates the correct 📚Layer(s).
- This behavior can be worked-around by setting any parent 📚
Classes
- BouncyBall
-
🏓
BouncyBall - CornerSpec
- 📐 CornerSpec
- DragNub
- Filter
- 🔬 Filter
- FX
- 🤹♂️ Surface FX
- Peek
- 🔲 Peek
- Shape
- 🔰 Shape
- Surface
- 🌟 Surface
- SurfaceShape
- Responsible for accepting a CornerSpec, BorderRadiusGeometry, and optionally a BorderSide description, and generating an OutlinedBorder that may be pathed.
- TapSpec
- 👆 TapSpec
Enums
Typedefs
- SurfaceFX = ImageFilter Function(double specRadius, SurfaceLayer layerForRender)
- 🤹♂️ Surface FX