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

# Interface de linha de comandos

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

A linha de comandos converte modelos sem abrir a interface gráfica. É ideal para bibliotecas, scripts ao estilo de CI e fluxos de LOD.

## Localizar o executável

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

Localizações habituais:

<table><thead><tr><th width="200">Plataforma</th><th>Caminho habitual</th></tr></thead><tbody><tr><td>Windows (por utilizador)</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 à `PATH` para poder escrever um comando curto em vez do caminho completo. Executar o executável **sem** `convert` abre a interface gráfica.
{% endhint %}

## Utilização básica

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

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

Escolher um caminho de saída:

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

Listar todas as opções:

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

## Opções comuns

| Opção                                                                                                 | Descrição                                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `-o, --output <path>`                                                                                 | Ficheiro de saída, ou uma pasta ao converter vários modelos                                                                                                  |
| `-p, --preset <path>`                                                                                 | Carregar uma predefinição `.json` da interface gráfica                                                                                                       |
| `--copyMaps`                                                                                          | Copiar os mapas de textura para junto da saída                                                                                                               |
| `--prefixMaterialsWithModelName`                                                                      | Prefixar 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 do resultado                                                                                                                                          |
| `--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 pretendido (apenas na linha de comandos)                                                                                                     |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Opções de arestas                                                                                                                                            |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Atalhos de arestas (apenas na linha de comandos)                                                                                                             |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy do V-Ray                                                                                                                                               |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy do Enscape                                                                                                                                             |
| `--proxy <type>`                                                                                      | Tipo de marcador de posição (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Controlos específicos do proxy                                                                                                                               |
| `--skipRendererMaterials`                                                                             | Desativar 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
```

Utilize padrões glob (`*`, `**`, intervalos). O Transmutr expande os padrões, para que os terminais do Windows se comportem como as 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" %}
Os caminhos e os padrões são **sensíveis a maiúsculas e minúsculas**. `.fbx` não corresponde a `.FBX`.
{% endhint %}

Ao converter vários modelos, as opções aplicam-se a todos e `--output` tem de ser uma **pasta**.