> For the complete documentation index, see [llms.txt](https://help.transmutr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.transmutr.com/v2-zh-cn/dao-chu/command-line-interface.md).

# 命令行界面

{% hint style="success" icon="rocket-launch" %}
**Studio / Creator** 功能。命令行界面需要有效的 Studio 或 Creator 许可证。
{% endhint %}

命令行界面无需打开图形界面即可转换模型。它适合资源库、CI 式脚本和 LOD 流程。

## 找到可执行文件

打开终端，使用 `convert` 子命令运行 Transmutr 可执行文件。

典型位置：

<table><thead><tr><th width="200">平台</th><th>典型路径</th></tr></thead><tbody><tr><td>Windows（按用户安装）</td><td><code>%LOCALAPPDATA%\Transmutr\current\Transmutr.exe</code></td></tr><tr><td>macOS</td><td><code>/Applications/Transmutr.app/Contents/MacOS/Transmutr</code></td></tr></tbody></table>

{% hint style="info" %}
将安装文件夹加入 `PATH`，即可输入短命令，而无需输入完整路径。在**不带** `convert` 的情况下运行可执行文件会打开图形界面。
{% endhint %}

## 基本用法

在输入文件旁转换模型（同名，`.skp`）：

```bash
Transmutr.exe convert C:/models/tree.obj
```

选择输出路径：

```bash
Transmutr.exe convert --output C:/sketchup/mytree.skp C:/models/tree.fbx
```

列出所有选项：

```bash
Transmutr.exe convert --help
```

## 常用选项

| 选项                                                                                                    | 说明                                                                                                                             |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `-o, --output <path>`                                                                                 | 输出文件；转换多个模型时为目录                                                                                                                |
| `-p, --preset <path>`                                                                                 | 载入图形界面预设 `.json`                                                                                                               |
| `--copyMaps`                                                                                          | 将纹理贴图复制到输出文件旁                                                                                                                  |
| `--prefixMaterialsWithModelName`                                                                      | 在材质名称前添加模型名称                                                                                                                   |
| `--sketchupFileVersion <version>`                                                                     | 目标 SketchUp `.skp` 版本                                                                                                          |
| `--scale <x>`                                                                                         | 缩放倍数                                                                                                                           |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | 源单位                                                                                                                            |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | 向上轴                                                                                                                            |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | 输出原点                                                                                                                           |
| `--simplificationLevel <0–1>`                                                                         | 简化程度                                                                                                                           |
| `--simplificationAuto`                                                                                | 魔棒自动级别                                                                                                                         |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | 保留选项                                                                                                                           |
| `--simplificationTarget <n>`                                                                          | 目标面数（仅命令行）                                                                                                                     |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | 边线选项                                                                                                                           |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | 仅命令行的边线快捷方式                                                                                                                    |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | V-Ray 代理                                                                                                                       |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Enscape 代理                                                                                                                     |
| `--proxy <type>`                                                                                      | 占位类型（`billboardCross`、`billboardFaceMe`、`blobs`、`boundingBoxWireframe`、`boundingBoxFaces`、`faceSkipping`、`simplifiedGeometry`） |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | 代理专用控件                                                                                                                         |
| `--skipRendererMaterials`                                                                             | 禁用 V-Ray/Enscape 材质数据                                                                                                          |

示例：

```bash
Transmutr.exe convert --simplificationLevel 0.25 statue.skp
Transmutr.exe convert --scale 5 --origin bottomCenter models/car.gltf
Transmutr.exe convert --preset C:/presets/studio.json --output C:/out C:/models/*.fbx
```

## 多个模型与通配符

传递多个路径：

```bash
Transmutr.exe convert C:/models/tree.fbx C:/models/sofa.obj
```

使用通配符（`*`、`**`、范围）。Transmutr 会自行展开模式，因此 Windows 终端的行为与 Unix shell 类似：

```bash
Transmutr.exe convert C:/models/trees/*.obj
Transmutr.exe convert C:/models/**/tree.fbx
Transmutr.exe convert C:/models/*.@(obj|fbx)
```

{% hint style="warning" %}
路径和模式**区分大小写**。`.fbx` 不会匹配 `.FBX`。
{% endhint %}

转换多个模型时，选项应用于所有模型，并且 `--output` 必须是**目录**。