# sceneview/sceneform-android architecture

> Architecture diagram of the GitHub repository sceneview/sceneform-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sceneview/sceneform-android
- Repository: https://github.com/sceneview/sceneform-android

## Overview

Sceneform Maintained is an Android ARCore SDK with Filament-based 3D rendering. In the documented viewer workflow, an app configures an AR fragment to load a glTF/GLB model; the user taps a detected plane, and the app places an anchored, transformable model in the scene. Sceneform also provides image and face augmentation, animation, video nodes, environment lighting, and depth-related capabilities. The graph combines README-documented behavior with source-index relationships; several capability implementations were not sampled, so their internal links are omitted.

Main entry points: [`ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java`](https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java) (AR Fragment), [`core/src/main/java/com/google/ar/sceneform/Node.java`](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/Node.java) (Scene Graph), [`core/src/main/java/com/google/ar/sceneform/rendering/Renderer.java`](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/Renderer.java) (Scene Renderer), [`core/src/main/java/com/google/ar/sceneform/ArSceneView.java`](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/ArSceneView.java) (AR Scene View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ar["AR Session"]
  node_fragment["AR Fragment"]
  node_arview["AR Scene View<br/>[ArSceneView.java]"]
  node_arcore["ARCore Session"]
  node_track["Image And Face Tracking"]
  node_plane["Plane Detection<br/>[Plane.java]"]
end

subgraph group_scene["Scene Interaction"]
  node_scenegraph["Scene Graph<br/>[Node.java]"]
  node_anchor["Anchor Placement<br/>[AnchorNode.java]"]
  node_transform["Gesture Transform"]
  node_controllers["Transform Controllers"]
end

subgraph group_render["Rendering Assets"]
  node_model["Model Loading"]
  node_renderable["Renderable Instance"]
  node_renderer["Scene Renderer<br/>[Renderer.java]"]
  node_filament["Filament Engine"]
  node_materials["Materials And Textures<br/>[Material.java]"]
  node_environment["HDR KTX Environment"]
  node_animation["Model Animation"]
  node_video["Video Node<br/>[VideoNode.java]"]
end

subgraph group_support["Runtime Support"]
  node_math["3D Math<br/>[Vector3.java]"]
  node_resources["Resource Lifecycle"]
end

node_app(("Android App"))

node_app -->|"configures"| node_fragment
node_fragment -->|"hosts"| node_arview
node_arview -.->|"updates from"| node_arcore
node_arcore -->|"detects planes"| node_plane
node_arcore -->|"tracks targets"| node_track
node_fragment -->|"loads model"| node_model
node_fragment -->|"adds scene content"| node_scenegraph
node_fragment -->|"places anchor"| node_anchor
node_anchor -->|"parents nodes"| node_scenegraph
node_scenegraph -->|"hosts model node"| node_transform
node_transform -->|"uses gestures"| node_controllers
node_controllers -->|"tests placement"| node_plane
node_model -.->|"creates instance"| node_renderable
node_arview -.->|"renders scene"| node_renderer
node_renderer -->|"uses engine"| node_filament
node_renderable -.->|"uses materials"| node_materials
node_renderer -->|"uses lighting"| node_environment
node_renderable -->|"animates"| node_animation
node_scenegraph -->|"can host"| node_video
node_renderer -.->|"manages resources"| node_resources
node_scenegraph -.->|"uses transforms"| node_math

click node_fragment "https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java"
click node_arview "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/ArSceneView.java"
click node_track "https://github.com/sceneview/sceneform-android/tree/master/core/src/main/java/com/google/ar/sceneform"
click node_scenegraph "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/Node.java"
click node_anchor "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/AnchorNode.java"
click node_transform "https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformableNode.java"
click node_controllers "https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformationController.java"
click node_plane "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/collision/Plane.java"
click node_model "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/ModelRenderable.java"
click node_renderable "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/RenderableInstance.java"
click node_renderer "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/Renderer.java"
click node_filament "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/FilamentEngineWrapper.java"
click node_materials "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/Material.java"
click node_environment "https://github.com/sceneview/sceneform-android/tree/master/core/src/main/java/com/gorisse/thomas/sceneform/environment"
click node_animation "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/animation/ModelAnimation.java"
click node_video "https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/VideoNode.java"
click node_math "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/math/Vector3.java"
click node_resources "https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/ResourceManager.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_fragment,node_arview,node_arcore,node_track,node_plane toneBlue
class node_scenegraph,node_anchor,node_transform,node_controllers toneAmber
class node_model,node_renderable,node_renderer,node_filament,node_materials,node_environment,node_animation,node_video toneMint
class node_math,node_resources toneRose
class node_app toneIndigo
```

## Components

### AR Session

- [AR Fragment](https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java): `ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java`
- [AR Scene View](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/ArSceneView.java): `core/src/main/java/com/google/ar/sceneform/ArSceneView.java`
- **ARCore Session**
- [Image And Face Tracking](https://github.com/sceneview/sceneform-android/tree/master/core/src/main/java/com/google/ar/sceneform): `core/src/main/java/com/google/ar/sceneform`
- [Plane Detection](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/collision/Plane.java): `core/src/main/java/com/google/ar/sceneform/collision/Plane.java`

### Scene Interaction

- [Scene Graph](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/Node.java): `core/src/main/java/com/google/ar/sceneform/Node.java`
- [Anchor Placement](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/AnchorNode.java): `core/src/main/java/com/google/ar/sceneform/AnchorNode.java`
- [Gesture Transform](https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformableNode.java): `ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformableNode.java`
- [Transform Controllers](https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformationController.java): `ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformationController.java`

### Rendering Assets

- [Model Loading](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/ModelRenderable.java): `core/src/main/java/com/google/ar/sceneform/rendering/ModelRenderable.java`
- [Renderable Instance](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/RenderableInstance.java): `core/src/main/java/com/google/ar/sceneform/rendering/RenderableInstance.java`
- [Scene Renderer](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/Renderer.java): `core/src/main/java/com/google/ar/sceneform/rendering/Renderer.java`
- [Filament Engine](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/FilamentEngineWrapper.java): `core/src/main/java/com/google/ar/sceneform/rendering/FilamentEngineWrapper.java`
- [Materials And Textures](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/Material.java): `core/src/main/java/com/google/ar/sceneform/rendering/Material.java`
- [HDR KTX Environment](https://github.com/sceneview/sceneform-android/tree/master/core/src/main/java/com/gorisse/thomas/sceneform/environment): `core/src/main/java/com/gorisse/thomas/sceneform/environment`
- [Model Animation](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/animation/ModelAnimation.java): `core/src/main/java/com/google/ar/sceneform/animation/ModelAnimation.java`
- [Video Node](https://github.com/sceneview/sceneform-android/blob/master/ux/src/main/java/com/google/ar/sceneform/ux/VideoNode.java): `ux/src/main/java/com/google/ar/sceneform/ux/VideoNode.java`

### Runtime Support

- [3D Math](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/math/Vector3.java): `core/src/main/java/com/google/ar/sceneform/math/Vector3.java`
- [Resource Lifecycle](https://github.com/sceneview/sceneform-android/blob/master/core/src/main/java/com/google/ar/sceneform/rendering/ResourceManager.java): `core/src/main/java/com/google/ar/sceneform/rendering/ResourceManager.java`

### Other components

- **Android App**

## Connections

- Android App → AR Fragment: configures
- AR Fragment → AR Scene View: hosts (evidence: `ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java`)
- AR Scene View → ARCore Session: updates from
- ARCore Session → Plane Detection: detects planes
- ARCore Session → Image And Face Tracking: tracks targets
- AR Fragment → Model Loading: loads model (evidence: `ux/src/main/java/com/google/ar/sceneform/ux/BaseArFragment.java`)
- AR Fragment → Scene Graph: adds scene content
- AR Fragment → Anchor Placement: places anchor
- Anchor Placement → Scene Graph: parents nodes (evidence: `core/src/main/java/com/google/ar/sceneform/AnchorNode.java`)
- Scene Graph → Gesture Transform: hosts model node (evidence: `ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformableNode.java`)
- Gesture Transform → Transform Controllers: uses gestures (evidence: `ux/src/main/java/com/google/ar/sceneform/ux/BaseTransformationController.java`)
- Transform Controllers → Plane Detection: tests placement (evidence: `ux/src/main/java/com/google/ar/sceneform/ux/TranslationController.java`)
- Model Loading → Renderable Instance: creates instance
- AR Scene View → Scene Renderer: renders scene (evidence: `core/src/main/java/com/google/ar/sceneform/ArSceneView.java`)
- Scene Renderer → Filament Engine: uses engine (evidence: `core/src/main/java/com/google/ar/sceneform/rendering/FilamentEngineWrapper.java`)
- Renderable Instance → Materials And Textures: uses materials (evidence: `core/src/main/java/com/google/ar/sceneform/rendering/RenderableInstance.java`)
- Scene Renderer → HDR KTX Environment: uses lighting
- Renderable Instance → Model Animation: animates (evidence: `core/src/main/java/com/google/ar/sceneform/rendering/RenderableInstance.java`)
- Scene Graph → Video Node: can host
- Scene Renderer → Resource Lifecycle: manages resources
- Scene Graph → 3D Math: uses transforms (evidence: `core/src/main/java/com/google/ar/sceneform/Node.java`)
