flutter3d_build #

The build hook behind a flutter3d project's assets. It converts model and texture sources into what the engine loads, and it does so on every build, so nobody has to remember to run a separate step.

dart pub add dev:flutter3d_build
dart run flutter3d_build:init          # hook/build.dart, pubspec, .gitignore
dart run flutter3d_build:init --check  # say what a run would change, change nothing

After that, anything under assets_src/ is converted into flutter3d_generated/ at the same relative path whenever the project builds, and a second build with nothing changed converts nothing. A flutter3d_assets.yaml beside the pubspec excludes files by glob.

The hook compresses textures for the platform it is building for: BC for a desktop target, ETC2 for Android and iOS. A block format is a property of the platform, so the hook does not have to guess about the device. A web build names no target and is left alone. Setting textures: under the project's own name in its hooks: user_defines: overrides either choice. The value universal there is the one family every device can load; it is turned into BC, ASTC, ETC2 or RGBA8 when the texture is uploaded.

The same converter can be run by hand:

dart run flutter3d_build:convert assets_src/chair.glb --textures universal

Plain Dart #

The Flutter tool starts hook/build.dart as a separate process, with no window and no Flutter SDK to resolve inside it. None of this package's dependencies (flutter3d_core, package:hooks, package:code_assets and a few plain-Dart libraries) names Flutter, because a hook that needed the SDK would not start on a machine that does not have it.