> 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-ko/undefined-2/command-line-interface.md).

# 명령줄 인터페이스

{% hint style="success" icon="rocket-launch" %}
**Studio / Creator** 기능입니다. CLI에는 유효한 Studio 또는 Creator 라이선스가 필요합니다.
{% endhint %}

CLI는 그래픽 인터페이스를 열지 않고 모델을 변환합니다. 라이브러리, CI 방식 스크립트, LOD 파이프라인에 적합합니다.

## 실행 파일 찾기

터미널을 열고 `convert` 하위 명령으로 Transmutr 실행 파일을 실행하십시오.

일반적인 위치:

<table><thead><tr><th width="200">플랫폼</th><th>일반적인 경로</th></tr></thead><tbody><tr><td>Windows(사용자별)</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" %}
설치 폴더를 `PATH`에 추가하면 전체 경로 대신 짧은 명령을 입력할 수 있습니다. `convert` **없이** 실행 파일을 실행하면 GUI가 열립니다.
{% endhint %}

## 기본 사용법

입력 옆에 모델을 변환합니다(같은 이름, `.skp`).

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

출력 경로를 선택합니다.

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

모든 플래그를 나열합니다.

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

## 자주 쓰는 옵션

| 옵션                                                                                                    | 설명                                                                                                                                        |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | 출력 파일. 여러 모델을 변환할 때는 디렉터리                                                                                                                 |
| `-p, --preset <path>`                                                                                 | GUI 프리셋 `.json`을 불러옵니다                                                                                                                    |
| `--copyMaps`                                                                                          | 출력 옆에 텍스처 맵을 복사합니다                                                                                                                        |
| `--prefixMaterialsWithModelName`                                                                      | 재질 이름 앞에 모델 이름을 붙입니다                                                                                                                      |
| `--sketchupFileVersion <version>`                                                                     | 대상 SketchUp `.skp` 버전                                                                                                                     |
| `--scale <x>`                                                                                         | 축척 배율                                                                                                                                     |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | 원본 단위                                                                                                                                     |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | 위쪽 축                                                                                                                                      |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | 출력 원점                                                                                                                                     |
| `--simplificationLevel <0–1>`                                                                         | 단순화 정도                                                                                                                                    |
| `--simplificationAuto`                                                                                | 마술봉 자동 수준                                                                                                                                 |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | 유지 플래그                                                                                                                                    |
| `--simplificationTarget <n>`                                                                          | 대상 면 수(CLI 전용)                                                                                                                            |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | 가장자리 옵션                                                                                                                                   |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | CLI 전용 가장자리 바로 가기                                                                                                                         |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | V-Ray 프록시                                                                                                                                 |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Enscape 프록시                                                                                                                               |
| `--proxy <type>`                                                                                      | 자리 표시자 유형(`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | 프록시 전용 컨트롤                                                                                                                                |
| `--skipRendererMaterials`                                                                             | V-Ray/Enscape 재질 데이터를 사용하지 않습니다                                                                                                           |

예:

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

## 여러 모델과 글롭

여러 경로를 전달합니다.

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

글롭(`*`, `**`, 범위)을 사용합니다. Transmutr가 패턴을 직접 확장하므로 Windows 터미널도 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" %}
경로와 패턴은 **대소문자를 구분합니다**. `.fbx`는 `.FBX`와 일치하지 않습니다.
{% endhint %}

여러 모델을 변환할 때 옵션은 모두에 적용되며, `--output`은 **디렉터리**여야 합니다.