Pakete, Repositories und App-Kategorien suchen

Cover von widget_mask
Paketdetailsv1.0.0+0

widget_mask

Verwenden Sie ein Widget, um ein anderes Widget zu maskieren und zu mischen, beispielsweise um Text auf Oberflächen zu übertragen.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
10
Likes
70
Pub-Punkte
150

Paket installieren

flutter pub add widget_mask

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das widget_mask-Paket ermöglicht Entwicklern, ein Widget als Maske zu verwenden, um ein anderes Widget zu schneiden oder zu mischen, wodurch kreative visuelle Effekte wie das Aufdrucken von Text auf Oberflächen möglich werden. Es nutzt die Kompositions-Fähigkeiten von Flutter, um Alpha-Masken anzuwenden, was es ideal für anspruchsvolle UI-Designs mit Transparenz und Schichtung macht. Das Paket ist leichtgewichtig und lässt sich nahtlos in bestehende Flutter-Projekte über mehrere Plattformen hinweg integrieren. Es unterstützt sowohl statische als auch dynamische Maskierungsszenarien und erhöht die Flexibilität bei der Erstellung benutzerdefinierter Widget-Kompositionen.

Anwendungsfälle

  • Textüberlagerungen auf Bildern erstellen
  • Geschichtete Benutzeroberflächenelemente gestalten
  • Benutzerdefinierte Ausschnittpfade implementieren
  • Animierte Maskenübergänge erstellen
  • Visuelle Effekte mit Transparenz erzeugen
  • Verbesserung der App-Branding mit maskierten Grafiken

Hauptmerkmale

  • Unterstützt jedes Widget als Maske
  • Effizientes Rendern mit minimalem Overhead
  • Plattformübergreifende Kompatibilität
  • Flexible Mischmodi
  • Einfache Integration über einfache API
  • Dynamische Maskenaktualisierungen

Geeignet für

  • UI-Designer, die fortgeschrittene visuelle Effekte suchen
  • Entwickler, die markenbezogene oder künstlerische Schnittstellen erstellen
  • Apps, die Text-on-Surface-Effekte erfordern
  • Projekte mit komplexer Schichtung und Transparenz
  • Flutter-Entwickler erkunden kreative Kompositionen

Hinweise

  • Kann die Leistung bei schweren Masken beeinträchtigen
  • Erfordert Verständnis des Flutter-Painting-Systems
  • Beschränkt auf Widgets, die als Masken gerendert werden können
  • Nicht geeignet für Hochfrequenzanimationen ohne Optimierung
  • Am besten mit vorhersehbaren, stabilen Maskenformen verwenden

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

pub.dev package page GitHub Actions CI GitHub Stars

Use a widget to mask and blend another widget, for example to imprint text onto surfaces.


If you're looking for a database solution, check out cbl, another project of mine. It brings Couchbase Lite to standalone Dart and Flutter, with support for:

  • Full-Text Search,
  • Expressive Queries,
  • Data Sync,
  • Change Notifications

and more.


Limitations

Widgets that are used as children of WidgetMask or SaveLayer must not need compositing, or contain widgets which need compositing, such as RepaintBoundary.

This is because this package makes use of save layers, which cannot encompass compositing layers.

Masks and blending

A mask is an image, which is positioned in front of another image and affects this images in some way, where it is not empty.

Blending is a process which takes two images and produces a new image by applying a mathematical function to each pair of pixels from the input images. For some of these functions, the order of the arguments matters. That's why the input images are labeled with src and dst. A mask is usually the image labeled with src.

Getting started

The example below paints some text onto an image. The text is filled with the negative of the image.

WidgetMask(
  // `BlendMode.difference` results in the negative of `dst` where `src`
  // is fully white. That is why the text is white.
  blendMode: BlendMode.difference,
  mask: Center(
    child: Text(
      'Negative',
      style: TextStyle(
        fontSize: 50,
        color: Colors.white,
      ),
    ),
  ),
  child: Image.asset('images/my_image.jpg'),
);

WidgetMask delegates to child to lay itself out. It always has the same size as child. mask is forced to adopt the same size as child and positioned on top it.

During hit testing mask is positioned over child.

The different BlendModes use src and dst to describe how the colors of two images are blended with each other. In the context of WidgetMask mask is the src and child the dst.

Examples

The NegativeMaskedImageDemo widget, in the example app, implements the image at the top.

SaveLayer

This widget paints its child into a save layer and allows you to fully specify the Paint to use with the save layer. If you need to use a custom Paint or require a different layout of the widgets, you can use SaveLayer.

WidgetMask is implement using two SaveLayers to blend the mask and child:

@override
Widget build(BuildContext context) {
  Widget child = Stack(
    textDirection: TextDirection.ltr,
    fit: StackFit.passthrough,
    children: [
      this.child,
      Positioned.fill(
        child: SaveLayer(
          paint: Paint()..blendMode = blendMode,
          child: mask,
        ),
      ),
    ],
  );

  if (childSaveLayer) {
    child = SaveLayer(
      child: child,
    );
  }

  return child;
}

Gabriel Terwesten • GitHub @blaugold • Twitter @GTerwesten • Medium @gabriel.terwesten

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden