Skip to content

Latest commit

ย 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

MeshDoc ๐Ÿฉบ 3D Print Mesh Repair & Analyzer

Version License: Custom Zero-Upload WebGL: Three.js

MeshDoc โ€” 3D Print Mesh Diagnostics & Auto-Repair

100% Client-Side 3D Mesh Diagnostics & Auto-Repair Engine for Additive Manufacturing & 3D Printing. Automated repair of broken STL, OBJ, and 3MF files directly in browser memory โ€” Zero-Upload, no cloud dependencies, maximum privacy.

๐ŸŒ Website & Live Tool: https://meshdoc.svender3d.de/


โœจ Features & Capabilities

1. ๐Ÿ”’ 100% Zero-Upload & Maximum Privacy (GDPR)

  • All file operations (parsing, diagnostics, ear-clipping hole repair, vertex welding, and export) execute strictly locally inside client browser memory (Float32Array, Blob, ArrayBuffer).
  • No server uploads, no cloud dependencies, and no third-party CDNs (all fonts and Three.js modules are self-hosted).

2. ๐Ÿš€ Zero-Idle GPU & Demand-Driven WebGL Engine (v1.5)

  • 0% Idle GPU Utilization: WebGL rendering loop pauses completely during stationary states, eliminating GPU fan noise, excessive power draw, and screen flickering.
  • Optimized CAD 3-Point Lighting: Crystal-clear topological inspection without the heavy VRAM depth-pass overhead of dynamic 2048 shadow maps.

3. ๐Ÿ“Š Two-Phase Vorher/Nachher Comparison Architecture (v1.5)

  • Pre-Repair Inspection: Shows exact verified vertex/triangle counts and explains precise repair operations.
  • Post-Repair Audit: Displays full Before โž” After comparison with exact delta badges (ยฑฮ”) and verified 100% Watertight / Manifold status.

4. โšก Deep Multi-Pass Force-Repair Pipeline

  • Remove Redundant CAD Duplicate Faces: Identifies and cleans overlapping triangles from complex multi-body CAD exports.
  • Planar Ear-Clipping Hole Triangulation: Reliable closure of open boundary loops and missing surface patches.
  • Topological BFS Surface Normal Alignment: Consistent outward-facing normal winding propagation across shared edge graphs.
  • Spatial Vertex Welding: Merges duplicated co-located vertices using a spatial hash table.
  • Sharp CAD Facet Shading: Recalculates exact face normals for crystal-clear geometry rendering.

5. ๐Ÿ”ฌ Interactive 3D Viewport & Live Laser Hologram Scanner

  • Live 3D Scanning Laser: Animated visual scanning HUD during the repair process with real-time multi-step progress feedback.
  • Zero-Offset Defect Lines: Open edges (Red) and non-manifold edges (Yellow) are rigidly parented to the model for perfect alignment.
  • Comparison Modes: Original, Repaired, and Split-View (Side-by-side pre/post inspection).
  • Bed Alignment Tools: 1-click drop to build bed (Z = 0) and centering on a 220 x 220 mm build plate.
  • Non-Intrusive Sticky Repair Pill: Floating quick-action button docked at bottom-center when scrolling past the dashboard.
  • Smooth Ease-In-Out Back-To-Top: High-precision easing navigation (easeInOutCubic).

4. ๐Ÿ“Š Detailed Diagnostics & Interactive Accordions

  • Expandable diagnostic cards explaining the exact root cause in 3D slicers and the applied algorithmic solution.
  • Metrics: Triangle count, vertices, dimensions (X ร— Y ร— Z in mm), surface area (cmยฒ), and signed volume (cmยณ).
  • Slicer-Readiness Assessment: Evaluated for Bambu Studio, OrcaSlicer, PrusaSlicer, and Ultimaker Cura.

5. โš–๏ธ Filament & Material Estimator

  • Automatic calculation of model weight (g) and filament length (m) for PLA, PETG, ABS, and TPU with customizable infill (0 โ€“ 100%).

6. ๐Ÿ’พ Multi-Format Export

  • Binary STL: Compact binary STL for all 3D printing slicers.
  • ASCII STL: Human-readable STL format.
  • 3MF: Modern 3D Manufacturing Format container packaging.
  • Wavefront OBJ: Universal 3D polygonal geometry.

๐Ÿ“„ License & Credits

Developed by Sven Harzer (svender3d.de)
Licensed under the MeshDoc Source-Available End-User License (Free for personal and commercial usage).

About

๐Ÿฉบ MeshDoc โ€” 100% Client-Side 3D Mesh Diagnostics & Auto-Repair Engine for 3D Printing. Fixes non-manifold edges, caps open holes with ear-clipping, harmonizes face normals, and optimizes STL, 3MF & OBJ files directly in your browser without cloud uploads.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages