UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
编程
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
应用程序接口
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes

启动命令行选项

可以在UNIGINE可执行文件启动时指定启动命令行选项。这些选项控制要使用的渲染API,为Unigine窗口设置的分辨率,用于存储引擎初始化的资源等。这些选项可以在 UNIGINE SDK浏览器中设置,也可以通过命令行手动设置

注意
如果未指定命令行选项,则在启动应用程序时将使用具有默认值的选项。

命令行选项的语法如下:首先指定二进制可执行文件的全名(64位开发或生产版本),然后指定启动选项。

命令行
main_* -command argument
命令行
main_* -command "argument,argument"
命令行
main_* -console_command "command argument"

所有路径均指定为绝对路径或相对于二进制可执行文件或data目录的路径。

如果多次指定同一命令,引擎将仅考虑最后一条命令。例如,在以下情况下,引擎将仅使用argument3

命令行
-command "argument1" -command "argument2" -command "argument3"
注意
  • 文件系统命令行选项是一个例外:它们可以累加所有指定的值。
  • 在应用程序启动时指定的CLI选项始终优先于存储在配置文件中的CLI选项。某些CLI选项可以通过控制台进行更改。这样的选项会自动存储在配置文件中(这样,退出应用程序后,它们将在下次启动时恢复)。所有其他CLI选项都不会更改配置文件。

影片设定#

名称 描述 争论 默认值
-video_mode 视频模式以设置窗口分辨率或大小 -1 对应于 video_width ×video_height
0 对应于 640×360
1 对应于 960×540
2 对应于 1024×576
3 对应于 1280×720
4 对应于 1366×768
5 对应于 1600×900
6 对应于 1920×1080
7 对应于 2560×1440
8 对应于 3840×2160
9 对应于 640×400
10 对应于 960×600
11 对应于 1024×640
12 对应于 1280×800
13 对应于 1440×900
14 对应于 1680×1050
15 对应于 1920×1200
16 对应于 2560×1600
17 对应于 640×480
18 对应于 800×600
19 对应于 1024×768
20 对应于 1280×960
21 对应于 1280×1024
22 对应于 1600×1200
23 对应于 2048×1536
24 对应于 2560×2048
1
-video_width 屏幕宽度
#只有在 才有意义 video_mode = -1
010000 0
-video_height 屏幕高度
#只有在 才有意义 video_mode = -1
010000 0
-video_resizable 允许即时更改窗口大小,而不必重新启动应用程序 0 对应于不可调整大小的模式
1对应于可调整大小的模式
0
-video_fullscreen 全屏模式 0 是窗口模式
1 是全屏模式
2 是呈现应用程序窗口时不进行修饰的全窗口模式
0

图形设定#

名称 描述 争论 默认值
-video_app 用于渲染的图形API:
  • 没有渲染器:请勿在屏幕上渲染任何内容(例如,对于通过网络播放的服务器)
  • 从可用选项中自动选择最佳选项。
  • DirectX
  • OpenGL
_ -video_app的当前值可以通过getVideoApp()Unigine API的方法。
"null"
"auto"
"direct3d11" or "dx"
"opengl" or "gl"
"auto"
-video_adapter 如果有多个GPU,则允许选择要使用的GPU。
注意
仅适用于DirectX。
要使用的GPU的数量。 0
-video_debug 启用或禁用OpenGL或DirectX的调试上下文。
注意
启用调试上下文可能会导致性能下降(〜30-40%)。
DirectX:
  • 0 禁用
  • 1 写入所有DirectX错误(红色)和警告(黄色)。如果发生错误,则表示API中存在错误。
  • 2 写入所有DirectX错误(红色)和警告(黄色)。如果发生错误,引擎将崩溃并显示完整的调用堆栈。
OpenGL:
  • 0 禁用
  • 1 写入所有OpenGL错误(红色)和警告(黄色)。如果发生错误,则表示API中存在错误。
  • 2 的工作方式与 1 模式相同。
0
-video_quad_buffer 启用 quad缓冲立体声 0 禁用四倍缓冲
1 启用四元缓冲
0
-video_surround 允许跨3个监视器呈现应用程序。 0 禁用3台显示器的渲染
1 跨3台显示器渲染
0
-video_surround_border 设置显示器边框补偿的大小(以像素为单位)。它与 -video_surround 1 一起使用。 边框补偿的大小(以像素为单位)。
-video_vsync 垂直同步(将FPS与监视器的刷新率同步) 0 - 不要使用同步
1 - 使用同步
0

文件系统#

名称 描述 争论 默认值
-data_path 包含所有资源data 目录的路径。可以将路径指定为绝对路径或相对于二进制可执行文件的路径。 可以通过getDataPath()函数获取指定的-data_path目录。 该参数可以按以下方式传递:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
../
-plugin_path 包含插件的目录的路径。此目录中的所有插件将在启动时自动加载。 可以相对于二进制可执行文件指定路径,也可以将其指定为绝对路径。 可以通过getPluginPath(int num)getPluginPath(int num)方法获取指定的-plugin_path目录的列表。 可以按以下方式传递参数:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
plugins/
注意
与其他命令行选项不同,plugin_path选项可以累加所有指定的值。它允许指定多个路径,每个路径将由引擎使用。

对于多个目录或软件包,应分别指定每个项目,且不要使用逗号,例如:

源代码
-plugin_path ../RELATIVE_PATH_1/ -plugin_path ../RELATIVE_PATH_2/ -plugin_path ABSOLUTE_PATH

其他资料#

名称 描述 争论 默认值
-cache_path 存储系统和编辑器缓存文件的路径(由system_cacheeditor_cache分别)。该路径可以指定为绝对路径,也可以相对于-data_path.
注意
为使该参数生效,您应该删除现有的系统 editor 缓存文件,或将其移动到新的指定位置。
可以按以下方式传递参数:
  • ../RELATIVE_PATH/
  • ABSOLUTE_PATH
data/
-editor_cache UnigineEditor要使用的缓存文件的路径。可以将路径指定为绝对路径,也可以指定为相对于-data_path或相对于-cache_path(如果有)的绝对路径。 editor.cache
-system_cache 引擎要使用的缓存文件的路径。可以将路径指定为绝对路径,也可以指定为相对于-data_path或相对于-cache_path(如果有)的绝对路径。 unigine.cache
-engine_log 要创建和使用的日志文件。可以将路径指定为绝对路径或相对于二进制可执行文件的路径。对于相对路径,如果设置了 -project_name ,则将在用户配置文件的相应目录中创建具有指定名称的日志文件(仅使用名称) ,相对路径的其余部分将被丢弃。) log.txt
-editor_script 编辑器脚本的路径(相对于 data目录指定的链接
-gui_path 引擎界面要使用的GUI外观的路径。可以将路径指定为绝对路径或相对于-data_path的路径。 core/gui/
-project_name 强制引擎将所有更改的数据(日志文件,缓存文件和配置文件)存储在用户配置文件中,而不是包含二进制文件的目录中。为此,将创建一个具有指定PROJECT_NAME的目录或相对于用户配置文件的项目目录的路径(例如unigine_projects/my_project)。 PROJECT_NAME,即:
  • 项目目录的名称。例如, -project_name my_project 将创建以下目录:

    Windows

    C:/Users/<username>/my_project/

    Linux

    /home/<username>/.my_project/

  • 相对于用户配置文件的项目目录的路径。例如,-project_name unigine_projects/my_project将在以下目录中创建my_project目录:

    Windows

    C:/Users/<username>/unigine_projects/

    Linux

    /home/<username>/.unigine_projects/

    注意
    用户配置文件中必须存在指定的unigine_projects文件夹。
-system_script 系统脚本的路径(相对于数据目录指定)。 core/unigine.usc
-skip_guidsdb 引擎将忽略guids.db文件,并在数据文件夹内的所有.meta文件以及所有已安装的外部目录和包中搜索GUID。
注意
默认情况下,UnigineEditor使用此参数以避免错误,并始终重新生成guids.db文件以确保其有效性。

引擎相关设置#

名称 描述 争论
-console_command 在引擎启动时使用的 控制台命令。可以使用&&序列分隔几个命令。 command <arguments>
-extern_plugin 加载插件库(相对于二进制可执行文件指定了路径)。
  • 库名称应该没有任何前缀和后缀。
    (例如libNetwork_x64d.so应该作为"Network"传递。)
  • 几个插件之间用逗号分隔(没有空格)。
  • 如果您要清除插件列表(在启动时指定了引擎,引擎会自动加载它们),只需传递 ""作为该命令的参数。
参数可以指定如下:
  • PLUGIN_NAME
  • PLUGIN_NAME_1,PLUGIN_NAME_2,...,PLUGIN_NAME_N
-extern_define 要使用的外部定义。
  • 几个定义以逗号分隔(没有空格)。
  • 您还可以使用以下语法: -extern_define "A=B,C=D"
    (例如-extern_define  "TEST=42" 。)
  • 如果要清除所有定义,只需传递 ""作为此命令的参数即可。
当前值-extern_define可以通过getExternDefine()Unigine API的方法。
参数可以指定如下:
  • DEFINITION_NAME
  • DEFINITION_NAME=VALUE
  • DEFINITION_NAME_1,DEFINITION_NAME_2,
    DEFINITION_NAME_3=VALUE,...,DEFINITION_NAME_N

声音设定#

名称 描述 争论 默认值
-sound_app 使用的声音API:
  • No sound
  • 从可用的库中自动选择最佳的声音库选项(OpenAL)
  • OpenAL声音库
当前值-sound_app可以通过getSoundApp()Unigine API的方法。
null
auto
openal
auto
最新更新: 2020-10-10