# cnckitchen/stltexturizer architecture

> Architecture diagram of the GitHub repository cnckitchen/stltexturizer, 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/cnckitchen/stltexturizer
- Repository: https://github.com/cnckitchen/stltexturizer

## Overview

BumpMesh is a browser-based 3D mesh texturing tool. The main workflow loads a model, lets users choose and configure texture projections and masks in the viewer, previews displacement, then builds and downloads a processed mesh. The graph includes documented capabilities such as STEP import, texture layers, painting, diagnostics, and project files. Some UI wiring and optional paths are unsampled; edges are limited to documented behavior or relationships visible in the supplied source index and excerpts.

Main entry points: [`js/main.js`](https://github.com/cnckitchen/stltexturizer/blob/main/js/main.js) (App interface), [`js/exportPipeline.js`](https://github.com/cnckitchen/stltexturizer/blob/main/js/exportPipeline.js) (Export pipeline), [`js/textureGallery.js`](https://github.com/cnckitchen/stltexturizer/blob/main/js/textureGallery.js) (Texture gallery), [`js/viewer.js`](https://github.com/cnckitchen/stltexturizer/blob/main/js/viewer.js) (3D viewer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and viewing"]
  node_main["App interface<br/>[main.js]"]
  node_viewer["3D viewer<br/>[viewer.js]"]
  node_section["Section view<br/>[section.js]"]
  node_load["Model loading<br/>[stlLoader.js]"]
  node_step["STEP import<br/>[stepLoader.js]"]
end

subgraph group_assets["Textures and controls"]
  node_presets["Texture presets<br/>[presetTextures.js]"]
  node_gallery["Texture gallery<br/>[textureGallery.js]"]
  node_custom[("Custom textures<br/>[customTextures.js]")]
end

subgraph group_mesh["Mesh processing"]
  node_mapping["UV projection<br/>[mapping.js]"]
  node_paint["Surface painting<br/>[paintTree.js]"]
  node_mask["Masking rules<br/>[exclusion.js]"]
  node_subdivide["Adaptive subdivision<br/>[subdivision.js]"]
  node_regularize["Mesh regularization<br/>[regularize.js]"]
  node_displace["Displacement<br/>[displacement.js]"]
  node_decimate["QEM decimation<br/>[decimation.js]"]
  node_repair["Mesh repair<br/>[meshRepair.js]"]
  node_index["Mesh indexing<br/>[meshIndex.js]"]
  node_validation["Mesh diagnostics<br/>[meshValidation.js]"]
end

subgraph group_output["Preview and export"]
  node_preview["Preview pipeline<br/>[previewPipeline.js]"]
  node_material["Preview material<br/>[previewMaterial.js]"]
  node_export["Export pipeline<br/>[exportPipeline.js]"]
  node_worker["Export worker<br/>[exportWorker.js]"]
  node_writer["File export<br/>[exporter.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_main
node_main -->|"loads models"| node_load
node_main -->|"imports STEP"| node_step
node_load -->|"loads geometry"| node_viewer
node_viewer -->|"uses"| node_section
node_main -->|"selects textures"| node_presets
node_main -->|"opens gallery"| node_gallery
node_gallery -->|"lists presets"| node_presets
node_gallery -->|"manages uploads"| node_custom
node_main -->|"configures painting"| node_paint
node_main -->|"builds preview"| node_preview
node_preview -->|"subdivides"| node_subdivide
node_main -->|"creates material"| node_material
node_material -->|"projects texture"| node_mapping
node_main -->|"runs export"| node_export
node_export -->|"subdivides"| node_subdivide
node_export -->|"regularizes"| node_regularize
node_export -->|"bakes displacement"| node_displace
node_displace -->|"computes projections"| node_mapping
node_export -->|"decimates"| node_decimate
node_export -->|"repairs mesh"| node_repair
node_export -->|"welds vertices"| node_index
node_export -.->|"applies masks"| node_mask
node_main -->|"writes files"| node_writer
node_main -.->|"shows diagnostics"| node_validation
node_worker -->|"runs pipeline"| node_export

click node_main "https://github.com/cnckitchen/stltexturizer/blob/main/js/main.js"
click node_viewer "https://github.com/cnckitchen/stltexturizer/blob/main/js/viewer.js"
click node_section "https://github.com/cnckitchen/stltexturizer/blob/main/js/section.js"
click node_load "https://github.com/cnckitchen/stltexturizer/blob/main/js/stlLoader.js"
click node_step "https://github.com/cnckitchen/stltexturizer/blob/main/js/stepLoader.js"
click node_presets "https://github.com/cnckitchen/stltexturizer/blob/main/js/presetTextures.js"
click node_gallery "https://github.com/cnckitchen/stltexturizer/blob/main/js/textureGallery.js"
click node_custom "https://github.com/cnckitchen/stltexturizer/blob/main/js/customTextures.js"
click node_mapping "https://github.com/cnckitchen/stltexturizer/blob/main/js/mapping.js"
click node_paint "https://github.com/cnckitchen/stltexturizer/blob/main/js/paintTree.js"
click node_mask "https://github.com/cnckitchen/stltexturizer/blob/main/js/exclusion.js"
click node_subdivide "https://github.com/cnckitchen/stltexturizer/blob/main/js/subdivision.js"
click node_regularize "https://github.com/cnckitchen/stltexturizer/blob/main/js/regularize.js"
click node_displace "https://github.com/cnckitchen/stltexturizer/blob/main/js/displacement.js"
click node_decimate "https://github.com/cnckitchen/stltexturizer/blob/main/js/decimation.js"
click node_repair "https://github.com/cnckitchen/stltexturizer/blob/main/js/meshRepair.js"
click node_index "https://github.com/cnckitchen/stltexturizer/blob/main/js/meshIndex.js"
click node_preview "https://github.com/cnckitchen/stltexturizer/blob/main/js/previewPipeline.js"
click node_material "https://github.com/cnckitchen/stltexturizer/blob/main/js/previewMaterial.js"
click node_export "https://github.com/cnckitchen/stltexturizer/blob/main/js/exportPipeline.js"
click node_worker "https://github.com/cnckitchen/stltexturizer/blob/main/js/exportWorker.js"
click node_writer "https://github.com/cnckitchen/stltexturizer/blob/main/js/exporter.js"
click node_validation "https://github.com/cnckitchen/stltexturizer/blob/main/js/meshValidation.js"

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_main,node_viewer,node_section,node_load,node_step,node_user toneBlue
class node_presets,node_gallery,node_custom toneAmber
class node_mapping,node_paint,node_mask,node_subdivide,node_regularize,node_displace,node_decimate,node_repair,node_index,node_validation toneMint
class node_preview,node_material,node_export,node_worker,node_writer toneRose
```

## Components

### Application and viewing

- [App interface](https://github.com/cnckitchen/stltexturizer/blob/main/js/main.js): `js/main.js`
- [3D viewer](https://github.com/cnckitchen/stltexturizer/blob/main/js/viewer.js): `js/viewer.js`
- [Section view](https://github.com/cnckitchen/stltexturizer/blob/main/js/section.js): `js/section.js`
- [Model loading](https://github.com/cnckitchen/stltexturizer/blob/main/js/stlLoader.js): `js/stlLoader.js`
- [STEP import](https://github.com/cnckitchen/stltexturizer/blob/main/js/stepLoader.js): `js/stepLoader.js`

### Textures and controls

- [Texture presets](https://github.com/cnckitchen/stltexturizer/blob/main/js/presetTextures.js): `js/presetTextures.js`
- [Texture gallery](https://github.com/cnckitchen/stltexturizer/blob/main/js/textureGallery.js): `js/textureGallery.js`
- [Custom textures](https://github.com/cnckitchen/stltexturizer/blob/main/js/customTextures.js): `js/customTextures.js`

### Mesh processing

- [UV projection](https://github.com/cnckitchen/stltexturizer/blob/main/js/mapping.js): `js/mapping.js`
- [Surface painting](https://github.com/cnckitchen/stltexturizer/blob/main/js/paintTree.js): `js/paintTree.js`
- [Masking rules](https://github.com/cnckitchen/stltexturizer/blob/main/js/exclusion.js): `js/exclusion.js`
- [Adaptive subdivision](https://github.com/cnckitchen/stltexturizer/blob/main/js/subdivision.js): `js/subdivision.js`
- [Mesh regularization](https://github.com/cnckitchen/stltexturizer/blob/main/js/regularize.js): `js/regularize.js`
- [Displacement](https://github.com/cnckitchen/stltexturizer/blob/main/js/displacement.js): `js/displacement.js`
- [QEM decimation](https://github.com/cnckitchen/stltexturizer/blob/main/js/decimation.js): `js/decimation.js`
- [Mesh repair](https://github.com/cnckitchen/stltexturizer/blob/main/js/meshRepair.js): `js/meshRepair.js`
- [Mesh indexing](https://github.com/cnckitchen/stltexturizer/blob/main/js/meshIndex.js): `js/meshIndex.js`
- [Mesh diagnostics](https://github.com/cnckitchen/stltexturizer/blob/main/js/meshValidation.js): `js/meshValidation.js`

### Preview and export

- [Preview pipeline](https://github.com/cnckitchen/stltexturizer/blob/main/js/previewPipeline.js): `js/previewPipeline.js`
- [Preview material](https://github.com/cnckitchen/stltexturizer/blob/main/js/previewMaterial.js): `js/previewMaterial.js`
- [Export pipeline](https://github.com/cnckitchen/stltexturizer/blob/main/js/exportPipeline.js): `js/exportPipeline.js`
- [Export worker](https://github.com/cnckitchen/stltexturizer/blob/main/js/exportWorker.js): `js/exportWorker.js`
- [File export](https://github.com/cnckitchen/stltexturizer/blob/main/js/exporter.js): `js/exporter.js`

### Other components

- **User**

## Connections

- User → App interface: uses
- App interface → Model loading: loads models (evidence: `js/main.js`)
- App interface → STEP import: imports STEP (evidence: `js/main.js`)
- Model loading → 3D viewer: loads geometry (evidence: `js/main.js`)
- 3D viewer → Section view: uses (evidence: `js/viewer.js`)
- App interface → Texture presets: selects textures (evidence: `js/main.js`)
- App interface → Texture gallery: opens gallery (evidence: `js/main.js`)
- Texture gallery → Texture presets: lists presets (evidence: `js/textureGallery.js`)
- Texture gallery → Custom textures: manages uploads (evidence: `js/textureGallery.js`)
- App interface → Surface painting: configures painting (evidence: `js/main.js`)
- App interface → Preview pipeline: builds preview (evidence: `js/main.js`)
- Preview pipeline → Adaptive subdivision: subdivides (evidence: `js/previewPipeline.js`)
- App interface → Preview material: creates material (evidence: `js/main.js`)
- Preview material → UV projection: projects texture (evidence: `js/previewMaterial.js`)
- App interface → Export pipeline: runs export (evidence: `js/main.js`)
- Export pipeline → Adaptive subdivision: subdivides (evidence: `js/exportPipeline.js`)
- Export pipeline → Mesh regularization: regularizes (evidence: `js/exportPipeline.js`)
- Export pipeline → Displacement: bakes displacement (evidence: `js/exportPipeline.js`)
- Displacement → UV projection: computes projections (evidence: `js/displacement.js`)
- Export pipeline → QEM decimation: decimates (evidence: `js/exportPipeline.js`)
- Export pipeline → Mesh repair: repairs mesh (evidence: `js/exportPipeline.js`)
- Export pipeline → Mesh indexing: welds vertices (evidence: `js/exportPipeline.js`)
- Export pipeline → Masking rules: applies masks
- App interface → File export: writes files (evidence: `js/main.js`)
- App interface → Mesh diagnostics: shows diagnostics (evidence: `js/main.js`)
- Export worker → Export pipeline: runs pipeline (evidence: `js/exportWorker.js`)
