flutter3d_app 0.7.1

What any Flutter application on flutter3d is assembled from: which backend to open and the runtime fallback, the surface a frame reaches Flutter through, widgets drawn in the scene, a level loaded int [...]

0.7.1

A widget drawn into a scene is unmounted when it goes. WidgetSurface and WidgetTexture only finalized their tree, so no State.dispose ran and every ticker, controller and focus node stayed alive. WidgetSurface also releases the texture it replaces and its mesh, and ignores an upload that lands after a newer frame or after dispose. Textures bound for a level's .fmat materials and every terrain tile mesh are released with the level.

ModelVisuals and PropVisuals, for a level's model and prop entities, live here beside LevelLoader. A model entity is a whole decoded hierarchy, so a lesson step can address a node inside it. Its asset loads through loadModelByPath, so an assets_src/ path the build hook converted is found, and a model that finishes decoding after dispose is released instead of added to a scene nobody draws.

SceneSurface clamps an unbounded constraint before rounding it and no longer throws inside a Column, and the level loader reads a ByteData view rather than its whole backing buffer.

Its flutter3d_* dependencies ask for ^0.7.1, and it asks for clock ^1.1.3, vector_math ^2.4.3.

0.7.0

Breaking. What any application needs from flutter3d_session and flutter3d_bridge is here now, and nothing is re-exported. doc/boundary-0.7.0.md has the whole list of packages that were folded for this release. flutter3d_backend, flutter3d_session, flutter3d_screens and flutter3d_bridge are marked discontinued on pub.dev the day this is published, and an import of one of them moves to this package or to flutter3d_game.

• From flutter3d_session: SceneSurface, FrameClock, FrameTimingLog, DidNotStart, and WidgetSurface with its pipeline.
• From flutter3d_screens, which was folded into flutter3d_session first and followed it: the status screens LoadingScreen, RendererFailure and LevelLoadFailed, and Storage/BinaryStorage, with the atomic write in package:flutter3d_app/native.dart.
• From flutter3d_bridge: LevelLoader, LoadedLevel, SharedMeshes, SurfaceMesh, VisibilityCuller and WidgetSurfaceVisuals.
• From flutter3d_game: Issue, IssueSink and IssueLog, which a storage reports through.
• No longer re-exported: flutter3d_session, flutter3d_screens, pad_input and pointer_lock. What a game took from the first two, RunSession, SaveFile, SettingsFile, the settings panel and rebinding among it, is flutter3d_game now, and a game names the two device packages itself.

Breaking. Accepted flutter3d_backend, because most of its consumers already reached it through this barrel rather than by naming it, and the handful that still named it directly — two package examples, and one game's now-redundant line — cost nothing to repoint, which left the separate package with no boundary of its own (package-merge-plan.md §3.6). The conditional export deciding which backend a build draws through — openDevice, kFixedResolution — now lives directly in this package's own src/backend_native.dart/src/backend_web.dart, and this package depends directly on flutter3d_hardware, flutter3d_impeller, flutter3d_webgl, flutter3d_cpu and flutter3d_webgpu instead of on flutter3d_backend. Nothing an application imports changed, unless it named package:flutter3d_backend/flutter3d_backend.dart itself; that line becomes package:flutter3d_app/flutter3d_app.dart.

presentFrame(device, frame, {fit, quality}), new — a registry lookup, not a fixed list. GraphicsDevice.present is gone (mcp-01n), and what replaces it is flutter3d_hardware's own device registry: registerBackendOpener and registerDevicePresenter, which every backend — including a third-party one this repository has never heard of — calls on itself. flutter3d_impeller and flutter3d_webgl register both halves from their own packages; flutter3d_cpu registers only its opener, since the flat package that went through mcp-02n cannot also build a Flutter Widget for CpuFrame, which moved here. This package's openDevice/presentFrame are the batteries- included default: they make sure the four backends this repository ships have registered themselves, then hand the question to the registry — a caller who wants a fifth backend, or none of these four, can register directly with flutter3d_hardware and never name this package at all.

Breaking. SceneSurface takes presentFrame. It is a required constructor argument of type FramePresenter, so every existing SceneSurface call site needs one line added: presentFrame: presentFrame. It became a parameter while the widget lived in flutter3d_session, which this package depended on and which could not name this package back. The widget is here now and the parameter stayed as it was.

A widget can be a texture, and a mesh in a level. New since 0.6.0, and arriving here with the session half. WidgetTexture.draw rasterises one widget off the tree at the size asked for and uploads the pixels, for a sign whose text changes once a lap. WidgetSurfacePipeline keeps a BuildOwner, a PipelineOwner and a RenderView alive between frames, repaints when one of them says something changed, and takes a pointer at a UV through dispatchAtUv, which hands it to GestureBinding.dispatchEvent, so an ordinary GestureDetector or TextField answers it. WidgetSurface is a MeshNode carrying that canvas as its albedo. WidgetSurfaceVisuals resolves a level's widget_surface entities against a Map<String, WidgetBuilder> the application hands over, and WidgetSurfaceKind is the EntityKind a game registers so that a level naming the type loads. It spawns nothing.

BinaryStorage, for a document that is bytes and may be megabytes. The same shape as Storage: read, write, remove, a name, and it never throws. defaultBinaryStorage(appName) answers FileBinaryStorage on native platforms, with the atomic write the text storage has, and IndexedDbBinaryStorage on the web, since localStorage holds a few megabytes for everything an origin keeps. applicationFolder(appName) is the directory the files are in, and null in a browser.

A storage name that holds a directory is written. FileStorage and FileBinaryStorage created their root and then wrote into a subdirectory nothing had made, so a name such as autosave/<hash> failed with "No such file or directory" on every write and answered false. Both create the file's own parent now.

LevelLoader.load(sidecars:). True by default. With false the loader does not ask for a level's visibility table and lightmap. A circuit in the open air has neither: the racing demo's ring baked to a table in which every pair of cells sees every other, and asking for it cost two 404s in the console of every web build.

TerrainTiles draws a HeightfieldTiles with detail that follows the camera. One MeshNode per tile in nodes, a TileLevelChooser deciding the level per tile, and update pointing each node at the mesh for the level its distance calls for. A level's mesh is uploaded the first time a tile needs it and kept, and uploads counts them. flutter3d_sim 0.7.0 has the tiles, the skirts that close a seam between two levels and the chooser's band.

SceneSemantics describes the scene to a screen reader. A viewport is a texture, so the accessibility layer saw one image the size of the window. semanticObjectsFor projects each SceneAnnouncement's node through screenBoundsOfBox and answers a SemanticObject with a rectangle, a label, a hint, a three-valued selected and an onTap; SceneSemantics lays one semantics node over each. The nodes sit under IgnorePointer, so they take no gesture from the viewport, and the picture under them is wrapped in ExcludeSemantics. A node with no bounds is left out, and a box the camera is inside answers the whole viewport.

MemoryPressureRelease gives the pooled render targets back on a memory warning. A widget around the scene that observes didHaveMemoryPressure and calls Renderer.releaseTransientTargets, with an optional onReleased. Targets lent to a frame in flight are left alone, and the frame after a release is byte for byte the frame before it.

The software backend's picture no longer freezes on its first frame. CpuFrame's presenter decoded its texture only when the texture instance changed, and flutter3d_cpu hands back the same render target every frame, so the widget went on showing the frame it started with. The two GPU backends present through their own path and were not affected.

What it depends on. flutter3d, flutter3d_hardware, the four backends and flutter3d_sim at ^0.7.0, with clock, vector_math and web. pad_input and pointer_lock are no longer dependencies.

0.6.0

• Floors, and no code. Storage, settings, the frame clock and the screens are byte for byte 0.5.0's. flutter3d_backend, flutter3d_session and flutter3d_screens move to ^0.6.0; pad_input and pointer_lock stay at ^0.4.0, which their 0.4.1 covers.
• What arrives through the barrel is one line wider without this package changing. flutter3d_backend 0.6.0 can try WebGPU on a web build given --dart-define=FLUTTER3D_WEBGPU=true; an application assembled from here gets that by raising the floor and nothing else, because openDevice was always the whole of the question this layer asks.

0.5.0

• No API change. Its floors move to the 0.5.0 packages it assembles.

0.4.0

• No changes of its own; the version moves with the workspace, whose sibling constraints name a single release. The README's closing section now says what the engine around this package is.

0.3.0

• A barrel over flutter3d_backend, flutter3d_session, flutter3d_screens, pad_input and pointer_lock — the five packages an application assembles itself from, none of which know about each other. No code of its own.