M9. 命令行界面

通过 SGX Studio Maya 插件，您可以使用 MEL 和 Python 命令创建自定义脚本，用于导出 SGX 生成的动画。

该插件有三个命令：

sgx_load_character

为场景中的目标角色骨骼控制加载角色控制文件。

MEL：

NONE

sgx_load_character -c character_control_file [-n target_namespace]

Python：

PY

cmds.sgx_load_character(c=character_control_file, [n=target_namespace])

选项	描述
`-c ARG`	角色控制文件的路径。
`-n ARG`	角色控制文件应该重新映射到的命名空间（如果有）。

将单个 event 文件作为关键帧动画导入角色骨骼控制。相当于插件 GUI 中的单个导入。导入前必须先执行 sgx_load_character。

MEL：

CODE

sgx_import -i event_file [-a]

Python：

CODE

cmds.sgx_import(i=event_file, a={0,1})

选项	描述
`-i ARG`	要导入的 event。
`-a`	导入音频。

将批量 event 文件转换为所需的格式。相当于插件 GUI 中的批量导出。导出前必须先执行 sgx_load_character。

MEL：

CODE

sgx_export -i input_path -o output_directory -f output_formats [-a] [-b] [-s] [-p playblast_options]

Python：

CODE

cmds.sgx_export(i=input_directory, o=output_directory, f=output_formats, a={0,1}, b={0,1}, s={0,1}, p=playblast_options)

选项：

选项	描述
`-i ARG`	输入路径，可以是：包含输入 event 文件的目录，或包含 event 文件路径列表的文件。
`-o ARG`	保存导出输出的目录路径。
`-f ARG`	以逗号分隔的导出格式列表，包括 `{maya,fbx,playblast}` 中的一种或多种；
`-p ARG`	以逗号分隔的播放预览选项列表：`width,height,format,encoding,camera`。（可用的视频格式和编码取决于本地环境）。如果无编码，`编码`值请使用“none”）。
`-a`	导出音频。
`-b`	将动画从高级控制器烘培到变形器（关节、融合变形等）。仅适用于 FBX 导出。
`-s`	只导出选定的场景元素。

下面是一个使用所有选项的批量导出命令示例：

MEL：

CODE

sgx_export -i "C:/my_input" -o "C:/my_output" -f "maya,playblast" -a -b -s -p "600,800,avi,none,persp"

Python：

CODE

cmds.sgx_export(i="C:/my_input", o="C:/my_output", f="maya,avi", a=1, b=1, s=1, p="600,800,avi,none,persp")

所有插件命令均可在无头模式下传递给 Maya。有关在命令行上运行 Maya，请参阅 Maya 的资料文档。请注意，命令字符串中的任何引号或正斜线在传递给 Maya 的命令字符串中都必须转义。