recipes

SceneViewSwift recipes — pointers to verified demos

**Do not improvise.** Every pattern below has a matching SwiftUI demo file in `samples/ios-demo/SceneViewDemo/Views/Demos/`. Read that file before writing code — the demo is the authoritative recipe.

1. Model viewer (3D, USDZ/GLB)

[`ModelViewerDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/ModelViewerDemo.swift) — `ModelNode.load(...)` in `.task { }`, stored in `@State`, added to the `SceneView` root.

2. All built-in shapes

[`AllShapesDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/AllShapesDemo.swift) — `GeometryNode.cube / .sphere / .cylinder / .plane / .cone / .torus / .capsule`.

3. Camera controls (orbit / pan / native Apple modes)

[`CameraControlsDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/CameraControlsDemo.swift) — `.cameraControls(.orbit)` modifier; native Apple modes (`.none`, `.tilt`, `.dolly`) available on iOS 18+ via `realityViewCameraControls(_:)`, unavailable on visionOS.

4. Auto-rotate turntable

[`AnimationDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/AnimationDemo.swift) — `.autoRotate(speed:)` modifier.

5. Light types

[`LightTypesDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/LightTypesDemo.swift) — `LightNode.directional / .point / .spot`.

6. Studio light rig

[`LightTypesDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/LightTypesDemo.swift) (Studio rig) — key, fill and rim `LightNode`s with live angle, intensity and colour.

7. Materials (PBR)

[`MaterialsDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/MaterialsDemo.swift) — `material: .pbr(color:metallic:roughness:)` / `.textured(...)` on geometry.

8. Animation

[`AnimationDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/AnimationDemo.swift) — `model.playAllAnimations()` / `playAnimation(at:)`.

9. Multi-model scene

[`MultiModelDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/MultiModelDemo.swift) — several `ModelNode`s in one `SceneView`.

10. 3D text

[`TextDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/TextDemo.swift) — `TextNode(text:fontSize:color:depth:)`.

11. Billboard

[`BillboardDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/BillboardDemo.swift) — `BillboardNode` always faces the camera.

12. Lines and paths

[`LinesPathsDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/LinesPathsDemo.swift) — `LineNode` / `PathNode` from `SIMD3<Float>` points.

13. Custom mesh

[`CustomMeshDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/CustomMeshDemo.swift) — composing built-in geometry into a custom shape.

14. Physics

[`ArDepthColliderScene.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/Scenes/ArDepthColliderScene.swift) — `PhysicsNode.dynamic / .static / .kinematic`. [`RollingBallsDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/RollingBallsDemo.swift) and [`DoublePendulumDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/DoublePendulumDemo.swift) — a fixed-step simulation that moves plain entities every frame, for a result that is identical on Android.

15. Dynamic sky

[`LightTypesDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/LightTypesDemo.swift) (Sun rig) — `DynamicSkyNode`: the hour drives the sun's colour and angle.

16. Image plane

[`ImagePlaneDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/ImagePlaneDemo.swift) — `ImageNode.load("img.png")`.

AR recipes (iOS only)

17. AR tap-to-place

[`ARPlacementDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/ARPlacementDemo.swift) — `ARSceneView(planeDetection:onTapOnPlane:)` + `AnchorNode.world(position:)`.

18. AR instant placement

[`ARInstantPlacementDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/ARInstantPlacementDemo.swift) — estimated-plane raycasts for immediate placement.

19. AR lighting

[`ARLightingDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/ARLightingDemo.swift) — `.mainLight(_:)` / `.fillLight(_:)` on `ARSceneView`.

20. AR recorder (record-only)

[`DemoScreenRecording.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Components/DemoScreenRecording.swift) (the Record action of every demo's sheet) — `ARRecorder` via ReplayKit. `startRecording()` / `stopRecording()`, `ARRecorder.saveToPhotoLibrary(_:)`. No deterministic playback on iOS.

21. AR debugging (Rerun)

[`RerunLiveCaptureView.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/Rerun/RerunLiveCaptureView.swift) — record AR frame data via `ARSceneView.onFrame`, replay it in 3D and export it to `.rrd` ([`RerunShowcaseDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/Rerun/RerunShowcaseDemo.swift)).

22. Collision & hit testing

[`CollisionHitTestDemo.swift`](https://github.com/sceneview/sceneview/blob/main/samples/ios-demo/SceneViewDemo/Views/Demos/CollisionHitTestDemo.