材質筆刷

材質筆刷 — 3 個分頁、12 項操作，快速批量塗抹與管理 Revit 元素表面材質

功能概述

「材質筆刷」是一個附著在 Revit 旁的工具視窗（視窗標題即為「材質筆刷」），用來批量塗抹與管理模型元素表面的材質。相比在 Revit 中逐一選取元素、再一個面一個面地修改材質，本工具可以依元素類型、手動挑選，或針對一般模型的大面積表面一次處理，大幅提升材質配置效率。

視窗右側的「表面材質」清單供所有分頁共用：先在清單中選好要套用的材質（可用上方的關鍵字欄位快速搜尋），再到各分頁執行塗抹。視窗共 3 個分頁：「依元素」、「依挑選」、「大面積部份填充」，分別對應整批類型、單一元素面、一般模型大面積三種塗抹需求。

30 秒快速開始

  1. 開啟一個 Revit 專案檔案，執行「材質筆刷」指令。
  2. 「材質筆刷」視窗開啟並附著在 Revit 主視窗旁（視窗已開啟時重跑指令不會再開第二個）。
  3. 切換到需要的分頁：設定處理範圍（例如勾選「階段」「樓層」、加入元素類型），並在右側「表面材質」清單選好材質。
  4. 按下執行按鈕（「上材質」／「挑選面並上色」／「挑選一般模型」／「手動輸入ID」），回 Revit 視圖確認顏色變化。

工具視窗長什麼樣？（3 個分頁導覽）

分頁用途（一句話）代表性功能
依元素依元素類型 × 階段 × 樓層的範圍，批量塗抹或清除面材質「上材質」「清除材質」、勾選「階段」「樓層」、「元素類」→「應用元素」、方向「上/下/周區」
依挑選手動挑選一個元素與面，精確塗抹單一元素「挑選元素」「挑選面並上色」（同朝向面自動一併處理）
大面積部份填充針對一般模型的大面積表面批量填充，支援材質對映與面積閾值「挑選一般模型」「手動輸入ID」「新增對映」「挑面」、Load/Save

💡 找不到功能怎麼辦？

先對照上面的分頁導覽表找到目標分頁，再到下方 操作步驟 的 📍 位置說明找到群組與按鈕；如果知道「想做的事」但不知道功能名稱，直接查 快速查詢表。

主要功能模組

✓ 你可以用它…

  • 整批類型塗抹：一次處理全專案的樓板、牆、樑、柱（「依元素」）。
  • 依方向塗抹：只塗上表面、下表面或垂直側面（方向「上/下/周區」）。
  • 單一元素精修：手動挑一個元素的一個面，同朝向的所有面自動一起上色（「依挑選」）。
  • 一般模型大面積填充：對一般模型的大面一次上色，小面自動略過（「大面積部份填充」）。
  • 材質批量替換：用對映規則把舊材質批次換成新材質。
  • 材質清除：移除已塗的面材質，恢復成類型預設材質。
  • 範圍篩選：用「階段」「樓層」勾選限定處理範圍，避免誤傷其他區域。
  • 材質搜尋與快速指定：關鍵字搜尋材質、右鍵「指定左/指定右」快速填入對映。
  • 樑接觸保護：大面積填充時自動略過緊貼結構樑 10 公分內的面。
  • 設定檔重用：把對映規則與元素 ID 清單存檔，日後直接 Load。

使用情境

情境一：整批結構元素統一材質

新專案要把所有混凝土柱、樑統一上材質。到「依元素」分頁：把「元素類」中的 [Column]、[Framing] 類型用「-->」加入「應用元素」，勾選要處理的「階段」與「樓層」，方向選「周區」，在右側「表面材質」選好材質後按「上材質」。

情境二：只處理樓板底面（天花面）

要上天花料的樓板底面。到「依元素」分頁，把需要的 [Floor] 類型加入「應用元素」，方向保持預設「下」，勾選對應的階段與樓層後按「上材質」——只有法線朝下的面會被塗抹。

情境三：局部單一面修正

某面牆只有一面要特殊材質。到「依挑選」分頁，先按「挑選元素」在 Revit 中點選該面牆，再選好材質按「挑選面並上色」點選目標面——系統會把該元素所有同朝向的面一起上色。

情境四：一般模型（GM）批量填充

大量景觀一般模型要上同一種材質。到「大面積部份填充」分頁：選好材質、勾選「不使用對映」、設定「面積小於」閾值後，按「挑選一般模型」在 Revit 中點選物件——面積達標的面會被填充，細小面自動略過。

情境五：舊材質批量替換成新材質

業主把磚牆材質從 A 換成 B。到「大面積部份填充」分頁：左側下拉選 A、右側下拉選 B，按「新增對映」（可加多條），不要勾「不使用對映」，再用「挑選一般模型」或「手動輸入ID」執行——元素現有材質符合對映規則的面會被換成目標材質。

情境六：塗錯了要清理

上材質上錯了要還原。小範圍可在 Revit 中用 Ctrl+Z 逐筆復原（每個面／每個元素各為一筆交易）；大範圍用「依元素」分頁的「清除材質」按鈕（範圍同塗抹設定），或「大面積部份填充」分頁勾選「清除材質」後指定目標元素。清除動作會移除面材質、無法在工具內還原，執行前請先備份。

情境七：類似專案重用設定

同一建築群的多棟案子都要用相同的對映規則。在第一棟完成設定後按「Save」存檔，之後每棟開好檔案、到「大面積部份填充」分頁按「Load」載入即可（載入的材質必須仍存在于目前文件中）。

前置設定

檔案狀態要求

  • 必須在專案檔案中執行：在族編輯器中執行指令時，工具視窗不會開啟。
  • 檔案需為可編輯狀態（已開啟、未鎖定）；要處理的元素需存在於目前文件中。
  • 「依元素」分頁需要文件中有可用的階段與樓層；「大面積部份填充」分頁需要有一般模型，或能取得元素 ID。

第一步：開啟並連結

  1. 在 Revit 中執行「材質筆刷」指令。
  2. 「材質筆刷」視窗開啟並附著在 Revit 主視窗旁，自動連結目前開啟的檔案。
  3. 視窗為單例：已開啟時重跑指令不會再出現第二個視窗；關閉 Revit 檔案時，工具視窗也會自動關閉。

第二步：選擇處理範圍

  • 依元素：在「階段」與「樓層」清單勾選範圍（兩者都必須至少勾選一項），把元素類型加入「應用元素」，並選好「表面材質」。
  • 依挑選：不需要預先設定範圍，直接在 Revit 中挑選元素與面。
  • 大面積部份填充：依需要設定對映規則與「面積小於」閾值，執行時再指定元素（挑選一般模型或輸入 ID）。

第三步：執行並觀察結果

  1. 確認右側「表面材質」已選定材質（清除類操作除外）。
  2. 按下對應的執行按鈕：「上材質」「挑選面並上色」「挑選一般模型」或「手動輸入ID」。
  3. 回 Revit 視圖確認表面顏色變化；若執行遇到問題，系統會顯示錯誤訊息。

⚠️ 執行前一定先備份

「清除材質」會移除已塗的面材質、無法在工具內還原；塗抹操作雖然可在 Revit 中逐筆 Ctrl+Z，但批量執行會產生大量交易、逐筆復原很費事。執行大批量或清除作業前，請先存檔或備份檔案，並可先在小範圍測試。

💡 執行前檢查清單

  • 「依元素」：「階段」「樓層」有勾選嗎？「應用元素」不為空嗎？「表面材質」有選嗎？（任一缺失都會導致無效果或錯誤）
  • 「依挑選」：先「挑選元素」再「挑選面並上色」，順序不能反。
  • 「大面積部份填充」：對映模式下，元素的現有材質要有對應規則否則不上色；勾選「清除材質」時會清除目標元素的所有面（不受面積閾值限制）。

操作步驟

本工具視窗共 3 個分頁，以下依分頁說明。視窗右側「表面材質」清單為所有分頁共用：上方搜尋欄位輸入關鍵字可即時過濾材質清單。常用詞彙：挑選＝到 Revit 視圖中點選物件；上材質＝執行塗抹；清除材質＝移除面材質；Load/Save＝載入/儲存設定檔。

分頁 1：依元素

依「元素類型 × 階段 × 樓層」範圍批量塗抹或清除面材質，是最常用的整批處理分頁。

1.1 範圍篩選：階段與樓層

📍 分頁左側：上方「階段」清單、下方「樓層」清單（皆為勾選式清單）

一句話：勾選要納入處理的階段與樓層；兩邊都至少勾一項，否則「上材質」不會處理任何元素。

  1. 在「階段」清單勾選元素所在的建立階段（例如「新建」）。
  2. 在「樓層」清單勾選要處理的樓層（清單依名稱排序）。

⚠️ 必選前提

「上材質」「清除材質」只處理「勾選階段 × 勾選樓層 × 應用元素類型」三重交集內的元素；任一項未勾選就等於不處理。看到「按了沒反應」時請先回來確認這裡。

1.2 元素類 → 應用元素

📍 群組「元素類」（左）與「應用元素」（右），中間一欄按鈕：「-->」「<--」「挑選」「重設」

一句話：把要處理的元素類型從左清單移到右清單；右清單裡有哪些類型，「上材質」就只會處理哪些類型。

  1. 在「元素類」勾選一個或多個類型（可多選）。
  2. 按「-->」加入右方「應用元素」；要移除就反向勾選後按「<--」。
  3. 或在 Revit 中直接點物件：按「挑選」，依提示「選擇」點選元素，系統自動把它的類型移入「應用元素」。
  4. 要全部清空重新開始，按「重設」。

清單項目以類型前綴區分：[Floor] 樓板類型、[Wall] 牆類型、[Framing] 結構樑類型、[Column] 結構柱類型。幕牆不在列表中（設計上排除）；[Floor]、[Framing]、[Column] 只列出目前文件中正在使用的類型，[Wall] 則列出文件中的所有牆類型。

💡 「挑選」可選取的物件

按「挑選」後，只有樓板、牆（不含幕牆）、樓梯、結構樑、結構柱會被接受；點選其他類別不會有反應。其他元素（如門窗、家具）請改用「依挑選」分頁處理。

1.3 方向

📍 群組「方向」：單選「上」「下」（預設）「周區」

一句話：決定要塗元素哪個方向的面：上表面、下表面或垂直側面；選錯方向是最常見的塗錯原因。

  1. 依需求選一個方向：「上」＝法線朝上的面（如樓板頂面）。
  2. 「下」＝法線朝下的面（如樓板底面，預設）。
  3. 「周區」＝法線水平的垂直側面（如牆體的四個立面）。

1.4 上材質

📍 按鈕「上材質」（分頁右下方，「方向」群組之下）＋ 右側共用「表面材質」清單

一句話：對「勾選階段 × 勾選樓層 × 應用元素類型 × 選定方向」的元素，把選定的材質塗到符合方向的所有面。

  1. 在右側「表面材質」清單選定要套用的材質（可在上方搜尋欄位輸入關鍵字快速找到，例如「混凝土」）。
  2. 確認 1.1 的階段/樓層、1.2 的應用元素、1.3 的方向都設好。
  3. 按「上材質」執行，回 Revit 視圖檢查顏色。

執行時每個面各自成一筆交易：在 Revit 中按 Ctrl+Z 是「一次復原一個面」，批量執行後需要按多次才能全部復原。

1.5 清除材質（按鈕）

📍 按鈕「清除材質」（「上材質」正下方）

一句話：把同樣範圍（階段 × 樓層 × 應用元素 × 方向）的元素面材質移除，恢復成類型預設材質。

  1. 設定與塗抹時相同的範圍：階段/樓層、應用元素、方向。
  2. 按「清除材質」執行清除。

⚠️ 不可逆

清除後該面的客製材質即被移除，無法在工具內還原（只能重新塗）。執行前請備份檔案。

1.6 表面材質（右側共用面板）

📍 視窗最右側群組「表面材質」：上方關鍵字搜尋欄位＋材質清單（依名稱排序）

一句話：所有分頁共用的材質選擇區；搜尋欄位即時過濾清單，右鍵選單可把材質快速填入大面積填充的對映下拉。

  1. 在搜尋欄位輸入關鍵字（例如「混凝土」），清單即時顯示符合的材質。
  2. 點選清單中的材質，即為目前選定的「表面材質」。
  3. （大面積填充用）在材質上按右鍵，選「指定左」填入對映的原始材質下拉、或「指定右」填入目標材質下拉。

分頁 2：依挑選

不依賴階段/樓層設定，直接針對手動挑選的單一元素上色，適合局部精修。

2.1 挑選元素

📍 按鈕「挑選元素」＋ 右旁唯讀編號欄位

一句話：到 Revit 中選一個有實體幾何的元素，讓後續的「挑選面並上色」知道要處理誰。

  1. 按「挑選元素」。
  2. 在 Revit 視圖依提示「選擇實體元素」點選目標物件。
  3. 確認編號欄位已顯示該元素的 ID（表示挑選成功）。

2.2 挑選面並上色

📍 按鈕「挑選面並上色」＋ 右旁唯讀法線欄位

一句話：選一個面，系統自動把該元素上所有同朝向（法線相同）的面一起塗成選定材質。

  1. 先完成 2.1 的「挑選元素」（未先選元素時按此按鈕不會有反應）。
  2. 在右側「表面材質」選定材質。
  3. 按「挑選面並上色」，在 Revit 依提示「選擇面」點選目標面。
  4. 法線欄位顯示該面法線；同朝向的面隨即完成上色。

💡 只有平面才能選

挑到曲面（非平面）時不會上色；請改選平面。每個面各自一筆交易，可用 Ctrl+Z 逐筆復原。

分頁 3：大面積部份填充

針對一般模型（GM）等大面積表面批量填充，支援材質對映、面積閾值與樑接觸保護。本分頁含清除操作（勾選「清除材質」時會清除目標元素的所有面），執行前請備份。

3.1 材質對映

📍 分頁上方：左/右兩個材質下拉選單＋「新增對映」按鈕、對映清單（欄位：「材質」「表面材質」＋刪除按鈕欄）、勾選框「不使用對映」

一句話：定義「原始材質 → 目標材質」的替換規則；執行填充時，元素現有材質符合規則的面會被換成對應的目標材質。

  1. 在左側下拉選原始材質、右側下拉選目標材質（或到右側「表面材質」清單右鍵「指定左／指定右」快速填入）。
  2. 按「新增對映」把規則加入清單；可建多條規則一次執行。
  3. 要移除某條規則，點選該列最右側的刪除按鈕。
  4. 若不想用對映、直接以選定的單一材質填充所有面，勾選「不使用對映」。

💡 對映規則的細節

  • 同一個原始材質只能有一條規則：對相同原始材質重複按「新增對映」會被靜默忽略（不會加入清單、也不提示）。
  • 對映模式下，元素現有材質若沒有對應規則，該元素不上色——「沒有變化」在此是正常現象。
  • 左側下拉留空加入的規則不會命中任何材質，請務必選定原始材質。

3.2 面積閾值

📍 標籤「面積小於」＋ 數值框（預設 0.25、最小 0.1，單位平方公尺）＋ 標籤「m²不上色」＋ 按鈕「挑面」

一句話：小於此面積的面不會被上色，避免細小邊角面被誤塗；勾選「清除材質」時此閾值不適用。

  1. 直接在數值框輸入閾值（預設 0.25，最低可設 0.1）。
  2. 或不手打：按「挑面」，在 Revit 中選一個面（提示「Pick A Face」），系統自動以該面面積填入閾值。

3.3 執行填充／清除

📍 按鈕「挑選一般模型」「手動輸入ID」＋ 多行 ID 文字框＋勾選框「清除材質」「不偵測是否與樑接觸」

一句話：指定要填充的元素——挑選一個一般模型，或一次輸入多個元素 ID；勾選「清除材質」則改為對目標元素全面清除。

  1. （方式一）按「挑選一般模型」，在 Revit 依提示「挑選一般模型」點選一個一般模型，立即對其執行。
  2. （方式二）在文字框輸入元素 ID，多個 ID 以逗號「,」分隔，按「手動輸入ID」批量執行。
  3. （可選）勾選「清除材質」：對目標元素的所有面執行清除，不受面積閾值限制。
  4. （可選）勾選「不偵測是否與樑接觸」：跳過樑接觸保護。

⚠️ 樑接觸保護與清除

預設下，系統會沿面法線方向檢查 10 公分內是否碰到結構樑——碰到的面會被略過不上色（避免塗到樑與模型之間的狹縫面），這是保護機制而非錯誤。勾選「清除材質」時操作為不可逆的清除，執行前請備份。

3.4 設定檔（Load / Save）

📍 分頁上方按鈕「Load」「Save」

一句話：把目前的對映規則與手動 ID 清單存成檔案，之後可在新的檔案中載入重用。

  1. 設定好對映規則與 ID 清單後，按「Save」選擇位置存檔。
  2. 之後在新專案開啟本視窗，按「Load」選擇設定檔載入。

💡 設定檔範圍

  • 只儲存「對映規則」與「手動輸入的 ID 清單」；面積閾值與勾選狀態不會存檔，請自行記錄。
  • 載入時，只有「材質仍存在于目前文件」的規則才會還原；若右側搜尋欄位有關鍵字，請先清空再 Load，以免規則被過濾掉。

使用技巧與注意事項

名詞對照表

名詞是什麼在本工具中的出現位置
材質Revit 的材質定義（名稱、貼圖、參數等），是「上什麼顏色」的來源右側「表面材質」清單、對映的兩個下拉選單
上材質（塗抹）把選定材質指定到元素的特定面（Revit 的逐面材質，不改變元素類型材質）「上材質」按鈕、各執行動作
清除材質移除已塗的面材質、恢復類型預設。注意兩處同名物件意思不同：分頁 1 的「按鈕」＝依範圍清除；分頁 3 的「勾選框」＝把執行模式改成對目標元素全面清除分頁 1 按鈕、分頁 3 勾選框
面（Face）元素實體幾何的一個表面；本工具的上色/清除都以面為單位「挑選面並上色」「挑面」、面積閾值
法線垂直於面的方向向量，用來判斷面朝向（上/下/側）分頁 1「方向」判斷、分頁 2 法線顯示欄
周區法線水平的垂直側面（如牆的四個立面）分頁 1「方向」群組
元素類（類型）元素的型別：樓板、牆、樑、柱類型；清單以 [Floor]/[Wall]/[Framing]/[Column] 前綴標示分頁 1「元素類」「應用元素」清單
階段Revit 的專案階段（如既有、新建、拆除）；以元素的「建立階段」篩選分頁 1「階段」勾選清單
樓層Revit 的 Level；「依元素」模式依樓層範圍取元素分頁 1「樓層」勾選清單（依名稱排序）
一般模型（GM）Generic Model 族的實例，常用作景觀、設備等雜項模型分頁 3「挑選一般模型」只接受此類別
對映「原始材質 → 目標材質」的替換規則；一個原始材質只對應一條規則分頁 3 對映清單（欄位「材質」＝原始、「表面材質」＝目標）
表面材質本工具對「要塗上去的那種材質」的稱呼（右側清單選定的材質）右側共用面板「表面材質」、對映清單右欄
挑面（易誤解）不是「挑一個面來上色」，而是挑一個面、用它的面積設定面積閾值分頁 3「挑面」按鈕
指定左／指定右（易誤解）把右側清單選定的材質填入分頁 3 對映的左（原始材質）／右（目標材質）下拉「表面材質」清單右鍵選單
手動輸入ID（易誤解）ID 是 Revit 的元素編號（數字），不是自己取的名稱；多個以逗號分隔分頁 3 ID 文字框＋「手動輸入ID」按鈕
設定檔存放對映規則與 ID 清單的檔案；不含閾值與勾選狀態分頁 3「Load」「Save」
樑接觸保護面法線方向 10 公分內碰到結構樑時，該面略過不上色分頁 3「不偵測是否與樑接觸」（勾選即關閉）

高效作業建議

✓ 這樣做更快

  • 整批處理先用「依元素」：類型 × 階段 × 樓層一次覆蓋大量元素，不必一個個挑。
  • 方向想清楚再執行：上/下/周區選錯是最常返工的點；不確定就先在單一樓層小範圍試。
  • 善用「挑選」加類型：在 Revit 直接點幾個物件，就把它的類型帶進「應用元素」，不用在長清單裡翻找。
  • 材質搜尋用關鍵字：右側搜尋欄位輸入關鍵字（如「混凝土」）秒找材質。
  • 對映用右鍵快速填入：材質清單右鍵「指定左／指定右」，省去下拉翻找。
  • 重複專案用 Save/Load：對映規則存檔一次，後續專案直接載入。
  • 閾值用「挑面」自動設定：不確定該設幾平方公尺時，挑一個代表性面即可。
  • 小範圍試跑：大批量前先只勾一個樓層執行，確認結果再擴大。

重要注意事項

⚠️ 一定要知道

  • 清除無法在工具內還原：分頁 1「清除材質」按鈕、分頁 3「清除材質」勾選都會移除面材質；執行前備份。
  • 塗抹可逐筆復原但很費事：分頁 1/2 每個面一筆交易、分頁 3 每個元素一筆交易；大量執行後 Ctrl+Z 要按很多次，建議先存檔再試。
  • 階段/樓層未勾選＝不處理：「依元素」分頁必須至少勾一個階段與一個樓層。
  • 幕牆無法處理：「依元素」與「挑選」都不含幕牆，幕牆材質請在 Revit 中手動調整。
  • 清除勾選時沒有面積保護：分頁 3 勾選「清除材質」會清除目標元素的所有面，「面積小於」閾值不生效。
  • 對映模式下「無變化」可能是正常的：元素現有材質沒有對應規則時不上色。
  • 本工具只在專案檔案有效：族編輯器中不會開啟視窗。
  • 設定檔不含閾值：Save 只存對映與 ID；Load 還原的規則以材質仍存在於文件中為限。

進階應用提示

💡 工作流組合

  • 結構整建制上色：「依元素」加入 [Floor]/[Wall]/[Framing]/[Column] 多類，分方向分次執行（先「下」面再「周區」面），避免一次全塗難查錯。
  • 先清後塗：範圍內有舊材質要先打掉時，先「清除材質」再「上材質」，兩次執行使用相同範圍設定。
  • 一般模型兩段式：先用對映把舊材質批量換掉（不勾「不使用對映」），再對漏網面勾「不使用對映」以單一材質補填。
  • ID 清單化：把需要處理的元素 ID 先收集到文字框（或存進設定檔），之後重複執行不用重挑。
  • 對映＋手動ID 精確換料：只有特定幾個元素要換材質時，用「手動輸入ID」而非「挑選一般模型」。
  • 新專案重用：Save 設定檔 → 新檔案 → Load → 直接執行，是系列案最快的起案方式。

常見疑難排解

問題現象可能原因解決方法
按「上材質」後完全沒變化「階段」或「樓層」沒有勾選兩者都至少勾一項再執行
按「上材質」後完全沒變化「應用元素」清單是空的先用「-->」或「挑選」加入類型
按「上材質」後完全沒變化右側「表面材質」沒有選材質先選定材質再執行
按「上材質」後完全沒變化勾選的樓層上沒有該類型元素，或元素建立階段未勾選確認元素所在樓層與建立階段都被勾選
塗到不想要的面（例如想塗底面卻塗了頂面）「方向」選錯改選「上/下/周區」；已塗錯的面用「清除材質」或 Revit Ctrl+Z（逐面）處理
大面積填充時有些面沒上色面小於「面積小於」閾值把閾值調低（最低 0.1），或用「挑面」依代表面設定
大面積填充時樑邊的面沒上色樑接觸保護（法線方向 10 公分內碰到結構樑）如屬誤殺，勾選「不偵測是否與樑接觸」再執行
對映模式下元素完全不上色元素現有材質沒有對應的對映規則補建該材質的對映規則，或改勾「不使用對映」以單一材質填充
按「新增對映」但清單沒多一列該原始材質已有規則（重複被靜默忽略）先刪掉舊規則再新增
Load 後規則比存的少部分材質已不在目前文件中確認材質存在於目前專案再 Load
Load 後規則比存的少右側搜尋欄位有關鍵字，材質清單被過濾先清空關鍵字再 Load
按「挑選面並上色」沒反應沒有先按「挑選元素」先完成「挑選元素」再挑面
挑了面但沒有上色挑到的是曲面（非平面）改選平面
分頁 1「挑選」點某些物件沒反應只接受樓板、非幕牆牆、樓梯、結構樑、結構柱其他元素改用「依挑選」分頁
「元素類」找不到某類型[Floor]/[Framing]/[Column] 只列出文件中正在使用的類型先在文件中建立該類型的元素；牆類型則列出文件全部牆類型
找不到幕牆幕牆被設計上排除幕牆材質在 Revit 中手動調整
想一步復原整批塗抹每個面/每個元素各為一筆獨立交易Ctrl+Z 需逐筆按；建議批量前先存檔
Save 後發現閾值沒被存進設定檔設定檔只含對映規則與 ID 清單閾值與勾選狀態自行記錄，Load 後重設
「面積小於」想設 0.05 設不了數值框最小值為 0.1工具最低只能設 0.1 平方公尺
在族編輯器中執行指令沒反應工具僅支援專案檔案開啟專案檔案再執行
重跑指令但視窗沒出現視窗已開啟（單例），或檔案已關閉使視窗跟著關閉找已附著在 Revit 旁的「材質筆刷」視窗；重開檔案再執行
「樓層」清單順序不是我想要的清單依名稱排序（設計如此）直接捲動尋找目標樓層
「手動輸入ID」部分 ID 沒被處理ID 非純數字，或元素已不存在確認以逗號分隔的數字 ID，並確認元素仍存在
「挑選一般模型」點某個物件沒反應該物件不是一般模型（GM）類別改挑一般模型；其他類別用「手動輸入ID」指定
勾「清除材質」後連不该清的面也被清掉清除模式對目標元素所有面生效，不看面積閾值取消勾選、用對映/單一材質模式重填；清除前備份
「挑面」後閾值數值奇怪挑到的面面積過大/過小重新挑一個有代表性的面
執行時看到錯誤訊息材質未選定、元素被刪除或無幾何依訊息修正（選材質、重新挑選元素）後再執行
批量執行很慢每個面各成一筆交易，交易數量多縮小階段/樓層範圍分批執行
不知道某個功能在哪功能分布在 3 個分頁對照分頁導覽表與 快速查詢表

快速查詢：遇到什麼狀況用什麼功能

我想要…用這個功能（所在分頁）
一次處理全專案某類元素（如所有柱）「上材質」＋加入 [Column] 類型（依元素）
只塗樓板底面（天花面）「上材質」＋方向「下」（預設）（依元素）
只塗樓板頂面「上材質」＋方向「上」（依元素）
只塗牆的垂直立面「上材質」＋方向「周區」（依元素）
把眼前這面牆的類型加入處理範圍「挑選」（依元素）
把處理範圍裡的類型移掉勾選後按「<--」（依元素）
清空所有範圍設定重來「重設」（依元素）
只處理特定幾層樓勾選「樓層」清單（依元素）
只處理特定階段的元素勾選「階段」清單（依元素）
把塗錯的面材質打掉「清除材質」按鈕（依元素）
只精修某一個元素的一個面「挑選元素」→「挑選面並上色」（依挑選）
看剛才挑選到哪個元素「挑選元素」旁的編號欄（依挑選）
快速找到「混凝土」開頭的材質「表面材質」搜尋欄位（右側共用）
把材質快速填入對映的原始/目標位置材質清單右鍵「指定左／指定右」（右側共用）
給一個一般模型的大面全部上色「挑選一般模型」（大面積部份填充）
一次處理一長串元素「手動輸入ID」＋逗號分隔 ID（大面積部份填充）
把舊材質 A 全換成新材質 B「新增對映」A→B＋執行（大面積部份填充）
多組材質同時替換多條「新增對映」規則（大面積部份填充）
不按材質規則、直接全部刷同一材質勾選「不使用對映」（大面積部份填充）
刪掉一條對映規則該列最右側刪除按鈕（大面積部份填充）
小面不要塗到調低「面積小於」閾值（大面積部份填充）
不知閾值該設幾「挑面」挑代表面自動設定（大面積部份填充）
跳過樑接觸檢查（加速）勾選「不偵測是否與樑接觸」（大面積部份填充）
把一個一般模型已塗的材質全部清除勾選「清除材質」＋「挑選一般模型」（大面積部份填充）
把這套設定留給下一棟用「Save」存檔（大面積部份填充）
把上次存的設定拿回來「Load」載入（大面積部份填充）
處理幕牆材質本工具不支援，請在 Revit 中手動調整
復原剛才的上色Revit Ctrl+Z（逐筆交易）

功能索引表（依分頁）

分頁包含功能典型產出
依元素階段/樓層勾選、元素類→應用元素（-->/<--/挑選/重設）、方向（上/下/周區）、上材質、清除材質、表面材質搜尋與指定整批類型的面材質塗抹或清除
依挑選挑選元素、挑選面並上色（同向面自動一併上色）、元素編號/法線顯示單一元素的精確面上色
大面積部份填充材質對映（新增對映/刪除/不使用對映）、面積閾值（挑面）、挑選一般模型、手動輸入ID、清除材質、不偵測是否與樑接觸、Load/Save一般模型大面積填充、批量材質替換、設定檔

常用工作流卡片

結構整批上色

「依元素」：加入 [Column]/[Framing] 類型 → 勾階段/樓層 → 方向「周區」→ 上材質。

樓板底面批刷

「依元素」：加入 [Floor] 類型 → 方向「下」→ 選天花材質 → 上材質。

單面精修

「依挑選」：挑選元素 → 選材質 → 挑選面並上色（同向面一併處理）。

一般模型大面積填充

「大面積部份填充」：選材質 → 勾「不使用對映」→ 設「面積小於」→ 挑選一般模型。

材質批量替換

「大面積部份填充」：多條「新增對映」→ 不勾「不使用對映」→ 挑選一般模型／手動輸入ID。

錯誤清理

小範圍：Revit Ctrl+Z 逐筆；大範圍：「依元素」清除材質，或分頁 3 勾「清除材質」＋指定元素（備份後執行）。

系列案重用

「大面積部份填充」：Save 存對映與 ID → 新專案 Load → 直接執行。