Import flutter_shaders package

.github/labeler.yml

@@ -48,6 +48,11 @@
     - any-glob-to-any-file:
       - packages/flutter_plugin_android_lifecycle/**/*
 
+'p: flutter_shaders':
+  - changed-files:
+    - any-glob-to-any-file:
+      - packages/flutter_shaders/**/*
+
 'p: flutter_svg':
   - changed-files:
     - any-glob-to-any-file:

README.md

@@ -46,6 +46,7 @@ These are the packages hosted in this repository:
 | [file\_selector](./packages/file_selector/) | [![pub package](https://img.shields.io/pub/v/file_selector.svg)](https://pub.dev/packages/file_selector) | [![pub points](https://img.shields.io/pub/points/file_selector)](https://pub.dev/packages/file_selector/score) | [![downloads](https://img.shields.io/pub/dm/file_selector)](https://pub.dev/packages/file_selector/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20file_selector?label=)](https://github.com/flutter/flutter/labels/p%3A%20file_selector) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20file_selector?label=)](https://github.com/flutter/packages/labels/p%3A%20file_selector) |
 | [flutter\_lints](./packages/flutter_lints/) | [![pub package](https://img.shields.io/pub/v/flutter_lints.svg)](https://pub.dev/packages/flutter_lints) | [![pub points](https://img.shields.io/pub/points/flutter_lints)](https://pub.dev/packages/flutter_lints/score) | [![downloads](https://img.shields.io/pub/dm/flutter_lints)](https://pub.dev/packages/flutter_lints/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20flutter_lints?label=)](https://github.com/flutter/flutter/labels/p%3A%20flutter_lints) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20flutter_lints?label=)](https://github.com/flutter/packages/labels/p%3A%20flutter_lints) |
 | [flutter\_plugin\_android\_lifecycle](./packages/flutter_plugin_android_lifecycle/) | [![pub package](https://img.shields.io/pub/v/flutter_plugin_android_lifecycle.svg)](https://pub.dev/packages/flutter_plugin_android_lifecycle) | [![pub points](https://img.shields.io/pub/points/flutter_plugin_android_lifecycle)](https://pub.dev/packages/flutter_plugin_android_lifecycle/score) | [![downloads](https://img.shields.io/pub/dm/flutter_plugin_android_lifecycle)](https://pub.dev/packages/flutter_plugin_android_lifecycle/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20flutter_plugin_android_lifecycle?label=)](https://github.com/flutter/flutter/labels/p%3A%20flutter_plugin_android_lifecycle) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20flutter_plugin_android_lifecycle?label=)](https://github.com/flutter/packages/labels/p%3A%20flutter_plugin_android_lifecycle) |
+| [flutter\_shaders](./packages/flutter_shaders/) | [![pub package](https://img.shields.io/pub/v/flutter_shaders.svg)](https://pub.dev/packages/flutter_shaders) | [![pub points](https://img.shields.io/pub/points/flutter_shaders)](https://pub.dev/packages/flutter_shaders/score) | [![downloads](https://img.shields.io/pub/dm/flutter_shaders)](https://pub.dev/packages/flutter_shaders/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20flutter_shaders?label=)](https://github.com/flutter/flutter/labels/p%3A%20flutter_shaders) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20flutter_shaders?label=)](https://github.com/flutter/packages/labels/p%3A%20flutter_shaders) |
 | [flutter\_svg](./third_party/packages/flutter_svg/) | [![pub package](https://img.shields.io/pub/v/flutter_svg.svg)](https://pub.dev/packages/flutter_svg) | [![pub points](https://img.shields.io/pub/points/flutter_svg)](https://pub.dev/packages/flutter_svg/score) | [![downloads](https://img.shields.io/pub/dm/flutter_svg)](https://pub.dev/packages/flutter_svg/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20flutter_svg?label=)](https://github.com/flutter/flutter/labels/p%3A%20flutter_svg) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20flutter_svg?label=)](https://github.com/flutter/packages/labels/p%3A%20flutter_svg) |
 | [flutter\_svg\_test](./third_party/packages/flutter_svg_test/) | [![pub package](https://img.shields.io/pub/v/flutter_svg_test.svg)](https://pub.dev/packages/flutter_svg_test) | [![pub points](https://img.shields.io/pub/points/flutter_svg_test)](https://pub.dev/packages/flutter_svg_test/score) | [![downloads](https://img.shields.io/pub/dm/flutter_svg_test)](https://pub.dev/packages/flutter_svg_test/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20flutter_svg_test?label=)](https://github.com/flutter/flutter/labels/p%3A%20flutter_svg_test) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20flutter_svg_test?label=)](https://github.com/flutter/packages/labels/p%3A%20flutter_svg_test) |
 | [go\_router](./packages/go_router/) | [![pub package](https://img.shields.io/pub/v/go_router.svg)](https://pub.dev/packages/go_router) | [![pub points](https://img.shields.io/pub/points/go_router)](https://pub.dev/packages/go_router/score) | [![downloads](https://img.shields.io/pub/dm/go_router)](https://pub.dev/packages/go_router/score) | [![GitHub issues by-label](https://img.shields.io/github/issues/flutter/flutter/p%3A%20go_router?label=)](https://github.com/flutter/flutter/labels/p%3A%20go_router) | [![GitHub pull requests by-label](https://img.shields.io/github/issues-pr/flutter/packages/p%3A%20go_router?label=)](https://github.com/flutter/packages/labels/p%3A%20go_router) |

packages/flutter_shaders/.gitignore

@@ -0,0 +1,21 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.packages
+.pubspec.lock
+.pub-cache/
+.pub/
+/build/
+.idea/

packages/flutter_shaders/AUTHORS

@@ -0,0 +1,7 @@
+# Below is a list of people and organizations that have contributed
+# to the Flutter project. Names should be added to the list like so:
+#
+#   Name/Organization <email address>
+
+Google Inc.
+The Chromium Authors

packages/flutter_shaders/CHANGELOG.md

@@ -0,0 +1,58 @@
+## 0.1.4
+
+* Transfers the package source from https://github.com/jonahwilliams/flutter_shaders
+  to https://github.com/flutter/packages.
+* Updates metadata in `pubspec.yaml`.
+* Updates minimum supported SDK version to Flutter 3.38/Dart 3.10.
+* Adds [FloatUniformsSetter] interface for configuring float uniforms.
+* Adds documentation comments for public APIs.
+* Updates code for new analysis options.
+
+## 0.1.3
+
+* Remove unecessary location decorations for pixelation shader.
+
+## 0.1.2
+
+* Ensure constructed ui.Picture objects are disposed after usage.
+* Add [SetUniforms] to help constructing FragmentShader uniform data.
+
+## 0.1.1
+
+* Fix `AnimatedSampler` offset assertion to no longer trigger incorrectly when shader is disabled.
+* Fix runtime exception when the `AnimatedSampler` was asked to construct an image with no size.
+
+## 0.1.0
+
+* Update URLs in pubspec.yaml.
+
+## 0.0.6
+
+* Fix bug in `AnimatedSampler` that caused children with non-zero offsets to
+  be rendered offscreen.
+* Removed `offset` parameter from `AnimatedSamplerBuilder`. The offset will
+  always be `Offset.zero` now and this is no longer necessary.
+
+
+## 0.0.5
+
+* Remove restriction on `AnimatedSampler` child repainting.
+
+## 0.0.4
+
+* Added `ShaderInkFeatureFactory` and `ShaderInkFeature` to allow configuration of a
+  material inkwell splash with a developer authored fragment shader and configuration
+  callback
+
+## 0.0.3
+
+* Updated documentation on `AnimatedSampler` to account for `FragmentShader` breaking
+  API changes.
+
+## 0.0.2
+
+ * Add pixelation shader.
+
+## 0.0.1
+
+ * First published version

packages/flutter_shaders/LICENSE

@@ -0,0 +1,25 @@
+Copyright 2013 The Flutter Authors
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Google Inc. nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/flutter_shaders/README.md

@@ -0,0 +1,31 @@
+# flutter_shaders
+
+A collection of utilities to make working with the FragmentProgram API easier.
+
+
+## Available Shaders
+
+This package includes a number of shaders that can be optionally included into your
+application by declaring them in the pubspec.yaml:
+
+### Pixelation
+
+The pixelation shader reduces the provided sampler to MxN samples. This can be used with the [AnimatedSampler] widget. The required uniforms are:
+
+Floats:
+  * The number of pixels in the X coordinate space.
+  * The number of pixels in the Y coordinate space.
+  * The width of the sampled area.
+  * The height of the sampled area.
+Samplers:
+  * The child widget, captured as a texture.
+
+To include this shader in your application, add the following line to
+your pubspec.yaml
+
+```yaml
+flutter:
+  shaders:
+    - packages/flutter_shaders/shaders/pixelation.frag
+
+```

packages/flutter_shaders/example/.gitignore

@@ -0,0 +1,53 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+pubspec.lock
+.pub-cache/
+.pub/
+/build/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release
+
+# Platform directories
+android/
+ios/
+windows/
+web/
+macos/
+linux/

packages/flutter_shaders/example/README.md

@@ -0,0 +1,3 @@
+# example
+
+A project for testing shaders with flutter_shaders

packages/flutter_shaders/example/dart_test.yaml

@@ -0,0 +1,2 @@
+# Fragment shaders are not supported in web unit tests.
+test_on: vm

packages/flutter_shaders/example/lib/main.dart

@@ -0,0 +1,93 @@
+// Copyright 2013 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:ui' as ui;
+
+import 'package:flutter/material.dart';
+import 'package:flutter_shaders/flutter_shaders.dart';
+
+void main() async {
+  final ui.FragmentProgram program = await ui.FragmentProgram.fromAsset('shaders/inkwell.frag');
+  runApp(MyApp(program: program));
+}
+
+/// The main application widget for the shader demo.
+class MyApp extends StatelessWidget {
+  /// Creates the [MyApp] demo widget.
+  const MyApp({super.key, required this.program});
+
+  /// The fragment program used to power shader effects.
+  final ui.FragmentProgram program;
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      title: 'Flutter Demo',
+      theme: ThemeData(
+        primarySwatch: Colors.blue,
+        splashFactory: ShaderInkFeatureFactory(program, (
+          shader, {
+          required double animation,
+          required Color color,
+          required Offset position,
+          required Size referenceBoxSize,
+          required double targetRadius,
+          required TextDirection textDirection,
+        }) {
+          shader.setFloatUniforms(
+            (uniforms) => uniforms
+              ..setFloat(animation)
+              ..setColor(color, premultiply: true)
+              ..setFloat(targetRadius)
+              ..setOffset(position),
+          );
+        }),
+      ),
+      home: const MyHomePage(title: 'Flutter Demo Home Page'),
+    );
+  }
+}
+
+/// The home page widget displaying counter and shader effects.
+class MyHomePage extends StatefulWidget {
+  /// Creates the home page with a given [title].
+  const MyHomePage({super.key, required this.title});
+
+  /// The title displayed in the AppBar.
+  final String title;
+
+  @override
+  State<MyHomePage> createState() => _MyHomePageState();
+}
+
+class _MyHomePageState extends State<MyHomePage> {
+  int _counter = 0;
+
+  void _incrementCounter() {
+    setState(() {
+      _counter++;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: Text(widget.title)),
+      body: Center(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: <Widget>[
+            const Text('You have pushed the button this many times:'),
+            Text('$_counter', style: Theme.of(context).textTheme.headlineMedium),
+          ],
+        ),
+      ),
+      floatingActionButton: FloatingActionButton(
+        onPressed: _incrementCounter,
+        tooltip: 'Increment',
+        child: const Icon(Icons.add),
+      ),
+    );
+  }
+}

packages/flutter_shaders/example/lib/sampler_example.dart

@@ -0,0 +1,77 @@
+// Copyright 2013 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter/material.dart';
+import 'package:flutter_shaders/flutter_shaders.dart';
+
+void main() {
+  runApp(const ExampleApp());
+}
+
+/// The example application widget showcasing shader sampling.
+class ExampleApp extends StatefulWidget {
+  /// Creates the [ExampleApp] widget.
+  const ExampleApp({super.key});
+
+  @override
+  State<ExampleApp> createState() => _ExampleAppState();
+}
+
+class _ExampleAppState extends State<ExampleApp> {
+  double _value = 2.0;
+
+  void _onChanged(double newValue) {
+    setState(() {
+      _value = newValue;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Shaders!')),
+        body: Center(
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              SampledText(text: 'This is some sampled text', value: _value),
+              Slider(value: _value, onChanged: _onChanged, min: 2, max: 50),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+/// A widget that renders text sampled and pixelated through a custom fragment shader.
+class SampledText extends StatelessWidget {
+  /// Creates a [SampledText] widget.
+  const SampledText({super.key, required this.text, required this.value});
+
+  /// The text content to display.
+  final String text;
+
+  /// The pixelation scale value applied to the shader.
+  final double value;
+
+  @override
+  Widget build(BuildContext context) {
+    return ShaderBuilder((context, shader, child) {
+      return AnimatedSampler((image, size, canvas) {
+        shader.setFloatUniforms((uniforms) {
+          uniforms
+            ..setFloat(value)
+            ..setFloat(value)
+            ..setSize(size);
+        });
+
+        shader.setImageSampler(0, image);
+
+        canvas.drawRect(Rect.fromLTWH(0, 0, size.width, size.height), Paint()..shader = shader);
+      }, child: Text(text, style: const TextStyle(fontSize: 20)));
+    }, assetKey: 'packages/flutter_shaders/shaders/pixelation.frag');
+  }
+}