# exeldro/obs-move-transition architecture

> Architecture diagram of the GitHub repository exeldro/obs-move-transition, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/exeldro/obs-move-transition
- Repository: https://github.com/exeldro/obs-move-transition

## Overview

##### Component Relationships

- Plugin registration flow with OBS Studio
- Filter chain processing
- Resource loading paths
- Event handling between components

##### Specific Implementation Details

Create subdivisions for different filter types:
**Filters:**
- Move Action Filter
- Move DirectShow Filter
- Move Source Filter
- Move Source Swap Filter
- Move Transition Override Filter
- Move Value Filter

##### Build System Integration

A separate section showing:
- CMake build system
- Platform-specific packaging
- Resource bundling

Use these visual elements:
- Blue rectangles for core components
- Green diamonds for filters
- Yellow hexagons for external interfaces
- Solid black lines for runtime dependencies

Key Considerations:

##### Platform Support
- Cross-platform compatibility layers
- Platform-specific components (e.g., DirectShow for Windows)

##### Plugin Architecture
- Plugin's hook points into OBS Studio
- Event flow for transition handling

##### Resource Management
- How effects and localization resources are loaded
- Configuration data flow

- Symbols for different component types
- Platform-specific elements
- Build system relationships
- Version dependencies

Keep the abstraction level focused on the plugin architecture while showing clear integration points with OBS Studio. This will help developers understand both the internal structure and how it fits into the larger OBS ecosystem.

Remember to highlight the transition movement functionality as the core feature, showing how it interacts with OBS's scene and source management systems.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "OBS Studio Integration"
        OBS["OBS Studio API"]
        WebSocket["WebSocket Interface"]:::websocket
        click WebSocket "https://github.com/exeldro/obs-move-transition/blob/master/obs-websocket-api.h"
    end

    subgraph "Move Transition Plugin"
        Core["Move Transition Core"]:::core
        click Core "https://github.com/exeldro/obs-move-transition/blob/master/move-transition.c"

        subgraph "Filter System"
            FilterCore["Filter Core"]:::filter
            click FilterCore "https://github.com/exeldro/obs-move-transition/blob/master/move-filter.c"
            
            ActionFilter["Move Action Filter"]:::filter
            click ActionFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-action-filter.c"
            
            DirectShowFilter["DirectShow Filter"]:::filter
            click DirectShowFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-directshow-filter.cpp"
            
            SourceFilter["Move Source Filter"]:::filter
            click SourceFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-source-filter.c"
            
            SwapFilter["Source Swap Filter"]:::filter
            click SwapFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-source-swap-filter.c"
            
            OverrideFilter["Transition Override Filter"]:::filter
            click OverrideFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-transition-override-filter.c"
            
            ValueFilter["Move Value Filter"]:::filter
            click ValueFilter "https://github.com/exeldro/obs-move-transition/blob/master/move-value-filter.c"
            
            NvidiaFilter["NVIDIA Filter"]:::filter
            click NvidiaFilter "https://github.com/exeldro/obs-move-transition/blob/master/nvidia-move-filter.c"
        end

        subgraph "Core Components"
            Audio["Audio Processing"]:::component
            click Audio "https://github.com/exeldro/obs-move-transition/blob/master/audio-move.c"
            
            Easing["Easing System"]:::component
            click Easing "https://github.com/exeldro/obs-move-transition/blob/master/easing.c"
        end
    end

    subgraph "Resource Management"
        Effects["Effects System"]:::resource
        click Effects "https://github.com/exeldro/obs-move-transition/tree/master/data/effects"
        
        Locale["Localization System"]:::resource
        click Locale "https://github.com/exeldro/obs-move-transition/tree/master/data/locale"
        
        NVarLoad["Resource Loader"]:::resource
        click NVarLoad "https://github.com/exeldro/obs-move-transition/blob/master/nvar-load.h"
    end

    subgraph "Build System"
        CMake["CMake Build System"]:::build
        click CMake "https://github.com/exeldro/obs-move-transition/blob/master/CMakeLists.txt"
        
        CMakeHelpers["Plugin Helpers"]:::build
        click CMakeHelpers "https://github.com/exeldro/obs-move-transition/blob/master/cmake/ObsPluginHelpers.cmake"
    end

    %% Connections
    OBS --> Core
    WebSocket --> Core
    Core --> FilterCore
    FilterCore --> ActionFilter & DirectShowFilter & SourceFilter & SwapFilter & OverrideFilter & ValueFilter & NvidiaFilter
    Core --> Audio
    Core --> Easing
    Core --> Effects
    Core --> Locale
    Core --> NVarLoad
    CMake --> CMakeHelpers

    %% Styles
    classDef core fill:#a8d5ff,stroke:#333
    classDef filter fill:#90EE90,stroke:#333
    classDef component fill:#FFB6C1,stroke:#333
    classDef resource fill:#FFE4B5,stroke:#333
    classDef build fill:#E6E6FA,stroke:#333
    classDef websocket fill:#98FB98,stroke:#333

    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Filters"]:::filter
        L3["Processing Components"]:::component
        L4["Resources"]:::resource
        L5["Build System"]:::build
        L6["External Interfaces"]:::websocket
    end
```
