xBIM 应用与学习（二）

一、新建项目

Visual Studio 新建项目、项目创建完成后 Nuget ,项目添加 Xbim.Essentials,那么如果项目需要几何引擎还需要集成 Xbim.Geometry。xBIM经过多年的发展，这两个包都比较稳定。

Package Manager

 Install-Package Xbim.Essentials -Version 4.0.29  /  Install-Package Xbim.Geometry -Version 4.0.11

.NET CLI

  dotnet add package Xbim.Essentials --version 4.0.29  /dotnet add package Xbim.Geometry --version 4.0.1

二、创建凭证，打开文件

用于IFC 文件保留所有实体的所有者历史信息； IfcOwnerHistory :定义所有的历史信息和识别相关。为了提供快速访问，它直接连接到所有独立的对象、关系和属性。

var editor = new XbimEditorCredentials
{
    ApplicationDevelopersName = "You", //应用开发商名称
    ApplicationFullName = "Your app",  //应用程序名称
    ApplicationIdentifier = "Your app ID", //应用程序标示符
    ApplicationVersion = "4.0", 
    //您的个人信息
    EditorsFamilyName = "lu",
    EditorsGivenName = "yongqiang",
    EditorsOrganisationName = "bim" 
};

IModel 在xBIM中的所有实现都是IDisposable这样的，建议在开发时应用 using：

using (var model = IfcStore.Open(fileName, editor, true))
{
    //...do something with the model
}

IfcStore.Open()能识别别文件格式（ .ifc，.ifczip，* .xml）和IFC版本（IFC2x3，IFC4）。使用这个静态函数，它也决定是否应该使用内存模型或Esent数据库来存储数据。你可以使用额外的参数来明确你想要的。你也可以通过一个代表，报告进度。

三、创建文件

如果要从头开始创建新模型，也可以使用以下功能。在这种情况下，您必须指定应该使用哪个模式和存储，因为我们不知道您需要什么，模型需要从一开始就知道这两件事情。另外，请确保您为所创建的模型使用正确的模式名称空间，因为您无法在单个模型中混合来自多个模式的数据。

IfcSchemaVersion.Ifc4 是枚举，代表IFC的版本，当前最新的版本是IFC 4

using (var model = IfcStore.Create(editor, IfcSchemaVersion.Ifc4, XbimStoreType.InMemoryModel))
{
    //...do something with the model
}

如果要在模型中创建或修改任何内容，则必须使用事务。这些也应该在using语句中使用，以便在事件发生的时候有适当的回滚操作范围。您必须明确提交事务以保持更改。事务不能嵌套，所以当时总是只有一个事务。

using (var txn = model.BeginTransaction("Hello Wall"))
{
    //....do something in the scope of this transaction
    txn.Commit()
}

所有的相关实体都可以通过model.Instances来创建。这个是你在模型中获取、更改和常见新的实体的入口点。创建任何新的对象，你需要用到这个模板函数。

var newWall = mode.Instances.New<IfcWall>();

除了使用这个函数之外，不可能以任何其他方式创建新的实体。你会在上面的代码中看到，这个函数使用可选的类型化对象初始化器来设置对象的值。没有必要使用它们，但我个人喜欢它，因为我可以看到结果实体的结构。要找到您想要的实体，您将使用以下功能：

var firstWall = model.Instances.FirstOrDefault<IfcWall>();  //获取默认的第一个
var allWalls = model.Instances.OfType<IfcWall>(); //获取所有
var specificWall = model.Instances.Where<IfcWall>(w => w.Name == "Brick wall");  //检索 墙的名称为 Brick wall

您可以看到，所有这些函数都是模板化的，所以它们使用对象的类型作为第一级过滤器。如果你知道你想要的类型，你应该总是指定它来提高性能。对于所有的搜索查询，您也可以使用接口来检索实体。我们在IFC2x3实体上实现了IFC4接口，这意味着您可以用一个代码库查询IFC2x3和IFC4 。使用所有这些基本的东西，你的第一个简单的代码可能看起来像这样。因为它使用Xbim.Ifc4.Interfaces这个代码将同时适用于IFC2x3和IFC4。

using Xbim.Ifc;
using Xbim.Ifc4.Interfaces; //IFC4 接口 同样也适用于 IFC2x3 架构实现

namespace BasicExamples
{
    class QuickStart
    {
        public static void Start()
        {
            const string fileName = "SampleHouse.ifc"; //这是不带任何IFC3 x 3 或 IFC4 版本
            var editor = new XbimEditorCredentials
            {
                ApplicationDevelopersName = "You",  // 应用开发商名称
                ApplicationFullName = "Your app",   //应用程序名称
                ApplicationIdentifier = "Your app ID",  //应用程序标识符
                ApplicationVersion = "4.0",     //版本
                //您的个人信息
                EditorsFamilyName = "lu,
                EditorsGivenName = "yongqiang",
                EditorsOrganisationName = "个人、企业"  //组织机构
            };
            using (var model = IfcStore.Open(fileName, editor, true))
            {
               //创建一个是事务
                using (var txn = model.BeginTransaction("Quick start transaction"))
                {
                    //获取模型中所有的墙
                    var walls = model.Instances.OfType<IIfcWall>();

                    //遍历所有的墙 并且改变他们的名称
                    foreach (var wall in walls)
                    {
                        wall.Name = "Iterated wall: " + wall.Name;
                    }

                    //提交事务 
                    txn.Commit();
                }

                //保存更改后的模型 IfcStore 可以使用的扩展名为 *.ifc, *.ifczip or *.ifcxml.
                model.SaveAs("SampleHouse_Modified.ifc");
            }
        }
    }
}