使用说明
该工具支持基于建筑物轮廓面数据及建筑高度等必要的参数信息，构建LOD2.0级别建筑精模数据。
系统提供通用城市建筑材质库，其中Commercial、Industrial、Residential文件夹分别对应商业、工业和居民用地类型的材质。各文件夹内按照建筑结构部位细分纹理：FlatRoof为平屋顶纹理、InnerWall为女儿墙/挑檐纹理、PitchedRoof为坡屋顶纹理、LOD2Facades为建筑主体立面纹理，可按需下载使用。
一、普通材质命名规范
1、 通用结构部位材质（FlatRoof/InnerWall/PitchedRoof）
命名格式：[Mat前缀+建筑类型]_[结构部位]_[具体材质(序号)]。例如：MatResidence_FlatRoof_Shuini(11).jpg。具体规则说明如下：
| 字段 | 说明 |
|---|---|
| 建筑类型（含 Mat 前缀） | 对应用地类型，统一添加Mat材质前缀，建筑类型包括：MatResidence（住宅）、MatCommercial/MatBussiness（商业）、MatIndustrial（工业）。 |
| 结构部位 | 严格对应建筑结构部位，可选项包括FlatRoof（平屋顶）、InnerWall（女儿墙/挑檐）、PitchedRoof（坡屋顶）。 |
| 具体材质 (序号) | 用拼音或英文标注具体材质，括号内数字为同类材质下不同纹理样式的编号，例如Shuini(11)=水泥 11 号）。 |
2、 LOD2 建筑立面材质（LOD2Facades）
命名格式： [Mat前缀+建筑类型]_[建筑层级]_[建筑高度类型+编号]_[立面类型]_[宽度]_[高度]_[行]_[列]_[底层行]。例如：MatResidence_LOD2_MiddleFacade3_front_36_36_4_4_1.jpg，表示：住宅类型、LOD2层级、中层立面编号3、正面纹理，实际宽度36米，高度36米，纵向可划分4行，横向可划分4列，底层行为第1行。
具体规则说明如下：
| 字段 | 说明 |
|---|---|
| 建筑类型 | Residence（住宅）、Commercial/Bussiness（商业）、Industrial（工业），统一添加材质前缀 Mat，与用地类型对应。 |
| 建筑层级 | 指定建筑模型精细层级，例如 LOD2。 |
| 建筑高度类型 | 按建筑高度分类，可带数字编号。可选项包括：LowerFacade（低层）、MiddleFacade（中层）、HigherFacade（高层）。 |
| 立面类型 | 按建筑矢量面边长自动匹配，可选项包括：front（正面，匹配最长边）、side（侧面，匹配次长边）、wall（墙面，匹配极窄边）。 |
| 宽度 | 纹理实际宽度，单位：米。 |
| 高度 | 纹理实际高度，单位：米。 |
| 行 | 不裁剪门窗时纵向最大可划分数。 |
| 列 | 不裁剪门窗时横向最大可划分数。 |
| 底层行 | 底部不参与纵向重复贴图的行数。 |
二、PBR材质命名规则
构建带PBR材质的建筑精模，可搭配材质库中 Glass、Metal、Stone等类型使用。PBR材质由 JSON配置文件和贴图文件组组成。
1、JSON 配置文件命名规则
规则同LOD2Facades普通材质，仅在建筑类型前增加PBRMat前缀。例如：PBRMatResidence_LOD2_MiddleFacade3_front_36_36_4_4_1.json
2、 PBR 贴图文件命名规则
命名格式：M_结构部位/立面类型_材质分类_材质类型_序号_贴图类型，例如M_Facade_Wall_Stone_Terrazzo_05_BaseColorMap.png。具体规则如下：
| 字段 | 说明 |
|---|---|
| 前缀 | 固定为 M_，代表 Material（材质），用于统一区分材质文件 |
| 结构部位/立面类型 | 标识贴图对应的建筑结构或立面类型，规则同LOD2Facades普通材质，例如Facade_Wall、PitchedRoof。 |
| 材质分类 | 材质大类与具体类型，以下划线分隔，如Stone_Terrazzo表示石材_水磨石。 |
| 序号 | 数字编号，用于区分同类材质下不同纹理样式。 |
| 贴图类型 | PBR 标准贴图类型，可选项包括：
|
参数说明
| 参数名 | 参数释义 | 参数类型 |
|---|---|---|
| 面数据集 | 输入表征建筑物轮廓面的二维面数据集。 | DatasetVector |
| 建筑高度: | 直接输入数值或选择属性字段来设置结果建筑模型的高度，单位为米。 | String |
| 底部高程 （可选） |
直接输入数值或选择属性字段来设置结果建筑模型的底部高程，单位为米。 | String |
| 资产路径 | 指定构建建筑模型所需的纹理贴图、屋顶附属物资源等资产的存储路径。 | String |
| 带纹理 （可选） |
设置是否为建筑模型添加纹理贴图。 若不勾选，结果建筑模型将为白模。若不指定资产路径，该参数将无效。 | Boolean |
| 构建屋顶附属物 （可选） |
设置是否为建筑模型添加屋顶附属物。 若不勾选，结果建筑模型将不包含屋顶附属物。若不指定资产路径，该参数将无效。 | Boolean |
| 屋顶类型: （可选） |
选择属性字段来指定结果建筑模型的屋顶类型。 若留空，则根据随机规则生成屋顶。 | String |
| 地块矢量面 （可选） |
输入用于指定建筑物所在地块用地类型的二维面数据集。位于同一地块的建筑会使用同一材质效果。 | DatasetVector |
| 用地类型字段 （可选） |
选择用于标识地块用地类型的属性字段，后续用地类型标签将基于该字段的值进行匹配。工具会根据用地类型，选择合适风格的建筑材质。 | String |
| 商业用地标签 （可选） |
输入用地类型字段中表征商业用地的属性值，各属性值使用逗号分隔，例如：停车场,商业用地。 | String |
| 工业用地标签 （可选） |
输入用地类型字段中表征工业用地的属性值，各属性值使用逗号分隔，例如：食品厂,纺织厂。 | String |
| 居民用地标签 （可选） |
输入用地类型字段中表征居民用地的属性值，各属性值使用逗号分隔，例如：小区,公共用地。 | String |
| 无值区域用地类型 （可选） |
指定无法区分用地类型的区域的类型，可选项包括：居民用地、工业用地、商业用地。 | BudingUsageType |
| 精细模型区域面 （可选） |
输入用于指定重点区域的二维面数据集，该区域内的建筑物将构建为更复杂的模型。 | DatasetVector |
| 目标数据源 | 指定存储结果模型数据集的数据源。 | Datasource |
| 结果数据集名 （可选） |
设置结果模型数据集的名称，默认值为building。 | String |
输出结果
| 参数名 | 参数释义 | 参数类型 |
|---|---|---|
| 结果数据集 | 结果数据集 | Object |