Revit二次开发十一 族

   在Revit中，提供了一个供用户自定义的元素"族"，在Revit所有的操作都围绕族这个元素进行。

1. 族的分类

   Revit将族分为系统族、内建族、标准构件族。

   1. 系统族：系统族是在 Autodesk Revit 中预定义的族，包含基本建筑构件，例如墙、窗和门。例如：基本墙系统族包含定义内墙、外墙、基础墙、常规墙和隔断墙样式的墙类型；可以复制和修改现有系统族，但不能创建新系统族；可以通过指定新参数定义新的族类型。
   2. 标准构件族：在默认情况下，在项目样板中载入标准构件族，但更多标准构件族存储在构件库中。使用族编辑器创建和修改构件。可以复制和修改现有构件族， 也可以根据各种族样板创建新的构件族。族样板可以是基于主体的样板， 也可以是独立的样板。基于主体的族包括需要主体的构件。例如：以墙族为主体的门族，独立族包括柱、树和家具；族样板有助于创建和操作构件族。标准构件族可以位于项目环境外，且具有 .rfa 扩展名，可以将它们载入项目，从一个项目传递到另一个项目，而且如果需要还可以从项目文件保存到您的库中。
   3. 内建族：内建族可以是特定项目中的模型构件，也可以是注释构件。只能在当前项目中创建内建族，因此它们仅可用于该项目特定的对象，例如：自定义墙的处理。创建内建族时，可以选择类别，且您使用的类别将决定构件在项目中的外观和显示控制。

   而我们在Revit二次开发中，与Family相关的主要是标准构建族和内建族，系统族虽然也被统称为族，并没有Family的相关属性和特性。本章主要讲解Family的相关关系。如图1-1所示：

   

   一个族（Famliy）在Revit系统中，是不允许独立存在，必须附属在一个族类别之上，族类别比族更加具体，族就像一个抽象类、族类型就是一个类，而族实例是一个实例化的对象元素。

2. 族的访问

   从族实例获取族类型FamilySymbol：

3. FamilySymbol symbol = familylnstance. Symbol  
   FamilySymbol symbol = RevitDoc. GetElement(familyInstance.GetTypeId()) as FamilySymbol 

    

    

4. 从族类型获取族：

   Family family = symbol. Family;

    

   从族获取族类型：

   FamilySymbolSet setOfSymbols = family. Symbols;

    

   从族类型获取族实例

   FamilylnstanceFilter familylnstanceFilter = new FamilyInstanceFilter(RevitDoc,symbol, Id)； 
   FilteredElementCollector filteredElements = new FilteredElementCollector(RevitDoc)； 
   filteredElements = filteredElements. WherePasses(familylnstanceFilter); 
   foreach (Familylnstance element in filteredElements) 
   { 
   //各族实例 
   } 

   族实例的构建

5. 分别通过doc.LoadFamily(file, out family);加载族，通过doc.Create.NewFamilyInstance创建一个族实例。

    

   ?

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77

   /// <summary> /// 创建一个门族的案例 /// </summary> /// <param name="RevitDoc"></param> /// <param name="doorTypeName"></param> public void CreatDoorInstance(Document doc, string doorTypeName = "0762 x 2032 mm") { FamilySymbol doorType = null;    string file = @"C:\ProgramData\Autodesk\RVT 2017\Libraries\Chinese_INTL\门\M_单-嵌板.rfa"; //获取族 Family family = null; //加载指定的族 bool loadSuccess = doc.LoadFamily(file, out family); if (loadSuccess) { //获取当前族所有的验证类型 foreach (ElementId doorTypeId in family.GetValidTypes()) { //获取当前的族类型 doorType = doc.GetElement(doorTypeId) as FamilySymbol; //指定当前的族类型 if (doorType != null) { if (doorType.Name == doorTypeName) { break; } } } } else { Autodesk.Revit.UI.TaskDialog.Show("失败", "加载族失败"); } // 使用族类型创建门 if (doorType != null) { // 首先找到线形的墙 ElementFilter wallFilter = new ElementClassFilter(typeof(Wall)); FilteredElementCollector filteredElements = new FilteredElementCollector(doc); filteredElements = filteredElements.WherePasses(wallFilter); Wall wall = null; Line line = null; foreach (Wall element in filteredElements) { LocationCurve locationCurve = element.Location as LocationCurve; if (locationCurve != null) { line = locationCurve.Curve as Line; if (line != null) { wall = element; break; } } } // 在墙的中心位置创建一个门 if (wall != null) { XYZ midPoint = (line.GetEndPoint(0) + line.GetEndPoint(1)) / 2; Level wallLevel = doc.GetElement(wall.LevelId) as Level; //创建一个族实例 FamilyInstance door = doc.Create.NewFamilyInstance(midPoint, doorType, wall, wallLevel, Autodesk.Revit.DB.Structure.StructuralType.NonStructural); Autodesk.Revit.UI.TaskDialog.Show("成功", door.Id.ToString()); System.Diagnostics.Trace.WriteLine("门创建完成: " + door.Id.ToString()); } else { Autodesk.Revit.UI.TaskDialog.Show("元素不存在", "没有找到符合条件的墙"); } } else { Autodesk.Revit.UI.TaskDialog.Show("族类型不存在", "没有找到族类型'" + doorTypeName + "'"); } }

    

    

6. 元素的编辑

   元素的移动、旋转和镜像，当前对对象进行操作时需要注意以下几点，不管是移动和旋转镜像，需要当前族具有此类特性，如一些族限制了标高，则Z方向不管赋值是否，都无法产生移动，其代码如下：

   public void ElementUtil(Document doc, FamilyInstance familyInstance) { 
    
   //元素的移动
   ElementTransformUtils.MoveElement(doc, familyInstance.Id, new XYZ(0, 0, 0)); 
   ElementTransformUtils.RotateElement(doc, familyInstance.Id, Line.CreateBound(new XYZ(0, 0, 0), new XYZ(1, 1, 1)), 30); 
   Plane plane = Plane.CreateByNormalAndOrigin(XYZ.BasisX, XYZ.Zero); 
   ElementTransformUtils.MirrorElement(doc, familyInstance.Id, plane); 
   }