Autodesk.Revit.DB.OffsetSurface

Autodesk.Revit.DB.OffsetSurface 是用于在 Revit 中创建偏移表面的类。偏移表面是通过将现有表面沿着其法线向外（或向内）平移而创建的。偏移表面通常用于创建具有特定高度，宽度或深度的新表面，例如护墙板或立柱。

基本用法

要创建 OffsetSurface 实例，可以通过调用 Autodesk.Revit.DB.OffsetSurface.Create 方法并将表面和偏移参数作为参数来实现。代码示例：

// 获取当前文档中选中的面 (face)
GeometryElement geoElement = element.get_Geometry(options);
foreach(GeometryObject geoObj in geoElement)
{
    if(geoObj is Solid)
    {
        Solid solid = geoObj as Solid;
        foreach(Face face in solid.Faces)
        {
            // 创建偏移表面
            OffsetSurface offsetSurface = OffsetSurface.Create(face, distance);
            
            // 将偏移表面添加到文档中
            ElementId wallTypeID = new ElementId(BuiltInCategory.OST_Walls);
            Transaction t = new Transaction(doc, "Add OffsetSurface");
            t.Start();
            doc.Create.NewWall(offsetSurface, wallTypeID, levelId, false);
            t.Commit();
        }
    }
}

属性

• Autodesk.Revit.DB.OffsetSurface.Face：获取偏移表面的原始面。
• Autodesk.Revit.DB.OffsetSurface.OffsetDistance：获取偏移表面的距离。

方法

• Autodesk.Revit.DB.OffsetSurface.Create：创建新的偏移表面。

示例

以下代码示例演示了如何使用 Autodesk.Revit.DB.OffsetSurface 类创建偏移表面：

// 获取当前文档中选中的面 (face)
GeometryElement geoElement = element.get_Geometry(options);
foreach(GeometryObject geoObj in geoElement)
{
    if(geoObj is Solid)
    {
        Solid solid = geoObj as Solid;
        foreach(Face face in solid.Faces)
        {
            // 创建偏移表面
            OffsetSurface offsetSurface = OffsetSurface.Create(face, distance);
            
            // 将偏移表面添加到文档中
            ElementId wallTypeID = new ElementId(BuiltInCategory.OST_Walls);
            Transaction t = new Transaction(doc, "Add OffsetSurface");
            t.Start();
            doc.Create.NewWall(offsetSurface, wallTypeID, levelId, false);
            t.Commit();
        }
    }
}

注意事项

• 偏移参数必须为正数或负数，表示向内或向外移动的距离。
• 如果偏移表面不是封闭的，则不能创建用于创建新元素的偏移表面。
• 当您调用 Create 方法创建偏移表面时，必须确保其所在的模型元素的几何体是有效的。如果几何体无效，则无法创建偏移表面，并且将引发异常。