模型目标生成器用户指南

模型目标生成器(MTG)将现有3D模型转换为Vuforia引擎数据库,VuforiaEngine可以使用该数据库进行模型目标跟踪。此工具使您能够确认模型的特征是否可用,以设置初始捕捉位置,然后导出最终数据库。

MTG生成的数据库包括来自指南视图(检测位置),您可以使用它创建自己的自定义指南视图图像,与默认指南视图图像相比,这些图像可能更适合您应用程序的视觉样式。

训练模型目标数据库

模型目标生成器允许您定义一个或多个辅助视图对于每个对象,它允许您合并不同的模型目标,每个都有一个或多个高级视图,变成单曲高级数据库。高级数据库通过基于云的深度学习过程与MTG一起训练,该过程允许您的应用程序在多个模型目标之间自动切换,每个模型目标都有一个或多个高级视图,在运行时识别范围可达360度。

有关MTG过程中使用的数据的更多信息,请参见模型目标生成器数据处理.

安装模型目标生成器

最低系统要求

  • Windows和macOS支持模型目标生成器。有关支持版本的更多详细信息,请参阅支持的版本表。
  • 如果您在企业网络上,请提供MTG访问*.vuforia.com网站域。另请参见防火墙配置.

安装和设置

MTG链接到您的开发人员帐户,并通过使用开发人员凭据登录来启动。为了便于在多次MTG启动时访问,可以通过检查记住我框,并且在注销时将再次删除凭据。

不要在团队成员之间使用Vuforia Developer帐户凭据,而是使用OAuth2客户端id客户端机密凭据作为用户名和密码。请参见Vuforia Web API身份验证如何为您的团队生成客户端凭据。生成的客户端凭据必须包括创建数据集签名标准模型目标生成范围和模型目标–所有高级模型目标用于高级模型目标训练。

MTG可从Vuforia的下载页面.

MTG作为Windows的安装程序提供(.exe文件)和macOS(.dmg(.dmg)). 下载安装程序并按照步骤安装软件。

对于窗户

  • 打开下载的安装程序,选择是为一个帐户安装还是为所有帐户安装,然后选择安装模型目标生成器的目录。安装完成后,会在桌面上自动创建一个快捷方式。

对于macOS操作系统

  • 打开下载的安装程序并将安装程序文件拖动到应用文件夹以安装该工具。为了重复使用,您可以在桌面上创建快捷方式,或将应用程序固定到start-menu。

MTG附带一套基本的模型转换器。如果输入需要JT转换,则还需要安装Creo View和附带的JT适配器。只有当Creo View能够导入JT文件时,MTG才能这样做在下面.

只要源模型是MTG能够导入的格式,就不需要进行额外的模型转换。在创建新项目时,甚至在更新源文件时,MTG都会自动处理它(假设在创建项目时使用的位置仍然可以访问源文件)。

模型要求和准备

MTG可以读取各种3D文件格式,并将其转换为Vuforia Engine的内部网格格式。因此,此转换过程中引入的模型中的任何视觉错误都将显示在MTG视口中。某些源模型格式可能会导致错误转换模型,因为它们缺少网格信息。因此,应使用MTG检查导入的模型是否与源数据对应。如果有问题,使用不同的文件格式可以解决;如果没有,则可能需要清理源数据。

Vuforia Engine的模型目标跟踪在具有特定特征的CAD模型上表现最佳,例如与物理对象对应的颜色复杂度较低,并且遵循我们的其他最佳实践。

有关更多信息,请参阅模型目标支持的对象和CAD模型最佳实践.

支持的功能

导入管道支持包含以下内容的网格:

  • 多个子网格
  • 顶点位置
  • 顶点法线
  • 顶点纹理坐标(仅一组)
  • 漫反射纯色
  • 漫反射纹理颜色
  • 法线贴图

如果输入模型提供的信息多于上述信息(例如,其他纹理坐标集),则在导入时将忽略这些信息。

支持格式

MTG支持读取:Creo View(.pvz)、Collada(.dae)、FBX(.FBX)、IGES(.igs、.IGES)、Wavefront(.obj)、STEP(.stp、.STEP)、STL(.STL、.sla)、VRML(.wrl、.VRML)、glTF 2.0。当安装了Creo View Adapter for JT时,也支持JT数据。

注:macOS的MTG不支持STEP(.stp,.STEP)和JT数据文件。

Creo View Adapter、Collada、FBX和JT的导入效果最佳。

注:模型上支持的纹理格式是32位、24位和8位的JPG、PNG和PGM文件。

模型准备

在为MTG准备3D模型时,需要检查数字对象和物理对象的比例是否匹配。在某些情况下,尝试使用全尺寸对象的3D模型跟踪玩具复制品可能会导致跟踪失败。为了确保获得最佳的跟踪质量,模型和物理对象的大小应该匹配。

模型零件、几何细节、纹理和模型组成都是为MTG准备模型时应审查的领域。请参阅中的建议和最佳实践的详细概述,包括模型复杂性模型目标支持的对象和CAD模型最佳实践.

简化模型

如果三维模型过于复杂,则需要简化模型,以便计算机视觉算法能够在移动设备上实时高效运行。

您可以使用简化MTG中的选项卡。它将把3D模型上传到安全的Vuforia云,在那里它的复杂性降低了。

或者,您可以通过减少多边形的数量来手动降低复杂性,直到接受建议的输入。请参见CAD模型最佳实践对于这些数字。

模型目标生成器接口

上的MTG主界面主屏幕包含两个主要部分:它包含已导入或创建的单个模型目标的列表。双击其中任何一个将导致3D查看器编辑模型目标及其引导视图。在3D查看器中,有一系列选项卡可用于配置模型目标。在右角,进度指示器显示是否解决了所有选项。

创建新的模型目标,导入项目,并从创建按钮。

在左侧边栏中,您可以切换到Advanced Model Targets的培训集概述,包括已配置、正在运行和已完成的培训课程。在这里,您可以创建一个或多个模型目标并将其导出到一个经过训练的设备数据库中,或使用高级视图训练高级模型目标。

顶部的状态栏主屏幕显示用于创建模型目标和高级数据库的可用配额。具有基本计划的Vuforia Developer帐户具有20个模型目标生成和20个用于创建高级模型目标数据库的训练集的配额。可以通过许可获得额外配额。请参阅Vuforia定价第页了解更多信息。

请参见如何创建模型目标获取有关使用模型目标生成器创建新模型目标的分步指南。

注:如果您面临连接问题或收到'服务不可用。请稍后再试。”在企业环境中使用桌面MTG应用程序时,请参阅安装模型目标生成器.

使用输出文件

创建模型目标数据库时,创建的文件包括数据集文件(XML&DAT)、Unity Asset Package、项目文件(VUP)、JSON配置文件和每个Guide View的图像路径(PNG)。

对于Unity开发,您将使用Unity Asset包文件。将其导入Unity项目并添加和配置建模目标游戏对象从数据库加载模型目标。请参阅统一模型目标介绍了解更多信息。

对于使用Vuforia引擎本机SDK开发的应用程序,请加载运输终端交货XML格式模型目标观测器。请参见模型目标API概述了解更多信息。

(可选)使用PNG文件作为基线来设计自定义导向视图图像,您的应用程序将使用这些图像引导用户将相机与跟踪对象正确对齐,以便初始化跟踪。如果使用,请注意,自定义指南视图需要由应用程序开发人员单独加载和打包。请参阅模型目标API概述了解详细信息。

导向视图

使用模型目标生成器,可以定义一个或多个导向视图用于模型目标,并为每个指南视图设置目标识别范围。有关更多信息,请参阅模型目标指南视图高级视图

高级模型目标数据库

如果你想让你的应用程序自动识别不同的对象而不显示导向视图,或者如果你想有一个或多个识别范围高达360°的模型目标,你需要列车高级模型目标数据库。

这是通过Model Target Generator桌面工具中基于云的培训过程完成的。请参见高级模型目标数据库了解更多信息。

了解更多信息

模型目标概述

如何创建模型目标

模型目标指南视图

高级模型目标数据库

模型目标支持的对象和CAD模型最佳实践

模型目标API概述