# ivanmurzak/unity-imageloader architecture

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

- Interactive diagram: https://gitdiagram.com/ivanmurzak/unity-imageloader
- Repository: https://github.com/ivanmurzak/unity-imageloader

## Overview

Unity Image Loader is a Unity runtime package for asynchronously loading sprites and textures from web or local paths, caching results, and delivering them to Unity objects. The documented workflow is to initialize the loader on Unity’s main thread, request an image, then await or consume the returned future; callers can also handle errors, cancellation, and lifecycle events. The README documents memory-before-disk caching and the supported delivery patterns. No source excerpts were provided, so edges below reflect README-documented relationships only; implementation details beyond those statements are not inferred.

Main entry points: [`Unity-Package/Assets/root/Runtime/Future/IFuture.cs`](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/IFuture.cs) (IFuture result), [`Unity-Package/Assets/root/Runtime/ImageLoader.cs`](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.cs) (ImageLoader API), [`Unity-Package/Assets/root/Runtime/ImageLoader.LoadSprite.cs`](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadSprite.cs) (Sprite loading), [`Unity-Package/Assets/root/Runtime/ImageLoader.LoadTexture.cs`](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadTexture.cs) (Texture loading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_loading["Image loading"]
  node_loader["ImageLoader API<br/>[ImageLoader.cs]"]
  node_sprite["Sprite loading"]
  node_texture["Texture loading"]
  node_source["Web or local source"]
  node_settings["Loader settings"]
end

subgraph group_cache["Caching"]
  node_memory[("Memory cache")]
  node_disk[("Disk cache")]
end

subgraph group_future["Future lifecycle"]
  node_future["IFuture result<br/>[IFuture.cs]"]
  node_futureload["Future loading<br/>[Future.Loading.cs]"]
  node_futureweb["Web request"]
  node_cancel["Cancellation"]
end

subgraph group_unity["Unity integration"]
  node_consume["Consume callbacks"]
  node_reference["Texture references<br/>[Reference.cs]"]
  node_unitytargets["Unity image targets"]
end

node_developer(("Unity application"))

node_developer -->|"initializes"| node_loader
node_developer -->|"requests sprite"| node_sprite
node_developer -->|"requests texture"| node_texture
node_sprite -->|"returns future"| node_future
node_texture -->|"returns future"| node_future
node_loader -->|"checks first"| node_memory
node_loader -->|"checks next"| node_disk
node_loader -->|"loads on miss"| node_source
node_future -->|"exposes lifecycle"| node_futureload
node_futureload -->|"loads web data"| node_futureweb
node_future -->|"supports consume"| node_consume
node_consume -->|"sets image"| node_unitytargets
node_future -->|"supports cancellation"| node_cancel
node_developer -->|"manages references"| node_reference
node_developer -->|"configures logging"| node_settings

click node_loader "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.cs"
click node_sprite "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadSprite.cs"
click node_texture "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadTexture.cs"
click node_memory "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Memory.cs"
click node_disk "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Disk.cs"
click node_future "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/IFuture.cs"
click node_futureload "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Future.Loading.cs"
click node_futureweb "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Future.WebRequest.cs"
click node_cancel "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.CancelOn.cs"
click node_consume "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.Consume.cs"
click node_reference "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Reference/Reference.cs"
click node_settings "https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Settings.cs"

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_loader,node_sprite,node_texture,node_source,node_settings toneBlue
class node_memory,node_disk toneAmber
class node_future,node_futureload,node_futureweb,node_cancel toneMint
class node_consume,node_reference,node_unitytargets toneRose
class node_developer toneIndigo
```

## Components

### Image loading

- [ImageLoader API](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.cs`
- [Sprite loading](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadSprite.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.LoadSprite.cs`
- [Texture loading](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.LoadTexture.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.LoadTexture.cs`
- **Web or local source**
- [Loader settings](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Settings.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.Settings.cs`

### Caching

- [Memory cache](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Memory.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Memory.cs`
- [Disk cache](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Disk.cs): `Unity-Package/Assets/root/Runtime/ImageLoader.Cache.Disk.cs`

### Future lifecycle

- [IFuture result](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/IFuture.cs): `Unity-Package/Assets/root/Runtime/Future/IFuture.cs`
- [Future loading](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Future.Loading.cs): `Unity-Package/Assets/root/Runtime/Future/Future.Loading.cs`
- [Web request](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Future.WebRequest.cs): `Unity-Package/Assets/root/Runtime/Future/Future.WebRequest.cs`
- [Cancellation](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.CancelOn.cs): `Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.CancelOn.cs`

### Unity integration

- [Consume callbacks](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.Consume.cs): `Unity-Package/Assets/root/Runtime/Future/Extensions/FutureEx.Consume.cs`
- [Texture references](https://github.com/ivanmurzak/unity-imageloader/blob/main/Unity-Package/Assets/root/Runtime/Reference/Reference.cs): `Unity-Package/Assets/root/Runtime/Reference/Reference.cs`
- **Unity image targets**

### Other components

- **Unity application**

## Connections

- Unity application → ImageLoader API: initializes (evidence: `README.md`)
- Unity application → Sprite loading: requests sprite (evidence: `README.md`)
- Unity application → Texture loading: requests texture (evidence: `README.md`)
- Sprite loading → IFuture result: returns future (evidence: `README.md`)
- Texture loading → IFuture result: returns future (evidence: `README.md`)
- ImageLoader API → Memory cache: checks first (evidence: `README.md`)
- ImageLoader API → Disk cache: checks next (evidence: `README.md`)
- ImageLoader API → Web or local source: loads on miss (evidence: `README.md`)
- IFuture result → Future loading: exposes lifecycle (evidence: `README.md`)
- Future loading → Web request: loads web data (evidence: `README.md`)
- IFuture result → Consume callbacks: supports consume (evidence: `README.md`)
- Consume callbacks → Unity image targets: sets image (evidence: `README.md`)
- IFuture result → Cancellation: supports cancellation (evidence: `README.md`)
- Unity application → Texture references: manages references (evidence: `README.md`)
- Unity application → Loader settings: configures logging (evidence: `README.md`)
