Skip to content

v0.0.0.1-alpha — macOS Alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@nghiazer nghiazer released this 06 Jun 00:55
v0.0.0.1-alpha
7c81b5f

4H-Unfolder v0.0.0.1-alpha — macOS Native

First alpha release of the native macOS Swift port.

Download

File Platform Size
4H-Unfolder_v0.0.0.1-alpha_mac.zip macOS 13+ Ventura or later ~433 KB

Installation: Unzip → Right-click 4H Unfolder.app → Open
(Gatekeeper bypass required once — app is ad-hoc signed, not Developer ID signed)

What's in this release

  • OBJ (+ MTL textures) and PDO v3 mesh loading
  • Kruskal MST unfold → BFS face layout in 2D paper-space
  • Interactive 2D canvas — zoom/pan, click edge to toggle fold↔cut, drag piece to reposition
  • UV texture rendering — affine-mapped triangles in both 3D (SceneKit/Metal) and 2D canvas
  • Glue tabs — Trapezoid / Rectangle / Triangle, 10 FlapMode variants per edge
  • Overlap detection — spatial grid + AABB + SAT
  • Auto-arrange pieces on paper (A4/A3/A2/A1/Letter/Legal)
  • SVG + PDF export
  • .4hu project bundle — save/load mesh + overrides + piece positions (cross-platform with Windows)
  • Undo/Redo edge and flap overrides
  • 4-tab Preferences window (⌘,)
  • Drag-and-drop mesh files onto window; file associations for .obj / .pdo / .4hu
  • 87 unit tests (XCTest, run in Xcode ⌘U)

Known limitations

  • No Developer ID code signing — Gatekeeper bypass required (Right-click → Open)
  • SVG/PDF export: solid fill only, no UV texture overlay
  • PDO v4 / PD6 format not supported
  • Multi-page PDF layout not implemented

Build from source

# Requires Xcode 15+ on macOS 13+
git clone https://github.com/nghiazer/4H-Unfolder.git
cd 4H-Unfolder/4h-unfolder-mac-swift
swift build -c release
# or open Package.swift in Xcode → ⌘R
Assets 3
Loading