Balcony Shaper

基本邏輯

Balcony Shaper 是一款專為建築設計開發的陽台自動產生工具。它能根據設定的填充區域與參數，自動生成標準陽台與景觀陽台的幾何體，包括欄位牆、樓板與扶手等元素。工具支援三種不同的產生模式，可應對各種建築需求與設計風格。

系統透過定義「樞軸線」作為基準，配合 Hatch 填充區域限定生成範圍，再依據選定的模式演算法自動配置陽台位置、形狀與尺寸。所有生成的元素都能完整整合至 Revit 模型中，並可進一步調整細部參數。

💡 核心概念

樞軸線 (Pivot Line)：定義陽台生成的基準參考線；Hatch 區域：限定陽台可生成的範圍；Watson Limit：與外部 Watson 系統整合的面積限制參數。

基本使用情境

情境一：住宅大樓陽台配置

針對多層住商混合大樓，需要快速產生各戶的標準陽台與景觀陽台。使用「Mode 1: Single Side Pattern」模式，可沿建築物外牆快速生成一致性的陽台配置。

情境二：旅館或服務式公寓

為避免单调重复的立面效果，可使用「Mode 2: Range Random」模式產生具有變化性的陽台排列，同時保持整體設計的一致性與可控性。

情境三：曲線建築物的陽台

針對弧形或曲線形建築物立面，「Mode 3: Along With Curve」模式可沿側邊曲線自動配置陽台，確保每戶的空間配置都符合設計意圖。

三種產生模式

Mode 1: Single Side Pattern

單側圖案模式。沿著樞軸線單側生成陽台，適用於標準化、重複性的設計需求。可控制間距因子與最大圖案數量。

Mode 2: Range Random

範圍隨機模式。在指定的樓層範圍內，以隨機演算法配置陽台位置與形狀，創造變化性高的立面效果。

Mode 3: Along With Curve

沿曲線模式。針對非直線型的建築立面，可沿著側邊曲線生成陽台，並支援平滑間隙與垂直切割等進階選項。

前置設定

第一步：階段與樓層選擇

在「階段」清單中勾選需要處理的設計階段（如新建、現有）。在「樓層」清單中選擇要產生陽台的目標樓層。

第二步：設定樞軸線

點擊「挑選樞軸線」按鈕，在 Revit 視圖中選取一條參考線作為陽台生成的基準。系統會自動識別該線條的法向量方向，並顯示於標籤上。

💡 樞軸線選擇

建議使用建築物的外牆中心線或參考平面作為樞軸線，這樣可以確保陽台位置與設計圖面保持一致。

第三步：定義 Hatch 填充區域

透過以下按鈕定義不同區域：

挑選基底填充區：設定基礎範圍
挑選陽台填充區：限定標準陽台可生成的範圍
挑選景觀陽台填充區：限定景觀陽台可生成的範圍
挑選合併填充區：設定需要合併處理的區域

第四步：選擇陽台類型

勾選「啟用基本陽台」或「啟用景觀陽台」，並分別設定：

陽台深度：從牆面延伸至外緣的深度（mm）
面積限制：單一陽台的最大允許面積

第五步：組態元素設定

選擇要產生的元素類型：

牆/樓板

勾選「建立牆壁」、「建立樓板」，並選擇對應的 Revit 類型。可設定是否為結構元素，以及牆壁高度。

手扶欄

勾選「建立陽台扶手」或「建立景觀扶手」，設定扶手高度、偏移量，並選擇扶手類型。

第六步：進階參數（視模式而定）

Mode 1 & Mode 2 共用設定

隨機陽台類型：啟用後在不同位置使用不同的陽台型式
間距因子範圍：設定陽台之間的最小與最大間距係數
最大圖案數量：限制生成陽台的總數（1-50）
使用 Watson 限制：勾選後可從外部 Watson 系統載入面積限制參數

Mode 3 獨有設定

挑選側邊曲線：設定沿著哪個曲線進行陽台配置
平滑間隙：啟用後自動調整陽台間的過渡
垂直切割：啟用後確保陽台邊緣與樞軸線保持垂直
分配景觀陽台：自動在適當位置插入景觀陽台

操作步驟

切換至目標模式分頁
根據設計需求選擇 Mode 1、Mode 2 或 Mode 3。
完成前置設定
按照前述步驟配置階段、樓層、樞軸線、Hatch 區域與元素類型。
預覽生成效果
點擊「Random」按鈕（btRandomM1/M2/M3），系統會在預覽區繪製預計生成的陽台配置圖，讓您確認佈局是否符合預期。
調整參數並重新預覽
若對預覽結果不滿意，可調整各項參數（如深度、間距、數量等），並再次點擊「Random」查看更新後的配置。
確認生成
對配置滿意後，點擊「Create」按鈕（btCreateM1/M2/M3），系統將在 Revit 模型中實際建立所有陽台元素。
檢查與後續調整
切換回 Revit 視圖，檢查生成的陽台是否正確。如有必要，可使用「刪除所有」按鈕清除已生成元素並重新設定。

⚠️ 注意事項

Hatch 區域必須封閉：未正確封閉的填充區域可能導致生成錯誤。
樞軸線方向影響：陽台會沿著樞軸線的法向量方向延伸，請確認法向指向正確。
樓板類型限制：某些複雜形狀的樓板可能無法自動生成，需手動調整。

設定檔管理

透過上方功能表列的「設定」選單：

Save/SaveAs：將目前的模式設定儲存為 JSON 檔案，方便重複使用。
Open/Load：載入先前儲存的設定檔，快速套用預先配置好的參數。