项目开发
项目是一个独立的实体,包含以一组目录组织的有关您的应用程序内容的所有数据。包含元数据的*.project文件与项目关联。
创建新项目#
在开始创建新项目之前,您应该已经安装了 SDK 。拥有所需版本的SDK后,您可以按以下方式创建一个新项目:
-
在SDK浏览器中打开Projects标签。
- 单击Create New。新的项目创建窗口将打开。
-
定义项目的名称,选择存储项目文件的路径,指定要使用的SDK和UNIGINE Engine build 。
该项目将在<project path>/<unigine_project>文件夹中创建。
- 指定所需的应用程序和常规设置。
- 单击Create New Project。该项目将出现在项目列表中。
应用程序设置#
可以使用以下应用程序设置创建项目:
Template |
用作项目基础的模板: |
---|---|
API+IDE |
|
Precision |
使用的坐标精度:
|
功能#
该项目可以创建以下功能:
Command-line Runtimes Generator | 为项目启用命令行运行时生成器。 |
---|---|
Command-line Build Tool | 为项目启用命令行生成工具。 |
Sandworm Distributed & Headless Mode | 支持在 Worker 计算机上创建所需的控制台应用程序,以便使用项目的Sandworm工具进行分布式计算和无头生成地形。 |
Editor Plugin Template |
启用基于项目可用模板创建编辑器插件。 |
Plugins (0)按钮打开可用插件列表:
STEREO 3D | |
Dual output stereo 3D (Separate plugin) | 每只眼睛输出 2张单独的图像。
Separate仅支持 DirectX 11 。 |
---|---|
MULTI-MONITOR | |
SpiderVision (SpiderVision plugin) |
将应用程序渲染为可配置的监视器或投影数量,或使用存储在通过 Scalable Display Manager 创建的校准文件中的多投影仪设置,并通过 EasyBlend SDK 设置。 |
3-monitor output (Surround plugin) | 同时在 3个监视器上渲染应用程序。 |
NETWORK | |
ARTTracker plugin | 使用 ARTTracker 插件创建一个项目。 |
Steam plugin | 使用用于Steam集成的插件创建一个项目。 |
Syncker plugin | 使用Syncker插件创建一个项目,以进行多通道渲染同步。 |
VRPN Client plugin | 使用VRPN Client插件创建一个项目。 |
WebStream plugin | 使用WebStream插件创建一个项目。 |
SPECIALS | |
GPU Monitor plugin | 为您的项目启用 GPU频率和温度监控。 |
Kinect2 Plugin | 使用 Kinect2 插件创建一个项目。 |
Leap Motion plugin | 用Leap Motion跟踪手和手指。 |
TeslaSuit plugin | 创造感觉,追踪身体动作,用 Teslasuit捕捉用户的生物特征。 |
Ultraleap | 用Ultraleap跟踪手和手指。 |
VCSIntegration Plugin | 使用版本控制系统(SVN, Git)跟踪在UNIGINE编辑器中执行的所有文件更改。 |
SOUND | |
FMOD plugin | 提供了与Firelight Technologies开发的FMOD库的集成的插件。FMOD是一个包括所有的工具,你需要添加声音和音乐的视频游戏和应用程序的解决方案。 |
添加现有项目#
要将现有项目添加到浏览器:
- 单击Projects选项卡中的Add Existing。
- 在打开的文件对话框窗口中,指定项目文件夹的路径,然后单击Apply。该项目将出现在项目列表中。
升级现有项目#
需要升级的项目带有Upgrade标签:
要将项目升级到UNIGINE SDK的最新安装版本:
-
单击项目映像上的Upgrade标签或Other Actions -> Configure。下面的表单将打开:
- 选择最新安装的SDK版本,然后单击Update Configuration。
- 指定将原始项目复制到的备份文件夹的路径。选中Migrate Content,然后单击UPGRADE PROJECT。
该项目将自动升级。您还可以通过运行升级脚本手动升级项目。在这两种情况下,将使用相同的脚本。
运行项目#
要运行自定义设置的项目,单击 Run 按钮上的省略号:
- launch_debug —项目的调试版本的启动器。
- launch_editor-使用已加载的编辑器启动项目的启动器。
-
launch_release-项目发行版本的启动器。
要使用发布启动器,您应该先将重新配置项目到Release二进制文件。
使用自定义设置运行项目#
要使用自定义设置运行项目,请单击 run 按钮上的省略号:
The Customize Run Options form will open.
根据Application选项的值,可以使用不同的选项集:
-
Default —将运行默认的主应用程序(<project_name>_x*.exe):
当仅使用 UnigineScript 实施项目时,应使用默认的主应用程序。在这种情况下,可以自定义以下选项:
Debug 指示应运行应用程序的调试版本还是发行版。 Microprofile Enabled 启用 Microprofile 工具运行该应用程序。 Arguments 启动命令行选项。 Remember 指示是否记住指定的自定义设置以供将来运行。 -
Custom —将运行自定义的主应用程序:
如果使用C++ or C# API实施项目(除UnigineScript外),则应选择此选项。在这种情况下,可以自定义以下选项:
Binary 定制主应用程序的名称。在这里,应指定位于项目bin文件夹中的已编译二进制可执行文件的名称。如果二进制可执行文件位于此文件夹之外,则应指定相对于bin文件夹的二进制路径。 Arguments 启动命令行选项。 Remember 指示是否记住指定的自定义设置以供将来运行。
编辑项目#
项目内容通过UNIGINE编辑器编辑,代码通过IDE编辑。
-
要编辑项目内容,请单击Open Editor。
-
要编辑源代码,请使用Open Code IDE。选择为默认的IDE将用于打开代码。
项目编辑工具还可以以自定义模式运行。
自定义UnigineEditor选项#
通过单击Open Editor按钮上的省略号来定制UNIGINE Editor的运行选项:
在打开的Customize UNIGINE Editor Options表单中,设置所需的值并单击Edit。
Additional arguments | 启动命令行选项。 |
---|---|
Debug | 将用于项目编辑的编辑器版本(调试或发行版)。 |
Microprofile Enabled | 启用 Microprofile 工具运行该应用程序。 |
Remember | 指示是否记住指定的自定义设置以备将来运行。 |
自定义IDE选项#
要更改工具,请执行以下操作:
-
在 Windows上,单击Open Code IDE按钮上的省略号。以下表格将打开:
在下拉列表中选择Custom,然后使用必需的参数指定自定义工具(例如IDE或编辑器)的路径:
-
在Linux上,单击Open folder,然后在关联的工具中编辑代码。
发布和开发版本#
您可以选择UNIGINE Engine的Development或Release版本:
- Development构建包含可用于项目开发的其他功能(Microprofile等)
- Release构建允许检查应用程序的最终性能。
默认情况下,该项目被配置为使用包含其他调试工具的 Development 引擎二进制文件。引擎的 Development 二进制文件需要一个正在运行的SDK Browser实例,就像UnigineEditor一样。
您可以通过项目文件夹中的 launch_release launch_release文件在不运行SDK Browser的情况下运行您的应用程序,但首先,您应该重新配置项目以使用 Release 二进制文件。
重新配置项目:
单击 Other Actions -> Configure。
在 Engine 下拉菜单中选择 Release 选项。
- 单击配置窗口底部的 Update Configuration 按钮保存配置。
一旦项目被重新配置为 Release 版本,它就可以在没有SDK浏览器的情况下运行——运行项目文件夹中的 launch_release 文件。
Release 二进制文件应该在项目的最终构建中使用。
其他行为#
更新项目配置#
单击Other Actions -> Configure时,将打开以下表单:
通过此表单,您可以更改现有项目的设置:用于该项目的 UNIGINE Engine版本,发布应用程序的版本,坐标精度和常规设置。当您需要将现有项目升级到最新的SDK版本时,也应该使用此选项。
此外,您可以还原已损坏,丢失或错误修改的项目文件。为此,您应保持表格形式的设置不变,然后按Update Configuration按钮。在这种情况下,将还原项目的以下文件(它们将从SDK复制):
- 二进制文件
- core.ung, editor.ung and scripts.ung
- 启动器