> 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-vi/xuat/command-line-interface.md).

# Giao diện dòng lệnh

{% hint style="success" icon="rocket-launch" %}
Tính năng **Studio / Creator**. CLI cần một giấy phép Studio hoặc Creator hợp lệ.
{% endhint %}

CLI chuyển đổi mô hình mà không mở giao diện đồ họa. Nó phù hợp cho thư viện, kịch bản kiểu CI và quy trình LOD.

## Tìm tệp thực thi

Mở một terminal và chạy tệp thực thi Transmutr với lệnh con `convert`.

Vị trí thường gặp:

<table><thead><tr><th width="200">Nền tảng</th><th>Đường dẫn thường gặp</th></tr></thead><tbody><tr><td>Windows (theo người dùng)</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" %}
Thêm thư mục cài đặt vào `PATH` để bạn có thể gõ một lệnh ngắn thay vì đường dẫn đầy đủ. Chạy tệp thực thi **không** có `convert` sẽ mở giao diện đồ họa.
{% endhint %}

## Cách dùng cơ bản

Chuyển đổi một mô hình cạnh tệp đầu vào (cùng tên, `.skp`):

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

Chọn đường dẫn đầu ra:

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

Liệt kê mọi cờ:

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

## Tùy chọn thường dùng

| Tùy chọn                                                                                              | Mô tả                                                                                                                                               |
| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | Tệp đầu ra, hoặc một thư mục khi chuyển đổi nhiều mô hình                                                                                           |
| `-p, --preset <path>`                                                                                 | Tải một preset `.json` từ giao diện đồ họa                                                                                                          |
| `--copyMaps`                                                                                          | Sao chép map texture cạnh tệp xuất                                                                                                                  |
| `--prefixMaterialsWithModelName`                                                                      | Thêm tên mô hình vào trước tên vật liệu                                                                                                             |
| `--sketchupFileVersion <version>`                                                                     | Phiên bản `.skp` SketchUp đích                                                                                                                      |
| `--scale <x>`                                                                                         | Hệ số tỷ lệ                                                                                                                                         |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Đơn vị nguồn                                                                                                                                        |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Trục hướng lên                                                                                                                                      |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Gốc tọa độ đầu ra                                                                                                                                   |
| `--simplificationLevel <0–1>`                                                                         | Mức đơn giản hóa                                                                                                                                    |
| `--simplificationAuto`                                                                                | Mức tự động của đũa thần                                                                                                                            |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Các cờ giữ nguyên                                                                                                                                   |
| `--simplificationTarget <n>`                                                                          | Số mặt mục tiêu (chỉ CLI)                                                                                                                           |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Tùy chọn cạnh                                                                                                                                       |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Lối tắt cạnh chỉ có trên CLI                                                                                                                        |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy V-Ray                                                                                                                                         |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy Enscape                                                                                                                                       |
| `--proxy <type>`                                                                                      | Loại hình đại diện (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Điều khiển riêng của proxy                                                                                                                          |
| `--skipRendererMaterials`                                                                             | Tắt dữ liệu vật liệu V-Ray/Enscape                                                                                                                  |

Ví dụ:

```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
```

## Nhiều mô hình và glob

Truyền nhiều đường dẫn:

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

Dùng glob (`*`, `**`, khoảng). Transmutr tự mở rộng mẫu nên terminal Windows hoạt động giống shell Unix:

```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" %}
Đường dẫn và mẫu **phân biệt chữ hoa chữ thường**. `.fbx` sẽ không khớp `.FBX`.
{% endhint %}

Khi chuyển đổi nhiều mô hình, các tùy chọn áp dụng cho tất cả, và `--output` phải là một **thư mục**.