revit-utils-extensions
Replace verbose Autodesk Revit *Utils static calls, static managers, and hand-written enum/id conversions with Nice3point.Revit.Extensions fluent extensions. USE FOR: any call to a SomeUtils.Operation(…) or any other static Revit API helper, any conversion or formatting of a Revit value, and any iteration of a Revit array, set, or map. DO NOT USE FOR: querying the model for elements (use revit-element-collector), or reading and writing element parameters (use revit-element-and-parameter-access).
Nice3point · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Nice3point/revit-skills --skill revit-utils-extensions技能说明
name: revit-utils-extensions description: > Replace verbose Autodesk Revit *Utils static calls, static managers, and hand-written enum/id conversions with Nice3point.Revit.Extensions fluent extensions. USE FOR: any call to a SomeUtils.Operation(…) or any other static Revit API helper, any conversion or formatting of a Revit value, and any iteration of a Revit array, set, or map. DO NOT USE FOR: querying the model for elements (use revit-element-collector), or reading and writing element parameters (use revit-element-and-parameter-access). license: MIT
Revit Utils Extensions
When to use
- Calling any
SomeUtils.Operation()static method or a verbose*Managergetter. - Converting a
BuiltInParameter/BuiltInCategory/ForgeTypeId, formatting or parsing a unit, or reading a color as hex or RGB. - Iterating a Revit array, set, or map, or looking a value up in one.
When not to use
- Finding a set of elements in the model — use
revit-element-collector. - Reading or writing a parameter on an element already retrieved — use
revit-element-and-parameter-access.
Recognize and replace
When the raw call is SomeUtils.Operation(document, element.Id, …) or a long getter, the facade is a method on the natural receiver.
ElementTransformUtils.MoveElement(document, element.Id, new XYZ(1, 1, 0)); // raw
element.Move(1, 1, 0); // facade
LabelUtils.GetLabelFor(BuiltInParameter.WALL_TOP_OFFSET); // raw
BuiltInParameter.WALL_TOP_OFFSET.ToLabel(); // facade
UnitUtils.ConvertToInternalUnits(69, UnitTypeId.Millimeters); // raw
69d.FromMillimeters(); // facade
SolidUtils.SplitVolumes(solid); // raw
solid.SplitVolumes(); // facade
Many members are conveniences with no raw equivalent. Use them directly, and do not hand-write the conversion:
ElementId wallsId = BuiltInCategory.OST_Walls.ToElementId(); // enum -> id
Category category = BuiltInCategory.OST_Walls.ToCategory(document); // enum -> object
string hex = color.ToHex(); // Color -> "#RRGGBB"
References
Each reference lists its domain's extensions in full — member, purpose, and a grounded example on the real receiver — with the raw *Utils class named in each section heading.
Load the one that matches the task, and do not guess a signature.
- references/transforms-and-modeling.md — Load when: moving, copying, joining, or cutting elements, or working with families, hosts, parts, assemblies, adaptive components, or masses.
- references/geometry.md — Load when: building or querying solids, bounding boxes, curves, points, tessellation, or view geometry.
- references/units-labels-forge.md — Load when: converting or formatting units, producing user-visible labels, or inspecting a
ForgeTypeIdspec, unit, or parameter. - references/converters-and-helpers.md — Load when: converting an enum to an id or object, reading a color representation, or using numeric, string, cast, or application-capability helpers.
- references/collections-and-maps.md — Load when: iterating a Revit array, set, or map, or looking a value up in a map.
- references/document-and-storage.md — Load when: reading the document version, getting a manager, working with global or project parameters, filtering parameters, or using extensible storage.
- references/disciplines-and-interop.md — Load when: working with MEP, structure, or analytical elements, or with model paths, worksharing, coordination models, export, external references, or DirectContext3D.
A newer Extensions package may expose members not shown here. If the Utils wrapper is not found, read the package README.
Validation
- Raw
*Utilsstatic calls and*Managergetters are replaced by the receiver-first facade. - Behavior is unchanged — facades add no new logic.
- Unit and label conversions use the extensions, not manual
UnitUtils/LabelUtilscalls. - Converters and helpers (
ToElementId,ToHex,Round, …) replace hand-written equivalents.
Common Pitfalls
| Pitfall | Correct approach |
|---|---|
ElementTransformUtils.MoveElement(document, id, v) | element.Move(x, y, z). |
LabelUtils.GetLabelFor(parameter) | parameter.ToLabel(). |
| Assuming a facade changes behavior | Facades only re-express the raw API; semantics match. |
| Hand-writing an id, color, or unit converter | Use the built-in ToElementId/ToHex/FromMillimeters conveniences. |
solid.Faces.Cast<Face>() | solid.Faces.EnumerateValues(). |
A ForwardIterator() loop to read map keys | map.EnumerateEntries() / EnumerateKeys() / TryGetValue(key, out var value). |
| Extension not found | The Nice3point.Revit.Extensions package is not referenced. |