SGX Producer

SGX Producer 是 SGX 的核心批量处理系统。它是适用于 Windows 的命令行可执行文件，可在 SGX Production Tools 安装文件中找到，位置在 SGX_ProductionTools/bin/SGX_Producer.exe。

有关批量处理的一般介绍，请参阅 SGX 批量处理。

该程序有两种启动方式：

直接在命令行上运行可执行文件。
通过 SGX Director 中对用户更友好的批量处理界面，启动 SGX Producer 实例（请参阅 SGX Director 产品指南中的批量处理）。

SGX Producer 目前有三个主要命令：

帮助
关于
处理

帮助命令

帮助命令用于打印版本/版权信息和使用信息。

语法

NONE

SGX_Producer.exe help

关于命令

关于命令用于打印版本/版权信息，并在默认浏览器中打开网页，列出 SGX 中包含的已获得许可的第三方软件组件的通知和附加条款。

语法

NONE

SGX_Producer.exe about

处理命令

处理命令用于对给定批量音频执行音频到动画处理。该命令也可从 SGX Director 批量选项卡启动。

如 SGX 批量处理中所述，有两种批量处理模式：

处理新 events
处理现有 events

在 SGX Producer 中，默认模式是处理现有 events。要处理新 events，请使用 -i 选项，指定将新音频和文本导入新 events 的位置。

语法

NONE

SGX_Producer.exe process -e <events_path> -c <character_path> 
[-i <import_path>] [-f] [ -L<languages_path> ] [ -l<language_name> ] 
[ -b behavior_settings ] [-P <pre-roll>] [-Q <post-roll>] 
[-A] [-N] [-E] [-M] [-r <framerate>] [-x <custom_parameters>]

选项

不带参数的选项都是布尔值：存在为 true，否则为 false。

选项	状态	参数	描述
`-e [ --events ]`	必填	路径	包含要处理的 events 目录的路径。在处理新 events 模式下，新 events 将在此路径输出。
`-c [ --character ]`	必填	路径	角色控制文件的路径。请参阅处理配置 - 角色。
`-i [ --import ]`	选填	路径	包含要导入的输入音频和文本的路径。可以是目录或电子表格 (`.csv`) 文件。请参阅批量输入格式。
`-f [ --overwrite ]`	选填	无	新创建的 events 是否可以覆盖 events 目录中同名的现有 events。仅涉及处理新 events 模式。
`-L [ --languages ]`	选填	路径	包含语言模块的目录路径。请参阅安装语言包。
`-l [ --language ]`	选填	字符串	语言模块基本名称（如 `English_US_2.1`）。请务必指定在输入音频中听到的语言（和方言）。如果未指定语言，则无法使用文本。请参阅输入选项。
`-b [ --behavior ]`	选填	字符串	由标记属性组成的字符串形式的情绪设置。请参阅下面的示例。
`-P [ --pre_roll ]`	选填	数字	为每个动画添加预缓冲帧。可以提供一个固定的时间值（以毫秒为单位），也可以提供“0”表示自动计算。请参阅预缓冲帧。实际添加的预缓冲帧时长将在批量报告中报告。
`-Q [ --post_roll ]`	选填	数字	为每个动画添加后缓冲帧。可以提供一个固定的时间值（以毫秒为单位），也可以提供“0”表示自动计算。请参阅后缓冲帧。添加后缓冲帧的实际时长将在批量报告中报告。
`-r [ --framerate ]`	选填	数字	所有输出 events 的帧率（以帧/秒为单位）。请参阅帧率。
`-A [ --active_start ]`	选填	无	活跃开头选项（请参阅活跃开头）。
`-N [ --neutral_finish ]`	选填	无	默认结尾选项（请参阅默认结尾）。
`-E [ --export_animation ]`	选填	无	将动画以纯文本 RTS 文件的形式和 event 文件一起导出（请参阅导出动画）。
`-M [ --export_metadata ]`	选填	无	从 events 中导出元数据。
`-x [ --custom ]`	选填	字符串	自定义或实验功能的参数列表，格式为 `xxx;xxx;xxx`。

示例

仅包含必填参数的处理命令示例：

CODE

SGX_Producer.exe process -e "C:/Events" -c "C:/Characters/Vivian.k"

包含选填参数的处理命令示例：

CODE

SGX_Producer.exe process -e "C:/Events" -c "C:/Characters/Vivian.k" -i "C:/Characters/Audio" 
-L "C:/Languages" -l English_GB-EAW_1.1
-b "mode=\"Neutral\" auto_modes=\"positive,negative,effort\" speech_magnitude=\"1.050000\" nonverbal_magnitude=\"1.200000\" "
-P 0 -Q 0 -N -E -M

退出代码

SGX_Producer.exe 程序采用以下退出代码：

CODE

0 - success
1 - license error
2 - input error
3 - processing error