> 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-pt-br/exportacao/command-line-interface.md).

# Interface de linha de comando

{% hint style="success" icon="rocket-launch" %}
Recurso do **Studio / Creator**. A interface de linha de comando exige uma licença válida do Studio ou do Creator.
{% endhint %}

A interface de linha de comando converte modelos sem abrir a interface gráfica. Ela é ideal para bibliotecas, scripts no estilo de CI e pipelines de LOD.

## Localizar o executável

Abra um terminal e execute o executável do Transmutr com o subcomando `convert`.

Locais típicos:

<table><thead><tr><th width="200">Plataforma</th><th>Caminho típico</th></tr></thead><tbody><tr><td>Windows (por usuário)</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" %}
Adicione a pasta de instalação ao seu `PATH` para digitar um comando curto em vez do caminho completo. Executar o executável **sem** `convert` abre a interface gráfica.
{% endhint %}

## Uso básico

Converta um modelo junto à entrada (mesmo nome, `.skp`):

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

Escolha um caminho de saída:

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

Liste todas as opções:

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

## Opções comuns

| Opção                                                                                                 | Descrição                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | Arquivo de saída, ou um diretório ao converter vários modelos                                                                                     |
| `-p, --preset <path>`                                                                                 | Carrega uma predefinição `.json` da interface gráfica                                                                                             |
| `--copyMaps`                                                                                          | Copia os mapas de textura junto à saída                                                                                                           |
| `--prefixMaterialsWithModelName`                                                                      | Prefixa os nomes dos materiais com o nome do modelo                                                                                               |
| `--sketchupFileVersion <version>`                                                                     | Versão `.skp` do SketchUp de destino                                                                                                              |
| `--scale <x>`                                                                                         | Multiplicador de escala                                                                                                                           |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Unidade de origem                                                                                                                                 |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Eixo vertical                                                                                                                                     |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Origem da saída                                                                                                                                   |
| `--simplificationLevel <0–1>`                                                                         | Intensidade da simplificação                                                                                                                      |
| `--simplificationAuto`                                                                                | Nível automático da varinha mágica                                                                                                                |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Opções de preservação                                                                                                                             |
| `--simplificationTarget <n>`                                                                          | Número de faces desejado (somente na CLI)                                                                                                         |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Opções de arestas                                                                                                                                 |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Atalhos de arestas (somente na CLI)                                                                                                               |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy do V-Ray                                                                                                                                    |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy do Enscape                                                                                                                                  |
| `--proxy <type>`                                                                                      | Tipo de marcador (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Controles específicos do proxy                                                                                                                    |
| `--skipRendererMaterials`                                                                             | Desativa os dados de material do V-Ray/Enscape                                                                                                    |

Exemplos:

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

## Vários modelos e padrões glob

Passe vários caminhos:

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

Use padrões glob (`*`, `**`, intervalos). O Transmutr expande os padrões por conta própria, para que os terminais do Windows se comportem como shells 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" %}
Caminhos e padrões **diferenciam maiúsculas de minúsculas**. `.fbx` não corresponde a `.FBX`.
{% endhint %}

Ao converter vários modelos, as opções se aplicam a todos eles, e `--output` precisa ser um **diretório**.