Plugin Revit
Molding dùng quy trình hai bước: bạn thiết kế family trong trình duyệt, rồi Revit add-in đọc thiết kế đó và tạo file .rfa.
Tải và cài đặt
- Tải bộ cài Molding (
.msi) mới nhất từ trang releases của dự án. - Đóng Revit nếu đang mở, rồi chạy bộ cài.
- Khởi động lại Revit. Molding xuất hiện trong tab ribbon Add-Ins.
Phiên bản hỗ trợ: Revit 2021 trở lên.
Mở editor trong Revit
Click Molding trên ribbon Add-Ins. Cùng editor bạn dùng trên trình duyệt sẽ mở ra dưới dạng panel trong Revit — cùng giao diện, cùng file, cùng JSON. Bạn có thể tải family đã thiết kế online bằng cách copy file JSON vào panel.
Ở chế độ panel, giao diện chuyển sang layout dạng tab:
| Tab | Nội dung |
|---|---|
| Thiết kế | Khung nhìn 3D + panel editor (Tham số / Loại / Phần tử) |
| Catalog | Duyệt và đặt các family chia sẻ có sẵn. Export All… batch-export toàn bộ catalog thành file .rfa vào một thư mục local. |
Các nút trên toolbar
| Nút | Khi nào bật | Chức năng |
|---|---|---|
▶ Generate | Đang chạy trong Revit và có family đang mở | Tạo hoặc tái tạo .rfa qua Revit Family API |
↻ Update | Trong Revit và thiết kế thay đổi sau lần Generate cuối | Tái tạo .rfa (bỏ qua nếu không có thay đổi từ lần Generate trước) |
💾 Lưu | Luôn luôn | Tải xuống thiết kế family dưới dạng file .json |
📄 New | Luôn luôn | Tạo family mới từ template |
Quy trình đầu đến cuối
- Thiết kế — mở hoặc xây dựng family trên trình duyệt hoặc trong panel Revit.
- Generate — click
▶ Generate. Molding tạo.rfavà mở trong Revit Family Editor ở nền. - Load vào dự án — trong Revit, load
.rfatừ Family Editor, hoặc dùng Load into Project. Đặt như family Revit thông thường. - Chỉnh sửa — thay đổi tham số hoặc geometry trong Molding, rồi click
↻ Updateđể đẩy thay đổi..rfađược tái tạo mà không mất các bản đặt trong dự án.
Family được tạo ra là family Revit có tham số đầy đủ: Revit's own solver xử lý tính toán lại khi tham số thay đổi. Không cần plugin Molding khi chạy runtime — chỉ cần lúc generate.
File .rfa được tạo ra
Molding tự tạo bộ constraint đầy đủ:
- Reference plane — một cái mỗi trục tọa độ có tham số.
- Dimension — được gán nhãn và liên kết với tham số tương ứng.
- Family parameter — nối hoàn chỉnh để Revit's solver flex geometry.
File Family Editor sẽ dày đặc (nhiều plane và dimension), nhưng không ai cần đọc. Node graph Molding là bề mặt thiết kế; .rfa là artifact được tạo tự động.
Lưu và tải JSON
💾 Lưuxuất family dưới dạng file.jsoncó thể chia sẻ hoặc đưa vào version control.- Để tải lại: click biểu tượng danh sách model (grid) trên toolbar → chọn model đã lưu. Bạn cũng có thể mở family từ panel Catalog.
- Family trong catalog công khai có thể fork (click biểu tượng fork trên thẻ catalog) và tùy chỉnh thành của riêng bạn.
Xử lý sự cố
Nút Generate bị xám — panel đang mở trong trình duyệt, không phải trong Revit. Nút Generate chỉ hoạt động khi Molding chạy trong panel Revit.
Lỗi "Unknown parameter" — một trường nút tham chiếu key tham số không tồn tại. Kiểm tra tab Tham số xem có typo không; hàng đỏ trong danh sách Phần tử chỉ ra trường nào bị lỗi.
Geometry trông sai trong preview nhưng đúng trong .rfa (hoặc ngược lại) — preview web và Revit đều evaluate cùng JSON, nhưng preview xấp xỉ với một số form (revolution, sweep). File .rfa mới là bản chính xác.
Flex thất bại sau khi load — kiểm tra xem tham số family trong Manage → Family Types của Revit có khớp với key tham số trong Molding không. Nếu bạn đã đổi tên tham số, hãy Generate lại thay vì Update.