模型文件要求
模型文件格式
DTwin 平台官方推荐、支持的模型文件格式为 GLTF 格式,故下文均以 GLTF 模型文件作为前提假设。
模型文件结构
GLTF 模型文件导出后,应包括 .gltf 文件、.bin 二进制文件、textures 纹理目录及相关纹理贴图,并按照如下层级结构放置,打包为 .zip 压缩包进行上传:
/Audi_A5 (GLTF 模型目录,其命名与模型名称、zip 名称一致)
|-index.gltf(GLTF 文件主体,命名为 index.gltf)
|- index.bin(二进制文件,导出后请勿修改名称)
|- cover.png (GLTF 模型封面图,命名为 cover.png,不提供将使用平台默认图片)
|-textures
|-... (纹理贴图文件)
注意:
ZIP 文件名称与目录的文件名称请保持一致
bin、textures 文件,在模型导出后请勿手动修改名称
尺寸规约
根据业务需要,模型精度从精细到粗糙,分为 L0 ~ L4 等级,分别对应:
L0:高精度细节模型(High Precision Detail Model):
描述:原始高精度模型,通常是人工建模的高精度模型,或点云还原、CAD 转换等自动生成的高精度模型,不适合实时渲染,通常不直接使用。
L1:高精度外观模型(High Precision Facade Model):
描述:需要重点刻画,或严格精确刻画的场景下使用,通常根据 L0 级别进行减面处理得到,由于高精度模型仍会保留较高的面数,所以在项目中应谨慎使用。
L2:装饰外观模型(Decorated Facade Model):
描述:带有外观装饰的模型文件,用于近距离显示模型内容,为较常用的近距离、高视觉还原度的模型级别。
L3:低精度外观模型(Low Precision Facade Model):
描述:去除外观装饰物,仅保留必要的模型主体的低精度模型文件,为较常用的中、远距离视觉还原模型级别,应为整个应用最常用的模型级别。
L4:空间轮廓模型(Space Outline Model):
描述:不带有外观装饰,且进一步去除细节,仅保留必要的空间轮廓的模型级别,用于远距离场景布局。
实际使用中,应主要考虑使用 L2、L3 级别模型,具体模型要求如下:
L2:
模型面数:单个模型面数控制在 5000 面以内
细节刻画:纹理、文字等,采用纹理贴图方式进行渲染刻画
凹凸效果采用法线贴图、凹凸贴图、粗糙贴图等进行刻画
环境光阴影效果,通过 AO 贴图进行刻画
文件尺寸:单模型压缩包(.zip)不超过 20 MB
纹理尺寸:纹理贴图尺寸控制在 2048 x 2048 以内;单张纹理贴图控制在 1MB 以下
L3:
模型面数:单个模型面数控制在 5000 面以内
细节刻画:纹理、文字等,采用纹理贴图方式进行渲染刻画
凹凸效果采用法线贴图、凹凸贴图、粗糙贴图等进行刻画
环境光阴影效果,通过 AO 贴图进行刻画
文件尺寸:单模型压缩包(.zip)不超过 10 MB
纹理尺寸
纹理贴图尺寸控制在 1024 x 1024 以内
单张纹理贴图控制在 500KB 以下
可用字符规约
为保证跨系统、跨语言的通用性,DTwin 要求模型及参数命名,符合以下规则:
可用字符:
模型的目录、文件,及多面体、几何体、材质、纹理的名称,仅包含半角英文、数字、下划线(_)、中划线(-)
默认字符集:
如涉及到字符集问题,请默认使用 UTF-8 字符集