# huafitwjb/comfyui-distortion-transformation-kit architecture

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

- Interactive diagram: https://gitdiagram.com/huafitwjb/comfyui-distortion-transformation-kit
- Repository: https://github.com/huafitwjb/comfyui-distortion-transformation-kit

## Overview

This ComfyUI custom-node package provides interactive and preset perspective transforms, mask completion tools, polygon approximation, and quadrilateral mask-based warping. The main interactive workflow is: a ComfyUI workflow invokes the visual transform node, the backend opens the browser editor with its images, the user adjusts the quadrilateral and applies or cancels, and the backend handles the request. The README documents the other node capabilities. Backend implementations share __init__.py; excerpts do not expose every node’s internal call graph, so those branches are shown without inferred links.

Main entry points: [`web/popup_blender.js`](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/web/popup_blender.js) (Popup editor), [`__init__.py`](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py) (Visual transform node)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_transform["Perspective transforms"]
  node_visual["Visual transform node<br/>[__init__.py]"]
  node_preset["Preset transform node<br/>[__init__.py]"]
end

subgraph group_editor["Interactive editor"]
  node_editor_ui["Popup editor<br/>[popup_blender.js]"]
  node_transform_math["Perspective rendering<br/>[popup_blender.js]"]
end

subgraph group_masks["Mask tools"]
  node_quick_fill["Quick mask completion<br/>[__init__.py]"]
  node_adaptive_fill["Adaptive mask completion<br/>[__init__.py]"]
  node_polygon_approx["Polygon approximation<br/>[__init__.py]"]
  node_quad_warp["Quad mask warper<br/>[__init__.py]"]
end

subgraph group_backend["Backend coordination"]
  node_apply_cancel["Apply and cancel routes<br/>[__init__.py]"]
  node_node_state[("Node session state<br/>[__init__.py]")]
end

node_workflow(("ComfyUI workflow"))
node_user(("User"))

node_workflow -->|"runs node"| node_visual
node_workflow -->|"runs node"| node_preset
node_workflow -->|"runs node"| node_quick_fill
node_workflow -->|"runs node"| node_adaptive_fill
node_workflow -->|"runs node"| node_polygon_approx
node_workflow -->|"runs node"| node_quad_warp
node_visual -->|"opens editor"| node_editor_ui
node_editor_ui -->|"accepts edits"| node_user
node_editor_ui -->|"renders preview"| node_transform_math
node_editor_ui -->|"posts apply or cancel"| node_apply_cancel
node_apply_cancel -->|"reads or updates"| node_node_state

click node_visual "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_preset "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_editor_ui "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/web/popup_blender.js"
click node_transform_math "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/web/popup_blender.js"
click node_apply_cancel "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_node_state "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_quick_fill "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_adaptive_fill "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_polygon_approx "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"
click node_quad_warp "https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py"

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_visual,node_preset,node_workflow,node_user toneBlue
class node_editor_ui,node_transform_math toneAmber
class node_quick_fill,node_adaptive_fill,node_polygon_approx,node_quad_warp toneMint
class node_apply_cancel,node_node_state toneRose
```

## Components

### Perspective transforms

- [Visual transform node](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`
- [Preset transform node](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`

### Interactive editor

- [Popup editor](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/web/popup_blender.js): `web/popup_blender.js`
- [Perspective rendering](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/web/popup_blender.js): `web/popup_blender.js`

### Mask tools

- [Quick mask completion](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`
- [Adaptive mask completion](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`
- [Polygon approximation](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`
- [Quad mask warper](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`

### Backend coordination

- [Apply and cancel routes](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`
- [Node session state](https://github.com/huafitwjb/comfyui-distortion-transformation-kit/blob/main/__init__.py): `__init__.py`

### Other components

- **ComfyUI workflow**
- **User**

## Connections

- ComfyUI workflow → Visual transform node: runs node (evidence: `README.md`)
- ComfyUI workflow → Preset transform node: runs node (evidence: `README.md`)
- ComfyUI workflow → Quick mask completion: runs node (evidence: `README.md`)
- ComfyUI workflow → Adaptive mask completion: runs node (evidence: `README.md`)
- ComfyUI workflow → Polygon approximation: runs node (evidence: `README.md`)
- ComfyUI workflow → Quad mask warper: runs node (evidence: `README.md`)
- Visual transform node → Popup editor: opens editor (evidence: `__init__.py`)
- Popup editor → User: accepts edits (evidence: `README.md`)
- Popup editor → Perspective rendering: renders preview (evidence: `web/popup_blender.js`)
- Popup editor → Apply and cancel routes: posts apply or cancel (evidence: `web/popup_blender.js`)
- Apply and cancel routes → Node session state: reads or updates (evidence: `__init__.py`)
