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

# Interfaccia a riga di comando

{% hint style="success" icon="rocket-launch" %}
Funzionalità **Studio / Creator**. La CLI richiede una licenza Studio o Creator valida.
{% endhint %}

La CLI converte i modelli senza aprire l'interfaccia grafica. È ideale per librerie, script in stile CI e pipeline LOD.

## Trova l'eseguibile

Apri un terminale ed esegui l'eseguibile di Transmutr con il sottocomando `convert`.

Percorsi tipici:

<table><thead><tr><th width="200">Piattaforma</th><th>Percorso tipico</th></tr></thead><tbody><tr><td>Windows (per utente)</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" %}
Aggiungi la cartella di installazione al `PATH` così puoi digitare un comando breve invece del percorso completo. Eseguire l'eseguibile **senza** `convert` apre l'interfaccia grafica.
{% endhint %}

## Uso di base

Converti un modello accanto al file di input (stesso nome, `.skp`):

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

Scegli un percorso di output:

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

Elenca tutti i flag:

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

## Opzioni comuni

| Opzione                                                                                               | Descrizione                                                                                                                                         |
| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | File di output, oppure una cartella quando converti più modelli                                                                                     |
| `-p, --preset <path>`                                                                                 | Carica un preset `.json` dell'interfaccia grafica                                                                                                   |
| `--copyMaps`                                                                                          | Copia le mappe delle texture accanto all'output                                                                                                     |
| `--prefixMaterialsWithModelName`                                                                      | Anteponi il nome del modello ai nomi dei materiali                                                                                                  |
| `--sketchupFileVersion <version>`                                                                     | Versione `.skp` di SketchUp di destinazione                                                                                                         |
| `--scale <x>`                                                                                         | Moltiplicatore di scala                                                                                                                             |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Unità di origine                                                                                                                                    |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Asse verticale                                                                                                                                      |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Origine di output                                                                                                                                   |
| `--simplificationLevel <0–1>`                                                                         | Quantità di semplificazione                                                                                                                         |
| `--simplificationAuto`                                                                                | Livello automatico della bacchetta magica                                                                                                           |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Flag di preservazione                                                                                                                               |
| `--simplificationTarget <n>`                                                                          | Numero di facce di destinazione (solo CLI)                                                                                                          |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Opzioni dei bordi                                                                                                                                   |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Scorciatoie dei bordi solo CLI                                                                                                                      |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy V-Ray                                                                                                                                         |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy Enscape                                                                                                                                       |
| `--proxy <type>`                                                                                      | Tipo di segnaposto (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Controlli specifici del proxy                                                                                                                       |
| `--skipRendererMaterials`                                                                             | Disattiva i dati dei materiali V-Ray/Enscape                                                                                                        |

Esempi:

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

## Più modelli e glob

Passa più percorsi:

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

Usa i glob (`*`, `**`, intervalli). Transmutr espande i pattern da solo, così i terminali Windows si comportano come le 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" %}
Percorsi e pattern **distinguono maiuscole e minuscole**. `.fbx` non corrisponde a `.FBX`.
{% endhint %}

Quando converti più modelli, le opzioni si applicano a tutti e `--output` deve essere una **cartella**.