Keycap 3D Viewer - 鍵帽視覺化工具

📁 檔案上傳

📦

STL 檔案

拖放 .stl 檔案至此

尚未載入

📐

NEU 檔案

拖放 .neu.1 檔案至此

尚未載入

🏷️ 特徵資訊

載入 NEU 檔案後顯示特徵

📊 模型資訊

三角面數 -

頂點數 -

邊界框 -

X Y Z

🗂️ 所有特徵 0

載入 NEU 檔案後顯示特徵

🔍 選取的表面

點擊左側特徵或 3D 模型中的平面以查看詳細資訊

📌 基準面

點擊特徵後按「設為基準」

📐 特徵比較

點擊特徵後按「加入比較」(最多2個)

📌 核心概念

遮擋檢測是判斷「從特定角度看，有沒有東西擋住目標表面」的演算法。

關鍵：觀察視角固定沿著法向量方向，不會任意移動。

📐 幾何原理

      👁️ 觀察視角（沿法向量）
       ↓
       │   ▲ d > 0 遮擋物（紅）
       │  ╱ ╲
       │ ╱───╲
       ↓
  ═════●═════  ← 目標表面
       │         Origin
       ↓
       ▽ d < 0 後方（安全）

d = (三角形中心 - Origin) · Normal

d > 0 → 在表面前方 → 可能遮擋
d < 0 → 在表面後方 → 不影響

📂 資料來源

NEU 檔案

Origin（原點）
Normal（法向量）
xyzMin / xyzMax（邊界）

STL 檔案

三角形網格頂點
[x,y,z, x,y,z, ...]

⚙️ 演算法流程

1 遍歷 STL 每個三角形

↓

2 2D 投影過濾（無重疊則跳過）

↓

3 計算三角形中心到表面的距離 d

↓

4 判斷 d > 0 且在邊界內 → 遮擋

📊 輸出結果

occluded：true/false（是否遮擋）
occludingTriangles：遮擋三角形詳細資訊
inFrontCount：前方三角形數量