flutter3d
Showcase Changelog 62 packages API reference

Levels of detail: the source

since 0.7.0 Scene and geometry

Regions the guide quotes: parts (line 23), asset (line 54), instantiate (line 70), selection (line 82), check (line 87).

1/// Three sphere meshes, packed into one `ModelAsset` with levels of detail and
2/// selected by their projected screen size.
3library;
4
5import 'package:flutter3d/flutter3d.dart';
6import 'package:flutter3d_showcase/src/demo/demo.dart';
7
8/// The `level-of-detail` page: one `ModelAsset` carrying three spheres as
9/// levels of detail. Its check is that the group shows exactly one of them.
10final class LevelOfDetailDemo extends ShowcaseDemo {
11 late final LodGroup _group;
13 @override
14 void configureView(DemoContext context) {
15 context.orbit
16 ..distance = 8.0
17 ..pitch = 0.18
18 ..yaw = 0.35;
19 }
21 @override
22 Scene build(DemoContext context) {
23 final List<(String, SphereShape, Vector4)> definitions =
24 <(String, SphereShape, Vector4)>[
25 (
26 'fine',
27 const SphereShape(radius: 1.6, segments: 48, rings: 24),
28 Vector4(0.16, 0.68, 0.92, 1.0),
29 ),
30 (
31 'medium',
32 const SphereShape(radius: 1.6, segments: 20, rings: 10),
33 Vector4(0.95, 0.62, 0.16, 1.0),
34 ),
35 (
36 'coarse',
37 const SphereShape(radius: 1.6, segments: 8, rings: 4),
38 Vector4(0.84, 0.24, 0.28, 1.0),
39 ),
40 ];
41 final List<ModelPart> parts = <ModelPart>[
42 for (final (String name, SphereShape shape, Vector4 color) in definitions)
43 ModelPart(
44 mesh: DeviceMesh.upload(context.device, shape.build()),
45 material: RenderMaterial(
46 name: '$name material',
47 baseColor: _fromSrgb(color),
48 roughness: 0.52,
49 ),
50 name: name,
51 ),
52 ];
54 final ModelNode node = ModelNode(
55 name: 'sphere lod',
56 surfaces: const <int>[0],
57 lods: const <ModelLod>[
58 ModelLod(surfaceIndices: <int>[1], maxScreenFraction: 0.34),
59 ModelLod(surfaceIndices: <int>[2], maxScreenFraction: 0.15),
60 ],
61 );
62 final ModelAsset asset = ModelAsset(
63 name: 'sphere lod asset',
64 parts: parts,
65 nodes: <ModelNode>[node],
66 roots: const <int>[0],
67 localBounds: parts.first.mesh.bounds,
68 );
70 final Scene scene = Scene()
71 ..ambientColor = LinearColor(0.42, 0.5, 0.68)
72 ..ambientIntensity = 0.14 * LightNode.legacyUnit
73 ..add(
74 LightNode(name: 'sun', intensity: 3.2 * LightNode.legacyUnit)
75 ..setLocalForward(Vector3(-0.46, -0.82, -0.34)),
76 );
77 asset.instantiate(scene);
78 _group = scene.lodGroups.single;
79 return scene;
80 }
82 double _screenFraction(Scene scene) =>
83 _group.screenFraction(scene.cameras.single);
85 @override
86 void verify(Scene scene, FrameResult frame) {
87 final int visibleLevels = _group.levels
88 .where((LodLevel level) => level.node.isVisible)
89 .length;
90 final double fraction = _screenFraction(scene);
91 if (scene.lodGroups.single != _group ||
92 _group.activeLevel < 0 ||
93 _group.activeLevel >= _group.levels.length ||
94 visibleLevels != 1 ||
95 fraction <= 0.0 ||
96 frame.drawCalls < 1) {
97 throw StateError('the LOD group did not select one visible mesh');
98 }
99 }
102/// A `Vector4` holding a colour sRGB-encoded, as the linear colour it names.
103LinearColor _fromSrgb(Vector4 c) => LinearColor.fromSrgb(c.x, c.y, c.z, c.w);