# finitesingularity/obs-composite-blur architecture

> Architecture diagram of the GitHub repository finitesingularity/obs-composite-blur, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/finitesingularity/obs-composite-blur
- Repository: https://github.com/finitesingularity/obs-composite-blur

## Overview

Composite Blur is an OBS video-filter plugin: an OBS user configures a source filter, which captures the input, applies a selected blur algorithm and effect, optionally masks the result, and renders it back into OBS. The README documents Gaussian, box, Dual Kawase, pixelate, multiple blur styles, background compositing, and several masks. The filter excerpt shows the render/mask/output sequence and algorithm dependencies; unsampled implementation details are represented only where documented, with uncertain links left dashed.

Main entry points: [`src/obs-composite-blur-filter.c`](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c) (Filter Controller), [`src/blur/gaussian.c`](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/gaussian.c) (Gaussian Blur), [`src/blur/pixelate.c`](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/pixelate.c) (Pixelate), [`src/blur/dual_kawase.c`](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/dual_kawase.c) (Dual Kawase)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_obs["OBS Filter"]
  node_obs["OBS Studio"]
  node_filter["Filter Controller"]
end

subgraph group_blur["Blur Algorithms"]
  node_gaussian["Gaussian Blur<br/>[gaussian.c]"]
  node_box["Box Blur<br/>[box.c]"]
  node_kawase["Dual Kawase<br/>[dual_kawase.c]"]
  node_pixelate["Pixelate<br/>[pixelate.c]"]
  node_temporal["Temporal Blur<br/>[temporal.c]"]
  node_kernel["Gaussian Kernel<br/>[gaussian-kernel.c]"]
end

subgraph group_render["Effects and Compositing"]
  node_styles["Blur Styles"]
  node_composite["Background Composite"]
  node_masks["Mask Processing"]
  node_shader_assets["GPU Shader Effects"]
end

subgraph group_support["Rendering Support"]
  node_utils["OBS Graphics Utilities<br/>[obs-utils.c]"]
  node_locales["Localized Labels"]
end

node_user(("OBS User"))

node_user -->|"configures filter"| node_obs
node_obs -.->|"runs filter"| node_filter
node_filter -->|"dispatches algorithm"| node_gaussian
node_filter -->|"dispatches algorithm"| node_box
node_filter -->|"dispatches algorithm"| node_kawase
node_filter -->|"dispatches algorithm"| node_pixelate
node_filter -->|"dispatches algorithm"| node_temporal
node_gaussian -->|"uses kernel"| node_kernel
node_gaussian -->|"smooths gradients"| node_kawase
node_pixelate -->|"uses rendering"| node_kawase
node_filter -->|"selects blur style"| node_styles
node_filter -.->|"composites background"| node_composite
node_filter -->|"applies mask"| node_masks
node_gaussian -->|"loads effects"| node_shader_assets
node_pixelate -->|"loads effects"| node_shader_assets
node_filter -.->|"uses graphics helpers"| node_utils
node_filter -->|"renders output"| node_obs
node_styles -.->|"labels settings"| node_locales

click node_filter "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c"
click node_gaussian "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/gaussian.c"
click node_box "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/box.c"
click node_kawase "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/dual_kawase.c"
click node_pixelate "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/pixelate.c"
click node_temporal "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/temporal.c"
click node_kernel "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/gaussian-kernel.c"
click node_styles "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c"
click node_composite "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c"
click node_masks "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c"
click node_shader_assets "https://github.com/finitesingularity/obs-composite-blur/tree/main/data/shaders"
click node_utils "https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-utils.c"
click node_locales "https://github.com/finitesingularity/obs-composite-blur/tree/main/data/locale"

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_obs,node_filter,node_user toneBlue
class node_gaussian,node_box,node_kawase,node_pixelate,node_temporal,node_kernel toneAmber
class node_styles,node_composite,node_masks,node_shader_assets toneMint
class node_utils,node_locales toneRose
```

## Components

### OBS Filter

- **OBS Studio**
- [Filter Controller](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c): `src/obs-composite-blur-filter.c`

### Blur Algorithms

- [Gaussian Blur](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/gaussian.c): `src/blur/gaussian.c`
- [Box Blur](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/box.c): `src/blur/box.c`
- [Dual Kawase](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/dual_kawase.c): `src/blur/dual_kawase.c`
- [Pixelate](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/pixelate.c): `src/blur/pixelate.c`
- [Temporal Blur](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/temporal.c): `src/blur/temporal.c`
- [Gaussian Kernel](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/blur/gaussian-kernel.c): `src/blur/gaussian-kernel.c`

### Effects and Compositing

- [Blur Styles](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c): `src/obs-composite-blur-filter.c`
- [Background Composite](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c): `src/obs-composite-blur-filter.c`
- [Mask Processing](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-composite-blur-filter.c): `src/obs-composite-blur-filter.c`
- [GPU Shader Effects](https://github.com/finitesingularity/obs-composite-blur/tree/main/data/shaders): `data/shaders`

### Rendering Support

- [OBS Graphics Utilities](https://github.com/finitesingularity/obs-composite-blur/blob/main/src/obs-utils.c): `src/obs-utils.c`
- [Localized Labels](https://github.com/finitesingularity/obs-composite-blur/tree/main/data/locale): `data/locale`

### Other components

- **OBS User**

## Connections

- OBS User → OBS Studio: configures filter (evidence: `README.md`)
- OBS Studio → Filter Controller: runs filter
- Filter Controller → Gaussian Blur: dispatches algorithm (evidence: `src/obs-composite-blur-filter.c`)
- Filter Controller → Box Blur: dispatches algorithm (evidence: `src/obs-composite-blur-filter.c`)
- Filter Controller → Dual Kawase: dispatches algorithm (evidence: `src/obs-composite-blur-filter.c`)
- Filter Controller → Pixelate: dispatches algorithm (evidence: `src/obs-composite-blur-filter.c`)
- Filter Controller → Temporal Blur: dispatches algorithm (evidence: `src/obs-composite-blur-filter.c`)
- Gaussian Blur → Gaussian Kernel: uses kernel
- Gaussian Blur → Dual Kawase: smooths gradients (evidence: `src/blur/gaussian.c`)
- Pixelate → Dual Kawase: uses rendering (evidence: `src/blur/pixelate.c`)
- Filter Controller → Blur Styles: selects blur style (evidence: `README.md`)
- Filter Controller → Background Composite: composites background (evidence: `src/obs-composite-blur-filter.c`)
- Filter Controller → Mask Processing: applies mask (evidence: `src/obs-composite-blur-filter.c`)
- Gaussian Blur → GPU Shader Effects: loads effects (evidence: `src/blur/gaussian.c`)
- Pixelate → GPU Shader Effects: loads effects (evidence: `src/blur/pixelate.c`)
- Filter Controller → OBS Graphics Utilities: uses graphics helpers
- Filter Controller → OBS Studio: renders output (evidence: `src/obs-composite-blur-filter.c`)
- Blur Styles → Localized Labels: labels settings
