b5725a4a83
* Add `--shader-bundle` mode to impellerc that takes a simple JSON spec and produces a single flatbuffer with a pack of named shaders. * Added "single invocation" mode to the impellerc GN templates. * Record vertex attribute reflection information. * Light refactoring of the compiler frontend to make compiler invocations easier to follow. Example shader bundle spec (json form of the yaml spec as shown in the [Flutter GPU](https://docs.google.com/document/d/1Sh1BAC5c_kkuMVreo7ymBzPoMzb7lamZRPsI7GBXv5M/edit?resourcekey=0-5w8u2V-LS41tCHeoE8bDTQ#heading=h.a3gmnzue7wgq) doc): ```json { "UnlitFragment": { "type": "fragment", "file": "shaders/flutter_gpu_unlit.frag" }, "UnlitVertex": { "type": "vertex", "file": "shaders/flutter_gpu_unlit.vert" }, "TextureFragment": { "type": "fragment", "file": "shaders/flutter_gpu_texture.frag" }, "TextureVertex": { "type": "vertex", "file": "shaders/flutter_gpu_texture.vert" } } ``` Example impellerc invocation: ```bash impellerc \ --include=~/projects/flutter/engine/src/flutter/impeller/compiler/shader_lib \ --runtime-stage-metal \ --sl=assets/TestLibrary.shaderbundle \ --shader-bundle='{"UnlitFragment": {"type": "fragment", "file": "shaders/flutter_gpu_unlit.frag"}, "UnlitVertex": {"type": "vertex", "file": "shaders/flutter_gpu_unlit.vert"}, "TextureFragment": {"type": "fragment", "file": "shaders/flutter_gpu_texture.frag"}, "TextureVertex": {"type": "vertex", "file": "shaders/flutter_gpu_texture.vert"}}' ``` Runtime usage: ```dart /// Add a render pass encoder to the command buffer so that we can start /// encoding commands. final encoder = commandBuffer.createRenderPass(renderTarget); /// Load a shader bundle asset. final library = gpu.ShaderLibrary.fromAsset('assets/TestLibrary.shaderbundle')!; /// Create a RenderPipeline using shaders from the asset. final vertex = library['TextureVertex']!; final fragment = library['TextureFragment']!; final pipeline = gpu.gpuContext.createRenderPipeline(vertex, fragment); encoder.bindPipeline(pipeline); ``` https://github.com/flutter/engine/assets/919017/6f3e9a59-d180-4ba6-b14c-fa6d7056965c
Flutter Engine
Flutter is Google's SDK for crafting beautiful, fast user experiences for mobile, web, and desktop from a single codebase. Flutter works with existing code, is used by developers and organizations around the world, and is free and open source.
The Flutter Engine is a portable runtime for hosting Flutter applications. It implements Flutter's core libraries, including animation and graphics, file and network I/O, accessibility support, plugin architecture, and a Dart runtime and compile toolchain. Most developers will interact with Flutter via the Flutter Framework, which provides a modern, reactive framework, and a rich set of platform, layout and foundation widgets.
If you want to run/contribute to Flutter Web engine, more tooling can be found at felt. This is a tool written to make web engine development experience easy.
If you are new to Flutter, then you will find more general information on the Flutter project, including tutorials and samples, on our Web site at Flutter.dev. For specific information about Flutter's APIs, consider our API reference which can be found at the docs.flutter.dev.
Flutter is a fully open source project, and we welcome contributions. Information on how to get started can be found at our contributor guide.