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

# Interface en ligne de commande

{% hint style="success" icon="rocket-launch" %}
Fonctionnalité **Studio / Creator**. L’interface en ligne de commande exige une licence Studio ou Creator valide.
{% endhint %}

L’interface en ligne de commande convertit des modèles sans ouvrir l’interface graphique. Elle convient aux bibliothèques, aux scripts de type intégration continue et aux chaînes de niveaux de détail.

## Localiser l’exécutable

Ouvrez un terminal et lancez l’exécutable Transmutr avec la sous-commande `convert`.

Emplacements habituels :

<table><thead><tr><th width="200">Plateforme</th><th>Chemin habituel</th></tr></thead><tbody><tr><td>Windows (par utilisateur)</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" %}
Ajoutez le dossier d’installation à votre `PATH` pour saisir une commande courte au lieu du chemin complet. Lancer l’exécutable **sans** `convert` ouvre l’interface graphique.
{% endhint %}

## Utilisation de base

Convertir un modèle à côté du fichier d’entrée (même nom, `.skp`) :

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

Choisir un chemin de sortie :

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

Lister toutes les options :

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

## Options courantes

| Option                                                                                                | Description                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `-o, --output <path>`                                                                                 | Fichier de sortie, ou un dossier lors de la conversion de plusieurs modèles                                                                            |
| `-p, --preset <path>`                                                                                 | Charger un préréglage `.json` créé dans l’interface graphique                                                                                          |
| `--copyMaps`                                                                                          | Copier les textures à côté du fichier de sortie                                                                                                        |
| `--prefixMaterialsWithModelName`                                                                      | Préfixer le nom des matériaux avec celui du modèle                                                                                                     |
| `--sketchupFileVersion <version>`                                                                     | Version SketchUp `.skp` cible                                                                                                                          |
| `--scale <x>`                                                                                         | Facteur d’échelle                                                                                                                                      |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Unité source                                                                                                                                           |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Axe vertical                                                                                                                                           |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Origine de sortie                                                                                                                                      |
| `--simplificationLevel <0–1>`                                                                         | Niveau de simplification                                                                                                                               |
| `--simplificationAuto`                                                                                | Niveau automatique de la baguette magique                                                                                                              |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Options de préservation                                                                                                                                |
| `--simplificationTarget <n>`                                                                          | Nombre de faces cible (ligne de commande uniquement)                                                                                                   |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Options d’arêtes                                                                                                                                       |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Raccourcis d’arêtes propres à la ligne de commande                                                                                                     |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy V-Ray                                                                                                                                            |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy Enscape                                                                                                                                          |
| `--proxy <type>`                                                                                      | Type d’espace réservé (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Réglages propres aux proxys                                                                                                                            |
| `--skipRendererMaterials`                                                                             | Désactiver les données de matériaux V-Ray/Enscape                                                                                                      |

Exemples :

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

## Plusieurs modèles et motifs

Transmettez plusieurs chemins :

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

Utilisez des motifs (`*`, `**`, plages). Transmutr développe lui-même les motifs, pour que les terminaux Windows se comportent comme les 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" %}
Les chemins et les motifs sont **sensibles à la casse**. `.fbx` ne correspond pas à `.FBX`.
{% endhint %}

Lors de la conversion de plusieurs modèles, les options s’appliquent à tous, et `--output` doit être un **dossier**.