Migrating from 0.8 to 1.0

1.0 is the release the engine promises to keep: from it on, a break comes only in a major version. To get there, 0.8's API changed in 2095 places, 308 of them left to you; 380 are backend internals no application called. The rest a program carries out for you, and three tools share the work. All three read one table, flutter3d_build/lib/migrations/0.8_to_1.0.yaml, so they agree about what changed.

Run the migration #

Commit or stash first: the migration edits your files in place, and a clean git diff is the easiest way to read what it did.

dart pub global activate flutter3d_build 1.0.0-rc.1
dart pub global activate flutter3d_lints 1.0.0-rc.1
dart pub global run flutter3d_build:migrate --dry-run .   # see what it would do
dart pub global run flutter3d_build:migrate .

Activate the tools globally rather than adding them to your project. Your pubspec still asks for 0.8, and a 1.0 tool cannot resolve beside it until the migration has moved the constraints.

migrate works through the project in this order:

1. Dependencies. Every dependency on a flutter3d package moves to ^1.0.0-rc.1, or to the package's own number for the few that are versioned apart (pad_input, flutter3d_pointer_lock). A renamed package is renamed in the pubspec (pointer_lock is flutter3d_pointer_lock). Path and git dependencies are left alone and listed.
2. Imports of libraries that moved to another package are rewritten.
3. flutter pub get (or dart pub get for a plain Dart package).
4. dart fix --apply. Each flutter3d package ships a lib/fix_data.yaml generated from the table. It renames what was renamed and imports moved names from where they live now. These are the same fixes your editor offers one at a time.
5. Rewrites that need the resolved code, which dart fix cannot express: the deprecated capability getters (device.supportsWireframe becomes device.features.has(DeviceFeature.wireframe)), and implements X for the types 1.0 made base mixin classes. This step is dart pub global run flutter3d_lints:migrate, and migrate runs it for you.
6. Dependencies again, for the packages the new imports need, such as flutter3d_core when a name left the flutter3d facade.
7. The report. It lists the files changed and what is left for you. Every item on the list also has a // TODO(flutter3d-1.0): above it in the code, with a link to its line below.

migrate reads the release your project is on from its pubspec.lock and applies every migration table after it, so a project on 0.8 goes through 0.8_to_1.0.yaml and, once there is a later candidate, the tables after it in the same run. --from <version> says the release when there is no lock. --dry-run makes the same changes in a copy next to your project, prints the report and removes the copy.

Afterwards, run flutter analyze. What is left is either on the report or is a change in behaviour the analyzer cannot see. The table below says which entries change behaviour.

In the editor #

flutter3d_lints is also an analysis server plugin. Listed in analysis_options.yaml, it reports each use of something 1.0 changed: a flutter3d_migrate warning with a quick fix where the change can be written, and flutter3d_migrate_by_hand with the guide's link where it cannot.

plugins:
  flutter3d_lints: ^1.0.0-rc.1

The plugin also turns on the fixed-step rules described in its README. A plugin's quick fixes are applied one at a time; dart fix does not apply them in bulk, which is why step 5 above exists.

GameLoop to EngineLoop #

GameLoop is gone in 1.0, and EngineLoop takes its place: the fixed step runs as named systems in ordered phases, and plugins add theirs to the same loop. The change is a shape rather than a rename, so no tool makes it for you:

// 0.8
final loop = GameLoop(input: input, onStep: (dt) => world.step(dt));
// every frame:
loop.advance(dt);

// 1.0
final loop = EngineLoop(input: input)
  ..addSystem('world', LoopPhase.physics, (ctx) => world.step(ctx.dt));
// every frame:
loop.frame(dt);

paused, alpha, playback, recorders, drainLook and longestFrame keep their names. EngineLoop adds timing: (a WorldTiming, the step rate and time scale) and catchUp: (what to do when a frame falls behind). Their defaults are what GameLoop did. In a Flame game, HasFixedStep runs an EngineLoop already: read engineLoop, and register your step work in installStepSystems.

Data files #

Your levels, effects, data plugins and recordings do not need a migration to keep working: 1.0 reads every version of each format, lifting an old file through its format's chain each time it opens it. What stays behind is the file on disk. A tool that does not carry the chain, a diff, or an older checkout of the editor still sees the 0.8 shape.

dart pub global run flutter3d_build:migrate --data --dry-run .   # list them
dart pub global run flutter3d_build:migrate --data --backup .

--data walks the project by the suffixes of every format below. Each JSON file below its format's version is written again in the shape 1.0 writes, with the format envelope (format, version, requires, generator) first. Every key it had is kept, including the ones 1.0 does not know. The report has a line per file, assets/levels/first.level.json: f3d.level v1 → v4, and a list of what it did not carry over. That covers a version newer than the tool, a document of another format under the suffix, and the formats it leaves as they are. --backup keeps each file as it was next to it, as <file>.v<N>.bak. flutter3d doctor, run in a project, lists the files that are behind.

A level is lifted by the level reader itself, because a level from before version 3 addressed a prefab override by name, and only the reader that has read the prefabs can turn that into an id path. The level's digest is computed from what the reader reads, so a run recorded against the old file still matches the new one.

Runs are left at their version on purpose. .f3drun is at version 5 in 1.0. A run with change stamps on its starting world (the step each component was last set at, which query().changed<T>() replays from) is written at 5. So is a run that carries externalInputs, state fed in from outside the simulation at a given step, which may say sourceTime, receivedTime, quality, tag and unit. Version 5 also reserves probes, what probes read while the run was recorded, and parent, the run a branch starts from. A build from before 5 plays neither of the first two correctly, so it must refuse them. Every other run is still written at the lowest version that describes it, and an older build keeps playing it. Lifting a version-1 run to 5 would only make those builds refuse it, so --data does not. Input tapes follow the same rule. A version-1 tape with button pairs where the game now has an axis is upgraded by the game's ActionSet.upgradeTape when it is replayed, since only the game knows its axes.

The formats owned by a package that needs the Flutter SDK (settings, action maps, saves, racing tracks and ghosts, strategy matches) cannot be loaded by a command-line tool. --data names those files and leaves them; the game reads every version of them as before.

Generated from the FormatSpecs migrate --data loads — 24 formats, and 10 it leaves to the package that reads them.

Every change, by package #

Each entry links here from its diagnostic and its TODO. How each one is carried out:

• dart fix: applied by migrate (step 4) and offered in your editor.
• migrate: applied by migrate (steps 2 and 5).
• by hand: on the report, with a TODO in your code.
• nothing to do: the classifier counts it as a break, but no call you can write is affected. It is listed so you know it was checked.

Generated from flutter3d_build/lib/migrations/ — 2095 entries from 0.8.5 to 1.0.0-rc.1, 308 by hand: 425 migrate, 308 by hand, 329 nothing to do, 528 dart fix, 380 gone internal, 125 migrate, with a TODO.

flame_flutter3d #

• ActorSystemComponent (by hand). The step: parameter (a FixedStep) is now timing: (a WorldTiming) and catchUp: (a CatchUp), used only when the game does not step the component itself; the public step field is gone.
• AtmosphereComponent (migrate). AtmosphereComponent is a base class: a class below it is base itself, and implements AtmosphereComponent becomes extends AtmosphereComponent.
• BillboardAtlas (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• BridgeSpace (migrate). BridgeSpace is a base mixin class: implements BridgeSpace becomes with BridgeSpace, on a base class.
• Bridged3d (by hand). See Drawn3d: tint is a settable LinearColor.
• CameraSyncController.takeRest (dart fix). CameraSyncController.takeRest is captureRest. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• CellGridComponent (migrate). color: Vector3(x, y, z) of CellGridComponent is color: LinearColor(x, y, z). CellGridComponent(color:) is a vertex colour, a linear LinearColor: Vector4(r, g, b, a) is LinearColor(r, g, b, a).
• CellGridComponent (migrate). CellGridComponent is a base class: a class below it is base itself, and implements CellGridComponent becomes extends CellGridComponent.
• CellGridComponent.CellGridComponent (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• CellGridComponent.centreOf (dart fix). CellGridComponent.centreOf is centerOf. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• CellGridComponent.colour (dart fix). CellGridComponent.colour is color. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• CharacterBodyComponent (migrate). CharacterBodyComponent is a base class: a class below it is base itself, and implements CharacterBodyComponent becomes extends CharacterBodyComponent.
• ChaseCamera (dart fix). ChaseCamera is FlameChaseCamera. The racing genre has a ChaseCamera of its own, so the Flame bridge's is FlameChaseCamera, with the same constructor and members.
• ChaseCameraComponent (dart fix). ChaseCameraComponent is FlameChaseCameraComponent. Renamed with FlameChaseCamera, which it carries; the same constructor and members.
• ChunkStreamer (migrate). drop: x of ChunkStreamer is drop: (dropped) => (x)(dropped.index, dropped.chunk). drop is handed one ChunkDrop, the piece and its index, where it took the two as parameters: (index, chunk) => ... is (dropped) => ... reading dropped.index and dropped.chunk. migrate wraps the old function, (dropped) => (old)(dropped.index, dropped.chunk), which runs as it did.
• CollisionBridge.onCollision (migrate). CollisionBridge.onCollision takes one CollisionContext: an override reads its old parameters from it (parameter 1 is .self, parameter 2 is .other), and a call builds one. CollisionBridge.onCollision takes one CollisionContext where it took its parameters. A collision listener is the hook a game overrides most, and a contact is handed to it per pair per step, so the world reuses one context and an override must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• CollisionBridge.onCollisionEnd (migrate). CollisionBridge.onCollisionEnd takes one CollisionContext: an override reads its old parameters from it (parameter 1 is .self, parameter 2 is .other), and a call builds one. CollisionBridge.onCollisionEnd takes one CollisionContext where it took its parameters. A collision listener is the hook a game overrides most, and a contact is handed to it per pair per step, so the world reuses one context and an override must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• CollisionBridge.onCollisionStart (migrate). CollisionBridge.onCollisionStart takes one CollisionContext: an override reads its old parameters from it (parameter 1 is .self, parameter 2 is .other), and a call builds one. CollisionBridge.onCollisionStart takes one CollisionContext where it took its parameters. A collision listener is the hook a game overrides most, and a contact is handed to it per pair per step, so the world reuses one context and an override must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• Drawn3d (by hand). Drawn3d.tint is a settable LinearColor where it was a Vector4 changed in place, so a TintEffect assigns it. A class implementing Drawn3d declares LinearColor tint = LinearColor.white; (a field, or a getter and a setter) in place of Vector4 get tint.
• FlameInputBridge (by hand). FlameInputBridge takes actions:, an ActionMap, where it took bindings:: the map a native game's DesktopInput reads. Wrap an old table as ActionMap(actions: ActionSet.common, buttons: table).
• Flutter3dFlameWidget (migrate). clearColor: Vector3(x, y, z) of Flutter3dFlameWidget is clearColor: LinearColor.fromSrgb(x, y, z). Flutter3dFlameWidget(clearColor:) takes a LinearColor, encoded to sRGB for the view once a frame. The Vector4 it took was sRGB, so the same picture is clearColor: LinearColor.fromSrgb(r, g, b).
• Flutter3dFlameWidget (migrate, with a TODO). Flutter3dFlameWidget is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• GridMover (migrate). onArrive: x of GridMover is onArrive: (arrival) => (x)(arrival.column, arrival.row). onArrive is handed one GridArrival, the cell reached, where it took its column and row as parameters: (column, row) => ... is (arrival) => ... reading arrival.column and arrival.row. migrate wraps the old function, (arrival) => (old)(arrival.column, arrival.row), which runs as it did. passable keeps its two parameters: it is a function of the cell, not an event.
• GridMover (migrate). GridMover is a base class: a class below it is base itself, and implements GridMover becomes extends GridMover.
• HasFixedStep (by hand). Only code that implements HasFixedStep has anything to do: it now has to provide createEngineLoop, engineLoop, installStepSystems. Code that calls a HasFixedStep needs no change.
• HasFixedStep.fixedStep (by hand). fixedStep is gone: the mixin runs an EngineLoop. Read engineLoop, override createEngineLoop to give it your own WorldTiming and CatchUp, and register step work in installStepSystems.
• HasFlutter3d (migrate). clearColor: Vector3(x, y, z) of HasFlutter3d is clearColor: LinearColor.fromSrgb(x, y, z). HasFlutter3d.clearColor is a LinearColor, linear, assigned whole, where it was a Vector4 of sRGB numbers changed in place. The numbers it held keep the sky: clearColor.setValues(0.55, 0.75, 0.95, 1) is clearColor = LinearColor.fromSrgb(0.55, 0.75, 0.95); a read of .z is .b, in linear light. An AtmosphereComponent assigns the day's sky to it, as it wrote into it before.
• InstancedActorComponent (migrate). InstancedActorComponent is a base class: a class below it is base itself, and implements InstancedActorComponent becomes extends InstancedActorComponent.
• InstancedObject3dComponent (migrate). tint:, color: of InstancedObject3dComponent: Vector3(x, y, z) is LinearColor(x, y, z). color (the constructor's and the field) and tint are linear LinearColors; tint is assigned whole. color: Vector4(r, g, b, a) is color: LinearColor(r, g, b, a), the same numbers.
• InstancedObject3dComponent (migrate). InstancedObject3dComponent is a base class: a class below it is base itself, and implements InstancedObject3dComponent becomes extends InstancedObject3dComponent.
• InstancedPoseComponent (migrate). InstancedPoseComponent is a base class: a class below it is base itself, and implements InstancedPoseComponent becomes extends InstancedPoseComponent.
• KinematicBodyComponent (migrate). KinematicBodyComponent is a base class: a class below it is base itself, and implements KinematicBodyComponent becomes extends KinematicBodyComponent.
• MeshFlipbookComponent (migrate). MeshFlipbookComponent is a base class: a class below it is base itself, and implements MeshFlipbookComponent becomes extends MeshFlipbookComponent.
• ModelAnimationComponent (migrate). ModelAnimationComponent is a base class: a class below it is base itself, and implements ModelAnimationComponent becomes extends ModelAnimationComponent.
• Move3dEffect (migrate). Move3dEffect is a base class: a class below it is base itself, and implements Move3dEffect becomes extends Move3dEffect.
• Node3dComponent (migrate). tint: Vector3(x, y, z) of Node3dComponent is tint: LinearColor(x, y, z). tint is a linear LinearColor assigned whole: component.tint.setValues(1, 0.3, 0.25, 1) is component.tint = const LinearColor(1, 0.3, 0.25), and tint.x, .y, .z, .w are tint.r, .g, .b, .a. The numbers are the same; the tint was linear already.
• Node3dComponent (migrate). Node3dComponent is a base class: a class below it is base itself, and implements Node3dComponent becomes extends Node3dComponent.
• Object3dComponent (migrate). tint: Vector3(x, y, z) of Object3dComponent is tint: LinearColor(x, y, z). tint is a linear LinearColor assigned whole; see rc-flame-Node3dComponent-tint.
• Object3dComponent (migrate). Object3dComponent is a base class: a class below it is base itself, and implements Object3dComponent becomes extends Object3dComponent.
• Particles3dComponent (migrate). Particles3dComponent is a base class: a class below it is base itself, and implements Particles3dComponent becomes extends Particles3dComponent.
• PhysicsStepComponent (by hand). dynamics is typed as the RigidDynamics interface now, which the Dart solver Dynamics and the native one both implement. Declare what you read it into as RigidDynamics; a call that needs the Dart solver's own members casts with as Dynamics.
• PhysicsStepComponent (by hand). The step: parameter (a FixedStep) is now timing: (a WorldTiming) and catchUp: (a CatchUp), used only when the game does not step the component itself; the public step field is gone.
• PlaneAxis (migrate, with a TODO). PlaneAxis is a class: a switch over it that names every value gains _ => throw UnimplementedError(). PlaneAxis is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• ProjectedViewfinder (migrate). ProjectedViewfinder is a base class: a class below it is base itself, and implements ProjectedViewfinder becomes extends ProjectedViewfinder.
• RigidBodyComponent (migrate). RigidBodyComponent is a base class: a class below it is base itself, and implements RigidBodyComponent becomes extends RigidBodyComponent.
• RigidBodyComponent (by hand). removeFrom is a RigidDynamics? now: pass any solver, and declare a variable you read it into as RigidDynamics?.
• Rotate3dEffect (migrate). Rotate3dEffect is a base class: a class below it is base itself, and implements Rotate3dEffect becomes extends Rotate3dEffect.
• Scale3dEffect (migrate). Scale3dEffect is a base class: a class below it is base itself, and implements Scale3dEffect becomes extends Scale3dEffect.
• SpriteBillboardComponent (migrate). SpriteBillboardComponent is a base class: a class below it is base itself, and implements SpriteBillboardComponent becomes extends SpriteBillboardComponent.
• StepClock (nothing to do). An abstract mixin class where it was an interface: its members never had bodies, and a class that implements StepClock compiles as it did. A component may mix it in instead (with StepClock).
• Tap3dCallbacks.hitAt3d (migrate). Tap3dCallbacks.hitAt3d takes one Tap3dProbe: an override reads its old parameters from it (parameter 1 is .screen, parameter 2 is .projector), and a call builds one. Tap3dCallbacks.hitAt3d takes one Tap3dProbe where it took its parameters. A tap target is a hook a component overrides for a tighter shape; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• Taps3dComponent (migrate). Taps3dComponent is a base class: a class below it is base itself, and implements Taps3dComponent becomes extends Taps3dComponent.
• TiledWorld3d (migrate). TiledWorld3d is a base class: a class below it is base itself, and implements TiledWorld3d becomes extends TiledWorld3d.
• TiledWorld3d (migrate). spawn: x of TiledWorld3d is spawn: (spawn) => (x)(spawn.object, spawn.at). spawn is handed one TiledSpawn, the object and its middle, where it took the two as parameters: (object, at) => ... is (spawn) => ... reading spawn.object and spawn.at. migrate wraps the old function, (spawn) => (old)(spawn.object, spawn.at), which runs as it did.
• TintEffect (migrate). TintEffect is a base class: a class below it is base itself, and implements TintEffect becomes extends TintEffect.
• TintEffect.TintEffect (migrate). color: Vector3(x, y, z) of TintEffect.TintEffect is color: LinearColor(x, y, z). TintEffect(color, controller) takes a linear LinearColor: TintEffect(Vector4(1, 0, 0, 1), c) is TintEffect(const LinearColor(1, 0, 0), c).
• TrailComponent (migrate). color: Vector3(x, y, z) of TrailComponent is color: LinearColor(x, y, z). TrailComponent(color:) and color are a linear LinearColor, white by default: Vector4(r, g, b, a) is LinearColor(r, g, b, a).
• TrailComponent (migrate). TrailComponent is a base class: a class below it is base itself, and implements TrailComponent becomes extends TrailComponent.
• TrailComponent.TrailComponent (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• TrailComponent.color (nothing to do). color is colour under its American name, which the rename entry for TrailComponent.colour carries; an implementer overrides it by the new name.
• TrailComponent.colour (dart fix). TrailComponent.colour is color. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• TransparentFlameGame (migrate). TransparentFlameGame is a base class: a class below it is base itself, and implements TransparentFlameGame becomes extends TransparentFlameGame.
• ViewCamera (nothing to do). rig, stiffness and view are getters over the camera's ViewFraming and VirtualCamera rather than fields; reading them is unchanged, and nothing outside the class could assign them.
• WrapSpace (migrate). WrapSpace is a base class: a class below it is base itself, and implements WrapSpace becomes extends WrapSpace.

flame_flutter3d_audio #

• AudioSceneComponent (migrate). AudioSceneComponent is a base class: a class below it is base itself, and implements AudioSceneComponent becomes extends AudioSceneComponent.
• AudioSceneComponent.close (dart fix). AudioSceneComponent.close is dispose. close is dispose, the one teardown verb. It stops every sound and disposes the speakers, as close did, and an open after it does nothing: a game that wants its sound again adds a new AudioSceneComponent.
• OpenedSpeakers (by hand). The OpenedSpeakers record is gone: AudioSceneComponent.opener is a Future<Speakers> Function(). An opener that made the record (scene: scene, close: close) returns Speakers(backend: backend, scene: scene), and one that answered null for no device throws AudioDeviceException.
• SoundEmitterComponent (migrate). SoundEmitterComponent is a base class: a class below it is base itself, and implements SoundEmitterComponent becomes extends SoundEmitterComponent.
• SoundEmitterComponent.SoundEmitterComponent (dart fix). A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SoundEmitterComponent.playing (dart fix). SoundEmitterComponent.playing is isPlaying. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.

flame_multiplayer #

• BatonStream (nothing to do). The constructor's holding: was declared as this._holding, a private named parameter, and is a plain bool holding now. A call already passed holding:, so no call changes; only the signature's spelling did.
• BatonStream.holding (dart fix). BatonStream.holding is isHolding. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• BatonStream.take (dart fix). BatonStream.take is claim. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• LoopbackParty (nothing to do). Declared by flutter3d_net now and re-exported here, as PeerWire.
• LoopbackWire (nothing to do). Declared by flutter3d_net now and re-exported here, as PeerWire.
• PeerRoom (nothing to do). Declared by flutter3d_net now and re-exported here, as PeerWire.
• PeerRoom.met (dart fix). PeerRoom.met is hasMet. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• PeerWire (by hand). PeerWire is an abstract base class: an adapter extends PeerWire and keeps its send and listen. slot, state, listenFrom and close have defaults; override close and state for a connection that has them.
• PeerWire.PeerWire (nothing to do). The constructor is no longer const: a wire holds its listeners. An adapter's own constructor was not const either, since a connection is not a constant.
• PeerWire.listen (by hand). A wire has several listeners now: listen and listenFrom are the base class's, add a listener and return the Registration that takes it away. An adapter no longer overrides them; it calls deliver(message) (a party's wire deliver(message, from: slot)) with each message that arrives, and drops the field that held the one listener. A wire wrapping another overrides listenFrom to hand back the inner wire's registration.
• PeerWire.send (migrate). PeerWire.send takes one PeerSend: an override reads its old parameters from it (parameter 1 is .message, reliable: is .reliable), and a call builds one. PeerWire.send takes one PeerSend where it took its parameters. A peer wire is a transport a network library implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• RollbackPlay (by hand). Use RollbackSession with localSlot, inputDelay: 3 and maxRollbackFrames: 20 (RollbackPlay's defaults); captureLocalFrame is capture, applyAndStep reads frames[0]/frames[1] where it read bySlot, and endsAt, agreedEnd and connected are on the session.
• RollbackSession (by hand). RollbackSession is the one rollback, for two to thirty-two machines: it takes localSlot (the wire's slot by default) and players, its applyAndStep receives every slot's frame by slot, and onSettled also receives the frames.
• RollbackSession (migrate). onSettled: x of RollbackSession is onSettled: (settled) => (x)(settled.step, settled.after). onSettled is handed one SettledStep, with the step, the state it ended in and the frames it ran on, where it took the step and the state as parameters: (step, after) => ... is (settled) => ... reading settled.step and settled.after. migrate wraps the old function, (settled) => (old)(settled.step, settled.after), which runs as it did. onMessage is new and takes a PeerMessage.
• WireHello (nothing to do). Declared by flutter3d_net now and re-exported here, as PeerWire.
• WireHello.currentProtocolMajor (nothing to do). Protocol 3: a rollback's frames carry the reserved key "f3d": "rollback" (PeerWire.engineKey). A machine on protocol 2 is refused in the hello with the version to update to, and a game's own message never sets f3d.
• WireState (nothing to do). Declared by flutter3d_net now and re-exported here, as PeerWire.

flame_multiplayer_dashwire #

• DashwireWire.send (migrate). DashwireWire.send takes one PeerSend: an override reads its old parameters from it (parameter 1 is .message, reliable: is .reliable), and a call builds one. DashwireWire.send takes one PeerSend where it took its parameters. A peer wire is a transport a network library implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.

flutter3d #

• 1 name was the package's own (gone internal): they are not exported since 1.0.0-rc.1, and the import of flutter3d that brought them gets one diagnostic for all of them. package:flutter3d/parity_scene.dart. A backend's own tests import it from package:flutter3d_core/src/engine/render/parity_scene.dart.
• BundleAssetSource (by hand). A key the asset bundle does not hold throws AssetNotFoundException (a Flutter3dException) naming the key, where it threw the platform's FlutterError. Catch AssetNotFoundException, or the root, instead.
• ImpostorPart (migrate). ImpostorPart is a class: .card is .card, .albedo is .albedo, .normalDepth is .normalDepth; a destructuring pattern is yours to rewrite. ImpostorPart is a final class with the same card, albedo and normalDepth; only a destructuring pattern names the class.
• MaterialDecoder (by hand). An abstract base class since 1.0: write extends MaterialDecoder where you wrote implements MaterialDecoder, and mark the class final, base or sealed.
• MaterialDecoder.decode (migrate). MaterialDecoder.decode takes one MaterialDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .fileName), and a call builds one. MaterialDecoder.decode takes one MaterialDecodeContext where it took its parameters. A material decoder is the plugin boundary for looks; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• MaterialDecoder.handles (migrate). MaterialDecoder.handles takes one MaterialProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. MaterialDecoder.handles takes one MaterialProbe where it took its parameters. A material decoder is the plugin boundary for looks; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ModelAsset (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• ModelAsset.release (migrate). ModelAsset.release becomes x.dispose(). dispose() is the one verb for ending what holds GPU memory. The asset remembers the device it was uploaded to, so the call takes nothing; a second call does nothing.
• ModelInstance (nothing to do). The constructor's private _drawn became the public named drawn, and a private _slots was added. Nothing outside the library could pass either, so every call still compiles.
• ModelWardrobe (migrate). onDressed: x of ModelWardrobe is onDressed: (dressed) => (x)(dressed.instance, dressed.key). onDressed is handed one ModelDressed, the model put on and the key it plays, where it took the two as parameters: (instance, key) => ... is (dressed) => ... reading dressed.instance and dressed.key. migrate wraps the old function, (dressed) => (old)(dressed.instance, dressed.key), which runs as it did.
• assetDeviceClass (by hand). There is no process-wide device class since 1.0: pass deviceClass: to loadModelAsset or loadModelByPath, and set HotSwap.instance.deviceClass for hot reload.
• bindMaterial (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• bindSurfaceMaterial (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• loadMaterial (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• loadModelAsset (by hand). A release build missing the converted .f3d throws AssetNotFoundException with the generated path as its key, where it threw StateError. Catch AssetNotFoundException instead.
• package:flutter3d_core/formats.dart (dart fix). Names re-exported from package:flutter3d_core/formats.dart are imported from package:flutter3d_core/formats.dart. package:flutter3d/flutter3d.dart re-exports the formats library through a show list now. The readers and writers a game calls are on it; the format internals (F3dSection, the KTX2 header fields, the material expression tree, the block encoders) are not. Import package:flutter3d_core/formats.dart for those; dart fix adds the import, and migrate the dependency on flutter3d_core.

flutter3d_addon_access #

• package:flutter3d_addon_access/flutter3d_addon_access.dart (migrate). package:flutter3d_addon_access/flutter3d_addon_access.dart is package:flutter3d_game_ui/access.dart. flutter3d_addon_access is the access.dart library of flutter3d_game_ui, with the API it had; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings.
• package:flutter3d_addon_access/src/ (migrate). package:flutter3d_addon_access/src/ is package:flutter3d_game_ui/src/access/. What was under flutter3d_addon_access's lib/src/ is under lib/src/access/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_atmosphere #

• package:flutter3d_addon_atmosphere/flutter3d_addon_atmosphere.dart (migrate). package:flutter3d_addon_atmosphere/flutter3d_addon_atmosphere.dart is package:flutter3d_post/atmosphere.dart. flutter3d_addon_atmosphere is the atmosphere.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_atmosphere/src/ (migrate). package:flutter3d_addon_atmosphere/src/ is package:flutter3d_post/src/atmosphere/. What was under flutter3d_addon_atmosphere's lib/src/ is under lib/src/atmosphere/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_camera #

• package:flutter3d_addon_camera/flutter3d_addon_camera.dart (migrate). package:flutter3d_addon_camera/flutter3d_addon_camera.dart is package:flutter3d_camera/flutter3d_camera.dart. flutter3d_addon_camera is flutter3d_camera, renamed with nothing else changed; src/ keeps its layout, which the package rename carries.

flutter3d_addon_capture #

• package:flutter3d_addon_capture/flutter3d_addon_capture.dart (migrate). package:flutter3d_addon_capture/flutter3d_addon_capture.dart is package:flutter3d_game_ui/capture.dart. flutter3d_addon_capture is the capture.dart library of flutter3d_game_ui, with the API it had; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings.
• package:flutter3d_addon_capture/src/ (migrate). package:flutter3d_addon_capture/src/ is package:flutter3d_game_ui/src/capture/. What was under flutter3d_addon_capture's lib/src/ is under lib/src/capture/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_ghost #

• package:flutter3d_addon_ghost/flutter3d_addon_ghost.dart (migrate). package:flutter3d_addon_ghost/flutter3d_addon_ghost.dart is package:flutter3d_game_kit/ghost.dart. flutter3d_addon_ghost is the ghost.dart library of flutter3d_game_kit, with the API it had; package:flutter3d_game_kit/flutter3d_game_kit.dart exports it beside its siblings.
• package:flutter3d_addon_ghost/src/ (migrate). package:flutter3d_addon_ghost/src/ is package:flutter3d_game_kit/src/ghost/. What was under flutter3d_addon_ghost's lib/src/ is under lib/src/ghost/ of flutter3d_game_kit. Importing it was never the public API; the main library above is.

flutter3d_addon_hud #

• package:flutter3d_addon_hud/flutter3d_addon_hud.dart (migrate). package:flutter3d_addon_hud/flutter3d_addon_hud.dart is package:flutter3d_game_ui/hud.dart. flutter3d_addon_hud is the hud.dart library of flutter3d_game_ui, with the API it had; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings.
• package:flutter3d_addon_hud/src/ (migrate). package:flutter3d_addon_hud/src/ is package:flutter3d_game_ui/src/hud/. What was under flutter3d_addon_hud's lib/src/ is under lib/src/hud/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_light #

• package:flutter3d_addon_light/flutter3d_addon_light.dart (migrate). package:flutter3d_addon_light/flutter3d_addon_light.dart is package:flutter3d_post/light.dart. flutter3d_addon_light is the light.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_light/src/ (migrate). package:flutter3d_addon_light/src/ is package:flutter3d_post/src/light/. What was under flutter3d_addon_light's lib/src/ is under lib/src/light/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_motion #

• package:flutter3d_addon_motion/flutter3d_addon_motion.dart (migrate). package:flutter3d_addon_motion/flutter3d_addon_motion.dart is package:flutter3d_post/motion.dart. flutter3d_addon_motion is the motion.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_motion/src/ (migrate). package:flutter3d_addon_motion/src/ is package:flutter3d_post/src/motion/. What was under flutter3d_addon_motion's lib/src/ is under lib/src/motion/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_party #

• package:flutter3d_addon_party/flutter3d_addon_party.dart (migrate). package:flutter3d_addon_party/flutter3d_addon_party.dart is package:flutter3d_game_physics/party.dart. flutter3d_addon_party is the party.dart library of flutter3d_game_physics, with the API it had; package:flutter3d_game_physics/flutter3d_game_physics.dart exports it beside its siblings. It needs the native physics core, so it is not in flutter3d_game_kit, which builds none.
• package:flutter3d_addon_party/src/ (migrate). package:flutter3d_addon_party/src/ is package:flutter3d_game_physics/src/party/. What was under flutter3d_addon_party's lib/src/ is under lib/src/party/ of flutter3d_game_physics. Importing it was never the public API; the main library above is.

flutter3d_addon_photo_mode #

• package:flutter3d_addon_photo_mode/flutter3d_addon_photo_mode.dart (migrate). package:flutter3d_addon_photo_mode/flutter3d_addon_photo_mode.dart is package:flutter3d_game_ui/photo_mode.dart. flutter3d_addon_photo_mode is the photo_mode.dart library of flutter3d_game_ui, with the API it had; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings.
• package:flutter3d_addon_photo_mode/src/ (migrate). package:flutter3d_addon_photo_mode/src/ is package:flutter3d_game_ui/src/photo_mode/. What was under flutter3d_addon_photo_mode's lib/src/ is under lib/src/photo_mode/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_ragdoll #

• package:flutter3d_addon_ragdoll/flutter3d_addon_ragdoll.dart (migrate). package:flutter3d_addon_ragdoll/flutter3d_addon_ragdoll.dart is package:flutter3d_game_physics/ragdoll.dart. flutter3d_addon_ragdoll is the ragdoll.dart library of flutter3d_game_physics, with the API it had; package:flutter3d_game_physics/flutter3d_game_physics.dart exports it beside its siblings. It needs the native physics core, so it is not in flutter3d_game_kit, which builds none.
• package:flutter3d_addon_ragdoll/src/ (migrate). package:flutter3d_addon_ragdoll/src/ is package:flutter3d_game_physics/src/ragdoll/. What was under flutter3d_addon_ragdoll's lib/src/ is under lib/src/ragdoll/ of flutter3d_game_physics. Importing it was never the public API; the main library above is.

flutter3d_addon_reactions #

• package:flutter3d_addon_reactions/flutter3d_addon_reactions.dart (migrate). package:flutter3d_addon_reactions/flutter3d_addon_reactions.dart is package:flutter3d_game_kit/reactions.dart. flutter3d_addon_reactions is the reactions.dart library of flutter3d_game_kit, with the API it had; package:flutter3d_game_kit/flutter3d_game_kit.dart exports it beside its siblings.
• package:flutter3d_addon_reactions/src/ (migrate). package:flutter3d_addon_reactions/src/ is package:flutter3d_game_kit/src/reactions/. What was under flutter3d_addon_reactions's lib/src/ is under lib/src/reactions/ of flutter3d_game_kit. Importing it was never the public API; the main library above is.

flutter3d_addon_reflections #

• package:flutter3d_addon_reflections/flutter3d_addon_reflections.dart (migrate). package:flutter3d_addon_reflections/flutter3d_addon_reflections.dart is package:flutter3d_post/reflections.dart. flutter3d_addon_reflections is the reflections.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_reflections/src/ (migrate). package:flutter3d_addon_reflections/src/ is package:flutter3d_post/src/reflections/. What was under flutter3d_addon_reflections's lib/src/ is under lib/src/reflections/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_screens #

• package:flutter3d_addon_screens/flutter3d_addon_screens.dart (migrate). package:flutter3d_addon_screens/flutter3d_addon_screens.dart is package:flutter3d_game_ui/screens.dart. flutter3d_addon_screens is the screens.dart library of flutter3d_game_ui, with the API it had; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings.
• package:flutter3d_addon_screens/src/ (migrate). package:flutter3d_addon_screens/src/ is package:flutter3d_game_ui/src/screens/. What was under flutter3d_addon_screens's lib/src/ is under lib/src/screens/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_seeded_levels #

• package:flutter3d_addon_seeded_levels/flutter3d_addon_seeded_levels.dart (migrate). package:flutter3d_addon_seeded_levels/flutter3d_addon_seeded_levels.dart is package:flutter3d_game_kit/seeded_levels.dart. flutter3d_addon_seeded_levels is the seeded_levels.dart library of flutter3d_game_kit, with the API it had; package:flutter3d_game_kit/flutter3d_game_kit.dart exports it beside its siblings.
• package:flutter3d_addon_seeded_levels/src/ (migrate). package:flutter3d_addon_seeded_levels/src/ is package:flutter3d_game_kit/src/seeded_levels/. What was under flutter3d_addon_seeded_levels's lib/src/ is under lib/src/seeded_levels/ of flutter3d_game_kit. Importing it was never the public API; the main library above is.

flutter3d_addon_shading #

• package:flutter3d_addon_shading/flutter3d_addon_shading.dart (migrate). package:flutter3d_addon_shading/flutter3d_addon_shading.dart is package:flutter3d_post/shading.dart. flutter3d_addon_shading is the shading.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_shading/src/ (migrate). package:flutter3d_addon_shading/src/ is package:flutter3d_post/src/shading/. What was under flutter3d_addon_shading's lib/src/ is under lib/src/shading/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_soundtrack #

• package:flutter3d_addon_soundtrack/flutter3d_addon_soundtrack.dart (migrate). package:flutter3d_addon_soundtrack/flutter3d_addon_soundtrack.dart is package:flutter3d_game_kit/soundtrack.dart. flutter3d_addon_soundtrack is the soundtrack.dart library of flutter3d_game_kit, with the API it had; package:flutter3d_game_kit/flutter3d_game_kit.dart exports it beside its siblings. ElementSounds and ElementCues, which reach the native physics core through flutter3d_effects, are in package:flutter3d_game_physics/elements.dart: import it, and depend on flutter3d_game_physics.
• package:flutter3d_addon_soundtrack/src/ (migrate). package:flutter3d_addon_soundtrack/src/ is package:flutter3d_game_kit/src/soundtrack/. What was under flutter3d_addon_soundtrack's lib/src/ is under lib/src/soundtrack/ of flutter3d_game_kit. Importing it was never the public API; the main library above is.

flutter3d_addon_style #

• package:flutter3d_addon_style/flutter3d_addon_style.dart (migrate). package:flutter3d_addon_style/flutter3d_addon_style.dart is package:flutter3d_post/style.dart. flutter3d_addon_style is the style.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addon_style/src/ (migrate). package:flutter3d_addon_style/src/ is package:flutter3d_post/src/style/. What was under flutter3d_addon_style's lib/src/ is under lib/src/style/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_addon_touch #

• package:flutter3d_addon_touch/flutter3d_addon_touch.dart (migrate). package:flutter3d_addon_touch/flutter3d_addon_touch.dart is package:flutter3d_game_ui/touch.dart. flutter3d_addon_touch is the touch.dart library of flutter3d_game_ui; package:flutter3d_game_ui/flutter3d_game_ui.dart exports it beside its siblings. Two of its widgets merged with the ones that did the same job: TouchCluster is TouchControls, whose toggle: is corner:, and Pedal is TouchButton.pedal, with the same parameters.
• package:flutter3d_addon_touch/src/ (migrate). package:flutter3d_addon_touch/src/ is package:flutter3d_game_ui/src/touch/. What was under flutter3d_addon_touch's lib/src/ is under lib/src/touch/ of flutter3d_game_ui. Importing it was never the public API; the main library above is.

flutter3d_addon_world #

• package:flutter3d_addon_world/flutter3d_addon_world.dart (migrate). package:flutter3d_addon_world/flutter3d_addon_world.dart is package:flutter3d_game_kit/world.dart. flutter3d_addon_world is the world.dart library of flutter3d_game_kit, with the API it had, but for Daylight.lightWater, which reaches the native physics core through flutter3d_effects: it is the DaylightOnWater extension of package:flutter3d_game_physics/elements.dart, called the same way once that library is imported.
• package:flutter3d_addon_world/src/ (migrate). package:flutter3d_addon_world/src/ is package:flutter3d_game_kit/src/world/. What was under flutter3d_addon_world's lib/src/ is under lib/src/world/ of flutter3d_game_kit. Importing it was never the public API; the main library above is.

flutter3d_addon_wrecks #

• package:flutter3d_addon_wrecks/flutter3d_addon_wrecks.dart (migrate). package:flutter3d_addon_wrecks/flutter3d_addon_wrecks.dart is package:flutter3d_game_physics/wrecks.dart. flutter3d_addon_wrecks is the wrecks.dart library of flutter3d_game_physics, with the API it had; package:flutter3d_game_physics/flutter3d_game_physics.dart exports it beside its siblings. It needs the native physics core, so it is not in flutter3d_game_kit, which builds none.
• package:flutter3d_addon_wrecks/src/ (migrate). package:flutter3d_addon_wrecks/src/ is package:flutter3d_game_physics/src/wrecks/. What was under flutter3d_addon_wrecks's lib/src/ is under lib/src/wrecks/ of flutter3d_game_physics. Importing it was never the public API; the main library above is.

flutter3d_addons_standard #

• package:flutter3d_addons_standard/flutter3d_addons_standard.dart (migrate). package:flutter3d_addons_standard/flutter3d_addons_standard.dart is package:flutter3d_post/standard.dart. flutter3d_addons_standard is the standard.dart library of flutter3d_post, with the API it had; package:flutter3d_post/flutter3d_post.dart exports it beside its siblings.
• package:flutter3d_addons_standard/src/ (migrate). package:flutter3d_addons_standard/src/ is package:flutter3d_post/src/standard/. What was under flutter3d_addons_standard's lib/src/ is under lib/src/standard/ of flutter3d_post. Importing it was never the public API; the main library above is.

flutter3d_app #

• BinaryStorage (by hand). BinaryStorage is an abstract base class: an implementation is written extends BinaryStorage. Its write returns Future<void> and throws a StorageException when the platform refused, where it answered false: throw one where you returned false, and drop the return true.
• BinaryStorage.write (by hand). write returns Future<void> and throws a StorageException when the platform refused, as Storage.write does, where it answered false: replace a check of the answer with try { await storage.write(…); } on StorageException catch (e) { … }. The exception's name and message say which document and why.
• Decal3D (migrate). color: Vector3(x, y, z) of Decal3D is color: LinearColor.fromSrgb(x, y, z). color and emissive are linear LinearColors; the old color drew as sRGB, so LinearColor.fromSrgb(r, g, b, a) keeps the picture.
• Decal3D.emissive (migrate). emissive: Vector3(x, y, z) of Decal3D.emissive is emissive: LinearColor(x, y, z). emissive is a linear LinearColor: Vector3(r, g, b) is LinearColor(r, g, b), the same numbers.
• DidNotStart (nothing to do). The widget is a final class: a widget is composed, not subclassed, so a build method that wraps a DidNotStart is unchanged. A class that extended it builds one instead.
• DocumentText (dart fix). DocumentText is LevelDocumentText. The function LevelLoader reads a level's text through is LevelDocumentText; DocumentText is the editor's writer of documents in flutter3d_editor_core.
• FileBinaryStorage.write (by hand). write returns Future<void> and throws a StorageException when the file could not be written, where it answered false: replace a check of the answer with try { await storage.write(…); } on StorageException catch (e) { … }.
• FileStorage (by hand). FileStorage.read, write and remove are asynchronous, as Storage is: await them, and catch StorageException from write where false was checked.
• Flutter3dEngine (nothing to do). device and renderer are getters where they were final fields, since a device loss may replace either; every read compiles as it did.
• Issue (dart fix). Issue is imported from package:flutter3d_foundation/flutter3d_foundation.dart. The one issue type every package reports through is the foundation's; flutter3d_app keeps IssueLog and printIssue and no longer re-exports the type.
• IssueSink (dart fix). IssueSink is imported from package:flutter3d_foundation/flutter3d_foundation.dart. IssueSink is the foundation's, beside Issue.
• LevelLoadFailed (nothing to do). Nullable, as LoadingScreen.message: null is Flutter3dAppLocalizations.startOver in the reader's language.
• LevelLoadFailed (nothing to do). The widget is a final class: a widget is composed, not subclassed, so a build method that wraps a LevelLoadFailed is unchanged. A class that extended it builds one instead.
• LevelLoader (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• Light3D.color (migrate). color: Vector3(x, y, z) of Light3D.color is color: LinearColor(x, y, z). color is a linear LinearColor: Vector3(r, g, b) is LinearColor(r, g, b).
• LoadingScreen (nothing to do). The widget is a final class: a widget is composed, not subclassed, so a build method that wraps a LoadingScreen is unchanged. A class that extended it builds one instead.
• LoadingScreen (nothing to do). LoadingScreen.message and LevelLoadFailed.startOverLabel are nullable now: left out, they are the reader's language from Flutter3dAppLocalizations, English when the app installs no delegate. A caller that passes a string still says its own words; only code reading the field as a non-null String sees the change.
• Material3D (by hand). Material3D.baseColor and emissive are linear LinearColors (baseColor: LinearColor.fromSrgb(r, g, b) for a colour picked by eye, which is what the old Vector4 drew as), and emissiveStrength is nits: multiply a pre-1.0 number by RenderMaterial.defaultEmissiveStrength.
• MemoryPressureRelease (nothing to do). The widget is a final class: a widget is composed, not subclassed, so a build method that wraps a MemoryPressureRelease is unchanged. A class that extended it builds one instead.
• Mirror3D.tint (migrate). tint: Vector3(x, y, z) of Mirror3D.tint is tint: LinearColor(x, y, z). tint is a linear LinearColor: Vector3(r, g, b) is LinearColor(r, g, b).
• RendererFailure (nothing to do). The widget is a final class: a widget is composed, not subclassed, so a build method that wraps a RendererFailure is unchanged. A class that extended it builds one instead.
• Scene3D.clearColor (migrate). clearColor: Vector3(x, y, z) of Scene3D.clearColor is clearColor: LinearColor.fromSrgb(x, y, z). Scene3D(clearColor:) takes a LinearColor, in linear light, and encodes it to sRGB for the view. The Vector4 it took was handed to the view as sRGB whatever its doc said, so to keep the picture write the old numbers as LinearColor.fromSrgb(r, g, b, a).
• Scene3DController (nothing to do). device, renderer and scene are getters where they were fields, reading through the new engine; every read compiles as it did.
• SceneSurface (by hand). SceneSurface is a StatefulWidget now, so it can own the frame callback it takes as onFrame. Building one is unchanged; a class that extended it and overrode build has to wrap a SceneSurface in a widget of its own instead.
• Storage (by hand). read, write and remove are asynchronous: await them, inside an async function. A write the platform refused throws a StorageException where it answered false.
• Storage (by hand). Storage is asynchronous and an abstract base class. read answers Future<String?>, write a Future<void> that throws a StorageException when the platform refused, and remove a Future<void>: await them, and catch StorageException where a refused write used to be false. An implementation is written extends Storage with async overrides; a test can use MemoryStorage instead of its own.
• TerrainTiles (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• TerrainTiles.TerrainTiles (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• TerrainTiles.metresPerTexture (dart fix). TerrainTiles.metresPerTexture is metersPerTexture. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• VisibilityBatch (migrate). VisibilityBatch is a class: .node is .node, .bounds is .bounds; a destructuring pattern is yours to rewrite. VisibilityBatch is a final class with the same node and bounds; a batch handed to VisibilityCuller is built with VisibilityBatch(node: …, bounds: …). Only a destructuring pattern names the class.
• WidgetSurface.WidgetSurface (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• defaultDevices (by hand). There is no process-wide device registry. An engine owns one (Flutter3dEngine.devices, or Flutter3dView(device: DeviceSettings(devices: ...))), and an application that wants a backend or presenter of its own keeps a registry from platformDevices() and passes it: openDevice(width: w, height: h, registry: mine). A device openDevice opened remembers its registry, so presentFrame finds the presenter without being handed it again. A test that put a fake in front of the real backends adds it to that registry instead.
• kFixedResolution (dart fix). kFixedResolution is fixedResolution. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• package:flutter3d_editor_core/flutter3d_editor_core.dart (dart fix). Names re-exported from package:flutter3d_editor_core/flutter3d_editor_core.dart are imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. flutter3d_app re-exported LevelBatching and meshDataOf from the editor's core; it depends on neither the editor nor a re-export now. Import package:flutter3d_level_scene/flutter3d_level_scene.dart for them; dart fix adds the import, and migrate the dependency.

flutter3d_audio #

• AudioIssue (dart fix). AudioIssue is Issue. AudioIssue is Issue, the type flutter3d_app reports in, now declared in flutter3d_foundation and exported by flutter3d_audio and flutter3d_app alike, with the same message.
• AudioIssueSink (dart fix). AudioIssueSink is IssueSink. AudioIssueSink is IssueSink, void Function(Issue issue).
• SoLoudBackend (nothing to do). onIssue is an IssueSink where it was an AudioIssueSink; the two renames above carry every caller, and a sink written as a closure needs no change.
• Speakers (by hand). Speakers.backend is an AudioBackend, not a SoLoudBackend. Declare what you read it into as AudioBackend; speakers.pause(), resume() and dispose() are on Speakers itself. Code that needs the SoLoud class's own members (failedAssets) casts with as SoLoudBackend.
• openSpeakers (by hand). openSpeakers answers Future<Speakers> and throws AudioDeviceException when no audio device opens, where it answered null. Wrap the call in try { ... } on AudioDeviceException { ... } and play silent in the on branch; drop the == null check, and declare what you read it into as Speakers. onIssue takes an IssueSink.
• package:flutter3d_audio/testing.dart (by hand). soundTableIn was this repository's check of its demo games' sound banks against their source, not engine API, and is no longer published. Copy it into your own test helpers: it reads the file, collects the names after static const SoundDef and the names inside static final SoundBank all = SoundBank(<SoundDef>[…]), and returns both sets.

flutter3d_audio_core #

• AudioBackend (by hand). AudioBackend is an abstract base class: write extends AudioBackend where you wrote implements AudioBackend, and mark the class final, base or sealed. The five voice members are still yours to write. open, pause, resume and dispose have bodies that do nothing; an open or dispose your backend already had now overrides them (add @override). MixingBackend and DirectionalBackend no longer extend it; they are base mixin classes with bodies that do nothing, so a backend that offers them writes extends AudioBackend with MixingBackend.
• AudioBackend.start (migrate). AudioBackend.start takes one VoiceStart: an override reads its old parameters from it (parameter 1 is .asset, gain: is .gain, pan: is .pan, rate: is .rate, loop: is .loop, muffle: is .muffle), and a call builds one. AudioBackend.start takes one VoiceStart where it took its parameters. An audio backend is a hook a platform implements, asked per voice, so the scene reuses one context and a backend must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• AudioBackend.update (migrate). AudioBackend.update takes one VoiceUpdate: an override reads its old parameters from it (parameter 1 is .voice, gain: is .gain, pan: is .pan, rate: is .rate, muffle: is .muffle), and a call builds one. AudioBackend.update takes one VoiceUpdate where it took its parameters. An audio backend is a hook a platform implements, asked per voice per frame, so the scene reuses one context and a backend must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• AudioScene (nothing to do). emitters and play return AudioEmitter, the new name of SoundEmitter; the old name is a typedef of the new one, so code that holds the result as a SoundEmitter still compiles. play gained the optional bus and follow.
• LoopBand.LoopBand (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• LoopBand.centre (dart fix). LoopBand.centre is center. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SilentBackend.start (migrate). SilentBackend.start takes one VoiceStart: an override reads its old parameters from it (parameter 1 is .asset, gain: is .gain, pan: is .pan, rate: is .rate, loop: is .loop, muffle: is .muffle), and a call builds one. SilentBackend.start takes one VoiceStart where it took its parameters. An audio backend is a hook a platform implements, asked per voice, so the scene reuses one context and a backend must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• SilentBackend.update (migrate). SilentBackend.update takes one VoiceUpdate: an override reads its old parameters from it (parameter 1 is .voice, gain: is .gain, pan: is .pan, rate: is .rate, muffle: is .muffle), and a call builds one. SilentBackend.update takes one VoiceUpdate where it took its parameters. An audio backend is a hook a platform implements, asked per voice per frame, so the scene reuses one context and a backend must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• SilentVoice (nothing to do). The constructor takes named arguments (id:, asset:, gain:, pan:, rate:, loop:); SilentBackend makes every voice, and a test reads them, so no caller builds one.
• SilentVoice.alive (dart fix). SilentVoice.alive is isAlive. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SoundEmitter (dart fix). SoundEmitter is AudioEmitter. SoundEmitter is AudioEmitter in the 1.0 audio model, with the same members. The old name is not kept as a typedef; dart fix renames every use.

flutter3d_build #

• package:flutter3d_build/src/six_way_bake.dart (migrate). package:flutter3d_build/src/six_way_bake.dart is package:flutter3d_particles/flutter3d_particles.dart. The six-way smoke bake moved to flutter3d_particles, which owns the particle look it feeds; its public names are on the package's main library.
• AssetManifest.AssetManifest (migrate). AssetManifest(x0, x1) is AssetManifest(rules: x0, classes: x1). The rules, the device classes and the shader selection are named arguments: write AssetManifest(rules: …, classes: …) where they were positional.
• ConvertCommandOptions (by hand). The readers in flutter3d_build throw their own leaf of Flutter3dFormatException instead of dart:core's FormatException: ConvertUsageException (ConvertCommandSettings.parse), SourceFormatException (a PLY, USD, Godot or Unity text file, XML, a ZIP, or a file decodeModelFile has no reader for) and MigrationTableException (a migration table). An on FormatException around one of them no longer catches: catch the leaf, or Flutter3dFormatException for all of them.
• ConvertOptions (dart fix). ConvertOptions is ConvertSettings. Settings classes have one suffix in 1.0, Settings (a HAL type's is Descriptor), and each is final, const, with a copyWith that covers every field. The class is the same under the new name.
• ManifestFormatException (nothing to do). ManifestFormatException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on ManifestFormatException and on Exception still catches it, and nothing outside the package could extend it.
• SixWayField (dart fix). SixWayField is imported from package:flutter3d_particles/flutter3d_particles.dart.
• SixWaySheet (dart fix). SixWaySheet is imported from package:flutter3d_particles/flutter3d_particles.dart.
• TextureFamily.parse (by hand). TextureFamily.parse throws a ConvertUsageException naming the families there are, instead of answering null for a word it does not know. A caller that had a fallback asks TextureFamily.tryParse, which answers null as parse did: TextureFamily.tryParse(text) ?? fallback.
• bakeSixWay (dart fix). bakeSixWay is imported from package:flutter3d_particles/flutter3d_particles.dart.
• decodeModelFile (by hand). A file no reader claims, or one that is already a .f3d, throws SourceFormatException (a Flutter3dFormatException) instead of dart:core's FormatException. Catch that, or the family.
• fileUriResolverFor (by hand). A converted document reads only files inside its own directory (for convertFiles, inside the upload): a buffer, texture, mtllib or USD reference that climbs out with .. or is absolute is refused. Move the files it names under the model's directory, or pass root:.
• kAssetPipelineVersion (dart fix). kAssetPipelineVersion is assetPipelineVersion. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix.
• kDefaultChunkThreshold (dart fix). kDefaultChunkThreshold is defaultChunkThreshold. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kFlutter3dBuildVersionConstraint (dart fix). kFlutter3dBuildVersionConstraint is flutter3dBuildVersionConstraint. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix.
• kGitignoreEntry (dart fix). kGitignoreEntry is gitignoreEntry. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kHookBuildContent (dart fix). kHookBuildContent is hookBuildContent. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• package:flutter3d_core/flutter3d_core.dart (dart fix). Names re-exported from package:flutter3d_core/flutter3d_core.dart are imported from package:flutter3d_core/flutter3d_core.dart. DeviceClass and deviceClassPath are the core's, and flutter3d_build no longer re-exports them.
• parseLodRatios (by hand). parseLodRatios answers a non-null list and throws a ConvertUsageException naming the entry that is not a ratio between 0 and 1, instead of answering null. Drop the ?? … after the call, and catch ConvertUsageException where the null was handled.
• recognisedExtensions (dart fix). recognisedExtensions is recognizedExtensions. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• smokePuff (dart fix). smokePuff is imported from package:flutter3d_particles/flutter3d_particles.dart.
• splitLargeMeshes (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• usage (dart fix). usage is modelConvertUsage. usage is the text runConvert, the one-model converter, prints for arguments it cannot read; dart run flutter3d_build:convert is now flutter3d convert, whose usage is convertUsage in package:flutter3d_build/cli.dart.

flutter3d_conformance #

• ConformanceCheck (migrate). ConformanceCheck is a class: .name is .name, .run is .run; a destructuring pattern is yours to rewrite. ConformanceCheck is a final class with the same name and run, so a check can carry more in a minor. A record literal (name: 'x', run: check) becomes ConformanceCheck(name: 'x', run: check); two checks with one name and one run are still equal, so filtering one list by another works as before.
• ConformanceDeclined (dart fix). ConformanceDeclined is ConformanceDeclinedException. ConformanceDeclined is ConformanceDeclinedException (decision H: a type that is thrown is named *Exception), with the same members. It now extends CapabilityException (and through it Flutter3dException) instead of implementing Exception directly, so on Exception still catches it; dart fix renames every use.
• ConformanceFailure (dart fix). ConformanceFailure is ConformanceFailureException. ConformanceFailure is ConformanceFailureException (decision H: a type that is thrown is named *Exception), with the same members. It now extends CapabilityException (and through it Flutter3dException) instead of implementing Exception directly, so on Exception still catches it; dart fix renames every use.
• FuzzTransform (migrate, with a TODO). FuzzTransform is a class: a switch over it that names every value gains _ => throw UnimplementedError(). FuzzTransform is an abstract final class rather than a sealed one, so a case a later minor adds breaks no switch: a switch over its cases ends with a wildcard. The cases and their fields are unchanged.
• OwnShaderSection (migrate). OwnShaderSection is a class: .id is .id, .bytes is .bytes, .sdk is .sdk; a destructuring pattern is yours to rewrite. OwnShaderSection is a final class with the same id, bytes and sdk. The ownShaders callback returns OwnShaderSection(id: …, bytes: …, sdk: …) where it returned the record.
• PluginHarness (by hand). PluginHarness has no capture, restore or digest: the world the plugin acts on is the loop's. In setUp, put the application's state in loop.world, or add a part for it — loop.snapshots.add(SnapshotPart.of(id: 'my.world', capture: world.save, restore: (context) => world.load(context.data))) — and the checks capture, restore and digest it through EngineLoop.snapshots, the path a rollback takes. hasWorld is gone: a loop whose snapshots hold nothing is a run with no world.

flutter3d_core #

• 6 names were the package's own (gone internal): they are not exported since 1.0.0-rc.1, and the import of flutter3d_core that brought them gets one diagnostic for all of them. DrawItem, FramePassState, LightBuffer, RenderList, ShaderLightType, package:flutter3d_core/parity_scene.dart. A node or contributor uses FrameContext.noteDraw and FrameContext.invalidatePipeline. The limits are LightNode.maxLights and LightNode.maxExtraLights, LightBuffer.reaches(light, channels) is light.reaches(channels), and a scene's overflow is scene.overflowingLights. A frame says what it drew in FrameResult. Use LightType. A backend's own tests import it from package:flutter3d_core/src/engine/render/parity_scene.dart.
• AdaptiveQuality.AdaptiveQuality (migrate). AdaptiveQuality(x0, x1) is AdaptiveQuality(x0, settings: x1). The settings and the policy are named arguments, so the constructor can take another one: write AdaptiveQuality(table, settings: …) where the second argument was positional.
• AdaptiveQualitySettings (migrate). budgetMicros: x of AdaptiveQualitySettings is budget: Duration(microseconds: x). The frame time aimed at is a Duration: budgetMicros: 16667 is budget: Duration(microseconds: 16667). A read of the field is budget.inMicroseconds.
• AdaptiveScaleSettings (migrate). targetMicros: x of AdaptiveScaleSettings is target: Duration(microseconds: x). The frame period aimed at is a Duration: targetMicros: 16667 is target: Duration(microseconds: 16667). A read of the field is target.inMicroseconds.
• AnimationBlend (migrate, with a TODO). AnimationBlend is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a blend a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values and name are there; index is not.
• AnimationInterpolation (migrate, with a TODO). AnimationInterpolation is a class: a switch over it that names every value gains _ => throw UnimplementedError(). AnimationInterpolation is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• AnimationPath (migrate, with a TODO). AnimationPath is a class: a switch over it that names every value gains _ => throw UnimplementedError(). AnimationPath is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is there too.
• AnimationPlayer.play (migrate). AnimationPlayer.play(x0) is AnimationPlayer.play(index: x0). The clip to start is a named argument: player.play(2) is player.play(index: 2), beside playLayer's named options. play() with no clip still resumes the current one.
• AnimationPointer.parse (by hand). AnimationPointer.parse throws an AnimationPointerFormatException for a pointer this engine does not animate, instead of answering null. Code that checked for null (a loader meeting a file's pointer) calls AnimationPointer.tryParse, which answers null as parse did.
• AnimationPointerProperty (migrate, with a TODO). AnimationPointerProperty is a class: a switch over it that names every value gains _ => throw UnimplementedError(). AnimationPointerProperty is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is there too.
• AnimationPointerSink (migrate). AnimationPointerSink is a base mixin class: implements AnimationPointerSink becomes with AnimationPointerSink, on a base class.
• AnimationPointerTarget (migrate, with a TODO). AnimationPointerTarget is a class: a switch over it that names every value gains _ => throw UnimplementedError(). AnimationPointerTarget is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• AnimationTarget (migrate). AnimationTarget is a base mixin class: implements AnimationTarget becomes with AnimationTarget, on a base class.
• AnimationWrap (migrate, with a TODO). AnimationWrap is a class: a switch over it that names every value gains _ => throw UnimplementedError(). AnimationWrap is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• AssetSource.read (migrate). AssetSource.read takes one AssetRead where it took nothing: an override takes it, and a call hands one asking for nothing, const AssetRead(). AssetSource.read takes one AssetRead where it took nothing: what a reader asks of the read, a progress listener, a cancel signal and a byte range, which a minor can add to without breaking a source written against 1.0. A source that cannot report, stop early or read a range ignores the request and reads the whole file, as before. migrate gives an override the parameter and hands a call const AssetRead(), which asks for nothing (AssetRead.whole).
• Atmosphere (by hand). Its colours are LinearColors (sky: const LinearColor(0.4, 0.6, 0.9), or vector.toLinearColor()), it is const, and sunIntensity is lux: multiply a pre-1.0 value by LightNode.defaultIntensity.
• Atmosphere.ambientIntensity (by hand). Atmosphere.ambientIntensity is lux, as sunIntensity already was: multiply a pre-1.0 number by LightNode.defaultIntensity.
• Atmosphere.applyTo (nothing to do). applyTo(scene, clearColor: view.clearColor) is applyTo(scene, view: view): the atmosphere puts its sky on the view itself, linear as both are, and core-Atmosphere marks each use. Where it wrote the linear numbers into the sRGB vector as they were, a clear colour set from an atmosphere is lighter than in 0.8: the colour the sky was meant to be.
• BoolCondition (by hand). AnimationCondition has a new case, BoolCondition: a switch over a AnimationCondition that names every case needs one for it, or a wildcard.
• CellGrid.mesh (migrate). color: Vector3(x, y, z) of CellGrid.mesh is color: LinearColor(x, y, z). mesh(color:) takes a linear LinearColor: Vector4(r, g, b, a) is LinearColor(r, g, b, a).
• CellGrid.mesh (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• CheckedModelWriter (by hand). CheckedModelWriter is an abstract base class that extends ModelWriter. A writer that wrote implements CheckedModelWriter now writes extends CheckedModelWriter and is final or base itself; its members stay as they were.
• ClusterDraws (dart fix). ClusterDraws is imported from package:flutter3d_core/flutter3d_core.dart.
• ClusterIndices (migrate). ClusterIndices is a class: .buffer is .buffer, .count is .count; a destructuring pattern is yours to rewrite. ClusterDraws.indicesFor answers a ClusterIndices, a class with the record's fields as getters; a destructuring pattern names the class.
• CompareCondition (by hand). AnimationCondition has a new case, CompareCondition: a switch over a AnimationCondition that names every case needs one for it, or a wildcard.
• CompiledFrameGraph.CompiledFrameGraph (nothing to do). The constructor took the compiler's own tables, which nothing outside the engine could fill. A compiled graph comes from FrameGraph.compile, as it always did.
• ContributorFrame (by hand). A contributor counts its draw with frame.noteDraw() and says it bound a pipeline of its own with frame.invalidatePipeline(); the counters behind them are the renderer's. ContributorFrame is a FrameContext now, and also says the view's projection, its jitter, the time and the scene's origin.
• ContributorLights (migrate). ContributorLights is a base mixin class: implements ContributorLights becomes with ContributorLights, on a base class.
• ContributorLights.bind (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ContributorLights.bind (migrate). ContributorLights.bind takes one LightBindRequest: an override reads its old parameters from it (parameter 1 is .encoder, parameter 2 is .stage, centre: is .center, center: is .center, radius: is .radius), and a call builds one. ContributorLights.bind takes one LightBindRequest where it took its parameters. A contributor's lights are mixed in by a test or a renderer of one's own; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ContributorRegistry (by hand). Renderer.contributors and addContributor moved to the one registry: renderer.renderSteps.addContributor(c), removeContributor(c), and renderSteps.contributors to list them.
• DebugColors (by hand). The overlay colours are linear LinearColors, static final where they were getters making a Vector4; DebugDraw encodes them back to the same display colours. Pass them on as they are; a read of .x is .r, in linear light.
• DebugDraw (migrate). color: Vector3(x, y, z) of DebugDraw is color: LinearColor.fromSrgb(x, y, z). A line's colour is a linear LinearColor, which the overlay encodes for the display; the Vector4 was written to the screen as it was, an sRGB colour. The same line is LinearColor.fromSrgb(r, g, b, a) of the old numbers: addLine(a, b, Vector4(1, 0.5, 0, 1)) is addLine(a, b, LinearColor.fromSrgb(1, 0.5, 0)). The points are in scene space; a place in the world goes in through addWorldLine.
• DebugDrawGizmos (migrate). color: Vector3(x, y, z) of DebugDrawGizmos is color: LinearColor.fromSrgb(x, y, z). Every gizmo's colour (addBox, addTransformedBox, addFrustum, addSphere, addBoneOctahedron, addJointCross, addNormals, addSkeletonOverlay) is a linear LinearColor; see rc-core-DebugDraw-colours for why the old numbers go through LinearColor.fromSrgb.
• DebugDrawGizmos.addSphere (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• DebugDrawGizmos.buildForScene (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• DebugDrawOptions (dart fix). DebugDrawOptions is DebugDrawSettings. Settings classes have one suffix in 1.0, Settings (a HAL type's is Descriptor), and each is final, const, with a copyWith that covers every field. The class is the same under the new name.
• DecalNode (migrate). color: Vector3(x, y, z) of DecalNode is color: LinearColor.fromSrgb(x, y, z). DecalNode.color is a linear LinearColor with the opacity in its alpha (it was an sRGB Vector4: LinearColor.fromSrgb(r, g, b, a) keeps the picture), and emissive a linear LinearColor. Both are assigned whole: decal.color.w = o is decal.color = decal.color.withAlpha(o).
• DecalNode.emissive (migrate). emissive: Vector3(x, y, z) of DecalNode.emissive is emissive: LinearColor(x, y, z). emissive is a linear LinearColor, assigned whole: Vector3(r, g, b) is LinearColor(r, g, b), the same numbers.
• DepthOfFieldSettings.lensFor (nothing to do). Answers a ThinLens whose getters are the record's fields, focalLength and sensorWidth, so a read of one is unchanged; a destructuring pattern names the class (2b-core-ThinLens).
• DeviceClass.parse (migrate, with a TODO). DeviceClass.parse throws UnknownDeviceClassException where it returned null: a null check beside a call becomes try … on UnknownDeviceClassException. A name that is not a class throws UnknownDeviceClassException, naming the classes there are, where it answered null. DeviceClass.tryParse is the lookup that still answers null.
• DeviceClassMemory (by hand). An abstract base class since 1.0: write extends DeviceClassMemory where you wrote implements DeviceClassMemory, and mark the class final, base or sealed.
• DeviceClassSelector (migrate). desktopMicros: x of DeviceClassSelector is desktopLimit: Duration(microseconds: x). The slowest probe frame a desktop may take is a Duration: desktopMicros: 8000 is desktopLimit: Duration(microseconds: 8000). choose(measuredMicros:) still takes the measurement in microseconds.
• DeviceMesh.clusters (migrate). DeviceMesh is a class: .table is .table, .indices is .indices; a destructuring pattern is yours to rewrite. clusters is a ClusteredIndices with the same table and indices.
• DiffuseModel (migrate, with a TODO). DiffuseModel is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a diffuse lobe a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values and name are there; index is not.
• DracoException (nothing to do). DracoException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on DracoException and on Exception still catches it, and nothing outside the package could extend it.
• DrawableGeometry (by hand). DrawableGeometry is an abstract base class that mixes in MeshGeometry. Code that draws one is unchanged. A geometry of your own that implemented it now extends DrawableGeometry (and is final or base itself), and keeps the members it wrote.
• DrawableGeometry.clusters (migrate). DrawableGeometry is a class: .table is .table, .indices is .indices; a destructuring pattern is yours to rewrite. clusters is a ClusteredIndices with the same table and indices: a geometry of your own returns ClusteredIndices(table: …, indices: …) or null.
• EffectiveAntiAliasing.none (dart fix). EffectiveAntiAliasing.none is isNone. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• EnumHintValue.EnumHintValue (migrate). EnumHintValue(x0, x1) is EnumHintValue(x0, label: x1). The label is a named argument: write EnumHintValue('opaque', label: 'Opaque') where the label was the second positional argument.
• EnvironmentCube (migrate). EnvironmentCube is a class: .texture is .texture, .levels is .levels; a destructuring pattern is yours to rewrite. EnvironmentMap.fromSky, fromPanorama and fromEncoded answer an EnvironmentCube, a class with the record's fields as getters; a destructuring pattern names the class.
• EnvironmentMap.fromEncoded (by hand). Completes with the environment, not a nullable one: bytes neither reader takes throw a PanoramaFormatException, and the rest as fromPanorama.
• EnvironmentMap.fromPanorama (by hand). Returns the environment, not a nullable one: a device without cubes throws UnsupportedCapabilityException (ask EnvironmentMap.isSupportedOn), and pixels that are not width × height RGBA8 an ArgumentError.
• EnvironmentMap.fromSky (by hand). Returns the environment, not a nullable one: a device without cubes throws UnsupportedCapabilityException and a sky that is off an ArgumentError. Ask EnvironmentMap.isSupportedOn(device) (and sky.enabled) first where the null meant "keep the flat ambient".
• F3dDecoder.decode (migrate). F3dDecoder.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. F3dDecoder.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• F3dDecoder.handles (migrate). F3dDecoder.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. F3dDecoder.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• F3dFormatException (nothing to do). F3dFormatException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on F3dFormatException and on Exception still catches it, and nothing outside the package could extend it.
• F3dModelWriter.write (migrate). F3dModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. F3dModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• FabrikIk (nothing to do). Only the animation pose in its signature changed: Pose is AnimationPose (core-Pose-AnimationPose renames it).
• FbxDecoder.decode (migrate). FbxDecoder.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. FbxDecoder.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• FbxDecoder.handles (migrate). FbxDecoder.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. FbxDecoder.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• FieldPass.spec (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FileAssetSource.read (migrate). FileAssetSource.read takes one AssetRead where it took nothing: an override takes it, and a call hands one asking for nothing, const AssetRead(). FileAssetSource.read takes the AssetRead every source's read takes; a call is handed const AssetRead(), which reads the whole file as before.
• FogSettings (migrate). color: Vector3(x, y, z) of FogSettings is color: LinearColor(x, y, z). The colours of FogSettings, LightShaftSettings, VolumetricFogSettings (color, ambient) and XraySettings are linear LinearColors, so the settings can be const: color: Vector3(r, g, b) is color: LinearColor(r, g, b), or vector.toLinearColor().
• FootPlantGoal (by hand). AnimationGoal has a new case, FootPlantGoal: a switch over a AnimationGoal that names every case needs one for it, or a wildcard.
• FrameCapture (by hand). FrameCapture.fromJson and FrameCapture.parse return a capture or throw a FrameCaptureFormatException with the reason (another format, a newer version, no size) instead of returning null; catch it where a file may not be a capture. The constructor is no longer const (FrameCapture is a FormatDocument now). fileFormat is f3d.frameCapture and fileVersion 2; files written as flutter3d.frameCapture version 1 still read.
• FrameCaptureBuilder (dart fix). FrameCaptureBuilder is imported from package:flutter3d_core/flutter3d_core.dart.
• FrameGraphNode.supported (dart fix). FrameGraphNode.supported is isSupported. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• FrameHistory (by hand). The history is kept per view now, so views drawn by separate Renderer.render calls each have their own past. of(node) is of(node, view) and moved(node) is moved(node, view): pass the RenderView whose last frame you mean, the one you hand to render.
• FrameHistory (by hand). The last view-projection is kept per RenderView since 1.0, not per camera, so two views of one camera each keep their own: viewProjection(view).
• FramePass (migrate). FramePass is a class: .name is .name, .active is .active, .micros is .micros, .gpuMicros is .gpuMicros, .drawCalls is .drawCalls, .triangles is .triangles, .pipelineSwitches is .pipelineSwitches; a destructuring pattern is yours to rewrite. FramePass is a class whose getters are the record's fields, so reading one is unchanged; a record literal is FramePass(name: …), and a destructuring pattern names the class.
• FramePhase (by hand). The two phases were two anchors. Add a node with renderer.renderSteps.addNode(node, at: RenderAnchor.afterScene) for FramePhase.overlay and at: RenderAnchor.beforePresent for FramePhase.present; a node that knows where it belongs overrides RenderNode.defaultAnchor and is added with no at.
• FrameResourceIds.hdrColour (dart fix). FrameResourceIds.hdrColour is hdrColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• FrameResourceIds.sceneColour (dart fix). FrameResourceIds.sceneColour is sceneColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• FrameResources.transient (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FrameTextureSource (migrate). FrameTextureSource is a base mixin class: implements FrameTextureSource becomes with FrameTextureSource, on a base class.
• FrameWorkBudget (migrate). microseconds: x of FrameWorkBudget is allowance: Duration(microseconds: x). The allowance is a Duration: FrameWorkBudget(microseconds: 1000) is FrameWorkBudget(allowance: Duration(microseconds: 1000)). What it reports having spent (spent, remaining, averageCost) is still microseconds.
• FreeLook.metresPerSecond (dart fix). FreeLook.metresPerSecond is metersPerSecond. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• FullscreenDraw.FullscreenDraw (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FullscreenDraw.sampler (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FullscreenDraw.samplerFor (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FullscreenDraw.samplers (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• FullscreenEffect (by hand). preferredPhase is defaultAnchor. An effect no longer registers itself anywhere: add it with renderer.renderSteps.addNode(effect), which places it at its own anchor.
• GeneratedTangents (migrate). GeneratedTangents is a class: .mesh is .mesh, .copiedFrom is .copiedFrom; a destructuring pattern is yours to rewrite. generateTangents answers a GeneratedTangents, a class with the record's fields as getters: final GeneratedTangents(:mesh) = ….
• GlbModelWriter.write (migrate). GlbModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. GlbModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• GltfLoader.decode (migrate). GltfLoader.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. GltfLoader.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• GltfLoader.handles (migrate). GltfLoader.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. GltfLoader.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• GltfWriter.usedGeometryQuantization (dart fix). GltfWriter.usedGeometryQuantization is didQuantizeGeometry. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• GltfWriter.usedVertexCacheReordering (dart fix). GltfWriter.usedVertexCacheReordering is didReorderVertexCache. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• HdrFormatException (nothing to do). HdrFormatException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on HdrFormatException and on Exception still catches it, and nothing outside the package could extend it.
• HiZOcclusion.HiZOcclusion (nothing to do). The renderer makes the one it uses and feeds it the depths it read back from the GPU; one made by hand at 0.8.5 was never fed and answered nothing, so no code had a use for it. OcclusionMode.hiZ in the render settings asks for it, as before.
• HighContrastSettings (migrate). outlineColor: Vector3(x, y, z) of HighContrastSettings is outlineColor: LinearColor.fromSrgb(x, y, z). HighContrastSettings.outlineColor is a linear LinearColor, encoded to the display where the line is drawn: a display colour is LinearColor.fromSrgb(r, g, b).
• HitResult (nothing to do). Reading a hit is unchanged: node, distance, triangleIndex and approximate read as before, and only writing them is gone. A hit is the caller's now, a new one per cast, where before 1.0 it was the caster's scratch that the next cast wrote over; a write into it changed nothing the engine read, so there is nothing to carry over. Keep a value of your own in a variable of your own.
• ImmediateTextureSource.acquire (nothing to do). Its parameter's type is RenderTargetSpec renamed to RenderTargetDescriptor, which the rename of that type carries; a call passes the same value as before. ImmediateTextureSource is exported by flutter3d again, as at 0.8.5.
• ImpostorNode.ImpostorNode (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ImpostorNode.ImpostorNode.withCard (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ImpostorNode.centre (dart fix). ImpostorNode.centre is center. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• InstanceHandle.live (dart fix). InstanceHandle.live is isLive. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• InstanceHandle.setColor (migrate). color: Vector3(x, y, z) of InstanceHandle.setColor is color: LinearColor(x, y, z). Takes a linear LinearColor; vector.toLinearColor() converts.
• InstancedMeshNode (migrate). color: Vector3(x, y, z) of InstancedMeshNode is color: LinearColor(x, y, z). An instance's colour is a linear LinearColor: addInstance(m, color: Vector4(r, g, b, a)) is addInstance(m, color: LinearColor(r, g, b, a)), and InstanceHandle.setColor takes one too. data stays a Vector4.
• IrradianceAtlas (migrate). IrradianceAtlas is a class: .width is .width, .height is .height, .columns is .columns, .momentsTop is .momentsTop, .texels is .texels; a destructuring pattern is yours to rewrite. IrradianceField.toAtlas answers an IrradianceAtlas, a class with the record's fields as getters; a destructuring pattern names the class.
• IrradianceField (by hand). Irradiance is a LinearColor: writeIrradiance and writeIrradianceTexel take one (vector.toLinearColor(), or LinearColor(r, g, b)), and readIrradiance and sample answer one and take no out vector; read .r, .g, .b where you read .x, .y, .z. toAtlas answers an IrradianceAtlas (2b-core-IrradianceAtlas).
• IrradianceField.writeIrradiance (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• IrradianceField.writeIrradianceTexel (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• Ktx2FormatException (nothing to do). Ktx2FormatException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on Ktx2FormatException and on Exception still catches it, and nothing outside the package could extend it.
• LightNode (by hand). intensity is in photometric units since 1.0: lux for a directional light, candela for a point, spot or area light. Multiply a pre-1.0 literal by LightNode.defaultIntensity (about 5 790.6) and the picture is the picture it was; or write the light's real lux or candela, or make it with LightNode.lumens. color is a LinearColor: color: const LinearColor(1, 0.8, 0.6), light.color = vector.toLinearColor() where it was light.color.setValues(...).
• LightNode.color (migrate). color: Vector3(x, y, z) of LightNode.color is color: LinearColor(x, y, z). color is a linear LinearColor, assigned whole: color: Vector3(r, g, b) is color: LinearColor(r, g, b), the same numbers, and light.color.setValues(r, g, b) is light.color = LinearColor(r, g, b).
• LightNode.maxExtraLights (nothing to do). A static getter now, with the same value (24), for the reason maxLights is one.
• LightNode.maxLights (nothing to do). A static getter now, with the same value (8). Every read still compiles; only a const expression that used it does not, and it takes the number itself or a non-const variable.
• LightShaftSettings (migrate). color: Vector3(x, y, z) of LightShaftSettings is color: LinearColor(x, y, z). color is a linear LinearColor; see f2-core-settings-colours.
• LightType (dart fix). LightType is imported from package:flutter3d_foundation/flutter3d_foundation.dart. LightType is flutter3d_foundation's, so a level, a modeller project and a model file hold the same kinds the scene does, area and a plugin's own among them; the facades export it as before.
• LightType (by hand). An open set since 1.0, so a light type a later minor adds does not break your code: a switch over it needs a _ => case. values, name and index are where they were; LightType.byName reads a name back.
• LightType.index (nothing to do). A getter where it was a field, with the same values; LightType gained LightType.custom and base, so the set is open.
• LineStripNode (migrate). color: Vector3(x, y, z) of LineStripNode is color: LinearColor(x, y, z). LineStripNode(color:) and color are a linear LinearColor.
• LineStripNode.LineStripNode (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• LineStripNode.colour (dart fix). LineStripNode.colour is color. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• LodGroup (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• LookGoal (by hand). AnimationGoal has a new case, LookGoal: a switch over a AnimationGoal that names every case needs one for it, or a wildcard.
• LookSettings (migrate). lift:, gamma:, gain: of LookSettings: Vector3(x, y, z) is LinearColor(x, y, z). lift, gamma and gain are LinearColors, one value per channel in red, green and blue, so the settings can be const: lift: Vector3(0, 0, 0.1) is lift: LinearColor(0, 0, 0.1), the same numbers, and a read of .x is .r.
• Material (dart fix). Material is RenderMaterial. The engine's material is RenderMaterial, so it no longer collides with Flutter's Material widget and the hide Material clauses go. (SurfaceMaterial was already the format-neutral material a decoder produces.)
• MaterialAlphaMode (migrate, with a TODO). MaterialAlphaMode is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so an alpha mode a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values and name are there; index is not.
• MaterialBinary (dart fix). MaterialBinary is ExpressionBinary. MaterialBinary was a second name of ExpressionBinary, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionBinary, from flutter3d_foundation, which the facades export.
• MaterialBindings (nothing to do). usesLightList became a final field instead of a getter. Reading it is the same; MaterialBindings is final, so nothing overrode it.
• MaterialBuiltin (dart fix). MaterialBuiltin is ExpressionBuiltin. MaterialBuiltin was a second name of ExpressionBuiltin, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionBuiltin, from flutter3d_foundation, which the facades export.
• MaterialBuiltin.glsl (migrate). MaterialBuiltin.glsl becomes x.name.
• MaterialCall (dart fix). MaterialCall is ExpressionCall. MaterialCall was a second name of ExpressionCall, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionCall, from flutter3d_foundation, which the facades export.
• MaterialConstant (dart fix). MaterialConstant is ExpressionConstant. MaterialConstant was a second name of ExpressionConstant, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionConstant, from flutter3d_foundation, which the facades export.
• MaterialConstruct (dart fix). MaterialConstruct is ExpressionConstruct. MaterialConstruct was a second name of ExpressionConstruct, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionConstruct, from flutter3d_foundation, which the facades export.
• MaterialExpression (dart fix). MaterialExpression is Expression. MaterialExpression was a second name of Expression, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, Expression, from flutter3d_foundation, which the facades export.
• MaterialExtensions (migrate). specularColor:, sheenColor:, attenuationColor: of MaterialExtensions: Vector3(x, y, z) is LinearColor(x, y, z). specularColor, sheenColor and attenuationColor are linear LinearColors with const defaults: Vector3(r, g, b) is LinearColor(r, g, b).
• MaterialHintKind (migrate, with a TODO). MaterialHintKind is a class: a switch over it that names every value gains _ => throw UnimplementedError(). MaterialHintKind is an abstract final class rather than a sealed one, so a case a later minor adds breaks no switch: a switch over its cases ends with a wildcard. The cases and their fields are unchanged.
• MaterialInput.MaterialInput (dart fix). An input says the material language version it arrived in, so a source of an older version neither reads it nor loses a name to it: every input a version 1 source could read is since: 1, which is what the fix writes. Give an input a translator of your own adds the version that brings it.
• MaterialInput.type (nothing to do). Only a type it names was renamed (a name Flutter or Dart also declares); the type's rename carries its own fix, and a call needs none.
• MaterialInputRef (nothing to do). It extends the expression language's ExpressionVariable, named as its input; input, the constructor and a material visitor's visitInputRef are unchanged.
• MaterialLet.value (nothing to do). Only a type it names was renamed (a name Flutter or Dart also declares); the type's rename carries its own fix, and a call needs none.
• MaterialLocalRef (nothing to do). It extends ExpressionVariable; name, the constructor and visitLocalRef are unchanged.
• MaterialMap (migrate, with a TODO). MaterialMap is a class: a switch over it that names every value gains _ => throw UnimplementedError(). MaterialMap is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is there too.
• MaterialNegate (dart fix). MaterialNegate is ExpressionNegate. MaterialNegate was a second name of ExpressionNegate, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionNegate, from flutter3d_foundation, which the facades export.
• MaterialOutput (by hand). MaterialStatement has a new case, MaterialOutput (out name = value;), which only a version 2 vertex block holds: a switch over a MaterialStatement that names every case needs one for it, or a wildcard. A reader of fragment, light, ambient or composite bodies never meets it and can refuse it; evaluateMaterialVertex runs a vertex block's outputs, and emitMaterialVertex writes them.
• MaterialParamRef (nothing to do). It extends ExpressionVariable, named as its parameter; parameter, the constructor and visitParamRef are unchanged.
• MaterialParameter.type (nothing to do). Only a type it names was renamed (a name Flutter or Dart also declares); the type's rename carries its own fix, and a call needs none.
• MaterialReturn.value (nothing to do). Only a type it names was renamed (a name Flutter or Dart also declares); the type's rename carries its own fix, and a call needs none.
• MaterialSample (nothing to do). It extends Expression, which MaterialExpression now names; slot, uv, the constructor and visitSample are unchanged.
• MaterialSortIds (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• MaterialStatement (migrate, with a TODO). MaterialStatement is a class: a switch over it that names every value gains _ => throw UnimplementedError(). MaterialStatement is an abstract base class with a visitor rather than a sealed class, so a statement kind a later minor adds breaks no switch: a switch over the kinds ends with a wildcard, or reads every kind through accept and a MaterialStatementVisitor, whose visitUnknown answers for a kind it predates. MaterialExpression has the same visitor, MaterialExpressionVisitor.
• MaterialSwizzle (dart fix). MaterialSwizzle is ExpressionSwizzle. MaterialSwizzle was a second name of ExpressionSwizzle, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionSwizzle, from flutter3d_foundation, which the facades export.
• MaterialSyntaxError (dart fix). MaterialSyntaxError is MaterialSyntaxException. *Error is for programmer mistakes, which a caller does not catch; this is something a correct program meets, so it is an exception and is named like one. MaterialSyntaxException has the same constructor and members and extends Flutter3dFormatException.
• MaterialType (dart fix). MaterialType is ExpressionType. MaterialType was a second name of ExpressionType, the expression language's own, and MaterialType is also a Flutter widget's name: the type is spelled once now, ExpressionType, from flutter3d_foundation, which the facades export.
• MaterialVariant.MaterialVariant (migrate). MaterialVariant(x0, x1) is MaterialVariant(x0, values: x1). The values are a named argument: write MaterialVariant('Rim', values: {…}) where the map was the second positional argument.
• MeshBuilder.addVertex (migrate). color: Vector3(x, y, z) of MeshBuilder.addVertex is color: LinearColor(x, y, z). addVertex(color:) takes a linear LinearColor, as a vertex colour is: color: Vector4(r, g, b, a) is color: LinearColor(r, g, b, a), the same numbers.
• MeshData.withColor (migrate). color: Vector3(x, y, z) of MeshData.withColor is color: LinearColor(x, y, z). withColor takes a linear LinearColor: withColor(Vector4(r, g, b, a)) is withColor(LinearColor(r, g, b, a)), and withColor(linearFromSrgb(r, g, b)) is withColor(LinearColor.fromSrgb(r, g, b)).
• MeshGeometry (migrate). MeshGeometry is a base mixin class: implements MeshGeometry becomes with MeshGeometry, on a base class.
• MeshNode (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• MeshNode.outlineColor (migrate). outlineColor: Vector3(x, y, z) of MeshNode.outlineColor is outlineColor: LinearColor.fromSrgb(x, y, z). MeshNode.outlineColor is a linear LinearColor. It held the display-referred channels a Color gives; say those as LinearColor.fromSrgb(r, g, b) (or color.toLinear()), and the ring is the colour it was.
• MeshNode.tint (migrate). tint: Vector3(x, y, z) of MeshNode.tint is tint: LinearColor(x, y, z). MeshNode.tint is a LinearColor assigned whole: node.tint.setValues(1, 0.3, 0.3, 1) is node.tint = LinearColor(1, 0.3, 0.3), tint.w is tint.a.
• MeshNode.worldBoundsCentre (dart fix). MeshNode.worldBoundsCentre is worldBoundsCenter. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• MeshNode.worldIsMirrored (dart fix). MeshNode.worldIsMirrored is isWorldMirrored. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• MeshOverlay (migrate). color: Vector4(x, y, z, w) of MeshOverlay is color: LinearColor.fromSrgb(x, y, z, w). edge, point, ribbon and wash take a linear LinearColor and write it as it is; they took the design's sRGB numbers in a Vector4 and decoded them with asDrawn, which is gone. The same picture is LinearColor.fromSrgb(r, g, b, a) of the old numbers, and MeshOverlay.asDrawn(v) is LinearColor.fromSrgb(v.x, v.y, v.z, v.w).
• MeshOverlay.asDrawn (migrate). MeshOverlay.asDrawn becomes LinearColor.fromSrgb({0}.x, {0}.y, {0}.z, {0}.w).toVector4(). MeshOverlay.asDrawn(v) is gone with the vector colours: the overlay takes LinearColor.fromSrgb(v.x, v.y, v.z, v.w).
• MeshOverlay.edge (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• MeshOverlay.point (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• MeshOverlay.ribbon (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• MeshOverlay.wash (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• MeshTangents (nothing to do). generateTangents answers a GeneratedTangents whose getters are the record's fields, mesh and copiedFrom, so a read of one is unchanged; a destructuring pattern names the class (2b-core-GeneratedTangents).
• ModelCameraProjection (migrate, with a TODO). ModelCameraProjection is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ModelCameraProjection is an abstract final class rather than a sealed one, so a case a later minor adds breaks no switch: a switch over its cases ends with a wildcard. The cases and their fields are unchanged.
• ModelDecoder (by hand). ModelDecoder is an abstract base class, so a member added in a minor comes with a default and breaks no decoder. A decoder of your own that wrote implements ModelDecoder now writes extends ModelDecoder and is final or base itself; its members stay as they were, and a const constructor still works.
• ModelDecoder.decode (migrate). ModelDecoder.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. ModelDecoder.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ModelDecoder.handles (migrate). ModelDecoder.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. ModelDecoder.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ModelDocument (by hand). ModelDocument is an abstract base class. A document of your own already extended it; the class that extends it is now final or base itself (final class MyDocument extends ModelDocument).
• ModelFormat (by hand). ModelFormat is a class with constant values instead of an enum, so a later release can name a format without breaking a switch written against this one. ModelFormat.gltf and the rest, values and name are unchanged; an exhaustive switch over it needs a default case.
• ModelImpostor.ModelImpostor (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ModelImpostor.centre (dart fix). ModelImpostor.centre is center. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ModelLight (migrate). color: Vector3(x, y, z) of ModelLight is color: LinearColor(x, y, z). ModelLight(color:) and ModelLight.color are a LinearColor, in linear light, where they were a Vector3: write LinearColor(r, g, b) for the same numbers.
• ModelLight.color (migrate). color: Vector3(x, y, z) of ModelLight.color is color: LinearColor(x, y, z). ModelLight.color is a linear LinearColor; Vector3(r, g, b) is LinearColor(r, g, b), and it goes onto a LightNode.color as it is.
• ModelLightType (dart fix). ModelLightType is LightType. A model file's lights are the scene's kinds, LightType, with the same directional, point and spot; the facades export it, and a file that imports only the core imports flutter3d_foundation for it.
• ModelLightType (migrate, with a TODO). ModelLightType is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a light type a later minor reads (an area light) does not break your code: a switch over it needs a _ => case. The constants, values and name (the extension's own type) are there; index is not.
• ModelPart (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• ModelSplat.ModelSplat (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ModelSplat.colourSpace (dart fix). ModelSplat.colourSpace is colorSpace. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ModelWriteFormat (migrate, with a TODO). ModelWriteFormat is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ModelWriteFormat is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• ModelWriter (by hand). ModelWriter is an abstract base class. A writer of your own that wrote implements ModelWriter now writes extends ModelWriter and is final or base itself; its members stay as they were.
• ModelWriter.write (migrate). ModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. ModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• MorphSink (migrate). MorphSink is a base mixin class: implements MorphSink becomes with MorphSink, on a base class.
• NodeFrame (dart fix). NodeFrame is RenderFrame. What a node is handed is RenderFrame, a FrameContext that also says the view, its matrices, the jitter, the time and the frame index.
• ObjLoader.decode (migrate). ObjLoader.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. ObjLoader.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ObjLoader.handles (migrate). ObjLoader.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. ObjLoader.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ObjModelWriter.write (migrate). ObjModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. ObjModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• ObjNormals (migrate, with a TODO). ObjNormals is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ObjNormals is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• OcclusionMode (by hand). An open set since 1.0: a switch over it needs a _ => case. values, name, index and byName are there.
• OcclusionTest (migrate). OcclusionTest is a base mixin class: implements OcclusionTest becomes with OcclusionTest, on a base class.
• OffAxisProjection.OffAxisProjection.symmetric (dart fix). Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• OrbitController.OrbitController (dart fix). Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• OrbitController.frameBounds (dart fix). Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• OrbitController.framingFov (dart fix). OrbitController.framingFov is framingFovY. Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• OutputTransform (by hand). An open set since 1.0: a switch over it needs a _ => case. values, name, index and byName are there.
• OverlayBatch.vertex (migrate). color: Vector3(x, y, z) of OverlayBatch.vertex is color: LinearColor(x, y, z). vertex(at, color) takes the linear LinearColor it writes: Vector4(r, g, b, a) is LinearColor(r, g, b, a), the same numbers.
• PackedLane (dart fix). PackedLane is imported from package:flutter3d_core/flutter3d_core.dart.
• PackedMap (dart fix). PackedMap is imported from package:flutter3d_core/flutter3d_core.dart.
• PassSkip (by hand). PassSkip has a new value, switchedOff, for a pass its settings turned off: a switch over a PassSkip that names every value needs a case for it, or a wildcard.
• PerspectiveProjection.PerspectiveProjection (dart fix). Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• PerspectiveProjection.copyWith (dart fix). Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• PerspectiveProjection.fovYRadians (dart fix). PerspectiveProjection.fovYRadians is fovY. Units in names: a field of view is fovY, the vertical angle, in radians (docs/CONTRACTS.md), and time in the simulation is a double of seconds. The value is the same under the new name.
• PhotoFilter (migrate). lift:, gain: of PhotoFilter: Vector3(x, y, z) is LinearColor(x, y, z). lift and gain are LinearColors, as LookSettings' are: Vector3(r, g, b) is LinearColor(r, g, b).
• Photometric (by hand). LightNode.intensity is already lux or candela since 1.0, so fromLux, fromCandela, toLux and toCandela went: write the number. Before 1.0 they converted at 800 lm per engine unit; to keep a scene that used them as it looked, multiply by LightNode.defaultIntensity / Photometric.bulbAtOneMeter (about 91). referenceIlluminance is Photometric.bulbAtOneMeter.
• Photometric.toEngine (by hand). The renderer's own light scale is not API since 1.0: everything takes lux, candela or nits and the renderer converts. To carry a pre-1.0 number over, multiply it by LightNode.defaultIntensity (lights, ambient, the sky's sun) or RenderMaterial.defaultEmissiveStrength (emissive strength).
• PhysicalCamera.luxPerUnit (migrate). PhysicalCamera.luxPerUnit becomes LightNode.defaultIntensity. The renderer's scale is internal; the number it was, about 5 790.6, is LightNode.defaultIntensity.
• PhysicalCamera.nitsPerUnit (migrate). PhysicalCamera.nitsPerUnit becomes RenderMaterial.defaultEmissiveStrength. The renderer's scale is internal; the number it was, 1 843.2, is RenderMaterial.defaultEmissiveStrength, for carrying a pre-1.0 emissive over.
• PlanarReflectorNode.tint (migrate). tint: Vector3(x, y, z) of PlanarReflectorNode.tint is tint: LinearColor(x, y, z). tint is a linear LinearColor, settable now: tint: Vector3(r, g, b) is tint: LinearColor(r, g, b).
• PlayheadStep (migrate). PlayheadStep is a class: .time is .time, .reversing is .reversing, .stopped is .stopped; a destructuring pattern is yours to rewrite. advanceTime answers a PlayheadStep, a class with the record's fields as getters: final PlayheadStep(:time) = ….
• PointerTargets (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• Pose (dart fix). Pose is AnimationPose. The engine's animation pose is AnimationPose, so it no longer shares a name with the simulation's Pose.
• ProbeFace (dart fix). ProbeFace is imported from package:flutter3d_core/flutter3d_core.dart.
• Ray (dart fix). Ray is LocalRay. The geometry library's float32 ray is LocalRay, so it no longer collides with vector_math's Ray. A ray in the world, with a double-precision origin, is the new WorldRay.
• Raycaster (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• ReachGoal (by hand). AnimationGoal has a new case, ReachGoal: a switch over a AnimationGoal that names every case needs one for it, or a wildcard.
• ReactiveFrame (nothing to do). A ReactiveFrame was only ever made by the renderer, which still makes it; the constructor took one of the engine's own uniform blocks.
• ReactiveShape (migrate, with a TODO). ReactiveShape is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ReactiveShape is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is there too.
• RenderMaterial.baseColor (migrate). baseColor: Vector3(x, y, z) of RenderMaterial.baseColor is baseColor: LinearColor.fromSrgb(x, y, z). RenderMaterial.baseColor is a LinearColor, linear, and assigned whole. It was a Vector4 holding the sRGB-encoded colour and changed in place. baseColor: Vector4(r, g, b, a) is baseColor: LinearColor.fromSrgb(r, g, b, a) (the picture does not change); material.baseColor.setValues(...) is material.baseColor = LinearColor.fromSrgb(...); a read of .x that wanted the encoded number is .toSrgb().r, and .w is .a.
• RenderMaterial.emissive (migrate). emissive: Vector3(x, y, z) of RenderMaterial.emissive is emissive: LinearColor(x, y, z). RenderMaterial.emissive is a linear LinearColor, assigned whole: emissive: Vector3(r, g, b) is emissive: LinearColor(r, g, b), and emissive.setValues(r, g, b) is emissive = LinearColor(r, g, b).
• RenderMaterial.emissiveStrength (by hand). emissiveStrength is nits (cd/m²) since 1.0, the luminance an emissive of white shines at; the default is RenderMaterial.defaultEmissiveStrength (1 843.2), which is what the old default of one drew. Multiply a pre-1.0 number by RenderMaterial.defaultEmissiveStrength to keep the glow: emissiveStrength: 4.0 is 4.0 * RenderMaterial.defaultEmissiveStrength. A SurfaceMaterial's strength is a file's plain multiple and is unchanged; loading converts it.
• RenderMaterial.parameters (migrate). parameters: Map(x) of RenderMaterial.parameters is parameters: MaterialParameters.over(Map(x)). A material's parameters are a MaterialParameters, the one shape RenderMaterial, Material3D and LevelMaterial share. parameters: map is parameters: MaterialParameters.over(map), which writes into the map you still hold. Indexing reads and writes as it did: material.parameters['wind'] is the bound floats, and material.parameters['wind'] = values sets them (checked against the material's schema where it has one). A use as a Map reads material.parameters.uniforms, and keys is names.
• RenderNode (by hand). preferredPhase is defaultAnchor: return RenderAnchor.beforePresent where it returned FramePhase.present, RenderAnchor.afterScene for FramePhase.overlay. execute takes a RenderFrame (the renamed NodeFrame).
• RenderNodeRegistry (by hand). Renderer.nodes went with the other four ways into the frame: a pass is added with renderer.renderSteps.addNode, which hands back a Registration; renderSteps.nodesAt(anchor) lists what is where.
• RenderServices (migrate). RenderServices is a base mixin class: implements RenderServices becomes with RenderServices, on a base class.
• RenderServices.encodeScene (migrate). RenderServices.encodeScene takes one SceneEncodeRequest: an override reads its old parameters from it (frame: is .frame, encoder: is .encoder, scene: is .scene, viewProjection: is .viewProjection, cameraPosition: is .cameraPosition, casterIndex: is .casterIndex), and a call builds one. RenderServices.encodeScene takes one SceneEncodeRequest where it took its parameters. The renderer's services are mixed in by a test or a renderer of one's own; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• RenderSettings (migrate). frameWorkBudget: x of RenderSettings is frameWorkBudget: Duration(microseconds: x). The allowance for work that can wait is a Duration: frameWorkBudget: 2000 is frameWorkBudget: Duration(microseconds: 2000), and Duration.zero, the default, is still no limit.
• RenderSettings (by hand). clusteredLights is on by default: a scene with more than eight lights is lit per cell of the view rather than per draw, and draws a different frame. Pass clusteredLights: false where the old picture is wanted. The physical camera is the default exposure model too (camera, physicalCamera), and its default camera draws exactly the old exposure, so physicalCamera: false is needed only where a camera is set and the multiplier alone is wanted.
• RenderSettings.copyWith (by hand). settings.copyWith(disabledPasses: {...}) is settings.without({...}) over the steps that own those passes; see f2-core-RenderSettings-disabledPasses for the names.
• RenderSettings.disabledPasses (by hand). RenderSettings(disabledPasses: {...}) is RenderSettings(...).without({...}) over the steps that own those passes: bloom is RenderStep.bloom, lens flare RenderStep.lensFlare, ssao and ssao blur RenderStep.ambientOcclusion, contact shadows RenderStep.contactShadows, reflections RenderStep.reflections, light shafts RenderStep.lightShafts, volumetric fog RenderStep.volumetricFog, depth of field RenderStep.depthOfField, motion blur RenderStep.motionBlur, luminance RenderStep.autoExposure, local exposure RenderStep.localExposure, spatial upscale RenderStep.spatialUpscale, antialias RenderStep.edgeSmoothing and RenderStep.sharpening, decals RenderStep.decals, depth pyramid RenderStep.hiZOcclusion, viewport shading RenderStep.viewportShading, the shadow passes RenderStep.shadows; RenderStep.ownsPass answers for any other name. A pass of your own is switched off by the RenderStep it was added with (renderSteps.addNode(node, step: myStep)). A skipped pass is reported as PassSkip.switchedOff rather than PassSkip.disabled. The transparent half and the scene colour copy have no step: they run when the scene holds glass.
• RenderSettings.needsSurfaceBuffer (by hand). A setting cannot see the frame, so needsSurfaceBuffer only ever modelled the built-in passes. Ask the compiled frame instead: compiled.isConsumed(FrameResourceIds.surfaceBuffer) on the CompiledFrameGraph the renderer built.
• RenderSettings.pixelAlteringPasses (dart fix). RenderSettings.pixelAlteringPasses is pixelAlteringSteps. The set forMeasurement switches off is a Set<RenderStep> now, handed to without: settings.without(RenderSettings.pixelAlteringSteps). A caller that read the pass names reads each step's passes.
• RenderSettings.undisablePasses (by hand). The names disabledPasses refused, scene, composite and object ids, are not steps, so no without can switch them off and there is nothing to subtract.
• RenderStep (migrate). isOn: x of RenderStep is isOn: (context) => (x)(context.settings). A step's own isOn is handed one RenderStepContext, where it took the settings: (settings) => ... is (context) => ... reading context.settings, and may read the frame's views, device and quality too. migrate wraps the old function, (context) => (old)(context.settings), which runs as it did.
• RenderStep (migrate). switchOff: x of RenderStep is switchOff: (context) => (x)(context.settings). A step's own switchOff is handed one RenderStepContext, where it took the settings, and still returns the settings with the step off: (settings) => ... is (context) => ... reading context.settings. migrate wraps the old function, (context) => (old)(context.settings), which runs as it did.
• RenderStep.isOn (migrate). RenderStep.isOn takes one RenderStepContext: an override reads its old parameters from it (parameter 1 is .settings), and a call builds one. RenderStep.isOn takes one RenderStepContext where it took the settings. A step's switch could only read the settings it was asked about; the context also carries the frame's views, its device and the quality setting it is drawn at, and can gain members in a minor release. migrate builds the context at a call, step.isOn(RenderStepContext(settings: s)).
• RenderView.RenderView (nothing to do). clearColor: keeps its name and takes what the field holds, a LinearColor (see core-RenderView-clearColor); the analyzer names every call that still passes a Vector4, and LinearColor.fromSrgb(r, g, b, a) is what it passes instead. RenderView.texture takes it the same way.
• RenderView.clearColor (migrate). clearColor: Vector3(x, y, z) of RenderView.clearColor is clearColor: LinearColor.fromSrgb(x, y, z). The clear colour is a LinearColor, linear like every other colour, and assigned whole. It was an sRGB-encoded Vector4: clearColor: Vector4(r, g, b, a) is clearColor: LinearColor.fromSrgb(r, g, b, a) and draws the same picture, and view.clearColor.setValues(r, g, b, a) is view.clearColor = LinearColor.fromSrgb(r, g, b, a).
• Renderer (by hand). The renderer's own stages and test hooks are not its API since 1.0, so a shader change is not a major release. A stage is looked up by name, renderer.shaders['DebugLineVertex']!; the debug* hooks are for the engine's own tests, through package:flutter3d_core/src/engine/render/renderer.dart.
• Renderer (by hand). One way into the frame since 1.0, renderer.renderSteps: addContributor, removeContributor and contributors moved there unchanged; addNode(node, phase: ...) is renderSteps.addNode(node, at: anchor) (FramePhase.overlay is RenderAnchor.afterScene, FramePhase.present is RenderAnchor.beforePresent, no at uses the node's defaultAnchor), and it hands back a Registration whose cancel is what removeNode was.
• Renderer.addMaterials (migrate). Renderer.addMaterials becomes x.renderSteps.addMaterials({0}). One way to add a bundle of materials: renderer.renderSteps.addMaterials, which a plugin already used. It returns the Registration that takes the library out again.
• Renderer.kShadowedLights (dart fix). Renderer.kShadowedLights is shadowedLights. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• Renderer.removeMaterials (by hand). Keep the Registration that renderer.renderSteps.addMaterials(library) returned and cancel() it; that takes the library out, as this did.
• Renderer.shadowedLights (nothing to do). A static getter now, with the same value (6), so a later minor can change the shadow atlas without a constant compiled into callers.
• ResourceDesc.resolve (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• ResourceOrigin (migrate, with a TODO). ResourceOrigin is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ResourceOrigin is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• ResourceSize (migrate, with a TODO). ResourceSize is a class: a switch over it that names every value gains _ => throw UnimplementedError(). ResourceSize is an abstract base class with a visitor rather than a sealed class, so a size a later minor adds breaks no switch: a switch over FrameFraction and AbsolutePixels ends with a wildcard, or reads them through accept and a ResourceSizeVisitor, whose visitUnknown answers for a kind it predates. resolve is unchanged.
• Scene (by hand). A node joins its scene's lists when it is added (Scene.add); the register* calls are the nodes' own since 1.0. ambientColor is a LinearColor: scene.ambientColor = const LinearColor(r, g, b), or vector.toLinearColor(). addRenderTexture is addTextureView, renderTextures is textureViews.
• Scene.ambientIntensity (by hand). Scene.ambientIntensity is lux since 1.0, about 347 by default (the 0.06 it was). Multiply a pre-1.0 number by LightNode.defaultIntensity: scene.ambientIntensity = 0.3 is scene.ambientIntensity = 0.3 * LightNode.defaultIntensity.
• SceneBvh (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• SceneNode (by hand). The scene graph's change counter is the engine's own since 1.0; a world position is node.worldPosition (double precision) and setWorldPosition.
• SceneNode.ownBoundsAreCullable (dart fix). SceneNode.ownBoundsAreCullable is hasCullableOwnBounds. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SceneNode.subtreeAlwaysDrawn (dart fix). SceneNode.subtreeAlwaysDrawn is isSubtreeAlwaysDrawn. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SceneNode.visible (dart fix). SceneNode.visible is isVisible. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SceneNode.visibleInHierarchy (dart fix). SceneNode.visibleInHierarchy is isVisibleInHierarchy. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• SceneShadows (dart fix). SceneShadows is imported from package:flutter3d_core/flutter3d_core.dart.
• ShadowAssignment (dart fix). ShadowAssignment is imported from package:flutter3d_core/flutter3d_core.dart.
• ShadowCandidate (dart fix). ShadowCandidate is imported from package:flutter3d_core/flutter3d_core.dart.
• ShadowCastingMode (migrate, with a TODO). ShadowCastingMode is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a mode a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name, casts, drawsColor and castsFromEveryFace are there; index is not.
• ShadowCastingMode.drawsColour (dart fix). ShadowCastingMode.drawsColour is drawsColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• ShadowFaceScheduler (dart fix). ShadowFaceScheduler is imported from package:flutter3d_core/flutter3d_core.dart.
• ShadowFaceScheduler.recordDrawn (migrate). ShadowFaceScheduler.recordDrawn(x0) is ShadowFaceScheduler.recordDrawn(only: x0). The faces drawn this frame are a named argument: recordDrawn(faces) is recordDrawn(only: faces).
• ShadowSettings (nothing to do). maxResolution and maxCubeTile are static getters with the values they had (4096, 1024), so a later release can raise them. Every read compiles; only a const expression that used one does not, and it takes the number or a non-const value.
• ShadowSettings.sunAngularRadius (nothing to do). Only the value of the constant moved, to the sun's radius of 0.2666° to three figures; it is also SkySettings.sunAngularRadius's default now. Code that reads it gets the new one.
• ShadowSlotAllocator (dart fix). ShadowSlotAllocator is imported from package:flutter3d_core/flutter3d_core.dart.
• Skeleton (nothing to do). maxJoints is a static getter with the value it had (64), so a later release can raise it. Every read compiles; only a const expression that used it does not, and it takes the number or a non-const value.
• SkippedPass (migrate). SkippedPass is a class: .name is .name, .reason is .reason; a destructuring pattern is yours to rewrite. SkippedPass is a final class with the same name and reason, equal by both as the record was; one is built with SkippedPass(name: …, reason: …). Only a destructuring pattern names the class.
• SkyColor (by hand). A SkyColor returns a linear LinearColor rather than a Vector4: (look) => Vector4(r, g, b, 1) is (look) => LinearColor(r, g, b).
• SkyColour (dart fix). SkyColour is SkyColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SkyGradient (migrate). zenith:, horizon:, nadir:, sunColor:, color: of SkyGradient: Vector3(x, y, z) is LinearColor(x, y, z). SkyGradient's stops and sunColor are linear LinearColors, and the SkyColor it hands out returns a LinearColor.
• SkyGradient.SkyGradient (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SkyGradient.colour (dart fix). SkyGradient.colour is color. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SkyGradient.sunColour (dart fix). SkyGradient.sunColour is sunColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SkySettings (migrate). zenith:, horizon:, nadir:, sunColor:, tint: of SkySettings: Vector3(x, y, z) is LinearColor(x, y, z). The sky's colours are LinearColors: zenith, horizon, nadir, sunColor and tint, in the constructor, in copyWith and from the resolved* getters. The numbers mean what they did (linear, scene-referred), so Vector3(0.1, 0.2, 0.5) becomes LinearColor(0.1, 0.2, 0.5), or vector.toLinearColor(); read .r, .g, .b where you read .x, .y, .z. directionToSun stays a Vector3, and sample still answers one.
• SkySettings.sunIntensity (by hand). The disc's sunIntensity is lux since 1.0, as a directional light is: multiply a pre-1.0 number by LightNode.defaultIntensity. Zero is still no disc.
• SolidColorTexture (migrate). color: Vector3(x, y, z) of SolidColorTexture is color: LinearColor.fromSrgb(x, y, z). SolidColorTexture(color) takes a linear LinearColor and stores it sRGB-encoded, as a base-colour texture's texels are. The Vector4 it took was the encoded texel, so the same bytes are SolidColorTexture(LinearColor.fromSrgb(r, g, b, a)), or SolidColorTexture.texel(r, g, b, a: a) for a texture of data rather than colour (a normal map's). color is texel, the stored values; white and flatNormal are constants.
• SortMode (migrate, with a TODO). SortMode is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a sort a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values and name are there; index is not.
• SplatCloud.SplatCloud (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SplatCloud.centres (dart fix). SplatCloud.centres is centers. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SplatCloud.colours (dart fix). SplatCloud.colours is colors. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SplatColourSpace (dart fix). SplatColourSpace is SplatColorSpace. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• SplatComposite (migrate, with a TODO). SplatComposite is a class: a switch over it that names every value gains _ => throw UnimplementedError(). SplatComposite is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• SplatOctreeException (nothing to do). SplatOctreeException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on SplatOctreeException and on Exception still catches it, and nothing outside the package could extend it.
• SplatPlyException (nothing to do). SplatPlyException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on SplatPlyException and on Exception still catches it, and nothing outside the package could extend it.
• SplatSpzException (nothing to do). SplatSpzException is still a final class with the same members; it now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly. Every on SplatSpzException and on Exception still catches it, and nothing outside the package could extend it.
• StlLoader.decode (migrate). StlLoader.decode takes one ModelDecodeContext: an override reads its old parameters from it (parameter 1 is .bytes, parameter 2 is .request, parameter 3 is .resolveUri), and a call builds one. StlLoader.decode takes one ModelDecodeContext where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• StlLoader.handles (migrate). StlLoader.handles takes one ModelProbe: an override reads its old parameters from it (parameter 1 is .fileName, parameter 2 is .bytes), and a call builds one. StlLoader.handles takes one ModelProbe where it took its parameters. A model decoder is the plugin boundary for reading; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• StlModelWriter.write (migrate). StlModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. StlModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• StlNormals (migrate, with a TODO). StlNormals is a class: a switch over it that names every value gains _ => throw UnimplementedError(). StlNormals is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• SurfaceAlphaMode (migrate, with a TODO). SurfaceAlphaMode is a class: a switch over it that names every value gains _ => throw UnimplementedError(). SurfaceAlphaMode is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• SurfaceMaterial (migrate). baseColor: Vector3(x, y, z) of SurfaceMaterial is baseColor: LinearColor.fromSrgb(x, y, z). SurfaceMaterial.baseColor and emissive are linear LinearColors. baseColor held the authored sRGB-encoded tint as a Vector4; it is LinearColor.fromSrgb(r, g, b, a) of the same numbers. Files keep what they stored: each reader and writer converts.
• SurfaceMaterial.emissive (migrate). emissive: Vector3(x, y, z) of SurfaceMaterial.emissive is emissive: LinearColor(x, y, z). emissive is a linear LinearColor: Vector3(r, g, b) is LinearColor(r, g, b), the same numbers.
• TangentMethod (migrate, with a TODO). TangentMethod is a class: a switch over it that names every value gains _ => throw UnimplementedError(). An open set since 1.0, so a method a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values and name are there; index is not.
• TemporalClip (migrate, with a TODO). TemporalClip is a class: a switch over it that names every value gains _ => throw UnimplementedError(). TemporalClip is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is there too.
• TextureSampling.TextureSampling (nothing to do). Only the wrap's type was renamed, TextureWrap to SamplerAddressMode; that rename's own fix carries every use.
• TextureSampling.wrapS (nothing to do). Only the wrap's type was renamed; that rename's own fix carries every use.
• TextureSampling.wrapT (nothing to do). Only the wrap's type was renamed; that rename's own fix carries every use.
• TextureWrap (dart fix). TextureWrap is imported from package:flutter3d_hardware/flutter3d_hardware.dart. One type says how a texture wraps: TextureWrap is SamplerAddressMode, the type a SamplerDescriptor already took, so TextureSampling.wrapS and wrapT hand a sampler their value as it is. repeat and clampToEdge keep their names; mirroredRepeat is mirror. Files keep their own words for it. package:flutter3d exports it; a file that imported only package:flutter3d_core/formats.dart imports package:flutter3d_hardware/flutter3d_hardware.dart for it.
• TextureWrap (migrate, with a TODO). TextureWrap is a class: a switch over it that names every value gains _ => throw UnimplementedError(). TextureWrap is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• TextureWrap.mirroredRepeat (dart fix). TextureWrap.mirroredRepeat is mirror. TextureWrap.mirroredRepeat is SamplerAddressMode.mirror, the same wrap.
• ThinLens (migrate). ThinLens is a class: .focalLength is .focalLength, .sensorWidth is .sensorWidth; a destructuring pattern is yours to rewrite. DepthOfFieldSettings.lensFor answers a ThinLens, a class, where it answered a record: final ThinLens(:focalLength) = … where the pattern was final (:focalLength, :sensorWidth) = ….
• TonemapCurve.agxFull (dart fix). TonemapCurve.agxFull is agx. TonemapCurve.agx is the full AgX transform since 0.7.4; agxFull is the same curve under its old name.
• TonemapCurve.values (nothing to do). The list no longer holds agxFull, which is gone; it drew the same picture as agx. Code that walks the list sees five curves where it saw six.
• TransparencyMode (by hand). An open set since 1.0: a switch over it needs a _ => case. values, name, index and byName are there.
• TriangleBvh (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• TriangleHit (migrate). TriangleHit is a class: .triangle is .triangle, .distance is .distance, .point is .point; a destructuring pattern is yours to rewrite. TriangleBvh.raycast answers a TriangleHit, a class with the record's fields as getters; a destructuring pattern names the class.
• TriggerCondition (by hand). AnimationCondition has a new case, TriggerCondition: a switch over a AnimationCondition that names every case needs one for it, or a wildcard.
• TwoBoneIk (nothing to do). Only the animation pose in its signature changed: Pose is AnimationPose (core-Pose-AnimationPose renames it).
• UniversalBlockFormat (migrate). UniversalBlockFormat is a class: .hasAlpha is .hasAlpha; a destructuring pattern is yours to rewrite. universalBlockFormat answers a UniversalBlockFormat, a class with the record's field as a getter.
• UsdzModelWriter.write (migrate). UsdzModelWriter.write takes one ModelWriteContext: an override reads its old parameters from it (parameter 1 is .document, baseName: is .baseName), and a call builds one. UsdzModelWriter.write takes one ModelWriteContext where it took its parameters. A model writer is a hook a format implements; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• VertexFetchOrder (migrate). VertexFetchOrder is a class: .indices is .indices, .oldToNew is .oldToNew; a destructuring pattern is yours to rewrite. optimizeVertexFetch answers a VertexFetchOrder, a class with the record's fields as getters; a destructuring pattern names the class.
• ViewModelNode (nothing to do). Only the frame type in its signature changed: NodeFrame is RenderFrame (core-NodeFrame-RenderFrame renames it).
• VolumetricFogSettings (migrate). color:, ambient: of VolumetricFogSettings: Vector3(x, y, z) is LinearColor(x, y, z). color and ambient are linear LinearColors; see f2-core-settings-colours.
• XraySettings (migrate). color: Vector3(x, y, z) of XraySettings is color: LinearColor(x, y, z). color is a linear LinearColor; see f2-core-settings-colours.
• advanceTime (nothing to do). Answers a PlayheadStep whose getters are the record's fields, time, reversing and stopped, so a read of one is unchanged; a destructuring pattern names the class (2b-core-PlayheadStep).
• animationTrackKey (dart fix). animationTrackKey is imported from package:flutter3d_core/flutter3d_core.dart.
• averageCacheMissRatio (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• broadcastArguments (nothing to do). Only a type it names was renamed (a name Flutter or Dart also declares); the type's rename carries its own fix, and a call needs none.
• buildPolyline (by hand). colors: is a List<LinearColor> and color: a LinearColor, linear as every vertex colour is: Vector4(r, g, b, a) is LinearColor(r, g, b, a).
• buildPolyline (dart fix). Public names are spelled the American way and say what they hold: colours: is colors:, colour: is color:, the same values.
• chooseUniversalTarget (dart fix). chooseUniversalTarget is imported from package:flutter3d_core/flutter3d_core.dart.
• clusterEye (dart fix). clusterEye is imported from package:flutter3d_core/flutter3d_core.dart.
• decodeImagePure (by hand). decodeImagePure completes with an Rgba8Image or fails with an ImageFormatException; it no longer completes with null. Drop the ! and the null check, and catch the exception where an unreadable image is expected.
• decodeJpeg (by hand). decodeJpeg returns a DecodedImage and throws an ImageFormatException instead of returning null; decodePng(b) ?? decodeJpeg(b) becomes isPng(b) ? decodePng(b) : decodeJpeg(b) inside a try.
• decodeOctahedral (dart fix). decodeOctahedral is imported from package:flutter3d_core/flutter3d_core.dart.
• decodePng (by hand). decodePng returns a DecodedImage and throws an ImageFormatException saying why instead of returning null. Replace if (decoded == null) with a try/on ImageFormatException, or ask isPng(bytes) first when only the signature matters.
• encodeOctahedral (dart fix). encodeOctahedral is imported from package:flutter3d_core/flutter3d_core.dart.
• ensureSphereCapacity (dart fix). ensureSphereCapacity is imported from package:flutter3d_core/flutter3d_core.dart.
• escapesAssetBase (dart fix). escapesAssetBase is imported from package:flutter3d_core/flutter3d_core.dart.
• gather (migrate). sky: Vector3(x, y, z) of gather is sky: LinearColor(x, y, z). gather(..., sky:) and gatherProbe(..., sky:) take a linear LinearColor, black by default: sky: Vector3(r, g, b) is sky: LinearColor(r, g, b).
• gatherProbe (migrate). sky: Vector3(x, y, z) of gatherProbe is sky: LinearColor(x, y, z). sky: is a linear LinearColor; see f2-core-gather-sky.
• gatherProbe (dart fix). gatherProbe is imported from package:flutter3d_core/flutter3d_core.dart.
• impostorCard (dart fix). American spelling in identifiers: impostorCard(centre:) is impostorCard(center:), the same point.
• impostorDecode (dart fix). impostorDecode is imported from package:flutter3d_core/flutter3d_core.dart.
• impostorEncode (dart fix). impostorEncode is imported from package:flutter3d_core/flutter3d_core.dart.
• jitterOffset (dart fix). jitterOffset is imported from package:flutter3d_core/flutter3d_core.dart.
• kDefaultVertexCacheSize (dart fix). kDefaultVertexCacheSize is defaultVertexCacheSize. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kF3dHeaderBytes (dart fix). kF3dHeaderBytes is f3dHeaderBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kF3dMagic (dart fix). kF3dMagic is f3dMagic. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kF3dSectionEntryBytes (dart fix). kF3dSectionEntryBytes is f3dSectionEntryBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kF3dVersion (dart fix). kF3dVersion is f3dVersion. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix.
• kFmatVersion (dart fix). kFmatVersion is fmatVersion. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kImpostorGrid (dart fix). kImpostorGrid is impostorGrid. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kIrradianceReach (dart fix). kIrradianceReach is imported from package:flutter3d_core/flutter3d_core.dart.
• kKtx2HeaderBytes (dart fix). kKtx2HeaderBytes is ktx2HeaderBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2HeaderOffset (dart fix). kKtx2HeaderOffset is ktx2HeaderOffset. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2Identifier (dart fix). kKtx2Identifier is ktx2Identifier. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2IndexBytes (dart fix). kKtx2IndexBytes is ktx2IndexBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2IndexOffset (dart fix). kKtx2IndexOffset is ktx2IndexOffset. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2LevelIndexEntryBytes (dart fix). kKtx2LevelIndexEntryBytes is ktx2LevelIndexEntryBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kKtx2LevelIndexOffset (dart fix). kKtx2LevelIndexOffset is ktx2LevelIndexOffset. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kMaterialInputs (dart fix). kMaterialInputs is materialInputs. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kMaterialTextureBindings (dart fix). kMaterialTextureBindings is materialTextureBindings. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kMaxPayload (dart fix). kMaxPayload is imported from package:flutter3d_core/flutter3d_core.dart.
• kNeutralColor (dart fix). kNeutralColor is imported from package:flutter3d_core/flutter3d_core.dart.
• kNeutralJoints (dart fix). kNeutralJoints is imported from package:flutter3d_core/flutter3d_core.dart.
• kNeutralTangent (dart fix). kNeutralTangent is imported from package:flutter3d_core/flutter3d_core.dart.
• kNeutralWeights (dart fix). kNeutralWeights is imported from package:flutter3d_core/flutter3d_core.dart.
• kNoHit (dart fix). kNoHit is imported from package:flutter3d_core/flutter3d_core.dart.
• kPayloadBits (dart fix). kPayloadBits is payloadBits. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kPayloadMask (dart fix). kPayloadMask is imported from package:flutter3d_core/flutter3d_core.dart.
• kRadixThreshold (dart fix). kRadixThreshold is imported from package:flutter3d_core/flutter3d_core.dart.
• kRootMotionExtra (dart fix). kRootMotionExtra is rootMotionExtra. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSortKeyBits (dart fix). kSortKeyBits is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatFloatsPerVertex (dart fix). kSplatFloatsPerVertex is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatKeyMax (dart fix). kSplatKeyMax is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatLeanLimit (dart fix). kSplatLeanLimit is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatLowPass (dart fix). kSplatLowPass is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatOctreeExtension (dart fix). kSplatOctreeExtension is splatOctreeExtension. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatOctreeHeaderBytes (dart fix). kSplatOctreeHeaderBytes is splatOctreeHeaderBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatOctreeNodeBytes (dart fix). kSplatOctreeNodeBytes is splatOctreeNodeBytes. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatOctreeVersion (dart fix). kSplatOctreeVersion is splatOctreeVersion. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatPageBytesPerSplat (dart fix). kSplatPageBytesPerSplat is splatPageBytesPerSplat. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatReach (dart fix). kSplatReach is imported from package:flutter3d_core/flutter3d_core.dart.
• kSplatShC0 (dart fix). kSplatShC0 is splatShC0. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSplatVerticesPerSplat (dart fix). kSplatVerticesPerSplat is splatVerticesPerSplat. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kSpzLatestVersion (dart fix). kSpzLatestVersion is spzLatestVersion. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kUniversalBlockKey (dart fix). kUniversalBlockKey is universalBlockKey. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kUniversalBlockRgb (dart fix). kUniversalBlockRgb is universalBlockRgb. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kUniversalBlockRgba (dart fix). kUniversalBlockRgba is universalBlockRgba. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• linearFromSrgb (migrate). linearFromSrgb(…) becomes LinearColor.fromSrgb(…).toVector4(). linearFromSrgb(r, g, b, a) is LinearColor.fromSrgb(r, g, b, a), the same decoded numbers in the engine's one colour type, which every vertex-colour call now takes; .toVector4() of it is the vector the function returned, for code of your own that keeps one.
• lookAtRightHanded (dart fix). lookAtRightHanded is imported from package:flutter3d_core/flutter3d_core.dart.
• mergeSplats (dart fix). Public names are spelled the American way and say what they hold: centre: is center:, the same values.
• neutralColor (by hand). neutralColor is LinearColor.white, a constant, where it was a shared Vector4; Vector4.copy(neutralColor) is neutralColor.
• optimizeTriangleOrder (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• optimizeVertexCache (nothing to do). Only the constant its cacheSize defaults to is renamed (kDefaultVertexCacheSize to defaultVertexCacheSize, an entry of its own), with the same value, so every call compiles and behaves as before. optimizeVertexCache is exported by flutter3d again, as at 0.8.5.
• optimizeVertexFetch (nothing to do). Answers a VertexFetchOrder whose getters are the record's fields, indices and oldToNew, so a read of one is unchanged; a destructuring pattern names the class (2b-core-VertexFetchOrder).
• packLanes (dart fix). packLanes is imported from package:flutter3d_core/flutter3d_core.dart.
• packSceneSpheres (dart fix). packSceneSpheres is imported from package:flutter3d_core/flutter3d_core.dart.
• package:flutter3d_hardware/flutter3d_hardware.dart (dart fix). Names re-exported from package:flutter3d_hardware/flutter3d_hardware.dart are imported from package:flutter3d_hardware/flutter3d_hardware.dart. package:flutter3d_core/flutter3d_core.dart no longer re-exports the graphics vocabulary. A file that names GraphicsDevice, TextureFormat or a descriptor imports package:flutter3d_hardware/flutter3d_hardware.dart, and the project depends on flutter3d_hardware. package:flutter3d/flutter3d.dart still names what an application spells of it.
• paintSky (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• parseSplatPly (dart fix). Public names are spelled the American way and say what they hold: colourSpace: is colorSpace:, the same values.
• parseSplatSpz (dart fix). Public names are spelled the American way and say what they hold: colourSpace: is colorSpace:, the same values.
• probeFaceIsMirrored (dart fix). probeFaceIsMirrored is imported from package:flutter3d_core/flutter3d_core.dart.
• probeFaceViewProjection (dart fix). probeFaceViewProjection is imported from package:flutter3d_core/flutter3d_core.dart.
• radixSortPackedKeys (dart fix). radixSortPackedKeys is imported from package:flutter3d_core/flutter3d_core.dart.
• rayAabb (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• raySphere (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• rayTriangle (nothing to do). Only the float32 ray in its signature changed: Ray is LocalRay (core-Ray-LocalRay renames it).
• readFmat (by hand). The readers in flutter3d_core throw their own leaf of Flutter3dFormatException instead of dart:core's FormatException: GltfFormatException (glTF/GLB, GlbContainer, decodeDataUri), FmatFormatException (readFmat), CubeLutFormatException (CubeLut.parse), MeshoptFormatException, FbxFormatException, MaterialBundleException and AnimationGraphFormatException (AnimationGraphJson.decode). An on FormatException around one of them no longer catches: catch the leaf, or Flutter3dFormatException for all of them.
• samplerOptionsFor (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• selectVisibleClusters (dart fix). selectVisibleClusters is imported from package:flutter3d_core/flutter3d_core.dart.
• sortSplatKeys (dart fix). sortSplatKeys is imported from package:flutter3d_core/flutter3d_core.dart.
• specialiseMaterial (dart fix). specialiseMaterial is specializeMaterial. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• splatColour (dart fix). splatColour is splatColor. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• universalBlockFormat (nothing to do). Answers a UniversalBlockFormat whose hasAlpha is the record's one field, so a read of it is unchanged; a destructuring pattern names the class (2b-core-UniversalBlockFormat).
• uploadCoatMap (dart fix). uploadCoatMap is imported from package:flutter3d_core/flutter3d_core.dart.
• uploadEncodedImage (migrate, with a TODO). uploadEncodedImage throws Flutter3dException where it returned null: a null check beside a call becomes try … on Flutter3dException. It throws where it answered null, saying why: an ImageFormatException for bytes it cannot read, a Ktx2FormatException for a KTX2 file this build cannot open, a DeviceResourceException for a texture the device refuses. Catch Flutter3dException where a missing texture was fine.
• uploadRgba8 (migrate, with a TODO). uploadRgba8 throws DeviceResourceException where it returned null: a null check beside a call becomes try … on DeviceResourceException. It throws the device's DeviceResourceException where it answered null for a texture the device refused.
• uploadSheenMap (dart fix). uploadSheenMap is imported from package:flutter3d_core/flutter3d_core.dart.

flutter3d_cpu #

• 167 names were the package's own (gone internal): they are not exported since 1.0.0-rc.1, and the import of flutter3d_cpu that brought them gets one diagnostic for all of them. BlinnPhongShader, BloomDownsampleShader, BloomThresholdShader, BloomUpsampleShader, CameraVelocityShader, CompositeShader, ContactShadowResolveShader, ContactShadowShader, CpuPipeline, DebugLineShader, DebugLineVertexShader, DepthOfFieldShader, DepthPyramidShader, DofTileMaxShader, EasuShader, FieldDecayShader, FullscreenVertexShader, FxaaShader, IrradianceConvolveShader, LambertShader, LayoutFetch, LightSample, LightShaftsShader, LocalExposureBlurShader, LocalExposureShader, LuminanceShader, MeshInstancedVertexShader, MeshLightmappedVertexShader, MeshSkinnedVertexShader, MeshVertexShader, MotionBlurShader, MrtProbeShader, NormalsShader, ObjectIdShader, PackedFetch, ParticleMeshShader, ParticleMeshVertexShader, ParticleShader, ParticleSixWayShader, ParticleTexturedShader, ParticleVertexShader, PbrShader, ProbePrefilterShader, ReactiveShader, ReactiveSpriteShader, ReflectionsShader, SceneColourCopyShader, ShadowCopyShader, ShadowDepthMaskedShader, ShadowDepthShader, ShadowDistanceMaskedShader, ShadowDistanceShader, ShadowTileResetShader, ShadowTileResetVertexShader, SkyCubeShader, SkyCubeVertexShader, SkyShader, SkyVertexShader, SplatHashedShader, SplatShader, SsaoBlurShader, SsaoShader, Surface, TemporalAccumulateShader, TemporalResolveShader, ToonShader, UvFootprint, VelocityInstancedVertexShader, VelocityNeighborMaxShader, VelocityShader, VelocitySkinnedVertexShader, VelocityTileMaxShader, VelocityVertexShader, VertexTextureProbeShader, VertexTextureProbeVertexShader, ViewportShadeShader, VolumetricFogShader, VolumetricFogUpsampleShader, WboitResolveShader, XrayShader, accumulateLights, agxSigmoid, applyCommonMaps, applyEmissiveMap, applyFog, applyMetallicRoughnessMap, applyNormalMap, applyOcclusionMap, atlasDistance, attenuation, bayerCell, bloomSource, blueNoise, clusterAt, clusterRow, clustered, contributorLight, contributorLightCount, decodeOctahedral, diskTaps, encodeOctahedral, eyeDistance, fract, inSlots, irradianceEnabled, kColour, kExtraLights, kMapBaseColor, kMapEmissive, kMapMetallicRoughness, kMapNormal, kMapOcclusion, kMaxLights, kNormal, kPosition, kTangent, kTexcoord, kUnimplementedCpuFragmentShaders, kUnimplementedCpuVertexShaders, kVColour, kVLightmap, kVNormal, kVTangent, kVUv, kVWorld, lightCount, lightListLane, lightListRow, lightListScale, lightListTexel, mapUv, materialLodBias, pixelNoise, pixelRay, pointShadowFactor, premultiplies, probeFaceDirection, readSurface, rectangleClosestPoint, rectangleFormFactor, sampleIrradiance, sampleLight, sampleLightmap, shadowFactor, shadowNoise, shadowSlots, smoothstep, softParticleFade, splatNoiseOffset, ssaoKernel, toLinear, toSrgb, tonemapAces, tonemapAces2, tonemapAgx, tonemapAgxFull, tonemapBy, tonemapNeutral, tonemapReinhard, uvFootprint, viewDepth, vogelDisc, weightedBlendedWeight, worldAtDepth, writeLit, writeSurface, writeWeightedBlended. A stage of your own is written with the kit that stays — CpuStage, CpuFragmentShader, CpuVertexShader, ShaderBindings, FragmentContext — and a test that wanted an unlit stand-in uses cpuUnlitStage from package:flutter3d_cpu/testing.dart. A package that compiles onto the engine's stages imports them from package:flutter3d_cpu/builtin.dart, which semver does not cover. The engine's decodeOctahedral, from flutter3d_core. The engine's encodeOctahedral, from flutter3d_core.
• BoundTexture.sampler (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• CpuComputeShader (by hand). An abstract base class since 1.0: write extends CpuComputeShader where you wrote implements CpuComputeShader, mark the class final, base or sealed, and give a const constructor a super() it now has.
• CpuDevice (by hand). What CpuDevice inherits from GraphicsDevice changed: the texture creators answer a non-null handle and throw DeviceResourceException or UnsupportedCapabilityException where they answered null, readPixels is readback, and the deprecated supportsX, maxAnisotropy and maxColorAttachments are features.has(...) and limits. The entries for GraphicsDevice say each.
• CpuDevice.createPipeline (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• CpuDevice.createStorageBuffer (migrate). CpuDevice.createStorageBuffer becomes x.createBuffer(BufferDescriptor(lengthInBytes: {0}.lengthInBytes, usage: BufferUsage.standardStorage), contents: {0}). One call makes every buffer: a storage buffer is createBuffer with BufferUsage.standardStorage and the bytes as contents, plus BufferUsage.hostReadable or BufferUsage.index where you asked for them by name.
• CpuDevice.createTexture (nothing to do). Only a type or a positional parameter it names was renamed; no call names a positional parameter, and a type's rename carries its own fix.
• CpuDevice.readPixels (dart fix). CpuDevice.readPixels is readback.
• CpuEncoder (by hand). A CpuEncoder is made by CpuDevice.beginRenderPass, which hands it the device's features, format support and timestamp clock. Code that constructed one directly opens the pass on a CpuDevice instead.
• CpuFragmentShader (by hand). An abstract base class since 1.0: write extends CpuFragmentShader where you wrote implements CpuFragmentShader, mark the class final, base or sealed, and give a const constructor a super() it now has.
• CpuVertexShader (by hand). An abstract base class since 1.0: write extends CpuVertexShader where you wrote implements CpuVertexShader, mark the class final, base or sealed, and give a const constructor a super() it now has.
• CpuVertexShaderByIndex (by hand). An abstract base class since 1.0: write extends CpuVertexShaderByIndex where you wrote implements CpuVertexShaderByIndex, mark the class final, base or sealed, and give a const constructor a super() it now has.
• DepthOfFieldShader.circleOfConfusion (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• UnlitShader (by hand). was the software rasteriser's own: one of the engine's shader stages in Dart, a helper they share, or the encoder. It is not exported since 1.0, so a change to the engine's shaders is not a major release. A stage of your own is written with the kit that stays — CpuStage, CpuFragmentShader, CpuVertexShader, ShaderBindings, FragmentContext — and a test that wanted an unlit stand-in uses cpuUnlitStage from package:flutter3d_cpu/testing.dart.
• VertexFetch (by hand). VertexFetch is closed: its two kinds are LayoutFetch and PackedFetch. Reading vertices through one is unchanged; a fetch of your own builds a LayoutFetch over its buffer layout instead.
• ensureCpuBackendRegistered (by hand). There is no process-wide registry since 1.0: registerCpuBackend(registry, materialCompiler: ...) adds the software rasteriser to an engine's own DeviceRegistry, as its fallback. flutter3d_app's platformDevices() does it for this platform.
• kMeshVaryings (nothing to do). Only the value of the constant moved; code that reads kMeshVaryings gets the new one. It is a version or a layout size the engine stamps and checks itself.

flutter3d_editor_core #

• AddLevelLight (nothing to do). Not a new case of EditorCommand: it is AddLight under its new name.
• AddLight (dart fix). AddLight is AddLevelLight. The editor's command is AddLevelLight; AddLight is the modeller's, in flutter3d_model_core. Its journal name is still addLight, so a journal written before reads the same.
• ApplyOverrides (by hand). EditorCommand has a new case, ApplyOverrides, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• CreatePrefab (by hand). EditorCommand has a new case, CreatePrefab, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• DocumentText.compact (migrate). DocumentText.compact(x0, x1) is DocumentText.compact(x0, depth: x1). The indentation depth is a named argument: compact(value, 2) is compact(value, depth: 2).
• Editing (nothing to do). kind and selected became a getter and setter pair over the selection; reading and assigning them read the same. Editing is final, so nothing overrode them.
• Editing.mayOverwrite (dart fix). Editing.mayOverwrite is canOverwrite. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• Editing.setOverride (nothing to do). Overrides are stored by id path; a path given by name or #<index> is still accepted and converted, so callers need no change.
• EditorCommand (migrate, with a TODO). EditorCommand is a class: a switch over it that names every value gains _ => throw UnimplementedError(). EditorCommand is an abstract final class rather than a sealed one, so a case a later minor adds breaks no switch: a switch over its cases ends with a wildcard. The cases and their fields are unchanged.
• EditorHistory (nothing to do). run takes a DocumentCommand, which every EditorCommand is: the parameter widened, so every call still fits.
• GeneratorRefused (dart fix). GeneratorRefused is GeneratorException. GeneratorRefused is GeneratorException (decision H: a type that is thrown is named *Exception), with the same members. It now extends Flutter3dFormatException (and through it Flutter3dException) instead of implementing Exception directly, so on Exception still catches it; dart fix renames every use.
• GeneratorSource (migrate). GeneratorSource is a base mixin class: implements GeneratorSource becomes with GeneratorSource, on a base class.
• Handle.Handle (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Handle.centre (dart fix). Handle.centre is center. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Handle.tint (migrate). tint: Vector3(x, y, z) of Handle.tint is tint: LinearColor(x, y, z). A handle's tint is a linear LinearColor, as every colour the engine takes is: Vector3(r, g, b) is LinearColor(r, g, b), and a read of .x is .r.
• LevelBatch (migrate). LevelBatch is a class: .node is .node, .mesh is .mesh, .bounds is .bounds, .brush is .brush; a destructuring pattern is yours to rewrite. LevelBatch (in flutter3d_level_scene now) is a final class with the same node, mesh, bounds and brush; only a destructuring pattern names the class.
• LevelBatch (dart fix). LevelBatch is imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. Building a scene from a level left the editor's core for flutter3d_level_scene, which the application's level loader and the editor both stand on. dart fix changes the import, and migrate adds the dependency.
• LevelBatching (dart fix). LevelBatching is imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. Building a scene from a level left the editor's core for flutter3d_level_scene, which the application's level loader and the editor both stand on. dart fix changes the import, and migrate adds the dependency.
• LevelScene (dart fix). LevelScene is imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. Building a scene from a level left the editor's core for flutter3d_level_scene, which the application's level loader and the editor both stand on. dart fix changes the import, and migrate adds the dependency.
• LevelSceneParts (dart fix). LevelSceneParts is imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. Building a scene from a level left the editor's core for flutter3d_level_scene, which the application's level loader and the editor both stand on. dart fix changes the import, and migrate adds the dependency.
• LightPlan.changes (dart fix). LightPlan.changes is hasChanges. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• Listed (dart fix). Listed is ListedPiece. A row of a level's listing is ListedPiece, a piece and its index; Listed is the modeller's row of a project.
• Look.tint (migrate). tint: Vector3(x, y, z) of Look.tint is tint: LinearColor(x, y, z). A look's tint is a linear LinearColor, as every colour the engine takes is: Vector3(r, g, b) is LinearColor(r, g, b), and a read of .x is .r.
• Looks.tintFor (nothing to do). The call is unchanged and so is the tint a look gives; only its type is, a LinearColor? whose channels are r, g and b, which is what a gizmo's tint now takes as it is.
• MoveBy (dart fix). MoveBy is MoveSelectionBy. The editor's command, which moves whatever is selected, is MoveSelectionBy; MoveBy is the modeller's, which moves objects by id. Its journal name is still moveBy.
• MoveSelectionBy (nothing to do). Not a new case of EditorCommand: it is MoveBy under its new name.
• OpenKind (dart fix). OpenKind is imported from package:flutter3d_sim/flutter3d_sim.dart. The kind that accepts a type and gives it no meaning was declared twice, here and in flutter3d_game; it is flutter3d_sim's now, beside EntityKind, and both use it. vocabularyOf is unchanged.
• Part.Part (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Part.color (migrate). color: Vector3(x, y, z) of Part.color is color: LinearColor(x, y, z). A part's color is a linear LinearColor, as every colour the engine takes is: Vector3(r, g, b) is LinearColor(r, g, b), and a read of .x is .r.
• Part.colour (dart fix). Part.colour is color. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Piece (migrate, with a TODO). Piece is a class: a switch over it that names every value gains _ => throw UnimplementedError(). Piece is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• PlacePrefab (by hand). EditorCommand has a new case, PlacePrefab, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• Placeable.tint (migrate). tint: Vector3(x, y, z) of Placeable.tint is tint: LinearColor(x, y, z). A palette row's tint is a linear LinearColor, as every colour the engine takes is: Vector3(r, g, b) is LinearColor(r, g, b), and a read of .x is .r.
• PluginCommand (by hand). A plugin's commands and components are published under its id: addCommand('sink', ...) through plugin boats's view registers boats.sink, so your PluginCommand.name returns 'boats.sink', and a component kind buoyancy becomes boats.buoyancy.
• PluginCommand (by hand). DocumentCommand has a new case, PluginCommand: a switch over a DocumentCommand that names every case needs one for it, or a wildcard.
• RevertOverrides (by hand). EditorCommand has a new case, RevertOverrides, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• SetOverride (by hand). EditorCommand has a new case, SetOverride, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• SetPrefabField (by hand). EditorCommand has a new case, SetPrefabField, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• UnpackPrefab (by hand). EditorCommand has a new case, UnpackPrefab, one of the seven prefab commands: a switch over EditorCommand that names every case needs one for it, or a wildcard. Nothing else changes; a command list built from editorCommandNames picks it up by itself.
• atLeast (migrate). atLeast becomes atLeast({0}.toLinearColor(), {1}).toVector3(). atLeast takes and gives a LinearColor. A call with a Vector3 is rewritten to convert both ways, which keeps it compiling; pass the colour as a LinearColor where you have one.
• contentsOf (dart fix). contentsOf is piecesOf. What is in a level is piecesOf(level), beside handlesOf; contentsOf is the modeller's, over a project.
• kGizmoSize (dart fix). kGizmoSize is gizmoSize. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kLight (dart fix). kLight is paletteLight. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• kLooksFile (dart fix). kLooksFile is looksFile. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.
• meshDataOf (dart fix). meshDataOf is imported from package:flutter3d_level_scene/flutter3d_level_scene.dart. Building a scene from a level left the editor's core for flutter3d_level_scene, which the application's level loader and the editor both stand on. dart fix changes the import, and migrate adds the dependency.
• orderedSteps (dart fix). orderedSteps is imported from package:flutter3d_education/lesson.dart. Reading a lesson's steps in order is what a lesson viewer needs as much as an editor, and a viewer does not depend on an editor, so it is flutter3d_education's lesson.dart now. The function is the same; the import and the dependency on flutter3d_education change.
• tintFor (nothing to do). The call is unchanged and so are the numbers it answers; only their type is, a LinearColor whose channels are r, g and b, which is what a gizmo's and a palette row's tint now take as they are.
• viewsAlong (nothing to do). Only a type it names moved or was renamed (one severity, one kind of light, one pose, a ghost's frame); that type's own entry carries the fix, and a call needs none.

flutter3d_editor_mcp #

• package:flutter3d_editor_mcp/flutter3d_editor_mcp.dart (migrate). package:flutter3d_editor_mcp/flutter3d_editor_mcp.dart is package:flutter3d_mcp/editor.dart. flutter3d_editor_mcp is the editor.dart library of flutter3d_mcp, with the API it had; package:flutter3d_mcp/flutter3d_mcp.dart exports it beside its siblings. It was on pub.dev as flutter3d_editor_mcp.
• package:flutter3d_editor_mcp/src/ (migrate). package:flutter3d_editor_mcp/src/ is package:flutter3d_mcp/src/editor/. What was under flutter3d_editor_mcp's lib/src/ is under lib/src/editor/ of flutter3d_mcp. Importing it was never the public API; the main library above is.
• EditorSession (by hand). save returns a Future<Answer> now, because it writes the file asynchronously. await it where its answer was read.
• EditorTool (nothing to do). Its tools answer an Answer, which carries the picture now; the rename of PictureAnswer carries the fix, and a tool that reads did, says or png reads them as before.
• editorMcpVersion (nothing to do). Only the value of the constant moved; code that reads editorMcpVersion gets the new one. It is a version or a layout size the engine stamps and checks itself.
• package:flutter3d_mcp_kit/flutter3d_mcp_kit.dart (nothing to do). Answer and PictureAnswer are still exported by the editor's library, package:flutter3d_mcp/editor.dart; they come from kit.dart of the same package, and the import moves with the rest.

flutter3d_editor_widgets #

• ColorField (migrate, with a TODO). ColorField is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• NumberField (migrate, with a TODO). NumberField is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• NumberUnit (migrate, with a TODO). NumberUnit is a class: a switch over it that names every value gains _ => throw UnimplementedError(). NumberUnit is an open set since 1.0, a class with constants rather than an enum, so a value a later minor adds does not break your code: a switch over it needs a _ => case. The constants, values, name (the same words the enum wrote) and byName are there; index is not.
• NumberUnit.metres (migrate). NumberUnit.metres becomes NumberUnit.meters. Public names are spelled the American way: NumberUnit.metres is NumberUnit.meters, the same unit.
• kLabelBesideFrom (dart fix). kLabelBesideFrom is labelBesideFrom. A public constant is lowerCamelCase in 1.0, as Effective Dart asks, without the k prefix. The value is the same under the new name.

flutter3d_foundation #

• LinearColor (by hand). A colour the engine hands out is a LinearColor, a value, where it was a vector: color.scale(f) changed it in place and is holder.color = color.scaled(f) on whatever held it; vector arithmetic on two colours is on toVector3() or toVector4() of each, or on their channels.
• LinearColor (migrate). LinearColor becomes x.to{type}(). A colour the engine hands out is a LinearColor where it was a vector: where code of your own still takes the vector, toVector3() or toVector4() gives it, with the same linear numbers.
• LinearColor.w (migrate). LinearColor.w becomes x.a. A colour the engine hands out is a LinearColor where it was a vector: .w of it is .a.
• LinearColor.x (migrate). LinearColor.x becomes x.r. A colour the engine hands out is a LinearColor where it was a vector: .x of it is .r.
• LinearColor.y (migrate). LinearColor.y becomes x.g. A colour the engine hands out is a LinearColor where it was a vector: .y of it is .g.
• LinearColor.z (migrate). LinearColor.z becomes x.b. A colour the engine hands out is a LinearColor where it was a vector: .z of it is .b.

flutter3d_game #

• ActorAppearance (migrate). ActorAppearance is a base mixin class: implements ActorAppearance becomes with ActorAppearance, on a base class.
• ActorVisuals.sync (migrate). ActorVisuals.sync(x0) is ActorVisuals.sync(alpha: x0). The blend between the last two steps is a named argument: visuals.sync(alpha) is visuals.sync(alpha: alpha).
• AutomapPainter (migrate, with a TODO). AutomapPainter is a final class: a class that extended or implemented it gets a TODO. A painter is final since 1.0: paint with one from a CustomPainter of your own instead of extending it.
• AutomapPainter (dart fix). AutomapPainter is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• AutomapPainter.AutomapPainter (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• AutomapPainter.metersAcross (nothing to do). metersAcross is metresAcross under its American name, which that member's rename entry carries.
• AutomapPainter.metresAcross (dart fix). AutomapPainter.metresAcross is metersAcross. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• AutomapView (migrate, with a TODO). AutomapView is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• AutomapView (dart fix). AutomapView is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• AutomapView.AutomapView (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• AutomapView.metersAcross (nothing to do). metersAcross is metresAcross under its American name, which that member's rename entry carries.
• AutomapView.metresAcross (dart fix). AutomapView.metresAcross is metersAcross. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• AxisBinding (nothing to do). ActionBinding is new in 1.0, sealed with its five shapes from the start, and AxisBinding is one of them. No 0.8 code has a switch over ActionBinding to be missing a case.
• AxisComposite (nothing to do). ActionBinding is new in 1.0, sealed with its five shapes from the start, and AxisComposite is one of them. No 0.8 code has a switch over ActionBinding to be missing a case.
• Bindings.takeFrom (dart fix). Bindings.takeFrom is copyFrom. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• BugReportTape (migrate). BugReportTape is a class: .start is .start, .tape is .tape; a destructuring pattern is yours to rewrite. BugReportTape is a final class with the same start and tape; only a destructuring pattern names the class.
• ButtonBinding (nothing to do). ActionBinding is new in 1.0, sealed with its five shapes from the start, and ButtonBinding is one of them. No 0.8 code has a switch over ActionBinding to be missing a case.
• CloudDocument (by hand). CloudFetch has a new case, CloudDocument: a switch over a CloudFetch that names every case needs one for it, or a wildcard.
• CloudEmpty (by hand). CloudFetch has a new case, CloudEmpty: a switch over a CloudFetch that names every case needs one for it, or a wildcard.
• CloudMoved (by hand). CloudPut has a new case, CloudMoved: a switch over a CloudPut that names every case needs one for it, or a wildcard.
• CloudStored (by hand). CloudPut has a new case, CloudStored: a switch over a CloudPut that names every case needs one for it, or a wildcard.
• CloudUnavailable (by hand). CloudFetch has a new case, CloudUnavailable: a switch over a CloudFetch that names every case needs one for it, or a wildcard.
• Credit (dart fix). Credit is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• Credit.Credit (dart fix). American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Credit.licence (dart fix). Credit.licence is license. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Credit.licenceUrl (dart fix). Credit.licenceUrl is licenseUrl. American spelling in identifiers, as Flutter and Dart use: the old British name is gone, and the new one means the same.
• Credit.traced (dart fix). Credit.traced is isTraced. A boolean getter reads as a question in 1.0: it starts with is, has, can, uses, supports, did or was, as Effective Dart asks. The value is the same under the new name.
• CreditsSection (by hand). heading defaults to the player's language (Flutter3dGameLocalizations.art), and footnote has no default: a game that relied on "Sounds and surfaces are generated by this repository" passes its own line.
• CreditsSection (migrate, with a TODO). CreditsSection is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• CreditsSection (dart fix). CreditsSection is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• DemoFile (by hand). read, write and clear are asynchronous, because Storage is: await them.
• DesktopInput (by hand). capture: takes a MouseCapture, the game's own: leave out capture: PointerLock.instance, which is the default, and make a test's fake capture extend MouseCapture, whose changes is a Stream<bool>, true when the pointer is taken.
• DesktopInput (by hand). A slot is an action: bind a key to SlotActions.of(n) in the action map (DesktopInput.addSlotsTo(map, keys)), and DesktopInput requests slot n on its press. addDefaultsTo binds the number row to the first four.
• DesktopInput (migrate). bindings: x of DesktopInput is actions: ActionMap(actions: ActionSet.common, buttons: x). DesktopInput reads an ActionMap: pass actions: where bindings: was (ActionMap(actions: ActionSet.common, buttons: table) wraps an old table), and read actions.buttons where bindings was read. defaultBindings() is DesktopInput.addDefaultsTo(ActionMap(actions: ActionSet.common)).buttons, and defaultActionMap is unchanged.
• DesktopInput.bindings (migrate). DesktopInput.bindings becomes x.actions.buttons. The table a DesktopInput reads is its map's buttons.
• DesktopInput.defaultBindings (migrate). DesktopInput.defaultBindings becomes x.addDefaultsTo(ActionMap(actions: ActionSet.common)).buttons. The keyboard's defaults are added to a map, whose buttons are the table defaultBindings() returned.
• DesktopInput.release (dart fix). DesktopInput.release is releaseMouse. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• DragLook.take (dart fix). DragLook.take is drain. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• DualAxisBinding (nothing to do). ActionBinding is new in 1.0, sealed with its five shapes from the start, and DualAxisBinding is one of them. No 0.8 code has a switch over ActionBinding to be missing a case.
• DualAxisComposite (nothing to do). ActionBinding is new in 1.0, sealed with its five shapes from the start, and DualAxisComposite is one of them. No 0.8 code has a switch over ActionBinding to be missing a case.
• FixtureAppearance (migrate). FixtureAppearance is a base mixin class: implements FixtureAppearance becomes with FixtureAppearance, on a base class.
• FixtureAppearance.refresh (migrate). FixtureAppearance.refresh takes one FixtureRefreshContext: an override reads its old parameters from it (parameter 1 is .fixture, parameter 2 is .material), and a call builds one. FixtureAppearance.refresh takes one FixtureRefreshContext where it took its parameters. A fixture appearance is a hook a game implements, refreshed per fixture per frame, so the visuals reuse one context and an appearance must not keep it; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• GameConfig (by hand). GameSettings (what GameConfig became) is a value: change it with withVolume(AudioBus.music, v), withValue(key, v), withoutValue(key) or copyWith, each of which returns a new one. A volume is volumeOf(AudioBus.music) where it was volumeOf('music'). A setting is a typed SettingKey: settingOf('pad.look', fallback) is valueOf(GameSettingKeys.padLook), or chosenValueOf(key) ?? fallback for a default that is somebody else's (the system's reduce-motion); a game's own setting is SettingKey<T>('mygame.name', fallback: ...). bindings is actions?.buttons: the controls are one ActionMap. fromJson takes defaultActions: and reads a file from before the envelope, moving its names to the namespaced ids.
• GameConfig (dart fix). GameConfig is GameSettings. Settings classes have one suffix in 1.0, Settings (a HAL type's is Descriptor), and each is final, const, with a copyWith that covers every field. The class is the same under the new name.
• LevelWalk.spawnIn (nothing to do). spawnIn returns a SpawnPoint, a class whose getters at and yaw read as the record's fields did, so spawn.at and spawn.yaw are unchanged; a destructuring (:at, :yaw) becomes SpawnPoint(:at, :yaw), which 2f-game-SpawnPoint-class marks.
• LightFixtureBuild (nothing to do). Only the engine's material type in its signature changed: Material is RenderMaterial (core-Material-RenderMaterial renames it).
• OpenKind (dart fix). OpenKind is imported from package:flutter3d_sim/flutter3d_sim.dart. OpenKind is flutter3d_sim's now, the same class the editor uses; openRegistryFor is unchanged.
• PadAxisPair (by hand). Bind each direction of the axis as a button with a magnitude: InputSource.padHalfAxis('leftStickX', positive: false) to the negative action and positive: true to the positive one, in the action map's buttons.
• PadInput (by hand). PadInput reads an ActionMap: pass actions: where bindings: was, and read actions.buttons where bindings was read. addDefaultsTo and knowsPad take the map (addDefaultsTo(map) returns it); defaultBindings() is PadInput.addDefaultsTo(ActionMap(actions: ActionSet.common)).buttons.
• PadInput (by hand). pad: takes a PadDevice, the game's own: leave out pad: Gamepad.instance, which is the default, write PadDevice.platform(slot: n) for Gamepad(index: n), and make a test's fake pad extend PadDevice and fill the PadReading it is handed. heldButtons holds GamePadButtons, so compare with GamePadButton.start rather than PadButton.start: a contains with the old type still compiles and is always false.
• PadInput (by hand). What the sticks do is the action map's (see f4-game-PadRoutes); routes.lookRate is lookRate. slotButtons: PadInput.dpadSlots is PadInput.addSlotDefaultsTo(map), which binds the d-pad to SlotActions. storeSettings is gone: the settings panel writes the dead zone and the look speed as GameSettingKeys, which applySettings reads.
• PadInput.addDefaultsTo (migrate). PadInput.addDefaultsTo becomes PadInput.addDefaultsTo(ActionMap(actions: ActionSet.common, buttons: {0})).buttons. PadInput.addDefaultsTo adds the pad's defaults to an ActionMap: an old table goes in as its buttons, and the buttons are the table it returned.
• PadInput.bindings (migrate). bindings: x of PadInput.bindings is actions: ActionMap(actions: ActionSet.common, buttons: x). A PadInput reads an ActionMap: an old table goes in as its buttons.
• PadInput.bindings (migrate). PadInput.bindings becomes x.actions.buttons. The table a PadInput reads is its map's buttons.
• PadInput.defaultBindings (migrate). PadInput.defaultBindings becomes x.addDefaultsTo(ActionMap(actions: ActionSet.common)).buttons. The pad's defaults are added to a map, whose buttons are the table defaultBindings() returned.
• PadPresses (nothing to do). offer takes the GameSettingsController that game-SettingsCubit renames at the call site; nothing else changed.
• PadPresses.offer (migrate). menuButton: PadButton(x) of PadPresses.offer is menuButton: GamePadButton(PadButton(x).id). menuButton: takes a GamePadButton, the game's own: write GamePadButton.start for PadButton.start. The ids are the same, so a saved binding is unchanged.
• PadRoutes (by hand). A pad's sticks are bindings in the action map. PadRoutes.walking is what PadInput.addDefaultsTo(map) binds (the left stick walks, the right one looks); PadRoutes.driving(steerLeft:, steerRight:) is PadInput.addDrivingDefaultsTo(map, steerLeft:, steerRight:); lookRate is PadInput.lookRate. Pass no routes: to PadInput.
• PadStickTarget (by hand). PadStickTarget is gone with PadStickUse: what a stick does is a DualAxisBinding on InputSource.padStick('left') or 'right' in the action map, to DualAxisAction.move, DualAxisAction.look or a game's own DualAxisAction, which the game reads off the InputState.
• PadStickUse (by hand). Bind the stick to an action instead: DualAxisBinding(myAction, InputSource.padStick('left')) in the action map, and read input.dualAxis(myAction) where the use's route was called. PadStickUse.move and look are DualAxisAction.move and look; ignored is no binding.
• Playing.capturesPointer (migrate). Playing.capturesPointer becomes Playing.ofPlatform().capturesPointer. Playing is an object: Playing.capturesPointer is Playing.ofPlatform().capturesPointer.
• Playing.dragLook (migrate). Playing.dragLook becomes Playing.ofPlatform().usesDragLook. Playing is an object, and a boolean getter reads as a question in 1.0: Playing.dragLook is Playing.ofPlatform().usesDragLook.
• Playing.touch (migrate). Playing.touch becomes Playing.ofPlatform().touch. Playing is an object: Playing.ofPlatform() reads the platform the static getters read, so Playing.touch is Playing.ofPlatform().touch. A game makes one where it starts and passes it on; a test constructs Playing(touch: …, capturesPointer: …) instead of overriding the platform.
• Rebinding (nothing to do). bindings went from required to optional, beside a new actions map and onConflict; Rebinding(bindings: table) means what it did. Rebinding is final, so nothing extends the constructor.
• RunSession (by hand). save returns whether it wrote the run. A call that ignored the result is unchanged; a subclass that overrides save declares it bool save() and returns true once the run is written.
• RunSession.carryFrom (migrate). RunSession.carryFrom takes one RunCarryContext: an override reads its old parameters from it (parameter 1 is .level, parameter 2 is .next), and a call builds one. RunSession.carryFrom takes one RunCarryContext where it took its parameters. A run session is a hook a game extends; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• RunSession.close (dart fix). RunSession.close is disposeLevel. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• RunSession.open (dart fix). RunSession.open is loadLevel. Creation and teardown verbs follow one convention in 1.0: create (synchronous), open (a device or a session), load (an asset), decode (bytes), parse (text), dispose (teardown), close (a connection or a stream), and drain for a read that empties what it reads. The behaviour is the same under the new name.
• RunSession.restoreInto (migrate). RunSession.restoreInto takes one RunRestoreContext: an override reads its old parameters from it (parameter 1 is .level, parameter 2 is .snapshot), and a call builds one. RunSession.restoreInto takes one RunRestoreContext where it took its parameters. A run session is a hook a game extends; one context can gain members in a minor release, where a parameter added to the call would break every override written against 1.0. migrate gives an override the context and reads each parameter it used from it, and a call builds one.
• RunStatus (migrate, with a TODO). RunStatus is a class: a switch over it that names every value gains _ => throw UnimplementedError(). RunStatus is an abstract final class rather than a sealed one, so a case a later minor adds breaks no switch: a switch over its cases ends with a wildcard. The cases and their fields are unchanged.
• RunTimeline.RunTimeline (by hand). RunTimeline(rewind:, input:, stepSim:, restore:) is RunTimeline(rewind:, loop:): the EngineLoop the run steps in, which the buffer is attached to (rewind.attach(loop), in place of adding its recorder to loop.recorders and calling keyframe with the run's save). The run has to be a part of the loop's snapshots — a genre is, under its plugin id; a game's own run adds loop.snapshots.add(SnapshotPart.of(id:, capture:, restore:)) — and its step a system of the loop's. input and stepSeconds are the loop's.
• RunTimeline.input (nothing to do). Still readable: a getter for the loop's input where it was a field. Nothing outside the package implements RunTimeline.
• RunTimeline.restore (by hand). The timeline restores through the loop's snapshots (loop.rewindTo(step, state:)), so the run is a part of them — a genre's is, under its plugin id — rather than a function handed to the timeline.
• RunTimeline.stepSeconds (nothing to do). Still readable: a getter for the loop's stepSeconds where it was a field. Nothing outside the package implements RunTimeline.
• RunTimeline.stepSim (by hand). The timeline steps the loop it was given (loop.runSteps), so the run's step is a system of that loop, not a function handed to the timeline.
• RunTimeline.tracks (by hand). tracks(capture:, layout:) is tracks(layout:, part:): the loop's capture is read at each step, and part: — the run's part, a genre's plugin id — hands the layout that part's own data, which is what a layout written against the run's save() reads.
• SaveFile (by hand). read, readRecord, write, writeRecord and clear are asynchronous, because Storage is: await them. A save kept before slots is the default slot's (save.json); SaveSlots holds more.
• ScrubMoved (by hand). ScrubAnswer has a new case, ScrubMoved: a switch over a ScrubAnswer that names every case needs one for it, or a wildcard.
• ScrubRefused (by hand). ScrubAnswer has a new case, ScrubRefused: a switch over a ScrubAnswer that names every case needs one for it, or a wildcard.
• SettingsCubit (by hand). GameSettingsController takes settings: where it took config:, and the map the devices read as actions:. settings is the current value, replaced on every change; keep yours current in apply. setVolume takes an AudioBus, and setSetting(name, value) is setValue(GameSettingKeys.<key>, value).
• SettingsCubit (dart fix). SettingsCubit is GameSettingsController. GameSettingsController is the same state machine as a ValueListenable rather than a Cubit: read .value where .state was read, listen with a ValueListenableBuilder where a BlocBuilder was, and call dispose() where close() was. rebind takes any action and its part (rebindAction is gone), and reset(defaults) takes the action map where resetControls took a button table.
• SettingsCubit.close (migrate). SettingsCubit.close becomes Future<void>.sync(x.dispose). GameSettingsController is a ChangeNotifier: dispose() is what a cubit's close() was, and it answers nothing to await.
• SettingsCubit.state (migrate). SettingsCubit.state becomes x.value. GameSettingsController is a ValueListenable: its value is what a cubit's state was.
• SettingsFile (by hand). read, write and clear are asynchronous, because Storage is. Read the settings in main() before runApp (after WidgetsFlutterBinding.ensureInitialized()) and hand the GameConfig to the screen, so the first key press uses them. write answers Future<bool>.
• SettingsOverlay (by hand). SettingsOverlay takes settings, sections, opening and canOpen. Pass sections: SettingsSection.standard(buses: ..., defaultActions: ..., padConnected: ..., credits: ..., colors: ..., privacy: ...) where mixer, bindings, config, padConnected, defaultBindings, credits and the rest were; the sections read and change the GameSettingsController themselves.
• SettingsOverlay (dart fix). SettingsOverlay is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• SettingsOverlay (migrate, with a TODO). SettingsOverlay is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• SettingsPanel (migrate, with a TODO). SettingsPanel is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• SettingsPanel (dart fix). SettingsPanel is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• SettingsPanel (by hand). SettingsPanel(settings: controller, sections: [...]) replaces the mixer, the config, the callbacks and the rest: the sections (SettingsSection.standard(...), or VolumesSection, ControlsSection, AccessibilitySection, MouseSection, GamepadSection and their kin) read and change the GameSettingsController, and the panel closes through it.
• SettingsState (by hand). waitingFor is the action of any kind that is listening, an InputAction<Object>?; waitingForAction is gone into it. A check for a button compares with is GameAction.
• SpawnPoint (migrate). SpawnPoint is a class: .at is .at, .yaw is .yaw; a destructuring pattern is yours to rewrite.
• TapToRestart (dart fix). TapToRestart is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TimelineCommand (migrate, with a TODO). TimelineCommand is a class: a switch over it that names every value gains _ => throw UnimplementedError(). TimelineCommand is an abstract base class rather than sealed, so a command added in a minor release breaks no switch: a switch that named every command gains a case for the rest.
• TimelineLevelSwapped (by hand). TimelineCommand has a new case, TimelineLevelSwapped: a switch over a TimelineCommand that names every case needs one for it, or a wildcard.
• TimelineReplayed (by hand). TimelineCommand has a new case, TimelineReplayed: a switch over a TimelineCommand that names every case needs one for it, or a wildcard.
• TimelineReturned (by hand). TimelineCommand has a new case, TimelineReturned: a switch over a TimelineCommand that names every case needs one for it, or a wildcard.
• TimelineScrubbed (by hand). TimelineCommand has a new case, TimelineScrubbed: a switch over a TimelineCommand that names every case needs one for it, or a wildcard.
• TouchAction (dart fix). TouchAction is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchButton (dart fix). TouchButton is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchButton (migrate, with a TODO). TouchButton is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• TouchControls (dart fix). TouchControls is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchControls (migrate, with a TODO). TouchControls is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• TouchSlot (dart fix). TouchSlot is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchSlots (dart fix). TouchSlots is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchSlots (migrate, with a TODO). TouchSlots is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• TouchStick (dart fix). TouchStick is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchStick (migrate, with a TODO). TouchStick is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• TouchToggle (dart fix). TouchToggle is imported from package:flutter3d_game_ui/flutter3d_game_ui.dart. The widgets left flutter3d_game for flutter3d_game_ui, which stands on it; flutter3d_game keeps the input, the run, the settings and the saves they show. dart fix adds the import, and migrate the dependency.
• TouchToggle (migrate, with a TODO). TouchToggle is a final class: a class that extended or implemented it gets a TODO. A widget is final since 1.0: wrap it in a widget of your own instead of extending it.
• applySavedVolumes (nothing to do). Only a type its declaration names was renamed; that rename's own fix carries every use.
• bugReportTape (nothing to do). An attached buffer keeps the loop's captures; pass part: (the run's part, a genre's plugin id) so the report's start is the run's own snapshot, which a .f3drun holds. Without it the keyframe is handed over whole, which is right only for a buffer filled by hand.
• configureForTouch (dart fix). configureForTouch is lockLandscapeForTouch. Called from main() as before; it takes the game's Playing optionally and asks the platform when given none.
• creditGaps (by hand). creditGaps checked this repository's demos against their asset folders and was not engine API; it lives in the repository's own test tooling now and no published package exports it. A test that used it copies it: it lists the asset folder with dart:io and compares the names with the credits' files.
• ownedBindings (by hand). Read the map the devices share as settings.actionsOr(defaults) and hand that same map to GameSettingsController(actions: ...), which saves a copy of it on every rebind; SettingsFile(defaultActions: defaults) reads a saved map against the game's own.
• package:flutter3d_game/testing.dart (by hand). creditGaps checked this repository's demos against their asset folders and was not engine API. Copy it into the test that uses it: it lists the folder with dart:io and compares the names with the credits' files.
• registerTimelineExtensions (by hand). capture: is gone: scrubTo and replayUnderNewCode are registered always, through the timeline's loop. tracks is registered with entityLayout:, and reads the part trackedPart: names (a genre's plugin id) when the layout reads the run's own save.
• replayDemo (by hand). Replay through the loop: replayDemoOnLoop(demo:, loop:, part:), where the loop steps the run (its genre installed, or the game's step as a system) and part is the run's part of its snapshots — the genre's plugin id (PlatformerPlugin.id), or the id of the SnapshotPart the game registered for its run. The file's start is restored as that part and each checkpoint digested from it, so recorded tapes check out as they did.
• replayDemoOnLoop (by hand). restore: and save: are gone; pass part:, the id of the run's part of the loop's snapshots (a genre's plugin id, or the SnapshotPart the game registered for its run with its own save and restore). The loop is rewound to step nought with the file's start as that part.
• rewindBufferFromDemo (by hand). rewindBufferFromDemo(demo:, stepsPerSecond:, input:, restore:, save:, stepSim:) is rewindBufferFromDemo(demo:, loop:, part:): the tape plays through the loop with the buffer attached, its start restored as the run's part. Steps per second are the loop's.
• settingsKeys (nothing to do). The settings argument is a GameSettingsController, which game-SettingsCubit renames at the call site; nothing else changed.