ent
The scene layer of Ent Engine, a 3D engine for Dart, in pure Dart: scene graph, math, cameras, geometries,
materials, lights, animation, loaders, camera controls and post-processing. It imports no Flutter, dart:ui or
dart:io, so it runs anywhere Dart does.
ent does not draw. A renderer package draws its scenes: today that is
ent_flutter, a renderer on Flutter GPU, which also exports all of ent. A Flutter
app depends on ent_flutter only.
A scene
import 'package:ent/ent.dart';
void main() {
final scene = Scene()..background = Color(0x202020);
final camera = PerspectiveCamera(60, 16 / 9, 0.1, 100)..position.set(0, 1.5, 4);
camera.lookAt(Vector3(0, 0, 0));
final cube = Mesh(BoxGeometry(1, 1, 1), MeshStandardMaterial({'color': 0x44aa88, 'roughness': 0.4}));
scene
..add(cube)
..add(AmbientLight(0xffffff, 0.3))
..add(DirectionalLight(0xffffff, 2)..position.set(3, 5, 2));
// Each frame, before it is drawn:
cube.rotation.y += 0.01;
// Picking needs no renderer: cast a ray through the center of the view.
scene.updateMatrixWorld();
camera.updateMatrixWorld();
final hits = (Raycaster()..setFromCamera(Vector2(0, 0), camera)).intersectObject(cube);
print('${hits.length} hits, the nearest ${hits.first.distance.toStringAsFixed(2)} away');
}
To draw it in Flutter, with ent_flutter:
final renderer = await FlutterGpuRenderer.create();
EntView(
renderer: renderer,
scene: scene,
camera: camera,
onFrame: (elapsed) => cube.rotation.y = elapsed.inMicroseconds / 1e6,
);
What is included
- Core, math, cameras, the built-in geometries and curves, every mesh, line, points and sprite material, lights and
shadows,
InstancedMesh,BatchedMesh,SkinnedMesh, morph targets,LOD, fog and the animation system. - Loaders:
ObjectLoader(the JSON format),GLTFLoader(glTF 2.0 and GLB, with mostKHR_materials_*extensions; not Draco, meshopt, KTX2 or GPU instancing),HDRLoader,TextureLoader,FileLoaderand the other core loaders. - Controls:
OrbitControlsandMapControls. - Post-processing:
EffectComposerwithRenderPass,OutputPass,CopyPass,FXAAPass,VignettePassandTuningPass(bloom).
Platform services
Loading images and files needs the platform: set ImageUtils.platform and Loader.platform once before loading.
ent_flutter's FlutterPlatform.install() sets both for Flutter (data URLs, http(s) and asset keys). Without a
platform, loaders that parse what they are given (ObjectLoader.parse, GLTFLoader.parse of a GLB without images)
still work.
Design notes
Where Dart or the renderer needs its own shape, the choice is recorded, with its reason and tests, in the compatibility exceptions. The ones a user meets first:
- No shaders at runtime: there is no
ShaderMaterial,RawShaderMaterialoronBeforeCompile; a loader reads a shader material as a plainMaterial, with a warning. - Post-processing effects are typed materials (
CopyMaterial,VignetteMaterial, ...) drawn byEffectPass; the renderer owns their shaders. Bloom isTuningPass. - Controls take a
ControlsElementand plain pointer, wheel and key events instead of a DOM element; in Flutter,OrbitControlsListenerfeeds them. - Ranges, raycast hits and camera views are small typed classes, not maps.
More usage, for controls, GLTFLoader and post-processing, is in docs/usage.md.
Status
Version 0.1.0-dev.1, a preview: the API may still change before 0.1.0. The API is listed in test/api.txt,
which test/api_test.dart checks, so every change to it is deliberate.
dart test
The tests compare ent with reference values in fixtures/, written by the scripts in
tool/reference/js/.
License
MIT, © 2026 KAMORA Ltd.; see LICENSE.
The notices of the third-party code it builds on are in THIRD_PARTY_NOTICES.md.
Libraries
- ent
- Ent Engine, a 3D engine for Dart: its scene layer, in pure Dart.