# blender/cycles architecture

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

- Interactive diagram: https://gitdiagram.com/blender/cycles
- Repository: https://github.com/blender/cycles

## Overview

Cycles is a path-tracing renderer exposed through a standalone XML application and a Hydra render delegate. A user or host supplies a scene; the interface builds or synchronizes a Scene, Session configures devices and scheduling, and PathTrace dispatches kernels that traverse acceleration structures, evaluate shaders, accumulate film passes, optionally denoise, and deliver display or image output. The tree shows CPU/GPU backends, OSL, BVH, Hydra, and optional production integrations; several backend and output links are therefore represented at subsystem level.

Main entry points: [`src/scene/scene.cpp`](https://github.com/blender/cycles/blob/main/src/scene/scene.cpp) (Scene Model), [`src/session/session.cpp`](https://github.com/blender/cycles/blob/main/src/session/session.cpp) (Render Session), [`src/session/buffers.cpp`](https://github.com/blender/cycles/blob/main/src/session/buffers.cpp) (Render Buffers), [`src/kernel/integrator`](https://github.com/blender/cycles/tree/main/src/kernel/integrator) (Kernel Integrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Interfaces"]
  node_standalone_app["Standalone App"]
  node_xml_loader["XML Loader<br/>[cycles_xml.cpp]"]
  node_hydra_delegate["Hydra Delegate"]
  node_hydra_session["Hydra Session<br/>[session.cpp]"]
end

subgraph group_scene["Scene and Shading"]
  node_scene_model["Scene Model<br/>[scene.cpp]"]
  node_shader_graph["Shader Graph<br/>[shader_graph.cpp]"]
  node_shader_compile["Shader Compilation<br/>[shader_nodes.cpp]"]
  node_image_manager[("Image Manager")]
  node_bvh_builder["BVH Builder<br/>[geometry_bvh.cpp]"]
end

subgraph group_orchestration["Render Orchestration"]
  node_session["Render Session<br/>[session.cpp]"]
  node_scheduler["Render Scheduler"]
  node_path_trace["Path Tracer<br/>[path_trace.cpp]"]
  node_buffers[("Render Buffers<br/>[buffers.cpp]")]
end

subgraph group_execution["Execution Kernels"]
  node_device_api["Device API<br/>[device.cpp]"]
  node_backend_devices["Backend Devices"]
  node_kernel_integrator["Kernel Integrator"]
  node_kernel_bvh["Kernel BVH"]
  node_kernel_shading["Kernel Shading"]
  node_film_passes["Film Passes"]
  node_osl_services["OSL Services<br/>[services.cpp]"]
end

subgraph group_output["Output Integrations"]
  node_denoiser["Denoiser<br/>[denoiser.cpp]"]
  node_display_output["Display Output<br/>[display_driver.cpp]"]
  node_image_output["Image Output"]
end

node_cli_user(("Renderer User"))
node_xml_scene["XML Scene"]
node_hydra_host(("Hydra Host"))
node_image_file["Rendered Image"]
node_oidn["OpenImageDenoise"]
node_embree["Embree"]

node_cli_user -->|"starts render"| node_standalone_app
node_xml_scene -->|"provides scene"| node_xml_loader
node_standalone_app -->|"loads XML"| node_xml_loader
node_xml_loader -->|"builds scene"| node_scene_model
node_hydra_host -->|"uses delegate"| node_hydra_delegate
node_hydra_delegate -->|"creates session"| node_hydra_session
node_hydra_session -->|"syncs scene"| node_scene_model
node_hydra_session -->|"configures AOVs"| node_film_passes
node_scene_model -->|"stores shaders"| node_shader_graph
node_shader_graph -->|"compiles graph"| node_shader_compile
node_shader_compile -->|"emits SVM"| node_kernel_shading
node_shader_compile -.->|"supports OSL"| node_osl_services
node_scene_model -->|"manages images"| node_image_manager
node_scene_model -->|"builds geometry"| node_bvh_builder
node_session -->|"creates scene"| node_scene_model
node_session -->|"creates device"| node_device_api
node_session -->|"runs tracing"| node_path_trace
node_session -->|"requests work"| node_scheduler
node_path_trace -->|"dispatches kernels"| node_device_api
node_device_api -->|"selects backend"| node_backend_devices
node_path_trace -->|"updates buffers"| node_buffers
node_kernel_integrator -->|"traverses rays"| node_kernel_bvh
node_kernel_integrator -->|"evaluates shaders"| node_kernel_shading
node_kernel_integrator -->|"writes passes"| node_film_passes
node_bvh_builder -.->|"uses acceleration"| node_embree
node_buffers -->|"denoises pixels"| node_denoiser
node_denoiser -.->|"uses denoiser"| node_oidn
node_buffers -->|"updates display"| node_display_output
node_buffers -->|"writes image"| node_image_output
node_image_output -->|"exports image"| node_image_file

click node_standalone_app "https://github.com/blender/cycles/blob/main/src/app/cycles_standalone.cpp"
click node_xml_loader "https://github.com/blender/cycles/blob/main/src/app/cycles_xml.cpp"
click node_hydra_delegate "https://github.com/blender/cycles/blob/main/src/hydra/render_delegate.cpp"
click node_hydra_session "https://github.com/blender/cycles/blob/main/src/hydra/session.cpp"
click node_scene_model "https://github.com/blender/cycles/blob/main/src/scene/scene.cpp"
click node_shader_graph "https://github.com/blender/cycles/blob/main/src/scene/shader_graph.cpp"
click node_shader_compile "https://github.com/blender/cycles/blob/main/src/scene/shader_nodes.cpp"
click node_bvh_builder "https://github.com/blender/cycles/blob/main/src/scene/geometry_bvh.cpp"
click node_session "https://github.com/blender/cycles/blob/main/src/session/session.cpp"
click node_scheduler "https://github.com/blender/cycles/blob/main/src/integrator/render_scheduler.cpp"
click node_path_trace "https://github.com/blender/cycles/blob/main/src/integrator/path_trace.cpp"
click node_buffers "https://github.com/blender/cycles/blob/main/src/session/buffers.cpp"
click node_device_api "https://github.com/blender/cycles/blob/main/src/device/device.cpp"
click node_backend_devices "https://github.com/blender/cycles/tree/main/src/device"
click node_kernel_integrator "https://github.com/blender/cycles/tree/main/src/kernel/integrator"
click node_kernel_bvh "https://github.com/blender/cycles/tree/main/src/kernel/bvh"
click node_kernel_shading "https://github.com/blender/cycles/tree/main/src/kernel/svm"
click node_film_passes "https://github.com/blender/cycles/tree/main/src/kernel/film"
click node_osl_services "https://github.com/blender/cycles/blob/main/src/kernel/osl/services.cpp"
click node_denoiser "https://github.com/blender/cycles/blob/main/src/integrator/denoiser.cpp"
click node_display_output "https://github.com/blender/cycles/blob/main/src/session/display_driver.cpp"
click node_image_output "https://github.com/blender/cycles/blob/main/src/app/oiio_output_driver.cpp"

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_standalone_app,node_xml_loader,node_hydra_delegate,node_hydra_session,node_cli_user toneBlue
class node_scene_model,node_shader_graph,node_shader_compile,node_image_manager,node_bvh_builder toneAmber
class node_session,node_scheduler,node_path_trace,node_buffers toneMint
class node_device_api,node_backend_devices,node_kernel_integrator,node_kernel_bvh,node_kernel_shading,node_film_passes,node_osl_services toneRose
class node_denoiser,node_display_output,node_image_output,node_xml_scene,node_hydra_host,node_image_file,node_oidn,node_embree toneIndigo
```

## Components

### Interfaces

- [Standalone App](https://github.com/blender/cycles/blob/main/src/app/cycles_standalone.cpp): `src/app/cycles_standalone.cpp`
- [XML Loader](https://github.com/blender/cycles/blob/main/src/app/cycles_xml.cpp): `src/app/cycles_xml.cpp`
- [Hydra Delegate](https://github.com/blender/cycles/blob/main/src/hydra/render_delegate.cpp): `src/hydra/render_delegate.cpp`
- [Hydra Session](https://github.com/blender/cycles/blob/main/src/hydra/session.cpp): `src/hydra/session.cpp`

### Scene and Shading

- [Scene Model](https://github.com/blender/cycles/blob/main/src/scene/scene.cpp): `src/scene/scene.cpp`
- [Shader Graph](https://github.com/blender/cycles/blob/main/src/scene/shader_graph.cpp): `src/scene/shader_graph.cpp`
- [Shader Compilation](https://github.com/blender/cycles/blob/main/src/scene/shader_nodes.cpp): `src/scene/shader_nodes.cpp`
- **Image Manager**
- [BVH Builder](https://github.com/blender/cycles/blob/main/src/scene/geometry_bvh.cpp): `src/scene/geometry_bvh.cpp`

### Render Orchestration

- [Render Session](https://github.com/blender/cycles/blob/main/src/session/session.cpp): `src/session/session.cpp`
- [Render Scheduler](https://github.com/blender/cycles/blob/main/src/integrator/render_scheduler.cpp): `src/integrator/render_scheduler.cpp`
- [Path Tracer](https://github.com/blender/cycles/blob/main/src/integrator/path_trace.cpp): `src/integrator/path_trace.cpp`
- [Render Buffers](https://github.com/blender/cycles/blob/main/src/session/buffers.cpp): `src/session/buffers.cpp`

### Execution Kernels

- [Device API](https://github.com/blender/cycles/blob/main/src/device/device.cpp): `src/device/device.cpp`
- [Backend Devices](https://github.com/blender/cycles/tree/main/src/device): `src/device`
- [Kernel Integrator](https://github.com/blender/cycles/tree/main/src/kernel/integrator): `src/kernel/integrator`
- [Kernel BVH](https://github.com/blender/cycles/tree/main/src/kernel/bvh): `src/kernel/bvh`
- [Kernel Shading](https://github.com/blender/cycles/tree/main/src/kernel/svm): `src/kernel/svm`
- [Film Passes](https://github.com/blender/cycles/tree/main/src/kernel/film): `src/kernel/film`
- [OSL Services](https://github.com/blender/cycles/blob/main/src/kernel/osl/services.cpp): `src/kernel/osl/services.cpp`

### Output Integrations

- [Denoiser](https://github.com/blender/cycles/blob/main/src/integrator/denoiser.cpp): `src/integrator/denoiser.cpp`
- [Display Output](https://github.com/blender/cycles/blob/main/src/session/display_driver.cpp): `src/session/display_driver.cpp`
- [Image Output](https://github.com/blender/cycles/blob/main/src/app/oiio_output_driver.cpp): `src/app/oiio_output_driver.cpp`

### Other components

- **Renderer User**
- **XML Scene**
- **Hydra Host**
- **Rendered Image**
- **OpenImageDenoise**
- **Embree**

## Connections

- Renderer User → Standalone App: starts render
- XML Scene → XML Loader: provides scene
- Standalone App → XML Loader: loads XML
- XML Loader → Scene Model: builds scene
- Hydra Host → Hydra Delegate: uses delegate
- Hydra Delegate → Hydra Session: creates session
- Hydra Session → Scene Model: syncs scene
- Hydra Session → Film Passes: configures AOVs
- Scene Model → Shader Graph: stores shaders
- Shader Graph → Shader Compilation: compiles graph
- Shader Compilation → Kernel Shading: emits SVM
- Shader Compilation → OSL Services: supports OSL
- Scene Model → Image Manager: manages images
- Scene Model → BVH Builder: builds geometry
- Render Session → Scene Model: creates scene
- Render Session → Device API: creates device
- Render Session → Path Tracer: runs tracing
- Render Session → Render Scheduler: requests work
- Path Tracer → Device API: dispatches kernels
- Device API → Backend Devices: selects backend
- Path Tracer → Render Buffers: updates buffers
- Kernel Integrator → Kernel BVH: traverses rays
- Kernel Integrator → Kernel Shading: evaluates shaders
- Kernel Integrator → Film Passes: writes passes
- BVH Builder → Embree: uses acceleration
- Render Buffers → Denoiser: denoises pixels
- Denoiser → OpenImageDenoise: uses denoiser
- Render Buffers → Display Output: updates display
- Render Buffers → Image Output: writes image
- Image Output → Rendered Image: exports image
