Balcony Shaper

Revit 陽台與景觀陽台自動產生工具

基本邏輯

Balcony Shaper 是一款專為建築設計團隊開發的陽台自動化工具。它能根據您事先定義的範圍與參數，快速產生標準陽台（Basic Balcony）與景觀陽台（Scenic Balcony）的地板、牆壁與扶手等元素。

工具的基本運作方式：首先選取一條「樞軸線」作為基準參考，接著使用填充區域（Hatch 區域）框定陽台可以生成的範圍。系統會根據這些資訊配合所選擇的生成模式，自動計算每個陽台的尺寸與位置，並在 Revit 中建立對應的幾何元素。

💡 核心概念

  • 樞軸線（Pivot Line）：定義陽台生成的基準參考線，建議使用建築物的牆中心線或參考平面。
  • Hatch 填充區域：在平面圖中以填充區域元素框定陽台可生成的範圍。分為「基底」「陽台」與「景觀陽台」三種用途。

模式一：單側排列（M1）

沿著樞軸線（如建築物的外牆參考線）生成陽台，最適合標準化、重複性的住宅大樓配置。

模式二：範圍隨機（M2）

在指定的填充區域內以隨機演算法分割生成，適合需要變化立面效果的大型公共建築或旅館。

模式三：沿曲線配置（M3）

沿著側邊曲線並搭配固定陽台作為基準生成，適用於弧形外牆或不規則立面設計。

使用情境

情境一：住宅大樓標準陽台配置（模式一）

針對多層住商混合大樓，每層的平面配置相近。使用「模式一：單側排列」，選取外牆樞軸線後設定最大圖案數量與間距因子範圍，系統即可沿建築物外牆快速生成一致性的陽台配置。

情境二：旅館立面變化設計（模式二）

為避免單調重複的立面效果，使用「模式二：範圍隨機」。在填充區域內以演算法自動分割出多個不規則的陽台面積，創造具有變化性的外觀。

情境三：曲線建築物的陽台（模式三）

對於弧形或斜向外牆，使用「模式三：沿曲線配置」。設定一條側邊曲線作為參考點，系統會自動計算與外牆的距離並生成固定深度的陽台。

三種模式說明

模式一：單側排列（M1）

適用場景：標準化住宅、辦公室等平面配置重複的建築。

工作原理：根據您選取的樞軸線，從中點向兩側延伸，在指定範圍內排列陽台。支援每個樓層設定不同的樞軸線。

模式二：範圍隨機（M2）

適用場景：需要立面變化效果的公共建築、旅館或商業大樓。

工作原理：根據預先定義的三種 Hatch 填充區域（基底、陽台、景觀陽台），系統以隨機射線法在區域內切割出生成範圍。可控制分割段數與平滑過渡等參數。

模式三：沿曲線配置（M3）

適用場景：弧形外牆、斜向立面或不規則建築形狀。

工作原理：先選取一條側邊曲線作為基準點，系統會在此處生成一個固定深度的標準陽台。接著在扣除固定陽台面積後的剩餘空間內，自動配置景觀陽台與標準陽台。

前置設定

工具開啟後，介面從左至右分為四個主要區域。建議依序完成以下設定：

第一步：選擇設計階段與目標樓層

  • M1、M3 共用的樓層清單：顯示所有大於零高程的樓層。勾選即表示要在此樓層生成陽台，未勾選則跳過。
  • M2、M3 共用的 Random Level 清單：在模式二和模式三中，額外勾選哪些樓層要參與隨機分割。

第二步：設定樞軸線（模式一、三需要）

在工具左方的「M1,M3」區域中：

  1. 點擊「Pivot Line」旁的 Pick 按鈕。
  2. 切換到 Revit 平面視圖，選取一條線（建議使用牆的中心線、參考平面或軸線）。
  3. 系統會自動讀取該線的延伸方向，並在右側顯示「Normal」數值，代表陽台將沿此法向量方向生成。

💡 挑選樞軸線的小技巧

  • 建議選擇直線（弧線不支援），線條的方向會影響陽台生成的方向。
  • 若需要每層不同的樞軸線，可在樓層清單中點擊「＋」按鈕為個別樓層單獨指定。
  • 「Normal Reverse」勾選框可用於翻轉生成方向。如果陽台生成了室內而非室外，請勾選此選項。

第三步：定義 Hatch 填充區域（模式二、三需要）

在工具左方的「M2,M3」區域中，您需要定義三種不同用途的填充區域：

Base Hatch（基底填充區）

定義整個陽台可生成的總範圍。點擊 Pick 按鈕後在 Revit 中選取一個已建立的填充區域。

Balcony Hatch（陽台填充區）

限定標準陽台可生成的範圍。通常與基底填充區相同，特殊分隔時可以不同。

Scenic Hatch（景觀陽台填充區）

限定景觀陽台可生成的範圍。同樣透過 Pick 按鈕在 Revit 中選取。

第四步：設定面積與深度限制

切換到左側「Balcony Limit」區域，配置兩個重要參數：

標準陽台（Basic Balcony）

  • Balcony Limit (m²)：設定標準陽台的最大面積上限。
  • Balcony Dep. Limit (mm)：設定標準陽台的深度。

景觀陽台（Scenic Balcony）

  • Scenic Limit (m²)：設定景觀陽台的最大面積上限。
  • Scenic Dep. Limit (mm)：設定景觀陽台的深度。

第五步：選擇要生成的元素類型

切換到工具右側「Generator」面板中上段的區塊，您可選擇生成哪些 Revit 元素：

基礎陽台與景觀陽台

  • Basic Balcony：勾選後生成標準陽台。
  • Scenic Balcony：勾選後生成景觀陽台。預設為已勾選狀態。

地板（Floor）

  • Floor：勾選後會建立陽台的地板圖元。
  • 從下拉選單中挑選 Revit 中的樓板類型。
  • Struct.：勾選則將地板設為結構元素。

牆壁（Wall）

  • Wall：勾選後會建立陽台外緣的欄位牆。
  • 從下拉選單中挑選牆體類型。
  • Height (mm)：設定牆壁高度。
  • Struct.：勾選則將牆壁設為結構元素。

扶手欄杆（Handrail）

  • Balcony Handrails / Scenic Handrails：分別勾選後生成標準與景觀陽台外的扶手欄杆。
  • Handrail Height (mm)：設定扶手高度。
  • 可設定相對於陽台內緣的偏移量（Balcony Offset / Scenic Offset）。

第六步：進階參數設定

M1 專屬設定（左上「M1」區塊）

  • Max. Pattern：每側最多生成的陽台數量。可設 1~50，預設為 3。
  • Random Balcony Type：開啟後交替生成標準與景觀陽台；關閉則固定使用同一種。

M1, M3 共用設定（左中「M1,M3」區塊）

  • Gap Factor (mm)：相鄰陽台之間的最小與最大距離。
  • Smooth Gap：開啟後自動計算平滑的漸進間距，讓相鄰陽台的間距變化更自然；關閉則完全隨機。
  • Smooth Factor：控制平滑演算法的變化係數。值越大，間距越趨於線性過渡。

M2, M3 共用設定（左中「M2,M3」區塊）

  • Seg. Factor：隨機分割時使用的切割段數。值越大，生成的陽台數量越多；預設為 2。
  • Force Seg.：勾選後強制按照設定的分段數量進行切割。
  • Perpendicular Cut：勾選後，當切割線與邊界呈平行時會自動調整為垂直切割。

M3 專屬設定（左下「M3」區塊）

  • Fixed Balcony Depth (mm)：在側邊曲線處生成的標準陽台固定深度。
  • Split Depth Extend (mm)：切割時的延伸距離，用於處理固定陽台與景觀區域之間的過渡。

操作步驟

  1. 開啟工具並選取模式分頁

    在工具頂端有三個分頁標籤，對應三種模式。根據您的需求選擇「M1」「M2」或「M3」。各模式共用的設定（如階段、樓層、Hatch 區域等）可在其他面板中一併完成。

  2. 依序完成前置設定

    依照上方「前置設定」章節中的說明，逐步配置階段、樓層、樞軸線、填充區域與元素類型。

  3. 預覽生成效果

    切換到您所選的模式分頁後，點擊最上方的 Random 按鈕。系統會在右側的預覽畫面中繪製預計生成的陽台配置。這讓您在實際生成前就有機會確認佈局是否符合預期。

  4. 調整參數並重新預覽

    若對預覽結果不滿意，可回到對應的設定區塊調整參數（如深度、間距、數量、面積限制等）。再次點擊「Random」按鈕查看更新後的配置，反覆調整直到滿意為止。

  5. 確認生成

    對配置感到滿意後，切換到右側「Generator」面板，在對應的模式區塊中（Mode 1/2/3）點擊 Create 按鈕。系統會先顯示確認訊息，點下「是」後即開始在 Revit 模型中建構實際的陽台元素。

  6. 檢查與後續調整

    切換回 Revit 視圖，檢查生成的陽台是否符合要求。若需要清除已生成的元素，可回到工具下方點擊 DeleteAll 按鈕（紅色字體），系統會先確認再刪除所有由本工具產生的圖元。

⚠️ 重要注意事項

  • Hatch 區域必須是封閉的填充區域：請使用 Revit 的「填充區域」工具在平面視圖中繪製。未正確封閉的區域可能導致系統無法計算。
  • 樞軸線必須為直線：模式一和模式三不接受弧線或曲線作為樞軸線。
  • 法向量方向：生成的陽台會朝向樞軸線的法向量（Normal）方向延伸。如果陽台生成了建築物的室內側而非室外側，請勾選「Normal Reverse」來翻轉方向。
  • 樓板類型需預先建立：工具只會建立地板圖元，不會自動創建樓板類型。請確認下拉選單中已存在可用的 FloorType。

設定檔管理

為了方便重複使用相同的配置，點擊工具頂端的「Setting」選單即可操作：

Open（開啟）

從檔案系統中選擇一個之前儲存的設定檔並載入。適用場景：換到另一台電腦使用、或想套用其他同事的設定時。

Load（載入）

重新載入最近一次儲存（Save）過的設定檔至工具中。

Save（儲存）

將目前的所有設定儲存至預設檔案位置，覆蓋前次儲存的內容。

Save As（另存為）

將目前的設定另存到新檔案。適合想同時保留多套不同配置（如住宅 A 方案、旅館 B 方案等）的情況。

實用技巧

分樓層分批生成

在大型專案中，建議先勾選單一個樓層進行測試。確認生成的陽台正確後，再逐步加入其他樓層。

善用預覽功能調整參數

不要跳過預覽步驟！「Random」按鈕能快速顯示當前配置的效果。反覆調整參數直到獲得滿意的結果再點擊 Create。

設定檔作為團隊資產管理

若您和團隊成員經常需要生成類似配置的陽台，建議將常用的設定分別儲存為不同的 JSON 檔案。在專案中透過 Open/Load 快速套用，大幅減少重複設定時間。

常見問題

問題現象 可能原因 解決方法
點擊 Create 後沒有任何反應或沒有生成陽台 未勾選任何樓層、面積限制為零、或未選擇 FloorType 確認已勾選目標樓層；檢查每層的面積上限；確認下拉選單中已挑選可用的地板類型。
生成的陽台在建築物室內而非室外 樞軸線的法向量方向錯誤 勾選「Normal Reverse」以翻轉生成方向，或重新挑選不同方向的樞軸線。
系統提示找不到填充區域 Hatch 區域尚未定義、或已刪除的圖元 ID 仍存在於設定中 重新點擊各 Hatch 旁的 Pick 按鈕在 Revit 中選取新的填充區域。
隨機生成的陽台數量與預期不符 面積限制過小，導致無法滿足最小生成條件 增大面積限制值；檢查 Min/Max 的間距範圍是否合理。
預覽畫面中看不到任何內容 尚未點擊 Random 按鈕、或參數設定有誤 確認已點擊各模式分頁上方的「Random」按鈕；檢查樞軸線與相關設定是否正確。
Arc（弧線）不支援的錯誤訊息 選取的樞軸線為弧形而非直線 請在 Revit 中選擇一條直線作為樞軸線。