Several views in one frame: the source
Open the live demo · Read the guide · View on GitHub
Regions the guide quotes: layers (line 28), rect (line 67), split (line 75), controls (line 97), check (line 106).
1/// One `CameraView` cropped to a rectangle, and two combined in one frame.
2library;
4import 'package:flutter3d/flutter3d.dart';
5import 'package:flutter3d_showcase/src/demo/demo.dart';
7/// The `multi-view` page: two cubes on different layers, the viewport
8/// cropped to one view and a second view drawn beside it. Its check is that
9/// the two views drew more than one draw.
10final class MultiViewDemo extends ShowcaseDemo {
11 /// Whether the main view shows the left cube's layer (1) rather than the
12 /// right cube's (2).
13 bool showLeft = true;
15 late final Scene _scene;
16 FrameResult? _combined;
19 void configureView(DemoContext context) {
20 context.orbit
21 ..distance = 6.0
22 ..pitch = 0.15
23 ..yaw = 0.0;
24 }
27 Scene build(DemoContext context) {
28 final MeshNode leftCube =
29 MeshNode(
30 DeviceMesh.upload(
31 context.device,
32 CuboidShape(size: Vector3.all(1.0)).build(),
33 ),
34 RenderMaterial(
35 name: 'left',
36 baseColor: LinearColor.fromSrgb(0.2, 0.55, 0.95, 1.0),
37 ),
38 name: 'left cube',
39 )
40 ..setPosition(-1.4, 0.0, 0.0)
41 ..layerMask = 1;
42 final MeshNode rightCube =
43 MeshNode(
44 DeviceMesh.upload(
45 context.device,
46 CuboidShape(size: Vector3.all(1.0)).build(),
47 ),
48 RenderMaterial(
49 name: 'right',
50 baseColor: LinearColor.fromSrgb(0.95, 0.42, 0.2, 1.0),
51 ),
52 name: 'right cube',
53 )
54 ..setPosition(1.4, 0.0, 0.0)
55 ..layerMask = 2;
57 _scene = Scene()
58 ..ambientColor = LinearColor(0.45, 0.5, 0.6)
59 ..ambientIntensity = 0.16 * LightNode.legacyUnit
60 ..add(leftCube)
61 ..add(rightCube)
62 ..add(
63 LightNode(name: 'key', intensity: 3.0 * LightNode.legacyUnit)
64 ..setLocalForward(Vector3(-0.4, -0.7, -0.5)),
65 );
67 context.view
68 ..viewportFraction = const ViewportRect(0.0, 0.0, 0.5, 1.0)
69 ..layerMask = showLeft ? 1 : 2;
70 return _scene;
71 }
74 void update(DemoContext context, double dt) {
75 final CameraView left = CameraView(
76 camera: context.camera,
77 viewportFraction: const ViewportRect(0.0, 0.0, 0.5, 1.0),
78 layerMask: 1,
79 );
80 final CameraView right = CameraView(
81 camera: context.camera,
82 viewportFraction: const ViewportRect(0.5, 0.0, 0.5, 1.0),
83 layerMask: 2,
84 );
85 _combined = context.renderer.render(
86 width: 320,
87 height: 180,
88 scene: _scene,
89 views: <CameraView>[left, right],
90 settings: const RenderSettings(),
91 );
92 context.view.layerMask = showLeft ? 1 : 2;
93 }
96 List<DemoControl> controls(DemoContext context) => <DemoControl>[
97 ToggleControl(
98 'Show the left layer',
99 value: () => showLeft,
100 onChanged: (bool value) => showLeft = value,
101 ),
102 ];
105 void verify(Scene scene, FrameResult frame) {
106 final FrameResult? combined = _combined;
107 if (combined == null || combined.drawCalls <= frame.drawCalls) {
108 throw StateError('two views in one frame did not draw more than one');
109 }
110 }
111}