flutter_scene 0.20.0

A flexible realtime 3D engine for Flutter games and apps, with glTF models, physics, skeletal animation, and PBR lighting.

0.20.0

• The .fscene document core (document model, stable ids, JSON/binary serialization, prefab composition, diffing) moved to the new pure-Dart scene package; flutter_scene re-exports it, so existing imports are unchanged.
• Fixed the web backend dropping every uniform-block draw on drivers that pad uniform block sizes (Mesa on Linux).
• New declarative scene API. SceneView.declarative, SceneNode, SceneMesh, and SceneModel describe scenes in build(), with bridges to and from the imperative API, which is unchanged.
• Declarative animation control via SceneModel.animations (SceneAnimationSpec), plus cached model templates so equal sources load once and share GPU resources.
• KHR_materials_variants support in both import paths via MaterialsVariantsComponent, declaratively via SceneModel.variant, with a new Configurator example.
• Fixed animation blending collapsing rigs with mirrored bones.
• Fixed slerp taking the long arc when interpolating between quaternions in opposite hemispheres.
• Automatic exposure (eye adaptation) via Scene.autoExposure, metered entirely on the GPU.
• Imported materials keep their source names via the new Material.name.
• Fixed cloned skinned meshes all drawing with the last-updated skeleton.
• Physics backends now implement the pure PhysicsSimulation contract from the scene package and no longer depend on Flutter, so the same simulations run under plain dart run.
• One generic physics component layer for every backend. PhysicsWorld(RapierWorld()), plus concrete RigidBody, Collider, the joint components, and KinematicCharacterController; the backend-specific component classes are gone.
• Backend-specific physics features stay first-class. RigidBody.handle, Collider.handles, and Joint.handle are public, so downcasting PhysicsWorld.simulation to a backend reaches capabilities beyond the shared contract, and the components subclass for typed backend components.
• Physics is now an optional sub-barrel. Import package:flutter_scene/physics.dart (or package:scene/physics.dart for the pure contract); the core package:flutter_scene/scene.dart no longer carries physics types.
• BasicSimulation (queries and triggers, pure Dart) replaces BasicPhysicsWorld/BasicCollider/BasicKinematicBody.
• Colliders without a sibling RigidBody now attach as static geometry instead of throwing.
• Spatial audio through an optional pluggable-backend contract. AudioEngine (implemented by flutter_scene_soloud and flutter_scene_fmod), with AudioListener, AudioSource/ClipAudioSource, AudioBus, and distance attenuation. Import package:flutter_scene/audio.dart; it is not in the core barrel.
• CPU particle systems are now public. ParticleEmitterComponent (camera-facing billboards), MeshParticleEmitterComponent (instanced 3D debris), and TrailComponent (ribbon trails), all driven by a ParticleSystem built from emitter shapes, spawners, over-life distributions, and a module stack (acceleration, drag, size/color-over-life, rotation, flipbook, curl-noise turbulence), with new Particles and Explosion examples.
• Sprites and billboard particles depth-test against opaque geometry again, so closer objects occlude them.

0.19.0

• Steady-state frame allocations cut sharply. Fullscreen passes reuse cached pipelines and per-draw uniform packs reuse scratch buffers.
• Faster draw submission. Bindings clear only on pipeline change and the engine lighting set rebinds only when it actually changes.
• Cheaper MeshGeometry.fromArrays for streamed meshes. Bulk attribute copies, no repack for typed index lists, and an optional caller-supplied bounds.
• Depth of field with shaped bokeh via scene.depthOfField, driven by a thin-lens camera model with three quality tiers.
• Cached shadow tiles for nodes marked shadowStatic, making static-world shadow rendering near free.
• Alpha-masked materials are now alpha-tested in the shadow and depth passes, so cutouts cast and receive correctly.
• Materials can declare per-frame scene inputs (scene_color, scene_depth) for refraction and depth-fade effects, and MaterialInputs gains specular.
• Fixed .fmat skies with requires: [environment] sampling black on the roughness-mip layout, and ShaderSkySource.sampledEnvironment pins the sampled map.
• The lit shader reads diffuse SH through one sampler, fixing skinned-mesh crashes on 16-unit GLES drivers (ANGLE on Windows).
• Fixed white speckles in compressed textures on devices preferring BC formats.
• Scene-graph conveniences. Node.meshNodes, Node.combinedWorldBounds, and PerspectiveCamera.framing.
• 3D Gaussian splatting. Load .ply/.splat captures with GaussianSplats and draw them with SplatComponent, with a new example.
• Scene content can be exposed to assistive technology via SemanticsComponent, including hosted widget-surface semantics.
• WidgetComponent gains opt-in occlusionHiding.
• Added Camera.worldToScreen.
• A failed static-resource load no longer marks the engine ready to render; it retries instead of crashing mid-frame.
• Point and spot lights. PointLightComponent and SpotLightComponent, unlimited BVH-culled lights, spot shadows, KHR_lights_punctual import, and a Lights example.
• Geometry readback and derivation. Geometry.extractMeshData(), MeshData ops (unweld, extractEdges, merge), and LineSegmentsGeometry for thick lines.
• Per-frame transient GPU data rides a completion-aware arena allocator, fixing whole-frame aborts past ~1MB of transients and collapsing per-draw buffer writes.
• BREAKING: the custom-pass and material/geometry bind surfaces take a TransientWriter where they previously took a gpu.HostBuffer.
• Large speedup for many-draw scenes on the web backend. No more per-draw buffer ghosting, vertex state cached in VAOs, redundant sampler calls skipped.
• The web shim's HostBuffer is a faithful flutter_gpu port again.
• On the web backend, an active but unbound uniform block reads zeros instead of rejecting the draw, fixing unlit .fmat materials rendering nothing.
• Fixed ambient occlusion and reflections sampling the wrong depth for double-sided materials.
• The .fmat compiler no longer lets declared but unread resources strip out of the generated shaders, which surfaced as build errors or draw-time crashes.
• Built-in noise matched between CPU and GPU via package:flutter_scene/noise.dart and #include <noise.glsl> (the Dart side is native-only for now).
• AmbientOcclusionSettings.depthMipChain (off by default) keeps occlusion accurate on grazing surfaces and large radii.
• Distance fog via scene.fog, with falloff modes, a height term, light in-scatter, and sky-color blending.
• Custom render passes via Scene.addRenderPass, powering the new Node.highlightColor selection outlines.
• Custom passes can request scene buffers (depth, normals, shadowMap) through RenderInput.
• Volumetric god rays via scene.godRays.
• Load gating and warm-up. ResourceGroup, SceneView.loading/revealMinDuration, Scene.warmUp, and background-isolate GLB geometry packing.
• Widget-texture captures stay on the GPU on texture-backed platforms, removing the per-capture CPU round trip.
• .fmat materials gain a vertex stage (a Vertex() hook, varyings, custom attributes), applied consistently across the color, shadow, depth, and pick passes.
• Built-in materials and geometries can now be constructed before Scene.initializeStaticResources() completes.
• Added Scene.camera with CameraComponent auto-promotion, and a default camera so a bare SceneView(scene) always renders.
• Camera-facing billboards and sprites via BillboardGeometry, SpriteMaterial, and Sprite.
• Directional-shadow controls. shadowAmbientStrength, shadowCasterFaces, and cascades that extend toward the sun so long shadows stop dropping out.
• Fixed the cascaded-shadow lookup misreading cascades on GLES and crashing the shader compiler on Windows.
• BREAKING: vertex layouts are described by VertexLayoutDescriptor and unskinned geometry is structure of arrays (.fscene gains unskinned_soa; old files still load).
• New procedural primitives. Cylinder, capsule, torus, disc, ring, and icosphere, each with a collisionShape physics bridge.
• Geometry level of detail via LodComponent, with screen-size selection, hysteresis, and dithered cross-fade.
• Image-based lighting prefilters into a mipped radiance cubemap, and EnvironmentMap.fromEquirectHdr keeps HDR intensity through the prefilter.
• Spatial environment volumes with camera-driven blending via EnvironmentSettings, Scene.baseEnvironment, and EnvironmentVolume.
• Sky-driven sun light via Scene.sunLight, aiming and coloring the directional light from the sky.
• BREAKING: .fscene stages reference an environment resource instead of inline stage fields, and prefab host-node additions are Attachments.
• Added Texture2D (generated mips, trilinear and anisotropic filtering) with TextureContent/TextureSampling; imported models are now mipmapped.
• BREAKING: material texture slots hold a TextureSource instead of a raw gpu.Texture.
• Added TextureAtlas for uniform tile grids.
• Added geometric specular antialiasing to PhysicallyBasedMaterial.
• Fixed the split-sum specular lookup sampling with its roughness axis flipped.
• Fixed image-based lighting taking the shadow-ambient gate and Fresnel term from the normal-mapped normal.
• Fixed normalScale not being applied to the perturbed normal.
• Screen-space reflections via Scene.screenSpaceReflections, with an example and live tuning panel.
• Screen-space reflections fade out on rough surfaces.
• The environment BRDF lookup is generated at load as RGBA16F, removing banding and the bundled PNG.

0.18.1

• No code changes. Reworded the package description and added the logo as a pub.dev screenshot.

0.18.0

• Offscreen render targets via RenderTexture, Scene.views, and the RenderTextureView widget.
• The prefiltered-radiance environment stores roughness bands as mips of one texture (smoother transitions, ~25% less memory).
• Fixed dim image-based specular lighting on the web backend by re-baking radiance after the first presented frame.
• The base shader bundle loads asynchronously on every backend; await Scene.initializeStaticResources() before constructing geometry or materials.
• The flutter SDK constraint is now >=3.44.0; the real requirement is a 2026-06-09 or later master build (see the README).
• Render targets serialize in .fscene via a renderTexture resource kind and a top-level views array.
• Material texture slots accept a RenderTexture for live render-to-texture sampling.
• Added render scaling (Scene.renderScale) and composite filtering (Scene.filterQuality), with per-view overrides.
• Added FXAA and an automatic anti-aliasing mode; auto is the new default, so backends without MSAA now get FXAA.
• Adopted hardware instancing for InstancedMesh. Breaking for direct VertexLayout construction, which now takes a list of VertexBuffers.
• BREAKING: package exports are explicit show lists; file an issue if a symbol you used disappeared.
• Added scene raycasting via Scene.raycast/raycastAll, with layer masks and Node.raycastable.
• Added WidgetComponent, a live interactive widget subtree on a scene surface.
• Added automatic widget-surface input, with WidgetInput.manual opt-out and SceneView.debugWidgetInput.
• Added ScenePointer for programmatic scene input.
• Added WidgetTexture and Camera.screenPointToRay.
• Added UnlitMaterial.alphaMode.
• Added Surface.lastSwapchainColorTexture for one-frame feedback effects.
• Fixed vertically flipped texturing on the cuboid and wedge primitives.

0.17.0

• Added SceneView, a widget that renders a Scene and drives its frame loop.
• Added debug-mode hot reload for .fmat materials and re-exported .glb scenes, patched in place.
• Added DataAssets-backed GLB import with auto-discovery, cached composed documents, and dart run flutter_scene:init wiring.
• Added AnimationClip.rebind/AnimationPlayer.rebind and Mesh.clone.
• Skinned geometry from buildScenes carries a pose-union bound for sound frustum culling.
• BREAKING: removed the .model format; convert with buildScenes or load GLBs at runtime.
• BREAKING: .fmat materials are discovered under assets/ and loaded by source path via loadFmatMaterial.
• Building .fmat materials and models requires flutter_gpu_shaders 0.5.0.
• Added the .fscene/.fsceneb serialized scene format with prefabs, hot reload, and deterministic composition.
• Added scene serialization via serializeScene and realizeStage/serializeStage, round-tripping byte-stably.
• Added opt-in KTX2 texture compression for imported scenes, transcoded at load off the main isolate.
• BREAKING: fixed vertically inverted image-based lighting; loaded panoramas now light correctly.
• Added a skybox via Scene.skybox and the built-in EnvironmentSkySource.
• Added custom sky shaders via ShaderSkySource and .fmat sky blocks.
• Added sky-driven lighting via EnvironmentMap.fromSky and Scene.skyEnvironment, with time-sliced re-bakes.
• Added built-in procedural skies, GradientSkySource and PhysicalSkySource.
• Diffuse SH coefficients are sampled from a texture, and fromGpuTextures accepts a GPU-computed diffuseShTexture.
• A .fmat compile failure during hot reload keeps the last good shaders and reports the error.
• Build-hook conversions are cached by input content; set FLUTTER_SCENE_DISABLE_BUILD_CACHE to always reconvert.
• Fixed progressive slowdown on the web backend from leaked framebuffers and per-frame program re-links.

0.16.0

• Added an abstract physics contract (bodies, colliders, joints, queries, events) with a built-in kinematic world; a full backend ships in flutter_scene_rapier.
• Added WedgeGeometry, a triangular-prism ramp primitive.
• Added optional screen-space ambient occlusion via Scene.ambientOcclusion, working on every backend.

0.15.1

• Added a DataAssets-backed .fmat material workflow with auto-discovery.
• Added dart run flutter_scene:init.
• Added FmatMaterialRegistry and loadFmatMaterial.
• Updated flutter_gpu_shaders to ^0.4.5 and moved hook-time dependencies to hooks 2.x/data_assets 0.20.x.

0.15.0

• Added the .fmat custom-material format, compiled by buildMaterials and driven at runtime with typed parameters. See MATERIALS.md.
• Added a post-processing suite via Scene.postProcess (bloom, color grading, vignette, chromatic aberration, film grain), each off by default.
• Added PostEffect for custom post-processing shaders. See POST_PROCESSING.md.
• The tone-mapping pass is now the resolve pass (exposure, grading, tone map, EOTF, bloom composite).
• Fixed image-based lighting on the OpenGL ES backend.
• Building .fmat custom materials requires flutter_gpu_shaders 0.4.4 or newer.

0.14.2

• Fixed mirrored geometry rendering inside-out; cull winding now follows the world-transform determinant.
• Fixed material.doubleSided being ignored by the runtime glTF importer.

0.14.1

• Now WASM-compatible; build-hook helpers no longer pull dart:io onto the web graph.
• Added a package example and a fuller description.
• Bumped flat_buffers to ^25.9.23.
• Internal lint and formatting cleanup.

0.14.0

Renderer overhaul, with several breaking changes.

• Rendering is structured as a render graph (ShadowPass? -> ScenePass -> TonemapPass) with a transient-texture pool.
• HDR pipeline. The scene renders to a float target and a tone-map pass writes the swapchain; custom shaders now output linear HDR premultiplied by alpha (see MATERIALS.md).
• Tone mapping and exposure moved onto Scene (exposure, toneMapping, physicalCameraExposure).
• Added DirectionalLight with PCF shadow mapping, assignable as Scene.directionalLight.
• Image-based lighting rework. SH-9 diffuse, a GPU-prefiltered specular atlas, and the old brightness fudges removed.
• BREAKING: Environment removed in favor of Scene.environment (an EnvironmentMap) and Scene.environmentIntensity.
• BREAKING: EnvironmentMap always carries a prefiltered atlas plus SH-9; the procedural EnvironmentMap.studio() is the new default.
• ShaderMaterial.useEnvironment now binds prefiltered_radiance and brdf_lut.
• Web support. flutter_scene runs on Flutter web through a built-in WebGL2 backend, under both CanvasKit and Skwasm.
• BREAKING: flutter_scene_importer folded into flutter_scene (package:flutter_scene/build_hooks.dart), with a curated gpu.dart for custom shaders.

0.13.0

• Added ShaderMaterial, custom fragment shaders with uniform and texture binding by name and render-state knobs.
• Added MATERIALS.md, the custom-shader contract guide.
• The example app gains a toon-shader demo.

0.12.0

• Added bounding-volume and frustum culling, with offline pose-union bounds for skinned content.
• New bounds API on Geometry, Mesh, and Node, plus Camera.getFrustum.

0.0.1-dev.1

• Initial render box.

0.1.0

• Rewrite for Flutter GPU.
• Physically based rendering.
• More conventional interface for scene construction.

0.1.1

• Rename PhysicallyBasedMaterial and UnlitMaterial.
• Fix environment lighting problems in PhysicallyBasedMaterial.
• Add default environment map.

0.2.0

• Skinned mesh import.
• Fix readme for pub.dev.

0.2.1-0

• Switch to pre-release versioning.
• Bump version of flutter_scene_importer.

0.2.1-1

• Bump flutter_scene_importer version.

0.3.0-0

• Add animation playback (Animation, AnimationPlayer, AnimationClip).
• Import animations from scene models.
• Add support for cloning nodes.

0.4.0-0

• Support node cloning for skins.
• Fix default/animation-less pose.

0.5.0-0

• Support non-embedded/URI-only image embeds.

0.6.0-0

• Fix memory leak in transients buffer.
• Optional MSAA support on iOS and Android (enabled by default).
• Cull backfaces by default.
• Fix animation blending bugs.
• Pin native_assets_cli to <0.9.0.
• Add car model and animation blending examples.
• Fancy readme and FAQ.

0.7.0-0

• Update to native_assets_cli 0.9.0.
• Update to flutter_gpu_shaders 0.2.0.

0.8.0-0

• Update to Flutter 3.29.0-1.0.pre.242.

0.9.0-0

• Update to native_assets_cli 0.13.0.
• Update to flutter_gpu_shaders 0.3.0.

0.9.1-0

• Fix invalid usage of textureLod on desktop platforms.

0.9.2-0

• Fix globalTransform calculation.

0.11.1

• Fixed the Node.globalTransform setter scaling by the parent's determinant instead of composing with its inverse.

0.11.0

• Added a runtime GLB importer, Node.fromGlbBytes and Node.fromGlbAsset. (#12)
• Bumped flutter_scene_importer to ^0.11.0 (pure Dart, no CMake).

0.10.0

• Migrated from the discontinued native_assets_cli to hooks 1.0; build hooks now import package:hooks/hooks.dart. (#82)
• Dropped the obsolete --enable-experiment=native-assets flag that broke builds on Dart 3.10+. (#82)
• Reorganized the repository as a pub workspace. (#36)
• Updated flutter_gpu_shaders to ^0.4.0.