The stereo rig: the source
Open the live demo · Read the guide · View on GitHub
Regions the guide quotes: rig (line 16), surface (line 43), views (line 54).
1/// Two cameras under a head, under a stage the application moves: a stereo
2/// pair drawn side by side into one frame.
3///
4/// Quoted by `stereo_rig.md` and shown whole in the Source tab.
5library;
7import 'package:flutter/widgets.dart';
8import 'package:flutter3d/flutter3d.dart';
9import 'package:flutter3d/flutter3d.dart' as f3d show RenderMaterial;
10import 'package:flutter3d_showcase/src/demo/demo.dart';
11import 'package:flutter3d_stereo/flutter3d_stereo.dart';
13/// The `stereo-rig` page: a ball seen by a stereo pair side by side. Its
14/// check is that the rig draws two views, one filling each half of the frame.
15final class StereoRigDemo extends ShowcaseDemo {
16 final StereoRig _rig = StereoRig();
18 late Scene _scene;
21 Scene build(DemoContext context) {
22 final material = f3d.RenderMaterial(
23 name: 'ball',
24 baseColor: LinearColor.fromSrgb(0.8, 0.5, 0.3, 1.0),
25 );
26 final ball = MeshNode(
27 DeviceMesh.upload(context.device, SphereShape(segments: 24).build()),
28 material,
29 )..setPosition(0, 0, -2);
30 _rig.stage.setPosition(0, 0, 0);
31 _scene = Scene()
32 ..add(_rig.stage)
33 ..add(ball)
34 ..add(
35 LightNode(name: 'sun', intensity: 3.0 * LightNode.legacyUnit)
36 ..setLocalForward(Vector3(-0.4, -1.0, -0.3)),
37 );
38 return _scene;
39 }
42 Widget? customBody(BuildContext buildContext, DemoContext context) {
43 return StereoSurface(
44 renderer: context.renderer,
45 scene: _scene,
46 rig: _rig,
47 settings: () => const RenderSettings().forStereo(),
48 onBeforeDraw: () {},
49 );
50 }
53 void verify(Scene scene, FrameResult frame) {
54 // Two views, side by side, half the frame's width apart.
55 if (_rig.views.length != 2) {
56 throw StateError('a stereo rig draws exactly two views');
57 }
58 final left = _rig.views[0].viewportFraction;
59 final right = _rig.views[1].viewportFraction;
60 if (left.x != 0.0 || right.x != 0.5 || left.width != 0.5) {
61 throw StateError(
62 'the left view should fill the left half of the '
63 'frame and the right view the right half',
64 );
65 }
66 }
67}