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

# Interfaz de línea de comandos

{% hint style="success" icon="rocket-launch" %}
Función de **Studio / Creator**. La CLI requiere una licencia válida de Studio o de Creator.
{% endhint %}

La CLI convierte modelos sin abrir la interfaz gráfica. Es ideal para bibliotecas, scripts de estilo CI y flujos de LOD.

## Localizar el ejecutable

Abra un terminal y ejecute el programa de Transmutr con el subcomando `convert`.

Ubicaciones habituales:

<table><thead><tr><th width="200">Plataforma</th><th>Ruta habitual</th></tr></thead><tbody><tr><td>Windows (por usuario)</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" %}
Añada la carpeta de instalación a su `PATH` para poder escribir un comando corto en lugar de la ruta completa. Si ejecuta el programa **sin** `convert`, se abre la interfaz gráfica.
{% endhint %}

## Uso básico

Convierta un modelo junto a la entrada (el mismo nombre, `.skp`):

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

Elija una ruta de salida:

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

Muestre todos los indicadores:

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

## Opciones habituales

| Opción                                                                                                | Descripción                                                                                                                                                   |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | Archivo de salida, o un directorio al convertir varios modelos                                                                                                |
| `-p, --preset <path>`                                                                                 | Cargar un preajuste `.json` de la interfaz gráfica                                                                                                            |
| `--copyMaps`                                                                                          | Copiar los mapas de textura junto a la salida                                                                                                                 |
| `--prefixMaterialsWithModelName`                                                                      | Anteponer el nombre del modelo a los nombres de los materiales                                                                                                |
| `--sketchupFileVersion <version>`                                                                     | Versión de SketchUp del `.skp` de destino                                                                                                                     |
| `--scale <x>`                                                                                         | Multiplicador de escala                                                                                                                                       |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Unidad de origen                                                                                                                                              |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Eje vertical                                                                                                                                                  |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Origen de salida                                                                                                                                              |
| `--simplificationLevel <0–1>`                                                                         | Nivel de simplificación                                                                                                                                       |
| `--simplificationAuto`                                                                                | Nivel automático de la varita mágica                                                                                                                          |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Indicadores de conservación                                                                                                                                   |
| `--simplificationTarget <n>`                                                                          | Número de caras objetivo (solo CLI)                                                                                                                           |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Opciones de aristas                                                                                                                                           |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Atajos de aristas solo para la CLI                                                                                                                            |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy de V-Ray                                                                                                                                                |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy de Enscape                                                                                                                                              |
| `--proxy <type>`                                                                                      | Tipo de marcador de posición (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Controles específicos del proxy                                                                                                                               |
| `--skipRendererMaterials`                                                                             | Desactivar los datos de material de V-Ray/Enscape                                                                                                             |

Ejemplos:

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

## Varios modelos y comodines

Pase varias rutas:

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

Use comodines (`*`, `**`, rangos). Transmutr expande los patrones por sí mismo, de modo que los terminales de Windows se comportan como los shells de 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" %}
Las rutas y los patrones **distinguen entre mayúsculas y minúsculas**. `.fbx` no coincide con `.FBX`.
{% endhint %}

Al convertir varios modelos, las opciones se aplican a todos y `--output` debe ser un **directorio**.