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

# Interfejs wiersza poleceń

{% hint style="success" icon="rocket-launch" %}
Funkcja **Studio / Creator**. Interfejs wiersza poleceń wymaga ważnej licencji Studio lub Creator.
{% endhint %}

Interfejs wiersza poleceń konwertuje modele bez otwierania interfejsu graficznego. Sprawdza się w bibliotekach, skryptach w stylu CI i potokach LOD.

## Znajdź plik wykonywalny

Otwórz terminal i uruchom plik wykonywalny programu Transmutr z podpoleceniem `convert`.

Typowe lokalizacje:

<table><thead><tr><th width="200">Platforma</th><th>Typowa ścieżka</th></tr></thead><tbody><tr><td>Windows (dla bieżącego użytkownika)</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" %}
Dodaj folder instalacji do zmiennej `PATH`, aby wpisywać krótkie polecenie zamiast pełnej ścieżki. Uruchomienie pliku wykonywalnego **bez** `convert` otwiera interfejs graficzny.
{% endhint %}

## Podstawowe użycie

Konwertuj model obok pliku wejściowego (ta sama nazwa, `.skp`):

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

Wybierz ścieżkę wyjściową:

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

Wyświetl wszystkie flagi:

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

## Częste opcje

| Opcja                                                                                                 | Opis                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | Plik wyjściowy albo katalog przy konwersji wielu modeli                                                                                         |
| `-p, --preset <path>`                                                                                 | Wczytaj preset `.json` z interfejsu graficznego                                                                                                 |
| `--copyMaps`                                                                                          | Kopiuj mapy tekstur obok pliku wyjściowego                                                                                                      |
| `--prefixMaterialsWithModelName`                                                                      | Poprzedzaj nazwy materiałów nazwą modelu                                                                                                        |
| `--sketchupFileVersion <version>`                                                                     | Docelowa wersja `.skp` programu SketchUp                                                                                                        |
| `--scale <x>`                                                                                         | Mnożnik skali                                                                                                                                   |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Jednostka źródłowa                                                                                                                              |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Oś pionowa                                                                                                                                      |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Początek osi na wyjściu                                                                                                                         |
| `--simplificationLevel <0–1>`                                                                         | Stopień uproszczenia                                                                                                                            |
| `--simplificationAuto`                                                                                | Automatyczny poziom magicznej różdżki                                                                                                           |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Flagi zachowywania                                                                                                                              |
| `--simplificationTarget <n>`                                                                          | Docelowa liczba płaszczyzn (tylko CLI)                                                                                                          |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Opcje krawędzi                                                                                                                                  |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Skróty krawędzi dostępne tylko w CLI                                                                                                            |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | Proxy V-Ray                                                                                                                                     |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Proxy Enscape                                                                                                                                   |
| `--proxy <type>`                                                                                      | Typ zastępnika (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Ustawienia właściwe dla proxy                                                                                                                   |
| `--skipRendererMaterials`                                                                             | Wyłącz dane materiałów V-Ray/Enscape                                                                                                            |

Przykłady:

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

## Wiele modeli i wzorce glob

Podaj kilka ścieżek:

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

Użyj wzorców glob (`*`, `**`, zakresy). Program Transmutr sam rozwija wzorce, dzięki czemu terminale Windows zachowują się jak powłoki 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" %}
Ścieżki i wzorce **rozróżniają wielkość liter**. `.fbx` nie pasuje do `.FBX`.
{% endhint %}

Przy konwersji wielu modeli opcje dotyczą ich wszystkich, a `--output` musi być **katalogiem**.