# radicalmedia/php-ffmpeg architecture

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

- Interactive diagram: https://gitdiagram.com/radicalmedia/php-ffmpeg
- Repository: https://github.com/radicalmedia/php-ffmpeg

## Overview

##### Core Components (Main Layer)
- It to two primary components:
- FFMpeg Driver
- FFProbe Driver

##### Media Handling Layer
- AbstractMediaType (base class)
- Connected subclasses:
- Video
- Audio
- Frame
- Gif
- AdvancedMedia
- Concat

##### Filter System (Processing Layer)
- Filters Collection
- Filter categories:
- Video Filters (Resize, Rotate, Watermark, etc.)
- Audio Filters (Resample, Metadata, etc.)
- Frame Filters
- Advanced Filters (Complex filtergraph)

##### Format Handling Layer
- FormatInterface
- Two main branches:
- Video Formats (X264, WebM, WMV, etc.)
- Audio Formats (MP3, AAC, WAV, etc.)

##### Coordinate System
- TimeCode
- Dimension
- Point
- FrameRate
- AspectRatio

##### External Integration
External dependencies:
- FFmpeg Binary
- FFProbe Binary

##### Process Flow
1. Client Code → FFMpeg
2. FFMpeg → Media Objects
3. Media Objects → Filters
4. Media Objects → Formats
5. All Components → FFmpeg Binary

Design Guidelines:

##### Layer Organization
- Components in clear layers
- Top: Client interaction
- Middle: Core processing
- Bottom: External systems

##### Notes
- Configuration options
- Important class relationships
- Key method calls

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Core Components
    FFMpeg["FFMpeg"]:::core
    FFMpegDriver["FFMpeg Driver"]:::core
    FFProbeDriver["FFProbe Driver"]:::core
    
    %% Media Handling
    AbstractMediaType["AbstractMediaType"]:::media
    Video["Video"]:::media
    Audio["Audio"]:::media
    Frame["Frame"]:::media
    Gif["Gif"]:::media
    AdvancedMedia["AdvancedMedia"]:::media
    Concat["Concat"]:::media
    
    %% Filter System
    FiltersCollection["Filters Collection"]:::filter
    VideoFilters["Video Filters"]:::filter
    AudioFilters["Audio Filters"]:::filter
    FrameFilters["Frame Filters"]:::filter
    AdvancedFilters["Advanced Filters"]:::filter
    
    %% Format Handling
    FormatInterface["FormatInterface"]:::format
    VideoFormats["Video Formats"]:::format
    AudioFormats["Audio Formats"]:::format
    
    %% Coordinate System
    subgraph Coordinates
        TimeCode["TimeCode"]:::coordinate
        Dimension["Dimension"]:::coordinate
        Point["Point"]:::coordinate
        FrameRate["FrameRate"]:::coordinate
        AspectRatio["AspectRatio"]:::coordinate
    end
    
    %% External Dependencies
    FFmpegBinary["FFmpeg Binary"]:::external
    FFProbeBinary["FFProbe Binary"]:::external
    
    %% Relationships
    FFMpeg --> FFMpegDriver
    FFMpeg --> FFProbeDriver
    FFMpegDriver --> FFmpegBinary
    FFProbeDriver --> FFProbeBinary
    
    AbstractMediaType --> Video
    AbstractMediaType --> Audio
    AbstractMediaType --> Frame
    AbstractMediaType --> Gif
    AbstractMediaType --> AdvancedMedia
    AbstractMediaType --> Concat
    
    FiltersCollection --> VideoFilters
    FiltersCollection --> AudioFilters
    FiltersCollection --> FrameFilters
    FiltersCollection --> AdvancedFilters
    
    FormatInterface --> VideoFormats
    FormatInterface --> AudioFormats
    
    %% Click Events
    click FFMpeg "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/FFMpeg.php"
    click FFMpegDriver "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Driver/FFMpegDriver.php"
    click FFProbeDriver "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Driver/FFProbeDriver.php"
    click AbstractMediaType "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/AbstractMediaType.php"
    click Video "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/Video.php"
    click Audio "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/Audio.php"
    click Frame "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/Frame.php"
    click Gif "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/Gif.php"
    click AdvancedMedia "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/AdvancedMedia.php"
    click Concat "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Media/Concat.php"
    click FiltersCollection "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Filters/FiltersCollection.php"
    click VideoFilters "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Filters/Video/"
    click AudioFilters "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Filters/Audio/"
    click FrameFilters "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Filters/Frame/"
    click AdvancedFilters "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Filters/AdvancedMedia/"
    click FormatInterface "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Format/FormatInterface.php"
    click VideoFormats "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Format/Video/"
    click AudioFormats "https://github.com/radicalmedia/PHP-FFMpeg/tree/master/src/FFMpeg/Format/Audio/"
    click TimeCode "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Coordinate/TimeCode.php"
    click Dimension "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Coordinate/Dimension.php"
    click Point "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Coordinate/Point.php"
    click FrameRate "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Coordinate/FrameRate.php"
    click AspectRatio "https://github.com/radicalmedia/PHP-FFMpeg/blob/master/src/FFMpeg/Coordinate/AspectRatio.php"
    
    %% Styles
    classDef core fill:#2374ab
    classDef media fill:#48a9a6
    classDef filter fill:#e4572e
    classDef format fill:#9b287b
    classDef coordinate fill:#17bebb
    classDef external fill:#666666,stroke-dasharray: 5 5
    
    %% Legend
    subgraph Legend
        CoreComponent["Core Component"]:::core
        MediaComponent["Media Component"]:::media
        FilterComponent["Filter Component"]:::filter
        FormatComponent["Format Component"]:::format
        CoordinateComponent["Coordinate Component"]:::coordinate
        ExternalComponent["External Dependency"]:::external
    end
```
