SceneView class Widgets

A widget that renders a Scene and drives its per-frame repaint.

This is the supported way to display a scene: it owns the frame ticker and the CustomPaint that calls Scene.render, so applications do not write their own CustomPainter. The scene is app-owned and mutated imperatively over time (attach and detach Nodes, swap materials); SceneView is a view onto it, not the owner of its contents.

Provide the camera either as a fixed camera or, for a camera that changes over time, a cameraBuilder that receives the elapsed time each frame.

SceneView(
  scene,
  cameraBuilder: (elapsed) {
    final t = elapsed.inMicroseconds / 1e6;
    return PerspectiveCamera(
      position: Vector3(sin(t) * 5, 2, cos(t) * 5),
      target: Vector3.zero(),
    );
  },
)

Place SceneView where it receives bounded constraints (for example inside a SizedBox.expand or an Expanded); it fills the space it is given.

The active scene is exposed to descendants through SceneScope, so widgets below can resolve the scene from their BuildContext.

For a fully declarative scene, use SceneView.declarative: the view owns an internal Scene and declarative scene widgets (SceneNode, SceneMesh, SceneModel) describe its contents in children. Both constructors accept children, so declarative subtrees also compose over an app-owned scene.