# efprefix/efqrcode architecture

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

- Interactive diagram: https://gitdiagram.com/efprefix/efqrcode
- Repository: https://github.com/efprefix/efqrcode

## Overview

EFQRCode is a cross-platform Swift library for generating customized QR code images and recognizing QR codes in images. The principal flow is application input to the generator, which applies a selected style and returns image or document data; recognition accepts an image and returns decoded contents. The README also documents animated-image and video export. Source excerpts are partial, so some implementation links—especially the generator’s internal QR encoding and export internals—are not shown and are omitted rather than inferred.

Main entry points: [`Source/EFQRCode+Generator.swift`](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BGenerator.swift) (Generator), [`Source/Styles`](https://github.com/efprefix/efqrcode/tree/main/Source/Styles) (Style Renderers), [`Source/EFQRCode.swift`](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode.swift) (EFQRCode API), [`Source/EFQRCode+Recognizer.swift`](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BRecognizer.swift) (Recognizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Library API"]
  node_api["EFQRCode API<br/>[EFQRCode.swift]"]
end

subgraph group_generation["QR Generation"]
  node_generator["Generator"]
  node_styles["Style Renderers"]
  node_basic["Basic Style"]
  node_image["Image Styles"]
  node_line["Line Style"]
  node_resample["Resample Style"]
end

subgraph group_recognition["QR Recognition"]
  node_recognizer["Recognizer"]
end

subgraph group_types["Formats and Types"]
  node_image_modes["Image Modes<br/>[EFImageMode.swift]"]
  node_edge_insets["Edge Insets<br/>[EFEdgeInsets.swift]"]
  node_correction["Correction Levels"]
  node_image_formats["Animated Formats"]
  node_video_formats["Video Formats"]
  node_errors["Error Types"]
  node_utils["Shared Utilities<br/>[Utils.swift]"]
end

node_app(("Application"))
node_result["QR Output"]
node_input_image["Source Image"]
node_decoded["Decoded Contents"]

node_app -->|"uses"| node_api
node_api -.->|"creates"| node_generator
node_api -->|"creates"| node_recognizer
node_generator -->|"applies style"| node_styles
node_styles -->|"uses base"| node_basic
node_styles -->|"renders image style"| node_image
node_styles -->|"renders line style"| node_line
node_styles -->|"renders resample style"| node_resample
node_generator -->|"accepts level"| node_correction
node_generator -->|"uses insets"| node_edge_insets
node_generator -->|"exports animation"| node_image_formats
node_generator -->|"exports video"| node_video_formats
node_generator -->|"throws errors"| node_errors
node_image -->|"positions images"| node_image_modes
node_resample -->|"positions images"| node_image_modes
node_generator -->|"exports QR data"| node_result
node_app -->|"provides image"| node_input_image
node_input_image -->|"recognizes codes"| node_recognizer
node_recognizer -->|"returns contents"| node_decoded

click node_api "https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode.swift"
click node_generator "https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BGenerator.swift"
click node_styles "https://github.com/efprefix/efqrcode/tree/main/Source/Styles"
click node_basic "https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleBasic.swift"
click node_image "https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleImage.swift"
click node_line "https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleLine.swift"
click node_resample "https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleResampleImage.swift"
click node_recognizer "https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BRecognizer.swift"
click node_image_modes "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFImageMode.swift"
click node_edge_insets "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFEdgeInsets.swift"
click node_correction "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFCorrectionLevel.swift"
click node_image_formats "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFAnimatedImageFormat.swift"
click node_video_formats "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFVideoFormat.swift"
click node_errors "https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFQRCodeError.swift"
click node_utils "https://github.com/efprefix/efqrcode/blob/main/Source/Utils/Utils.swift"

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_api toneBlue
class node_generator,node_styles,node_basic,node_image,node_line,node_resample toneAmber
class node_recognizer toneMint
class node_image_modes,node_edge_insets,node_correction,node_image_formats,node_video_formats,node_errors,node_utils toneRose
class node_app,node_result,node_input_image,node_decoded toneIndigo
```

## Components

### Library API

- [EFQRCode API](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode.swift): `Source/EFQRCode.swift`

### QR Generation

- [Generator](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BGenerator.swift): `Source/EFQRCode+Generator.swift`
- [Style Renderers](https://github.com/efprefix/efqrcode/tree/main/Source/Styles): `Source/Styles`
- [Basic Style](https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleBasic.swift): `Source/Styles/EFQRCodeStyleBasic.swift`
- [Image Styles](https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleImage.swift): `Source/Styles/EFQRCodeStyleImage.swift`
- [Line Style](https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleLine.swift): `Source/Styles/EFQRCodeStyleLine.swift`
- [Resample Style](https://github.com/efprefix/efqrcode/blob/main/Source/Styles/EFQRCodeStyleResampleImage.swift): `Source/Styles/EFQRCodeStyleResampleImage.swift`

### QR Recognition

- [Recognizer](https://github.com/efprefix/efqrcode/blob/main/Source/EFQRCode%2BRecognizer.swift): `Source/EFQRCode+Recognizer.swift`

### Formats and Types

- [Image Modes](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFImageMode.swift): `Source/Type/EFImageMode.swift`
- [Edge Insets](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFEdgeInsets.swift): `Source/Type/EFEdgeInsets.swift`
- [Correction Levels](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFCorrectionLevel.swift): `Source/Type/EFCorrectionLevel.swift`
- [Animated Formats](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFAnimatedImageFormat.swift): `Source/Type/EFAnimatedImageFormat.swift`
- [Video Formats](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFVideoFormat.swift): `Source/Type/EFVideoFormat.swift`
- [Error Types](https://github.com/efprefix/efqrcode/blob/main/Source/Type/EFQRCodeError.swift): `Source/Type/EFQRCodeError.swift`
- [Shared Utilities](https://github.com/efprefix/efqrcode/blob/main/Source/Utils/Utils.swift): `Source/Utils/Utils.swift`

### Other components

- **Application**
- **QR Output**
- **Source Image**
- **Decoded Contents**

## Connections

- Application → EFQRCode API: uses (evidence: `README.md`)
- EFQRCode API → Generator: creates (evidence: `Source/EFQRCode+Generator.swift`)
- EFQRCode API → Recognizer: creates (evidence: `README.md`)
- Generator → Style Renderers: applies style (evidence: `Source/EFQRCode+Generator.swift`)
- Style Renderers → Basic Style: uses base (evidence: `Source/Styles/EFQRCodeStyle.swift`)
- Style Renderers → Image Styles: renders image style (evidence: `Source/Styles/EFQRCodeStyle.swift`)
- Style Renderers → Line Style: renders line style (evidence: `Source/Styles/EFQRCodeStyle.swift`)
- Style Renderers → Resample Style: renders resample style (evidence: `Source/Styles/EFQRCodeStyle.swift`)
- Generator → Correction Levels: accepts level (evidence: `Source/EFQRCode+Generator.swift`)
- Generator → Edge Insets: uses insets (evidence: `Source/EFQRCode+Generator.swift`)
- Generator → Animated Formats: exports animation (evidence: `README.md`)
- Generator → Video Formats: exports video (evidence: `Source/EFQRCode+Generator.swift`)
- Generator → Error Types: throws errors (evidence: `Source/EFQRCode+Generator.swift`)
- Image Styles → Image Modes: positions images (evidence: `Source/Styles/EFQRCodeStyleImage.swift`)
- Resample Style → Image Modes: positions images (evidence: `Source/Styles/EFQRCodeStyleResampleImage.swift`)
- Generator → QR Output: exports QR data (evidence: `README.md`)
- Application → Source Image: provides image (evidence: `README.md`)
- Source Image → Recognizer: recognizes codes (evidence: `README.md`)
- Recognizer → Decoded Contents: returns contents (evidence: `README.md`)
