flutter3d
Showcase Changelog 62 packages API reference

Polylines in screen pixels: the source

since 0.7.0 Scene and geometry

Regions the guide quotes: routes (line 28), geometry (line 63), material (line 78), resize (line 106), check (line 130).

1/// Joined lines whose width is measured in screen pixels.
2library;
3
4import 'package:flutter3d/flutter3d.dart';
5import 'package:flutter3d_showcase/src/demo/demo.dart';
6
7/// The `polylines` page: coloured routes drawn as joined lines a fixed
8/// number of pixels wide. Its check is that the routes are drawn with their
9/// viewport set.
10final class PolylinesDemo extends ShowcaseDemo {
11 static const double _viewportWidth = 1280;
12 static const double _viewportHeight = 720;
14 final List<MeshData> _meshes = <MeshData>[];
15 final List<RenderMaterial> _materials = <RenderMaterial>[];
16 final List<MeshNode> _lines = <MeshNode>[];
18 @override
19 void configureView(DemoContext context) {
20 context.orbit
21 ..distance = 8.2
22 ..pitch = 0.08
23 ..yaw = 0.12;
24 }
26 @override
27 Scene build(DemoContext context) {
28 final List<List<Vector3>> routes = <List<Vector3>>[
29 <Vector3>[
30 Vector3(-3.2, 1.35, 0.0),
31 Vector3(-2.0, 1.75, 0.2),
32 Vector3(-0.8, 1.05, -0.1),
33 Vector3(0.4, 1.62, 0.15),
34 Vector3(1.7, 1.12, -0.05),
35 Vector3(3.2, 1.52, 0.1),
36 ],
37 <Vector3>[
38 Vector3(-3.2, 0.25, 0.0),
39 Vector3(-2.2, -0.35, 0.15),
40 Vector3(-1.0, 0.42, -0.1),
41 Vector3(0.0, -0.28, 0.1),
42 Vector3(1.25, 0.38, -0.15),
43 Vector3(2.15, -0.3, 0.1),
44 Vector3(3.2, 0.2, 0.0),
45 ],
46 <Vector3>[
47 Vector3(-3.2, -1.45, 0.0),
48 Vector3(-1.9, -0.85, -0.1),
49 Vector3(-0.55, -1.62, 0.15),
50 Vector3(0.8, -0.92, -0.1),
51 Vector3(2.0, -1.55, 0.12),
52 Vector3(3.2, -1.05, 0.0),
53 ],
54 ];
55 final List<double> widths = <double>[6, 12, 22];
56 final List<LinearColor> palette = <LinearColor>[
57 const LinearColor(0.12, 0.78, 1.0),
58 const LinearColor(0.48, 0.3, 0.96),
59 const LinearColor(1.0, 0.34, 0.2),
60 const LinearColor(1.0, 0.76, 0.15),
61 ];
63 _meshes.clear();
64 for (var routeIndex = 0; routeIndex < routes.length; routeIndex++) {
65 final List<Vector3> route = routes[routeIndex];
66 _meshes.add(
67 buildPolyline(
68 route,
69 width: widths[routeIndex],
70 colors: <LinearColor>[
71 for (var point = 0; point < route.length; point++)
72 palette[(point + routeIndex) % palette.length],
73 ],
74 ),
75 );
76 }
78 _materials
79 ..clear()
80 ..addAll(<RenderMaterial>[
81 for (var i = 0; i < _meshes.length; i++)
82 RenderMaterial.polyline(
83 name: 'route ${i + 1}',
84 viewportWidth: _viewportWidth,
85 viewportHeight: _viewportHeight,
86 ),
87 ]);
88 _lines
89 ..clear()
90 ..addAll(<MeshNode>[
91 for (var i = 0; i < _meshes.length; i++)
92 MeshNode(
93 DeviceMesh.upload(context.device, _meshes[i]),
94 _materials[i],
95 name: 'route ${i + 1}',
96 ),
97 ]);
99 final Scene scene = Scene();
100 for (final MeshNode line in _lines) {
101 scene.add(line);
102 }
103 return scene;
104 }
106 /// Tells every route's material that the view is [width] by [height]
107 /// pixels, which their widths are measured against. The page starts them at
108 /// 1280 by 720.
109 void setViewport(double width, double height) {
110 _drawnWidth = width;
111 _drawnHeight = height;
112 for (final RenderMaterial material in _materials) {
113 final viewport = material.polylineViewport!;
114 viewport[0] = width;
115 viewport[1] = height;
116 }
117 }
119 /// Every frame, before it is drawn: a route six pixels wide stays six
120 /// pixels wide whatever the canvas measures.
121 @override
122 void resize(DemoContext context, int width, int height) =>
123 setViewport(width.toDouble(), height.toDouble());
125 double _drawnWidth = _viewportWidth;
126 double _drawnHeight = _viewportHeight;
128 @override
129 void verify(Scene scene, FrameResult frame) {
130 final bool geometryMatches = _meshes.every(
131 (MeshData mesh) =>
132 mesh.vertexCount >= 12 &&
133 mesh.indexCount == (mesh.vertexCount - 2) * 3,
134 );
135 final bool viewportsMatch = _materials.every((RenderMaterial material) {
136 final viewport = material.polylineViewport;
137 return material.lighting == LightingModel.polyline &&
138 viewport != null &&
139 viewport[0] == _drawnWidth &&
140 viewport[1] == _drawnHeight;
141 });
142 if (_lines.length != 3 ||
143 !geometryMatches ||
144 !viewportsMatch ||
145 frame.drawCalls < 3) {
146 throw StateError('the joined pixel-width routes were not drawn');
147 }
148 }