Autodesk.Revit.DB.OBJImportOptions

Autodesk.Revit.DB.OBJImportOptions是Revit API中用于导入OBJ文件的选项类。OBJ格式是一种常见的三维模型文件格式，通常用于游戏开发、电影特效等领域。

构造函数

public OBJImportOptions()

OBJImportOptions类的构造函数没有参数，用于创建一个新的选项对象。

属性

EdgeMergeTolerance

public double EdgeMergeTolerance { get; set; }

EdgeMergeTolerance属性用于控制相邻面之间边缘的距离容差，取值范围为0到1之间的实数。如果该值设置为0，则意味着不存在容差，即只有当两个边缘精确相符时才会被认为是同一个边缘；如果该值为1，则意味着任意两个边缘都会被认为是同一个边缘。默认值为0.001。

MergeCoplanarFaces

public bool MergeCoplanarFaces { get; set; }

MergeCoplanarFaces属性用于控制是否合并平面上相邻的面，使它们成为一个整体。如果该属性为True，则相邻的平面面会被合并成一个大的面；如果该属性为False，则相邻的平面面会被保留为独立的面。默认值为True。

SeparateDisjointEntities

public bool SeparateDisjointEntities { get; set; }

SeparateDisjointEntities属性用于控制是否将独立的实体分开导入。如果该属性为True，则独立的实体会被分开导入；如果该属性为False，则所有实体会被视为一个整体导入。默认值为True。

VertexMergeTolerance

public double VertexMergeTolerance { get; set; }

VertexMergeTolerance属性用于控制相邻顶点之间的距离容差，取值范围为0到1之间的实数。如果该值设置为0，则意味着不存在容差，即只有当两个顶点精确相符时才会被认为是同一个顶点；如果该值为1，则意味着任意两个顶点都会被认为是同一个顶点。默认值为0.001。

示例

下面的示例展示了如何使用OBJImportOptions类来设置OBJ导入选项，并将OBJ文件导入为Revit族文件。

public void ImportObj(string filePath)
{
    Document doc = this.ActiveUIDocument.Document;
    ModelPath path = ModelPathUtils.ConvertUserVisiblePathToModelPath(filePath);
    OBJImportOptions options = new OBJImportOptions();
    options.EdgeMergeTolerance = 0.1;
    options.MergeCoplanarFaces = true;
    options.SeparateDisjointEntities = true;
    options.VertexMergeTolerance = 0.01;
    Transaction transaction = new Transaction(doc);
    transaction.Start("Import OBJ");
    ImportInstance importInstance = ImportInstance.Create(doc, path, options);
    transaction.Commit();
}

在上述代码中，我们首先创建了一个名为options的OBJImportOptions对象，并设置了它的四个属性值。然后，我们使用ImportInstance.Create()方法来将OBJ文件导入为Revit族文件，并在事务中提交更改。